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

package/build/consumer/records.js

@@ -0,0 +1,296 @@
+import { billingLanguageOf, chargeCurrencyOf, ConsumerRegion, ConsumerRightsError, ENTITLING_STATUSES, inScope, PurchaseKind, regionOf, withdrawalOpen, } from '@owlmeans/payment';
+import { PURCHASE_ID_PREFIX, STRIPE_PAYGATE_ALIAS } from '../consts.js';
+import { billingProfiles, compact, conditionalDelete, consumerEvents, fulfillments, isDuplicateKey, paygateCustomers, purchases, stripePricingConfig, subscriptions, } from '../utils.js';
+import { makeContractRef, normalizeEmail } from './format.js';
+export const purchaseIdOf = (externalId) => `${PURCHASE_ID_PREFIX}:${externalId}`;
+/** A locked profile as the wire sees it. */
+export const profileViewOf = (record, policy) => ({
+    country: record.country,
+    region: record.region,
+    currency: record.currency,
+    locked: true,
+    lockedAt: new Date(record.lockedAt),
+    language: record.language,
+    inScope: inScope(record.region, record.country, policy),
+});
+/** No profile yet: nothing locked, the default legal language, an unknown buyer (protected by default). */
+export const unlockedProfileView = (policy) => ({
+    country: null,
+    region: null,
+    currency: null,
+    locked: false,
+    language: policy?.defaultLanguage ?? 'en',
+    inScope: inScope(null, null, policy),
+});
+/**
+ * Append one audit step. A failure to write it is logged and never fails the act it describes —
+ * the act's own record (consent, declaration, purchase) is already written.
+ */
+export const recordEvent = async (ctx, event) => {
+    try {
+        await consumerEvents(ctx).create(compact({ ...event, at: event.at ?? new Date() }));
+    }
+    catch (error) {
+        console.error(`[payment] consumer event "${event.action}" of "${event.recordId}" not recorded`, error);
+    }
+};
+/** Whether a step already succeeded (or a mail was deliberately skipped) for a record. */
+export const hasEvent = async (ctx, recordId, action, step, ok) => await consumerEvents(ctx).load(compact({
+    recordId, action, ...(step != null ? { step } : {}), ...(ok != null ? { ok } : {}),
+})) != null;
+/** The currency of the entity's entitling Stripe subscription — two of one customer cannot differ. */
+export const activeSubscriptionCurrency = async (ctx, entityId) => {
+    const row = await entitlingStripeSubscription(ctx, entityId);
+    return row?.currency ?? undefined;
+};
+/** The entity's highest-ranked entitling Stripe subscription, or `null`. */
+export const entitlingStripeSubscription = async (ctx, entityId) => await subscriptions(ctx).load({ entityId, paygate: STRIPE_PAYGATE_ALIAS, status: [...ENTITLING_STATUSES] }, { sort: [{ field: 'rank', order: 'desc' }, { field: 'createdAt', order: 'desc' }] });
+/** Whether the entity ever paid through the paygate (a fulfilled checkout or a propagated subscription). */
+export const hasPaid = async (ctx, entityId) => await fulfillments(ctx).load({ entityId, paygate: STRIPE_PAYGATE_ALIAS, fulfilledAt: { $exists: true } }) != null
+    || await subscriptions(ctx).load({ entityId, paygate: STRIPE_PAYGATE_ALIAS, initialPropagatedAt: { $exists: true } }) != null;
+/**
+ * Fix an entity's billing country — the FIRST write wins (a unique index on `entityId` settles a
+ * race). A later, different country is only a `lock-mismatch` event; only a `manual` lock with
+ * `force` replaces the country, audited as `relock`. The charge currency is fixed with it: the
+ * currency of an entitling paygate subscription when one exists (a customer's subscriptions share
+ * one currency), else the region's (`policy.currencies`), else the given one.
+ */
+export const lockProfile = async (ctx, policy, input) => {
+    const country = input.country.trim().toUpperCase();
+    if (!/^[A-Z]{2}$/.test(country)) {
+        throw new ConsumerRightsError(`lock:country:${input.country}`);
+    }
+    const resource = billingProfiles(ctx);
+    const now = new Date();
+    const existing = await resource.byEntity(input.entityId);
+    if (existing != null) {
+        return await compareLock(ctx, policy, existing, input, country, now);
+    }
+    const region = regionOf(country, policy) ?? ConsumerRegion.Other;
+    const settlement = (await stripePricingConfig(ctx))?.settlementCurrency?.toLowerCase();
+    const currency = (await activeSubscriptionCurrency(ctx, input.entityId))
+        ?? (policy?.currencies != null && Object.keys(policy.currencies).length > 0
+            ? chargeCurrencyOf(region, policy, input.currency ?? settlement ?? 'usd')
+            : input.currency ?? settlement ?? 'usd');
+    const record = compact({
+        entityId: input.entityId,
+        country,
+        region,
+        currency: currency.toLowerCase(),
+        language: input.language ?? billingLanguageOf(country, policy),
+        source: input.source,
+        paygate: STRIPE_PAYGATE_ALIAS,
+        customerId: input.customerId,
+        sessionId: input.sessionId,
+        ipCountry: input.ipCountry?.toUpperCase(),
+        email: input.email,
+        name: input.name,
+        business: input.business,
+        lockedAt: now,
+        createdAt: now,
+    });
+    try {
+        const created = await resource.create(record);
+        await recordEvent(ctx, {
+            recordId: input.entityId, recordKind: 'profile', entityId: input.entityId, action: 'lock', ok: true,
+            detail: JSON.stringify(compact({
+                source: input.source, country, currency: created.currency, sessionId: input.sessionId,
+                ipCountry: input.ipCountry?.toUpperCase(),
+                ipMismatch: input.ipCountry != null ? input.ipCountry.toUpperCase() !== country : undefined,
+                by: input.by, reason: input.reason,
+            })),
+        });
+        return { record: created, created: true, mismatch: false };
+    }
+    catch (error) {
+        if (!isDuplicateKey(error)) {
+            throw error;
+        }
+        const winner = await resource.byEntity(input.entityId);
+        if (winner == null) {
+            throw error;
+        }
+        return await compareLock(ctx, policy, winner, input, country, now);
+    }
+};
+const compareLock = async (ctx, policy, existing, input, country, now) => {
+    if (input.source === 'manual' && input.force === true) {
+        const region = regionOf(country, policy) ?? ConsumerRegion.Other;
+        const updated = await billingProfiles(ctx).update(compact({
+            ...existing,
+            country,
+            region,
+            currency: (input.currency ?? (country === existing.country ? existing.currency
+                : chargeCurrencyOf(region, policy, existing.currency))).toLowerCase(),
+            language: input.language ?? (country === existing.country ? existing.language : billingLanguageOf(country, policy)),
+            source: 'manual',
+            updatedAt: now,
+        }));
+        await recordEvent(ctx, {
+            recordId: existing.entityId, recordKind: 'profile', entityId: existing.entityId, action: 'relock', ok: true,
+            detail: JSON.stringify(compact({
+                from: existing.country, to: country, currency: updated.currency, by: input.by, reason: input.reason,
+            })),
+        });
+        return { record: updated, created: false, mismatch: false };
+    }
+    const mismatch = existing.country !== country;
+    if (mismatch) {
+        await recordEvent(ctx, {
+            recordId: existing.entityId, recordKind: 'profile', entityId: existing.entityId, action: 'lock-mismatch',
+            ok: true,
+            detail: JSON.stringify(compact({
+                locked: existing.country, observed: country, source: input.source, sessionId: input.sessionId,
+                ipCountry: input.ipCountry,
+            })),
+        });
+    }
+    return { record: existing, created: false, mismatch };
+};
+/**
+ * An operator removes an entity's lock: the profile row is deleted (only while it still holds the
+ * country read — a concurrent relock survives) and an `unlock` event keeps the whole row, `by` and
+ * `reason`. `null` when nothing was locked.
+ */
+export const unlockProfile = async (ctx, entityId, opts = {}) => {
+    const resource = billingProfiles(ctx);
+    const existing = await resource.byEntity(entityId);
+    if (existing == null) {
+        return null;
+    }
+    if (!await conditionalDelete(resource, { entityId, country: existing.country })) {
+        throw new ConsumerRightsError(`unlock:changed:${entityId}`);
+    }
+    const { id: _id, ...row } = existing;
+    await recordEvent(ctx, {
+        recordId: entityId, recordKind: 'profile', entityId, action: 'unlock', ok: true,
+        detail: JSON.stringify(compact({ from: existing.country, by: opts.by, reason: opts.reason, profile: row })),
+    });
+    return existing;
+};
+/**
+ * Whether an operator unlocked the entity — then no lock is taken from its paygate customer's saved
+ * address (at checkout or in reconcile): its next completed purchase locks it.
+ */
+export const wasUnlocked = async (ctx, entityId) => await hasEvent(ctx, entityId, 'unlock');
+/** Inside its window at `at`: in scope, before the deadline, neither withdrawn from nor refunded. */
+export const windowOpen = (purchase, at = new Date()) => purchase.inScope && withdrawalOpen({
+    deadline: purchase.deadline != null ? new Date(purchase.deadline) : null,
+    withdrawnAt: purchase.withdrawnAt ?? null,
+    refundedAt: purchase.refundedAt ?? null,
+}, at);
+export const purchaseViewOf = (purchase, withdrawable) => compact({
+    purchaseId: purchase.purchaseId,
+    contractRef: purchase.contractRef,
+    kind: purchase.kind,
+    purchasedAt: new Date(purchase.purchasedAt),
+    deadline: purchase.deadline != null ? new Date(purchase.deadline) : undefined,
+    productSku: purchase.productSku,
+    planSku: purchase.planSku ?? undefined,
+    amountTotalMinor: purchase.amountTotalMinor,
+    currency: purchase.currency,
+    consentedAt: purchase.consentedAt != null ? new Date(purchase.consentedAt) : undefined,
+    withdrawnAt: purchase.withdrawnAt != null ? new Date(purchase.withdrawnAt) : undefined,
+    withdrawable,
+});
+export const purchaseRefOf = (purchase) => compact({
+    purchaseId: purchase.purchaseId,
+    kind: purchase.kind,
+    entityId: purchase.entityId,
+    contractRef: purchase.contractRef,
+    productSku: purchase.productSku,
+    planSku: purchase.planSku ?? undefined,
+    sessionId: purchase.sessionId ?? undefined,
+    subscriptionId: purchase.subscriptionId ?? undefined,
+    invoiceId: purchase.invoiceId ?? undefined,
+    purchasedAt: new Date(purchase.purchasedAt),
+});
+/** The open, unconsented top-up windows of an entity — what a performance consent covers. */
+export const unconsentedWindows = async (ctx, entityId, at = new Date()) => (await purchases(ctx).list({
+    entityId, inScope: true, kind: PurchaseKind.TopUp, consentedAt: null, withdrawnAt: null, refundedAt: null,
+    deadline: { $gt: at },
+}, { size: 100, sort: [{ field: 'deadline', order: 'desc' }] })).items;
+const CONTRACT_REF_ATTEMPTS = 6;
+/**
+ * Write a purchase once: an existing row for the same purchase (or the same checkout session) is
+ * returned as it is. A contract-reference collision retries with a fresh reference.
+ */
+export const createPurchase = async (ctx, draft) => {
+    const resource = purchases(ctx);
+    const existing = await resource.byPurchaseId(draft.purchaseId)
+        ?? (draft.sessionId != null ? await resource.load({ sessionId: draft.sessionId }) : null);
+    if (existing != null) {
+        return { record: existing, created: false };
+    }
+    let last = null;
+    for (let attempt = 0; attempt < CONTRACT_REF_ATTEMPTS; attempt++) {
+        try {
+            const record = await resource.create(compact({
+                ...draft, contractRef: makeContractRef(new Date(draft.purchasedAt)), createdAt: new Date(),
+            }));
+            return { record, created: true };
+        }
+        catch (error) {
+            if (!isDuplicateKey(error)) {
+                throw error;
+            }
+            last = error;
+            const winner = await resource.byPurchaseId(draft.purchaseId)
+                ?? (draft.sessionId != null ? await resource.load({ sessionId: draft.sessionId }) : null);
+            if (winner != null) {
+                return { record: winner, created: false };
+            }
+        }
+    }
+    console.error('[payment] no free contract reference after retries', last);
+    throw new ConsumerRightsError('contract-ref');
+};
+/** Set fields on a purchase without replacing it (a concurrent conditional write survives). */
+export const patchPurchase = async (ctx, purchaseId, fields) => {
+    const set = Object.fromEntries(Object.entries({ ...fields, updatedAt: new Date() }).filter(([, value]) => value !== undefined));
+    const resource = purchases(ctx);
+    const collection = resource.collection;
+    if (collection?.updateOne != null) {
+        await collection.updateOne({ purchaseId }, { $set: set });
+        return;
+    }
+    const current = await resource.byPurchaseId(purchaseId);
+    if (current != null) {
+        await resource.update({ ...current, ...set });
+    }
+};
+/** The e-mail a consumer-rights mail reaches the organization at when no person named one. */
+export const contactEmailOf = async (ctx, entityId) => {
+    const profile = await billingProfiles(ctx).byEntity(entityId);
+    if (profile?.email != null && profile.email !== '') {
+        return profile.email;
+    }
+    const latest = await purchases(ctx).load({ entityId, email: { $exists: true } }, {
+        sort: [{ field: 'purchasedAt', order: 'desc' }],
+    });
+    if (latest?.email != null && latest.email !== '') {
+        return latest.email;
+    }
+    const customer = await paygateCustomers(ctx).byEntity(entityId, STRIPE_PAYGATE_ALIAS);
+    return customer?.email ?? undefined;
+};
+/**
+ * Whether an e-mail address belongs to a purchase: its checkout e-mail, the organization's
+ * profile e-mail or its paygate customer's — compared case-insensitively.
+ */
+export const emailMatches = async (ctx, purchase, email) => {
+    const wanted = normalizeEmail(email);
+    if (wanted === '') {
+        return false;
+    }
+    if (normalizeEmail(purchase.email) === wanted) {
+        return true;
+    }
+    const profile = await billingProfiles(ctx).byEntity(purchase.entityId);
+    if (normalizeEmail(profile?.email) === wanted) {
+        return true;
+    }
+    const customer = await paygateCustomers(ctx).byEntity(purchase.entityId, STRIPE_PAYGATE_ALIAS);
+    return normalizeEmail(customer?.email) === wanted;
+};
+//# sourceMappingURL=records.js.map

