Merge branch 'supabase:main' into main

Author: xpertforextradeinc

.github/workflows/ci.yml

@@ -14,7 +14,7 @@ jobs:
 
     services:
       postgres:
-        image: postgres:17
+        image: postgres:18
         ports:
           - 55432:5432
         env:
@@ -23,13 +23,13 @@ jobs:
           POSTGRES_PASSWORD: postgres
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
 
       - name: Install pnpm
         uses: pnpm/action-setup@v4
 
       - name: Set up Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version-file: ./.nvmrc
           cache: pnpm

.github/workflows/docs.yml

@@ -8,8 +8,8 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-python@v5
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
         with:
           python-version: 3.x
       - run: pip install mkdocs

.github/workflows/release.yml

@@ -17,13 +17,13 @@ jobs:
       new-release-version: ${{ steps.semantic-release.outputs.new_release_version }}
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
 
       - name: Install pnpm
         uses: pnpm/action-setup@v4
 
       - name: Set up Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version-file: ./.nvmrc
           cache: pnpm
@@ -41,7 +41,8 @@ jobs:
 
   docker:
     name: Release on Docker Hub
-
+    permissions:
+      contents: read
     needs:
       - release
 
@@ -77,7 +78,9 @@ jobs:
 
   npm:
     name: Release on NPM
-
+    permissions:
+      contents: read
+      id-token: write # OIDC for releasing on npm
     needs:
       - release
 
@@ -86,7 +89,7 @@ jobs:
     runs-on: ubuntu-24.04
 
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           sparse-checkout: |
             packages/sync-engine
@@ -99,12 +102,15 @@ jobs:
           cd packages/sync-engine
           pnpm version ${{ needs.release.outputs.new-release-version }} --no-git-tag-version
 
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+
       - name: Publish sync-engine to npm
         run: |
           cd packages/sync-engine
           pnpm install --frozen-lockfile
           pnpm run build
           pnpm pack
           npm publish --access public
-        env:
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

.nvmrc

@@ -1 +1 @@
-v22
+v24

Dockerfile

@@ -1,17 +1,40 @@
 # Build step
-FROM node:22-alpine
+FROM node:24-alpine AS base
 
-RUN npm install -g [email protected]
+ENV PNPM_HOME="/pnpm"
+ENV PATH="$PNPM_HOME:$PATH"
+
+RUN corepack enable
 
 WORKDIR /app
 COPY . ./
-RUN pnpm install --frozen-lockfile
-RUN pnpm build
-RUN pnpm prune --production
+
+FROM base AS prod-deps
+RUN --mount=type=cache,id=pnpm,target=/pnpm/store pnpm install --prod --frozen-lockfile
+
+FROM base AS build
+RUN --mount=type=cache,id=pnpm,target=/pnpm/store pnpm install --frozen-lockfile
+RUN pnpm run -r build
 
 ## Build step complete, copy to working image
-FROM node:22-alpine
+FROM node:24-alpine
 WORKDIR /app
+
+# Copy workspace configuration
+COPY --from=base /app/package.json /app/pnpm-lock.yaml /app/pnpm-workspace.yaml* ./
+
+# Copy package.json files for both packages
+COPY --from=base /app/packages/fastify-app/package.json /app/packages/fastify-app/
+COPY --from=base /app/packages/sync-engine/package.json /app/packages/sync-engine/
+
+# Copy production dependencies (including workspace dependencies)
+COPY --from=prod-deps /app/node_modules /app/node_modules
+COPY --from=prod-deps /app/packages/fastify-app/node_modules /app/packages/fastify-app/node_modules
+COPY --from=prod-deps /app/packages/sync-engine/node_modules /app/packages/sync-engine/node_modules
+
+# Copy built files
+COPY --from=build /app/packages/fastify-app/dist /app/packages/fastify-app/dist
+COPY --from=build /app/packages/sync-engine/dist /app/packages/sync-engine/dist
+
 ENV NODE_ENV=production
-COPY --from=0 /app .
 CMD ["node", "packages/fastify-app/dist/src/server.js"]

README.md

