@owlmeans/server-payment 0.1.18-rc.30 → 0.1.18-rc.32

package/build/actions/webhook.js

@@ -1,16 +1,17 @@
 import { PaygateError, UnknownPaygate } from '@owlmeans/payment';
 import { handlers } from '@owlmeans/server-api';
 import { STRIPE_PAYGATE_ALIAS } from '../consts.js';
-import { paymentGate, gateway } from '../utils.js';
-import { handleStripeWebhook } from '../plugins/stripe.js';
+import { paymentAccessOf } from '../access.js';
+import { paymentGate } from '../protocol.js';
+import { webhookOf } from '../plugins/webhook-manager.js';
 const bind = handlers();
 /** A Stripe delivery — only a managed gateway receives one; its secret is the `owner`'s stored one. */
 export const webhook = bind.params(paymentGate.webhook, async ({ paygate }, context, request) => {
     if (paygate !== STRIPE_PAYGATE_ALIAS)
         throw new UnknownPaygate(paygate);
-    const service = gateway(context);
+    const service = paymentAccessOf(context).gateway();
     if (!service.managed)
         throw new PaygateError('unmanaged');
-    await handleStripeWebhook(context, await service.stripe(context), request);
+    await webhookOf(context).handleStripeWebhook(await service.stripe(context), request);
 });
 //# sourceMappingURL=webhook.js.map

package/build/actions/webhook.js.map

