stripe-experiment-sync 1.0.18 → 1.0.19

package/dist/index.d.ts

@@ -157,12 +157,21 @@ declare class PostgresClient {
         status: string;
         processedCount: number;
         cursor: string | null;
+        pageCursor: string | null;
     } | null>;
     /**
      * Update progress for an object sync.
      * Also touches updated_at for stale detection.
      */
     incrementObjectProgress(accountId: string, runStartedAt: Date, object: string, count: number): Promise<void>;
+    /**
+     * Update the pagination page_cursor used for backfills using Stripe list calls.
+     */
+    updateObjectPageCursor(accountId: string, runStartedAt: Date, object: string, pageCursor: string | null): Promise<void>;
+    /**
+     * Clear the pagination page_cursor for an object sync.
+     */
+    clearObjectPageCursor(accountId: string, runStartedAt: Date, object: string): Promise<void>;
     /**
      * Update the cursor for an object sync.
      * Only updates if the new cursor is higher than the existing one (cursors should never decrease).
@@ -172,15 +181,20 @@ declare class PostgresClient {
     updateObjectCursor(accountId: string, runStartedAt: Date, object: string, cursor: string | null): Promise<void>;
     /**
      * Get the highest cursor from previous syncs for an object type.
-     * This considers completed, error, AND running runs to ensure recovery syncs
-     * don't re-process data that was already synced before a crash.
-     * A 'running' status with a cursor means the process was killed mid-sync.
+     * Uses only completed object runs.
+     * - During the initial backfill we page through history, but we also update the cursor as we go.
+     *   If we crash mid-backfill and reuse that cursor, we can accidentally switch into incremental mode
+     *   too early and only ever fetch the newest page (breaking the historical backfill).
      *
      * Handles two cursor formats:
      * - Numeric: compared as bigint for correct ordering
      * - Composite cursors: compared as strings with COLLATE "C"
      */
     getLastCompletedCursor(accountId: string, object: string): Promise<string | null>;
+    /**
+     * Get the highest cursor from previous syncs for an object type, excluding the current run.
+     */
+    getLastCursorBeforeRun(accountId: string, object: string, runStartedAt: Date): Promise<string | null>;
     /**
      * Delete all sync runs and object runs for an account.
      * Useful for testing or resetting sync state.
@@ -587,6 +601,7 @@ declare class StripeSync {
      * ```
      */
     processNext(object: Exclude<SyncObject, 'all' | 'customer_with_entitlements'>, params?: ProcessNextParams): Promise<ProcessNextResult>;
+    private appendMigrationHint;
     /**
      * Get the database resource name for a SyncObject type
      */

package/dist/index.js

@@ -5,8 +5,8 @@ import {
   createStripeWebSocketClient,
   hashApiKey,
   runMigrations
-} from "./chunk-K4JQHI7Y.js";
-import "./chunk-XO57OJUE.js";
+} from "./chunk-XKBCLBFT.js";
+import "./chunk-CMGFQCD7.js";
 export {
   PostgresClient,
   StripeSync,

package/dist/migrations/0061_add_page_cursor.sql

@@ -0,0 +1,3 @@
+-- Add page_cursor column for pagination state within a single sync run.
+-- This is used to store the starting_after ID for backfills using Stripe list calls.
+ALTER TABLE "stripe"."_sync_obj_runs" ADD COLUMN IF NOT EXISTS page_cursor text;

package/dist/supabase/index.cjs

@@ -54,7 +54,7 @@ var workerFunctionCode = stripe_worker_default;
 // package.json
 var package_default = {
   name: "stripe-experiment-sync",
-  version: "1.0.18",
+  version: "1.0.19",
   private: false,
   description: "Stripe Sync Engine to sync Stripe data to Postgres",
   type: "module",

package/dist/supabase/index.js

@@ -9,8 +9,8 @@ import {
   uninstall,
   webhookFunctionCode,
   workerFunctionCode
-} from "../chunk-M5TTM27L.js";
-import "../chunk-XO57OJUE.js";
+} from "../chunk-4P6TAP7L.js";
+import "../chunk-CMGFQCD7.js";
 export {
   INSTALLATION_ERROR_SUFFIX,
   INSTALLATION_INSTALLED_SUFFIX,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe-experiment-sync",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "private": false,
   "description": "Stripe Sync Engine to sync Stripe data to Postgres",
   "type": "module",