@endora-commerce/mod-payments 0.100.0

package/dist/backend/services/gateway-refund-registry.js

@@ -0,0 +1,106 @@
+const consoleLogger = {
+    warn: (message) => console.warn(message),
+};
+export class GatewayRefundRegistry {
+    log;
+    isModulePresent;
+    handlers = new Map();
+    /**
+     * @param log             collision warnings.
+     * @param isModulePresent the effective-state probe. Defaults to
+     *   always-present, so a registry a unit test builds for itself keeps
+     *   answering about the handlers that test registered; the process singleton
+     *   wires it to the kernel's effective state.
+     */
+    constructor(log = consoleLogger, isModulePresent = () => true) {
+        this.log = log;
+        this.isModulePresent = isModulePresent;
+    }
+    register(handler, moduleId) {
+        const existing = this.handlers.get(handler.adapterKey);
+        if (existing && existing.module !== moduleId) {
+            this.log.warn(`GatewayRefundRegistry: handler "${handler.adapterKey}" re-registered by module ` +
+                `"${moduleId}" (was "${existing.module}"); overwriting previous registration.`);
+        }
+        this.handlers.set(handler.adapterKey, { handler, module: moduleId });
+    }
+    unregister(adapterKey) {
+        this.handlers.delete(adapterKey);
+    }
+    /** The contributed entry, presence-blind. Diagnostics read this. */
+    entry(adapterKey) {
+        return this.handlers.get(adapterKey);
+    }
+    /** The module that contributed `adapterKey`, or `null` when nobody did. */
+    ownerOf(adapterKey) {
+        return this.handlers.get(adapterKey)?.module ?? null;
+    }
+    /**
+     * The module that would have handled this refund but is not present (D-71).
+     *
+     * The question a caller asks *after* {@link resolve} declined, because one
+     * empty `resolve` covers two situations that are not interchangeable: a
+     * gateway an operator switched off is a capability restorable in one click
+     * and must be **refused**, while an adapter nobody ever registered is a
+     * deployment with no PSP integration, which records the obligation and
+     * settles by hand.
+     *
+     * It mirrors `resolve`'s two arms exactly, which is why the unkeyed one is
+     * here at all: `resolve` answers with the sole registered handler when the
+     * order names no adapter, and point 3 of the docblock above says that is the
+     * worst arm to get wrong — the refunds with the least information behind
+     * them. Presence-blind in the same sense `ownerOf` is.
+     */
+    absentOwnerFor(adapterKey) {
+        if (adapterKey) {
+            const entry = this.handlers.get(adapterKey);
+            if (!entry || this.isModulePresent(entry.module))
+                return null;
+            return entry.module;
+        }
+        // No key: `resolve` would have answered with the sole registered handler.
+        // Nothing is available and exactly one thing is registered ⇒ that one is
+        // the handler the operator switched off.
+        if (this.list().length > 0)
+            return null;
+        const entries = [...this.handlers.values()];
+        return entries.length === 1 ? entries[0].module : null;
+    }
+    /** The handler, or `undefined` when unregistered or its owner is absent. */
+    get(adapterKey) {
+        const entry = this.handlers.get(adapterKey);
+        if (!entry || !this.isModulePresent(entry.module))
+            return undefined;
+        return entry.handler;
+    }
+    /**
+     * Resolve the handler for a gateway payment.
+     * - Known `adapterKey` → exact handler only (never guess another PSP).
+     * - Missing key → sole registered handler when exactly one exists.
+     *
+     * Both arms drop a handler whose owner is absent, and the second arm counts
+     * only the handlers that are available: with one gateway installed and
+     * switched off, "the sole registered handler" must not be it.
+     */
+    resolve(adapterKey) {
+        if (adapterKey) {
+            return this.get(adapterKey);
+        }
+        const available = this.list();
+        const [only, ...rest] = available;
+        if (only !== undefined && rest.length === 0)
+            return this.get(only);
+        return undefined;
+    }
+    /** Adapter keys whose owner is present (stable insertion order). */
+    list() {
+        return [...this.handlers.entries()]
+            .filter(([, entry]) => this.isModulePresent(entry.module))
+            .map(([key]) => key);
+    }
+    /** Every registered adapter key, presence-blind. */
+    listAll() {
+        return [...this.handlers.keys()];
+    }
+}
+//# sourceMappingURL=gateway-refund-registry.js.map

