stripe-experiment-sync 0.0.4 → 1.0.0

package/dist/migrations/0049_remove_redundant_underscores_from_metadata_tables.sql

@@ -0,0 +1,68 @@
+-- Remove redundant underscore prefixes from columns in metadata tables
+--
+-- For tables that are already prefixed with underscore (indicating they are
+-- metadata/system tables), the underscore prefix on columns is redundant.
+-- This migration removes those redundant prefixes to keep naming cleaner.
+--
+-- Affected tables: _sync_status, _managed_webhooks
+
+-- Create a new trigger function for metadata tables that references updated_at without underscore
+CREATE OR REPLACE FUNCTION set_updated_at_metadata() RETURNS trigger
+    LANGUAGE plpgsql
+AS $$
+begin
+  new.updated_at = now();
+  return NEW;
+end;
+$$;
+
+-- Update _sync_status table
+-- Step 1: Drop constraints and triggers that reference the old column names
+DROP TRIGGER IF EXISTS handle_updated_at ON "stripe"."_sync_status";
+ALTER TABLE "stripe"."_sync_status" DROP CONSTRAINT IF EXISTS _sync_status_resource_account_key;
+ALTER TABLE "stripe"."_sync_status" DROP CONSTRAINT IF EXISTS fk_sync_status_account;
+DROP INDEX IF EXISTS "stripe"."idx_sync_status_resource_account";
+
+-- Step 2: Rename columns
+ALTER TABLE "stripe"."_sync_status" RENAME COLUMN "_id" TO "id";
+ALTER TABLE "stripe"."_sync_status" RENAME COLUMN "_last_synced_at" TO "last_synced_at";
+ALTER TABLE "stripe"."_sync_status" RENAME COLUMN "_updated_at" TO "updated_at";
+ALTER TABLE "stripe"."_sync_status" RENAME COLUMN "_account_id" TO "account_id";
+
+-- Step 3: Recreate constraints and trigger with new column names
+ALTER TABLE "stripe"."_sync_status"
+  ADD CONSTRAINT _sync_status_resource_account_key
+  UNIQUE (resource, "account_id");
+
+CREATE INDEX IF NOT EXISTS idx_sync_status_resource_account
+  ON "stripe"."_sync_status" (resource, "account_id");
+
+ALTER TABLE "stripe"."_sync_status"
+  ADD CONSTRAINT fk_sync_status_account
+  FOREIGN KEY ("account_id") REFERENCES "stripe"."accounts" ("_id");
+
+CREATE TRIGGER handle_updated_at
+  BEFORE UPDATE ON "stripe"."_sync_status"
+  FOR EACH ROW
+  EXECUTE PROCEDURE set_updated_at_metadata();
+
+-- Update _managed_webhooks table
+-- Step 1: Drop constraints and triggers that reference the old column names
+DROP TRIGGER IF EXISTS handle_updated_at ON "stripe"."_managed_webhooks";
+ALTER TABLE "stripe"."_managed_webhooks" DROP CONSTRAINT IF EXISTS fk_managed_webhooks_account;
+
+-- Step 2: Rename columns
+ALTER TABLE "stripe"."_managed_webhooks" RENAME COLUMN "_id" TO "id";
+ALTER TABLE "stripe"."_managed_webhooks" RENAME COLUMN "_last_synced_at" TO "last_synced_at";
+ALTER TABLE "stripe"."_managed_webhooks" RENAME COLUMN "_updated_at" TO "updated_at";
+ALTER TABLE "stripe"."_managed_webhooks" RENAME COLUMN "_account_id" TO "account_id";
+
+-- Step 3: Recreate foreign key constraint and trigger with new column names
+ALTER TABLE "stripe"."_managed_webhooks"
+  ADD CONSTRAINT fk_managed_webhooks_account
+  FOREIGN KEY ("account_id") REFERENCES "stripe"."accounts" ("_id");
+
+CREATE TRIGGER handle_updated_at
+  BEFORE UPDATE ON "stripe"."_managed_webhooks"
+  FOR EACH ROW
+  EXECUTE PROCEDURE set_updated_at_metadata();

