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

package/build/consumer/reconcile.js

@@ -0,0 +1,317 @@
+import { MAILER_SERVICE } from '@owlmeans/mailer';
+import { CancellationStatus, DeclarationKind, ENTITLING_STATUSES, PurchaseKind, WithdrawalStatus, } from '@owlmeans/payment';
+import { PURCHASE_BACKFILL_DAYS, STRIPE_PAYGATE_ALIAS } from '../consts.js';
+import { billingProfiles, consumerConsents, consumerDeclarations, consumerEvents, consumerMailConfig, errorText, idOf, paygateCustomers, payment, purchases, subscriptions, } from '../utils.js';
+import { capturePaymentPurchase, captureSubscriptionPurchase, completeSubscriptionPurchase, } from './capture.js';
+import { sendConsumerMail } from './mail.js';
+import { hasEvent, hasPaid, lockProfile, purchaseIdOf, wasUnlocked } from './records.js';
+import { notifyCancellation, notifyConsent, notifyWithdrawal, scheduleCancellation, } from './service.js';
+import { executeWithdrawal, retryCreditNote } from './withdrawal.js';
+const DAY_MS = 86_400_000;
+/** A paygate step failed this often is left to an operator. */
+const MAX_ATTEMPTS = 5;
+/** What `withdraw` computed for a declaration, read back from its `computed` event. */
+const computedOf = async (ctx, withdrawalId) => {
+    const event = await consumerEvents(ctx).load({ recordId: withdrawalId, action: 'computed', ok: true });
+    if (event == null) {
+        return null;
+    }
+    const detail = JSON.parse(event.detail ?? '{}');
+    return {
+        reading: detail.reading ?? { granted: 0, used: 0, usedAfter: 0 },
+        deducted: detail.deducted ?? 0,
+        unitsReturned: detail.unitsReturned ?? 0,
+        netMinor: detail.netMinor ?? 0,
+        refundMinor: event.amountMinor ?? 0,
+    };
+};
+const failures = async (ctx, recordId, action) => await consumerEvents(ctx).count({ recordId, action, ok: false });
+/** Every distinct (record, step) with a failed event since `since` and no success after all. */
+const pendingSteps = async (ctx, action, since, limit) => {
+    const { items } = await consumerEvents(ctx).list({ action, ok: false, at: { $gte: since } }, {
+        size: limit * 4, sort: [{ field: 'at', order: 'desc' }],
+    });
+    const seen = new Set();
+    const pending = [];
+    for (const event of items) {
+        const key = `${event.recordId}:${event.step ?? ''}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        if (!await hasEvent(ctx, event.recordId, action, event.step ?? undefined, true)) {
+            pending.push(event);
+        }
+        if (pending.length >= limit)
+            break;
+    }
+    return pending;
+};
+const retryWithdrawals = async (ctx, stripe, since, limit, result) => {
+    const { items } = await consumerDeclarations(ctx).list({
+        kind: DeclarationKind.Withdrawal, status: WithdrawalStatus.Processing, matched: true, receivedAt: { $gte: since },
+    }, { size: limit * 2, sort: [{ field: 'receivedAt', order: 'asc' }] });
+    let handled = 0;
+    for (const declaration of items) {
+        if (handled >= limit)
+            break;
+        const id = declaration.id;
+        const purchase = declaration.purchaseId != null ? await purchases(ctx).byPurchaseId(declaration.purchaseId) : null;
+        // A declaration that lost the race for its purchase is a duplicate — never executed.
+        if (purchase == null || purchase.withdrawalId !== id)
+            continue;
+        const computed = await computedOf(ctx, id);
+        const refundDone = (declaration.refundMinor ?? 0) <= 0 || await hasEvent(ctx, id, 'refund', undefined, true);
+        const cancelDone = purchase.kind !== PurchaseKind.Subscription || await hasEvent(ctx, id, 'subscription-cancel', undefined, true);
+        if (refundDone && cancelDone) {
+            const refundEvent = await consumerEvents(ctx).load({ recordId: id, action: 'refund', ok: true });
+            const noteFailed = await consumerEvents(ctx).load({ recordId: id, action: 'credit-note', ok: false, step: null });
+            if (refundEvent?.externalId != null && noteFailed != null && computed != null
+                && !await hasEvent(ctx, id, 'credit-note', undefined, true)) {
+                const attempt = await failures(ctx, id, 'credit-note');
+                if (attempt < MAX_ATTEMPTS) {
+                    handled++;
+                    result.retried++;
+                    if (!await retryCreditNote(ctx, stripe, declaration, purchase, computed.netMinor, refundEvent.externalId, attempt)) {
+                        result.failed++;
+                    }
+                }
+            }
+            continue;
+        }
+        const attempt = Math.max(await failures(ctx, id, 'refund'), await failures(ctx, id, 'subscription-cancel'));
+        if (attempt >= MAX_ATTEMPTS)
+            continue;
+        handled++;
+        result.retried++;
+        try {
+            const execution = await executeWithdrawal(ctx, stripe, declaration, purchase, {
+                refundMinor: declaration.refundMinor ?? computed?.refundMinor ?? 0, netMinor: computed?.netMinor ?? 0,
+            }, { attempt });
+            if (!execution.ok) {
+                result.failed++;
+                continue;
+            }
+            if (!await hasEvent(ctx, id, 'observers', 'withdrawal')) {
+                await notifyWithdrawal(ctx, declaration, purchase, WithdrawalStatus.Refunded, computed, execution);
+            }
+        }
+        catch (error) {
+            result.failed++;
+            console.error(`[payment] reconcile: withdrawal "${id}" failed`, error);
+        }
+    }
+};
+const retryCancellations = async (ctx, stripe, since, limit, result) => {
+    const { items } = await consumerDeclarations(ctx).list({
+        kind: DeclarationKind.Cancellation, status: CancellationStatus.Scheduled, matched: true, receivedAt: { $gte: since },
+    }, { size: limit * 2, sort: [{ field: 'receivedAt', order: 'asc' }] });
+    let handled = 0;
+    for (const declaration of items) {
+        if (handled >= limit)
+            break;
+        const id = declaration.id;
+        if (declaration.subscriptionId == null || await hasEvent(ctx, id, 'cancel-scheduled', undefined, true))
+            continue;
+        const attempt = await failures(ctx, id, 'cancel-scheduled');
+        const row = await subscriptions(ctx).byExternalId(declaration.subscriptionId, STRIPE_PAYGATE_ALIAS);
+        if (row == null || attempt >= MAX_ATTEMPTS)
+            continue;
+        handled++;
+        result.retried++;
+        if (!await scheduleCancellation(ctx, stripe, declaration, row, attempt)) {
+            result.failed++;
+        }
+    }
+};
+const retryMails = async (ctx, since, limit, result) => {
+    const policy = await payment(ctx).consumerRightsPolicy();
+    const alias = (await consumerMailConfig(ctx))?.alias ?? MAILER_SERVICE;
+    if (policy == null || ctx.hasService?.(alias) !== true) {
+        return;
+    }
+    for (const event of await pendingSteps(ctx, 'mail', since, limit)) {
+        if (event.step == null)
+            continue;
+        if (await sendConsumerMail(ctx, policy, event.step, event.recordId)) {
+            result.mailed++;
+        }
+        else if (!await hasEvent(ctx, event.recordId, 'mail', event.step, true)) {
+            result.failed++;
+        }
+    }
+};
+const retryObservers = async (ctx, since, limit, result) => {
+    for (const event of await pendingSteps(ctx, 'observers', since, limit)) {
+        let told = false;
+        try {
+            if (event.step === 'consent') {
+                const consent = await consumerConsents(ctx).load(event.recordId);
+                told = consent != null && await notifyConsent(ctx, consent);
+            }
+            else if (event.step === 'withdrawal') {
+                const declaration = await consumerDeclarations(ctx).load(event.recordId);
+                const purchase = declaration?.purchaseId != null ? await purchases(ctx).byPurchaseId(declaration.purchaseId) : null;
+                if (declaration != null && purchase != null) {
+                    const refunded = await hasEvent(ctx, event.recordId, 'refund', undefined, true) || (declaration.refundMinor ?? 0) <= 0;
+                    const refund = await consumerEvents(ctx).load({ recordId: event.recordId, action: 'refund', ok: true });
+                    const note = await consumerEvents(ctx).load({ recordId: event.recordId, action: 'credit-note', ok: true });
+                    told = await notifyWithdrawal(ctx, declaration, purchase, declaration.status === WithdrawalStatus.Processing && refunded ? WithdrawalStatus.Refunded : WithdrawalStatus.Review, await computedOf(ctx, event.recordId), refund != null ? {
+                        ok: true, refundId: refund.externalId ?? undefined, creditNoteId: note?.externalId ?? undefined,
+                        refundedMinor: refund.amountMinor ?? 0, needsReview: false,
+                        subscriptionCanceled: await hasEvent(ctx, event.recordId, 'subscription-cancel', undefined, true),
+                    } : null);
+                }
+            }
+            else if (event.step === 'cancellation') {
+                const declaration = await consumerDeclarations(ctx).load(event.recordId);
+                if (declaration != null) {
+                    const scheduled = await hasEvent(ctx, event.recordId, 'cancel-scheduled', undefined, true);
+                    told = await notifyCancellation(ctx, declaration, declaration.status === CancellationStatus.Scheduled && !scheduled
+                        ? CancellationStatus.Received : declaration.status);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`[payment] reconcile: observers of "${event.recordId}" failed`, error);
+        }
+        if (told) {
+            result.observed++;
+        }
+        else {
+            result.failed++;
+        }
+    }
+};
+/** Completed checkouts of the last days that have no purchase row (records only — no mail). */
+const backfillPurchases = async (ctx, stripe, limit, result) => {
+    const from = Math.floor((Date.now() - PURCHASE_BACKFILL_DAYS * DAY_MS) / 1000);
+    let startingAfter;
+    let scanned = 0;
+    for (;;) {
+        const page = await stripe.checkout.sessions.list({
+            created: { gte: from }, status: 'complete', limit: 100,
+            ...(startingAfter != null ? { starting_after: startingAfter } : {}),
+        });
+        for (const session of page.data) {
+            scanned++;
+            if (result.backfilled >= limit)
+                return;
+            const metadata = session.metadata ?? {};
+            if (metadata.entityId == null || metadata.productSku == null)
+                continue;
+            try {
+                if (session.mode === 'payment' && session.payment_status === 'paid') {
+                    if (await purchases(ctx).load({ sessionId: session.id }) != null)
+                        continue;
+                    const amount = Number(metadata.amountMinor);
+                    const captured = await capturePaymentPurchase(ctx, stripe, session, {
+                        ...(Number.isSafeInteger(amount) && amount > 0 ? { netAmountMinor: amount } : {}),
+                        ...(metadata.amountCurrency != null ? { amountCurrency: metadata.amountCurrency } : {}),
+                        at: new Date(session.created * 1000),
+                    }, { mail: false });
+                    if (captured?.created === true)
+                        result.backfilled++;
+                }
+                else if (session.mode === 'subscription') {
+                    const subscriptionId = idOf(session.subscription);
+                    if (subscriptionId == null || await purchases(ctx).byPurchaseId(purchaseIdOf(subscriptionId)) != null)
+                        continue;
+                    const row = await subscriptions(ctx).byExternalId(subscriptionId, STRIPE_PAYGATE_ALIAS);
+                    if (row == null || !ENTITLING_STATUSES.includes(row.status))
+                        continue;
+                    const subscription = await stripe.subscriptions.retrieve(subscriptionId);
+                    const captured = await captureSubscriptionPurchase(ctx, stripe, subscription, row);
+                    if (captured != null) {
+                        await completeSubscriptionPurchase(ctx, stripe, session, captured.purchase, { mail: false });
+                        if (captured.created)
+                            result.backfilled++;
+                    }
+                }
+            }
+            catch (error) {
+                result.failed++;
+                console.error(`[payment] reconcile: backfill of "${session.id}" failed`, error);
+            }
+        }
+        if (!page.has_more || page.data.length === 0 || scanned >= limit * 20)
+            return;
+        startingAfter = page.data[page.data.length - 1].id;
+    }
+};
+/**
+ * Organizations that paid before countries were locked: locked from their paygate customer's
+ * address — never one an operator unlocked (its next completed purchase locks it).
+ */
+const lockLegacy = async (ctx, stripe, limit, result) => {
+    const policy = await payment(ctx).consumerRightsPolicy();
+    if (policy?.mechanisms.countryLock !== true) {
+        return;
+    }
+    const { items } = await paygateCustomers(ctx).list({ paygate: STRIPE_PAYGATE_ALIAS, deletedAt: null }, { size: limit * 4 });
+    for (const customer of items) {
+        if (result.locked >= limit)
+            return;
+        if (customer.entityId == null || await billingProfiles(ctx).byEntity(customer.entityId) != null)
+            continue;
+        if (!await hasPaid(ctx, customer.entityId) || await wasUnlocked(ctx, customer.entityId))
+            continue;
+        try {
+            let country = customer.country;
+            if (country == null) {
+                const retrieved = await stripe.customers.retrieve(customer.externalId);
+                country = retrieved.deleted ? undefined : retrieved.address?.country ?? undefined;
+            }
+            if (country == null)
+                continue;
+            const { created } = await lockProfile(ctx, policy, {
+                entityId: customer.entityId, country, source: 'customer', customerId: customer.externalId,
+                email: customer.email ?? undefined,
+            });
+            if (created)
+                result.locked++;
+        }
+        catch (error) {
+            result.failed++;
+            console.error(`[payment] reconcile: legacy lock of "${customer.entityId}" failed: ${errorText(error)}`);
+        }
+    }
+};
+/**
+ * The consumer-rights repair an application runs nightly: retry the paygate steps of withdrawals
+ * (refunds, credit notes, subscription cancels) and scheduled cancellations, failed mails and
+ * failed observers; backfill purchases of completed checkouts of the last 16 days that have no
+ * row; lock organizations that paid before countries were locked. The paygate steps, the
+ * backfill and the legacy locks need a managed service. Each step handles at most `limit` items.
+ */
+export const reconcileConsumerRights = async (ctx, internals, opts = {}) => {
+    const result = { retried: 0, mailed: 0, observed: 0, backfilled: 0, locked: 0, failed: 0 };
+    if (await payment(ctx).consumerRightsPolicy() == null) {
+        return result;
+    }
+    const limit = Math.max(1, opts.limit ?? 50);
+    const since = opts.since ?? new Date(Date.now() - 30 * DAY_MS);
+    const stripe = internals.managed ? await internals.stripe(ctx) : null;
+    const steps = [
+        ...(stripe != null ? [
+            ['withdrawals', async () => { await retryWithdrawals(ctx, stripe, since, limit, result); }],
+            ['cancellations', async () => { await retryCancellations(ctx, stripe, since, limit, result); }],
+        ] : []),
+        ['mails', async () => { await retryMails(ctx, since, limit, result); }],
+        ['observers', async () => { await retryObservers(ctx, since, limit, result); }],
+        ...(stripe != null ? [
+            ['backfill', async () => { await backfillPurchases(ctx, stripe, limit, result); }],
+            ['legacy locks', async () => { await lockLegacy(ctx, stripe, limit, result); }],
+        ] : []),
+    ];
+    for (const [name, step] of steps) {
+        try {
+            await step();
+        }
+        catch (error) {
+            result.failed++;
+            console.error(`[payment] consumer-rights reconcile step "${name}" failed`, error);
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=reconcile.js.map

package/build/consumer/reconcile.js.map

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

package/build/consumer/records.d.ts

@@ -0,0 +1,78 @@
+import type { BillingProfileView, ConsumerRightsPolicy, PurchaseView } from '@owlmeans/payment';
+import type { Context as ApiContext } from '@owlmeans/server-api';
+import type { BillingProfileRecord, BillingProfileSource, ConsumerEventRecord, LockOptions, PaymentSubscriptionRecord, PurchaseRecord, PurchaseRef, UnlockOptions } from '../types.js';
+export declare const purchaseIdOf: (externalId: string) => string;
+/** A locked profile as the wire sees it. */
+export declare const profileViewOf: (record: BillingProfileRecord, policy: ConsumerRightsPolicy | null) => BillingProfileView;
+/** No profile yet: nothing locked, the default legal language, an unknown buyer (protected by default). */
+export declare const unlockedProfileView: (policy: ConsumerRightsPolicy | null) => BillingProfileView;
+/**
+ * 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 declare const recordEvent: (ctx: ApiContext, event: Omit<ConsumerEventRecord, 'at' | 'id'> & {
+    at?: Date;
+}) => Promise<void>;
+/** Whether a step already succeeded (or a mail was deliberately skipped) for a record. */
+export declare const hasEvent: (ctx: ApiContext, recordId: string, action: ConsumerEventRecord['action'], step?: string, ok?: boolean) => Promise<boolean>;
+/** The currency of the entity's entitling Stripe subscription — two of one customer cannot differ. */
+export declare const activeSubscriptionCurrency: (ctx: ApiContext, entityId: string) => Promise<string | undefined>;
+/** The entity's highest-ranked entitling Stripe subscription, or `null`. */
+export declare const entitlingStripeSubscription: (ctx: ApiContext, entityId: string) => Promise<PaymentSubscriptionRecord | null>;
+/** Whether the entity ever paid through the paygate (a fulfilled checkout or a propagated subscription). */
+export declare const hasPaid: (ctx: ApiContext, entityId: string) => Promise<boolean>;
+export interface LockInput extends LockOptions {
+    entityId: string;
+    country: string;
+    source: BillingProfileSource;
+}
+export interface LockResult {
+    record: BillingProfileRecord;
+    created: boolean;
+    /** The lock exists with another country: recorded as `lock-mismatch`, never relocked. */
+    mismatch: boolean;
+}
+/**
+ * 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 declare const lockProfile: (ctx: ApiContext, policy: ConsumerRightsPolicy | null, input: LockInput) => Promise<LockResult>;
+/**
+ * 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 declare const unlockProfile: (ctx: ApiContext, entityId: string, opts?: UnlockOptions) => Promise<BillingProfileRecord | null>;
+/**
+ * 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 declare const wasUnlocked: (ctx: ApiContext, entityId: string) => Promise<boolean>;
+/** Inside its window at `at`: in scope, before the deadline, neither withdrawn from nor refunded. */
+export declare const windowOpen: (purchase: PurchaseRecord, at?: Date) => boolean;
+export declare const purchaseViewOf: (purchase: PurchaseRecord, withdrawable: boolean) => PurchaseView;
+export declare const purchaseRefOf: (purchase: PurchaseRecord) => PurchaseRef;
+/** The open, unconsented top-up windows of an entity — what a performance consent covers. */
+export declare const unconsentedWindows: (ctx: ApiContext, entityId: string, at?: Date) => Promise<PurchaseRecord[]>;
+export type PurchaseDraft = Omit<PurchaseRecord, 'id' | 'contractRef' | 'createdAt'>;
+/**
+ * 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 declare const createPurchase: (ctx: ApiContext, draft: PurchaseDraft) => Promise<{
+    record: PurchaseRecord;
+    created: boolean;
+}>;
+/** Set fields on a purchase without replacing it (a concurrent conditional write survives). */
+export declare const patchPurchase: (ctx: ApiContext, purchaseId: string, fields: Partial<PurchaseRecord>) => Promise<void>;
+/** The e-mail a consumer-rights mail reaches the organization at when no person named one. */
+export declare const contactEmailOf: (ctx: ApiContext, entityId: string) => Promise<string | 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 declare const emailMatches: (ctx: ApiContext, purchase: PurchaseRecord, email: string) => Promise<boolean>;
+//# sourceMappingURL=records.d.ts.map

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

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