package/dist/backend/services/gateway-refund-registry.js.map

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

package/dist/backend/services/payment-email-notifier.d.ts

@@ -0,0 +1,71 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CustomerAccountReadPort, OrderReadPort, TransactionalEmailSender } from '@endora-commerce/contracts';
+/**
+ * Why the payment-status e-mail did — or did not — go out (issue #78).
+ *
+ * `notify` answered `void`, and `void` covered seven situations: no sender
+ * wired, no order behind the id, no address on the customer, the three outcomes
+ * `send` reports since issue #67, and anything the bare `catch` absorbed. A
+ * payment was recorded and nothing anywhere said whether the customer had been
+ * told.
+ */
+export type PaymentEmailNotSentReason = 
+/** No transactional sender is wired in this composition. */
+'no_sender'
+/** The event named an order this process cannot load. */
+ | 'order_not_found'
+/** The customer account carries no address to send to. */
+ | 'no_recipient'
+/** The operator switched the `payment_status_changed` e-mail off. */
+ | 'deactivated'
+/** No mailer is wired behind the sender. */
+ | 'no_transport'
+/** No `payment_status_changed` template exists yet. */
+ | 'no_definition'
+/** The send raised, and the payment stays recorded. */
+ | 'failed';
+export type PaymentEmailResult = {
+    sent: true;
+} | {
+    sent: false;
+    reason: PaymentEmailNotSentReason;
+};
+/**
+ * Where a send that did not happen is reported. Injectable so a test can read
+ * it; defaults to `console.warn`, which is what the rest of this layer uses.
+ */
+export type PaymentEmailLog = (message: string, context: Record<string, unknown>) => void;
+export interface PaymentEmailNotifierDeps {
+    emFactory: () => EntityManager;
+    /**
+     * Feature 075 Phase C — the order and its buyer come from the ports their
+     * owners publish, not from `Order` and `CustomerAccount`. Both fail closed
+     * when their owner is off, and that is the right answer for a notification:
+     * an e-mail addressed from data the platform will not read is worse than no
+     * e-mail. `notify`'s `catch` re-throws `ModuleDisabledError` first, so the
+     * refusal reaches the subscriber rather than being logged as `failed`.
+     */
+    orderRead: OrderReadPort;
+    customerAccountRead: CustomerAccountReadPort;
+    getTransactionalEmailSender: () => TransactionalEmailSender | undefined;
+    log?: PaymentEmailLog;
+}
+export declare class PaymentEmailNotifier {
+    private readonly deps;
+    private readonly log;
+    constructor(deps: PaymentEmailNotifierDeps);
+    /**
+     * Public since feature 072 (T126), and `attach(eventBus)` is gone with it.
+     * That method subscribed to the raw bus, which is how a payment-status
+     * e-mail went out while this module was switched off; the module now
+     * subscribes through `ctx.subscribe`, which stops with it.
+     *
+     * **Best-effort, and now audible.** The subscriber that calls this has no
+     * result to inspect, so every non-sent path is written to the log as well as
+     * named in the return value; a payment must not be un-recorded because the
+     * notification failed.
+     */
+    notify(orderId: string, status: 'paid' | 'failed', failureReason: string | null): Promise<PaymentEmailResult>;
+    private notSent;
+}
+//# sourceMappingURL=payment-email-notifier.d.ts.map

package/dist/backend/services/payment-email-notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-email-notifier.d.ts","sourceRoot":"","sources":["../../../src/backend/services/payment-email-notifier.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACb,wBAAwB,EACzB,MAAM,4BAA4B,CAAC;AAIpC;;;;;;;;GAQG;AACH,MAAM,MAAM,yBAAyB;AACnC,4DAA4D;AAC1D,WAAW;AACb,yDAAyD;GACvD,iBAAiB;AACnB,0DAA0D;GACxD,cAAc;AAChB,qEAAqE;GACnE,aAAa;AACf,4CAA4C;GAC1C,cAAc;AAChB,uDAAuD;GACrD,eAAe;AACjB,uDAAuD;GACrD,QAAQ,CAAC;AAEb,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAErG;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAE1F,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B;;;;;;;OAOG;IACH,SAAS,EAAE,aAAa,CAAC;IACzB,mBAAmB,EAAE,uBAAuB,CAAC;IAC7C,2BAA2B,EAAE,MAAM,wBAAwB,GAAG,SAAS,CAAC;IACxE,GAAG,CAAC,EAAE,eAAe,CAAC;CACvB;AAED,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;gBAET,IAAI,EAAE,wBAAwB;IAI3D;;;;;;;;;;OAUG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,QAAQ,EACzB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,kBAAkB,CAAC;IAqC9B,OAAO,CAAC,OAAO;CAYhB"}

