@revealui/services 0.0.3 → 0.2.0

package/dist/stripe/stripeClient.d.ts

@@ -0,0 +1,126 @@
+import Stripe from 'stripe';
+import { DbCircuitBreaker } from './db-circuit-breaker.js';
+/**
+ * Get or create Stripe client instance (production use)
+ */
+declare function getStripe(): Stripe;
+/**
+ * Factory function to create protected Stripe client with dependency injection
+ * @param stripeInstance - Stripe instance to use (for testing) or undefined to use getStripe()
+ */
+declare function createProtectedStripe(stripeInstance?: Stripe): {
+    billingPortal: {
+        sessions: {
+            create: (params: Stripe.BillingPortal.SessionCreateParams, options?: Stripe.RequestOptions) => Promise<Stripe.BillingPortal.Session>;
+        };
+    };
+    customers: {
+        create: (params: Stripe.CustomerCreateParams, options?: Stripe.RequestOptions) => Promise<Stripe.Customer>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Customer | Stripe.DeletedCustomer>;
+        update: (id: string, params?: Stripe.CustomerUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Customer>;
+        del: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.DeletedCustomer>;
+        list: (params?: Stripe.CustomerListParams, options?: Stripe.RequestOptions) => Promise<Stripe.ApiList<Stripe.Customer>>;
+    };
+    paymentIntents: {
+        create: (params: Stripe.PaymentIntentCreateParams, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.PaymentIntent>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.PaymentIntent>;
+        update: (id: string, params?: Stripe.PaymentIntentUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.PaymentIntent>;
+    };
+    checkout: {
+        sessions: {
+            create: (params: Stripe.Checkout.SessionCreateParams, options?: Stripe.RequestOptions) => Promise<Stripe.Checkout.Session>;
+            retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Checkout.Session>;
+        };
+    };
+    products: {
+        create: (params: Stripe.ProductCreateParams, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Product>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Product>;
+        update: (id: string, params?: Stripe.ProductUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Product>;
+        list: (params?: Stripe.ProductListParams, options?: Stripe.RequestOptions) => Promise<Stripe.ApiList<Stripe.Product>>;
+    };
+    prices: {
+        create: (params: Stripe.PriceCreateParams, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Price>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Price>;
+        update: (id: string, params?: Stripe.PriceUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Price>;
+        list: (params?: Stripe.PriceListParams, options?: Stripe.RequestOptions) => Promise<Stripe.ApiList<Stripe.Price>>;
+    };
+    subscriptions: {
+        list: (options?: Stripe.RequestOptions | undefined) => Promise<Stripe.ApiList<Stripe.Subscription>>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Subscription>;
+        update: (id: string, params?: Stripe.SubscriptionUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Subscription>;
+        cancel: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Subscription>;
+    };
+    readonly webhooks: Stripe["webhooks"];
+    readonly balance: Stripe["balance"];
+};
+/**
+ * Enhanced Stripe client with circuit breaker and retry protection
+ * Uses factory with production Stripe instance for backward compatibility
+ */
+export declare const protectedStripe: {
+    billingPortal: {
+        sessions: {
+            create: (params: Stripe.BillingPortal.SessionCreateParams, options?: Stripe.RequestOptions) => Promise<Stripe.BillingPortal.Session>;
+        };
+    };
+    customers: {
+        create: (params: Stripe.CustomerCreateParams, options?: Stripe.RequestOptions) => Promise<Stripe.Customer>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Customer | Stripe.DeletedCustomer>;
+        update: (id: string, params?: Stripe.CustomerUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Customer>;
+        del: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.DeletedCustomer>;
+        list: (params?: Stripe.CustomerListParams, options?: Stripe.RequestOptions) => Promise<Stripe.ApiList<Stripe.Customer>>;
+    };
+    paymentIntents: {
+        create: (params: Stripe.PaymentIntentCreateParams, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.PaymentIntent>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.PaymentIntent>;
+        update: (id: string, params?: Stripe.PaymentIntentUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.PaymentIntent>;
+    };
+    checkout: {
+        sessions: {
+            create: (params: Stripe.Checkout.SessionCreateParams, options?: Stripe.RequestOptions) => Promise<Stripe.Checkout.Session>;
+            retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Checkout.Session>;
+        };
+    };
+    products: {
+        create: (params: Stripe.ProductCreateParams, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Product>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Product>;
+        update: (id: string, params?: Stripe.ProductUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Product>;
+        list: (params?: Stripe.ProductListParams, options?: Stripe.RequestOptions) => Promise<Stripe.ApiList<Stripe.Product>>;
+    };
+    prices: {
+        create: (params: Stripe.PriceCreateParams, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Price>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Price>;
+        update: (id: string, params?: Stripe.PriceUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Price>;
+        list: (params?: Stripe.PriceListParams, options?: Stripe.RequestOptions) => Promise<Stripe.ApiList<Stripe.Price>>;
+    };
+    subscriptions: {
+        list: (options?: Stripe.RequestOptions | undefined) => Promise<Stripe.ApiList<Stripe.Subscription>>;
+        retrieve: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Subscription>;
+        update: (id: string, params?: Stripe.SubscriptionUpdateParams | undefined, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Subscription>;
+        cancel: (id: string, options?: Stripe.RequestOptions | undefined) => Promise<Stripe.Subscription>;
+    };
+    readonly webhooks: Stripe["webhooks"];
+    readonly balance: Stripe["balance"];
+};
+export { getStripe, createProtectedStripe };
+export declare const __dbCircuitBreaker: DbCircuitBreaker;
+export declare const __CIRCUIT_BREAKER_CONFIG: {
+    failureThreshold: number;
+    resetTimeout: number;
+    successThreshold: number;
+};
+export declare const __RETRY_CONFIG: {
+    maxAttempts: number;
+    backoff: number[];
+    timeout: number;
+};
+/**
+ * Reset the DB circuit breaker state and clear local cache (test-only).
+ */
+export declare const __resetCircuitBreaker: () => Promise<void>;
+/**
+ * Reset the cached Stripe instance (test-only)
+ * This allows tests to reset the production Stripe cache
+ */
+export declare const __resetStripe: () => void;
+//# sourceMappingURL=stripeClient.d.ts.map

package/dist/stripe/stripeClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripeClient.d.ts","sourceRoot":"","sources":["../../src/stripe/stripeClient.ts"],"names":[],"mappings":"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"}

package/dist/stripe/stripeClient.js

@@ -0,0 +1,226 @@
+// Import config module (ESM)
+// Config uses proxy for lazy loading, so import is safe - validation only happens on property access
+import configModule from '@revealui/config';
+import Stripe from 'stripe';
+import { createLogger } from '@revealui/core/observability/logger';
+import { DbCircuitBreaker } from './db-circuit-breaker.js';
+const logger = createLogger({ service: 'Stripe' });
+// Lazy initialization to handle missing env vars during build
+let _stripe = null;
+/**
+ * Get or create Stripe client instance (production use)
+ */
+function getStripe() {
+    // Use cached instance if available
+    if (_stripe)
+        return _stripe;
+    // Try to get from config module, fallback to process.env for backward compatibility
+    let secretKey;
+    try {
+        // Accessing config.stripe.secretKey triggers lazy validation via proxy
+        // Type assertion needed because Proxy type inference fails for nested properties
+        // Config is a Proxy, so we need to access properties directly
+        secretKey = configModule.stripe?.secretKey;
+    }
+    catch {
+        // Config validation failed or module unavailable - will use process.env fallback
+        secretKey = undefined;
+    }
+    secretKey = secretKey ?? process.env.STRIPE_SECRET_KEY;
+    if (!secretKey) {
+        throw new Error('STRIPE_SECRET_KEY environment variable is required. Use @revealui/config or set STRIPE_SECRET_KEY.');
+    }
+    _stripe = new Stripe(secretKey, {
+        apiVersion: '2026-01-28.clover',
+    });
+    return _stripe;
+}
+/**
+ * Circuit breaker configuration
+ */
+const CIRCUIT_BREAKER_CONFIG = {
+    failureThreshold: 5, // Open circuit after 5 failures
+    resetTimeout: 30000, // 30 seconds before half-open
+    successThreshold: 2, // Need 2 successes to close from half-open
+};
+/**
+ * Retry configuration
+ */
+const RETRY_CONFIG = {
+    maxAttempts: 3,
+    backoff: [100, 200, 400], // Exponential backoff in milliseconds
+    timeout: 10000, // 10 second timeout
+};
+/**
+ * Shared DB-backed circuit breaker for all Stripe operations.
+ * State is persisted to NeonDB so all API instances share the same view.
+ * Local 5-second cache keeps the read path fast.
+ */
+const stripeCircuitBreaker = new DbCircuitBreaker('stripe', {
+    failureThreshold: CIRCUIT_BREAKER_CONFIG.failureThreshold,
+    successThreshold: CIRCUIT_BREAKER_CONFIG.successThreshold,
+    resetTimeout: CIRCUIT_BREAKER_CONFIG.resetTimeout,
+});
+/**
+ * Sleep helper for exponential backoff
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Timeout wrapper for promises
+ */
+function withTimeout(promise, timeoutMs) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`Operation timed out after ${timeoutMs}ms`)), timeoutMs)),
+    ]);
+}
+/**
+ * Factory function to create protected Stripe client with dependency injection
+ * @param stripeInstance - Stripe instance to use (for testing) or undefined to use getStripe()
+ */
+function createProtectedStripe(stripeInstance) {
+    // Use provided instance or get production instance
+    const getStripeInstance = () => {
+        return stripeInstance ?? getStripe();
+    };
+    /**
+     * Wrapper for Stripe API calls with circuit breaker and retry logic
+     */
+    async function callWithResilience(operation, operationName) {
+        // Check circuit breaker state (DB-backed, 5s local cache)
+        if (await stripeCircuitBreaker.isOpen()) {
+            logger.error(`Stripe circuit breaker is OPEN`, undefined, {
+                operation: operationName,
+                state: 'open',
+            });
+            throw new Error('Stripe circuit breaker is OPEN. Service may be unavailable. Please try again later.');
+        }
+        let lastError;
+        // Retry with exponential backoff
+        for (let attempt = 0; attempt < RETRY_CONFIG.maxAttempts; attempt++) {
+            try {
+                // Execute operation with timeout
+                const result = await withTimeout(operation(), RETRY_CONFIG.timeout);
+                // Success - record it and return
+                await stripeCircuitBreaker.recordSuccess();
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                // Check if it's a timeout or network error (retryable)
+                const isRetryable = error instanceof Error &&
+                    (error.message.includes('timeout') ||
+                        error.message.includes('ECONNREFUSED') ||
+                        error.message.includes('ETIMEDOUT') ||
+                        error.message.includes('network'));
+                // Don't retry non-retryable errors (e.g., validation errors from Stripe)
+                if (!isRetryable) {
+                    await stripeCircuitBreaker.recordFailure();
+                    logger.error(`Operation ${operationName} failed (non-retryable)`, error instanceof Error ? error : new Error(String(error)), {
+                        operation: operationName,
+                        attempt: attempt + 1,
+                        maxAttempts: RETRY_CONFIG.maxAttempts,
+                    });
+                    throw error;
+                }
+                // Log retryable error
+                logger.warn(`Operation ${operationName} failed (retryable), retrying...`, {
+                    operation: operationName,
+                    attempt: attempt + 1,
+                    maxAttempts: RETRY_CONFIG.maxAttempts,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                // If this is the last attempt, don't wait
+                if (attempt === RETRY_CONFIG.maxAttempts - 1) {
+                    break;
+                }
+                // Exponential backoff
+                const backoffMs = RETRY_CONFIG.backoff[attempt] ??
+                    RETRY_CONFIG.backoff[RETRY_CONFIG.backoff.length - 1] ??
+                    1000;
+                await sleep(backoffMs);
+            }
+        }
+        // All retries failed
+        await stripeCircuitBreaker.recordFailure();
+        throw lastError instanceof Error
+            ? new Error(`${operationName} failed after ${RETRY_CONFIG.maxAttempts} attempts: ${lastError.message}`)
+            : new Error(`${operationName} failed after ${RETRY_CONFIG.maxAttempts} attempts`);
+    }
+    // Return protected Stripe client using the provided or production Stripe instance
+    return {
+        billingPortal: {
+            sessions: {
+                create: (params, options) => callWithResilience(() => getStripeInstance().billingPortal.sessions.create(params, options), 'billingPortal.sessions.create'),
+            },
+        },
+        customers: {
+            create: (params, options) => callWithResilience(() => getStripeInstance().customers.create(params, options), 'customers.create'),
+            retrieve: (...args) => callWithResilience(() => getStripeInstance().customers.retrieve(...args), 'customers.retrieve'),
+            update: (...args) => callWithResilience(() => getStripeInstance().customers.update(...args), 'customers.update'),
+            del: (...args) => callWithResilience(() => getStripeInstance().customers.del(...args), 'customers.del'),
+            list: (params, options) => callWithResilience(() => getStripeInstance().customers.list(params, options), 'customers.list'),
+        },
+        paymentIntents: {
+            create: (...args) => callWithResilience(() => getStripeInstance().paymentIntents.create(...args), 'paymentIntents.create'),
+            retrieve: (...args) => callWithResilience(() => getStripeInstance().paymentIntents.retrieve(...args), 'paymentIntents.retrieve'),
+            update: (...args) => callWithResilience(() => getStripeInstance().paymentIntents.update(...args), 'paymentIntents.update'),
+        },
+        checkout: {
+            sessions: {
+                create: (params, options) => callWithResilience(() => getStripeInstance().checkout.sessions.create(params, options), 'checkout.sessions.create'),
+                retrieve: (...args) => callWithResilience(() => getStripeInstance().checkout.sessions.retrieve(...args), 'checkout.sessions.retrieve'),
+            },
+        },
+        products: {
+            create: (...args) => callWithResilience(() => getStripeInstance().products.create(...args), 'products.create'),
+            retrieve: (...args) => callWithResilience(() => getStripeInstance().products.retrieve(...args), 'products.retrieve'),
+            update: (...args) => callWithResilience(() => getStripeInstance().products.update(...args), 'products.update'),
+            list: (params, options) => callWithResilience(() => getStripeInstance().products.list(params, options), 'products.list'),
+        },
+        prices: {
+            create: (...args) => callWithResilience(() => getStripeInstance().prices.create(...args), 'prices.create'),
+            retrieve: (...args) => callWithResilience(() => getStripeInstance().prices.retrieve(...args), 'prices.retrieve'),
+            update: (...args) => callWithResilience(() => getStripeInstance().prices.update(...args), 'prices.update'),
+            list: (params, options) => callWithResilience(() => getStripeInstance().prices.list(params, options), 'prices.list'),
+        },
+        subscriptions: {
+            list: (...args) => callWithResilience(() => getStripeInstance().subscriptions.list(...args), 'subscriptions.list'),
+            retrieve: (...args) => callWithResilience(() => getStripeInstance().subscriptions.retrieve(...args), 'subscriptions.retrieve'),
+            update: (...args) => callWithResilience(() => getStripeInstance().subscriptions.update(...args), 'subscriptions.update'),
+            cancel: (...args) => callWithResilience(() => getStripeInstance().subscriptions.cancel(...args), 'subscriptions.cancel'),
+        },
+        get webhooks() {
+            return getStripeInstance().webhooks;
+        },
+        get balance() {
+            return getStripeInstance().balance;
+        },
+    };
+}
+/**
+ * Enhanced Stripe client with circuit breaker and retry protection
+ * Uses factory with production Stripe instance for backward compatibility
+ */
+export const protectedStripe = createProtectedStripe();
+// Export factory for cases where you need explicit initialization control (e.g., testing)
+export { getStripe, createProtectedStripe };
+// Test-only exports (DO NOT USE IN PRODUCTION)
+// These are exported with __ prefix to indicate they are internal and test-only
+export const __dbCircuitBreaker = stripeCircuitBreaker;
+export const __CIRCUIT_BREAKER_CONFIG = CIRCUIT_BREAKER_CONFIG;
+export const __RETRY_CONFIG = RETRY_CONFIG;
+/**
+ * Reset the DB circuit breaker state and clear local cache (test-only).
+ */
+export const __resetCircuitBreaker = () => stripeCircuitBreaker.reset();
+/**
+ * Reset the cached Stripe instance (test-only)
+ * This allows tests to reset the production Stripe cache
+ */
+export const __resetStripe = () => {
+    _stripe = null;
+};
+//# sourceMappingURL=stripeClient.js.map

package/dist/stripe/stripeClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripeClient.js","sourceRoot":"","sources":["../../src/stripe/stripeClient.ts"],"names":[],"mappings":"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"}

package/dist/supabase/index.d.ts

@@ -0,0 +1,6 @@
+export type { SupabaseClient } from '@supabase/supabase-js';
+export { withSupabaseResilience } from './resilience.js';
+export { default as createBrowserClient } from './utils/client.js';
+export { default as createServerClient } from './utils/server.js';
+export { createServerClientFromRequest } from './utils/web.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/supabase/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/supabase/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/supabase/index.js

@@ -0,0 +1,5 @@
+export { withSupabaseResilience } from './resilience.js';
+export { default as createBrowserClient } from './utils/client.js';
+export { default as createServerClient } from './utils/server.js';
+export { createServerClientFromRequest } from './utils/web.js';
+//# sourceMappingURL=index.js.map

package/dist/supabase/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/supabase/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/supabase/resilience.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Supabase Resilience Layer
+ *
+ * Provides circuit breaker + retry protection for Supabase operations,
+ * matching the resilience pattern used in packages/services/src/stripe/stripeClient.ts.
+ *
+ * NOTE: Circuit breaker state is in-memory (per-instance).
+ * TODO: For multi-instance deployments, replace with Redis-backed state.
+ * Uses createLogger from @revealui/core. Wire up to alerting when circuit opens.
+ */
+type CircuitState = 'closed' | 'open' | 'half-open';
+interface CircuitBreakerState {
+    state: CircuitState;
+    failures: number;
+    lastFailureTime: number;
+    successCount: number;
+}
+declare function getCircuitBreaker(operationName: string): CircuitBreakerState;
+declare function recordFailure(operationName: string): void;
+declare function recordSuccess(operationName: string): void;
+declare function isCircuitOpen(operationName: string): boolean;
+/**
+ * Wrap a Supabase operation with circuit breaker + exponential-backoff retry.
+ *
+ * Usage:
+ * ```ts
+ * const data = await withSupabaseResilience(
+ *   () => supabase.from('documents').select('*'),
+ *   'documents.select',
+ * )
+ * ```
+ */
+export declare function withSupabaseResilience<T>(operation: () => Promise<T>, operationName: string): Promise<T>;
+export declare const __supabaseCircuitBreakers: Map<string, CircuitBreakerState>;
+export declare const __supabaseCircuitBreakerConfig: {
+    failureThreshold: number;
+    resetTimeout: number;
+    successThreshold: number;
+};
+export declare const __supabaseRetryConfig: {
+    maxAttempts: number;
+    backoff: readonly [100, 200, 400];
+    timeout: number;
+};
+export declare const __supabaseGetCircuitBreaker: typeof getCircuitBreaker;
+export declare const __supabaseRecordFailure: typeof recordFailure;
+export declare const __supabaseRecordSuccess: typeof recordSuccess;
+export declare const __supabaseIsCircuitOpen: typeof isCircuitOpen;
+export {};
+//# sourceMappingURL=resilience.d.ts.map

package/dist/supabase/resilience.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.d.ts","sourceRoot":"","sources":["../../src/supabase/resilience.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,KAAK,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;AAEnD,UAAU,mBAAmB;IAC3B,KAAK,EAAE,YAAY,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;CACrB;AAwBD,iBAAS,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,mBAAmB,CAWrE;AAED,iBAAS,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAelD;AAED,iBAAS,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAelD;AAED,iBAAS,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAgBrD;AAuBD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,CAAC,CA0DZ;AAGD,eAAO,MAAM,yBAAyB,kCAAkB,CAAA;AACxD,eAAO,MAAM,8BAA8B;;;;CAAyB,CAAA;AACpE,eAAO,MAAM,qBAAqB;;;;CAAe,CAAA;AACjD,eAAO,MAAM,2BAA2B,0BAAoB,CAAA;AAC5D,eAAO,MAAM,uBAAuB,sBAAgB,CAAA;AACpD,eAAO,MAAM,uBAAuB,sBAAgB,CAAA;AACpD,eAAO,MAAM,uBAAuB,sBAAgB,CAAA"}

package/dist/supabase/resilience.js

@@ -0,0 +1,166 @@
+/**
+ * Supabase Resilience Layer
+ *
+ * Provides circuit breaker + retry protection for Supabase operations,
+ * matching the resilience pattern used in packages/services/src/stripe/stripeClient.ts.
+ *
+ * NOTE: Circuit breaker state is in-memory (per-instance).
+ * TODO: For multi-instance deployments, replace with Redis-backed state.
+ * Uses createLogger from @revealui/core. Wire up to alerting when circuit opens.
+ */
+import { createLogger } from '@revealui/core/observability/logger';
+const logger = createLogger({ service: 'Supabase' });
+// ---------------------------------------------------------------------------
+// Configuration — mirrors Stripe circuit breaker config for consistency
+// ---------------------------------------------------------------------------
+const CIRCUIT_BREAKER_CONFIG = {
+    failureThreshold: 5,
+    resetTimeout: 30_000,
+    successThreshold: 2,
+};
+const RETRY_CONFIG = {
+    maxAttempts: 3,
+    backoff: [100, 200, 400],
+    timeout: 10_000,
+};
+// ---------------------------------------------------------------------------
+// Circuit breaker state store (in-memory)
+// ---------------------------------------------------------------------------
+const circuitBreakers = new Map();
+function getCircuitBreaker(operationName) {
+    if (!circuitBreakers.has(operationName)) {
+        circuitBreakers.set(operationName, {
+            state: 'closed',
+            failures: 0,
+            lastFailureTime: 0,
+            successCount: 0,
+        });
+    }
+    // biome-ignore lint/style/noNonNullAssertion: just set above
+    return circuitBreakers.get(operationName);
+}
+function recordFailure(operationName) {
+    const breaker = getCircuitBreaker(operationName);
+    breaker.failures++;
+    breaker.lastFailureTime = Date.now();
+    if (breaker.failures >= CIRCUIT_BREAKER_CONFIG.failureThreshold) {
+        if (breaker.state !== 'open') {
+            logger.warn(`Circuit breaker OPENED for Supabase:${operationName}`, {
+                failures: breaker.failures,
+                threshold: CIRCUIT_BREAKER_CONFIG.failureThreshold,
+            });
+        }
+        breaker.state = 'open';
+        breaker.successCount = 0;
+    }
+}
+function recordSuccess(operationName) {
+    const breaker = getCircuitBreaker(operationName);
+    breaker.failures = 0;
+    if (breaker.state === 'half-open') {
+        breaker.successCount++;
+        if (breaker.successCount >= CIRCUIT_BREAKER_CONFIG.successThreshold) {
+            logger.info(`Circuit breaker CLOSED for Supabase:${operationName}`);
+            breaker.state = 'closed';
+            breaker.successCount = 0;
+        }
+    }
+    else if (breaker.state === 'open') {
+        breaker.state = 'closed';
+        breaker.successCount = 0;
+    }
+}
+function isCircuitOpen(operationName) {
+    const breaker = getCircuitBreaker(operationName);
+    if (breaker.state === 'closed')
+        return false;
+    if (breaker.state === 'open') {
+        const elapsed = Date.now() - breaker.lastFailureTime;
+        if (elapsed >= CIRCUIT_BREAKER_CONFIG.resetTimeout) {
+            breaker.state = 'half-open';
+            breaker.successCount = 0;
+            return false;
+        }
+        return true;
+    }
+    return false; // half-open: allow one attempt
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function withTimeout(promise, ms) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`Supabase operation timed out after ${ms}ms`)), ms)),
+    ]);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Wrap a Supabase operation with circuit breaker + exponential-backoff retry.
+ *
+ * Usage:
+ * ```ts
+ * const data = await withSupabaseResilience(
+ *   () => supabase.from('documents').select('*'),
+ *   'documents.select',
+ * )
+ * ```
+ */
+export async function withSupabaseResilience(operation, operationName) {
+    if (isCircuitOpen(operationName)) {
+        logger.error(`Circuit breaker OPEN for Supabase:${operationName}`, undefined, {
+            operation: operationName,
+            state: 'open',
+        });
+        throw new Error(`Circuit breaker is OPEN for Supabase:${operationName}. Service may be unavailable.`);
+    }
+    let lastError;
+    for (let attempt = 0; attempt < RETRY_CONFIG.maxAttempts; attempt++) {
+        try {
+            const result = await withTimeout(operation(), RETRY_CONFIG.timeout);
+            recordSuccess(operationName);
+            return result;
+        }
+        catch (error) {
+            lastError = error;
+            const isRetryable = error instanceof Error &&
+                (error.message.includes('timeout') ||
+                    error.message.includes('ECONNREFUSED') ||
+                    error.message.includes('ETIMEDOUT') ||
+                    error.message.includes('network') ||
+                    error.message.includes('fetch failed'));
+            if (!isRetryable) {
+                recordFailure(operationName);
+                logger.error(`Supabase:${operationName} failed (non-retryable)`, error instanceof Error ? error : new Error(String(error)), { attempt: attempt + 1 });
+                throw error;
+            }
+            logger.warn(`Supabase:${operationName} failed (retryable), retrying...`, {
+                attempt: attempt + 1,
+                maxAttempts: RETRY_CONFIG.maxAttempts,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            if (attempt < RETRY_CONFIG.maxAttempts - 1) {
+                const backoffMs = RETRY_CONFIG.backoff[attempt] ?? RETRY_CONFIG.backoff.at(-1) ?? 1000;
+                await sleep(backoffMs);
+            }
+        }
+    }
+    recordFailure(operationName);
+    throw lastError instanceof Error
+        ? new Error(`Supabase:${operationName} failed after ${RETRY_CONFIG.maxAttempts} attempts: ${lastError.message}`)
+        : new Error(`Supabase:${operationName} failed after ${RETRY_CONFIG.maxAttempts} attempts`);
+}
+// Test-only exports
+export const __supabaseCircuitBreakers = circuitBreakers;
+export const __supabaseCircuitBreakerConfig = CIRCUIT_BREAKER_CONFIG;
+export const __supabaseRetryConfig = RETRY_CONFIG;
+export const __supabaseGetCircuitBreaker = getCircuitBreaker;
+export const __supabaseRecordFailure = recordFailure;
+export const __supabaseRecordSuccess = recordSuccess;
+export const __supabaseIsCircuitOpen = isCircuitOpen;
+//# sourceMappingURL=resilience.js.map

package/dist/supabase/resilience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.js","sourceRoot":"","sources":["../../src/supabase/resilience.ts"],"names":[],"mappings":"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"}