@codelitdev/billing 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/workflows/engine.js

@@ -1,13 +1,13 @@
-import { checkoutIsAvailable, toPublicCatalog, } from "../catalog/public-view.js";
-import { catalogMatchesProviderSnapshot, validateCatalog, } from "../catalog/validate.js";
+import { checkoutIsAvailable, toPublicCatalog } from "../catalog/public-view.js";
 import { canActivateRevision } from "../catalog/revisions.js";
-import { BillingProviderError, BillingCompositionError, BillingWorkflowError, providerErrorSummary, } from "../core/errors.js";
+import { catalogMatchesProviderSnapshot, validateCatalog, } from "../catalog/validate.js";
+import { BillingCompositionError, BillingProviderError, BillingWorkflowError, providerErrorSummary, } from "../core/errors.js";
 import { retainsPaidEntitlement } from "../core/subscription.js";
 import { decideCheckoutTransition, decideCustomerTransition, decidePlanChangeTransition, decideSubscriptionTransition, decideWebhookInboxTransition, } from "../core/transitions.js";
-import { noopTelemetry, safeTelemetry, } from "../ports/telemetry.js";
+import { billingWebhookRetry, DEFAULT_WEBHOOK_MAX_ATTEMPTS, } from "../maintenance/retry.js";
 import { applySubscriptionProjection, MemoryBillingStore, newId, } from "../persistence/memory.js";
+import { noopTelemetry, safeTelemetry, } from "../ports/telemetry.js";
 import { BillingProviderRegistry } from "../providers/registry.js";
-import { billingWebhookRetry, DEFAULT_WEBHOOK_MAX_ATTEMPTS, } from "../maintenance/retry.js";
 const LEASE_MS = 5 * 60 * 1000;
 export function createBilling(options) {
     if (options.mode === "cloud" && !options.hooks?.audit) {
@@ -16,8 +16,7 @@ export function createBilling(options) {
     if (options.webhookRetrieveCurrent === false) {
         throw new BillingCompositionError("webhook_current_retrieval_required");
     }
-    if (options.mode === "cloud" &&
-        typeof options.returnUrlValidator !== "function") {
+    if (options.mode === "cloud" && typeof options.returnUrlValidator !== "function") {
         throw new BillingCompositionError("return_url_validator_required");
     }
     const store = options.database ?? new MemoryBillingStore();
@@ -41,10 +40,8 @@ export function createBilling(options) {
             !Array.isArray(options.requiredOfferKeys) ||
             options.requiredOfferKeys.length === 0 ||
             !Array.isArray(options.offers) ||
-            new Set(options.requiredOfferKeys).size !==
-                options.requiredOfferKeys.length ||
-            options.requiredOfferKeys.some((key) => !isBoundedOpaqueId(key) ||
-                !/^[A-Za-z0-9][A-Za-z0-9_.:-]*$/.test(key)) ||
+            new Set(options.requiredOfferKeys).size !== options.requiredOfferKeys.length ||
+            options.requiredOfferKeys.some((key) => !isBoundedOpaqueId(key) || !/^[A-Za-z0-9][A-Za-z0-9_.:-]*$/.test(key)) ||
             !registry.has(options.checkoutProvider))) {
         throw new BillingCompositionError("cloud_billing_configuration_incomplete");
     }
@@ -93,9 +90,7 @@ export function createBilling(options) {
             providerProductId: item.price.providerProductId,
         }));
         return toPublicCatalog(active.revision.revision, offers, checkoutIsAvailable({
-            requestedRevision: providerName === options.checkoutProvider
-                ? options.requestedRevision
-                : null,
+            requestedRevision: providerName === options.checkoutProvider ? options.requestedRevision : null,
             activeRevision: active.revision.revision,
         }));
     }