package/dist/migrations/0050_rename_id_to_match_stripe_api.sql

@@ -0,0 +1,239 @@
+-- Rename _id back to id to match Stripe API field names
+--
+-- Migration 0048 added underscore prefixes to all "reserved" columns including id.
+-- However, id is actually a field that comes directly from the Stripe API and should
+-- match the API naming for agent/user comprehension.
+--
+-- Additionally, this migration converts id from a regular column to a GENERATED column
+-- derived from _raw_data->>'id', ensuring the raw_data is the single source of truth.
+
+-- ============================================================================
+-- Step 1: Drop all foreign key constraints referencing accounts._id
+-- ============================================================================
+
+ALTER TABLE "stripe"."active_entitlements" DROP CONSTRAINT IF EXISTS fk_active_entitlements_account;
+ALTER TABLE "stripe"."charges" DROP CONSTRAINT IF EXISTS fk_charges_account;
+ALTER TABLE "stripe"."checkout_session_line_items" DROP CONSTRAINT IF EXISTS fk_checkout_session_line_items_account;
+ALTER TABLE "stripe"."checkout_sessions" DROP CONSTRAINT IF EXISTS fk_checkout_sessions_account;
+ALTER TABLE "stripe"."credit_notes" DROP CONSTRAINT IF EXISTS fk_credit_notes_account;
+ALTER TABLE "stripe"."customers" DROP CONSTRAINT IF EXISTS fk_customers_account;
+ALTER TABLE "stripe"."disputes" DROP CONSTRAINT IF EXISTS fk_disputes_account;
+ALTER TABLE "stripe"."early_fraud_warnings" DROP CONSTRAINT IF EXISTS fk_early_fraud_warnings_account;
+ALTER TABLE "stripe"."features" DROP CONSTRAINT IF EXISTS fk_features_account;
+ALTER TABLE "stripe"."invoices" DROP CONSTRAINT IF EXISTS fk_invoices_account;
+ALTER TABLE "stripe"."_managed_webhooks" DROP CONSTRAINT IF EXISTS fk_managed_webhooks_account;
+ALTER TABLE "stripe"."payment_intents" DROP CONSTRAINT IF EXISTS fk_payment_intents_account;
+ALTER TABLE "stripe"."payment_methods" DROP CONSTRAINT IF EXISTS fk_payment_methods_account;
+ALTER TABLE "stripe"."plans" DROP CONSTRAINT IF EXISTS fk_plans_account;
+ALTER TABLE "stripe"."prices" DROP CONSTRAINT IF EXISTS fk_prices_account;
+ALTER TABLE "stripe"."products" DROP CONSTRAINT IF EXISTS fk_products_account;
+ALTER TABLE "stripe"."refunds" DROP CONSTRAINT IF EXISTS fk_refunds_account;
+ALTER TABLE "stripe"."reviews" DROP CONSTRAINT IF EXISTS fk_reviews_account;
+ALTER TABLE "stripe"."setup_intents" DROP CONSTRAINT IF EXISTS fk_setup_intents_account;
+ALTER TABLE "stripe"."subscription_items" DROP CONSTRAINT IF EXISTS fk_subscription_items_account;
+ALTER TABLE "stripe"."subscription_schedules" DROP CONSTRAINT IF EXISTS fk_subscription_schedules_account;
+ALTER TABLE "stripe"."subscriptions" DROP CONSTRAINT IF EXISTS fk_subscriptions_account;
+ALTER TABLE "stripe"."tax_ids" DROP CONSTRAINT IF EXISTS fk_tax_ids_account;
+ALTER TABLE "stripe"."_sync_status" DROP CONSTRAINT IF EXISTS fk_sync_status_account;
+
+-- ============================================================================
+-- Step 2: Convert accounts._id to generated column accounts.id
+-- ============================================================================
+
+ALTER TABLE "stripe"."accounts" DROP CONSTRAINT IF EXISTS accounts_pkey;
+ALTER TABLE "stripe"."accounts" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."accounts" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."accounts" ADD PRIMARY KEY (id);
+
+-- ============================================================================
+-- Step 3: Convert _id to generated column id for all Stripe entity tables
+-- ============================================================================
+
+-- active_entitlements
+ALTER TABLE "stripe"."active_entitlements" DROP CONSTRAINT IF EXISTS active_entitlements_pkey;
+ALTER TABLE "stripe"."active_entitlements" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."active_entitlements" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."active_entitlements" ADD PRIMARY KEY (id);
+
+-- charges
+ALTER TABLE "stripe"."charges" DROP CONSTRAINT IF EXISTS charges_pkey;
+ALTER TABLE "stripe"."charges" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."charges" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."charges" ADD PRIMARY KEY (id);
+
+-- checkout_session_line_items
+ALTER TABLE "stripe"."checkout_session_line_items" DROP CONSTRAINT IF EXISTS checkout_session_line_items_pkey;
+ALTER TABLE "stripe"."checkout_session_line_items" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."checkout_session_line_items" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."checkout_session_line_items" ADD PRIMARY KEY (id);
+
+-- checkout_sessions
+ALTER TABLE "stripe"."checkout_sessions" DROP CONSTRAINT IF EXISTS checkout_sessions_pkey;
+ALTER TABLE "stripe"."checkout_sessions" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."checkout_sessions" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."checkout_sessions" ADD PRIMARY KEY (id);
+
+-- credit_notes
+ALTER TABLE "stripe"."credit_notes" DROP CONSTRAINT IF EXISTS credit_notes_pkey;
+ALTER TABLE "stripe"."credit_notes" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."credit_notes" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."credit_notes" ADD PRIMARY KEY (id);
+
+-- coupons
+ALTER TABLE "stripe"."coupons" DROP CONSTRAINT IF EXISTS coupons_pkey;
+ALTER TABLE "stripe"."coupons" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."coupons" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."coupons" ADD PRIMARY KEY (id);
+
+-- customers
+ALTER TABLE "stripe"."customers" DROP CONSTRAINT IF EXISTS customers_pkey;
+ALTER TABLE "stripe"."customers" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."customers" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."customers" ADD PRIMARY KEY (id);
+
+-- disputes
+ALTER TABLE "stripe"."disputes" DROP CONSTRAINT IF EXISTS disputes_pkey;
+ALTER TABLE "stripe"."disputes" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."disputes" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."disputes" ADD PRIMARY KEY (id);
+
+-- early_fraud_warnings
+ALTER TABLE "stripe"."early_fraud_warnings" DROP CONSTRAINT IF EXISTS early_fraud_warnings_pkey;
+ALTER TABLE "stripe"."early_fraud_warnings" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."early_fraud_warnings" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."early_fraud_warnings" ADD PRIMARY KEY (id);
+
+-- events
+ALTER TABLE "stripe"."events" DROP CONSTRAINT IF EXISTS events_pkey;
+ALTER TABLE "stripe"."events" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."events" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."events" ADD PRIMARY KEY (id);
+
+-- features
+ALTER TABLE "stripe"."features" DROP CONSTRAINT IF EXISTS features_pkey;
+ALTER TABLE "stripe"."features" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."features" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."features" ADD PRIMARY KEY (id);
+
+-- invoices
+ALTER TABLE "stripe"."invoices" DROP CONSTRAINT IF EXISTS invoices_pkey;
+ALTER TABLE "stripe"."invoices" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."invoices" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."invoices" ADD PRIMARY KEY (id);
+
+-- payment_intents
+ALTER TABLE "stripe"."payment_intents" DROP CONSTRAINT IF EXISTS payment_intents_pkey;
+ALTER TABLE "stripe"."payment_intents" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."payment_intents" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."payment_intents" ADD PRIMARY KEY (id);
+
+-- payment_methods
+ALTER TABLE "stripe"."payment_methods" DROP CONSTRAINT IF EXISTS payment_methods_pkey;
+ALTER TABLE "stripe"."payment_methods" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."payment_methods" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."payment_methods" ADD PRIMARY KEY (id);
+
+-- payouts
+ALTER TABLE "stripe"."payouts" DROP CONSTRAINT IF EXISTS payouts_pkey;
+ALTER TABLE "stripe"."payouts" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."payouts" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."payouts" ADD PRIMARY KEY (id);
+
+-- plans
+ALTER TABLE "stripe"."plans" DROP CONSTRAINT IF EXISTS plans_pkey;
+ALTER TABLE "stripe"."plans" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."plans" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."plans" ADD PRIMARY KEY (id);
+
+-- prices
+ALTER TABLE "stripe"."prices" DROP CONSTRAINT IF EXISTS prices_pkey;
+ALTER TABLE "stripe"."prices" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."prices" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."prices" ADD PRIMARY KEY (id);
+
+-- products
+ALTER TABLE "stripe"."products" DROP CONSTRAINT IF EXISTS products_pkey;
+ALTER TABLE "stripe"."products" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."products" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."products" ADD PRIMARY KEY (id);
+
+-- refunds
+ALTER TABLE "stripe"."refunds" DROP CONSTRAINT IF EXISTS refunds_pkey;
+ALTER TABLE "stripe"."refunds" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."refunds" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."refunds" ADD PRIMARY KEY (id);
+
+-- reviews
+ALTER TABLE "stripe"."reviews" DROP CONSTRAINT IF EXISTS reviews_pkey;
+ALTER TABLE "stripe"."reviews" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."reviews" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."reviews" ADD PRIMARY KEY (id);
+
+-- setup_intents
+ALTER TABLE "stripe"."setup_intents" DROP CONSTRAINT IF EXISTS setup_intents_pkey;
+ALTER TABLE "stripe"."setup_intents" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."setup_intents" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."setup_intents" ADD PRIMARY KEY (id);
+
+-- subscription_items
+ALTER TABLE "stripe"."subscription_items" DROP CONSTRAINT IF EXISTS subscription_items_pkey;
+ALTER TABLE "stripe"."subscription_items" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."subscription_items" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."subscription_items" ADD PRIMARY KEY (id);
+
+-- subscription_schedules
+ALTER TABLE "stripe"."subscription_schedules" DROP CONSTRAINT IF EXISTS subscription_schedules_pkey;
+ALTER TABLE "stripe"."subscription_schedules" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."subscription_schedules" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."subscription_schedules" ADD PRIMARY KEY (id);
+
+-- subscriptions
+ALTER TABLE "stripe"."subscriptions" DROP CONSTRAINT IF EXISTS subscriptions_pkey;
+ALTER TABLE "stripe"."subscriptions" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."subscriptions" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."subscriptions" ADD PRIMARY KEY (id);
+
+-- tax_ids
+ALTER TABLE "stripe"."tax_ids" DROP CONSTRAINT IF EXISTS tax_ids_pkey;
+ALTER TABLE "stripe"."tax_ids" DROP COLUMN IF EXISTS "_id";
+ALTER TABLE "stripe"."tax_ids" ADD COLUMN "id" TEXT GENERATED ALWAYS AS ((_raw_data->>'id')::TEXT) STORED;
+ALTER TABLE "stripe"."tax_ids" ADD PRIMARY KEY (id);
+
+-- ============================================================================
+-- Step 4: Handle metadata tables
+-- ============================================================================
+
+-- _managed_webhooks (internal metadata table, doesn't use _raw_data pattern)
+-- Already uses "id" without underscore (migration 0049), no changes needed
+
+-- _sync_status (internal table, uses auto-incrementing id not from Stripe)
+-- Already uses "id" without underscore (migration 0049), no changes needed
+
+-- ============================================================================
+-- Step 5: Recreate all foreign key constraints
+-- ============================================================================
+
+ALTER TABLE "stripe"."active_entitlements" ADD CONSTRAINT fk_active_entitlements_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."charges" ADD CONSTRAINT fk_charges_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."checkout_session_line_items" ADD CONSTRAINT fk_checkout_session_line_items_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."checkout_sessions" ADD CONSTRAINT fk_checkout_sessions_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."credit_notes" ADD CONSTRAINT fk_credit_notes_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."customers" ADD CONSTRAINT fk_customers_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."disputes" ADD CONSTRAINT fk_disputes_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."early_fraud_warnings" ADD CONSTRAINT fk_early_fraud_warnings_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."features" ADD CONSTRAINT fk_features_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."invoices" ADD CONSTRAINT fk_invoices_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."_managed_webhooks" ADD CONSTRAINT fk_managed_webhooks_account FOREIGN KEY ("account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."payment_intents" ADD CONSTRAINT fk_payment_intents_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."payment_methods" ADD CONSTRAINT fk_payment_methods_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."plans" ADD CONSTRAINT fk_plans_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."prices" ADD CONSTRAINT fk_prices_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."products" ADD CONSTRAINT fk_products_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."refunds" ADD CONSTRAINT fk_refunds_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."reviews" ADD CONSTRAINT fk_reviews_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."setup_intents" ADD CONSTRAINT fk_setup_intents_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."subscription_items" ADD CONSTRAINT fk_subscription_items_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."subscription_schedules" ADD CONSTRAINT fk_subscription_schedules_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."subscriptions" ADD CONSTRAINT fk_subscriptions_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."tax_ids" ADD CONSTRAINT fk_tax_ids_account FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id);
+ALTER TABLE "stripe"."_sync_status" ADD CONSTRAINT fk_sync_status_account FOREIGN KEY ("account_id") REFERENCES "stripe"."accounts" (id);

package/dist/migrations/0051_remove_webhook_uuid.sql

@@ -0,0 +1,7 @@
+-- Remove UUID from managed webhooks
+-- UUID-based routing is no longer used; webhooks are identified by exact URL match
+-- Legacy webhooks with UUID in URL will be automatically deleted and recreated
+
+drop index if exists "stripe"."stripe_managed_webhooks_uuid_idx";
+
+alter table "stripe"."_managed_webhooks" drop column if exists "uuid";

package/dist/migrations/0052_webhook_url_uniqueness.sql

@@ -0,0 +1,7 @@
+-- Add unique constraint on URL per account to prevent duplicate webhooks at database level
+-- This prevents race conditions where multiple instances try to create webhooks for the same URL
+-- Since UUIDs have been removed from URLs, we can enforce strict uniqueness on the URL column per account
+-- Note: Different accounts can have webhooks with the same URL
+
+alter table "stripe"."_managed_webhooks"
+  add constraint managed_webhooks_url_account_unique unique ("url", "account_id");

package/dist/migrations/0053_sync_observability.sql

@@ -0,0 +1,104 @@
+-- Observable Sync System: Track sync runs and individual object syncs
+-- Enables observability for long-running syncs (days, not minutes)
+--
+-- Two-level hierarchy:
+--   _sync_run: Parent sync operation (one active per account)
+--   _sync_obj_run: Individual object syncs within a run
+--
+-- Features:
+--   - Only one active run per account (EXCLUDE constraint)
+--   - Configurable object concurrency (max_concurrent)
+--   - Stale detection (is_stale in dashboard view)
+--   - Progress tracking per object
+
+-- Step 1: Create _sync_run table (parent sync operation)
+CREATE TABLE IF NOT EXISTS "stripe"."_sync_run" (
+  "_account_id" TEXT NOT NULL,
+  started_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  status TEXT NOT NULL DEFAULT 'running' CHECK (status IN ('running', 'complete', 'error')),
+  max_concurrent INTEGER NOT NULL DEFAULT 3,
+  completed_at TIMESTAMPTZ,
+  error_message TEXT,
+  triggered_by TEXT,
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  PRIMARY KEY ("_account_id", started_at),
+
+  -- Only one active run per account
+  CONSTRAINT one_active_run_per_account
+    EXCLUDE ("_account_id" WITH =) WHERE (status = 'running'),
+
+  -- Foreign key to accounts table
+  CONSTRAINT fk_sync_run_account
+    FOREIGN KEY ("_account_id") REFERENCES "stripe"."accounts" (id)
+);
+
+-- Step 2: Add updated_at trigger for _sync_run
+-- Use set_updated_at_metadata() since this is a metadata table with updated_at (not _updated_at)
+CREATE TRIGGER handle_updated_at
+  BEFORE UPDATE ON "stripe"."_sync_run"
+  FOR EACH ROW
+  EXECUTE PROCEDURE set_updated_at_metadata();
+
+-- Step 3: Create _sync_obj_run table (individual object syncs)
+CREATE TABLE IF NOT EXISTS "stripe"."_sync_obj_run" (
+  "_account_id" TEXT NOT NULL,
+  run_started_at TIMESTAMPTZ NOT NULL,
+  object TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'running', 'complete', 'error')),
+  started_at TIMESTAMPTZ,
+  completed_at TIMESTAMPTZ,
+  processed_count INTEGER DEFAULT 0,
+  cursor TEXT,
+  error_message TEXT,
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+
+  PRIMARY KEY ("_account_id", run_started_at, object),
+
+  -- Foreign key to parent sync run
+  CONSTRAINT fk_sync_obj_run_parent
+    FOREIGN KEY ("_account_id", run_started_at) REFERENCES "stripe"."_sync_run" ("_account_id", started_at)
+);
+
+-- Step 4: Add updated_at trigger for _sync_obj_run
+-- Use set_updated_at_metadata() since this is a metadata table with updated_at (not _updated_at)
+CREATE TRIGGER handle_updated_at
+  BEFORE UPDATE ON "stripe"."_sync_obj_run"
+  FOR EACH ROW
+  EXECUTE PROCEDURE set_updated_at_metadata();
+
+-- Step 5: Create indexes for efficient queries
+CREATE INDEX IF NOT EXISTS idx_sync_run_account_status
+  ON "stripe"."_sync_run" ("_account_id", status);
+
+CREATE INDEX IF NOT EXISTS idx_sync_obj_run_status
+  ON "stripe"."_sync_obj_run" ("_account_id", run_started_at, status);
+
+-- Step 6: Create sync_dashboard view for observability
+CREATE OR REPLACE VIEW "stripe"."sync_dashboard" AS
+SELECT
+  r."_account_id" as account_id,
+  r.started_at as run_started_at,
+  r.status as run_status,
+  r.completed_at as run_completed_at,
+  r.max_concurrent,
+  r.triggered_by,
+  o.object,
+  o.status as object_status,
+  o.started_at as object_started_at,
+  o.completed_at as object_completed_at,
+  o.processed_count,
+  o.error_message,
+  o.updated_at,
+  -- Duration in seconds
+  EXTRACT(EPOCH FROM (COALESCE(o.completed_at, now()) - o.started_at))::integer as duration_seconds,
+  -- Stale detection: running but no update in 5 min
+  CASE
+    WHEN o.status = 'running' AND o.updated_at < now() - interval '5 minutes'
+    THEN true
+    ELSE false
+  END as is_stale
+FROM "stripe"."_sync_run" r
+LEFT JOIN "stripe"."_sync_obj_run" o
+  ON o."_account_id" = r."_account_id"
+  AND o.run_started_at = r.started_at;