package/build/consumer/records.js.map

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

package/build/consumer/service.d.ts

@@ -0,0 +1,51 @@
+import type Stripe from 'stripe';
+import { CancellationStatus, WithdrawalStatus } from '@owlmeans/payment';
+import type { Context as ApiContext } from '@owlmeans/server-api';
+import type { WithdrawalComputation, WithdrawalExecution } from './withdrawal.js';
+import type { Config, ConsumerConsentRecord, ConsumerDeclarationRecord, ConsumerRightsOptions, ConsumerRightsService, Context, PaymentSubscriptionRecord, PurchaseRecord, UsageMeter } from '../types.js';
+export interface ConsumerRightsInternals {
+    readonly managed: boolean;
+    meter: () => UsageMeter | null;
+    stripe: (ctx: ApiContext) => Promise<Stripe>;
+}
+/** Who hands a registration its options: the application itself, or the gateway on its behalf. */
+export type ConsumerRightsRegistrar = 'application' | 'gateway';
+/** Run the consumer-rights observers of one act; a throw is recorded for `reconcile` to retry. */
+export declare const runConsumerObservers: (ctx: ApiContext, family: 'consent' | 'withdrawal' | 'cancellation', recordId: string, entityId: string | undefined, run: () => Promise<void>) => Promise<boolean>;
+/** Tell the withdrawal observers — after the records and the paygate steps. */
+export declare const notifyWithdrawal: (ctx: ApiContext, declaration: ConsumerDeclarationRecord, purchase: PurchaseRecord, status: WithdrawalStatus, computation: Pick<WithdrawalComputation, 'reading' | 'deducted' | 'unitsReturned' | 'netMinor' | 'refundMinor'> | null, execution: WithdrawalExecution | null) => Promise<boolean>;
+/** Tell the cancellation observers. */
+export declare const notifyCancellation: (ctx: ApiContext, declaration: ConsumerDeclarationRecord, status: CancellationStatus) => Promise<boolean>;
+/** Tell the consent observers. */
+export declare const notifyConsent: (ctx: ApiContext, consent: ConsumerConsentRecord) => Promise<boolean>;
+/**
+ * Schedule an ordinary cancellation at the paygate: at the period end (`cancel_at_period_end`), or
+ * at a later boundary (`cancel_at`, no proration). Recorded as a `cancel-scheduled` event.
+ */
+export declare const scheduleCancellation: (ctx: ApiContext, stripe: Stripe, declaration: ConsumerDeclarationRecord, row: PaymentSubscriptionRecord, attempt?: number) => Promise<boolean>;
+/**
+ * The consumer-rights service (`CONSUMER_RIGHTS_SERVICE`): the billing profile and its lock,
+ * purchases and their withdrawal windows, performance consent and subscription start requests,
+ * the withdrawal and cancellation functions with their paygate steps, the durable-medium mails,
+ * and `reconcile`. Unmanaged (`manage: false`) it still reads, records consents and asserts them;
+ * withdrawing and cancelling need the paygate.
+ *
+ * A lazy service, like the completion observer: `useMeter` / `useMailRenderer` work while the
+ * application is still being wired, before the context initializes.
+ */
+export declare const makeConsumerRightsService: (alias?: string, opts?: ConsumerRightsOptions) => ConsumerRightsService;
+/**
+ * Register the consumer-rights resources and service (each only when absent), or configure the
+ * service already registered — `from` says who asks. The order of the application's call and the
+ * gateway's is free: `usage` and `stripe` are installed whenever they come, and the application's
+ * explicit `manage` wins over the gateway's. The resources keep the first registration's aliases.
+ */
+export declare const registerConsumerRights: <C extends Config, T extends Context<C>>(ctx: T, opts?: ConsumerRightsOptions, from?: ConsumerRightsRegistrar) => T;
+/**
+ * Register the consumer-rights resources and service, each only when absent — the gateway
+ * registration does too. Called before or after the gateway, it installs `usage` and `stripe` on
+ * the service and its explicit `manage` wins over the gateway's; `useMeter` and `useMailRenderer`
+ * work on the service at any time.
+ */
+export declare const appendConsumerRights: <C extends Config, T extends Context<C>>(ctx: T, opts?: ConsumerRightsOptions) => T;
+//# sourceMappingURL=service.d.ts.map

