stripe-experiment-sync 1.0.6 → 1.0.8

package/dist/cli/lib.d.cts

@@ -0,0 +1,69 @@
+interface Config {
+    stripeApiKey: string;
+    ngrokAuthToken?: string;
+    databaseUrl: string;
+}
+interface CliOptions {
+    stripeKey?: string;
+    ngrokToken?: string;
+    databaseUrl?: string;
+}
+/**
+ * Load configuration from .env file, environment variables, and interactive prompts.
+ * Values are masked with *** when prompting for sensitive information.
+ */
+declare function loadConfig(options: CliOptions): Promise<Config>;
+
+interface DeployOptions {
+    supabaseAccessToken?: string;
+    supabaseProjectRef?: string;
+    stripeKey?: string;
+    packageVersion?: string;
+}
+
+/**
+ * Backfill command - backfills a specific entity type from Stripe.
+ */
+declare function backfillCommand(options: CliOptions, entityName: string): Promise<void>;
+/**
+ * Migration command - runs database migrations only.
+ */
+declare function migrateCommand(options: CliOptions): Promise<void>;
+/**
+ * Main sync command - syncs Stripe data to PostgreSQL using webhooks for real-time updates.
+ * Supports two modes:
+ * - WebSocket mode (default): Direct connection to Stripe via WebSocket, no ngrok needed
+ * - Webhook mode: Uses ngrok tunnel + Express server (when NGROK_AUTH_TOKEN is provided)
+ */
+declare function syncCommand(options: CliOptions): Promise<void>;
+/**
+ * Install command - installs Stripe sync Edge Functions to Supabase.
+ * 1. Validates Supabase project access
+ * 2. Deploys stripe-setup, stripe-webhook, and stripe-worker Edge Functions
+ * 3. Sets required secrets (STRIPE_SECRET_KEY)
+ * 4. Runs the setup function to create webhook and run migrations
+ */
+declare function installCommand(options: DeployOptions): Promise<void>;
+/**
+ * Uninstall command - removes Stripe sync Edge Functions and resources from Supabase.
+ * 1. Validates Supabase project access
+ * 2. Deletes Stripe webhooks
+ * 3. Deletes Edge Functions (stripe-setup, stripe-webhook, stripe-worker)
+ * 4. Deletes secrets and pg_cron jobs
+ * 5. Drops the stripe schema
+ */
+declare function uninstallCommand(options: DeployOptions): Promise<void>;
+
+interface NgrokTunnel {
+    url: string;
+    close: () => Promise<void>;
+}
+/**
+ * Create an ngrok tunnel to expose the local server to the internet.
+ * @param port - The local port to expose
+ * @param authToken - ngrok authentication token
+ * @returns The tunnel URL and a close function
+ */
+declare function createTunnel(port: number, authToken: string): Promise<NgrokTunnel>;
+
+export { type CliOptions, type Config, type DeployOptions, type NgrokTunnel, backfillCommand, createTunnel, installCommand, loadConfig, migrateCommand, syncCommand, uninstallCommand };

package/dist/cli/lib.d.ts

@@ -0,0 +1,69 @@
+interface Config {
+    stripeApiKey: string;
+    ngrokAuthToken?: string;
+    databaseUrl: string;
+}
+interface CliOptions {
+    stripeKey?: string;
+    ngrokToken?: string;
+    databaseUrl?: string;
+}
+/**
+ * Load configuration from .env file, environment variables, and interactive prompts.
+ * Values are masked with *** when prompting for sensitive information.
+ */
+declare function loadConfig(options: CliOptions): Promise<Config>;
+
+interface DeployOptions {
+    supabaseAccessToken?: string;
+    supabaseProjectRef?: string;
+    stripeKey?: string;
+    packageVersion?: string;
+}
+
+/**
+ * Backfill command - backfills a specific entity type from Stripe.
+ */
+declare function backfillCommand(options: CliOptions, entityName: string): Promise<void>;
+/**
+ * Migration command - runs database migrations only.
+ */
+declare function migrateCommand(options: CliOptions): Promise<void>;
+/**
+ * Main sync command - syncs Stripe data to PostgreSQL using webhooks for real-time updates.
+ * Supports two modes:
+ * - WebSocket mode (default): Direct connection to Stripe via WebSocket, no ngrok needed
+ * - Webhook mode: Uses ngrok tunnel + Express server (when NGROK_AUTH_TOKEN is provided)
+ */
+declare function syncCommand(options: CliOptions): Promise<void>;
+/**
+ * Install command - installs Stripe sync Edge Functions to Supabase.
+ * 1. Validates Supabase project access
+ * 2. Deploys stripe-setup, stripe-webhook, and stripe-worker Edge Functions
+ * 3. Sets required secrets (STRIPE_SECRET_KEY)
+ * 4. Runs the setup function to create webhook and run migrations
+ */
+declare function installCommand(options: DeployOptions): Promise<void>;
+/**
+ * Uninstall command - removes Stripe sync Edge Functions and resources from Supabase.
+ * 1. Validates Supabase project access
+ * 2. Deletes Stripe webhooks
+ * 3. Deletes Edge Functions (stripe-setup, stripe-webhook, stripe-worker)
+ * 4. Deletes secrets and pg_cron jobs
+ * 5. Drops the stripe schema
+ */
+declare function uninstallCommand(options: DeployOptions): Promise<void>;
+
+interface NgrokTunnel {
+    url: string;
+    close: () => Promise<void>;
+}
+/**
+ * Create an ngrok tunnel to expose the local server to the internet.
+ * @param port - The local port to expose
+ * @param authToken - ngrok authentication token
+ * @returns The tunnel URL and a close function
+ */
+declare function createTunnel(port: number, authToken: string): Promise<NgrokTunnel>;
+
+export { type CliOptions, type Config, type DeployOptions, type NgrokTunnel, backfillCommand, createTunnel, installCommand, loadConfig, migrateCommand, syncCommand, uninstallCommand };

package/dist/cli/lib.js

@@ -0,0 +1,21 @@
+import {
+  backfillCommand,
+  createTunnel,
+  installCommand,
+  loadConfig,
+  migrateCommand,
+  syncCommand,
+  uninstallCommand
+} from "../chunk-YH6KRZDQ.js";
+import "../chunk-J7BH3XD6.js";
+import "../chunk-X2OQQCC2.js";
+import "../chunk-CKWVW2JK.js";
+export {
+  backfillCommand,
+  createTunnel,
+  installCommand,
+  loadConfig,
+  migrateCommand,
+  syncCommand,
+  uninstallCommand
+};