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

package/build/actions/resync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resync.d.ts","sourceRoot":"","sources":["../../src/actions/resync.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,MAAM,0JAIjB,CAAA"}
+{"version":3,"file":"resync.d.ts","sourceRoot":"","sources":["../../src/actions/resync.ts"],"names":[],"mappings":"AASA,yGAAyG;AACzG,eAAO,MAAM,MAAM,0JAKjB,CAAA"}

package/build/actions/resync.js

@@ -1,11 +1,15 @@
+import { PaygateError } from '@owlmeans/payment';
 import { handlers } from '@owlmeans/server-api';
 import { paymentGate } from '../consts.js';
-import { fingerprints } from '../utils.js';
-import { initialize } from '../sync.js';
+import { bootstrapStripe } from '../service.js';
+import { fingerprints, gateway, stripeClient } from '../utils.js';
 const bind = handlers();
+/** Forget every sync fingerprint and bring Stripe back to the declared catalogue, portal and webhook. */
 export const resync = bind.request(paymentGate.resync, async (_request, context) => {
+    if (!gateway(context).managed)
+        throw new PaygateError('unmanaged');
     await fingerprints(context).clear();
-    await initialize(context);
+    await bootstrapStripe(context, await stripeClient(context), { force: true });
     return { ok: true };
 });
 //# sourceMappingURL=resync.js.map

package/build/actions/resync.js.map

