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

package/dist/hooks/useQuotaCheck.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Hook to check if the current team can perform a billing action.
+ * Used to gate entity creation based on plan limits.
+ *
+ * @param action - The action to check (e.g., 'professionals.create')
+ * @param enabled - Whether to run the check (default: true)
+ *
+ * @example
+ * const { canCreate, isLoading, reason } = useQuotaCheck('professionals.create')
+ * if (!canCreate) showUpgradeBanner()
+ */
+export declare function useQuotaCheck(action: string, enabled?: boolean): {
+    canCreate: boolean;
+    isLoading: boolean;
+    reason: string;
+    message: string;
+    meta: {
+        limitSlug?: string;
+        remaining?: number;
+        requiredFeature?: string;
+        currentPlan?: string;
+    };
+    isQuotaExceeded: boolean;
+    isFeatureBlocked: boolean;
+};
+//# sourceMappingURL=useQuotaCheck.d.ts.map

package/dist/hooks/useQuotaCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQuotaCheck.d.ts","sourceRoot":"","sources":["../../src/hooks/useQuotaCheck.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,UAAO;;;;;;oBAlB5C,MAAM;oBACN,MAAM;0BACA,MAAM;sBACV,MAAM;;;;EAwCvB"}

package/dist/hooks/useQuotaCheck.js

@@ -0,0 +1,33 @@
+"use client";
+import { useQuery } from "@tanstack/react-query";
+import { fetchWithTeam } from "../lib/api/entities.js";
+function useQuotaCheck(action, enabled = true) {
+  const { data, isLoading } = useQuery({
+    queryKey: ["quota-check", action],
+    queryFn: async () => {
+      const res = await fetchWithTeam("/api/v1/billing/check-action", {
+        method: "POST",
+        body: JSON.stringify({ action })
+      });
+      const json = await res.json();
+      return json.data || { allowed: true };
+    },
+    enabled,
+    staleTime: 3e4,
+    // Cache for 30s
+    retry: false
+  });
+  return {
+    canCreate: (data == null ? void 0 : data.allowed) ?? true,
+    // Default to true while loading
+    isLoading,
+    reason: data == null ? void 0 : data.reason,
+    message: data == null ? void 0 : data.message,
+    meta: data == null ? void 0 : data.meta,
+    isQuotaExceeded: (data == null ? void 0 : data.reason) === "quota_exceeded",
+    isFeatureBlocked: (data == null ? void 0 : data.reason) === "feature_not_in_plan"
+  };
+}
+export {
+  useQuotaCheck
+};

package/dist/lib/api/entity/generic-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generic-handler.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/entity/generic-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAkYvD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAwdnF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CA2SrF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CA+KpJ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAyStJ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAmHtJ;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAEtF"}
+{"version":3,"file":"generic-handler.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/entity/generic-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAqYvD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAwdnF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAiVrF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CA+KpJ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAyStJ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAkItJ;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAEtF"}

package/dist/lib/api/entity/generic-handler.js

@@ -21,6 +21,9 @@ import { afterEntityCreate, afterEntityUpdate, afterEntityDelete } from "../../e
 import { extractPatternIds } from "../../blocks/pattern-resolver.js";
 import { isPatternReference } from "../../../types/pattern-reference.js";
 import { PatternUsageService } from "../../services/pattern-usage.service.js";
+import { SubscriptionService } from "../../services/subscription.service.js";
+import { UsageService } from "../../services/usage.service.js";
+import { BILLING_REGISTRY } from "@nextsparkjs/registries/billing-registry";
 function filterPublicFields(data, entityConfig, userId) {
   var _a;
   const publicFields = (_a = entityConfig.access) == null ? void 0 : _a.publicFields;
@@ -531,7 +534,7 @@ async function handleGenericList(request) {
   }
 }
 async function handleGenericCreate(request) {
-  var _a, _b, _c, _d, _e, _f, _g;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   try {
     const resolution = await resolveEntityFromUrl(request.nextUrl.pathname);
     if (!resolution.isValidEntity || !resolution.entityConfig) {
@@ -666,14 +669,45 @@ async function handleGenericCreate(request) {
         }
       }
     });