package/dist/migrations/0054_drop_sync_status.sql

@@ -0,0 +1,5 @@
+-- Drop the old _sync_status table
+-- This table has been replaced by _sync_run and _sync_obj_run for better observability
+-- See migration 0053_sync_observability.sql
+
+DROP TABLE IF EXISTS "stripe"."_sync_status";

package/dist/pg.cjs

@@ -0,0 +1,87 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/pg.ts
+var pg_exports = {};
+__export(pg_exports, {
+  PgAdapter: () => PgAdapter
+});
+module.exports = __toCommonJS(pg_exports);
+
+// src/database/pg-adapter.ts
+var import_pg = __toESM(require("pg"), 1);
+var PgAdapter = class {
+  pool;
+  constructor(config) {
+    this.pool = new import_pg.default.Pool(config);
+  }
+  async query(sql, params) {
+    const result = await this.pool.query(sql, params);
+    return {
+      rows: result.rows,
+      rowCount: result.rowCount ?? 0
+    };
+  }
+  async end() {
+    await this.pool.end();
+  }
+  /**
+   * Execute a function while holding a PostgreSQL advisory lock.
+   * Uses a dedicated connection to ensure lock is held for the duration.
+   */
+  async withAdvisoryLock(lockId, fn) {
+    const client = await this.pool.connect();
+    try {
+      await client.query("SELECT pg_advisory_lock($1)", [lockId]);
+      return await fn();
+    } finally {
+      try {
+        await client.query("SELECT pg_advisory_unlock($1)", [lockId]);
+      } finally {
+        client.release();
+      }
+    }
+  }
+  /**
+   * Returns a pg-compatible client for use with libraries that expect pg.Client.
+   * Used by pg-node-migrations to run database migrations.
+   */
+  toPgClient() {
+    return {
+      query: async (sql) => {
+        const result = typeof sql === "string" ? await this.pool.query(sql) : await this.pool.query(sql.text, sql.values);
+        return { rows: result.rows, rowCount: result.rowCount ?? 0 };
+      }
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PgAdapter
+});

package/dist/pg.d.cts

@@ -0,0 +1,28 @@
+import { PoolConfig } from 'pg';
+import { D as DatabaseAdapter, P as PgCompatibleClient } from './adapter-BtXT5w9r.cjs';
+
+/**
+ * Database adapter implementation using node-postgres (pg).
+ * This is the default adapter for Node.js environments.
+ */
+declare class PgAdapter implements DatabaseAdapter {
+    private pool;
+    constructor(config: PoolConfig);
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number;
+    }>;
+    end(): Promise<void>;
+    /**
+     * Execute a function while holding a PostgreSQL advisory lock.
+     * Uses a dedicated connection to ensure lock is held for the duration.
+     */
+    withAdvisoryLock<T>(lockId: number, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Returns a pg-compatible client for use with libraries that expect pg.Client.
+     * Used by pg-node-migrations to run database migrations.
+     */
+    toPgClient(): PgCompatibleClient;
+}
+
+export { PgAdapter };

package/dist/pg.d.ts

@@ -0,0 +1,28 @@
+import { PoolConfig } from 'pg';
+import { D as DatabaseAdapter, P as PgCompatibleClient } from './adapter-BtXT5w9r.js';
+
+/**
+ * Database adapter implementation using node-postgres (pg).
+ * This is the default adapter for Node.js environments.
+ */
+declare class PgAdapter implements DatabaseAdapter {
+    private pool;
+    constructor(config: PoolConfig);
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number;
+    }>;
+    end(): Promise<void>;
+    /**
+     * Execute a function while holding a PostgreSQL advisory lock.
+     * Uses a dedicated connection to ensure lock is held for the duration.
+     */
+    withAdvisoryLock<T>(lockId: number, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Returns a pg-compatible client for use with libraries that expect pg.Client.
+     * Used by pg-node-migrations to run database migrations.
+     */
+    toPgClient(): PgCompatibleClient;
+}
+
+export { PgAdapter };

package/dist/pg.js

@@ -0,0 +1,50 @@
+// src/database/pg-adapter.ts
+import pg from "pg";
+var PgAdapter = class {
+  pool;
+  constructor(config) {
+    this.pool = new pg.Pool(config);
+  }
+  async query(sql, params) {
+    const result = await this.pool.query(sql, params);
+    return {
+      rows: result.rows,
+      rowCount: result.rowCount ?? 0
+    };
+  }
+  async end() {
+    await this.pool.end();
+  }
+  /**
+   * Execute a function while holding a PostgreSQL advisory lock.
+   * Uses a dedicated connection to ensure lock is held for the duration.
+   */
+  async withAdvisoryLock(lockId, fn) {
+    const client = await this.pool.connect();
+    try {
+      await client.query("SELECT pg_advisory_lock($1)", [lockId]);
+      return await fn();
+    } finally {
+      try {
+        await client.query("SELECT pg_advisory_unlock($1)", [lockId]);
+      } finally {
+        client.release();
+      }
+    }
+  }
+  /**
+   * Returns a pg-compatible client for use with libraries that expect pg.Client.
+   * Used by pg-node-migrations to run database migrations.
+   */
+  toPgClient() {
+    return {
+      query: async (sql) => {
+        const result = typeof sql === "string" ? await this.pool.query(sql) : await this.pool.query(sql.text, sql.values);
+        return { rows: result.rows, rowCount: result.rowCount ?? 0 };
+      }
+    };
+  }
+};
+export {
+  PgAdapter
+};