@@ -1 +1 @@
-{"version":3,"file":"resync.js","sourceRoot":"","sources":["../../src/actions/resync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC,MAAM,IAAI,GAAG,QAAQ,EAAW,CAAA;AAEhC,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IACjF,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAA;IACnC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAA;IACzB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;AACrB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"resync.js","sourceRoot":"","sources":["../../src/actions/resync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAGjE,MAAM,IAAI,GAAG,QAAQ,EAAW,CAAA;AAEhC,yGAAyG;AACzG,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IACjF,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO;QAAE,MAAM,IAAI,YAAY,CAAC,WAAW,CAAC,CAAA;IAClE,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAA;IACnC,MAAM,eAAe,CAAC,OAAO,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;AACrB,CAAC,CAAC,CAAA"}

package/build/actions/webhook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/actions/webhook.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,OAAO;;cAGlB,CAAA"}
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/actions/webhook.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,OAAO;;cAIlB,CAAA"}

package/build/actions/webhook.js

@@ -1,11 +1,14 @@
-import { UnknownPaygate } from '@owlmeans/payment';
+import { PaygateError, UnknownPaygate } from '@owlmeans/payment';
 import { handlers } from '@owlmeans/server-api';
 import { paymentGate, STRIPE_PAYGATE_ALIAS } from '../consts.js';
-import { stripePlugin } from '../plugins/stripe.js';
+import { handleStripeWebhook } from '../plugins/stripe.js';
+import { gateway, stripeClient } from '../utils.js';
 const bind = handlers();
 export const webhook = bind.params(paymentGate.webhook, async ({ paygate }, context, request) => {
     if (paygate !== STRIPE_PAYGATE_ALIAS)
         throw new UnknownPaygate(paygate);
-    await stripePlugin.handleWebhook(request, context);
+    if (!gateway(context).managed)
+        throw new PaygateError('unmanaged');
+    await handleStripeWebhook(context, await stripeClient(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,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,MAAM,IAAI,GAAG,QAAQ,EAAW,CAAA;AAEhC,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,YAAY,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AACpD,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,WAAW,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAGnD,MAAM,IAAI,GAAG,QAAQ,EAAW,CAAA;AAEhC,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,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO;QAAE,MAAM,IAAI,YAAY,CAAC,WAAW,CAAC,CAAA;IAClE,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAA;AAC1E,CAAC,CAAC,CAAA"}

package/build/config.d.ts

@@ -1,8 +1,63 @@
-import type { Config, PaymentPlanDef, PaymentProductDef } from './types.js';
+import type { ConsumerRightsPolicy } from '@owlmeans/payment';
+import type { Config, ConsumerRightsDef, PaymentPlan, PaymentPlanDef, PaymentProductDef, PortalBrandingDef, PricingDef, StripeSecretsDef } from './types.js';
 export declare const declarePaymentProduct: (cfg: Config, def: PaymentProductDef) => void;
+/**
+ * Declare a plan into the configuration catalogue.
+ *
+ * Validated before anything is pushed: `rank` a safe integer `>= 0`; a `free` plan costs nothing
+ * and is sold through no gateway; no capability set under the reserved `limit` scope; every limit
+ * well-formed (a `window` limit names its window, the others do not, the ceiling is a safe
+ * 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;
-export declare const stripeSecrets: (cfg: Config, paths: {
-    api: string;
-    webhook: string;
-}) => 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.
+ */
+export declare const stripeSecrets: (cfg: Config, paths: StripeSecretsDef) => void;
+/** Branding and the default return URL of the managed customer portal configuration. */
+export declare const portalBranding: (cfg: Config, def: PortalBrandingDef) => void;
+/**
+ * Declare the pricing policy: whether checkout collects tax and a VAT/GST id, what `tax_behavior`
+ * synced prices are given, Adaptive Pricing, and whether the estimate endpoints are served. A
+ * config never carries more than one — a second call replaces the first, so re-declaring (a test, a
+ * config module re-run) is safe rather than silently ignored (a config resource resolves an id to
+ * its FIRST match).
+ *
+ * `def.stripe` (the FX Quotes preview version, the unspecified-price migration switch) is
+ * Stripe-only and goes to a backend plugin, never the advertised `PricingPolicy` record.
+ *
+ * @throws PaymentError (`assertPricingPolicy`) when an estimate is declared without the tax or
+ * currency capability it requires.
+ */
+export declare const declarePaymentPricing: (cfg: Config, def: PricingDef) => void;
+/**
+ * Declare the consumer-rights policy (EU withdrawal, spend consent, start requests, cancellation,
+ * country lock) — a singleton config record like the pricing policy: `DEFAULT_CONSUMER_RIGHTS`
+ * filled in, asserted, and replacing any earlier declaration. It is ADVERTISED to the browser; the
+ * `mail` options (mailer alias, sender, archive copies) go to a backend-only plugin config.
+ *
+ * `trader` (who the consumer contracts with: `name` for the statements, `legalName`/`address`/`email`
+ * for the mails and the withdrawal information) is backend-only as well.
+ *
+ * @throws ConsumerRightsError (`policy:<field>`) — see `assertConsumerRightsPolicy`; `policy:trader`
+ * when a mechanism is on and no trader `name` and `legalName` are declared.
+ */
+export declare const declareConsumerRights: (cfg: Config, def: ConsumerRightsDef) => ConsumerRightsPolicy;
 //# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAe,cAAc,EAAkB,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAExG,eAAO,MAAM,qBAAqB,QAAS,MAAM,OAAO,iBAAiB,KAAG,IAS3E,CAAA;AAED,eAAO,MAAM,kBAAkB,QAAS,MAAM,OAAO,cAAc,KAAG,IA4BrE,CAAA;AAED,eAAO,MAAM,aAAa,QAAS,MAAM,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KAAG,IAEpF,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,oBAAoB,EAA6C,MAAM,mBAAmB,CAAA;AAKxG,OAAO,KAAK,EACV,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAkB,iBAAiB,EAAE,iBAAiB,EAC5G,UAAU,EAAE,gBAAgB,EAC7B,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,qBAAqB,QAAS,MAAM,OAAO,iBAAiB,KAAG,IAS3E,CAAA;AA8BD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAS,MAAM,OAAO,cAAc,KAAG,IA+CrE,CAAA;AAgDD,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,IAwBpE,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,QAAS,MAAM,OAAO,iBAAiB,KAAG,oBAsC3E,CAAA"}

package/build/config.js

@@ -1,7 +1,7 @@
 import { toConfigRecord } from '@owlmeans/server-app';
-import { plugin } from '@owlmeans/config';
-import { assertAmountCheckoutPolicy, assertQuantityCheckoutPolicy, CheckoutPricingMode, PLAN_RECORD_PREFIX, PLAN_RECORD_TYPE, PlanStatus, PRODUCT_RECORD_PREFIX, PRODUCT_RECORD_TYPE, } from '@owlmeans/payment';
-import { STRIPE_PAYGATE_ALIAS, STRIPE_PLUGIN_CONFIG } from './consts.js';
+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, LimitWindow, 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 { CONSUMER_RIGHTS_MAIL_PLUGIN_CONFIG, STRIPE_PAYGATE_ALIAS, STRIPE_PLUGIN_CONFIG, STRIPE_PORTAL_PLUGIN_CONFIG, STRIPE_PRICING_PLUGIN_CONFIG, } from './consts.js';
 export const declarePaymentProduct = (cfg, def) => {
     cfg.records = cfg.records ?? [];
     const product = {
@@ -12,8 +12,52 @@ export const declarePaymentProduct = (cfg, def) => {
     };
     cfg.records.push({ ...toConfigRecord(product), recordType: PRODUCT_RECORD_TYPE, id: `${PRODUCT_RECORD_PREFIX}:${def.sku}` });
 };
+const isSafeCount = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+const LIMIT_KINDS = Object.values(LimitKind);
+const LIMIT_WINDOWS = Object.values(LimitWindow);
+const assertLimitDeclaration = (key, limit) => {
+    if (!LIMIT_KINDS.includes(limit.kind)) {
+        throw new LimitMisdeclared(`${key}:kind`);
+    }
+    if (limit.kind === LimitKind.Window) {
+        if (limit.window == null) {
+            throw new LimitMisdeclared(`${key}:window-missing`);
+        }
+        if (!LIMIT_WINDOWS.includes(limit.window)) {
+            throw new LimitMisdeclared(`${key}:window`);
+        }
+    }
+    else if (limit.window != null) {
+        throw new LimitMisdeclared(`${key}:window-forbidden`);
+    }
+    if (!isSafeCount(limit.limit)) {
+        throw new LimitMisdeclared(`${key}:limit`);
+    }
+    if (limit.promo != null && !(limit.promo.until instanceof Date && !Number.isNaN(limit.promo.until.getTime()))) {
+        throw new LimitMisdeclared(`${key}:promo-until`);
+    }
+};
+/**
+ * Declare a plan into the configuration catalogue.
+ *
+ * Validated before anything is pushed: `rank` a safe integer `>= 0`; a `free` plan costs nothing
+ * and is sold through no gateway; no capability set under the reserved `limit` scope; every limit
+ * well-formed (a `window` limit names its window, the others do not, the ceiling is a safe
+ * integer, a promo ends at a real `Date`). Amount and quantity policies are asserted as before.
+ */
 export const declarePaymentPlan = (cfg, def) => {
-    cfg.records = cfg.records ?? [];
+    if (def.rank != null && !isSafeCount(def.rank)) {
+        throw new PlanRankConflict(`rank:${def.sku}`);
+    }
+    if (def.free === true && (def.price !== 0 || (def.gateways ?? []).length > 0)) {
+        throw new PlanRankConflict(`free:${def.sku}`);
+    }
+    if ((def.capabilities ?? []).some(set => set.scope === CAPABILITY_LIMIT_SCOPE)) {
+        throw new LimitMisdeclared(`${def.sku}:reserved-scope`);
+    }
+    for (const [key, limit] of Object.entries(def.limits ?? {})) {
+        assertLimitDeclaration(key, limit);
+    }
     const pricingMode = def.pricingMode;
     if (pricingMode === CheckoutPricingMode.Amount) {
         if (def.amountPolicy == null)
@@ -29,18 +73,206 @@ export const declarePaymentPlan = (cfg, def) => {
         : undefined);
     if (quantityPolicy != null)
         assertQuantityCheckoutPolicy(quantityPolicy);
+    const currencyPrices = currencyPricesOf(def);
+    assertWithdrawalComponents(def);
+    cfg.records = cfg.records ?? [];
     const plan = {
         productSku: def.productSku, sku: def.sku, status: PlanStatus.Active,
+        ...(def.rank != null ? { rank: def.rank } : {}),
+        ...(def.free === true ? { free: true, gateways: [] } : def.gateways != null ? { gateways: def.gateways } : {}),
         duration: def.duration, price: def.price, currency: def.currency ?? def.amountPolicy?.currency ?? 'usd',
         order: def.order ?? 0, title: def.title ?? def.sku, capabilities: def.capabilities,
         limits: def.limits, recurring: def.recurring, pricingMode, amountPolicy: def.amountPolicy,
         quantityPolicy,
         minQuantity: quantityPolicy?.minimum, maxQuantity: quantityPolicy?.maximum,
         defaultQuantity: quantityPolicy?.default,
+        ...(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}` });
 };
+const CURRENCY = /^[a-z]{3}$/;
+/** `currencyPrices` normalized to lowercase codes; each a positive amount of whole minor units. */
+const currencyPricesOf = (def) => {
+    if (def.currencyPrices == null) {
+        return undefined;
+    }
+    if (def.pricingMode === CheckoutPricingMode.Amount || def.free === true) {
+        throw new ProductError(`currency-prices:${def.sku}:mode`);
+    }
+    const prices = {};
+    for (const [raw, amount] of Object.entries(def.currencyPrices)) {
+        const currency = raw.toLowerCase();
+        const minor = Math.round(amount * 100);
+        if (!CURRENCY.test(currency) || !Number.isFinite(amount) || amount <= 0 || !Number.isSafeInteger(minor)
+            || Math.abs(minor - amount * 100) > 1e-6 || prices[currency] != null) {
+            throw new ProductError(`currency-prices:${def.sku}:${raw}`);
+        }
+        prices[currency] = amount;
+    }
+    return prices;
+};
+/** The components' shares must add up to the plan's price in minor units. */
+const assertWithdrawalComponents = (def) => {
+    const components = def.withdrawal?.components;
+    if (components == null) {
+        return;
+    }
+    const keys = new Set();
+    let sum = 0;
+    for (const component of components) {
+        if (typeof component.key !== 'string' || component.key === '' || keys.has(component.key)
+            || (component.basis !== 'time' && component.basis !== 'units')
+            || !Number.isSafeInteger(component.shareMinor) || component.shareMinor < 0) {
+            throw new ProductError(`withdrawal:${def.sku}:component`);
+        }
+        keys.add(component.key);
+        sum += component.shareMinor;
+    }
+    if (components.length === 0 || sum !== Math.round(def.price * 100)) {
+        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.
+ */
 export const stripeSecrets = (cfg, paths) => {
-    plugin(cfg, { api: paths.api, webhook: paths.webhook }, STRIPE_PLUGIN_CONFIG);
+    plugin(cfg, {
+        api: paths.api, ...(paths.webhook != null && paths.webhook !== '' ? { webhook: paths.webhook } : {}),
+    }, STRIPE_PLUGIN_CONFIG);
+};
+/** Branding and the default return URL of the managed customer portal configuration. */
+export const portalBranding = (cfg, def) => {
+    plugin(cfg, {
+        returnUrl: def.returnUrl,
+        ...(def.headline != null ? { headline: def.headline } : {}),
+        ...(def.privacyPolicyUrl != null ? { privacyPolicyUrl: def.privacyPolicyUrl } : {}),
+        ...(def.termsOfServiceUrl != null ? { termsOfServiceUrl: def.termsOfServiceUrl } : {}),
+    }, STRIPE_PORTAL_PLUGIN_CONFIG);
+};
+/**
+ * Declare the pricing policy: whether checkout collects tax and a VAT/GST id, what `tax_behavior`
+ * synced prices are given, Adaptive Pricing, and whether the estimate endpoints are served. A
+ * config never carries more than one — a second call replaces the first, so re-declaring (a test, a
+ * config module re-run) is safe rather than silently ignored (a config resource resolves an id to
+ * its FIRST match).
+ *
+ * `def.stripe` (the FX Quotes preview version, the unspecified-price migration switch) is
+ * Stripe-only and goes to a backend plugin, never the advertised `PricingPolicy` record.
+ *
+ * @throws PaymentError (`assertPricingPolicy`) when an estimate is declared without the tax or
+ * currency capability it requires.
+ */
+export const declarePaymentPricing = (cfg, def) => {
+    const { stripe, ...policy } = def;
+    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,
+    });
+    if (stripe != null) {
+        const settlementCurrency = stripe.settlementCurrency?.toLowerCase();
+        if (settlementCurrency != null && !/^[a-z]{3}$/.test(settlementCurrency)) {
+            throw new PaymentError('pricing-policy:settlement-currency');
+        }
+        const subscriptionPaymentMethodTypes = stripe.subscriptionPaymentMethodTypes?.map(type => type.toLowerCase());
+        if (subscriptionPaymentMethodTypes != null && (subscriptionPaymentMethodTypes.length === 0
+            || subscriptionPaymentMethodTypes.some(type => !/^[a-z][a-z0-9_]*$/.test(type))
+            || new Set(subscriptionPaymentMethodTypes).size !== subscriptionPaymentMethodTypes.length)) {
+            throw new PaymentError('pricing-policy:subscription-payment-methods');
+        }
+        plugin(cfg, {
+            ...stripe,
+            ...(settlementCurrency != null ? { settlementCurrency } : {}),
+            ...(subscriptionPaymentMethodTypes != null ? { subscriptionPaymentMethodTypes } : {}),
+        }, STRIPE_PRICING_PLUGIN_CONFIG);
+    }
+};
+/**
+ * Declare the consumer-rights policy (EU withdrawal, spend consent, start requests, cancellation,
+ * country lock) — a singleton config record like the pricing policy: `DEFAULT_CONSUMER_RIGHTS`
+ * filled in, asserted, and replacing any earlier declaration. It is ADVERTISED to the browser; the
+ * `mail` options (mailer alias, sender, archive copies) go to a backend-only plugin config.
+ *
+ * `trader` (who the consumer contracts with: `name` for the statements, `legalName`/`address`/`email`
+ * for the mails and the withdrawal information) is backend-only as well.
+ *
+ * @throws ConsumerRightsError (`policy:<field>`) — see `assertConsumerRightsPolicy`; `policy:trader`
+ * when a mechanism is on and no trader `name` and `legalName` are declared.
+ */
+export const declareConsumerRights = (cfg, def) => {
+    const { mail, trader, ...declaration } = def;
+    const policy = makeConsumerRightsPolicy(declaration);
+    const anyMechanism = Object.values(policy.mechanisms).some(on => on === true);
+    if (anyMechanism && (trader?.name == null || trader.name.trim() === '' || trader.legalName == null
+        || trader.legalName.trim() === '')) {
+        throw new ConsumerRightsError('policy:trader');
+    }
+    if (mail?.bcc?.some(address => !/^[^\s@]+@[^\s@]+$/.test(address)) === true) {
+        throw new ConsumerRightsError('policy:mail-bcc');
+    }
+    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,
+    });
+    const plugins = cfg[PLUGIN_RECORD];
+    if (plugins != null) {
+        cfg[PLUGIN_RECORD] = plugins
+            .filter(record => record.id !== CONSUMER_RIGHTS_MAIL_PLUGIN_CONFIG);
+    }
+    if (mail != null || trader != null) {
+        plugin(cfg, {
+            ...(trader != null ? {
+                trader: {
+                    name: trader.name.trim(), legalName: trader.legalName.trim(),
+                    ...(trader.address != null && trader.address.trim() !== '' ? { address: trader.address.trim() } : {}),
+                    ...(trader.email != null && trader.email.trim() !== '' ? { email: trader.email.trim() } : {}),
+                    ...(trader.website != null && trader.website.trim() !== '' ? { website: trader.website.trim() } : {}),
+                },
+            } : {}),
+            ...(mail?.alias != null ? { alias: mail.alias } : {}),
+            ...(mail?.from != null ? { from: mail.from } : {}),
+            ...(mail?.replyTo != null ? { replyTo: mail.replyTo } : {}),
+            ...(mail?.bcc != null && mail.bcc.length > 0 ? { bcc: [...mail.bcc] } : {}),
+        }, CONSUMER_RIGHTS_MAIL_PLUGIN_CONFIG);
+    }
+    return policy;
 };
 //# sourceMappingURL=config.js.map

package/build/config.js.map

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

package/build/consts.d.ts

@@ -1,26 +1,98 @@
+import { INTERNAL_PAYGATE, LIMIT_GATE } from '@owlmeans/payment';
+export { INTERNAL_PAYGATE, LIMIT_GATE };
 export declare const STRIPE_PAYGATE_ALIAS = "stripe";
 export declare const STRIPE_PLUGIN_CONFIG = "_external:stripe";
+export declare const STRIPE_PORTAL_PLUGIN_CONFIG = "_external:stripe-portal";
+/** Stripe-only pricing settings (FX Quotes API version, the unspecified-price migration switch) — never advertised to the browser, unlike the `PricingPolicy` record itself. */
+export declare const STRIPE_PRICING_PLUGIN_CONFIG = "_external:stripe-pricing";
 export declare const STRIPE_SIGNATURE = "Stripe-Signature";
+/**
+ * The FX Quotes API is a Stripe PREVIEW endpoint as of this writing: it answers only a
+ * `Stripe-Version` header naming a preview version, never the SDK's pinned stable one. Verify this
+ * string against https://docs.stripe.com/api/fx_quotes/create before relying on it, and override it
+ * with `declarePaymentPricing({ stripe: { fxApiVersion } })` once Stripe moves the API or renames
+ * the preview.
+ */
+export declare const STRIPE_FX_QUOTES_API_VERSION = "2025-07-30.preview";
 export declare const GATEWAY_SERVICE = "payment-gateway";
 export declare const PAYMENT_OBSERVER = "payment-observer";
+export declare const ENTITLEMENT_SERVICE = "payment-entitlement";
 export declare const RES_PAYGATE_CUSTOMER = "payment-paygate-customer";
 export declare const RES_PAYMENT_SUBSCRIPTION = "payment-subscription";
+export declare const RES_PAYMENT_FULFILLMENT = "payment-fulfillment";
+export declare const RES_PAYMENT_WEBHOOK = "payment-webhook";
+export declare const RES_PAYMENT_USAGE = "payment-usage";
+export declare const RES_PAYMENT_USAGE_COUNTER = "payment-usage-counter";
 export declare const RES_PAYMENT_FINGERPRINT = "payment-fingerprint";
-export declare const COMPLETION_TOP_UP = "top-up";
-export declare const COMPLETION_SUBSCRIPTION = "subscription";
+/** One per organization: the billing country fixed at the first purchase. */
+export declare const RES_BILLING_PROFILE = "payment-billing-profile";
+/** One per paid checkout (a top-up, a subscription's first invoice): the contract and its window. */
+export declare const RES_PAYMENT_PURCHASE = "payment-purchase";
+/** Append-only: express consents to early performance and subscription start requests. */
+export declare const RES_CONSUMER_CONSENT = "payment-consumer-consent";
+/** Append-only: withdrawal and cancellation declarations. */
+export declare const RES_CONSUMER_DECLARATION = "payment-consumer-declaration";
+/** Append-only: every execution and audit step of the consumer-rights flows. */
+export declare const RES_CONSUMER_EVENT = "payment-consumer-event";
+export declare const CONSUMER_RIGHTS_SERVICE = "payment-consumer-rights";
+/** The consumer-rights mail options (trader, sender, archive copies) — never advertised. */
+export declare const CONSUMER_RIGHTS_MAIL_PLUGIN_CONFIG = "_external:payment-consumer-mail";
+/** Stripe's own bounds of a Checkout Session's `expires_at`, from now. */
+export declare const STRIPE_SESSION_TTL_MIN_SECONDS: number;
+export declare const STRIPE_SESSION_TTL_MAX_SECONDS: number;
+/** How far back `reconcile` looks for completed sessions that have no purchase row. */
+export declare const PURCHASE_BACKFILL_DAYS = 16;
+/** Top-level domains that never receive mail (RFC 2606 / 6761) — e2e addresses are recorded as skipped. */
+export declare const RESERVED_MAIL_TLDS: readonly string[];
+/** The purchase id prefix of a Stripe purchase: `stripe:<session id>` or `stripe:<subscription id>`. */
+export declare const PURCHASE_ID_PREFIX = "stripe";
+/**
+ * The contract reference alphabet: digits and capitals without the look-alikes 0/O, 1/I/L, so a
+ * reference read aloud or typed from paper is never ambiguous.
+ */
+export declare const CONTRACT_REF_ALPHABET = "23456789ABCDEFGHJKMNPQRSTUVWXYZ";
+/** Fingerprint sku prefix of a portal configuration: `portal:<service>`. */
+export declare const FINGERPRINT_PORTAL = "portal";
+/**
+ * The metadata every Stripe object this package creates carries (`{ owlmeans: 'payment', service }`).
+ * It labels the object for an operator; several deployments of one service share it, so it never
+ * decides on its own that an object belongs to this deployment.
+ */
+export declare const STRIPE_OWNER_KEY = "owlmeans";
+export declare const STRIPE_OWNER_VALUE = "payment";
+/**
+ * The metadata key naming the ONE deployment a portal configuration belongs to, valued with that
+ * deployment's webhook URL (`webhookUrlOf`). Only an exact match lets a deployment adopt a
+ * configuration it holds no fingerprint row for.
+ */
+export declare const STRIPE_DEPLOYMENT_KEY = "deployment";
+/**
+ * Every Stripe event the managed webhook endpoint subscribes to.
+ *
+ * `invoice.upcoming` is enabled although nothing handles it (it carries no invoice id and nothing
+ * is due), so an application can observe it without a Stripe dashboard change.
+ */
+export declare const WEBHOOK_EVENTS: readonly string[];
 export interface PaygateParams {
     paygate: string;
 }
 export interface ResyncResult {
     ok: boolean;
 }
+export interface ResyncSubscriptionsResult {
+    scanned: number;
+    updated: number;
+}
 /** Embedded gateway protocol tree; the alias strings are private adapter details. */
 export declare const paymentGate: {
     readonly base: import("@owlmeans/entrypoint").EntrypointProtocol<{}, undefined>;
+    /** Public: Stripe signs the raw body, so no application guard may sit in front of it. */
     readonly webhook: import("@owlmeans/entrypoint").EntrypointProtocol<{
         params: PaygateParams;
     }, undefined>;
+    /** Re-sync products, prices, the portal configuration and the webhook endpoint. */
     readonly resync: import("@owlmeans/entrypoint").EntrypointProtocol<{}, ResyncResult>;
+    /** Re-read every live paygate subscription and apply it as a webhook would. */
+    readonly resyncSubscriptions: import("@owlmeans/entrypoint").EntrypointProtocol<{}, ResyncSubscriptionsResult>;
 };
-export declare const paymentGateProtocols: import("@owlmeans/entrypoint").EntrypointProtocolDeclaration[];
 //# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,oBAAoB,WAAW,CAAA;AAC5C,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AACtD,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAClD,eAAO,MAAM,eAAe,oBAAoB,CAAA;AAChD,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAClD,eAAO,MAAM,oBAAoB,6BAA6B,CAAA;AAC9D,eAAO,MAAM,wBAAwB,yBAAyB,CAAA;AAC9D,eAAO,MAAM,uBAAuB,wBAAwB,CAAA;AAC5D,eAAO,MAAM,iBAAiB,WAAW,CAAA;AACzC,eAAO,MAAM,uBAAuB,iBAAiB,CAAA;AAErD,MAAM,WAAW,aAAa;IAAG,OAAO,EAAE,MAAM,CAAA;CAAE;AAClD,MAAM,WAAW,YAAY;IAAG,EAAE,EAAE,OAAO,CAAA;CAAE;AAe7C,qFAAqF;AACrF,eAAO,MAAM,WAAW;;;;;;CAWd,CAAA;AAEV,eAAO,MAAM,oBAAoB,gEAAyB,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGhE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAA;AAEvC,eAAO,MAAM,oBAAoB,WAAW,CAAA;AAC5C,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AACtD,eAAO,MAAM,2BAA2B,4BAA4B,CAAA;AACpE,gLAAgL;AAChL,eAAO,MAAM,4BAA4B,6BAA6B,CAAA;AACtE,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,uBAAuB,CAAA;AAChE,eAAO,MAAM,eAAe,oBAAoB,CAAA;AAChD,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAClD,eAAO,MAAM,mBAAmB,wBAAwB,CAAA;AAExD,eAAO,MAAM,oBAAoB,6BAA6B,CAAA;AAC9D,eAAO,MAAM,wBAAwB,yBAAyB,CAAA;AAC9D,eAAO,MAAM,uBAAuB,wBAAwB,CAAA;AAC5D,eAAO,MAAM,mBAAmB,oBAAoB,CAAA;AACpD,eAAO,MAAM,iBAAiB,kBAAkB,CAAA;AAChD,eAAO,MAAM,yBAAyB,0BAA0B,CAAA;AAChE,eAAO,MAAM,uBAAuB,wBAAwB,CAAA;AAE5D,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,4BAA4B,CAAA;AAC5D,qGAAqG;AACrG,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AACtD,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,6BAA6B,CAAA;AAC9D,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,iCAAiC,CAAA;AACtE,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAE1D,eAAO,MAAM,uBAAuB,4BAA4B,CAAA;AAChE,4FAA4F;AAC5F,eAAO,MAAM,kCAAkC,oCAAoC,CAAA;AAEnF,0EAA0E;AAC1E,eAAO,MAAM,8BAA8B,QAAU,CAAA;AACrD,eAAO,MAAM,8BAA8B,QAAe,CAAA;AAE1D,uFAAuF;AACvF,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAExC,2GAA2G;AAC3G,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA+D,CAAA;AAE/G,wGAAwG;AACxG,eAAO,MAAM,kBAAkB,WAAW,CAAA;AAE1C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,oCAAoC,CAAA;AAEtE,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,WAAW,CAAA;AAE1C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAC1C,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAY1C,CAAA;AAEF,MAAM,WAAW,aAAa;IAAG,OAAO,EAAE,MAAM,CAAA;CAAE;AAClD,MAAM,WAAW,YAAY;IAAG,EAAE,EAAE,OAAO,CAAA;CAAE;AAC7C,MAAM,WAAW,yBAAyB;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAyB/E,qFAAqF;AACrF,eAAO,MAAM,WAAW;;IAEtB,yFAAyF;;;;IAKzF,mFAAmF;;IAMnF,+EAA+E;;CAMvE,CAAA"}