refactor: monorepo - standalone sync-engine lib

Refactors the repo to a monorepo and publishes @supabase/stripe-sync-engine as individual package. For the docker image, there are no breaking changes.

The standalone package supports both ESM and CJS and can be used in any JavaScript based server environment, including Supabase Edge Functions, Node/Deno servers.

Author: kevcodez

.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
-      
+
       - name: Install pnpm
         uses: pnpm/action-setup@v4
 
@@ -36,14 +36,14 @@ jobs:
 
       - name: Set up .env file
         run: |
-          touch .env
-          echo DATABASE_URL='postgres://postgres:postgres@localhost:55432/postgres?sslmode=disable&search_path=stripe' >> .env
-          echo NODE_ENV=dev >> .env
-          echo STRIPE_SECRET_KEY=sk_test_ >> .env
-          echo STRIPE_WEBHOOK_SECRET=whsec_ >> .env
-          echo SCHEMA=stripe >> .env
-          echo PORT=8080 >> .env
-          echo API_KEY=api_key_test >> .env
+          touch packages/fastify-app/.env
+          echo DATABASE_URL='postgres://postgres:postgres@localhost:55432/postgres?sslmode=disable&search_path=stripe' >> packages/fastify-app/.env
+          echo NODE_ENV=dev >> packages/fastify-app/.env
+          echo STRIPE_SECRET_KEY=sk_test_ >> packages/fastify-app/.env
+          echo STRIPE_WEBHOOK_SECRET=whsec_ >> packages/fastify-app/.env
+          echo SCHEMA=stripe >> packages/fastify-app/.env
+          echo PORT=8080 >> packages/fastify-app/.env
+          echo API_KEY=api_key_test >> packages/fastify-app/.env
 
       - name: Install dependencies
         run: |
@@ -59,8 +59,7 @@ jobs:
 
       - name: Builds successfully
         run: |
-          pnpm typecheck
-
+          pnpm build
 
       - name: Initialize DB schema
         run: |

.github/workflows/release.yml

@@ -8,11 +8,7 @@ on:
 
 jobs:
   release:
-    name: Release / Node ${{ matrix.node }}
-    strategy:
-      matrix:
-        node:
-          - '22'
+    name: Release
 
     runs-on: ubuntu-24.04
 
@@ -23,10 +19,14 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Set up Node
         uses: actions/setup-node@v4
         with:
-          node-version: ${{ matrix.node }}
+          node-version-file: ./.nvmrc
+          cache: pnpm
 
       - run: |
           pnpm install --frozen-lockfile
@@ -68,9 +68,33 @@ jobs:
         id: docker_build
         uses: docker/build-push-action@v6
         with:
+          context: packages/fastify-app
           push: true
           tags: supabase/stripe-sync-engine:latest,supabase/stripe-sync-engine:v${{ needs.release.outputs.new-release-version }}
           platforms: linux/amd64,linux/arm64
 
       - name: Image digest
         run: echo ${{ steps.docker_build.outputs.digest }}
+
+  npm:
+    name: Release on NPM
+
+    needs:
+      - release
+
+    if: needs.release.outputs.new-release-published == 'true'
+
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Set new version in sync-engine
+        run: |
+          cd packages/sync-engine
+          pnpm version ${{ needs.release.outputs.new-release-version }} --no-git-tag-version
+
+      - name: Publish sync-engine to npm
+        run: |
+          cd packages/sync-engine
+          npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -3,4 +3,4 @@ dist/
 node_modules/
 .env
 .env.*
-db/migrations/0000_schema.sql
+!.env.sample

.prettierignore

@@ -3,4 +3,5 @@
 node_modules
 pnpm-lock.yaml
 docker*
-Pulumi.*.yaml
+Pulumi.*.yaml
+LICENSE.md

.vscode/settings.json

@@ -8,5 +8,3 @@ services:
       - 55432:5432
     environment:
       POSTGRES_PASSWORD: postgres
-    volumes:
-      - ./db/migrations/schema.sql:/docker-entrypoint-initdb.d/0000_schema.sql

RELEASE.md

@@ -20,5 +20,8 @@ export default [
       ecmaVersion: 2022,
       sourceType: 'module',
     },
+    rules: {
+      '@typescript-eslint/ban-ts-comment': 'off',
+    },
   },
 ]

docker/compose.yml

@@ -1,53 +1,31 @@
 {
   "name": "stripe-sync-engine",
-  "version": "0.0.0",
-  "description": "Stripe sync engine. Sync your Stripe account to your Postgres database.",
-  "main": "index.js",
+  "private": true,
+  "version": "1.0.0",
+  "workspaces": [
+    "packages/*"
+  ],
   "scripts": {
-    "dev": "tsx --watch ./src/server.ts",
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "start": "NODE_ENV=production node dist/server.js",
-    "test": "vitest",
-    "lint": "eslint 'src/**'",
-    "format:check": "prettier -c src/**",
-    "format": "prettier --write src/**",
-    "prod:secrets:fetch": "AWS_PROFILE=supabase node internals/getSecrets.js prod",
-    "staging:secrets:fetch": "node internals/getSecrets.js staging"
-  },
-  "author": "Supabase",
-  "license": "MIT",
-  "engines": {
-    "node": ">= 22.0.0"
-  },
-  "dependencies": {
-    "@fastify/autoload": "^6.3.0",
-    "@fastify/swagger": "^9.5.1",
-    "@fastify/swagger-ui": "^5.2.2",
-    "dotenv": "^16.5.0",
-    "fastify": "^5.3.3",
-    "p-limit": "^3.1.0",
-    "pg": "^8.16.0",
-    "pg-node-migrations": "0.0.8",
-    "pino": "^9.7.0",
-    "stripe": "^18.2.0",
-    "yesql": "^7.0.0"
+    "build": "pnpm -r run build",
+    "test": "pnpm -r run test",
+    "typecheck": "pnpm -r run typecheck",
+    "lint": "pnpm -r run lint",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.28.0",
-    "@types/node": "^22.15.29",
-    "@types/pg": "^8.15.2",
-    "@types/yesql": "^4.1.4",
     "@typescript-eslint/eslint-plugin": "^8.33.0",
     "@typescript-eslint/parser": "^8.33.0",
     "eslint": "^9.28.0",
     "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-prettier": "^5.4.1",
+    "pino": "^9.7.0",
     "prettier": "^3.5.3",
-    "tsx": "^4.19.4",
+    "rimraf": "^6.0.1",
     "typescript": "^5.8.3",
-    "vitest": "^3.1.4"
+    "vite": "^6.3.5"
   },
   "packageManager": "[email protected]"
 }