@paymentsdb/sync-engine 0.0.4 → 0.0.6

package/dist/index.d.cts

@@ -33,7 +33,7 @@ declare class PostgresClient {
     }>(entries: T[], table: string): Promise<T[]>;
     upsertManyWithTimestampProtection<T extends {
         [Key: string]: any;
-    }>(entries: T[], table: string, accountId: string, syncTimestamp?: string, upsertOptions?: RawJsonUpsertOptions): Promise<T[]>;
+    }>(entries: T[], table: string, accountId: string, syncTimestamp?: string, upsertOptions?: RawJsonUpsertOptions, schemaOverride?: string): Promise<T[]>;
     private cleanseArrayField;
     findMissingEntries(table: string, ids: string[]): Promise<string[]>;
     upsertAccount(accountData: {
@@ -102,9 +102,10 @@ declare class PostgresClient {
     cancelStaleRuns(accountId: string): Promise<void>;
     /**
      * Get or create a sync run for this account.
-     * Returns existing run if one is active, otherwise creates new one.
+     * Returns existing run if one is active for the given triggeredBy, otherwise creates new one.
      * Auto-cancels stale runs before checking.
      *
+     * @param triggeredBy - Worker type (e.g., 'worker', 'sigma-worker'). Runs are isolated per triggeredBy.
      * @returns RunKey with isNew flag, or null if constraint violation (race condition)
      */
     getOrCreateSyncRun(accountId: string, triggeredBy?: string): Promise<{
@@ -114,8 +115,9 @@ declare class PostgresClient {
     } | null>;
     /**
      * Get the active sync run for an account (if any).
+     * @param triggeredBy - If provided, only returns run matching this triggeredBy value
      */
-    getActiveSyncRun(accountId: string): Promise<{
+    getActiveSyncRun(accountId: string, triggeredBy?: string): Promise<{
         accountId: string;
         runStartedAt: Date;
     } | null>;
@@ -129,6 +131,10 @@ declare class PostgresClient {
         maxConcurrent: number;
         closedAt: Date | null;
     } | null>;
+    /**
+     * Ensure a sync run has at least the requested max_concurrent value.
+     */
+    ensureSyncRunMaxConcurrent(accountId: string, runStartedAt: Date, maxConcurrent: number): Promise<void>;
     /**
      * Close a sync run (mark as done).
      * Status (complete/error) is derived from object run states.
@@ -179,6 +185,11 @@ declare class PostgresClient {
      * For non-numeric cursors, just sets the value directly.
      */
     updateObjectCursor(accountId: string, runStartedAt: Date, object: string, cursor: string | null): Promise<void>;
+    setObjectCursor(accountId: string, runStartedAt: Date, object: string, cursor: string | null): Promise<void>;
+    /**
+     * List object names for a run by status, optionally filtered to a subset.
+     */
+    listObjectsByStatus(accountId: string, runStartedAt: Date, status: string, objectFilter?: string[]): Promise<string[]>;
     /**
      * Get the highest cursor from previous syncs for an object type.
      * Uses only completed object runs.
@@ -195,6 +206,11 @@ declare class PostgresClient {
      * 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>;
+    /**
+     * Get the most recent cursor for an object run before the given run.
+     * This returns the raw cursor value without interpretation.
+     */
+    getLastObjectCursorBeforeRun(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.
@@ -243,6 +259,12 @@ type SigmaCursorSpec = {
     version: 1;
     columns: SigmaCursorColumnSpec[];
 };
+type SigmaColumnSpec = {
+    name: string;
+    sigmaType: string;
+    pgType: string;
+    primaryKey: boolean;
+};
 type SigmaIngestionConfig = {
     /**
      * The Sigma table name to query (no quoting, no schema).
@@ -258,6 +280,11 @@ type SigmaIngestionConfig = {
      * Defines the ordering and cursor semantics. The columns must form a total order (i.e. be unique together) or pagination can be incorrect.
      */
     cursor: SigmaCursorSpec;
+    /**
+     * Column metadata for the destination table.
+     * If provided, used to dynamically create/reconcile the table.
+     */
+    columns?: SigmaColumnSpec[];
     /** Optional additional WHERE clause appended with AND (must not include leading WHERE). */
     additionalWhere?: string;
     /** Columns to SELECT (defaults to `*`). */
@@ -291,6 +318,16 @@ type StripeSyncConfig = {
      * Default: false (opt-in, so workers don't enqueue Sigma jobs unexpectedly).
      */
     enableSigma?: boolean;
+    /**
+     * Optional override for Sigma page size (per query).
+     * Useful for edge function CPU limits; lower values reduce per-invocation work.
+     */
+    sigmaPageSizeOverride?: number;
+    /**
+     * Postgres schema name for Sigma tables.
+     * Default: "sigma"
+     */
+    sigmaSchemaName?: string;
     /** Stripe account ID. If not provided, will be retrieved from Stripe API. Used as fallback option. */
     stripeAccountId?: string;
     /** Stripe webhook signing secret for validating webhook signatures. Required if not using managed webhooks. */
@@ -345,7 +382,7 @@ type StripeSyncConfig = {
      */
     maxConcurrentCustomers?: number;
 };
-type SyncObject = 'all' | 'customer' | 'customer_with_entitlements' | 'invoice' | 'price' | 'product' | 'subscription' | 'subscription_schedules' | 'setup_intent' | 'payment_method' | 'dispute' | 'charge' | 'balance_transaction' | 'payment_intent' | 'plan' | 'tax_id' | 'credit_note' | 'early_fraud_warning' | 'refund' | 'checkout_sessions' | 'subscription_item_change_events_v2_beta' | 'exchange_rates_from_usd';
+type SyncObject = 'all' | 'customer' | 'customer_with_entitlements' | 'invoice' | 'price' | 'product' | 'subscription' | 'subscription_schedules' | 'setup_intent' | 'payment_method' | 'dispute' | 'charge' | 'balance_transaction' | 'payment_intent' | 'plan' | 'tax_id' | 'credit_note' | 'early_fraud_warning' | 'refund' | 'checkout_sessions' | '_event_catchup';
 interface Sync {
     synced: number;
 }
@@ -370,6 +407,8 @@ interface SyncBackfill {
     checkoutSessions?: Sync;
     subscriptionItemChangeEventsV2Beta?: Sync;
     exchangeRatesFromUsd?: Sync;
+    /** Sigma-backed results by table name (e.g. subscription_item_change_events_v2_beta). */
+    sigma?: Record<string, Sync>;
 }
 interface SyncParams {
     created?: {
@@ -412,6 +451,8 @@ interface ProcessNextResult {
     hasMore: boolean;
     /** The sync run this processing belongs to */
     runStartedAt: Date;
+    /** Sigma-only: whether this step started a new Sigma query run */
+    startedQuery?: boolean;
 }
 /**
  * Parameters for processNext() including optional run context
@@ -502,7 +543,12 @@ declare class StripeSync {
     private config;
     stripe: Stripe;
     postgresClient: PostgresClient;
+    private readonly resourceRegistry;
+    private get sigmaSchemaName();
     constructor(config: StripeSyncConfig);
+    private buildResourceRegistry;
+    private isSigmaResource;
+    private sigmaResultKey;
     /**
      * Get the Stripe account ID. Delegates to getCurrentAccount() for the actual lookup.
      */
@@ -545,7 +591,6 @@ declare class StripeSync {
     }>;
     processWebhook(payload: Buffer | string, signature: string | undefined): Promise<void>;
     private readonly eventHandlers;
-    private readonly resourceRegistry;
     processEvent(event: Stripe.Event): Promise<void>;
     /**
      * Returns an array of all webhook event types that this sync engine can handle.
@@ -558,6 +603,13 @@ declare class StripeSync {
      * Order is determined by the `order` field in resourceRegistry.
      */
     getSupportedSyncObjects(): Exclude<SyncObject, 'all' | 'customer_with_entitlements'>[];
+    /**
+     * Get the list of Sigma-backed object types that can be synced.
+     * Only returns sigma objects when enableSigma is true.
+     *
+     * @returns Array of sigma object names (e.g. 'subscription_item_change_events_v2_beta')
+     */
+    getSupportedSigmaObjects(): string[];
     private handleChargeEvent;
     private handleCustomerDeletedEvent;
     private handleCustomerEvent;
@@ -620,6 +672,45 @@ declare class StripeSync {
     private fetchOnePage;
     private getSigmaFallbackCursorFromDestination;
     private fetchOneSigmaPage;
+    /**
+     * Fetch payment methods by iterating customers in batches.
+     *
+     * Most customers have 1-2 PMs, so processing one customer per processNext call
+     * would be extremely wasteful (10,000 customers = 10,000 worker round-trips).
+     * Instead, each call fetches a batch of customers (sized by maxConcurrentCustomers,
+     * default 10) and lists+upserts PMs for all of them concurrently.
+     *
+     * Cursor semantics:
+     * - cursor: max customer `created` timestamp — filters to only new customers on subsequent runs
+     * - pageCursor: last processed customer ID — tracks position in customer iteration
+     */
+    private fetchOnePagePaymentMethods;
+    /**
+     * Fetch the next batch of non-deleted customers for PM sync.
+     * Returns customer IDs and created timestamps, ordered by id ASC.
+     */
+    private findNextCustomerBatchForPmSync;
+    /**
+     * Fetch one page of events from the Stripe Events API and reconcile affected entities.
+     *
+     * Instead of replaying events (which can resurrect deleted objects due to newest-first ordering),
+     * we deduplicate by entity and re-fetch current state from Stripe for each affected entity.
+     *
+     * Cursor: event `created` timestamp. On first run, starts from the sync run's startedAt.
+     * On subsequent runs, picks up where the last completed run left off.
+     */
+    private fetchOnePageEventCatchup;
+    /**
+     * Handle a delete for an entity discovered via event catch-up.
+     * Maps Stripe object types to the appropriate delete method.
+     */
+    private handleEventCatchupDelete;
+    /**
+     * Handle an upsert for an entity discovered via event catch-up.
+     * Re-fetches the current state from Stripe and upserts it.
+     * If the entity has been deleted (404), falls back to the delete handler.
+     */
+    private handleEventCatchupUpsert;
     /**
      * Process all pages for all (or specified) object types until complete.
      *
@@ -651,6 +742,22 @@ declare class StripeSync {
         runKey: RunKey;
         objects: Exclude<SyncObject, 'all' | 'customer_with_entitlements'>[];
     }>;
+    private applySyncBackfillResult;
+    processUntilDoneParallel(params?: SyncParams & {
+        maxParallel?: number;
+        triggeredBy?: string;
+        continueOnError?: boolean;
+        skipInaccessibleSigmaTables?: boolean;
+    }): Promise<{
+        results: SyncBackfill;
+        totals: Record<string, number>;
+        totalSynced: number;
+        skipped: string[];
+        errors: Array<{
+            object: string;
+            message: string;
+        }>;
+    }>;
     processUntilDone(params?: SyncParams): Promise<SyncBackfill>;
     /**
      * Internal implementation of processUntilDone with an existing run.
@@ -771,6 +878,7 @@ type MigrationConfig = {
     databaseUrl: string;
     ssl?: ConnectionOptions;
     logger?: Logger;
+    enableSigma?: boolean;
 };
 declare function runMigrations(config: MigrationConfig): Promise<void>;
 

package/dist/index.d.ts

@@ -33,7 +33,7 @@ declare class PostgresClient {
     }>(entries: T[], table: string): Promise<T[]>;
     upsertManyWithTimestampProtection<T extends {
         [Key: string]: any;
-    }>(entries: T[], table: string, accountId: string, syncTimestamp?: string, upsertOptions?: RawJsonUpsertOptions): Promise<T[]>;
+    }>(entries: T[], table: string, accountId: string, syncTimestamp?: string, upsertOptions?: RawJsonUpsertOptions, schemaOverride?: string): Promise<T[]>;
     private cleanseArrayField;
     findMissingEntries(table: string, ids: string[]): Promise<string[]>;
     upsertAccount(accountData: {
@@ -102,9 +102,10 @@ declare class PostgresClient {
     cancelStaleRuns(accountId: string): Promise<void>;
     /**
      * Get or create a sync run for this account.
-     * Returns existing run if one is active, otherwise creates new one.
+     * Returns existing run if one is active for the given triggeredBy, otherwise creates new one.
      * Auto-cancels stale runs before checking.
      *
+     * @param triggeredBy - Worker type (e.g., 'worker', 'sigma-worker'). Runs are isolated per triggeredBy.
      * @returns RunKey with isNew flag, or null if constraint violation (race condition)
      */
     getOrCreateSyncRun(accountId: string, triggeredBy?: string): Promise<{
@@ -114,8 +115,9 @@ declare class PostgresClient {
     } | null>;
     /**
      * Get the active sync run for an account (if any).
+     * @param triggeredBy - If provided, only returns run matching this triggeredBy value
      */
-    getActiveSyncRun(accountId: string): Promise<{
+    getActiveSyncRun(accountId: string, triggeredBy?: string): Promise<{
         accountId: string;
         runStartedAt: Date;
     } | null>;
@@ -129,6 +131,10 @@ declare class PostgresClient {
         maxConcurrent: number;
         closedAt: Date | null;
     } | null>;
+    /**
+     * Ensure a sync run has at least the requested max_concurrent value.
+     */
+    ensureSyncRunMaxConcurrent(accountId: string, runStartedAt: Date, maxConcurrent: number): Promise<void>;
     /**
      * Close a sync run (mark as done).
      * Status (complete/error) is derived from object run states.
@@ -179,6 +185,11 @@ declare class PostgresClient {
      * For non-numeric cursors, just sets the value directly.
      */
     updateObjectCursor(accountId: string, runStartedAt: Date, object: string, cursor: string | null): Promise<void>;
+    setObjectCursor(accountId: string, runStartedAt: Date, object: string, cursor: string | null): Promise<void>;
+    /**
+     * List object names for a run by status, optionally filtered to a subset.
+     */
+    listObjectsByStatus(accountId: string, runStartedAt: Date, status: string, objectFilter?: string[]): Promise<string[]>;
     /**
      * Get the highest cursor from previous syncs for an object type.
      * Uses only completed object runs.
@@ -195,6 +206,11 @@ declare class PostgresClient {
      * 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>;
+    /**
+     * Get the most recent cursor for an object run before the given run.
+     * This returns the raw cursor value without interpretation.
+     */
+    getLastObjectCursorBeforeRun(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.
@@ -243,6 +259,12 @@ type SigmaCursorSpec = {
     version: 1;
     columns: SigmaCursorColumnSpec[];
 };
+type SigmaColumnSpec = {
+    name: string;
+    sigmaType: string;
+    pgType: string;
+    primaryKey: boolean;
+};
 type SigmaIngestionConfig = {
     /**
      * The Sigma table name to query (no quoting, no schema).
@@ -258,6 +280,11 @@ type SigmaIngestionConfig = {
      * Defines the ordering and cursor semantics. The columns must form a total order (i.e. be unique together) or pagination can be incorrect.
      */
     cursor: SigmaCursorSpec;
+    /**
+     * Column metadata for the destination table.
+     * If provided, used to dynamically create/reconcile the table.
+     */
+    columns?: SigmaColumnSpec[];
     /** Optional additional WHERE clause appended with AND (must not include leading WHERE). */
     additionalWhere?: string;
     /** Columns to SELECT (defaults to `*`). */
@@ -291,6 +318,16 @@ type StripeSyncConfig = {
      * Default: false (opt-in, so workers don't enqueue Sigma jobs unexpectedly).
      */
     enableSigma?: boolean;
+    /**
+     * Optional override for Sigma page size (per query).
+     * Useful for edge function CPU limits; lower values reduce per-invocation work.
+     */
+    sigmaPageSizeOverride?: number;
+    /**
+     * Postgres schema name for Sigma tables.
+     * Default: "sigma"
+     */
+    sigmaSchemaName?: string;
     /** Stripe account ID. If not provided, will be retrieved from Stripe API. Used as fallback option. */
     stripeAccountId?: string;
     /** Stripe webhook signing secret for validating webhook signatures. Required if not using managed webhooks. */
@@ -345,7 +382,7 @@ type StripeSyncConfig = {
      */
     maxConcurrentCustomers?: number;
 };
-type SyncObject = 'all' | 'customer' | 'customer_with_entitlements' | 'invoice' | 'price' | 'product' | 'subscription' | 'subscription_schedules' | 'setup_intent' | 'payment_method' | 'dispute' | 'charge' | 'balance_transaction' | 'payment_intent' | 'plan' | 'tax_id' | 'credit_note' | 'early_fraud_warning' | 'refund' | 'checkout_sessions' | 'subscription_item_change_events_v2_beta' | 'exchange_rates_from_usd';
+type SyncObject = 'all' | 'customer' | 'customer_with_entitlements' | 'invoice' | 'price' | 'product' | 'subscription' | 'subscription_schedules' | 'setup_intent' | 'payment_method' | 'dispute' | 'charge' | 'balance_transaction' | 'payment_intent' | 'plan' | 'tax_id' | 'credit_note' | 'early_fraud_warning' | 'refund' | 'checkout_sessions' | '_event_catchup';
 interface Sync {
     synced: number;
 }
@@ -370,6 +407,8 @@ interface SyncBackfill {
     checkoutSessions?: Sync;
     subscriptionItemChangeEventsV2Beta?: Sync;
     exchangeRatesFromUsd?: Sync;
+    /** Sigma-backed results by table name (e.g. subscription_item_change_events_v2_beta). */
+    sigma?: Record<string, Sync>;
 }
 interface SyncParams {
     created?: {
@@ -412,6 +451,8 @@ interface ProcessNextResult {
     hasMore: boolean;
     /** The sync run this processing belongs to */
     runStartedAt: Date;
+    /** Sigma-only: whether this step started a new Sigma query run */
+    startedQuery?: boolean;
 }
 /**
  * Parameters for processNext() including optional run context
@@ -502,7 +543,12 @@ declare class StripeSync {
     private config;
     stripe: Stripe;
     postgresClient: PostgresClient;
+    private readonly resourceRegistry;
+    private get sigmaSchemaName();
     constructor(config: StripeSyncConfig);
+    private buildResourceRegistry;
+    private isSigmaResource;
+    private sigmaResultKey;
     /**
      * Get the Stripe account ID. Delegates to getCurrentAccount() for the actual lookup.
      */
@@ -545,7 +591,6 @@ declare class StripeSync {
     }>;
     processWebhook(payload: Buffer | string, signature: string | undefined): Promise<void>;
     private readonly eventHandlers;
-    private readonly resourceRegistry;
     processEvent(event: Stripe.Event): Promise<void>;
     /**
      * Returns an array of all webhook event types that this sync engine can handle.
@@ -558,6 +603,13 @@ declare class StripeSync {
      * Order is determined by the `order` field in resourceRegistry.
      */
     getSupportedSyncObjects(): Exclude<SyncObject, 'all' | 'customer_with_entitlements'>[];
+    /**
+     * Get the list of Sigma-backed object types that can be synced.
+     * Only returns sigma objects when enableSigma is true.
+     *
+     * @returns Array of sigma object names (e.g. 'subscription_item_change_events_v2_beta')
+     */
+    getSupportedSigmaObjects(): string[];
     private handleChargeEvent;
     private handleCustomerDeletedEvent;
     private handleCustomerEvent;
@@ -620,6 +672,45 @@ declare class StripeSync {
     private fetchOnePage;
     private getSigmaFallbackCursorFromDestination;
     private fetchOneSigmaPage;
+    /**
+     * Fetch payment methods by iterating customers in batches.
+     *
+     * Most customers have 1-2 PMs, so processing one customer per processNext call
+     * would be extremely wasteful (10,000 customers = 10,000 worker round-trips).
+     * Instead, each call fetches a batch of customers (sized by maxConcurrentCustomers,
+     * default 10) and lists+upserts PMs for all of them concurrently.
+     *
+     * Cursor semantics:
+     * - cursor: max customer `created` timestamp — filters to only new customers on subsequent runs
+     * - pageCursor: last processed customer ID — tracks position in customer iteration
+     */
+    private fetchOnePagePaymentMethods;
+    /**
+     * Fetch the next batch of non-deleted customers for PM sync.
+     * Returns customer IDs and created timestamps, ordered by id ASC.
+     */
+    private findNextCustomerBatchForPmSync;
+    /**
+     * Fetch one page of events from the Stripe Events API and reconcile affected entities.
+     *
+     * Instead of replaying events (which can resurrect deleted objects due to newest-first ordering),
+     * we deduplicate by entity and re-fetch current state from Stripe for each affected entity.
+     *
+     * Cursor: event `created` timestamp. On first run, starts from the sync run's startedAt.
+     * On subsequent runs, picks up where the last completed run left off.
+     */
+    private fetchOnePageEventCatchup;
+    /**
+     * Handle a delete for an entity discovered via event catch-up.
+     * Maps Stripe object types to the appropriate delete method.
+     */
+    private handleEventCatchupDelete;
+    /**
+     * Handle an upsert for an entity discovered via event catch-up.
+     * Re-fetches the current state from Stripe and upserts it.
+     * If the entity has been deleted (404), falls back to the delete handler.
+     */
+    private handleEventCatchupUpsert;
     /**
      * Process all pages for all (or specified) object types until complete.
      *
@@ -651,6 +742,22 @@ declare class StripeSync {
         runKey: RunKey;
         objects: Exclude<SyncObject, 'all' | 'customer_with_entitlements'>[];
     }>;
+    private applySyncBackfillResult;
+    processUntilDoneParallel(params?: SyncParams & {
+        maxParallel?: number;
+        triggeredBy?: string;
+        continueOnError?: boolean;
+        skipInaccessibleSigmaTables?: boolean;
+    }): Promise<{
+        results: SyncBackfill;
+        totals: Record<string, number>;
+        totalSynced: number;
+        skipped: string[];
+        errors: Array<{
+            object: string;
+            message: string;
+        }>;
+    }>;
     processUntilDone(params?: SyncParams): Promise<SyncBackfill>;
     /**
      * Internal implementation of processUntilDone with an existing run.
@@ -771,6 +878,7 @@ type MigrationConfig = {
     databaseUrl: string;
     ssl?: ConnectionOptions;
     logger?: Logger;
+    enableSigma?: boolean;
 };
 declare function runMigrations(config: MigrationConfig): Promise<void>;
 

package/dist/index.js

@@ -5,8 +5,8 @@ import {
   createStripeWebSocketClient,
   hashApiKey,
   runMigrations
-} from "./chunk-UD6RQUDV.js";
-import "./chunk-FII5OTPO.js";
+} from "./chunk-2KB2ISYF.js";
+import "./chunk-E6BGC7CB.js";
 export {
   PostgresClient,
   StripeSync,

package/dist/migrations/0062_sigma_query_runs.sql

@@ -0,0 +1,8 @@
+-- Allow parallel sync runs per triggered_by (sigma-worker vs stripe-worker)
+ALTER TABLE "stripe"."_sync_runs" DROP CONSTRAINT IF EXISTS one_active_run_per_account;
+ALTER TABLE "stripe"."_sync_runs"
+ADD CONSTRAINT one_active_run_per_account_triggered_by
+EXCLUDE (
+  "_account_id" WITH =,
+  COALESCE(triggered_by, 'default') WITH =
+) WHERE (closed_at IS NULL);

package/dist/migrations/0064_add_account_id_indexes.sql

@@ -0,0 +1,120 @@
+-- Add indexes on _account_id for all entity tables
+-- This dramatically improves query performance for multi-tenant queries
+-- like COUNT(*) and MAX(_last_synced_at) filtered by account
+--
+-- CRITICAL: Foreign keys do NOT automatically create indexes in PostgreSQL.
+-- Without these indexes, queries filtering by _account_id do full table scans.
+--
+-- NOTE: Using regular CREATE INDEX (not CONCURRENTLY) because:
+-- 1. pg-node-migrations runs migrations in transactions
+-- 2. CREATE INDEX CONCURRENTLY cannot run inside a transaction
+-- 3. For new deployments, tables are empty so this is instant
+-- 4. For existing deployments, brief lock is acceptable during maintenance window
+
+-- Products (catalog)
+CREATE INDEX IF NOT EXISTS idx_products_account_id
+  ON stripe.products (_account_id);
+CREATE INDEX IF NOT EXISTS idx_products_account_last_synced
+  ON stripe.products (_account_id, _last_synced_at DESC);
+
+-- Prices (catalog)
+CREATE INDEX IF NOT EXISTS idx_prices_account_id
+  ON stripe.prices (_account_id);
+CREATE INDEX IF NOT EXISTS idx_prices_account_last_synced
+  ON stripe.prices (_account_id, _last_synced_at DESC);
+
+-- Plans (catalog)
+CREATE INDEX IF NOT EXISTS idx_plans_account_id
+  ON stripe.plans (_account_id);
+CREATE INDEX IF NOT EXISTS idx_plans_account_last_synced
+  ON stripe.plans (_account_id, _last_synced_at DESC);
+
+-- Customers
+CREATE INDEX IF NOT EXISTS idx_customers_account_id
+  ON stripe.customers (_account_id);
+CREATE INDEX IF NOT EXISTS idx_customers_account_last_synced
+  ON stripe.customers (_account_id, _last_synced_at DESC);
+
+-- Subscriptions
+CREATE INDEX IF NOT EXISTS idx_subscriptions_account_id
+  ON stripe.subscriptions (_account_id);
+CREATE INDEX IF NOT EXISTS idx_subscriptions_account_last_synced
+  ON stripe.subscriptions (_account_id, _last_synced_at DESC);
+
+-- Subscription Schedules
+CREATE INDEX IF NOT EXISTS idx_subscription_schedules_account_id
+  ON stripe.subscription_schedules (_account_id);
+CREATE INDEX IF NOT EXISTS idx_subscription_schedules_account_last_synced
+  ON stripe.subscription_schedules (_account_id, _last_synced_at DESC);
+
+-- Invoices
+CREATE INDEX IF NOT EXISTS idx_invoices_account_id
+  ON stripe.invoices (_account_id);
+CREATE INDEX IF NOT EXISTS idx_invoices_account_last_synced
+  ON stripe.invoices (_account_id, _last_synced_at DESC);
+
+-- Credit Notes
+CREATE INDEX IF NOT EXISTS idx_credit_notes_account_id
+  ON stripe.credit_notes (_account_id);
+CREATE INDEX IF NOT EXISTS idx_credit_notes_account_last_synced
+  ON stripe.credit_notes (_account_id, _last_synced_at DESC);
+
+-- Balance Transactions
+CREATE INDEX IF NOT EXISTS idx_balance_transactions_account_id
+  ON stripe.balance_transactions (_account_id);
+CREATE INDEX IF NOT EXISTS idx_balance_transactions_account_last_synced
+  ON stripe.balance_transactions (_account_id, _last_synced_at DESC);
+
+-- Charges
+CREATE INDEX IF NOT EXISTS idx_charges_account_id
+  ON stripe.charges (_account_id);
+CREATE INDEX IF NOT EXISTS idx_charges_account_last_synced
+  ON stripe.charges (_account_id, _last_synced_at DESC);
+
+-- Payment Intents
+CREATE INDEX IF NOT EXISTS idx_payment_intents_account_id
+  ON stripe.payment_intents (_account_id);
+CREATE INDEX IF NOT EXISTS idx_payment_intents_account_last_synced
+  ON stripe.payment_intents (_account_id, _last_synced_at DESC);
+
+-- Payment Methods
+CREATE INDEX IF NOT EXISTS idx_payment_methods_account_id
+  ON stripe.payment_methods (_account_id);
+CREATE INDEX IF NOT EXISTS idx_payment_methods_account_last_synced
+  ON stripe.payment_methods (_account_id, _last_synced_at DESC);
+
+-- Setup Intents
+CREATE INDEX IF NOT EXISTS idx_setup_intents_account_id
+  ON stripe.setup_intents (_account_id);
+CREATE INDEX IF NOT EXISTS idx_setup_intents_account_last_synced
+  ON stripe.setup_intents (_account_id, _last_synced_at DESC);
+
+-- Refunds
+CREATE INDEX IF NOT EXISTS idx_refunds_account_id
+  ON stripe.refunds (_account_id);
+CREATE INDEX IF NOT EXISTS idx_refunds_account_last_synced
+  ON stripe.refunds (_account_id, _last_synced_at DESC);
+
+-- Checkout Sessions
+CREATE INDEX IF NOT EXISTS idx_checkout_sessions_account_id
+  ON stripe.checkout_sessions (_account_id);
+CREATE INDEX IF NOT EXISTS idx_checkout_sessions_account_last_synced
+  ON stripe.checkout_sessions (_account_id, _last_synced_at DESC);
+
+-- Disputes
+CREATE INDEX IF NOT EXISTS idx_disputes_account_id
+  ON stripe.disputes (_account_id);
+CREATE INDEX IF NOT EXISTS idx_disputes_account_last_synced
+  ON stripe.disputes (_account_id, _last_synced_at DESC);
+
+-- Early Fraud Warnings
+CREATE INDEX IF NOT EXISTS idx_early_fraud_warnings_account_id
+  ON stripe.early_fraud_warnings (_account_id);
+CREATE INDEX IF NOT EXISTS idx_early_fraud_warnings_account_last_synced
+  ON stripe.early_fraud_warnings (_account_id, _last_synced_at DESC);
+
+-- Tax IDs
+CREATE INDEX IF NOT EXISTS idx_tax_ids_account_id
+  ON stripe.tax_ids (_account_id);
+CREATE INDEX IF NOT EXISTS idx_tax_ids_account_last_synced
+  ON stripe.tax_ids (_account_id, _last_synced_at DESC);