stripe-experiment-sync 1.0.3 → 1.0.7

package/dist/migrations/0057_rename_sync_tables.sql

@@ -0,0 +1,57 @@
+-- Rename sync observability tables and create public sync_runs view
+-- Internal tables use _ prefix, public view is sync_runs
+
+-- Step 1: Drop the old sync_dashboard view
+DROP VIEW IF EXISTS "stripe"."sync_dashboard";
+
+-- Step 2: Rename tables to plural (keep _ prefix for internal tables)
+ALTER TABLE "stripe"."_sync_run" RENAME TO "_sync_runs";
+ALTER TABLE "stripe"."_sync_obj_run" RENAME TO "_sync_obj_runs";
+
+-- Step 3: Update foreign key constraint name
+ALTER TABLE "stripe"."_sync_obj_runs"
+  DROP CONSTRAINT IF EXISTS fk_sync_obj_run_parent;
+
+ALTER TABLE "stripe"."_sync_obj_runs"
+  ADD CONSTRAINT fk_sync_obj_runs_parent
+    FOREIGN KEY ("_account_id", run_started_at)
+    REFERENCES "stripe"."_sync_runs" ("_account_id", started_at);
+
+-- Step 4: Recreate indexes with new table names
+DROP INDEX IF EXISTS "stripe"."idx_sync_run_account_status";
+DROP INDEX IF EXISTS "stripe"."idx_sync_obj_run_status";
+
+CREATE INDEX idx_sync_runs_account_status
+  ON "stripe"."_sync_runs" ("_account_id", closed_at);
+
+CREATE INDEX idx_sync_obj_runs_status
+  ON "stripe"."_sync_obj_runs" ("_account_id", run_started_at, status);
+
+-- Step 5: Create public sync_runs view (one row per run with aggregates)
+CREATE VIEW "stripe"."sync_runs" AS
+SELECT
+  r._account_id as account_id,
+  r.started_at,
+  r.closed_at,
+  r.triggered_by,
+  r.max_concurrent,
+  -- Aggregate metrics from child objects
+  COALESCE(SUM(o.processed_count), 0) as total_processed,
+  COUNT(o.*) as total_objects,
+  COUNT(*) FILTER (WHERE o.status = 'complete') as complete_count,
+  COUNT(*) FILTER (WHERE o.status = 'error') as error_count,
+  COUNT(*) FILTER (WHERE o.status = 'running') as running_count,
+  COUNT(*) FILTER (WHERE o.status = 'pending') as pending_count,
+  -- Collect error messages if any
+  STRING_AGG(o.error_message, '; ') FILTER (WHERE o.error_message IS NOT NULL) as error_message,
+  -- Derive overall status from run state and object states
+  CASE
+    WHEN r.closed_at IS NULL THEN 'running'
+    WHEN COUNT(*) FILTER (WHERE o.status = 'error') > 0 THEN 'error'
+    ELSE 'complete'
+  END as status
+FROM "stripe"."_sync_runs" r
+LEFT JOIN "stripe"."_sync_obj_runs" o
+  ON o._account_id = r._account_id
+  AND o.run_started_at = r.started_at
+GROUP BY r._account_id, r.started_at, r.closed_at, r.triggered_by, r.max_concurrent;

package/dist/supabase/index.cjs