+    const createAction = `${entityConfig.slug}.create`;
+    const limitSlug = (_f = (_e = (_d = BILLING_REGISTRY) == null ? void 0 : _d.actionMappings) == null ? void 0 : _e.limits) == null ? void 0 : _f[createAction];
+    if (limitSlug) {
+      const actionResult = await SubscriptionService.canPerformAction(
+        authResult.user.id,
+        teamId,
+        createAction
+      );
+      if (!actionResult.allowed) {
+        const statusCode = actionResult.reason === "quota_exceeded" ? 429 : 403;
+        const response2 = createApiError(
+          actionResult.message || `Quota exceeded for ${entityConfig.slug}`,
+          statusCode,
+          void 0,
+          actionResult.reason === "quota_exceeded" ? "QUOTA_EXCEEDED" : "FEATURE_NOT_IN_PLAN"
+        );
+        return addCorsHeaders(response2, request);
+      }
+    }
     const insertQuery = `
       INSERT INTO "${tableName}" (${insertFields.join(", ")})
       VALUES (${placeholders.join(", ")}) RETURNING *
     `;
     const insertResult = await mutateWithRLS(insertQuery, values, authResult.user.id);
-    const createdEntityId = String((_d = insertResult.rows[0]) == null ? void 0 : _d.id);
+    const createdEntityId = String((_g = insertResult.rows[0]) == null ? void 0 : _g.id);
+    if (limitSlug) {
+      UsageService.track({
+        teamId,
+        userId: authResult.user.id,
+        limitSlug,
+        delta: 1,
+        action: createAction,
+        resourceType: entityConfig.slug,
+        resourceId: createdEntityId
+      }).catch(() => {
+      });
+    }
     const systemFields = ["id", "userId", "teamId", "createdAt", "updatedAt"];
-    if ((_e = entityConfig.builder) == null ? void 0 : _e.enabled) {
+    if ((_h = entityConfig.builder) == null ? void 0 : _h.enabled) {
       systemFields.push("blocks");
     }
     const configFields = entityConfig.fields.map((field) => {
@@ -692,7 +726,7 @@ async function handleGenericCreate(request) {
     `;
     const createdItems = await queryWithRLS(selectQuery, [createdEntityId], authResult.user.id);
     const createdItem = createdItems[0];
-    if ((_f = entityConfig.taxonomies) == null ? void 0 : _f.enabled) {
+    if ((_i = entityConfig.taxonomies) == null ? void 0 : _i.enabled) {
       await processTaxonomyRelations(entityConfig, createdEntityId, body, authResult.user.id, false);
     }
     const metadataWasProvided = metas && typeof metas === "object" && Object.keys(metas).length > 0;
@@ -705,7 +739,7 @@ async function handleGenericCreate(request) {
       );
     }
     let responseItem = createdItem;
-    if ((_g = entityConfig.taxonomies) == null ? void 0 : _g.enabled) {
+    if ((_j = entityConfig.taxonomies) == null ? void 0 : _j.enabled) {
       const itemsWithTaxonomies = await includeTaxonomiesInData(
         entityConfig,
         [createdItem],
@@ -1062,7 +1096,7 @@ async function handleGenericUpdate(request, { params }) {
   }
 }
 async function handleGenericDelete(request, { params }) {
-  var _a, _b;
+  var _a, _b, _c, _d, _e;
   try {
     const { id } = await params;
     const resolution = await resolveEntityFromUrl(request.nextUrl.pathname);
@@ -1137,6 +1171,20 @@ async function handleGenericDelete(request, { params }) {
     } catch (hookError) {
       console.error(`[generic-handler] Error in afterEntityDelete hook for ${entityConfig.slug}:`, hookError);
     }
+    const deleteAction = `${entityConfig.slug}.create`;
+    const deleteLimitSlug = (_e = (_d = (_c = BILLING_REGISTRY) == null ? void 0 : _c.actionMappings) == null ? void 0 : _d.limits) == null ? void 0 : _e[deleteAction];
+    if (deleteLimitSlug) {
+      UsageService.track({
+        teamId,
+        userId: authResult.user.id,
+        limitSlug: deleteLimitSlug,
+        delta: -1,
+        action: `${entityConfig.slug}.delete`,
+        resourceType: entityConfig.slug,
+        resourceId: id
+      }).catch(() => {
+      });
+    }
     const response = createApiResponse({ success: true, id });
     return addCorsHeaders(response, request);
   } catch (error) {

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"}