@@ -412,8 +407,7 @@ export function createBilling(options) {
         }
         const live = await store.findLiveJob(subject);
         if (live) {
-            if (subject.operation === "cancellation" &&
-                live.operation !== "cancellation") {
+            if (subject.operation === "cancellation" && live.operation !== "cancellation") {
                 live.operation = "cancellation";
                 await store.saveJob(live);
             }
@@ -479,14 +473,39 @@ export function createBilling(options) {
         if (existingSub && retainsPaidEntitlement(existingSub, clock.now())) {
             throw new BillingWorkflowError("active_subscription_exists");
         }
+        const adapter = provider(options.checkoutProvider);
+        const checkoutIdempotencyKey = `checkout:${input.entity.id}:${input.offerKey}:${catalog.revision.revision}`;
+        const resumable = await store.findResumableCheckout(input.entity.id);
+        if (resumable?.providerCheckoutSessionId && resumable.payerId === input.payer.id) {
+            try {
+                const session = await callProvider(() => adapter.retrieveCheckoutSession(resumable.providerCheckoutSessionId));
+                if (session.subscriptionId) {
+                    const snapshot = await callProvider(() => adapter.retrieveSubscription(session.subscriptionId));
+                    if (retainsPaidEntitlement(snapshot, clock.now())) {
+                        await projectSnapshot(snapshot, {
+                            checkoutAttemptId: resumable.attemptId,
+                        });
+                        const latest = (await store.findCheckoutById(resumable.id)) ?? resumable;
+                        return {
+                            attempt: latest,
+                            checkoutUrl: latest.returnUrl,
+                        };
+                    }
+                }
+            }
+            catch (error) {
+                if (error instanceof BillingWorkflowError)
+                    throw error;
+            }
+        }
         const liveCheckout = await store.findLiveCheckout(input.entity.id);
         let resumeAttempt;
-        if (liveCheckout &&
-            liveCheckout.expiresAt.getTime() <= clock.now().getTime()) {
+        if (liveCheckout && liveCheckout.expiresAt.getTime() <= clock.now().getTime()) {
             liveCheckout.status = "expired";
             liveCheckout.completedAt = clock.now();
             liveCheckout.checkoutUrlEncrypted = null;
             await store.saveCheckout(liveCheckout);
+            resumeAttempt = liveCheckout;
         }
         else if (liveCheckout) {
             if (liveCheckout.payerId !== input.payer.id ||
@@ -505,11 +524,37 @@ export function createBilling(options) {
             }
             resumeAttempt = liveCheckout;
         }
-        const adapter = provider(options.checkoutProvider);
-        if (adapter.capabilities.mutationRecovery.createCustomer ===
-            "unsupported" ||
-            adapter.capabilities.mutationRecovery.createCheckout ===
-                "unsupported") {
+        if (!resumeAttempt) {
+            const existing = await store.findCheckoutByIdempotencyKey(checkoutIdempotencyKey);
+            if (existing &&
+                existing.payerId === input.payer.id &&
+                existing.offerKey === input.offerKey &&
+                existing.catalogRevision === catalog.revision.revision) {
+                if (existing.status === "open" &&
+                    existing.checkoutUrlEncrypted &&
+                    existing.expiresAt.getTime() > clock.now().getTime() &&
+                    options.sensitiveValues) {
+                    const checkoutUrl = await options.sensitiveValues.decrypt(existing.checkoutUrlEncrypted, {
+                        operatorActorId: input.payer.id,
+                        reason: "resume_checkout",
+                    });
+                    return { attempt: existing, checkoutUrl };
+                }
+                if (existing.status === "completed" &&
+                    existing.checkoutUrlEncrypted &&
+                    existing.expiresAt.getTime() > clock.now().getTime() &&
+                    options.sensitiveValues) {
+                    const checkoutUrl = await options.sensitiveValues.decrypt(existing.checkoutUrlEncrypted, {
+                        operatorActorId: input.payer.id,
+                        reason: "resume_checkout",
+                    });
+                    return { attempt: existing, checkoutUrl };
+                }
+                resumeAttempt = existing;
+            }
+        }
+        if (adapter.capabilities.mutationRecovery.createCustomer === "unsupported" ||
+            adapter.capabilities.mutationRecovery.createCheckout === "unsupported") {
             throw new BillingWorkflowError("unsupported_operation");
         }
         let providerProduct;
@@ -517,8 +562,7 @@ export function createBilling(options) {
             providerProduct = await callProvider(() => adapter.retrieveProduct(item.price.providerProductId));
         }
         catch (error) {
-            if (error instanceof BillingProviderError &&
-                error.code === "invalid") {
+            if (error instanceof BillingProviderError && error.code === "invalid") {
                 throw new BillingWorkflowError("catalog_changed", {
                     details: { publicCatalog: pub },
                 });
@@ -532,8 +576,7 @@ export function createBilling(options) {
                 details: { publicCatalog: pub },
             });
         }
-        if (liveCheckout?.status === "open" &&
-            !liveCheckout.checkoutUrlEncrypted) {
+        if (liveCheckout?.status === "open" && !liveCheckout.checkoutUrlEncrypted) {
             let customer;
             try {
                 customer = await resolveCustomer({
@@ -563,8 +606,7 @@ export function createBilling(options) {
                 if (options.sensitiveValues) {
                     const encrypted = await options.sensitiveValues.encrypt(remote.checkoutUrl);
                     liveCheckout.checkoutUrlEncrypted = encrypted.ciphertext;
-                    liveCheckout.providerCheckoutSessionId =
-                        remote.providerCheckoutSessionId;
+                    liveCheckout.providerCheckoutSessionId = remote.providerCheckoutSessionId;
                     liveCheckout.providerCustomerRowId = customer.id;
                     await store.saveCheckout(liveCheckout);
                 }
@@ -610,7 +652,7 @@ export function createBilling(options) {
                         providerCustomerRowId: null,
                         providerCheckoutSessionId: null,
                         checkoutUrlEncrypted: null,
-                        idempotencyKey: `checkout:${input.entity.id}:${input.offerKey}:${catalog.revision.revision}`,
+                        idempotencyKey: checkoutIdempotencyKey,
                         status: "creating",
                         expiresAt: new Date(clock.now().getTime() + 60 * 60 * 1000),
                         lastError: null,
@@ -623,7 +665,8 @@ export function createBilling(options) {
                 });
             }
             catch (error) {
-                const raced = await store.findLiveCheckout(input.entity.id);
+                const raced = (await store.findLiveCheckout(input.entity.id)) ??
+                    (await store.findCheckoutByIdempotencyKey(checkoutIdempotencyKey));
                 if (!raced ||
                     raced.payerId !== input.payer.id ||
                     raced.offerKey !== input.offerKey ||
@@ -633,6 +676,18 @@ export function createBilling(options) {
                 attempt = raced;
             }
         }
+        const reopenExpiredOrUnpaidCompleted = attempt.status === "expired" || attempt.status === "completed";
+        if (reopenExpiredOrUnpaidCompleted) {
+            attempt.status = "creating";
+            attempt.completedAt = null;
+            attempt.checkoutUrlEncrypted = null;
+            attempt.lastError = null;
+            attempt.expiresAt = new Date(clock.now().getTime() + 60 * 60 * 1000);
+            await store.saveCheckout(attempt);
+        }
+        const providerCheckoutKey = reopenExpiredOrUnpaidCompleted
+            ? `${attempt.idempotencyKey}:reopen:${attempt.id}`
+            : attempt.idempotencyKey;
         let customer;
         try {
             customer = await resolveCustomer({
@@ -657,7 +712,7 @@ export function createBilling(options) {
                 attemptId: attempt.attemptId,
                 catalogKey: item.offerKey,
                 trialDays: input.trialDays ?? 0,
-                idempotencyKey: attempt.idempotencyKey,
+                idempotencyKey: providerCheckoutKey,
             }));
             const encrypted = options.sensitiveValues
                 ? await options.sensitiveValues.encrypt(remote.checkoutUrl)
@@ -676,8 +731,7 @@ export function createBilling(options) {
                 }
                 latest.status = "open";
                 latest.providerCustomerRowId = customer.id;
-                latest.providerCheckoutSessionId =
-                    remote.providerCheckoutSessionId;
+                latest.providerCheckoutSessionId = remote.providerCheckoutSessionId;
                 latest.checkoutUrlEncrypted = encrypted?.ciphertext ?? null;
                 await store.saveCheckout(latest);
                 await requireAudit({
@@ -799,8 +853,7 @@ export function createBilling(options) {
             providerProduct = await callProvider(() => adapter.retrieveProduct(target.price.providerProductId));
         }
         catch (error) {
-            if (error instanceof BillingProviderError &&
-                error.code === "invalid") {
+            if (error instanceof BillingProviderError && error.code === "invalid") {
                 throw new BillingWorkflowError("catalog_changed", {
                     details: {
                         publicCatalog: await publicCatalogFor(sub.provider),
@@ -823,8 +876,7 @@ export function createBilling(options) {
             if (livePlanChange.subscriptionId === sub.id &&
                 livePlanChange.payerId === input.payer.id &&
                 livePlanChange.targetOfferKey === input.offerKey &&
-                livePlanChange.targetCatalogRevision ===
-                    catalog.revision.revision &&
+                livePlanChange.targetCatalogRevision === catalog.revision.revision &&
                 livePlanChange.effectiveAt === input.effectiveAt &&
                 livePlanChange.prorationMode === input.prorationMode) {
                 return livePlanChange;
@@ -923,8 +975,7 @@ export function createBilling(options) {
         }, input.payer.id);
         const source = await store.findEntitlementSubscription(input.entity.id);
         const sub = source ??
-            (await store.listSubscriptionsByEntity(input.entity.id)).find((row) => row.payerId === input.payer.id &&
-                row.status === "cancelled");
+            (await store.listSubscriptionsByEntity(input.entity.id)).find((row) => row.payerId === input.payer.id && row.status === "cancelled");
         if (!sub)
             throw new BillingWorkflowError("subscription_required");
         if (sub.payerId !== input.payer.id) {
@@ -933,8 +984,8 @@ export function createBilling(options) {
         if (sub.status === "cancelled") {
             return { accepted: true, subscriptionId: sub.id };
         }
-        if (provider(sub.provider).capabilities.mutationRecovery
-            .cancellation === "unsupported") {
+        if (provider(sub.provider).capabilities.mutationRecovery.cancellation ===
+            "unsupported") {
             throw new BillingWorkflowError("unsupported_operation");
         }
         await store.withTransaction(async () => {
@@ -1145,10 +1196,7 @@ export function createBilling(options) {
             providerProductId: snapshot.providerProductId,
             catalogRevision: lineageRevision,
             offerKey: lineageOffer,
-            plan: pendingChange?.targetPlan ??
-                existing?.plan ??
-                attempt?.plan ??
-                price.plan,
+            plan: pendingChange?.targetPlan ?? existing?.plan ?? attempt?.plan ?? price.plan,
             interval: pendingChange?.targetInterval ??
                 existing?.interval ??
                 attempt?.interval ??
@@ -1165,9 +1213,7 @@ export function createBilling(options) {
             providerOccurredAt: snapshot.providerOccurredAt,
             providerVersion: snapshot.providerVersion,
             lastObservedAt: now,
-            lastReconciledAt: reconcile
-                ? now
-                : (existing?.lastReconciledAt ?? null),
+            lastReconciledAt: reconcile ? now : (existing?.lastReconciledAt ?? null),
         };
         const write = await applySubscriptionProjection(store, next, now, {
             reconcile,
@@ -1207,7 +1253,7 @@ export function createBilling(options) {
                     entityUnchanged: attempt.billableEntityId === billableEntityId,
                     payerUnchanged: attempt.payerId === payerId,
                 });
-                if (decision.allowed) {
+                if (decision.allowed && paid) {
                     attempt.status = "completed";
                     attempt.completedAt = now;
                 }
@@ -1234,8 +1280,7 @@ export function createBilling(options) {
         const now = clock.now();
         const alreadyClaimed = record.status === "processing" && record.workerId === workerId;
         if (!alreadyClaimed) {
-            if (!decideWebhookInboxTransition(record.status, "processing")
-                .allowed) {
+            if (!decideWebhookInboxTransition(record.status, "processing").allowed) {
                 return;
             }
             record.status = "processing";
@@ -1256,9 +1301,7 @@ export function createBilling(options) {
             const adapter = provider(record.provider);
             const snapshot = await callProvider(() => adapter.retrieveSubscription(record.subscriptionId));
             await projectSnapshot(snapshot, {
-                checkoutAttemptId: record.checkoutAttemptId ??
-                    snapshot.metadata.checkoutAttemptId ??
-                    undefined,
+                checkoutAttemptId: record.checkoutAttemptId ?? snapshot.metadata.checkoutAttemptId ?? undefined,
             });
             record.status = "processed";
             record.processedAt = clock.now();
@@ -1503,10 +1546,8 @@ export function createBilling(options) {
             if (attempt.provider !== job.provider) {
                 throw new BillingWorkflowError("operation_quarantined");
             }
-            if (adapter.capabilities.mutationRecovery.createCustomer ===
-                "unsupported" ||
-                adapter.capabilities.mutationRecovery.createCheckout ===
-                    "unsupported") {
+            if (adapter.capabilities.mutationRecovery.createCustomer === "unsupported" ||
+                adapter.capabilities.mutationRecovery.createCheckout === "unsupported") {
                 throw new BillingWorkflowError("operation_quarantined");
             }
             if (attempt.providerCheckoutSessionId) {
@@ -1541,8 +1582,7 @@ export function createBilling(options) {
                     idempotencyKey: customer.idempotencyKey,
                 }));
                 await store.withTransaction(async () => {
-                    const latest = (await store.findCustomerById(customer.id)) ??
-                        customer;
+                    const latest = (await store.findCustomerById(customer.id)) ?? customer;
                     const decision = decideCustomerTransition(latest.status, "active");
                     if (!decision.allowed) {
                         throw new BillingWorkflowError("operation_quarantined");
@@ -1593,8 +1633,7 @@ export function createBilling(options) {
                     return;
                 }
                 const wasCreating = latest.status === "creating";
-                latest.providerCheckoutSessionId =
-                    remote.providerCheckoutSessionId;
+                latest.providerCheckoutSessionId = remote.providerCheckoutSessionId;
                 if (wasCreating)
                     latest.status = "open";
                 await store.saveCheckout(latest);
@@ -1623,8 +1662,7 @@ export function createBilling(options) {
                 throw new BillingWorkflowError("operation_quarantined");
             }
             if (job.operation === "cancellation") {
-                if (adapter.capabilities.mutationRecovery.cancellation ===
-                    "unsupported") {
+                if (adapter.capabilities.mutationRecovery.cancellation === "unsupported") {
                     throw new BillingWorkflowError("operation_quarantined");
                 }
                 await callProvider(() => adapter.cancelSubscription(sub.providerSubscriptionId, `cancel:${sub.id}`));
@@ -1647,8 +1685,7 @@ export function createBilling(options) {
                 (customer.status === "active" && !customer.providerCustomerId)) {
                 throw new BillingWorkflowError("operation_quarantined");
             }
-            if (adapter.capabilities.mutationRecovery.createCustomer ===
-                "unsupported") {
+            if (adapter.capabilities.mutationRecovery.createCustomer === "unsupported") {
                 throw new BillingWorkflowError("operation_quarantined");
             }
             const remote = await callProvider(() => adapter.createCustomer({
@@ -1701,8 +1738,7 @@ export function createBilling(options) {
             if (target.provider !== attempt.provider) {
                 throw new BillingWorkflowError("operation_quarantined");
             }
-            if (adapter.capabilities.mutationRecovery.planChange ===
-                "unsupported") {
+            if (adapter.capabilities.mutationRecovery.planChange === "unsupported") {
                 throw new BillingWorkflowError("operation_quarantined");
             }
             const remote = await callProvider(() => adapter.changeSubscriptionPlan({
@@ -1827,8 +1863,8 @@ export function createBilling(options) {
             throw new BillingWorkflowError("subscription_required");
         if (sub.status === "cancelled" || sub.status === "expired")
             return;
-        if (provider(sub.provider).capabilities.mutationRecovery
-            .cancellation === "unsupported") {
+        if (provider(sub.provider).capabilities.mutationRecovery.cancellation ===
+            "unsupported") {
             throw new BillingWorkflowError("unsupported_operation");
         }
         await store.withTransaction(async () => {
@@ -2001,8 +2037,7 @@ function workLimit(value) {
     return Math.min(value, 1_000);
 }
 function isOptionalDate(value) {
-    return (value === null ||
-        (value instanceof Date && !Number.isNaN(value.getTime())));
+    return value === null || (value instanceof Date && !Number.isNaN(value.getTime()));
 }
 function isCanonicalSubscriptionStatus(value) {
     return (value === "pending" ||
@@ -2016,8 +2051,7 @@ function isOlderProviderSnapshot(existing, incoming) {
     if (existing.providerVersion && incoming.providerVersion) {
         const existingNumber = Number(existing.providerVersion);
         const incomingNumber = Number(incoming.providerVersion);
-        if (Number.isSafeInteger(existingNumber) &&
-            Number.isSafeInteger(incomingNumber)) {
+        if (Number.isSafeInteger(existingNumber) && Number.isSafeInteger(incomingNumber)) {
             if (incomingNumber < existingNumber)
                 return true;
             if (incomingNumber > existingNumber)
@@ -2025,8 +2059,7 @@ function isOlderProviderSnapshot(existing, incoming) {
         }
     }
     if (existing.providerOccurredAt && incoming.providerOccurredAt) {
-        return (incoming.providerOccurredAt.getTime() <
-            existing.providerOccurredAt.getTime());
+        return (incoming.providerOccurredAt.getTime() < existing.providerOccurredAt.getTime());
     }
     return false;
 }