@nextsparkjs/core 0.1.0-beta.127 → 0.1.0-beta.128

package/dist/components/billing/ManageBillingButton.d.ts

@@ -2,10 +2,10 @@ interface ManageBillingButtonProps {
     className?: string;
 }
 /**
- * ManageBillingButton - Redirect to Stripe Customer Portal
+ * ManageBillingButton - Redirect to Billing Management Portal
  *
- * Button that opens Stripe's hosted billing portal for subscription management.
- * Only visible for subscriptions with an external Stripe customer ID.
+ * Button that opens the payment provider's hosted billing portal for subscription management.
+ * Only visible for subscriptions with an external customer ID.
  *
  * Features:
  * - Update payment method

package/dist/lib/api/rate-limit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/lib/api/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAa,EACpB,QAAQ,GAAE,MAAc,GACvB,eAAe,CAyCjB;AAED;;;GAGG;AACH,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,aAAqB,GAC1B,OAAO,CAAC,eAAe,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsCpD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAwB5G;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,GACf,YAAY,GAAG,IAAI,CAkCrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,GACf,YAAY,CASd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,EAC/C,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,IAEtD,SAAS,WAAW,EAAE,GAAG,MAAM,CAAC,KAAG,OAAO,CAAC,YAAY,CAAC,CAsCvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,IAAI,CAaP;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CASD;AAED;;GAEG;AACH,wBAAgB,sBAAsB;;;;;EAErC;AAmGD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,EACnD,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,EACpE,IAAI,GAAE,aAAqB,IAEb,SAAS,WAAW,EAAE,GAAG,MAAM,CAAC,KAAG,OAAO,CAAC,YAAY,CAAC,CAkCvE"}
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/lib/api/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAa,EACpB,QAAQ,GAAE,MAAc,GACvB,eAAe,CAyCjB;AAED;;;GAGG;AACH,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,aAAqB,GAC1B,OAAO,CAAC,eAAe,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCpD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,eAAe,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAwB5G;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,GACf,YAAY,GAAG,IAAI,CAkCrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,GACf,YAAY,CASd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,EAC/C,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,IAEtD,SAAS,WAAW,EAAE,GAAG,MAAM,CAAC,KAAG,OAAO,CAAC,YAAY,CAAC,CAsCvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,IAAI,CAaP;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CASD;AAED;;GAEG;AACH,wBAAgB,sBAAsB;;;;;EAErC;AAoGD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,EACnD,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,EACpE,IAAI,GAAE,aAAqB,IAEb,SAAS,WAAW,EAAE,GAAG,MAAM,CAAC,KAAG,OAAO,CAAC,YAAY,CAAC,CAkCvE"}

package/dist/lib/api/rate-limit.js

@@ -46,7 +46,8 @@ async function checkDistributedRateLimit(identifier, type = "api") {
       api: 100,
       strict: 10,
       read: 200,
-      write: 50
+      write: 50,
+      webhook: 500
     };
     return {
       allowed: result2.success,
@@ -65,8 +66,10 @@ async function checkDistributedRateLimit(identifier, type = "api") {
     // 10 requests per hour
     read: { limit: 200, windowMs: 60 * 1e3 },
     // 200 requests per minute
-    write: { limit: 50, windowMs: 60 * 1e3 }
+    write: { limit: 50, windowMs: 60 * 1e3 },
     // 50 requests per minute
+    webhook: { limit: 500, windowMs: 60 * 60 * 1e3 }
+    // 500 requests per hour
   };
   const config = limits[type];
   const result = checkRateLimit(`${type}:${identifier}`, config.limit, config.windowMs);
@@ -200,15 +203,15 @@ function getRateLimitCacheStats() {
   return rateLimitCache.getStats();
 }
 function getClientIp(request) {
+  const cfIp = request.headers.get("cf-connecting-ip");
+  if (cfIp) return cfIp;
   const forwardedFor = request.headers.get("x-forwarded-for");
   if (forwardedFor) {
-    const ips = forwardedFor.split(",").map((ip) => ip.trim());
-    if (ips[0]) return ips[0];
+    const ips = forwardedFor.split(",").map((ip) => ip.trim()).filter(Boolean);
+    if (ips.length > 0) return ips[ips.length - 1];
   }
   const realIp = request.headers.get("x-real-ip");
   if (realIp) return realIp;
-  const cfIp = request.headers.get("cf-connecting-ip");
-  if (cfIp) return cfIp;
   const trueClientIp = request.headers.get("true-client-ip");
   if (trueClientIp) return trueClientIp;
   return "unknown";

package/dist/lib/billing/config-types.d.ts

@@ -37,10 +37,7 @@ export interface PlanDefinition {
     features: string[];
     /** Map of limitSlug -> value (-1 means unlimited) */
     limits: Record<string, number>;