@@ -4,30 +4,37 @@
 ![NPM Version](https://img.shields.io/npm/v/%40supabase%2Fstripe-sync-engine)
 ![Docker Image Version](https://img.shields.io/docker/v/supabase/stripe-sync-engine?label=Docker)
 
-This monorepo contains two packages for synchronizing your Stripe account with a Postgres database:
+This monorepo contains two packages for synchronizing your Stripe account with a PostgreSQL database:
 
-- [`@supabase/stripe-sync-engine`](./packages/sync-engine/README.md): A TypeScript library for syncing Stripe data to Postgres, designed for integration into your own Node.js backend or serverless environment.
-- [`stripe-sync-fastify`](./packages/fastify-app/README.md): A Fastify-based server and Docker image that exposes a `/webhooks` endpoint for Stripe, providing a ready-to-run service for real-time Stripe-to-Postgres sync.
+- [`@supabase/stripe-sync-engine`](./packages/sync-engine/README.md): A TypeScript library for syncing Stripe data to PostgreSQL, designed for integration into your own Node.js backend or serverless environment.
+- [`stripe-sync-fastify`](./packages/fastify-app/README.md): A Fastify-based server and Docker image that exposes a `/webhooks` endpoint for Stripe, providing a ready-to-run service for real-time Stripe-to-PostgreSQL sync.
 
-![Sync Stripe with Postgres](./docs/stripe-sync-engine.jpg)
+![Sync Stripe with PostgreSQL](./docs/stripe-sync-engine.jpg)
 
 ---
 
 ## Motivation
 
 Sometimes you want to analyze your billing data using SQL. Even more importantly, you want to join your billing data to your product/business data.
 
-This project synchronizes your Stripe account to a Postgres database. It can be a new database, or an existing Postgres database.
+This project synchronizes your Stripe account to a PostgreSQL database. It can be a new database, or an existing PostgreSQL database.
 
 ---
 
 ## How it works
 
 ![How it works](./docs/sync-engine-how.png)
 
-- Creates a new schema `stripe` in a Postgres database, with tables & columns matching Stripe.
+- Creates a new schema `stripe` in a PostgreSQL database, with tables and columns matching Stripe.
 - Exposes a `/webhooks` endpoint that listens to any Stripe webhooks (via the Fastify app).
-- Inserts/updates/deletes changes into the tables whenever there is a change to Stripe.
+- Inserts, updates, or deletes changes into the tables whenever there is a change to Stripe.
+
+> **Note:** If other PostgreSQL users need access to the `stripe` schema, grant them privileges:
+>
+> ```sql
+> GRANT USAGE ON SCHEMA stripe TO your_user;
+> GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA stripe TO your_user;
+> ```
 
 ---
 
@@ -42,7 +49,7 @@ Each package has its own README with installation, configuration, and usage inst
 
 ## Supabase Edge Function
 
-To deploy the sync-engine to a Supabase edge function, follow this [guide](./edge-function.md).
+To deploy the sync-engine to a Supabase Edge Function, follow this [guide](./docs/edge-function.md).
 
 ## Webhook Support
 
@@ -60,9 +67,10 @@ To deploy the sync-engine to a Supabase edge function, follow this [guide](./edg
 - [x] `charge.dispute.funds_reinstated` 🟢
 - [x] `charge.dispute.funds_withdrawn` 🟢
 - [x] `charge.dispute.updated` 🟢
-- [ ] `checkout.session.async_payment_failed`
-- [ ] `checkout.session.async_payment_succeeded`
-- [ ] `checkout.session.completed`
+- [x] `checkout.session.async_payment_failed` 🟢
+- [x] `checkout.session.async_payment_succeeded` 🟢
+- [x] `checkout.session.completed` 🟢
+- [x] `checkout.session.expired` 🟢
 - [x] `credit_note.created` 🟢
 - [x] `credit_note.updated` 🟢
 - [x] `credit_note.voided` 🟢
@@ -98,6 +106,7 @@ To deploy the sync-engine to a Supabase edge function, follow this [guide](./edg
 - [x] `invoice.overpaid` 🟢
 - [x] `invoice.will_be_due` 🟢
 - [x] `invoice.voided` 🟢
+- [x] `invoice_payment.paid` 🟢
 - [ ] `issuing_authorization.request`
 - [ ] `issuing_card.created`
 - [ ] `issuing_cardholder.created`
@@ -141,3 +150,4 @@ To deploy the sync-engine to a Supabase edge function, follow this [guide](./edg
 - [x] `subscription_schedule.expiring` 🟢
 - [x] `subscription_schedule.released` 🟢
 - [x] `subscription_schedule.updated` 🟢
+- [x] `entitlements.active_entitlement_summary.updated` 🟢

docs/contributing.md

@@ -1,6 +1,6 @@
 # Contributing
 
-Contributions are welcome.
+Contributions are welcome! This document provides guidelines for contributing to the Stripe Sync Engine project.
 
 ## Contributing to the Docs
 
@@ -10,7 +10,7 @@ Building documentation requires Python 3.8+ and uv.
 
 Create a virtual environment and install mkdocs, themes, and extensions using uv.
 
-```shell
+```sh
 source .venv/bin/activate  # On Windows: .venv\Scripts\activate
 uv pip install -r docs/requirements_docs.txt
 ```
@@ -19,7 +19,7 @@ uv pip install -r docs/requirements_docs.txt
 
 To serve the documentation locally, make sure your virtual environment is activated and run:
 
-```shell
+```sh
 source .venv/bin/activate  # On Windows: .venv\Scripts\activate
 mkdocs serve
 ```
@@ -28,8 +28,8 @@ and visit the docs at [http://127.0.0.1:8000/](http://127.0.0.1:8000/)
 
 ### Deploying
 
-If you have write access to the repo, docs can be updated using
+If you have write access to the repository, documentation can be updated using:
 
-```
+```sh
 mkdocs gh-deploy
 ```