package/dist/backend/services/payment-email-notifier.js

@@ -0,0 +1,73 @@
+// Feature 047 — payment_status_changed transactional email. A net-new email
+// (no legacy builder): subscribes to payment.received/failed and sends the
+// admin-editable template to the order's customer. Best-effort; event-bus
+// dispatch isolates handler errors.
+import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+export class PaymentEmailNotifier {
+    deps;
+    log;
+    constructor(deps) {
+        this.deps = deps;
+        this.log = deps.log ?? ((message, context) => console.warn(message, context));
+    }
+    /**
+     * Public since feature 072 (T126), and `attach(eventBus)` is gone with it.
+     * That method subscribed to the raw bus, which is how a payment-status
+     * e-mail went out while this module was switched off; the module now
+     * subscribes through `ctx.subscribe`, which stops with it.
+     *
+     * **Best-effort, and now audible.** The subscriber that calls this has no
+     * result to inspect, so every non-sent path is written to the log as well as
+     * named in the return value; a payment must not be un-recorded because the
+     * notification failed.
+     */
+    async notify(orderId, status, failureReason) {
+        const sender = this.deps.getTransactionalEmailSender();
+        if (!sender)
+            return this.notSent(orderId, 'no_sender');
+        try {
+            const em = this.deps.emFactory();
+            const order = await this.deps.orderRead.findById(orderId);
+            if (!order)
+                return this.notSent(orderId, 'order_not_found');
+            const customer = await this.deps.customerAccountRead.findById(order.placedByCustomerAccountId);
+            if (!customer?.email)
+                return this.notSent(orderId, 'no_recipient');
+            const channel = await em.findOne(SalesChannel, { id: order.salesChannelId });
+            const outcome = await sender.send({
+                code: 'payment_status_changed',
+                salesChannelId: order.salesChannelId,
+                language: channel?.defaultLanguage ?? 'en-US',
+                to: customer.email,
+                messageId: `payment_status_changed:${order.id}:${status}`,
+                variables: {
+                    order: { businessId: order.businessId },
+                    payment: { status, statusLabel: status === 'paid' ? 'Paid' : 'Failed', failureReason: failureReason ?? '' },
+                },
+                meta: { orderId: order.id, kind: 'payment_status_changed', status },
+            });
+            if (outcome.status !== 'sent')
+                return this.notSent(orderId, outcome.status);
+            return { sent: true };
+        }
+        catch (error) {
+            // A switched-off module is a presence answer about the whole operation,
+            // not a message that failed to render; absorbing it would report "sent
+            // nothing" where the truthful answer is "this capability is off".
+            rethrowIfModuleDisabled(error);
+            // Everything else is contained: the payment is recorded and must not be
+            // undone because the message did not go out. It is named, though.
+            return this.notSent(orderId, 'failed', error);
+        }
+    }
+    notSent(orderId, reason, error) {
+        this.log('[payments] the payment-status e-mail was not sent', {
+            orderId,
+            reason,
+            ...(error === undefined ? {} : { error: error instanceof Error ? error.message : error }),
+        });
+        return { sent: false, reason };
+    }
+}
+//# sourceMappingURL=payment-email-notifier.js.map

package/dist/backend/services/payment-email-notifier.js.map

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