-    /** Stripe price IDs (P2: Stripe Integration) */
-    stripePriceIdMonthly?: string | null;
-    stripePriceIdYearly?: string | null;
-    /** Generic price IDs for any payment provider (checked first, falls back to stripe-specific) */
+    /** Price IDs for the configured payment provider (monthly and yearly) */
     providerPriceIds?: {
         monthly?: string | null;
         yearly?: string | null;
@@ -64,7 +61,7 @@ export interface ActionMappings {
     limits: Record<string, string>;
 }
 export interface BillingConfig {
-    /** Payment provider: stripe, paddle, lemonsqueezy */
+    /** Payment provider: stripe, polar */
     provider: PaymentProvider;
     /** Default currency (ISO 4217) */
     currency: string;

package/dist/lib/billing/config-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../../../src/lib/billing/config-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAMxE,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;IACjC,sCAAsC;IACtC,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;CACtD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,QAAQ,CAAA;IACd,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnC,gGAAgG;IAChG,gBAAgB,CAAC,EAAE;QACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KACvB,CAAA;CACF;AAMD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAMD,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,EAAE,eAAe,CAAA;IAEzB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAEhB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAA;IAEnB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAE3C,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAEvC,uBAAuB;IACvB,KAAK,EAAE,cAAc,EAAE,CAAA;IAEvB,uCAAuC;IACvC,cAAc,EAAE,cAAc,CAAA;CAC/B"}
+{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../../../src/lib/billing/config-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAMxE,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;IACjC,sCAAsC;IACtC,WAAW,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;CACtD;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,QAAQ,CAAA;IACd,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE;QACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;QACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KACvB,CAAA;CACF;AAMD,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAMD,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,EAAE,eAAe,CAAA;IAEzB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAEhB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAA;IAEnB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAE3C,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAEvC,uBAAuB;IACvB,KAAK,EAAE,cAAc,EAAE,CAAA;IAEvB,uCAAuC;IACvC,cAAc,EAAE,cAAc,CAAA;CAC/B"}

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

@@ -2,8 +2,7 @@
  * Billing Gateway Factory
  *
  * Returns the configured BillingGateway implementation based on the
- * provider setting in the billing registry. Uses lazy loading so that
- * provider SDKs (Stripe, Polar, etc.) are only imported when needed.
+ * provider setting in the billing registry.
  *
  * Usage:
  *   import { getBillingGateway } from '@nextsparkjs/core/lib/billing/gateways/factory'
@@ -17,6 +16,18 @@ import type { BillingGateway } from './interface';
  * Provider is determined by BILLING_REGISTRY.config.provider (from billing.config.ts).
  */
 export declare function getBillingGateway(): BillingGateway;
+/**
+ * Get resource hint domains for the configured billing provider.
+ * Use in <head> for performance optimization.
+ *
+ * @example
+ * // In layout.tsx:
+ * const { preconnect, dnsPrefetch } = getBillingResourceHints()
+ */
+export declare function getBillingResourceHints(): {
+    preconnect: string[];
+    dnsPrefetch: string[];
+};
 /**
  * Reset the cached gateway instance.
  * Useful for testing or when billing config changes at runtime.

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/billing/gateways/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CA4BlD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/billing/gateways/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAuBlD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAMzF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

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

@@ -1,22 +1,21 @@
 import { BILLING_REGISTRY } from "@nextsparkjs/registries/billing-registry";
+import { StripeGateway } from "./stripe.js";
+import { PolarGateway } from "./polar.js";
 let gatewayInstance = null;
 function getBillingGateway() {
   if (!gatewayInstance) {
     const provider = BILLING_REGISTRY.provider;
     switch (provider) {
-      case "stripe": {
-        const { StripeGateway } = require("./stripe");
+      case "stripe":
         gatewayInstance = new StripeGateway();
         break;
-      }
-      case "polar": {
-        const { PolarGateway } = require("./polar");
+      case "polar":
         gatewayInstance = new PolarGateway();
         break;
-      }
       // Future providers:
       // case 'paddle': { ... }
       // case 'lemonsqueezy': { ... }
+      // case 'mercadopago': { ... }
       default:
         throw new Error(
           `Unsupported billing provider: "${provider}". Supported providers: stripe, polar. Check your billing.config.ts provider setting.`
@@ -25,10 +24,18 @@ function getBillingGateway() {
   }
   return gatewayInstance;
 }
+function getBillingResourceHints() {
+  try {
+    return getBillingGateway().getResourceHintDomains();
+  } catch {
+    return { preconnect: [], dnsPrefetch: [] };
+  }
+}
 function resetBillingGateway() {
   gatewayInstance = null;
 }
 export {
   getBillingGateway,
+  getBillingResourceHints,
   resetBillingGateway
 };

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

@@ -5,9 +5,10 @@
  * 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';
+import type { CheckoutSessionResult, PortalSessionResult, SubscriptionResult, CustomerResult, WebhookEventResult, CreateCheckoutParams, CreatePortalParams, CreateCustomerParams, UpdateSubscriptionParams, CreateOneTimeCheckoutParams } from './types';
 export interface BillingGateway {
     createCheckoutSession(params: CreateCheckoutParams): Promise<CheckoutSessionResult>;
+    createOneTimeCheckout(params: CreateOneTimeCheckoutParams): Promise<CheckoutSessionResult>;
     createPortalSession(params: CreatePortalParams): Promise<PortalSessionResult>;
     getCustomer(customerId: string): Promise<CustomerResult>;
     createCustomer(params: CreateCustomerParams): Promise<CustomerResult>;
@@ -15,6 +16,23 @@ export interface BillingGateway {
     cancelSubscriptionAtPeriodEnd(subscriptionId: string): Promise<SubscriptionResult>;
     cancelSubscriptionImmediately(subscriptionId: string): Promise<SubscriptionResult>;
     reactivateSubscription(subscriptionId: string): Promise<SubscriptionResult>;
+    /** Get the human-readable provider name (e.g., "Stripe", "Polar") */
+    getProviderName(): string;
+    /**
+     * Get resource hint domains for the <head>.
+     * - preconnect: domains loaded immediately on page render (DNS + TCP + TLS)
+     * - dnsPrefetch: domains used later after user interaction (DNS only)
+     *
+     * Note: preconnect sockets expire after ~10s, so only use for resources
+     * loaded during initial render. Use dnsPrefetch for domains used after
+     * user interaction (e.g., API calls on form submit).
+     */
+    getResourceHintDomains(): {
+        preconnect: string[];
+        dnsPrefetch: string[];
+    };
+    /** Get the provider dashboard URL for a subscription (e.g., Stripe Dashboard, Polar Dashboard) */
+    getSubscriptionDashboardUrl(externalSubscriptionId: string | null | undefined): string | null;
     verifyWebhookSignature(payload: string | Buffer, signatureOrHeaders: string | Record<string, string>): WebhookEventResult;
 }
 //# sourceMappingURL=interface.d.ts.map

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

@@ -1 +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"}
+{"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,EACxB,2BAA2B,EAC5B,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,cAAc;IAE7B,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACnF,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAC1F,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,qEAAqE;IACrE,eAAe,IAAI,MAAM,CAAA;IAEzB;;;;;;;;OAQG;IACH,sBAAsB,IAAI;QACxB,UAAU,EAAE,MAAM,EAAE,CAAA;QACpB,WAAW,EAAE,MAAM,EAAE,CAAA;KACtB,CAAA;IAED,kGAAkG;IAClG,2BAA2B,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAAA;IAG7F,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

@@ -23,13 +23,14 @@
  */
 import { Polar } from '@polar-sh/sdk';
 import type { BillingGateway } from './interface';
-import type { CheckoutSessionResult, PortalSessionResult, SubscriptionResult, CustomerResult, WebhookEventResult, CreateCheckoutParams, CreatePortalParams, CreateCustomerParams, UpdateSubscriptionParams } from './types';
+import type { CheckoutSessionResult, PortalSessionResult, SubscriptionResult, CustomerResult, WebhookEventResult, CreateCheckoutParams, CreatePortalParams, CreateCustomerParams, UpdateSubscriptionParams, CreateOneTimeCheckoutParams } 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>;
+    createOneTimeCheckout(params: CreateOneTimeCheckoutParams): Promise<CheckoutSessionResult>;
     createPortalSession(params: CreatePortalParams): Promise<PortalSessionResult>;
     verifyWebhookSignature(payload: string | Buffer, signatureOrHeaders: string | Record<string, string>): WebhookEventResult;
     getCustomer(customerId: string): Promise<CustomerResult>;
@@ -37,6 +38,12 @@ export declare class PolarGateway implements BillingGateway {
     updateSubscriptionPlan(params: UpdateSubscriptionParams): Promise<SubscriptionResult>;
     cancelSubscriptionAtPeriodEnd(subscriptionId: string): Promise<SubscriptionResult>;
     cancelSubscriptionImmediately(subscriptionId: string): Promise<SubscriptionResult>;
+    getProviderName(): string;
+    getResourceHintDomains(): {
+        preconnect: string[];
+        dnsPrefetch: string[];
+    };
+    getSubscriptionDashboardUrl(externalSubscriptionId: string | null | undefined): string | null;
     reactivateSubscription(subscriptionId: string): Promise<SubscriptionResult>;
 }
 /**

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

@@ -1 +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"}
+{"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,EACxB,2BAA2B,EAC5B,MAAM,SAAS,CAAA;AAiBhB;;;GAGG;AACH,qBAAa,YAAa,YAAW,cAAc;IAC3C,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0BnF,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAoB1F,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;IAaxF,eAAe,IAAI,MAAM;IAIzB,sBAAsB,IAAI;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE;IAMzE,2BAA2B,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI;IAOvF,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

@@ -34,6 +34,21 @@ class PolarGateway {
       url: result.url ?? null
     };
   }
+  async createOneTimeCheckout(params) {
+    const { teamId, priceId, successUrl, cancelUrl, customerEmail, customerId, metadata } = params;
+    const checkoutParams = {
+      products: [priceId],
+      successUrl,
+      metadata: { teamId, ...metadata },
+      allowTrial: false,
+      // one-time purchases should never start a trial
+      ...cancelUrl && { returnUrl: cancelUrl },
+      ...customerEmail && { customerEmail },
+      ...customerId && { customerId }
+    };
+    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({
@@ -127,6 +142,16 @@ class PolarGateway {
       cancelAtPeriodEnd: false
     };
   }
+  getProviderName() {
+    return "Polar";
+  }
+  getResourceHintDomains() {
+    return { preconnect: [], dnsPrefetch: [] };
+  }
+  getSubscriptionDashboardUrl(externalSubscriptionId) {
+    if (!externalSubscriptionId) return null;
+    return "https://polar.sh/dashboard/sales/subscriptions";
+  }
   async reactivateSubscription(subscriptionId) {
     const result = await getPolar().subscriptions.update({
       id: subscriptionId,

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

@@ -6,16 +6,15 @@
  *
  * P2: Stripe Integration
  */
-import Stripe from 'stripe';
 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';
+import type { CheckoutSessionResult, PortalSessionResult, SubscriptionResult, CustomerResult, WebhookEventResult, CreateCheckoutParams, CreatePortalParams, CreateCustomerParams, UpdateSubscriptionParams, CreateOneTimeCheckoutParams } 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>;
+    createOneTimeCheckout(params: CreateOneTimeCheckoutParams): Promise<CheckoutSessionResult>;
     createPortalSession(params: CreatePortalParams): Promise<PortalSessionResult>;
     verifyWebhookSignature(payload: string | Buffer, signatureOrHeaders: string | Record<string, string>): WebhookEventResult;
     getCustomer(customerId: string): Promise<CustomerResult>;
@@ -23,29 +22,12 @@ export declare class StripeGateway implements BillingGateway {
     updateSubscriptionPlan(params: UpdateSubscriptionParams): Promise<SubscriptionResult>;
     cancelSubscriptionAtPeriodEnd(subscriptionId: string): Promise<SubscriptionResult>;
     cancelSubscriptionImmediately(subscriptionId: string): Promise<SubscriptionResult>;
+    getProviderName(): string;
+    getResourceHintDomains(): {
+        preconnect: string[];
+        dnsPrefetch: string[];
+    };
+    getSubscriptionDashboardUrl(externalSubscriptionId: string | null | undefined): string | null;
     reactivateSubscription(subscriptionId: string): Promise<SubscriptionResult>;
 }
-/**
- * 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;
-/** @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;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"}
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../../../src/lib/billing/gateways/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,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,EACxB,2BAA2B,EAC5B,MAAM,SAAS,CAAA;AAkBhB;;;GAGG;AACH,qBAAa,aAAc,YAAW,cAAc;IAC5C,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA2CnF,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAuB1F,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;IASxF,eAAe,IAAI,MAAM;IAIzB,sBAAsB,IAAI;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE;IASzE,2BAA2B,CAAC,sBAAsB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI;IAOvF,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAUlF"}

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

@@ -1,5 +1,6 @@
 import Stripe from "stripe";
 import { BILLING_REGISTRY } from "@nextsparkjs/registries/billing-registry";
+import { PlanService } from "../../services/plan.service.js";
 let stripeInstance = null;
 function getStripe() {
   if (!stripeInstance) {
@@ -20,9 +21,9 @@ class StripeGateway {
     if (!planConfig) {
       throw new Error(`Plan ${planSlug} not found in BILLING_REGISTRY`);
     }
-    const priceId = billingPeriod === "yearly" ? planConfig.stripePriceIdYearly : planConfig.stripePriceIdMonthly;
+    const priceId = PlanService.getPriceId(planSlug, billingPeriod);
     if (!priceId) {
-      throw new Error(`No Stripe price configured for ${planSlug} ${billingPeriod}`);
+      throw new Error(`No price ID configured for ${planSlug} ${billingPeriod}`);
     }
     const sessionParams = {
       mode: "subscription",
@@ -46,6 +47,25 @@ class StripeGateway {
     const session = await getStripe().checkout.sessions.create(sessionParams);
     return { id: session.id, url: session.url };
   }
+  async createOneTimeCheckout(params) {
+    const { teamId, priceId, quantity = 1, successUrl, cancelUrl, customerEmail, customerId, metadata } = params;
+    const sessionParams = {
+      mode: "payment",
+      payment_method_types: ["card"],
+      line_items: [{ price: priceId, quantity }],
+      success_url: successUrl,
+      cancel_url: cancelUrl,
+      metadata: { teamId, ...metadata },
+      client_reference_id: teamId
+    };
+    if (customerId) {
+      sessionParams.customer = customerId;
+    } else if (customerEmail) {
+      sessionParams.customer_email = customerEmail;
+    }
+    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,
@@ -125,6 +145,24 @@ class StripeGateway {
       cancelAtPeriodEnd: canceled.cancel_at_period_end
     };
   }
+  getProviderName() {
+    return "Stripe";
+  }
+  getResourceHintDomains() {
+    return {
+      // js.stripe.com: Stripe.js SDK loaded on page render
+      preconnect: ["https://js.stripe.com"],
+      // api.stripe.com: called by Stripe.js after user fills payment form (too late for preconnect)
+      dnsPrefetch: ["https://api.stripe.com"]
+    };
+  }
+  getSubscriptionDashboardUrl(externalSubscriptionId) {
+    var _a;
+    if (!externalSubscriptionId) return null;
+    const isLive = (_a = process.env.STRIPE_SECRET_KEY) == null ? void 0 : _a.startsWith("sk_live");
+    const prefix = isLive ? "" : "test/";
+    return `https://dashboard.stripe.com/${prefix}subscriptions/${externalSubscriptionId}`;
+  }
   async reactivateSubscription(subscriptionId) {
     const updated = await getStripe().subscriptions.update(subscriptionId, {
       cancel_at_period_end: false
@@ -136,47 +174,6 @@ class StripeGateway {
     };
   }
 }
-function getStripeInstance() {
-  return getStripe();
-}
-const _defaultGateway = new StripeGateway();
-async function createCheckoutSession(params) {
-  return _defaultGateway.createCheckoutSession(params);
-}
-async function createPortalSession(params) {
-  return _defaultGateway.createPortalSession(params);
-}
-function verifyWebhookSignature(payload, signatureOrHeaders) {
-  return _defaultGateway.verifyWebhookSignature(payload, signatureOrHeaders);
-}
-async function getCustomer(customerId) {
-  return _defaultGateway.getCustomer(customerId);
-}
-async function createCustomer(params) {
-  return _defaultGateway.createCustomer(params);
-}
-async function cancelSubscriptionAtPeriodEnd(subscriptionId) {
-  return _defaultGateway.cancelSubscriptionAtPeriodEnd(subscriptionId);
-}
-async function cancelSubscriptionImmediately(subscriptionId) {
-  return _defaultGateway.cancelSubscriptionImmediately(subscriptionId);
-}
-async function reactivateSubscription(subscriptionId) {
-  return _defaultGateway.reactivateSubscription(subscriptionId);
-}
-async function updateSubscriptionPlan(params) {
-  return _defaultGateway.updateSubscriptionPlan(params);
-}
 export {
-  StripeGateway,
-  cancelSubscriptionAtPeriodEnd,
-  cancelSubscriptionImmediately,
-  createCheckoutSession,
-  createCustomer,
-  createPortalSession,
-  getCustomer,
-  getStripeInstance,
-  reactivateSubscription,
-  updateSubscriptionPlan,
-  verifyWebhookSignature
+  StripeGateway
 };

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

@@ -47,6 +47,17 @@ export interface CreateCustomerParams {
 export interface UpdateSubscriptionParams {
     subscriptionId: string;
     newPriceId: string;
+    /** Proration behavior when changing plans. Default: 'create_prorations' */
     prorationBehavior?: 'create_prorations' | 'none' | 'always_invoice';
 }
+export interface CreateOneTimeCheckoutParams {
+    teamId: string;
+    priceId: string;
+    quantity?: number;
+    successUrl: string;
+    cancelUrl: string;
+    customerEmail?: string;
+    customerId?: string;
+    metadata?: Record<string, string>;
+}
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/billing/gateways/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;CACZ;AAMD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAMD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAMD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAMD,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,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/billing/gateways/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;CACZ;AAMD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAMD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAMD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAMD,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,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,gBAAgB,CAAA;CACpE;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC"}

package/dist/lib/billing/jobs.d.ts

@@ -14,7 +14,7 @@ export interface JobResult {
 }
 /**
  * Expire trials that have passed their trial end date
- * Trial -> Expired (if no payment method) or Active (if payment processed by Stripe)
+ * Trial -> Expired (if no payment method) or Active (if payment processed by provider)
  */
 export declare function expireTrials(): Promise<JobResult>;
 /**

package/dist/lib/billing/polar-webhook.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Polar.sh Webhook Types
+ *
+ * Exports extension interfaces for the Polar webhook handler.
+ * Projects override lib/billing/polar-webhook-extensions.ts to handle
+ * one-time payment events (credit packs, LTD purchases, upsells, etc.)
+ *
+ * Usage in lib/billing/polar-webhook-extensions.ts:
+ *   import type { PolarWebhookExtensions } from '@nextsparkjs/core/lib/billing/polar-webhook'
+ *
+ *   export const polarWebhookExtensions: PolarWebhookExtensions = {
+ *     onOneTimePaymentCompleted: async (order, context) => {
+ *       if (order.metadata?.type === 'credit_pack') {
+ *         await handleCreditPackPurchase(order, context)
+ *       }
+ *     }
+ *   }
+ */
+import type { OneTimePaymentContext } from './types';
+export type { OneTimePaymentContext };
+export interface PolarOrderData {
+    id: string;
+    amount: number;
+    currency: string;
+    metadata: Record<string, string>;
+    customerId?: string;
+    externalCustomerId?: string;
+    productId?: string;
+}
+export interface PolarWebhookExtensions {
+    /**
+     * Called when a Polar order.paid event fires for an order with no subscriptionId
+     * (i.e. a one-time purchase, not a recurring subscription payment).
+     * Use this for credit packs, one-time purchases, etc.
+     */
+    onOneTimePaymentCompleted?: (order: PolarOrderData, context: OneTimePaymentContext) => Promise<void>;
+}
+//# sourceMappingURL=polar-webhook.d.ts.map

package/dist/lib/billing/polar-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polar-webhook.d.ts","sourceRoot":"","sources":["../../../src/lib/billing/polar-webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEpD,YAAY,EAAE,qBAAqB,EAAE,CAAA;AAErC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,yBAAyB,CAAC,EAAE,CAC1B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAA;CACnB"}

package/dist/lib/billing/schema.d.ts

@@ -25,8 +25,7 @@ export declare const subscriptionStatusSchema: z.ZodEnum<{
 }>;
 export declare const paymentProviderSchema: z.ZodEnum<{
     stripe: "stripe";
-    paddle: "paddle";
-    lemonsqueezy: "lemonsqueezy";
+    polar: "polar";
 }>;
 export declare const billingEventTypeSchema: z.ZodEnum<{
     payment: "payment";

package/dist/lib/billing/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/lib/billing/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,cAAc;;;;EAAyC,CAAA;AAEpE,eAAO,MAAM,oBAAoB;;;;EAA8C,CAAA;AAE/E,eAAO,MAAM,wBAAwB;;;;;;;EAOnC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;;EAA+C,CAAA;AAEjF,eAAO,MAAM,sBAAsB;;;;;EAAqD,CAAA;AAExF,eAAO,MAAM,wBAAwB;;;;EAA6C,CAAA;AAMlF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;iBAc3B,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;iBAA6B,CAAA;AAM1D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;iBAQnC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAInC,CAAA;AAMF,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAA;AAMF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;iBAUnC,CAAA;AAMF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAC9E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/lib/billing/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,cAAc;;;;EAAyC,CAAA;AAEpE,eAAO,MAAM,oBAAoB;;;;EAA8C,CAAA;AAE/E,eAAO,MAAM,wBAAwB;;;;;;;EAOnC,CAAA;AAEF,eAAO,MAAM,qBAAqB;;;EAA8B,CAAA;AAEhE,eAAO,MAAM,sBAAsB;;;;;EAAqD,CAAA;AAExF,eAAO,MAAM,wBAAwB;;;;EAA6C,CAAA;AAMlF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;iBAc3B,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;iBAA6B,CAAA;AAM1D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;iBAQnC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAInC,CAAA;AAMF,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAA;AAMF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;iBAUnC,CAAA;AAMF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAC9E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/lib/billing/schema.js

@@ -9,7 +9,7 @@ const subscriptionStatusSchema = z.enum([
   "paused",
   "expired"
 ]);
-const paymentProviderSchema = z.enum(["stripe", "paddle", "lemonsqueezy"]);
+const paymentProviderSchema = z.enum(["stripe", "polar"]);
 const billingEventTypeSchema = z.enum(["payment", "refund", "invoice", "credit"]);
 const billingEventStatusSchema = z.enum(["pending", "succeeded", "failed"]);
 const createPlanSchema = z.object({