@@ -30,7 +30,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/supabase/index.ts
 var supabase_exports = {};
 __export(supabase_exports, {
-  SupabaseDeployClient: () => SupabaseDeployClient,
+  INSTALLATION_ERROR_SUFFIX: () => INSTALLATION_ERROR_SUFFIX,
+  INSTALLATION_INSTALLED_SUFFIX: () => INSTALLATION_INSTALLED_SUFFIX,
+  INSTALLATION_STARTED_SUFFIX: () => INSTALLATION_STARTED_SUFFIX,
+  STRIPE_SCHEMA_COMMENT_PREFIX: () => STRIPE_SCHEMA_COMMENT_PREFIX,
+  SupabaseDeployClient: () => SupabaseSetupClient,
+  SupabaseSetupClient: () => SupabaseSetupClient,
   install: () => install,
   setupFunctionCode: () => setupFunctionCode,
   uninstall: () => uninstall,
@@ -59,12 +64,12 @@ var workerFunctionCode = stripe_worker_default;
 // package.json
 var package_default = {
   name: "stripe-experiment-sync",
-  version: "1.0.3",
+  version: "1.0.7",
   private: false,
   description: "Stripe Sync Engine to sync Stripe data to Postgres",
   type: "module",
   main: "./dist/index.cjs",
-  bin: "./dist/cli/index.cjs",
+  bin: "./dist/cli/index.js",
   exports: {
     ".": {
       types: "./dist/index.d.ts",
@@ -75,12 +80,17 @@ var package_default = {
       types: "./dist/supabase/index.d.ts",
       import: "./dist/supabase/index.js",
       require: "./dist/supabase/index.cjs"
+    },
+    "./cli": {
+      types: "./dist/cli/lib.d.ts",
+      import: "./dist/cli/lib.js",
+      require: "./dist/cli/lib.cjs"
     }
   },
   scripts: {
     clean: "rimraf dist",
     prebuild: "npm run clean",
-    build: "tsup src/index.ts src/supabase/index.ts --format esm,cjs --dts --shims && cp -r src/database/migrations dist/migrations",
+    build: "tsup src/index.ts src/supabase/index.ts src/cli/index.ts src/cli/lib.ts --format esm,cjs --dts --shims && cp -r src/database/migrations dist/migrations",
     lint: "eslint src --ext .ts",
     test: "vitest"
   },
@@ -88,21 +98,28 @@ var package_default = {
     "dist"
   ],
   dependencies: {
+    "@ngrok/ngrok": "^1.4.1",
+    chalk: "^5.3.0",
+    commander: "^12.1.0",
+    dotenv: "^16.4.7",
+    express: "^4.18.2",
+    inquirer: "^12.3.0",
     pg: "^8.16.3",
     "pg-node-migrations": "0.0.8",
+    stripe: "^17.7.0",
     "supabase-management-js": "^0.1.6",
     ws: "^8.18.0",
     yesql: "^7.0.0"
   },
-  peerDependencies: {
-    stripe: "> 11"
-  },
   devDependencies: {
+    "@types/express": "^4.17.21",
+    "@types/inquirer": "^9.0.7",
     "@types/node": "^24.10.1",
     "@types/pg": "^8.15.5",
     "@types/ws": "^8.5.13",
     "@types/yesql": "^4.1.4",
     "@vitest/ui": "^4.0.9",
+    tsx: "^4.19.2",
     vitest: "^3.2.4"
   },
   repository: {
@@ -128,14 +145,21 @@ var package_default = {
 
 // src/supabase/supabase.ts
 var import_stripe = __toESM(require("stripe"), 1);
-var SupabaseDeployClient = class {
+var STRIPE_SCHEMA_COMMENT_PREFIX = "stripe-sync";
+var INSTALLATION_STARTED_SUFFIX = "installation:started";
+var INSTALLATION_ERROR_SUFFIX = "installation:error";
+var INSTALLATION_INSTALLED_SUFFIX = "installed";
+var SupabaseSetupClient = class {
   api;
   projectRef;
-  baseUrl;
+  projectBaseUrl;
   constructor(options) {
-    this.api = new import_supabase_management_js.SupabaseManagementAPI({ accessToken: options.accessToken });
+    this.api = new import_supabase_management_js.SupabaseManagementAPI({
+      accessToken: options.accessToken,
+      baseUrl: options.managementApiBaseUrl
+    });
     this.projectRef = options.projectRef;
-    this.baseUrl = options.baseUrl || process.env.SUPABASE_BASE_URL || "supabase.co";
+    this.projectBaseUrl = options.projectBaseUrl || process.env.SUPABASE_BASE_URL || "supabase.co";
   }
   /**
    * Validate that the project exists and we have access
@@ -222,7 +246,7 @@ var SupabaseDeployClient = class {
         '10 seconds',
         $$
         SELECT net.http_post(
-          url := 'https://${this.projectRef}.${this.baseUrl}/functions/v1/stripe-worker',
+          url := 'https://${this.projectRef}.${this.projectBaseUrl}/functions/v1/stripe-worker',
           headers := jsonb_build_object(
             'Authorization', 'Bearer ' || (SELECT decrypted_secret FROM vault.decrypted_secrets WHERE name = 'stripe_sync_service_role_key')
           )
@@ -236,7 +260,7 @@ var SupabaseDeployClient = class {
    * Get the webhook URL for this project
    */
   getWebhookUrl() {
-    return `https://${this.projectRef}.${this.baseUrl}/functions/v1/stripe-webhook`;
+    return `https://${this.projectRef}.${this.projectBaseUrl}/functions/v1/stripe-webhook`;
   }
   /**
    * Get the service role key for this project (needed to invoke Edge Functions)
@@ -264,13 +288,13 @@ var SupabaseDeployClient = class {
    * Get the project URL
    */
   getProjectUrl() {
-    return `https://${this.projectRef}.${this.baseUrl}`;
+    return `https://${this.projectRef}.${this.projectBaseUrl}`;
   }
   /**
    * Invoke an Edge Function
    */
   async invokeFunction(name, serviceRoleKey) {
-    const url = `https://${this.projectRef}.${this.baseUrl}/functions/v1/${name}`;
+    const url = `https://${this.projectRef}.${this.projectBaseUrl}/functions/v1/${name}`;
     const response = await fetch(url, {
       method: "POST",
       headers: {
@@ -327,15 +351,15 @@ var SupabaseDeployClient = class {
          WHERE nspname = '${schema}'`
       );
       const comment = commentCheck[0]?.rows?.[0]?.comment;
-      if (!comment || !comment.includes("stripe-sync")) {
+      if (!comment || !comment.includes(STRIPE_SCHEMA_COMMENT_PREFIX)) {
         throw new Error(
           `Legacy installation detected: Schema '${schema}' and migrations table exist, but missing stripe-sync comment marker. This may be a legacy installation or manually created schema. Please contact support or manually drop the schema before proceeding.`
         );
       }
-      if (comment.includes("installation:started")) {
+      if (comment.includes(INSTALLATION_STARTED_SUFFIX)) {
         return false;
       }
-      if (comment.includes("installation:error")) {
+      if (comment.includes(INSTALLATION_ERROR_SUFFIX)) {
         throw new Error(
           `Installation failed: Schema '${schema}' exists but installation encountered an error. Comment: ${comment}. Please uninstall and install again.`
         );
@@ -380,7 +404,7 @@ var SupabaseDeployClient = class {
    * Removes all Edge Functions, secrets, database resources, and Stripe webhooks
    */
   async uninstall(stripeSecretKey) {
-    const stripe = new import_stripe.default(stripeSecretKey, { apiVersion: "2025-05-28.basil" });
+    const stripe = new import_stripe.default(stripeSecretKey, { apiVersion: "2025-02-24.acacia" });
     try {
       try {
         const webhookResult = await this.runSQL(`
@@ -424,41 +448,60 @@ var SupabaseDeployClient = class {
       throw new Error(`Uninstall failed: ${error instanceof Error ? error.message : String(error)}`);
     }
   }
+  async install(stripeKey) {
+    const trimmedStripeKey = stripeKey.trim();
+    if (!trimmedStripeKey.startsWith("sk_") && !trimmedStripeKey.startsWith("rk_")) {
+      throw new Error('Stripe key should start with "sk_" or "rk_"');
+    }
+    try {
+      await this.validateProject();
+      await this.runSQL(`CREATE SCHEMA IF NOT EXISTS stripe`);
+      await this.updateInstallationComment(
+        `${STRIPE_SCHEMA_COMMENT_PREFIX} v${package_default.version} ${INSTALLATION_STARTED_SUFFIX}`
+      );
+      await this.deployFunction("stripe-setup", setupFunctionCode);
+      await this.deployFunction("stripe-webhook", webhookFunctionCode);
+      await this.deployFunction("stripe-worker", workerFunctionCode);
+      await this.setSecrets([{ name: "STRIPE_SECRET_KEY", value: trimmedStripeKey }]);
+      const serviceRoleKey = await this.getServiceRoleKey();
+      const setupResult = await this.invokeFunction("stripe-setup", serviceRoleKey);
+      if (!setupResult.success) {
+        throw new Error(`Setup failed: ${setupResult.error}`);
+      }
+      let pgCronEnabled = false;
+      try {
+        await this.setupPgCronJob();
+        pgCronEnabled = true;
+      } catch {
+        console.warn("pg_cron setup failed - falling back to manual worker invocation");
+      }
+      if (!pgCronEnabled) {
+        try {
+          await this.invokeFunction("stripe-worker", serviceRoleKey);
+        } catch (err) {
+          console.warn("Failed to trigger initial worker invocation:", err);
+        }
+      }
+      await this.updateInstallationComment(
+        `${STRIPE_SCHEMA_COMMENT_PREFIX} v${package_default.version} ${INSTALLATION_INSTALLED_SUFFIX}`
+      );
+    } catch (error) {
+      await this.updateInstallationComment(
+        `${STRIPE_SCHEMA_COMMENT_PREFIX} v${package_default.version} ${INSTALLATION_ERROR_SUFFIX} - ${error instanceof Error ? error.message : String(error)}`
+      );
+      throw error;
+    }
+  }
 };
 async function install(params) {
   const { supabaseAccessToken, supabaseProjectRef, stripeKey } = params;
-  const trimmedStripeKey = stripeKey.trim();
-  if (!trimmedStripeKey.startsWith("sk_") && !trimmedStripeKey.startsWith("rk_")) {
-    throw new Error('Stripe key should start with "sk_" or "rk_"');
-  }
-  const client = new SupabaseDeployClient({
+  const client = new SupabaseSetupClient({
     accessToken: supabaseAccessToken,
-    projectRef: supabaseProjectRef
+    projectRef: supabaseProjectRef,
+    projectBaseUrl: params.baseProjectUrl,
+    managementApiBaseUrl: params.baseManagementApiUrl
   });
-  try {
-    await client.validateProject();
-    await client.runSQL(`CREATE SCHEMA IF NOT EXISTS stripe`);
-    await client.updateInstallationComment(`stripe-sync v${package_default.version} installation:started`);
-    await client.deployFunction("stripe-setup", setupFunctionCode);
-    await client.deployFunction("stripe-webhook", webhookFunctionCode);
-    await client.deployFunction("stripe-worker", workerFunctionCode);
-    await client.setSecrets([{ name: "STRIPE_SECRET_KEY", value: trimmedStripeKey }]);
-    const serviceRoleKey = await client.getServiceRoleKey();
-    const setupResult = await client.invokeFunction("stripe-setup", serviceRoleKey);
-    if (!setupResult.success) {
-      throw new Error(`Setup failed: ${setupResult.error}`);
-    }
-    try {
-      await client.setupPgCronJob();
-    } catch {
-    }
-    await client.updateInstallationComment(`stripe-sync v${package_default.version} installed`);
-  } catch (error) {
-    await client.updateInstallationComment(
-      `stripe-sync v${package_default.version} installation:error - ${error instanceof Error ? error.message : String(error)}`
-    );
-    throw error;
-  }
+  await client.install(stripeKey);
 }
 async function uninstall(params) {
   const { supabaseAccessToken, supabaseProjectRef, stripeKey } = params;
@@ -466,7 +509,7 @@ async function uninstall(params) {
   if (!trimmedStripeKey.startsWith("sk_") && !trimmedStripeKey.startsWith("rk_")) {
     throw new Error('Stripe key should start with "sk_" or "rk_"');
   }
-  const client = new SupabaseDeployClient({
+  const client = new SupabaseSetupClient({
     accessToken: supabaseAccessToken,
     projectRef: supabaseProjectRef
   });
@@ -474,7 +517,12 @@ async function uninstall(params) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  INSTALLATION_ERROR_SUFFIX,
+  INSTALLATION_INSTALLED_SUFFIX,
+  INSTALLATION_STARTED_SUFFIX,
+  STRIPE_SCHEMA_COMMENT_PREFIX,
   SupabaseDeployClient,
+  SupabaseSetupClient,
   install,
   setupFunctionCode,
   uninstall,

package/dist/supabase/index.d.cts

@@ -1,17 +1,22 @@
+declare const STRIPE_SCHEMA_COMMENT_PREFIX = "stripe-sync";
+declare const INSTALLATION_STARTED_SUFFIX = "installation:started";
+declare const INSTALLATION_ERROR_SUFFIX = "installation:error";
+declare const INSTALLATION_INSTALLED_SUFFIX = "installed";
 interface DeployClientOptions {
     accessToken: string;
     projectRef: string;
-    baseUrl?: string;
+    projectBaseUrl?: string;
+    managementApiBaseUrl?: string;
 }
 interface ProjectInfo {
     id: string;
     name: string;
     region: string;
 }
-declare class SupabaseDeployClient {
+declare class SupabaseSetupClient {
     private api;
     private projectRef;
-    private baseUrl;
+    private projectBaseUrl;
     constructor(options: DeployClientOptions);
     /**
      * Validate that the project exists and we have access
@@ -88,11 +93,14 @@ declare class SupabaseDeployClient {
      * Removes all Edge Functions, secrets, database resources, and Stripe webhooks
      */
     uninstall(stripeSecretKey: string): Promise<void>;
+    install(stripeKey: string): Promise<void>;
 }
 declare function install(params: {
     supabaseAccessToken: string;
     supabaseProjectRef: string;
     stripeKey: string;
+    baseProjectUrl?: string;
+    baseManagementApiUrl?: string;
 }): Promise<void>;
 declare function uninstall(params: {
     supabaseAccessToken: string;
@@ -104,4 +112,4 @@ declare const setupFunctionCode: string;
 declare const webhookFunctionCode: string;
 declare const workerFunctionCode: string;
 
-export { type DeployClientOptions, type ProjectInfo, SupabaseDeployClient, install, setupFunctionCode, uninstall, webhookFunctionCode, workerFunctionCode };
+export { type DeployClientOptions, INSTALLATION_ERROR_SUFFIX, INSTALLATION_INSTALLED_SUFFIX, INSTALLATION_STARTED_SUFFIX, type ProjectInfo, STRIPE_SCHEMA_COMMENT_PREFIX, SupabaseSetupClient as SupabaseDeployClient, SupabaseSetupClient, install, setupFunctionCode, uninstall, webhookFunctionCode, workerFunctionCode };

package/dist/supabase/index.d.ts

@@ -1,17 +1,22 @@
+declare const STRIPE_SCHEMA_COMMENT_PREFIX = "stripe-sync";
+declare const INSTALLATION_STARTED_SUFFIX = "installation:started";
+declare const INSTALLATION_ERROR_SUFFIX = "installation:error";
+declare const INSTALLATION_INSTALLED_SUFFIX = "installed";
 interface DeployClientOptions {
     accessToken: string;
     projectRef: string;
-    baseUrl?: string;
+    projectBaseUrl?: string;
+    managementApiBaseUrl?: string;
 }
 interface ProjectInfo {
     id: string;
     name: string;
     region: string;
 }
-declare class SupabaseDeployClient {
+declare class SupabaseSetupClient {
     private api;
     private projectRef;
-    private baseUrl;
+    private projectBaseUrl;
     constructor(options: DeployClientOptions);
     /**
      * Validate that the project exists and we have access
@@ -88,11 +93,14 @@ declare class SupabaseDeployClient {
      * Removes all Edge Functions, secrets, database resources, and Stripe webhooks
      */
     uninstall(stripeSecretKey: string): Promise<void>;
+    install(stripeKey: string): Promise<void>;
 }
 declare function install(params: {
     supabaseAccessToken: string;
     supabaseProjectRef: string;
     stripeKey: string;
+    baseProjectUrl?: string;
+    baseManagementApiUrl?: string;
 }): Promise<void>;
 declare function uninstall(params: {
     supabaseAccessToken: string;
@@ -104,4 +112,4 @@ declare const setupFunctionCode: string;
 declare const webhookFunctionCode: string;
 declare const workerFunctionCode: string;
 
-export { type DeployClientOptions, type ProjectInfo, SupabaseDeployClient, install, setupFunctionCode, uninstall, webhookFunctionCode, workerFunctionCode };
+export { type DeployClientOptions, INSTALLATION_ERROR_SUFFIX, INSTALLATION_INSTALLED_SUFFIX, INSTALLATION_STARTED_SUFFIX, type ProjectInfo, STRIPE_SCHEMA_COMMENT_PREFIX, SupabaseSetupClient as SupabaseDeployClient, SupabaseSetupClient, install, setupFunctionCode, uninstall, webhookFunctionCode, workerFunctionCode };