package/dist/backend/services/payment-email-renderer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Payment-method renderer registry for the transactional order-confirmation
+ * e-mail (feature 034, FR-016/FR-017). An adapter may register a custom
+ * e-mail renderer under a key (the adapter's `renderers.email`); when none is
+ * registered, the platform default text builder is used, so the payment
+ * section always renders.
+ *
+ * E-mail bodies are plain text (see Mailer.MailerSendInput.text), so a renderer
+ * is a `(ctx) => string` builder rather than a React component.
+ */
+import type { PaymentEmailContext } from '@endora-commerce/contracts';
+/**
+ * `PaymentEmailContext` moved to `@endora-commerce/contracts` in feature 075's Phase P —
+ * `orders` renders the payment line with it. Re-exported here for the length
+ * of Phase P, which cuts no consumer.
+ */
+export type { PaymentEmailContext };
+export type PaymentEmailRenderer = (ctx: PaymentEmailContext) => string;
+export declare const defaultPaymentEmailRenderer: PaymentEmailRenderer;
+export declare function registerPaymentEmailRenderer(key: string, renderer: PaymentEmailRenderer): void;
+export declare function resolvePaymentEmailRenderer(rendererKey: string | null): PaymentEmailRenderer;
+//# sourceMappingURL=payment-email-renderer.d.ts.map

package/dist/backend/services/payment-email-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-email-renderer.d.ts","sourceRoot":"","sources":["../../../src/backend/services/payment-email-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;GAIG;AACH,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,MAAM,CAAC;AAExE,eAAO,MAAM,2BAA2B,EAAE,oBAIzC,CAAC;AAIF,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAE9F;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,oBAAoB,CAM5F"}

package/dist/backend/services/payment-email-renderer.js

@@ -0,0 +1,17 @@
+export const defaultPaymentEmailRenderer = (ctx) => {
+    const surcharge = ctx.additionalPrice > 0 ? ` (+${ctx.additionalPrice.toFixed(2)} ${ctx.currency})` : '';
+    return `${ctx.name}${surcharge}`;
+};
+const registry = new Map();
+export function registerPaymentEmailRenderer(key, renderer) {
+    registry.set(key, renderer);
+}
+export function resolvePaymentEmailRenderer(rendererKey) {
+    if (rendererKey) {
+        const found = registry.get(rendererKey);
+        if (found)
+            return found;
+    }
+    return defaultPaymentEmailRenderer;
+}
+//# sourceMappingURL=payment-email-renderer.js.map

package/dist/backend/services/payment-email-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-email-renderer.js","sourceRoot":"","sources":["../../../src/backend/services/payment-email-renderer.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,2BAA2B,GAAyB,CAAC,GAAG,EAAE,EAAE;IACvE,MAAM,SAAS,GACb,GAAG,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,SAAS,EAAE,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;AAEzD,MAAM,UAAU,4BAA4B,CAAC,GAAW,EAAE,QAA8B;IACtF,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,WAA0B;IACpE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACxC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,2BAA2B,CAAC;AACrC,CAAC"}

package/dist/backend/services/payment-placement-apply-port.d.ts

@@ -0,0 +1,33 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { PaymentOpened, PaymentPlacementApplyPort } from '@endora-commerce/mod-orders/ports';
+/**
+ * `paymentPlacementApplyPort` — the payment row an order is placed with,
+ * written on the caller's `EntityManager` (feature 080, T048; D-169, D-179).
+ *
+ * `orders` held this module's `Payment` class for it until T048 and did the
+ * `tx.create` itself — the last cross-module entity-class reach in the tree, and
+ * the one thing standing between `orders` and `payments` and their packaging.
+ * D-168 leaves a packaged `payments` no entity class for `orders` to name, so
+ * the reach had to go before either module moves; the transaction it runs in did
+ * not change, and `payments_order_fk` is untouched. The port's own doc block
+ * states the constraint.
+ *
+ * **Every default the row carries is this module's**, and that is the second
+ * thing the conversion moved. `status` (`awaiting_payment`), `attemptNo` (1) and
+ * `refundedAmount` (`0`) are entity defaults `orders` inherited by constructing
+ * the row; they are now inherited by the module that owns the vocabulary, which
+ * is what makes `deferred` — the one value a placement ever overrides — a named
+ * method below rather than a string crossing a boundary.
+ */
+export declare class PaymentPlacementApplyService implements PaymentPlacementApplyPort {
+    openForOrder(em: EntityManager, input: {
+        orderId: string;
+        paymentMethodId: string;
+        amount: string;
+        currency: string;
+    }): Promise<PaymentOpened>;
+    markDeferred(em: EntityManager, input: {
+        paymentId: string;
+    }): Promise<PaymentOpened>;
+}
+//# sourceMappingURL=payment-placement-apply-port.d.ts.map

package/dist/backend/services/payment-placement-apply-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-placement-apply-port.d.ts","sourceRoot":"","sources":["../../../src/backend/services/payment-placement-apply-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,KAAK,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAElG;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,4BAA6B,YAAW,yBAAyB;IACtE,YAAY,CAChB,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,aAAa,CAAC;IAenB,YAAY,CAChB,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,aAAa,CAAC;CAsB1B"}

package/dist/backend/services/payment-placement-apply-port.js

@@ -0,0 +1,68 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { Payment } from '../entities/payment.entity.js';
+/**
+ * `paymentPlacementApplyPort` — the payment row an order is placed with,
+ * written on the caller's `EntityManager` (feature 080, T048; D-169, D-179).
+ *
+ * `orders` held this module's `Payment` class for it until T048 and did the
+ * `tx.create` itself — the last cross-module entity-class reach in the tree, and
+ * the one thing standing between `orders` and `payments` and their packaging.
+ * D-168 leaves a packaged `payments` no entity class for `orders` to name, so
+ * the reach had to go before either module moves; the transaction it runs in did
+ * not change, and `payments_order_fk` is untouched. The port's own doc block
+ * states the constraint.
+ *
+ * **Every default the row carries is this module's**, and that is the second
+ * thing the conversion moved. `status` (`awaiting_payment`), `attemptNo` (1) and
+ * `refundedAmount` (`0`) are entity defaults `orders` inherited by constructing
+ * the row; they are now inherited by the module that owns the vocabulary, which
+ * is what makes `deferred` — the one value a placement ever overrides — a named
+ * method below rather than a string crossing a boundary.
+ */
+export class PaymentPlacementApplyService {
+    async openForOrder(em, input) {
+        // command-coverage-ignore: the payment row an audited order placement opens,
+        // inside that placement's own transaction. `orders` records the placement as
+        // one operation through its own Command; a second audit entry for the row it
+        // opened would record the same decision twice.
+        const payment = em.create(Payment, {
+            orderId: input.orderId,
+            paymentMethodId: input.paymentMethodId,
+            amount: input.amount,
+            currency: input.currency,
+        });
+        await em.persistAndFlush(payment);
+        return recordOf(payment);
+    }
+    async markDeferred(em, input) {
+        const payment = await em.findOne(Payment, { id: input.paymentId });
+        if (!payment) {
+            // Not a tolerance and not a degrade: the one caller opened this row on the
+            // very transaction it is handing back, so an absent row means the two
+            // calls are not on one unit of work — which is precisely the mistake the
+            // required `EntityManager` exists to make impossible. Refuse loudly rather
+            // than leave a credit-limit order recorded as awaiting a payment nobody
+            // will make.
+            throw new HttpError(500, ERROR_CODES.INTERNAL, 'Payment row to defer does not exist on this transaction.');
+        }
+        payment.status = 'deferred';
+        // command-coverage-ignore: the same placement operation as `openForOrder`
+        // above, one branch further in — the credit-limit order whose reservation
+        // this transaction has just taken. Audited once, by `orders`' own Command.
+        await em.flush();
+        return recordOf(payment);
+    }
+}
+/** A published record, never the managed entity (D-77's first narrowing). */
+function recordOf(payment) {
+    return {
+        id: payment.id,
+        orderId: payment.orderId,
+        paymentMethodId: payment.paymentMethodId,
+        amount: payment.amount,
+        currency: payment.currency,
+        status: payment.status,
+    };
+}
+//# sourceMappingURL=payment-placement-apply-port.js.map

package/dist/backend/services/payment-placement-apply-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-placement-apply-port.js","sourceRoot":"","sources":["../../../src/backend/services/payment-placement-apply-port.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAGxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,4BAA4B;IACvC,KAAK,CAAC,YAAY,CAChB,EAAiB,EACjB,KAKC;QAED,6EAA6E;QAC7E,6EAA6E;QAC7E,6EAA6E;QAC7E,+CAA+C;QAC/C,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;YACjC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,MAAM,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,EAAiB,EACjB,KAA4B;QAE5B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,2EAA2E;YAC3E,sEAAsE;YACtE,yEAAyE;YACzE,2EAA2E;YAC3E,wEAAwE;YACxE,aAAa;YACb,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,QAAQ,EACpB,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC;QAC5B,0EAA0E;QAC1E,0EAA0E;QAC1E,2EAA2E;QAC3E,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;CACF;AAED,6EAA6E;AAC7E,SAAS,QAAQ,CAAC,OAAgB;IAChC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC"}

package/dist/backend/services/payment-read-port.d.ts

@@ -0,0 +1,33 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { PaymentReadPort, PaymentRecord } from '@endora-commerce/contracts';
+import { Payment } from '../entities/payment.entity.js';
+/**
+ * The row-level read model `payments` publishes (feature 075, Phase P).
+ *
+ * Sixteen of this module's 35 inbound import sites are `em.findOne(Payment, …)`
+ * — the same four lookups written out once per gateway, with each gateway
+ * spelling "the latest attempt" slightly differently (`attemptNo` descending
+ * in two, `createdAt` descending in the others). Publishing the read fixes
+ * that ordering in one place: `attemptNo` first, `createdAt` as the tiebreak,
+ * which is the ordering the attempt counter is maintained for.
+ *
+ * The money columns stay strings: they are `decimal(14,2)`, and every consumer
+ * forwards the figure to a payment provider.
+ *
+ * `countByPaymentMethod` joined it for feature 075. It answers the one question
+ * `payment_methods` had been asking of this module's table directly, in raw SQL
+ * inside its delete Command — a boundary crossing that named no import
+ * specifier and so compiled, returned rows and went unseen until
+ * `check:module-boundary` learned to read a SQL statement.
+ */
+export declare class PaymentReadService implements PaymentReadPort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    findById(id: string): Promise<PaymentRecord | null>;
+    listByOrderId(orderId: string): Promise<PaymentRecord[]>;
+    findLatestForOrder(orderId: string): Promise<PaymentRecord | null>;
+    findByExternalReference(externalReference: string): Promise<PaymentRecord | null>;
+    countByPaymentMethod(paymentMethodId: string): Promise<number>;
+}
+export declare function toPaymentRecord(payment: Payment): PaymentRecord;
+//# sourceMappingURL=payment-read-port.d.ts.map

