@nextsparkjs/core 0.1.0-beta.100 → 0.1.0-beta.102

package/dist/lib/billing/gateways/factory.js

@@ -0,0 +1,34 @@
+import { BILLING_REGISTRY } from "@nextsparkjs/registries/billing-registry";
+let gatewayInstance = null;
+function getBillingGateway() {
+  if (!gatewayInstance) {
+    const provider = BILLING_REGISTRY.provider;
+    switch (provider) {
+      case "stripe": {
+        const { StripeGateway } = require("./stripe");
+        gatewayInstance = new StripeGateway();
+        break;
+      }
+      case "polar": {
+        const { PolarGateway } = require("./polar");
+        gatewayInstance = new PolarGateway();
+        break;
+      }
+      // Future providers:
+      // case 'paddle': { ... }
+      // case 'lemonsqueezy': { ... }
+      default:
+        throw new Error(
+          `Unsupported billing provider: "${provider}". Supported providers: stripe, polar. Check your billing.config.ts provider setting.`
+        );
+    }
+  }
+  return gatewayInstance;
+}
+function resetBillingGateway() {
+  gatewayInstance = null;
+}
+export {
+  getBillingGateway,
+  resetBillingGateway
+};

package/dist/lib/billing/gateways/interface.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Billing Gateway Interface
+ *
+ * Defines the contract that all payment provider implementations must satisfy.
+ * Consumers interact with this interface via the factory (getBillingGateway()),
+ * making provider switching a configuration change rather than a code change.
+ */
+import type { CheckoutSessionResult, PortalSessionResult, SubscriptionResult, CustomerResult, WebhookEventResult, CreateCheckoutParams, CreatePortalParams, CreateCustomerParams, UpdateSubscriptionParams } from './types';
+export interface BillingGateway {
+    createCheckoutSession(params: CreateCheckoutParams): Promise<CheckoutSessionResult>;
+    createPortalSession(params: CreatePortalParams): Promise<PortalSessionResult>;
+    getCustomer(customerId: string): Promise<CustomerResult>;
+    createCustomer(params: CreateCustomerParams): Promise<CustomerResult>;
+    updateSubscriptionPlan(params: UpdateSubscriptionParams): Promise<SubscriptionResult>;
+    cancelSubscriptionAtPeriodEnd(subscriptionId: string): Promise<SubscriptionResult>;
+    cancelSubscriptionImmediately(subscriptionId: string): Promise<SubscriptionResult>;
+    reactivateSubscription(subscriptionId: string): Promise<SubscriptionResult>;
+    verifyWebhookSignature(payload: string | Buffer, signatureOrHeaders: string | Record<string, string>): WebhookEventResult;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/lib/billing/gateways/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../src/lib/billing/gateways/interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,cAAc;IAE7B,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACnF,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAG7E,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACxD,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAGrE,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACrF,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAClF,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAClF,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAG3E,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,kBAAkB,CAAA;CAC1H"}

package/dist/lib/billing/gateways/polar.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Polar.sh Payment Gateway Implementation
+ *
+ * Implements BillingGateway interface for Polar.sh.
+ * Wraps Polar SDK types into provider-agnostic result types.
+ *
+ * Key differences from Stripe:
+ * - Checkout uses `products: [productId]` (Polar product IDs, not Stripe price IDs)
+ * - Cancel = "revoke" in Polar terminology (immediate)
+ * - Customer portal via "customer sessions" (not a hosted portal page)
+ * - Webhook verification requires ALL headers, not just a signature string
+ * - Uses `validateEvent` from @polar-sh/sdk/webhooks
+ *
+ * NOTE: In billing.config.ts, Polar's `providerPriceIds` should contain Polar **product IDs**
+ * (not price IDs). Polar associates prices with products, so the product ID is used for checkout
+ * and subscription plan changes.
+ *
+ * NOTE: Polar also offers @polar-sh/better-auth for direct Better Auth integration.
+ * That is an ALTERNATIVE approach to this gateway. If you want the simpler plugin-based
+ * approach (auto-create customer on signup, client-side checkout helpers), use the
+ * Better Auth plugin instead of this gateway. The two approaches are mutually exclusive
+ * for the same project - pick one.
+ */
+import { Polar } from '@polar-sh/sdk';
+import type { BillingGateway } from './interface';
+import type { CheckoutSessionResult, PortalSessionResult, SubscriptionResult, CustomerResult, WebhookEventResult, CreateCheckoutParams, CreatePortalParams, CreateCustomerParams, UpdateSubscriptionParams } from './types';
+/**
+ * Polar.sh implementation of the BillingGateway interface.
+ * Maps Polar SDK types to provider-agnostic result types.
+ */
+export declare class PolarGateway implements BillingGateway {
+    createCheckoutSession(params: CreateCheckoutParams): Promise<CheckoutSessionResult>;
+    createPortalSession(params: CreatePortalParams): Promise<PortalSessionResult>;
+    verifyWebhookSignature(payload: string | Buffer, signatureOrHeaders: string | Record<string, string>): WebhookEventResult;
+    getCustomer(customerId: string): Promise<CustomerResult>;
+    createCustomer(params: CreateCustomerParams): Promise<CustomerResult>;
+    updateSubscriptionPlan(params: UpdateSubscriptionParams): Promise<SubscriptionResult>;
+    cancelSubscriptionAtPeriodEnd(subscriptionId: string): Promise<SubscriptionResult>;
+    cancelSubscriptionImmediately(subscriptionId: string): Promise<SubscriptionResult>;
+    reactivateSubscription(subscriptionId: string): Promise<SubscriptionResult>;
+}
+/**
+ * Get raw Polar instance for advanced usage (e.g., webhook handlers that need full types).
+ * Prefer using getBillingGateway() for all other operations.
+ */
+export declare function getPolarInstance(): Polar;
+//# sourceMappingURL=polar.d.ts.map

package/dist/lib/billing/gateways/polar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polar.d.ts","sourceRoot":"","sources":["../../../../src/lib/billing/gateways/polar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAKrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,SAAS,CAAA;AAiBhB;;;GAGG;AACH,qBAAa,YAAa,YAAW,cAAc;IAC3C,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0BnF,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAcnF,sBAAsB,CACpB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClD,kBAAkB;IA4Bf,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAUxD,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAsBrE,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkBrF,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiBlF,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAalF,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAelF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAExC"}

package/dist/lib/billing/gateways/polar.js

@@ -0,0 +1,150 @@
+import { Polar } from "@polar-sh/sdk";
+import { validateEvent, WebhookVerificationError } from "@polar-sh/sdk/webhooks";
+import { PlanService } from "../../services/plan.service.js";
+let polarInstance = null;
+function getPolar() {
+  if (!polarInstance) {
+    if (!process.env.POLAR_ACCESS_TOKEN) {
+      throw new Error("POLAR_ACCESS_TOKEN is not configured");
+    }
+    polarInstance = new Polar({
+      accessToken: process.env.POLAR_ACCESS_TOKEN
+    });
+  }
+  return polarInstance;
+}
+class PolarGateway {
+  async createCheckoutSession(params) {
+    const { teamId, planSlug, billingPeriod, successUrl, cancelUrl, customerEmail } = params;
+    const productId = PlanService.getPriceId(planSlug, billingPeriod);
+    if (!productId) {
+      throw new Error(`No product ID configured for ${planSlug} ${billingPeriod}`);
+    }
+    const checkoutParams = {
+      products: [productId],
+      successUrl,
+      metadata: { teamId, planSlug, billingPeriod },
+      ...customerEmail && { customerEmail },
+      // Polar uses returnUrl for back navigation (equivalent to Stripe's cancel_url)
+      ...cancelUrl && { returnUrl: cancelUrl }
+    };
+    const result = await getPolar().checkouts.create(checkoutParams);
+    return {
+      id: result.id,
+      url: result.url ?? null
+    };
+  }
+  async createPortalSession(params) {
+    const { customerId, returnUrl } = params;
+    const result = await getPolar().customerSessions.create({
+      customerId
+    });
+    return {
+      url: result.customerPortalUrl
+    };
+  }
+  verifyWebhookSignature(payload, signatureOrHeaders) {
+    const webhookSecret = process.env.POLAR_WEBHOOK_SECRET;
+    if (!webhookSecret) {
+      throw new Error("POLAR_WEBHOOK_SECRET is not configured");
+    }
+    const headers = typeof signatureOrHeaders === "string" ? { "webhook-id": "", "webhook-timestamp": "", "webhook-signature": signatureOrHeaders } : signatureOrHeaders;
+    const body = typeof payload === "string" ? payload : payload.toString("utf-8");
+    try {
+      const event = validateEvent(body, headers, webhookSecret);
+      return {
+        id: event.id || crypto.randomUUID(),
+        type: event.type,
+        data: event.data
+      };
+    } catch (error) {
+      if (error instanceof WebhookVerificationError) {
+        throw new Error(`Polar webhook verification failed: ${error.message}`);
+      }
+      throw error;
+    }
+  }
+  async getCustomer(customerId) {
+    const customer = await getPolar().customers.get({ id: customerId });
+    return {
+      id: customer.id,
+      email: customer.email ?? null,
+      name: customer.name ?? null
+    };
+  }
+  async createCustomer(params) {
+    const { email, name, metadata } = params;
+    const customerParams = {
+      email,
+      ...name && { name },
+      ...metadata && { metadata },
+      // Add organization ID if available
+      ...process.env.POLAR_ORGANIZATION_ID && {
+        organizationId: process.env.POLAR_ORGANIZATION_ID
+      }
+    };
+    const customer = await getPolar().customers.create(customerParams);
+    return {
+      id: customer.id,
+      email: customer.email ?? null,
+      name: customer.name ?? null
+    };
+  }
+  async updateSubscriptionPlan(params) {
+    const { subscriptionId, newPriceId } = params;
+    const result = await getPolar().subscriptions.update({
+      id: subscriptionId,
+      subscriptionUpdate: {
+        productId: newPriceId
+      }
+    });
+    return {
+      id: result.id,
+      status: result.status,
+      cancelAtPeriodEnd: result.cancelAtPeriodEnd ?? false
+    };
+  }
+  async cancelSubscriptionAtPeriodEnd(subscriptionId) {
+    const result = await getPolar().subscriptions.update({
+      id: subscriptionId,
+      subscriptionUpdate: {
+        cancelAtPeriodEnd: true
+      }
+    });
+    return {
+      id: result.id,
+      status: result.status,
+      cancelAtPeriodEnd: true
+    };
+  }
+  async cancelSubscriptionImmediately(subscriptionId) {
+    const result = await getPolar().subscriptions.revoke({
+      id: subscriptionId
+    });
+    return {
+      id: result.id,
+      status: result.status ?? "canceled",
+      cancelAtPeriodEnd: false
+    };
+  }
+  async reactivateSubscription(subscriptionId) {
+    const result = await getPolar().subscriptions.update({
+      id: subscriptionId,
+      subscriptionUpdate: {
+        cancelAtPeriodEnd: false
+      }
+    });
+    return {
+      id: result.id,
+      status: result.status,
+      cancelAtPeriodEnd: false
+    };
+  }
+}
+function getPolarInstance() {
+  return getPolar();
+}
+export {
+  PolarGateway,
+  getPolarInstance
+};

package/dist/lib/billing/gateways/stripe.d.ts

@@ -1,76 +1,51 @@
 /**
- * Stripe Payment Gateway Integration
+ * Stripe Payment Gateway Implementation
  *
- * Wrapper around Stripe SDK for subscription billing operations.
- * Handles checkout sessions, customer portal, and webhooks.
+ * Implements BillingGateway interface for Stripe.
+ * Wraps Stripe SDK types into provider-agnostic result types.
  *
  * P2: Stripe Integration
  */
 import Stripe from 'stripe';
-export interface CreateCheckoutParams {
-    teamId: string;
-    planSlug: string;
-    billingPeriod: 'monthly' | 'yearly';
-    successUrl: string;
-    cancelUrl: string;
-    customerEmail?: string;
-    customerId?: string;
+import type { BillingGateway } from './interface';
+import type { CheckoutSessionResult, PortalSessionResult, SubscriptionResult, CustomerResult, WebhookEventResult, CreateCheckoutParams, CreatePortalParams, CreateCustomerParams, UpdateSubscriptionParams } from './types';
+export type { CreateCheckoutParams, CreatePortalParams, UpdateSubscriptionParams } from './types';
+/**
+ * Stripe implementation of the BillingGateway interface.
+ * Maps Stripe SDK types to provider-agnostic result types.
+ */
+export declare class StripeGateway implements BillingGateway {
+    createCheckoutSession(params: CreateCheckoutParams): Promise<CheckoutSessionResult>;
+    createPortalSession(params: CreatePortalParams): Promise<PortalSessionResult>;
+    verifyWebhookSignature(payload: string | Buffer, signatureOrHeaders: string | Record<string, string>): WebhookEventResult;
+    getCustomer(customerId: string): Promise<CustomerResult>;
+    createCustomer(params: CreateCustomerParams): Promise<CustomerResult>;
+    updateSubscriptionPlan(params: UpdateSubscriptionParams): Promise<SubscriptionResult>;
+    cancelSubscriptionAtPeriodEnd(subscriptionId: string): Promise<SubscriptionResult>;
+    cancelSubscriptionImmediately(subscriptionId: string): Promise<SubscriptionResult>;
+    reactivateSubscription(subscriptionId: string): Promise<SubscriptionResult>;
 }
-export interface CreatePortalParams {
-    customerId: string;
-    returnUrl: string;
-}
-/**
- * Create Stripe Checkout session for subscription
- */
-export declare function createCheckoutSession(params: CreateCheckoutParams): Promise<Stripe.Checkout.Session>;
-/**
- * Create Stripe Customer Portal session for self-service billing
- */
-export declare function createPortalSession(params: CreatePortalParams): Promise<Stripe.BillingPortal.Session>;
-/**
- * Verify Stripe webhook signature (MANDATORY for security)
- */
-export declare function verifyWebhookSignature(payload: string | Buffer, signature: string): Stripe.Event;
-/**
- * Get Stripe customer by ID
- */
-export declare function getCustomer(customerId: string): Promise<Stripe.Customer>;
-/**
- * Create Stripe customer
- */
-export declare function createCustomer(params: {
-    email: string;
-    name?: string;
-    metadata?: Record<string, string>;
-}): Promise<Stripe.Customer>;
 /**
- * Get Stripe instance for advanced usage (lazy-loaded)
+ * Get raw Stripe instance for advanced usage (webhook handlers that need Stripe.Event types).
+ * Prefer using getBillingGateway() for all other operations.
  */
 export declare function getStripeInstance(): Stripe;
-/**
- * Cancel subscription at period end (soft cancel)
- * User keeps access until the current billing period ends
- */
-export declare function cancelSubscriptionAtPeriodEnd(subscriptionId: string): Promise<Stripe.Subscription>;
-/**
- * Cancel subscription immediately (hard cancel)
- * User loses access immediately
- */
-export declare function cancelSubscriptionImmediately(subscriptionId: string): Promise<Stripe.Subscription>;
-/**
- * Reactivate a subscription that was scheduled to cancel
- * Only works if cancel_at_period_end was true
- */
-export declare function reactivateSubscription(subscriptionId: string): Promise<Stripe.Subscription>;
-export interface UpdateSubscriptionParams {
-    subscriptionId: string;
-    newPriceId: string;
-    prorationBehavior?: 'create_prorations' | 'none' | 'always_invoice';
-}
-/**
- * Update subscription to a new plan/price
- * Stripe handles proration automatically based on prorationBehavior
- */
-export declare function updateSubscriptionPlan(params: UpdateSubscriptionParams): Promise<Stripe.Subscription>;
+/** @deprecated Use getBillingGateway().createCheckoutSession() instead */
+export declare function createCheckoutSession(params: CreateCheckoutParams): Promise<CheckoutSessionResult>;
+/** @deprecated Use getBillingGateway().createPortalSession() instead */
+export declare function createPortalSession(params: CreatePortalParams): Promise<PortalSessionResult>;
+/** @deprecated Use getBillingGateway().verifyWebhookSignature() instead */
+export declare function verifyWebhookSignature(payload: string | Buffer, signatureOrHeaders: string | Record<string, string>): WebhookEventResult;
+/** @deprecated Use getBillingGateway().getCustomer() instead */
+export declare function getCustomer(customerId: string): Promise<CustomerResult>;
+/** @deprecated Use getBillingGateway().createCustomer() instead */
+export declare function createCustomer(params: CreateCustomerParams): Promise<CustomerResult>;
+/** @deprecated Use getBillingGateway().cancelSubscriptionAtPeriodEnd() instead */
+export declare function cancelSubscriptionAtPeriodEnd(subscriptionId: string): Promise<SubscriptionResult>;
+/** @deprecated Use getBillingGateway().cancelSubscriptionImmediately() instead */
+export declare function cancelSubscriptionImmediately(subscriptionId: string): Promise<SubscriptionResult>;
+/** @deprecated Use getBillingGateway().reactivateSubscription() instead */
+export declare function reactivateSubscription(subscriptionId: string): Promise<SubscriptionResult>;
+/** @deprecated Use getBillingGateway().updateSubscriptionPlan() instead */
+export declare function updateSubscriptionPlan(params: UpdateSubscriptionParams): Promise<SubscriptionResult>;
 //# sourceMappingURL=stripe.d.ts.map

package/dist/lib/billing/gateways/stripe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../../../src/lib/billing/gateways/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAA;AAmB3B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,SAAS,GAAG,QAAQ,CAAA;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CA0ClC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAKvC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,KAAK,CAMd;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAE9E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAE3B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAI9B;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAE9B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAI9B;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,gBAAgB,CAAA;CACpE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAoB9B"}
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../../../src/lib/billing/gateways/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAA;AAE3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,SAAS,CAAA;AAGhB,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAkBjG;;;GAGG;AACH,qBAAa,aAAc,YAAW,cAAc;IAC5C,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA6CnF,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQnF,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,kBAAkB;IAiBnH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAYxD,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IASrE,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2BrF,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWlF,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IASlF,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAUlF;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAQD,0EAA0E;AAC1E,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,kCAEvE;AAED,wEAAwE;AACxE,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,gCAEnE;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,sBAEnH;AAED,gEAAgE;AAChE,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,2BAEnD;AAED,mEAAmE;AACnE,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,2BAEhE;AAED,kFAAkF;AAClF,wBAAsB,6BAA6B,CAAC,cAAc,EAAE,MAAM,+BAEzE;AAED,kFAAkF;AAClF,wBAAsB,6BAA6B,CAAC,cAAc,EAAE,MAAM,+BAEzE;AAED,2EAA2E;AAC3E,wBAAsB,sBAAsB,CAAC,cAAc,EAAE,MAAM,+BAElE;AAED,2EAA2E;AAC3E,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,wBAAwB,+BAE5E"}

package/dist/lib/billing/gateways/stripe.js

@@ -13,90 +13,162 @@ function getStripe() {
   }
   return stripeInstance;
 }
-async function createCheckoutSession(params) {
-  const { teamId, planSlug, billingPeriod, successUrl, cancelUrl, customerEmail, customerId } = params;
-  const planConfig = BILLING_REGISTRY.plans.find((p) => p.slug === planSlug);
-  if (!planConfig) {
-    throw new Error(`Plan ${planSlug} not found in BILLING_REGISTRY`);
+class StripeGateway {
+  async createCheckoutSession(params) {
+    const { teamId, planSlug, billingPeriod, successUrl, cancelUrl, customerEmail, customerId } = params;
+    const planConfig = BILLING_REGISTRY.plans.find((p) => p.slug === planSlug);
+    if (!planConfig) {
+      throw new Error(`Plan ${planSlug} not found in BILLING_REGISTRY`);
+    }
+    const priceId = billingPeriod === "yearly" ? planConfig.stripePriceIdYearly : planConfig.stripePriceIdMonthly;
+    if (!priceId) {
+      throw new Error(`No Stripe price configured for ${planSlug} ${billingPeriod}`);
+    }
+    const sessionParams = {
+      mode: "subscription",
+      payment_method_types: ["card"],
+      line_items: [{ price: priceId, quantity: 1 }],
+      success_url: successUrl,
+      cancel_url: cancelUrl,
+      metadata: { teamId, planSlug, billingPeriod },
+      client_reference_id: teamId
+    };
+    if (customerId) {
+      sessionParams.customer = customerId;
+    } else if (customerEmail) {
+      sessionParams.customer_email = customerEmail;
+    }
+    if (planConfig.trialDays && planConfig.trialDays > 0 && !customerId) {
+      sessionParams.subscription_data = {
+        trial_period_days: planConfig.trialDays
+      };
+    }
+    const session = await getStripe().checkout.sessions.create(sessionParams);
+    return { id: session.id, url: session.url };
+  }
+  async createPortalSession(params) {
+    const session = await getStripe().billingPortal.sessions.create({
+      customer: params.customerId,
+      return_url: params.returnUrl
+    });
+    return { url: session.url };
+  }
+  verifyWebhookSignature(payload, signatureOrHeaders) {
+    const webhookSecret = process.env.STRIPE_WEBHOOK_SECRET;
+    if (!webhookSecret) {
+      throw new Error("STRIPE_WEBHOOK_SECRET is not configured");
+    }
+    const signature = typeof signatureOrHeaders === "string" ? signatureOrHeaders : signatureOrHeaders["stripe-signature"] || "";
+    const event = getStripe().webhooks.constructEvent(payload, signature, webhookSecret);
+    return {
+      id: event.id,
+      type: event.type,
+      data: event.data
+    };
+  }
+  async getCustomer(customerId) {
+    const customer = await getStripe().customers.retrieve(customerId);
+    if ("deleted" in customer && customer.deleted) {
+      throw new Error(`Customer ${customerId} has been deleted`);
+    }
+    return {
+      id: customer.id,
+      email: customer.email ?? null,
+      name: customer.name ?? null
+    };
+  }
+  async createCustomer(params) {
+    const customer = await getStripe().customers.create(params);
+    return {
+      id: customer.id,
+      email: customer.email ?? null,
+      name: customer.name ?? null
+    };
+  }
+  async updateSubscriptionPlan(params) {
+    var _a;
+    const { subscriptionId, newPriceId, prorationBehavior = "create_prorations" } = params;
+    const stripe = getStripe();
+    const subscription = await stripe.subscriptions.retrieve(subscriptionId);
+    const itemId = (_a = subscription.items.data[0]) == null ? void 0 : _a.id;
+    if (!itemId) {
+      throw new Error("Subscription has no items");
+    }
+    const updated = await stripe.subscriptions.update(subscriptionId, {
+      items: [{
+        id: itemId,
+        price: newPriceId
+      }],
+      proration_behavior: prorationBehavior
+    });
+    return {
+      id: updated.id,
+      status: updated.status,
+      cancelAtPeriodEnd: updated.cancel_at_period_end
+    };
   }
-  const priceId = billingPeriod === "yearly" ? planConfig.stripePriceIdYearly : planConfig.stripePriceIdMonthly;
-  if (!priceId) {
-    throw new Error(`No Stripe price configured for ${planSlug} ${billingPeriod}`);
+  async cancelSubscriptionAtPeriodEnd(subscriptionId) {
+    const updated = await getStripe().subscriptions.update(subscriptionId, {
+      cancel_at_period_end: true
+    });
+    return {
+      id: updated.id,
+      status: updated.status,
+      cancelAtPeriodEnd: updated.cancel_at_period_end
+    };
   }
-  const sessionParams = {
-    mode: "subscription",
-    payment_method_types: ["card"],
-    line_items: [{ price: priceId, quantity: 1 }],
-    success_url: successUrl,
-    cancel_url: cancelUrl,
-    metadata: { teamId, planSlug, billingPeriod },
-    client_reference_id: teamId
-  };
-  if (customerId) {
-    sessionParams.customer = customerId;
-  } else if (customerEmail) {
-    sessionParams.customer_email = customerEmail;
+  async cancelSubscriptionImmediately(subscriptionId) {
+    const canceled = await getStripe().subscriptions.cancel(subscriptionId);
+    return {
+      id: canceled.id,
+      status: canceled.status,
+      cancelAtPeriodEnd: canceled.cancel_at_period_end
+    };
   }
-  if (planConfig.trialDays && planConfig.trialDays > 0 && !customerId) {
-    sessionParams.subscription_data = {
-      trial_period_days: planConfig.trialDays
+  async reactivateSubscription(subscriptionId) {
+    const updated = await getStripe().subscriptions.update(subscriptionId, {
+      cancel_at_period_end: false
+    });
+    return {
+      id: updated.id,
+      status: updated.status,
+      cancelAtPeriodEnd: updated.cancel_at_period_end
     };
   }
-  return getStripe().checkout.sessions.create(sessionParams);
+}
+function getStripeInstance() {
+  return getStripe();
+}
+const _defaultGateway = new StripeGateway();
+async function createCheckoutSession(params) {
+  return _defaultGateway.createCheckoutSession(params);
 }
 async function createPortalSession(params) {
-  return getStripe().billingPortal.sessions.create({
-    customer: params.customerId,
-    return_url: params.returnUrl
-  });
+  return _defaultGateway.createPortalSession(params);
 }
-function verifyWebhookSignature(payload, signature) {
-  const webhookSecret = process.env.STRIPE_WEBHOOK_SECRET;
-  if (!webhookSecret) {
-    throw new Error("STRIPE_WEBHOOK_SECRET is not configured");
-  }
-  return getStripe().webhooks.constructEvent(payload, signature, webhookSecret);
+function verifyWebhookSignature(payload, signatureOrHeaders) {
+  return _defaultGateway.verifyWebhookSignature(payload, signatureOrHeaders);
 }
 async function getCustomer(customerId) {
-  return getStripe().customers.retrieve(customerId);
+  return _defaultGateway.getCustomer(customerId);
 }
 async function createCustomer(params) {
-  return getStripe().customers.create(params);
-}
-function getStripeInstance() {
-  return getStripe();
+  return _defaultGateway.createCustomer(params);
 }
 async function cancelSubscriptionAtPeriodEnd(subscriptionId) {
-  return getStripe().subscriptions.update(subscriptionId, {
-    cancel_at_period_end: true
-  });
+  return _defaultGateway.cancelSubscriptionAtPeriodEnd(subscriptionId);
 }
 async function cancelSubscriptionImmediately(subscriptionId) {
-  return getStripe().subscriptions.cancel(subscriptionId);
+  return _defaultGateway.cancelSubscriptionImmediately(subscriptionId);
 }
 async function reactivateSubscription(subscriptionId) {
-  return getStripe().subscriptions.update(subscriptionId, {
-    cancel_at_period_end: false
-  });
+  return _defaultGateway.reactivateSubscription(subscriptionId);
 }
 async function updateSubscriptionPlan(params) {
-  var _a;
-  const { subscriptionId, newPriceId, prorationBehavior = "create_prorations" } = params;
-  const stripe = getStripe();
-  const subscription = await stripe.subscriptions.retrieve(subscriptionId);
-  const itemId = (_a = subscription.items.data[0]) == null ? void 0 : _a.id;
-  if (!itemId) {
-    throw new Error("Subscription has no items");
-  }
-  return stripe.subscriptions.update(subscriptionId, {
-    items: [{
-      id: itemId,
-      price: newPriceId
-    }],
-    proration_behavior: prorationBehavior
-  });
+  return _defaultGateway.updateSubscriptionPlan(params);
 }
 export {
+  StripeGateway,
   cancelSubscriptionAtPeriodEnd,
   cancelSubscriptionImmediately,
   createCheckoutSession,