@@ -1 +1 @@
-{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/actions/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG1D,MAAM,IAAI,GAAG,QAAQ,EAAW,CAAA;AAEhC,uGAAuG;AACvG,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;IAC9F,IAAI,OAAO,KAAK,oBAAoB;QAAE,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAChC,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,YAAY,CAAC,WAAW,CAAC,CAAA;IACzD,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAA;AAC5E,CAAC,CAAC,CAAA"}
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/actions/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAEzD,MAAM,IAAI,GAAG,QAAQ,EAAW,CAAA;AAEhC,uGAAuG;AACvG,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;IAC9F,IAAI,OAAO,KAAK,oBAAoB;QAAE,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;IACvE,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAA;IAClD,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,YAAY,CAAC,WAAW,CAAC,CAAA;IACzD,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC,mBAAmB,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAA;AACtF,CAAC,CAAC,CAAA"}

package/build/bootstrap/types.d.ts

@@ -0,0 +1,16 @@
+import type Stripe from 'stripe';
+import type { StripeBootstrapOptions } from '../types.js';
+/** What brings Stripe to a deployment's declaration. */
+export interface StripeBootstrapHelper {
+    /**
+     * 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.
+     *
+     * The webhook URL and the owner key come from the context's gateway (`webhookService`, `owner`), so
+     * every process of one deployment — the one bootstrapping at boot, a `resync`, an application's
+     * forced maintenance run — computes the same URL and rows; each step is fingerprinted, so running it
+     * from any of them is idempotent.
+     */
+    bootstrapStripe: (stripe: Stripe, opts?: StripeBootstrapOptions) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/bootstrap/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bootstrap/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAChC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzD,wDAAwD;AACxD,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;OAQG;IACH,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAClF"}

package/build/bootstrap/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/bootstrap/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bootstrap/types.ts"],"names":[],"mappings":""}

package/build/bootstrap.d.ts

@@ -0,0 +1,6 @@
+import type { Context as ApiContext } from '@owlmeans/server-api';
+import type { StripeBootstrapHelper } from './bootstrap/types.js';
+export declare const makeStripeBootstrapHelper: (ctx: ApiContext) => StripeBootstrapHelper;
+/** The Stripe bootstrap of a context — one per context. */
+export declare const stripeBootstrapOf: (target: ApiContext<import("@owlmeans/server-api").Config>) => StripeBootstrapHelper;
+//# sourceMappingURL=bootstrap.d.ts.map

package/build/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAIjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAKjE,eAAO,MAAM,yBAAyB,QAAS,UAAU,KAAG,qBAiB3D,CAAA;AAED,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,sFAAgD,CAAA"}

package/build/bootstrap.js

@@ -0,0 +1,26 @@
+import { memoHelper } from '@owlmeans/context';
+import { log } from './log.js';
+import { productSyncOf } from './sync.js';
+import { portalOf } from './plugins/portal.js';
+import { webhookOf } from './plugins/webhook-manager.js';
+export const makeStripeBootstrapHelper = (ctx) => {
+    const bootstrapStripe = async (stripe, opts = {}) => {
+        const steps = [
+            ['products', async () => await productSyncOf(ctx).syncStripeProducts(stripe)],
+            ['portal', async () => await portalOf(ctx).ensurePortalConfiguration(stripe, opts)],
+            ['webhook', async () => await webhookOf(ctx).ensureWebhookEndpoint(stripe, opts)],
+        ];
+        for (const [name, step] of steps) {
+            try {
+                await step();
+            }
+            catch (error) {
+                log.error('Stripe bootstrap step failed', { step: name, error });
+            }
+        }
+    };
+    return { bootstrapStripe };
+};
+/** The Stripe bootstrap of a context — one per context. */
+export const stripeBootstrapOf = memoHelper.oncePer(makeStripeBootstrapHelper);
+//# sourceMappingURL=bootstrap.js.map

package/build/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAExD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAe,EAAyB,EAAE;IAClF,MAAM,eAAe,GAAG,KAAK,EAAE,MAAc,EAAE,IAAI,GAA2B,EAAE,EAAiB,EAAE;QACjG,MAAM,KAAK,GAA4C;YACrD,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC7E,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,yBAAyB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACnF,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;SAClF,CAAA;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,IAAI,EAAE,CAAA;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;YAClE,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,OAAO,EAAE,eAAe,EAAE,CAAA;AAC5B,CAAC,CAAA;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAA"}

package/build/catalogue/types.d.ts

@@ -0,0 +1,38 @@
+import type { PermissionSet } from '@owlmeans/auth';
+import type { EffectivePlan, PaymentPlan, PaymentProduct } from '../types.js';
+/** The catalogue a context declares, and the plan each entity holds in it. */
+export interface CatalogueHelper {
+    /** A plan by sku, or `null` when the catalogue no longer declares it. */
+    findPlan: (planSku: string) => Promise<PaymentPlan | null>;
+    /** A product by sku, or `null`. */
+    findProduct: (productSku: string) => Promise<PaymentProduct | null>;
+    /** Every plan of every declared product. */
+    catalogPlans: () => Promise<PaymentPlan[]>;
+    /** The declared free plan an entity falls back to: the lowest rank, then the sku. */
+    freePlanOf: () => Promise<PaymentPlan | null>;
+    /**
+     * The plan an entity holds: its highest-ranked subscription in an entitling status (the catalogue
+     * rank, the stored one for a plan the catalogue no longer declares; the newest first on a tie),
+     * else the declared free plan. The plan answered carries the winning row's `overrides`
+     * (`overriddenPlan`), so every reader — ceilings, the view, the gates — sees one answer.
+     *
+     * @throws PlanRequired when there is neither.
+     */
+    resolveEffectivePlan: (entityId: string, at?: Date) => Promise<EffectivePlan>;
+    /**
+     * The capability sets an entity's effective plan grants now — sets behind a lapsed promo left out.
+     * Empty when the plan is not of one of `productSkus`.
+     */
+    entitlementsOf: (entityId: string, productSkus?: string[]) => Promise<PermissionSet[]>;
+    /** Every product sold through Stripe with the plans it sells there. */
+    stripePlansOf: () => Promise<Array<{
+        product: PaymentProduct;
+        plans: PaymentPlan[];
+    }>>;
+    /** The plan an amount/quantity checkout of a consumable product sells: the named one, else the first. */
+    consumablePlanOf: (productSku: string, planSku?: string) => Promise<{
+        product: PaymentProduct;
+        plan: PaymentPlan;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/catalogue/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/catalogue/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE7E,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC1D,mCAAmC;IACnC,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IACnE,4CAA4C;IAC5C,YAAY,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAC1C,qFAAqF;IACrF,UAAU,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC7C;;;;;;;OAOG;IACH,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,aAAa,CAAC,CAAA;IAC7E;;;OAGG;IACH,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IACtF,uEAAuE;IACvE,aAAa,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAAC,CAAA;IACtF,yGAAyG;IACzG,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC,CAAA;CACpH"}

package/build/catalogue/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/catalogue/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/catalogue/types.ts"],"names":[],"mappings":""}

package/build/catalogue.d.ts

@@ -0,0 +1,6 @@
+import type { Context as ApiContext } from '@owlmeans/server-api';
+import type { CatalogueHelper } from './catalogue/types.js';
+export declare const makeCatalogueHelper: (ctx: ApiContext) => CatalogueHelper;
+/** The catalogue of a context — one per context. */
+export declare const catalogueOf: (target: ApiContext<import("@owlmeans/server-api").Config>) => CatalogueHelper;
+//# sourceMappingURL=catalogue.d.ts.map

package/build/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../src/catalogue.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAOjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAS3D,eAAO,MAAM,mBAAmB,QAAS,UAAU,KAAG,eAiHrD,CAAA;AAED,oDAAoD;AACpD,eAAO,MAAM,WAAW,gFAA0C,CAAA"}

package/build/catalogue.js

@@ -0,0 +1,110 @@
+import { ENTITLING_STATUSES, INTERNAL_PAYGATE, PlanRequired, ProductError, promoHelper } from '@owlmeans/payment';
+import { memoHelper } from '@owlmeans/context';
+import { STRIPE_PAYGATE_ALIAS } from './consts.js';
+import { paymentAccessOf } from './access.js';
+import { planHelper } from './plan.js';
+import { log } from './log.js';
+/** The plan skus already reported unknown — process-wide, so each is warned about once. */
+const unknownPlans = new Set();
+/** An internal grant with a period end stops entitling at that instant; a paygate row never does. */
+const stillEntitles = (row, at) => row.paygate !== INTERNAL_PAYGATE || row.periodEnd == null || new Date(row.periodEnd).getTime() > at.getTime();
+export const makeCatalogueHelper = (ctx) => {
+    const access = paymentAccessOf(ctx);
+    const findPlan = async (planSku) => {
+        try {
+            return await access.payment().plan(planSku);
+        }
+        catch {
+            return null;
+        }
+    };
+    const findProduct = async (productSku) => {
+        try {
+            return await access.payment().product(productSku);
+        }
+        catch {
+            return null;
+        }
+    };
+    const catalogPlans = async () => {
+        const products = await access.payment().products();
+        const plans = [];
+        for (const product of products) {
+            plans.push(...await access.payment().allPlans(product.sku));
+        }
+        return plans;
+    };
+    const freePlanOf = async () => (await catalogPlans())
+        .filter(plan => plan.free === true)
+        .sort((a, b) => planHelper.planRank(a) - planHelper.planRank(b) || a.sku.localeCompare(b.sku))[0] ?? null;
+    const resolveEffectivePlan = async (entityId, at = new Date()) => {
+        const fallback = await freePlanOf();
+        const { items } = await access.subscriptions().list({ entityId, status: [...ENTITLING_STATUSES] }, { size: 0 });
+        const candidates = [];
+        for (const row of items.filter(item => stillEntitles(item, at))) {
+            const plan = await findPlan(row.planSku);
+            if (plan == null) {
+                if (!unknownPlans.has(row.planSku)) {
+                    unknownPlans.add(row.planSku);
+                    log.warn('Subscription names an unknown plan; ignored', { subscriptionId: row.externalId, planSku: row.planSku });
+                }
+                continue;
+            }
+            candidates.push({ plan, row, rank: planHelper.planRank(plan) });
+        }
+        candidates.sort((a, b) => b.rank - a.rank
+            || new Date(b.row.createdAt).getTime() - new Date(a.row.createdAt).getTime());
+        const best = candidates[0];
+        if (best != null) {
+            return { plan: planHelper.overriddenPlan(best.plan, best.row), subscription: best.row, fallback };
+        }
+        if (fallback != null) {
+            return { plan: fallback, subscription: null, fallback };
+        }
+        throw new PlanRequired(entityId);
+    };
+    const entitlementsOf = async (entityId, productSkus) => {
+        const { plan, subscription } = await resolveEffectivePlan(entityId);
+        if (productSkus != null && !productSkus.includes(plan.productSku)) {
+            return [];
+        }
+        const at = new Date();
+        return (plan.capabilities ?? [])
+            .filter(set => promoHelper.promoActive(set.promo, subscription?.createdAt, at))
+            .map(({ promo: _promo, ...set }) => set);
+    };
+    const stripePlansOf = async () => {
+        const products = await access.payment().products();
+        const result = [];
+        for (const product of products) {
+            if (!(product.gateways ?? []).includes(STRIPE_PAYGATE_ALIAS)) {
+                continue;
+            }
+            const plans = (await access.payment().allPlans(product.sku))
+                .filter(plan => planHelper.isSoldThrough(product, plan, STRIPE_PAYGATE_ALIAS));
+            if (plans.length > 0) {
+                result.push({ product, plans });
+            }
+        }
+        return result;
+    };
+    const consumablePlanOf = async (productSku, planSku) => {
+        const product = await access.payment().product(productSku);
+        const plans = (await access.payment().allPlans(product.sku))
+            .filter(plan => planHelper.isSoldThrough(product, plan, STRIPE_PAYGATE_ALIAS));
+        if (planSku != null && !plans.some(plan => plan.sku === planSku)) {
+            throw new ProductError(`plan:${planSku}`);
+        }
+        const plan = plans.find(item => item.sku === planSku) ?? plans[0];
+        if (plan == null)
+            throw new ProductError('plan');
+        return { product, plan };
+    };
+    return {
+        findPlan, findProduct, catalogPlans, freePlanOf, resolveEffectivePlan, entitlementsOf, stripePlansOf,
+        consumablePlanOf,
+    };
+};
+/** The catalogue of a context — one per context. */
+export const catalogueOf = memoHelper.oncePer(makeCatalogueHelper);
+//# sourceMappingURL=catalogue.js.map

package/build/catalogue.js.map

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

package/build/commit/types.d.ts

@@ -0,0 +1,22 @@
+import type { CommitOptions, CommitResult, GrantInternalPlanOptions, PaymentSubscriptionRecord, PropagatedState, SubscriptionSnapshot } from '../types.js';
+/** A context's subscription rows: what observers see of them, how a new state is committed, internal grants. */
+export interface SubscriptionCommitHelper {
+    /** A subscription as observers see it; `state` overlays what was last propagated. */
+    snapshotOf: (record: PaymentSubscriptionRecord, state?: PropagatedState) => Promise<SubscriptionSnapshot>;
+    /**
+     * 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.
+     */
+    commitSubscription: (previous: PaymentSubscriptionRecord | null, next: PaymentSubscriptionRecord, opts?: CommitOptions) => Promise<CommitResult>;
+    /**
+     * 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.
+     */
+    grantInternalPlan: (entityId: string, planSku: string, opts?: GrantInternalPlanOptions) => Promise<PaymentSubscriptionRecord>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/commit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commit/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAAE,YAAY,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,eAAe,EACjG,oBAAoB,EACrB,MAAM,aAAa,CAAA;AAEpB,gHAAgH;AAChH,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,UAAU,EAAE,CAAC,MAAM,EAAE,yBAAyB,EAAE,KAAK,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;IACzG;;;;;;;OAOG;IACH,kBAAkB,EAAE,CAClB,QAAQ,EAAE,yBAAyB,GAAG,IAAI,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,CAAC,EAAE,aAAa,KAC9F,OAAO,CAAC,YAAY,CAAC,CAAA;IAC1B;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,wBAAwB,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAA;CAC9H"}

package/build/commit/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/commit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/commit/types.ts"],"names":[],"mappings":""}

package/build/commit.d.ts

@@ -0,0 +1,6 @@
+import type { Context as ApiContext } from '@owlmeans/server-api';
+import type { SubscriptionCommitHelper } from './commit/types.js';
+export declare const makeSubscriptionCommitHelper: (ctx: ApiContext) => SubscriptionCommitHelper;
+/** The subscription store of a context — one per context. */
+export declare const subscriptionCommitOf: (target: ApiContext<import("@owlmeans/server-api").Config>) => SubscriptionCommitHelper;
+//# sourceMappingURL=commit.d.ts.map

package/build/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../src/commit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAajE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAEjE,eAAO,MAAM,4BAA4B,QAAS,UAAU,KAAG,wBAoI9D,CAAA;AAED,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,yFAAmD,CAAA"}

package/build/commit.js

@@ -0,0 +1,125 @@
+import { ENTITLING_STATUSES, INTERNAL_PAYGATE, ProductError, SubscriptionStatus, UnknownPlan } from '@owlmeans/payment';
+import { memoHelper } from '@owlmeans/context';
+import { log } from './log.js';
+import { SUBSCRIPTION_LOG_EVENTS } from './consts.local.js';
+import { paymentAccessOf } from './access.js';
+import { paymentUtils } from './utils.js';
+import { catalogueOf } from './catalogue.js';
+import { planHelper } from './plan.js';
+import { subscriptionHelper } from './subscription.js';
+export const makeSubscriptionCommitHelper = (ctx) => {
+    const access = paymentAccessOf(ctx);
+    const snapshotOf = async (record, state) => {
+        const planSku = state?.planSku ?? record.planSku;
+        const declared = await catalogueOf(ctx).findPlan(planSku);
+        const plan = declared != null ? planHelper.overriddenPlan(declared, record) : null;
+        return paymentUtils.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 commitSubscription = async (previous, next, opts = {}) => {
+        const resource = access.subscriptions();
+        const updated = previous == null || subscriptionHelper.materiallyDiffers(previous, next);
+        const prior = previous?.propagated ?? null;
+        const change = subscriptionHelper.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: subscriptionHelper.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 (!paymentUtils.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 || !subscriptionHelper.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 access.observer().propagateSubscription({
+            change,
+            previous: prior != null && previous != null ? await snapshotOf(previous, prior) : null,
+            current: await snapshotOf(stored),
+            active: ENTITLING_STATUSES.includes(stored.status),
+            eventKey: subscriptionHelper.subscriptionEventKey(stored, change, opts),
+            ...(opts.invoiceId != null ? { invoiceId: opts.invoiceId } : {}),
+            ...(opts.eventId != null ? { externalEventId: opts.eventId } : {}),
+        }, ctx);
+        const record = await resource.update(finalize(stored));
+        log.info('Subscription changed', paymentUtils.compact({
+            entityId: stored.entityId, subscriptionId: stored.externalId, change, planSku: stored.planSku,
+            previousPlanSku: prior != null && prior.planSku !== stored.planSku ? prior.planSku : undefined,
+            status: stored.status, currency: stored.currency ?? undefined, invoiceId: opts.invoiceId, eventId: opts.eventId,
+        }), { event: SUBSCRIPTION_LOG_EVENTS[change] ?? 'subscription.updated' });
+        return { record, change, updated };
+    };
+    const grantInternalPlan = async (entityId, planSku, opts = {}) => {
+        const plan = await catalogueOf(ctx).findPlan(planSku);
+        if (plan == null) {
+            throw new UnknownPlan(planSku);
+        }
+        if (plan.free !== true && opts.force !== true) {
+            throw new ProductError(`internal-grant:${planSku}`);
+        }
+        const product = await catalogueOf(ctx).findProduct(plan.productSku);
+        const externalId = plan.free === true ? `free:${entityId}` : `internal:${planSku}:${entityId}`;
+        const previous = await access.subscriptions().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: planHelper.planRank(plan),
+            ...(opts.periodEnd != null ? { periodEnd: opts.periodEnd } : {}),
+            createdAt: previous?.createdAt ?? now,
+            updatedAt: now,
+        };
+        const { record } = await commitSubscription(previous, next);
+        return record ?? next;
+    };
+    return { snapshotOf, commitSubscription, grantInternalPlan };
+};
+/** The subscription store of a context — one per context. */
+export const subscriptionCommitOf = memoHelper.oncePer(makeSubscriptionCommitHelper);
+//# sourceMappingURL=commit.js.map

package/build/commit.js.map

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

package/build/config.d.ts

@@ -1,5 +1,5 @@
 import { type ConsumerRightsPolicy } from '@owlmeans/payment';
-import type { Config, ConsumerRightsDef, PaymentPlan, PaymentPlanDef, PaymentProductDef, PortalBrandingDef, PricingDef, StripeSecretsDef } from './types.js';
+import type { Config, ConsumerRightsDef, PaymentPlanDef, PaymentProductDef, PortalBrandingDef, PricingDef, StripeSecretsDef } from './types.js';
 export declare const declarePaymentProduct: (cfg: Config, def: PaymentProductDef) => void;
 /**
  * Declare a plan into the configuration catalogue.
@@ -10,22 +10,6 @@ export declare const declarePaymentProduct: (cfg: Config, def: PaymentProductDef
  * integer, a promo ends at a real `Date`). Amount and quantity policies are asserted as before.
  */
 export declare const declarePaymentPlan: (cfg: Config, def: PaymentPlanDef) => void;
-/** Every plan declared into a configuration. */
-export declare const declaredPlansOf: (cfg: Config) => PaymentPlan[];
-/**
- * Cross-plan rules a single declaration cannot see:
- *
- * - at most one free plan per rank;
- * - no two paid plans of one product at the same rank (one-time `consumable` plans are never an
- *   entity's plan and are not ranked against each other).
- *
- * A limit key MAY change kind between plans (lifetime on one, a monthly window on another): counters
- * are keyed by `(entity, key, window)` and the window is derived from the kind, so each kind keeps its
- * own counter and a lifetime count still sticks to the entity across plan changes.
- *
- * @throws PlanRankConflict
- */
-export declare const assertPlanDeclarations: (cfg: Config) => void;
 /**
  * Where the Stripe secrets live. A value that looks like a path is read into the configuration at
  * boot. The webhook secret is an optional override of the one the managed endpoint stores.

package/build/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkd,KAAK,oBAAoB,EAAuD,MAAM,mBAAmB,CAAA;AAKlkB,OAAO,KAAK,EACV,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAkB,iBAAiB,EAAE,iBAAiB,EAC5G,UAAU,EAAE,gBAAgB,EAC7B,MAAM,YAAY,CAAA;AAGnB,eAAO,MAAM,qBAAqB,QAAS,MAAM,OAAO,iBAAiB,KAAG,IAS3E,CAAA;AA4BD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAS,MAAM,OAAO,cAAc,KAAG,IA+CrE,CAAA;AA8CD,gDAAgD;AAChD,eAAO,MAAM,eAAe,QAAS,MAAM,KAAG,WAAW,EACiD,CAAA;AAE1G;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,QAAS,MAAM,KAAG,IAmBpD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAS,MAAM,SAAS,gBAAgB,KAAG,IAIpE,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,cAAc,QAAS,MAAM,OAAO,iBAAiB,KAAG,IAOpE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,QAAS,MAAM,OAAO,UAAU,KAAG,IAqCpE,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,QAAS,MAAM,OAAO,iBAAiB,KAAG,oBAsC3E,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqX,KAAK,oBAAoB,EAAmG,MAAM,mBAAmB,CAAA;AAKjhB,OAAO,KAAK,EACV,MAAM,EAAE,iBAAiB,EAAe,cAAc,EAAkB,iBAAiB,EAAE,iBAAiB,EAC5G,UAAU,EAAE,gBAAgB,EAC7B,MAAM,YAAY,CAAA;AAGnB,eAAO,MAAM,qBAAqB,QAAS,MAAM,OAAO,iBAAiB,KAAG,IAS3E,CAAA;AA2BD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAS,MAAM,OAAO,cAAc,KAAG,IA+CrE,CAAA;AA8CD;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAS,MAAM,SAAS,gBAAgB,KAAG,IAIpE,CAAA;AAED,wFAAwF;AACxF,eAAO,MAAM,cAAc,QAAS,MAAM,OAAO,iBAAiB,KAAG,IAOpE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,QAAS,MAAM,OAAO,UAAU,KAAG,IAqCpE,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,QAAS,MAAM,OAAO,iBAAiB,KAAG,oBAsC3E,CAAA"}

package/build/config.js

@@ -1,6 +1,5 @@
-import { toConfigRecord } from '@owlmeans/server-app';
-import { plugin, PLUGIN_RECORD } from '@owlmeans/config';
-import { assertAmountCheckoutPolicy, assertPricingPolicy, assertQuantityCheckoutPolicy, CAPABILITY_LIMIT_SCOPE, CheckoutPricingMode, CONSUMER_RIGHTS_RECORD_ID, CONSUMER_RIGHTS_RECORD_TYPE, ConsumerRightsError, LimitKind, LimitMisdeclared, makeConsumerRightsPolicy, PLAN_RECORD_PREFIX, PLAN_RECORD_TYPE, PaymentError, PlanDuration, PlanRankConflict, PlanStatus, PRICING_POLICY_RECORD_ID, PRICING_POLICY_RECORD_TYPE, PRODUCT_RECORD_PREFIX, PRODUCT_RECORD_TYPE, ProductError } from '@owlmeans/payment';
+import { plugin, PLUGIN_RECORD, configHelper } from '@owlmeans/config';
+import { CAPABILITY_LIMIT_SCOPE, CheckoutPricingMode, CONSUMER_RIGHTS_RECORD_ID, CONSUMER_RIGHTS_RECORD_TYPE, ConsumerRightsError, LimitKind, LimitMisdeclared, makeConsumerRightsPolicy, PLAN_RECORD_PREFIX, PLAN_RECORD_TYPE, PaymentError, PlanRankConflict, PlanStatus, PRICING_POLICY_RECORD_ID, PRICING_POLICY_RECORD_TYPE, PRODUCT_RECORD_PREFIX, PRODUCT_RECORD_TYPE, ProductError, checkoutPricingHelper, priceEstimateHelper } from '@owlmeans/payment';
 import { CONSUMER_RIGHTS_MAIL_PLUGIN_CONFIG, STRIPE_PAYGATE_ALIAS, STRIPE_PLUGIN_CONFIG, STRIPE_PORTAL_PLUGIN_CONFIG, STRIPE_PRICING_PLUGIN_CONFIG, } from './consts.js';
 import { CURRENCY, LIMIT_KINDS, LIMIT_WINDOWS } from './consts.local.js';
 export const declarePaymentProduct = (cfg, def) => {
@@ -11,7 +10,7 @@ export const declarePaymentProduct = (cfg, def) => {
         gateways: def.gateways ?? [STRIPE_PAYGATE_ALIAS], capabilities: def.capabilities,
         taxCode: def.taxCode, unitLabel: def.unitLabel,
     };
-    cfg.records.push({ ...toConfigRecord(product), recordType: PRODUCT_RECORD_TYPE, id: `${PRODUCT_RECORD_PREFIX}:${def.sku}` });
+    cfg.records.push({ ...configHelper.toConfigRecord(product), recordType: PRODUCT_RECORD_TYPE, id: `${PRODUCT_RECORD_PREFIX}:${def.sku}` });
 };
 const isSafeCount = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
 const assertLimitDeclaration = (key, limit) => {
@@ -61,7 +60,7 @@ export const declarePaymentPlan = (cfg, def) => {
     if (pricingMode === CheckoutPricingMode.Amount) {
         if (def.amountPolicy == null)
             throw new TypeError(`Amount checkout plan '${def.sku}' requires amountPolicy`);
-        assertAmountCheckoutPolicy(def.amountPolicy);
+        checkoutPricingHelper.assertAmountCheckoutPolicy(def.amountPolicy);
     }
     const quantityPolicy = def.quantityPolicy ?? (def.minQuantity != null || def.maxQuantity != null || def.defaultQuantity != null
         ? {
@@ -71,7 +70,7 @@ export const declarePaymentPlan = (cfg, def) => {
         }
         : undefined);
     if (quantityPolicy != null)
-        assertQuantityCheckoutPolicy(quantityPolicy);
+        checkoutPricingHelper.assertQuantityCheckoutPolicy(quantityPolicy);
     const currencyPrices = currencyPricesOf(def);
     assertWithdrawalComponents(def);
     cfg.records = cfg.records ?? [];
@@ -88,7 +87,7 @@ export const declarePaymentPlan = (cfg, def) => {
         ...(currencyPrices != null ? { currencyPrices } : {}),
         ...(def.withdrawal != null ? { withdrawal: { components: def.withdrawal.components.map(item => ({ ...item })) } } : {}),
     };
-    cfg.records.push({ ...toConfigRecord(plan), recordType: PLAN_RECORD_TYPE, id: `${PLAN_RECORD_PREFIX}:${def.sku}` });
+    cfg.records.push({ ...configHelper.toConfigRecord(plan), recordType: PLAN_RECORD_TYPE, id: `${PLAN_RECORD_PREFIX}:${def.sku}` });
 };
 /** `currencyPrices` normalized to lowercase codes; each a positive amount of whole minor units. */
 const currencyPricesOf = (def) => {
@@ -131,42 +130,6 @@ const assertWithdrawalComponents = (def) => {
         throw new ProductError(`withdrawal:${def.sku}:shares`);
     }
 };
-/** Every plan declared into a configuration. */
-export const declaredPlansOf = (cfg) => (cfg.records ?? []).filter(record => record.recordType === PLAN_RECORD_TYPE);
-/**
- * Cross-plan rules a single declaration cannot see:
- *
- * - at most one free plan per rank;
- * - no two paid plans of one product at the same rank (one-time `consumable` plans are never an
- *   entity's plan and are not ranked against each other).
- *
- * A limit key MAY change kind between plans (lifetime on one, a monthly window on another): counters
- * are keyed by `(entity, key, window)` and the window is derived from the kind, so each kind keeps its
- * own counter and a lifetime count still sticks to the entity across plan changes.
- *
- * @throws PlanRankConflict
- */
-export const assertPlanDeclarations = (cfg) => {
-    const plans = declaredPlansOf(cfg);
-    const freeRanks = new Set();
-    const paidRanks = new Set();
-    for (const plan of plans) {
-        const rank = plan.rank ?? 0;
-        if (plan.free === true) {
-            if (freeRanks.has(rank)) {
-                throw new PlanRankConflict(`free:${rank}`);
-            }
-            freeRanks.add(rank);
-        }
-        else if (plan.duration !== PlanDuration.Consumable) {
-            const key = `${plan.productSku}:${rank}`;
-            if (paidRanks.has(key)) {
-                throw new PlanRankConflict(key);
-            }
-            paidRanks.add(key);
-        }
-    }
-};
 /**
  * Where the Stripe secrets live. A value that looks like a path is read into the configuration at
  * boot. The webhook secret is an optional override of the one the managed endpoint stores.
@@ -200,10 +163,10 @@ export const portalBranding = (cfg, def) => {
  */
 export const declarePaymentPricing = (cfg, def) => {
     const { stripe, ...policy } = def;
-    assertPricingPolicy(policy);
+    priceEstimateHelper.assertPricingPolicy(policy);
     cfg.records = (cfg.records ?? []).filter(record => record.id !== PRICING_POLICY_RECORD_ID);
     cfg.records.push({
-        ...toConfigRecord(policy), recordType: PRICING_POLICY_RECORD_TYPE, id: PRICING_POLICY_RECORD_ID,
+        ...configHelper.toConfigRecord(policy), recordType: PRICING_POLICY_RECORD_TYPE, id: PRICING_POLICY_RECORD_ID,
     });
     if (stripe != null) {
         const settlementCurrency = stripe.settlementCurrency?.toLowerCase();
@@ -261,7 +224,7 @@ export const declareConsumerRights = (cfg, def) => {
     }
     cfg.records = (cfg.records ?? []).filter(record => record.id !== CONSUMER_RIGHTS_RECORD_ID);
     cfg.records.push({
-        ...toConfigRecord(policy), recordType: CONSUMER_RIGHTS_RECORD_TYPE, id: CONSUMER_RIGHTS_RECORD_ID,
+        ...configHelper.toConfigRecord(policy), recordType: CONSUMER_RIGHTS_RECORD_TYPE, id: CONSUMER_RIGHTS_RECORD_ID,
     });
     const plugins = cfg[PLUGIN_RECORD];
     if (plugins != null) {