package/dist/backend/services/payment-read-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-read-port.d.ts","sourceRoot":"","sources":["../../../src/backend/services/payment-read-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAKnD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IASxD,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IASlE,uBAAuB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IASjF,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAiB/D"}

package/dist/backend/services/payment-read-port.js

@@ -0,0 +1,64 @@
+import { Payment } from '../entities/payment.entity.js';
+/**
+ * The row-level read model `payments` publishes (feature 075, Phase P).
+ *
+ * Sixteen of this module's 35 inbound import sites are `em.findOne(Payment, …)`
+ * — the same four lookups written out once per gateway, with each gateway
+ * spelling "the latest attempt" slightly differently (`attemptNo` descending
+ * in two, `createdAt` descending in the others). Publishing the read fixes
+ * that ordering in one place: `attemptNo` first, `createdAt` as the tiebreak,
+ * which is the ordering the attempt counter is maintained for.
+ *
+ * The money columns stay strings: they are `decimal(14,2)`, and every consumer
+ * forwards the figure to a payment provider.
+ *
+ * `countByPaymentMethod` joined it for feature 075. It answers the one question
+ * `payment_methods` had been asking of this module's table directly, in raw SQL
+ * inside its delete Command — a boundary crossing that named no import
+ * specifier and so compiled, returned rows and went unseen until
+ * `check:module-boundary` learned to read a SQL statement.
+ */
+export class PaymentReadService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async findById(id) {
+        const payment = await this.emFactory().findOne(Payment, { id });
+        return payment ? toPaymentRecord(payment) : null;
+    }
+    async listByOrderId(orderId) {
+        const payments = await this.emFactory().find(Payment, { orderId }, { orderBy: { attemptNo: 'desc', createdAt: 'desc' } });
+        return payments.map(toPaymentRecord);
+    }
+    async findLatestForOrder(orderId) {
+        const payment = await this.emFactory().findOne(Payment, { orderId }, { orderBy: { attemptNo: 'desc', createdAt: 'desc' } });
+        return payment ? toPaymentRecord(payment) : null;
+    }
+    async findByExternalReference(externalReference) {
+        const payment = await this.emFactory().findOne(Payment, { externalReference }, { orderBy: { attemptNo: 'desc', createdAt: 'desc' } });
+        return payment ? toPaymentRecord(payment) : null;
+    }
+    async countByPaymentMethod(paymentMethodId) {
+        return this.emFactory().count(Payment, { paymentMethodId });
+    }
+}
+export function toPaymentRecord(payment) {
+    return {
+        id: payment.id,
+        orderId: payment.orderId,
+        paymentMethodId: payment.paymentMethodId,
+        status: payment.status,
+        amount: payment.amount,
+        refundedAmount: payment.refundedAmount,
+        currency: payment.currency,
+        paidAt: payment.paidAt ?? null,
+        externalReference: payment.externalReference ?? null,
+        providerDetails: payment.providerDetails ?? null,
+        failureReason: payment.failureReason ?? null,
+        attemptNo: payment.attemptNo,
+        createdAt: payment.createdAt,
+        updatedAt: payment.updatedAt,
+    };
+}
+//# sourceMappingURL=payment-read-port.js.map

