@owlmeans/server-payment 0.1.18-rc.2 → 0.1.18-rc.21

package/build/resource.js

@@ -1,6 +1,6 @@
 import { makeMongoResource } from '@owlmeans/mongo-resource';
-import { RES_PAYGATE_CUSTOMER, RES_PAYMENT_FINGERPRINT, RES_PAYMENT_SUBSCRIPTION } from './consts.js';
-import { FingerprintSchema, PaygateCustomerSchema, PaymentSubscriptionSchema } from './model.js';
+import { RES_BILLING_PROFILE, RES_CONSUMER_CONSENT, RES_CONSUMER_DECLARATION, RES_CONSUMER_EVENT, RES_PAYGATE_CUSTOMER, RES_PAYMENT_FINGERPRINT, RES_PAYMENT_FULFILLMENT, RES_PAYMENT_PURCHASE, RES_PAYMENT_SUBSCRIPTION, RES_PAYMENT_USAGE, RES_PAYMENT_USAGE_COUNTER, RES_PAYMENT_WEBHOOK, } from './consts.js';
+import { BillingProfileSchema, ConsumerConsentSchema, ConsumerDeclarationSchema, ConsumerEventSchema, FingerprintSchema, PaygateCustomerSchema, PaymentFulfillmentSchema, PaymentSubscriptionSchema, PaymentUsageCounterSchema, PaymentUsageSchema, PaymentWebhookSchema, PurchaseSchema, } from './model.js';
 export const makePaygateCustomerResource = (dbAlias, serviceAlias) => {
     const resource = makeMongoResource(RES_PAYGATE_CUSTOMER, dbAlias, serviceAlias);
     resource.loadByPgId = async (externalId, paygate) => await resource.load({ externalId, paygate });
@@ -14,11 +14,45 @@ export const makePaygateCustomerResource = (dbAlias, serviceAlias) => {
 export const makeSubscriptionResource = (dbAlias, serviceAlias) => {
     const resource = makeMongoResource(RES_PAYMENT_SUBSCRIPTION, dbAlias, serviceAlias);
     resource.byExternalId = async (externalId, paygate) => await resource.load({ externalId, paygate });
+    resource.byItemId = async (itemId, paygate) => await resource.load({ itemId, paygate });
     resource.schema = PaymentSubscriptionSchema;
-    resource.index('entity', { entityId: 1 });
-    resource.index('entitySku', { entityId: 1, sku: 1 });
-    resource.index('external', { externalId: 1, paygate: 1 }, { unique: true });
-    resource.index('status', { status: 1 });
+    resource.index('external', { paygate: 1, externalId: 1 }, { unique: true });
+    resource.index('entityStatusRank', { entityId: 1, status: 1, rank: -1 });
+    resource.index('entityPlan', { entityId: 1, planSku: 1 });
+    resource.index('customer', { paygate: 1, customerId: 1 });
+    resource.index('item', { paygate: 1, itemId: 1 }, { sparse: true });
+    resource.index('statusUpdated', { paygate: 1, status: 1, updatedAt: 1 });
+    return resource;
+};
+export const makeFulfillmentResource = (dbAlias, serviceAlias) => {
+    const resource = makeMongoResource(RES_PAYMENT_FULFILLMENT, dbAlias, serviceAlias);
+    resource.byExternalId = async (externalId, paygate) => await resource.load({ externalId, paygate });
+    resource.schema = PaymentFulfillmentSchema;
+    resource.index('external', { paygate: 1, externalId: 1 }, { unique: true });
+    resource.index('paymentIntent', { paygate: 1, paymentIntentId: 1 }, { sparse: true });
+    resource.index('charge', { paygate: 1, chargeId: 1 }, { sparse: true });
+    resource.index('entityCreated', { entityId: 1, createdAt: -1 });
+    return resource;
+};
+export const makeWebhookResource = (dbAlias, serviceAlias) => {
+    const resource = makeMongoResource(RES_PAYMENT_WEBHOOK, dbAlias, serviceAlias);
+    resource.schema = PaymentWebhookSchema;
+    resource.index('endpoint', { paygate: 1, service: 1, url: 1 }, { unique: true });
+    return resource;
+};
+export const makeUsageResource = (dbAlias, serviceAlias) => {
+    const resource = makeMongoResource(RES_PAYMENT_USAGE, dbAlias, serviceAlias);
+    resource.schema = PaymentUsageSchema;
+    resource.index('event', { entityId: 1, limitKey: 1, eventKey: 1 }, { unique: true });
+    resource.index('window', { entityId: 1, limitKey: 1, window: 1 });
+    resource.index('ref', { entityId: 1, limitKey: 1, ref: 1 }, { sparse: true });
+    resource.index('entityCreated', { entityId: 1, createdAt: -1 });
+    return resource;
+};
+export const makeUsageCounterResource = (dbAlias, serviceAlias) => {
+    const resource = makeMongoResource(RES_PAYMENT_USAGE_COUNTER, dbAlias, serviceAlias);
+    resource.schema = PaymentUsageCounterSchema;
+    resource.index('window', { entityId: 1, limitKey: 1, window: 1 }, { unique: true });
     return resource;
 };
 export const makeFingerprintResource = (dbAlias, serviceAlias) => {
@@ -29,4 +63,61 @@ export const makeFingerprintResource = (dbAlias, serviceAlias) => {
     resource.index('sku', { sku: 1 }, { unique: true });
     return resource;
 };
+export const makeBillingProfileResource = (dbAlias, serviceAlias) => {
+    const resource = makeMongoResource(RES_BILLING_PROFILE, dbAlias, serviceAlias);
+    resource.byEntity = async (entityId) => await resource.load({ entityId });
+    resource.schema = BillingProfileSchema;
+    // One profile per organization: the unique index is what makes the first lock the only one.
+    resource.index('entity', { entityId: 1 }, { unique: true });
+    resource.index('customer', { paygate: 1, customerId: 1 }, { sparse: true });
+    return resource;
+};
+export const makePurchaseResource = (dbAlias, serviceAlias) => {
+    const resource = makeMongoResource(RES_PAYMENT_PURCHASE, dbAlias, serviceAlias);
+    resource.byPurchaseId = async (purchaseId) => await resource.load({ purchaseId });
+    resource.schema = PurchaseSchema;
+    resource.index('purchase', { purchaseId: 1 }, { unique: true });
+    resource.index('contract', { contractRef: 1 }, { unique: true });
+    resource.index('entityDeadline', { entityId: 1, deadline: -1 });
+    resource.index('entityPurchased', { entityId: 1, purchasedAt: -1 });
+    // Single-field on purpose: a compound sparse index still indexes rows missing only `sessionId`
+    // (subscription purchases before their checkout is captured), and unique would collide on them.
+    resource.index('session', { sessionId: 1 }, { unique: true, sparse: true });
+    resource.index('subscription', { paygate: 1, subscriptionId: 1 }, { sparse: true });
+    resource.index('invoice', { invoiceId: 1 }, { sparse: true });
+    resource.index('invoiceNumber', { invoiceNumber: 1 }, { sparse: true });
+    resource.index('paymentIntent', { paygate: 1, paymentIntentId: 1 }, { sparse: true });
+    return resource;
+};
+export const makeConsumerConsentResource = (dbAlias, serviceAlias) => {
+    const resource = makeMongoResource(RES_CONSUMER_CONSENT, dbAlias, serviceAlias);
+    resource.schema = ConsumerConsentSchema;
+    resource.index('entityDecided', { entityId: 1, decidedAt: -1 });
+    resource.index('kindPlan', { kind: 1, entityId: 1, planSku: 1, decidedAt: -1 });
+    return resource;
+};
+export const makeConsumerDeclarationResource = (dbAlias, serviceAlias) => {
+    const resource = makeMongoResource(RES_CONSUMER_DECLARATION, dbAlias, serviceAlias);
+    resource.schema = ConsumerDeclarationSchema;
+    resource.index('kindReceived', { kind: 1, receivedAt: -1 });
+    resource.index('entityReceived', { entityId: 1, receivedAt: -1 }, { sparse: true });
+    resource.index('purchase', { purchaseId: 1 }, { sparse: true });
+    return resource;
+};
+export const makeConsumerEventResource = (dbAlias, serviceAlias) => {
+    const resource = makeMongoResource(RES_CONSUMER_EVENT, dbAlias, serviceAlias);
+    resource.schema = ConsumerEventSchema;
+    resource.index('record', { recordId: 1, at: 1 });
+    resource.index('entityAt', { entityId: 1, at: -1 }, { sparse: true });
+    resource.index('actionOk', { action: 1, ok: 1, at: 1 });
+    return resource;
+};
+/** The consumer-rights resources, alias → maker — registered by the gateway, each only when absent. */
+export const CONSUMER_RIGHTS_RESOURCE_MAKERS = [
+    [RES_BILLING_PROFILE, makeBillingProfileResource],
+    [RES_PAYMENT_PURCHASE, makePurchaseResource],
+    [RES_CONSUMER_CONSENT, makeConsumerConsentResource],
+    [RES_CONSUMER_DECLARATION, makeConsumerDeclarationResource],
+    [RES_CONSUMER_EVENT, makeConsumerEventResource],
+];
 //# sourceMappingURL=resource.js.map

package/build/resource.js.map

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

package/build/service.d.ts

@@ -1,4 +1,29 @@
-import type { Config, Context, GatewayService, PaymentResourceOptions } from './types.js';
-export declare const makeGatewayService: (alias?: string) => GatewayService;
-export declare const appendPaymentGatewayService: <C extends Config, T extends Context<C>>(ctx: T, opts?: PaymentResourceOptions) => T;
+import type Stripe from 'stripe';
+import type { Context as ApiContext } from '@owlmeans/server-api';
+import type { Config, Context, GatewayService, GrantInternalPlanOptions, PaymentGatewayOptions, PaymentSubscriptionRecord } from './types.js';
+export interface StripeBootstrapOptions {
+    /** Re-verify what the stored fingerprints say is in place. */
+    force?: boolean;
+}
+/**
+ * Bring Stripe to what this deployment declares, each step on its own so one failing does not block
+ * the others: products and prices, the customer-portal configuration, the webhook endpoint.
+ */
+export declare const bootstrapStripe: (ctx: ApiContext, stripe: Stripe, opts?: StripeBootstrapOptions) => Promise<void>;
+/**
+ * Grant a plan without a paygate — the free plan every entity holds, or a complimentary one
+ * (`force`). One row per grant (`free:<entityId>` / `internal:<planSku>:<entityId>`), upserted: its
+ * `createdAt` survives a re-grant, and observers hear `created` once.
+ */
+export declare const grantInternalPlan: (ctx: ApiContext, entityId: string, planSku: string, opts?: GrantInternalPlanOptions) => Promise<PaymentSubscriptionRecord>;
+export declare const makeGatewayService: (alias?: string, opts?: Pick<PaymentGatewayOptions, 'manage'>) => GatewayService;
+/**
+ * Register the payment resources, the catalogue service, the completion observer, the gateway, both
+ * gate services, the entitlement service and the consumer-rights records and service — each only
+ * when not registered yet.
+ *
+ * `manage: false` registers the same surface for a process that reads entitlements but never talks
+ * to Stripe.
+ */
+export declare const appendPaymentGatewayService: <C extends Config, T extends Context<C>>(ctx: T, opts?: PaymentGatewayOptions) => T;
 //# sourceMappingURL=service.d.ts.map

package/build/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAEzF,eAAO,MAAM,kBAAkB,WAAW,MAAM,KAAqB,cAUpE,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,OAC3E,CAAC,SAAS,sBAAsB,KACpC,CASF,CAAA"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAMhC,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAyBjE,OAAO,KAAK,EACV,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,qBAAqB,EAChF,yBAAyB,EAC1B,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,QACrB,UAAU,UAAU,MAAM,SAAQ,sBAAsB,KAC5D,OAAO,CAAC,IAAI,CAad,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QACvB,UAAU,YAAY,MAAM,WAAW,MAAM,SAAQ,wBAAwB,KACjF,OAAO,CAAC,yBAAyB,CA+BnC,CAAA;AAID,eAAO,MAAM,kBAAkB,WACtB,MAAM,SAA0B,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,KAC3E,cA6CF,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,OAC3E,CAAC,SAAS,qBAAqB,KACnC,CA2BF,CAAA"}

package/build/service.js

@@ -1,35 +1,162 @@
 import { createService } from '@owlmeans/context';
-import { DEFAULT_ALIAS as PAYMENT_SERVICE, ENTITLEMENT_GATE, appendPaymentService } from '@owlmeans/payment';
-import { GATEWAY_SERVICE, RES_PAYGATE_CUSTOMER, RES_PAYMENT_FINGERPRINT, RES_PAYMENT_SUBSCRIPTION } from './consts.js';
-import { makeEntitlementGate } from './gate.js';
+import { appendPaymentService, DEFAULT_ALIAS as PAYMENT_SERVICE, ENTITLEMENT_GATE, INTERNAL_PAYGATE, LIMIT_GATE, PaygateError, ProductError, SubscriptionStatus, UnknownPlan, } from '@owlmeans/payment';
+import { assertPlanDeclarations } from './config.js';
+import { ENTITLEMENT_SERVICE, GATEWAY_SERVICE, RES_PAYGATE_CUSTOMER, RES_PAYMENT_FINGERPRINT, RES_PAYMENT_FULFILLMENT, RES_PAYMENT_SUBSCRIPTION, RES_PAYMENT_USAGE, RES_PAYMENT_USAGE_COUNTER, RES_PAYMENT_WEBHOOK, } from './consts.js';
+import { registerConsumerRights } from './consumer/service.js';
+import { makeEntitlementService } from './entitlement.js';
+import { makeCapabilityGate } from './gate.js';
+import { makeLimitGate } from './limit.js';
 import { appendCompletionObserver } from './observer.js';
-import { stripePlugin } from './plugins/stripe.js';
-import { makeFingerprintResource, makePaygateCustomerResource, makeSubscriptionResource } from './resource.js';
-import { initialize } from './sync.js';
-export const makeGatewayService = (alias = GATEWAY_SERVICE) => {
+import { findPlan, findProduct, planRank } from './plan.js';
+import { resyncStripeSubscription, resyncStripeSubscriptions } from './plugins/events.js';
+import { makeEstimateCache, estimateStripePrice } from './plugins/estimate.js';
+import { createPortalLink, ensurePortalConfiguration } from './plugins/portal.js';
+import { makeCheckoutPluginRegistry, narrowAmountFor } from './plugins/checkout-plugins.js';
+import { consumablePlanOf, createCheckoutLink } from './plugins/stripe.js';
+import { ensureWebhookEndpoint } from './plugins/webhook-manager.js';
+import { makeFingerprintResource, makeFulfillmentResource, makePaygateCustomerResource, makeSubscriptionResource, makeUsageCounterResource, makeUsageResource, makeWebhookResource, } from './resource.js';
+import { commitSubscription } from './subscription.js';
+import { syncedPlanPrices, syncStripeProducts } from './sync.js';
+import { consumerRightsOf, stripeClient, subscriptions } from './utils.js';
+/**
+ * Bring Stripe to what this deployment declares, each step on its own so one failing does not block
+ * the others: products and prices, the customer-portal configuration, the webhook endpoint.
+ */
+export const bootstrapStripe = async (ctx, stripe, opts = {}) => {
+    const steps = [
+        ['products', async () => await syncStripeProducts(ctx, stripe)],
+        ['portal', async () => await ensurePortalConfiguration(ctx, stripe, opts)],
+        ['webhook', async () => await ensureWebhookEndpoint(ctx, stripe, opts)],
+    ];
+    for (const [name, step] of steps) {
+        try {
+            await step();
+        }
+        catch (error) {
+            console.error(`[payment] Stripe ${name} bootstrap failed`, error);
+        }
+    }
+};
+/**
+ * Grant a plan without a paygate — the free plan every entity holds, or a complimentary one
+ * (`force`). One row per grant (`free:<entityId>` / `internal:<planSku>:<entityId>`), upserted: its
+ * `createdAt` survives a re-grant, and observers hear `created` once.
+ */
+export const grantInternalPlan = async (ctx, entityId, planSku, opts = {}) => {
+    const plan = await findPlan(ctx, planSku);
+    if (plan == null) {
+        throw new UnknownPlan(planSku);
+    }
+    if (plan.free !== true && opts.force !== true) {
+        throw new ProductError(`internal-grant:${planSku}`);
+    }
+    const product = await findProduct(ctx, plan.productSku);
+    const externalId = plan.free === true ? `free:${entityId}` : `internal:${planSku}:${entityId}`;
+    const previous = await subscriptions(ctx).byExternalId(externalId, INTERNAL_PAYGATE);
+    const now = new Date();
+    const { periodEnd: _periodEnd, endedAt: _endedAt, canceledAt: _canceledAt, ...kept } = previous ?? {};
+    const next = {
+        ...kept,
+        entityId,
+        planSku,
+        productSku: plan.productSku,
+        service: previous?.service ?? product?.services?.[0] ?? ctx.cfg.service,
+        paygate: INTERNAL_PAYGATE,
+        externalId,
+        status: SubscriptionStatus.Active,
+        rank: planRank(plan),
+        ...(opts.periodEnd != null ? { periodEnd: opts.periodEnd } : {}),
+        createdAt: previous?.createdAt ?? now,
+        updatedAt: now,
+    };
+    const { record } = await commitSubscription(ctx, previous, next);
+    return record ?? next;
+};
+const unmanaged = () => { throw new PaygateError('unmanaged'); };
+export const makeGatewayService = (alias = GATEWAY_SERVICE, opts = {}) => {
+    const managed = opts.manage !== false;
+    // One estimate cache per gateway SERVICE instance, never module-level: several service
+    // instances (several tests, several deployments in one process) must never share hits.
+    const estimateCache = makeEstimateCache();
+    // Checkout plugins are seated per gateway instance, like the estimate cache.
+    const plugins = makeCheckoutPluginRegistry();
     const service = createService(alias, {
-        createLink: async (ctx, params) => stripePlugin.createLink(ctx, params),
-        manageSubscription: async (ctx, entityId, returnUrl) => stripePlugin.manageSubscription(ctx, entityId, returnUrl),
+        managed,
+        createLink: async (ctx, params) => managed
+            ? await createCheckoutLink(ctx, await stripeClient(ctx), params, plugins.list()) : unmanaged(),
+        use: plugin => { plugins.use(plugin); },
+        checkoutPlugins: () => plugins.list(),
+        amountPolicy: async (ctx, entityId, productSku, planSku) => {
+            const { plan } = await consumablePlanOf(ctx, productSku, planSku);
+            if (plan.amountPolicy == null)
+                throw new ProductError(`amount-policy:${plan.sku}`);
+            return await narrowAmountFor(ctx, plugins.list(), {
+                entityId, productSku, planSku: plan.sku, base: plan.amountPolicy, at: new Date(),
+            });
+        },
+        planPrices: async (ctx, productSku) => await syncedPlanPrices(ctx, productSku),
+        portalLink: async (ctx, entityId, link) => managed
+            ? await createPortalLink(ctx, await stripeClient(ctx), entityId, link) : unmanaged(),
+        grantInternalPlan: async (ctx, entityId, planSku, grant) => await grantInternalPlan(ctx, entityId, planSku, grant),
+        resyncSubscription: async (ctx, ref) => managed
+            ? await resyncStripeSubscription(ctx, await stripeClient(ctx), ref) : unmanaged(),
+        resyncAll: async (ctx) => managed
+            ? await resyncStripeSubscriptions(ctx, await stripeClient(ctx)) : unmanaged(),
+        estimatePrice: async (ctx, params) => managed
+            ? await estimateStripePrice(ctx, await stripeClient(ctx), params, estimateCache) : unmanaged(),
     }, service => async () => {
-        service.initialized = true;
         const ctx = service.assertCtx();
-        ctx.waitForInitialized().then(() => initialize(ctx).catch(console.error));
+        assertPlanDeclarations(ctx.cfg);
+        service.initialized = true;
+        // The consumer-rights service is lazy (reachable while the application is wired): initialize it
+        // with the gateway, so its boot checks run at boot.
+        consumerRightsOf(ctx);
+        if (managed) {
+            void ctx.waitForInitialized().then(async () => {
+                await bootstrapStripe(ctx, await stripeClient(ctx));
+            }).catch(error => { console.error('[payment] Stripe bootstrap failed', error); });
+        }
     });
     return service;
 };
+/**
+ * Register the payment resources, the catalogue service, the completion observer, the gateway, both
+ * gate services, the entitlement service and the consumer-rights records and service — each only
+ * when not registered yet.
+ *
+ * `manage: false` registers the same surface for a process that reads entitlements but never talks
+ * to Stripe.
+ */
 export const appendPaymentGatewayService = (ctx, opts) => {
-    if (!ctx.hasResource(RES_PAYGATE_CUSTOMER))
-        ctx.registerResource(makePaygateCustomerResource(opts?.dbAlias, opts?.serviceAlias));
-    if (!ctx.hasResource(RES_PAYMENT_SUBSCRIPTION))
-        ctx.registerResource(makeSubscriptionResource(opts?.dbAlias, opts?.serviceAlias));
-    if (!ctx.hasResource(RES_PAYMENT_FINGERPRINT))
-        ctx.registerResource(makeFingerprintResource(opts?.dbAlias, opts?.serviceAlias));
+    const makers = [
+        [RES_PAYGATE_CUSTOMER, makePaygateCustomerResource],
+        [RES_PAYMENT_SUBSCRIPTION, makeSubscriptionResource],
+        [RES_PAYMENT_FULFILLMENT, makeFulfillmentResource],
+        [RES_PAYMENT_WEBHOOK, makeWebhookResource],
+        [RES_PAYMENT_USAGE, makeUsageResource],
+        [RES_PAYMENT_USAGE_COUNTER, makeUsageCounterResource],
+        [RES_PAYMENT_FINGERPRINT, makeFingerprintResource],
+    ];
+    for (const [alias, maker] of makers) {
+        if (!ctx.hasResource(alias)) {
+            ctx.registerResource(maker(opts?.dbAlias, opts?.serviceAlias));
+        }
+    }
     if (!ctx.hasService(PAYMENT_SERVICE))
         appendPaymentService(ctx);
     appendCompletionObserver(ctx);
-    ctx.registerService(makeGatewayService());
+    if (!ctx.hasService(GATEWAY_SERVICE))
+        ctx.registerService(makeGatewayService(GATEWAY_SERVICE, { manage: opts?.manage }));
     if (!ctx.hasService(ENTITLEMENT_GATE))
-        ctx.registerService(makeEntitlementGate());
+        ctx.registerService(makeCapabilityGate());
+    if (!ctx.hasService(LIMIT_GATE))
+        ctx.registerService(makeLimitGate());
+    if (!ctx.hasService(ENTITLEMENT_SERVICE))
+        ctx.registerService(makeEntitlementService());
+    // The consumer-rights records and service, with this gateway's `manage` unless the application
+    // gave its own (before or after this call): the webhook writes purchases and locks, and an
+    // unmanaged process still reads and asserts consent.
+    registerConsumerRights(ctx, { manage: opts?.manage, dbAlias: opts?.dbAlias, serviceAlias: opts?.serviceAlias }, 'gateway');
     return ctx;
 };
 //# sourceMappingURL=service.js.map

package/build/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,aAAa,IAAI,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAE5G,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtH,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAC9G,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAGtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,GAAW,eAAe,EAAkB,EAAE;IACpF,MAAM,OAAO,GAAG,aAAa,CAAiB,KAAK,EAAE;QACnD,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;QACvE,kBAAkB,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC;KAClH,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;QACvB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAA;QAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,EAAgB,CAAA;QAC7C,GAAG,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IACF,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,GAAM,EAAE,IAA6B,EAClC,EAAE;IACL,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,oBAAoB,CAAC;QAAE,GAAG,CAAC,gBAAgB,CAAC,2BAA2B,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAA;IAChI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,wBAAwB,CAAC;QAAE,GAAG,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAA;IACjI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,uBAAuB,CAAC;QAAE,GAAG,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAA;IAC/H,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,oBAAoB,CAAC,GAAY,CAAC,CAAA;IACxE,wBAAwB,CAAC,GAAG,CAAC,CAAA;IAC7B,GAAG,CAAC,eAAe,CAAC,kBAAkB,EAAE,CAAC,CAAA;IACzC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,GAAG,CAAC,eAAe,CAAC,mBAAmB,EAAE,CAAC,CAAA;IACjF,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/build/subscription.d.ts

@@ -0,0 +1,48 @@
+import type { Context as ApiContext } from '@owlmeans/server-api';
+import type { PaymentSubscriptionRecord, PropagatedState, SubscriptionChange, SubscriptionSnapshot } from './types.js';
+export interface CommitOptions {
+    /** The paygate event being applied; a repeat of the last applied one is ignored. */
+    eventId?: string;
+    /** A paid renewal invoice. */
+    renewal?: boolean;
+    invoiceId?: string;
+    /** The paygate announced the trial ends soon. */
+    trialEnding?: boolean;
+    /**
+     * Runs after the new state is written and BEFORE observers hear the change — what must exist
+     * before an observer grants anything (a subscription's purchase row). A throw propagates: the
+     * observers are not told and the paygate retries.
+     */
+    beforePropagate?: (record: PaymentSubscriptionRecord, change: SubscriptionChange) => Promise<void>;
+}
+export interface CommitResult {
+    record: PaymentSubscriptionRecord | null;
+    change: SubscriptionChange | null;
+    /** The stored subscription state changed. */
+    updated: boolean;
+}
+/** The inputs classification compares. */
+export declare const propagatedStateOf: (record: PaymentSubscriptionRecord, renewedInvoiceId?: string) => PropagatedState;
+/**
+ * What one subscription change means — the first rule that matches:
+ * `created` (first entitling state ever propagated), `canceled`, `paused`, `resumed`,
+ * `upgraded`/`downgraded` (plan change by rank; equal rank reads as an upgrade),
+ * `cancel-scheduled`, `cancel-undone`, `renewed` (once per invoice), `past-due`, `suspended`,
+ * `trial-ending`; otherwise nothing an observer is told about.
+ */
+export declare const classifySubscriptionChange: (previous: PropagatedState | null, current: PaymentSubscriptionRecord, opts?: CommitOptions) => SubscriptionChange | null;
+/** The idempotency key a consumer keys the side effect of a change by. */
+export declare const subscriptionEventKey: (record: PaymentSubscriptionRecord, change: SubscriptionChange, opts?: CommitOptions) => string;
+/** A subscription as observers see it; `state` overlays what was last propagated. */
+export declare const snapshotOf: (ctx: ApiContext, record: PaymentSubscriptionRecord, state?: PropagatedState) => Promise<SubscriptionSnapshot>;
+export declare const materiallyDiffers: (previous: PaymentSubscriptionRecord, next: PaymentSubscriptionRecord) => boolean;
+/**
+ * Store a subscription's new state, tell observers what changed, then record what was told.
+ *
+ * The state is written BEFORE observers run, so an observer reading entitlements sees the new plan.
+ * What classification compares against is the state last PROPAGATED (`propagated`), stamped only
+ * after every observer succeeded — so an observer that throws leaves the change to be classified
+ * again, identically, when the paygate retries. `lastEventId` is stamped with it.
+ */
+export declare const commitSubscription: (ctx: ApiContext, previous: PaymentSubscriptionRecord | null, next: PaymentSubscriptionRecord, opts?: CommitOptions) => Promise<CommitResult>;
+//# sourceMappingURL=subscription.d.ts.map

package/build/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../src/subscription.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAGjE,OAAO,KAAK,EACV,yBAAyB,EAAE,eAAe,EAAE,kBAAkB,EAAE,oBAAoB,EACrF,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,EAAE,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACnG;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAAA;IACxC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAA;IACjC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAA;CACjB;AAMD,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,WAAY,yBAAyB,qBAAqB,MAAM,KAAG,eAO/F,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,aAC3B,eAAe,GAAG,IAAI,WAAW,yBAAyB,SAAQ,aAAa,KACxF,kBAAkB,GAAG,IAsCvB,CAAA;AAED,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,WACvB,yBAAyB,UAAU,kBAAkB,SAAQ,aAAa,KACjF,MAeF,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,UAAU,QAChB,UAAU,UAAU,yBAAyB,UAAU,eAAe,KAC1E,OAAO,CAAC,oBAAoB,CAsB9B,CAAA;AAmBD,eAAO,MAAM,iBAAiB,aAAc,yBAAyB,QAAQ,yBAAyB,KAAG,OACvC,CAAA;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QACxB,UAAU,YAAY,yBAAyB,GAAG,IAAI,QAAQ,yBAAyB,SACtF,aAAa,KAClB,OAAO,CAAC,YAAY,CAqDtB,CAAA"}

package/build/subscription.js

@@ -0,0 +1,176 @@
+import { ENTITLING_STATUSES, SubscriptionStatus } from '@owlmeans/payment';
+import { findPlan } from './plan.js';
+import { compact, isDuplicateKey, observer, subscriptions } from './utils.js';
+const ENDED = [SubscriptionStatus.Canceled, SubscriptionStatus.Ended];
+const timeOf = (value) => value == null ? null : new Date(value).getTime();
+/** The inputs classification compares. */
+export const propagatedStateOf = (record, renewedInvoiceId) => compact({
+    planSku: record.planSku,
+    rank: record.rank,
+    status: record.status,
+    cancelAtPeriodEnd: record.cancelAtPeriodEnd === true,
+    pausedAt: record.pausedAt ?? undefined,
+    renewedInvoiceId: renewedInvoiceId ?? undefined,
+});
+/**
+ * What one subscription change means — the first rule that matches:
+ * `created` (first entitling state ever propagated), `canceled`, `paused`, `resumed`,
+ * `upgraded`/`downgraded` (plan change by rank; equal rank reads as an upgrade),
+ * `cancel-scheduled`, `cancel-undone`, `renewed` (once per invoice), `past-due`, `suspended`,
+ * `trial-ending`; otherwise nothing an observer is told about.
+ */
+export const classifySubscriptionChange = (previous, current, opts = {}) => {
+    const active = ENTITLING_STATUSES.includes(current.status);
+    if (previous == null) {
+        return active ? 'created' : null;
+    }
+    if (ENDED.includes(current.status) && !ENDED.includes(previous.status)) {
+        return 'canceled';
+    }
+    if (current.pausedAt != null && previous.pausedAt == null) {
+        return 'paused';
+    }
+    if ((current.pausedAt == null && previous.pausedAt != null)
+        || (previous.status === SubscriptionStatus.Suspended && active)) {
+        return 'resumed';
+    }
+    if (current.planSku !== previous.planSku) {
+        return current.rank < previous.rank ? 'downgraded' : 'upgraded';
+    }
+    if (previous.cancelAtPeriodEnd !== true && current.cancelAtPeriodEnd === true) {
+        return 'cancel-scheduled';
+    }
+    if (previous.cancelAtPeriodEnd === true && current.cancelAtPeriodEnd !== true) {
+        return 'cancel-undone';
+    }
+    if (opts.renewal === true && opts.invoiceId != null && opts.invoiceId !== previous.renewedInvoiceId) {
+        return 'renewed';
+    }
+    if (current.status === SubscriptionStatus.PastDue && previous.status !== SubscriptionStatus.PastDue) {
+        return 'past-due';
+    }
+    if (current.status === SubscriptionStatus.Suspended && previous.status !== SubscriptionStatus.Suspended) {
+        return 'suspended';
+    }
+    if (opts.trialEnding === true) {
+        return 'trial-ending';
+    }
+    return null;
+};
+/** The idempotency key a consumer keys the side effect of a change by. */
+export const subscriptionEventKey = (record, change, opts = {}) => {
+    const base = `subscription:${record.externalId}:${change}`;
+    switch (change) {
+        case 'created':
+            return `${base}:${new Date(record.createdAt).toISOString()}`;
+        case 'renewed':
+            return `${base}:${opts.invoiceId ?? record.latestInvoiceId ?? 'unknown'}`;
+        case 'upgraded':
+        case 'downgraded':
+            return `${base}:${record.planSku}`;
+        case 'trial-ending':
+            return `${base}:${record.trialEnd != null ? new Date(record.trialEnd).toISOString() : 'unknown'}`;
+        default:
+            return `${base}:${opts.eventId ?? `sync-${new Date(record.updatedAt ?? Date.now()).toISOString()}`}`;
+    }
+};
+/** A subscription as observers see it; `state` overlays what was last propagated. */
+export const snapshotOf = async (ctx, record, state) => {
+    const planSku = state?.planSku ?? record.planSku;
+    const plan = await findPlan(ctx, planSku);
+    return compact({
+        entityId: record.entityId,
+        planSku,
+        productSku: plan?.productSku ?? record.productSku,
+        rank: state?.rank ?? record.rank,
+        status: state?.status ?? record.status,
+        paygate: record.paygate,
+        subscriptionId: record.externalId,
+        service: record.service,
+        periodStart: record.periodStart ?? undefined,
+        periodEnd: record.periodEnd ?? undefined,
+        cancelAtPeriodEnd: state != null ? state.cancelAtPeriodEnd : record.cancelAtPeriodEnd ?? undefined,
+        trialEnd: record.trialEnd ?? undefined,
+        pausedAt: state != null ? state.pausedAt : record.pausedAt ?? undefined,
+        createdAt: record.createdAt ?? undefined,
+        capabilities: plan?.capabilities,
+        limits: plan?.limits,
+    });
+};
+const MATERIAL = [
+    'entityId', 'planSku', 'productSku', 'service', 'itemId', 'priceId', 'status', 'externalStatus', 'rank',
+    'periodStart', 'periodEnd', 'cancelAtPeriodEnd', 'canceledAt', 'endedAt', 'pausedAt', 'trialEnd',
+    'latestInvoiceId', 'customerId',
+];
+const sameValue = (left, right) => {
+    if (left == null || right == null) {
+        return left == null && right == null;
+    }
+    if (left instanceof Date || right instanceof Date) {
+        return timeOf(left) === timeOf(right);
+    }
+    return left === right;
+};
+export const materiallyDiffers = (previous, next) => MATERIAL.some(field => !sameValue(previous[field], next[field]));
+/**
+ * Store a subscription's new state, tell observers what changed, then record what was told.
+ *
+ * The state is written BEFORE observers run, so an observer reading entitlements sees the new plan.
+ * What classification compares against is the state last PROPAGATED (`propagated`), stamped only
+ * after every observer succeeded — so an observer that throws leaves the change to be classified
+ * again, identically, when the paygate retries. `lastEventId` is stamped with it.
+ */
+export const commitSubscription = async (ctx, previous, next, opts = {}) => {
+    const resource = subscriptions(ctx);
+    const updated = previous == null || materiallyDiffers(previous, next);
+    const prior = previous?.propagated ?? null;
+    const change = classifySubscriptionChange(prior, next, opts);
+    const at = new Date();
+    const finalize = (record) => {
+        const tracked = prior != null || change === 'created';
+        return {
+            ...record,
+            ...(opts.eventId != null ? { lastEventId: opts.eventId } : {}),
+            ...(tracked ? {
+                propagated: propagatedStateOf(record, change === 'renewed' ? opts.invoiceId : prior?.renewedInvoiceId),
+            } : {}),
+            ...(change === 'created' && record.initialPropagatedAt == null ? { initialPropagatedAt: at } : {}),
+        };
+    };
+    const write = async (record) => {
+        if (record.id != null) {
+            return await resource.update(record);
+        }
+        try {
+            return await resource.create(record);
+        }
+        catch (error) {
+            if (!isDuplicateKey(error)) {
+                throw error;
+            }
+            const winner = await resource.byExternalId(record.externalId, record.paygate);
+            return await resource.update({ ...record, id: winner?.id });
+        }
+    };
+    if (change == null) {
+        const quiet = previous != null && !updated && (opts.eventId == null || previous.lastEventId === opts.eventId)
+            && (prior == null || !stateDiffers(prior, next));
+        return { record: quiet ? previous : await write(finalize(next)), change: null, updated };
+    }
+    const stored = await write(next);
+    await opts.beforePropagate?.(stored, change);
+    await observer(ctx).propagateSubscription({
+        change,
+        previous: prior != null && previous != null ? await snapshotOf(ctx, previous, prior) : null,
+        current: await snapshotOf(ctx, stored),
+        active: ENTITLING_STATUSES.includes(stored.status),
+        eventKey: subscriptionEventKey(stored, change, opts),
+        ...(opts.invoiceId != null ? { invoiceId: opts.invoiceId } : {}),
+        ...(opts.eventId != null ? { externalEventId: opts.eventId } : {}),
+    }, ctx);
+    return { record: await resource.update(finalize(stored)), change, updated };
+};
+const stateDiffers = (state, record) => state.planSku !== record.planSku || state.rank !== record.rank || state.status !== record.status
+    || (state.cancelAtPeriodEnd === true) !== (record.cancelAtPeriodEnd === true)
+    || timeOf(state.pausedAt) !== timeOf(record.pausedAt);
+//# sourceMappingURL=subscription.js.map