package/build/consumer/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/consumer/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAGhC,OAAO,EACsC,kBAAkB,EAI7D,gBAAgB,EACjB,MAAM,mBAAmB,CAAA;AAK1B,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAiBjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACjF,OAAO,KAAK,EACV,MAAM,EAAE,qBAAqB,EAAE,yBAAyB,EAAwB,qBAAqB,EACrG,qBAAqB,EAAE,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,UAAU,EACtF,MAAM,aAAa,CAAA;AAmEpB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,KAAK,EAAE,MAAM,UAAU,GAAG,IAAI,CAAA;IAC9B,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7C;AAED,kGAAkG;AAClG,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG,SAAS,CAAA;AAQ/D,kGAAkG;AAClG,eAAO,MAAM,oBAAoB,QAC1B,UAAU,UAAU,SAAS,GAAG,YAAY,GAAG,cAAc,YAAY,MAAM,YAAY,MAAM,GAAG,SAAS,OAC7G,MAAM,OAAO,CAAC,IAAI,CAAC,KACvB,OAAO,CAAC,OAAO,CAajB,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,QACtB,UAAU,eAAe,yBAAyB,YAAY,cAAc,UAAU,gBAAgB,eAC9F,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,UAAU,GAAG,aAAa,CAAC,GAAG,IAAI,aAC3G,mBAAmB,GAAG,IAAI,KACpC,OAAO,CAAC,OAAO,CAoBhB,CAAA;AAEF,uCAAuC;AACvC,eAAO,MAAM,kBAAkB,QACxB,UAAU,eAAe,yBAAyB,UAAU,kBAAkB,KAClF,OAAO,CAAC,OAAO,CAahB,CAAA;AAEF,kCAAkC;AAClC,eAAO,MAAM,aAAa,QAAe,UAAU,WAAW,qBAAqB,KAAG,OAAO,CAAC,OAAO,CASjG,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAC1B,UAAU,UAAU,MAAM,eAAe,yBAAyB,OAAO,yBAAyB,YAC9F,MAAM,KACd,OAAO,CAAC,OAAO,CAyBjB,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,WAC7B,MAAM,SAAkC,qBAAqB,KACnE,qBAohBF,CAAA;AAwDD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,OACtE,CAAC,SAAQ,qBAAqB,SAAa,uBAAuB,KACtE,CAsBF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,OACpE,CAAC,SAAQ,qBAAqB,KAClC,CAAqD,CAAA"}