package/dist/backend/services/payment-read-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-read-port.js","sourceRoot":"","sources":["../../../src/backend/services/payment-read-port.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,SAA8B;QAA9B,cAAS,GAAT,SAAS,CAAqB;IAAG,CAAC;IAE/D,KAAK,CAAC,QAAQ,CAAC,EAAU;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAC1C,OAAO,EACP,EAAE,OAAO,EAAE,EACX,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CACtD,CAAC;QACF,OAAO,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,OAAe;QACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAC5C,OAAO,EACP,EAAE,OAAO,EAAE,EACX,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CACtD,CAAC;QACF,OAAO,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,iBAAyB;QACrD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAC5C,OAAO,EACP,EAAE,iBAAiB,EAAE,EACrB,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CACtD,CAAC;QACF,OAAO,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,eAAuB;QAChD,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;QACpD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;QAChD,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC5C,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC"}

package/dist/backend/services/payment-reference-port.d.ts

@@ -0,0 +1,29 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { PaymentReferencePort } from '@endora-commerce/contracts';
+/**
+ * The one write the four payment gateways make into this module's table
+ * (feature 075, Phase P) — the write side of
+ * `PaymentReadPort.findByExternalReference`.
+ *
+ * Each gateway opens its own provider object for an attempt (a Stripe
+ * PaymentIntent or Checkout Session, a TPay transaction, a PayU order, an
+ * Autopay transaction) and then records that object's identifier on the
+ * attempt, so a later provider event carrying only the provider's reference
+ * resolves back to a payment. Four modules were doing it with
+ * `em.findOne(Payment, …)` and a field assignment, which is this module's row
+ * being written by somebody else's `EntityManager`.
+ *
+ * It is deliberately not on the Command Bus, and the four call sites all say
+ * why in their own words: this is provider-integration bookkeeping, not an
+ * operator decision. The state change an operator is answerable for is the
+ * settlement, and that is audited in the payments/orders flow.
+ */
+export declare class PaymentReferenceService implements PaymentReferencePort {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    stampExternalReference(paymentId: string, externalReference: string): Promise<boolean>;
+    stampExternalReferenceIfAbsent(paymentId: string, externalReference: string): Promise<boolean>;
+    mergeProviderDetails(paymentId: string, patch: Record<string, unknown>): Promise<boolean>;
+    private stamp;
+}
+//# sourceMappingURL=payment-reference-port.d.ts.map

package/dist/backend/services/payment-reference-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-reference-port.d.ts","sourceRoot":"","sources":["../../../src/backend/services/payment-reference-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGvE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,YAAW,oBAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQtF,8BAA8B,CAClC,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,OAAO,CAAC;IAMb,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC;YAYL,KAAK;CAqBpB"}