@endora-commerce/mod-payments 0.100.0

package/dist/backend/drivers/gateway-adapter-port.js

@@ -0,0 +1,18 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+/**
+ * Default placeholder until a per-vendor adapter is wired by the
+ * integrations module's composition root. Implements the contract
+ * surface so type-checking passes everywhere; throws at runtime when
+ * the order-placement transaction tries to use it.
+ */
+export class GatewayAdapterPortNotWired {
+    vendor = 'unwired';
+    async reserve(_input) {
+        throw new HttpError(501, ERROR_CODES.INTERNAL, 'No payment-gateway adapter is configured. Configure a vendor under /admin/integrations or use a non-gateway PaymentMethod.');
+    }
+    async settle(_input) {
+        throw new HttpError(501, ERROR_CODES.INTERNAL, 'No payment-gateway adapter is configured.');
+    }
+}
+//# sourceMappingURL=gateway-adapter-port.js.map

package/dist/backend/drivers/gateway-adapter-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-adapter-port.js","sourceRoot":"","sources":["../../../src/backend/drivers/gateway-adapter-port.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AA+C3D;;;;;GAKG;AACH,MAAM,OAAO,0BAA0B;IAC5B,MAAM,GAAG,SAAS,CAAC;IAE5B,KAAK,CAAC,OAAO,CAAC,MAA2B;QACvC,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,QAAQ,EACpB,4HAA4H,CAC7H,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA0B;QACrC,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,QAAQ,EACpB,2CAA2C,CAC5C,CAAC;IACJ,CAAC;CACF"}

package/dist/backend/drivers/pickup-driver.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pickup driver (T140).
+ *
+ * Used when the buyer pays in cash on pickup. No external integration,
+ * no `nextAction` for the storefront to navigate to — the order stays
+ * `paymentStatus='awaiting_payment'` until staff settles it on receipt
+ * via `POST /api/v1/admin/orders/:id/payment-status`.
+ *
+ * Captured here so the spec's `payments/drivers/*-driver.ts` layout
+ * exists; the order-service dispatch refactor that consumes the driver
+ * registry is a separate slice.
+ */
+export interface PickupReserveResult {
+    paymentRef: null;
+    nextAction: {
+        kind: 'none';
+    };
+}
+export declare class PickupDriver {
+    readonly kind: "pickup";
+    reserve(): PickupReserveResult;
+}
+//# sourceMappingURL=pickup-driver.d.ts.map

package/dist/backend/drivers/pickup-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickup-driver.d.ts","sourceRoot":"","sources":["../../../src/backend/drivers/pickup-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,OAAO,IAAI,mBAAmB;CAG/B"}

package/dist/backend/drivers/pickup-driver.js

@@ -0,0 +1,19 @@
+/**
+ * Pickup driver (T140).
+ *
+ * Used when the buyer pays in cash on pickup. No external integration,
+ * no `nextAction` for the storefront to navigate to — the order stays
+ * `paymentStatus='awaiting_payment'` until staff settles it on receipt
+ * via `POST /api/v1/admin/orders/:id/payment-status`.
+ *
+ * Captured here so the spec's `payments/drivers/*-driver.ts` layout
+ * exists; the order-service dispatch refactor that consumes the driver
+ * registry is a separate slice.
+ */
+export class PickupDriver {
+    kind = 'pickup';
+    reserve() {
+        return { paymentRef: null, nextAction: { kind: 'none' } };
+    }
+}
+//# sourceMappingURL=pickup-driver.js.map

package/dist/backend/drivers/pickup-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickup-driver.js","sourceRoot":"","sources":["../../../src/backend/drivers/pickup-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,QAAiB,CAAC;IAElC,OAAO;QACL,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IAC5D,CAAC;CACF"}

package/dist/backend/email-templates/transactional-defaults.d.ts

@@ -0,0 +1,6 @@
+export declare const PAYMENT_STATUS_CHANGED_DEFAULT: {
+    defaultSubject: Record<string, string>;
+    defaultContent: Record<string, unknown>;
+    languages: string[];
+};
+//# sourceMappingURL=transactional-defaults.d.ts.map

package/dist/backend/email-templates/transactional-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-defaults.d.ts","sourceRoot":"","sources":["../../../src/backend/email-templates/transactional-defaults.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,8BAA8B;oBAIpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;oBAetB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;CAE7B,CAAC"}

package/dist/backend/email-templates/transactional-defaults.js

@@ -0,0 +1,27 @@
+// Default subject + content for the payment_status_changed transactional email
+// (feature 047). Simple layout via shared header/footer embeds.
+import { simpleEmailBodyTree } from '@endora-commerce/email-components/defaults/simple-email-body';
+const LANGS = ['en-US', 'pl-PL'];
+export const PAYMENT_STATUS_CHANGED_DEFAULT = {
+    defaultSubject: {
+        'en-US': 'Payment update for order {{var order.businessId}}',
+        'pl-PL': 'Aktualizacja płatności dla zamówienia {{var order.businessId}}',
+    },
+    defaultContent: {
+        schema_version: 1,
+        languages: {
+            'en-US': simpleEmailBodyTree({
+                idPrefix: 'payment',
+                heading: 'Payment update',
+                text: 'The payment status for your order {{var order.businessId}} is now: {{var payment.statusLabel}}.\n{{if payment.failureReason}}Reason: {{var payment.failureReason}}{{/if}}',
+            }),
+            'pl-PL': simpleEmailBodyTree({
+                idPrefix: 'payment',
+                heading: 'Aktualizacja płatności',
+                text: 'Status płatności dla Twojego zamówienia {{var order.businessId}} to teraz: {{var payment.statusLabel}}.\n{{if payment.failureReason}}Powód: {{var payment.failureReason}}{{/if}}',
+            }),
+        },
+    },
+    languages: LANGS,
+};
+//# sourceMappingURL=transactional-defaults.js.map

package/dist/backend/email-templates/transactional-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-defaults.js","sourceRoot":"","sources":["../../../src/backend/email-templates/transactional-defaults.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gEAAgE;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8DAA8D,CAAC;AAEnG,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAEjC,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,cAAc,EAAE;QACd,OAAO,EAAE,mDAAmD;QAC5D,OAAO,EAAE,gEAAgE;KAChD;IAC3B,cAAc,EAAE;QACd,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE;YACT,OAAO,EAAE,mBAAmB,CAAC;gBAC3B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,gBAAgB;gBACzB,IAAI,EAAE,2KAA2K;aAClL,CAAC;YACF,OAAO,EAAE,mBAAmB,CAAC;gBAC3B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,wBAAwB;gBACjC,IAAI,EAAE,kLAAkL;aACzL,CAAC;SACH;KACyB;IAC5B,SAAS,EAAE,KAAK;CACjB,CAAC"}

package/dist/backend/entities/payment.entity.d.ts

@@ -0,0 +1,26 @@
+import { OptionalProps } from '@mikro-orm/core';
+export declare class Payment {
+    [OptionalProps]?: 'id' | 'createdAt' | 'updatedAt' | 'status' | 'paidAt' | 'externalReference' | 'providerDetails' | 'failureReason' | 'attemptNo' | 'refundedAmount';
+    id: string;
+    orderId: string;
+    paymentMethodId: string;
+    status: 'awaiting_payment' | 'paid' | 'failed' | 'deferred' | 'refunded' | 'partially_refunded';
+    amount: string;
+    /**
+     * Cumulative amount refunded against this payment (feature 049). Kept in sync
+     * with the gateway's authoritative total via the `charge.refunded` webhook.
+     */
+    refundedAmount: string;
+    currency: string;
+    paidAt?: Date | null;
+    externalReference?: string | null;
+    /** Adapter/PSP payload captured on receive_payment (feature 034). */
+    providerDetails?: Record<string, unknown> | null;
+    /** Populated on a failure outcome. */
+    failureReason?: string | null;
+    /** Retry sequence per order: 1 = first attempt. */
+    attemptNo: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=payment.entity.d.ts.map

package/dist/backend/entities/payment.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/payment.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAIrF,qBAEa,OAAO;IAClB,CAAC,aAAa,CAAC,CAAC,EACZ,IAAI,GACJ,WAAW,GACX,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,WAAW,GACX,gBAAgB,CAAC;IAGrB,EAAE,EAAE,MAAM,CAAgB;IAI1B,OAAO,EAAG,MAAM,CAAC;IAGjB,eAAe,EAAG,MAAM,CAAC;IAIzB,MAAM,EACF,kBAAkB,GAClB,MAAM,GACN,QAAQ,GACR,UAAU,GACV,UAAU,GACV,oBAAoB,CAAsB;IAG9C,MAAM,EAAG,MAAM,CAAC;IAEhB;;;OAGG;IAEH,cAAc,EAAE,MAAM,CAAO;IAG7B,QAAQ,EAAG,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAGrB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,qEAAqE;IAErE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEjD,sCAAsC;IAEtC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,mDAAmD;IAEnD,SAAS,EAAE,MAAM,CAAK;IAGtB,SAAS,EAAE,IAAI,CAAc;IAG7B,SAAS,EAAE,IAAI,CAAc;CAC9B"}

package/dist/backend/entities/payment.entity.js

@@ -0,0 +1,100 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { GlobalEntity } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+let Payment = class Payment {
+    [OptionalProps];
+    id = randomUUID();
+    orderId;
+    paymentMethodId;
+    status = 'awaiting_payment';
+    amount;
+    /**
+     * Cumulative amount refunded against this payment (feature 049). Kept in sync
+     * with the gateway's authoritative total via the `charge.refunded` webhook.
+     */
+    refundedAmount = '0';
+    currency;
+    paidAt;
+    externalReference;
+    /** Adapter/PSP payload captured on receive_payment (feature 034). */
+    providerDetails;
+    /** Populated on a failure outcome. */
+    failureReason;
+    /** Retry sequence per order: 1 = first attempt. */
+    attemptNo = 1;
+    createdAt = new Date();
+    updatedAt = new Date();
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], Payment.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    Index(),
+    __metadata("design:type", String)
+], Payment.prototype, "orderId", void 0);
+__decorate([
+    Property({ type: 'uuid' }),
+    __metadata("design:type", String)
+], Payment.prototype, "paymentMethodId", void 0);
+__decorate([
+    Property({ type: 'string', length: 32 }),
+    Index(),
+    __metadata("design:type", String)
+], Payment.prototype, "status", void 0);
+__decorate([
+    Property({ type: 'decimal', precision: 14, scale: 2 }),
+    __metadata("design:type", String)
+], Payment.prototype, "amount", void 0);
+__decorate([
+    Property({ type: 'decimal', precision: 14, scale: 2 }),
+    __metadata("design:type", String)
+], Payment.prototype, "refundedAmount", void 0);
+__decorate([
+    Property({ type: 'string', length: 3 }),
+    __metadata("design:type", String)
+], Payment.prototype, "currency", void 0);
+__decorate([
+    Property({ type: 'datetime', nullable: true }),
+    __metadata("design:type", Object)
+], Payment.prototype, "paidAt", void 0);
+__decorate([
+    Property({ type: 'string', length: 255, nullable: true }),
+    __metadata("design:type", Object)
+], Payment.prototype, "externalReference", void 0);
+__decorate([
+    Property({ type: 'json', nullable: true }),
+    __metadata("design:type", Object)
+], Payment.prototype, "providerDetails", void 0);
+__decorate([
+    Property({ type: 'text', nullable: true }),
+    __metadata("design:type", Object)
+], Payment.prototype, "failureReason", void 0);
+__decorate([
+    Property({ type: 'integer' }),
+    __metadata("design:type", Number)
+], Payment.prototype, "attemptNo", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], Payment.prototype, "createdAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onUpdate: () => new Date() }),
+    __metadata("design:type", Date)
+], Payment.prototype, "updatedAt", void 0);
+Payment = __decorate([
+    GlobalEntity(),
+    Entity({ tableName: 'payments' })
+], Payment);
+export { Payment };
+//# sourceMappingURL=payment.entity.js.map

package/dist/backend/entities/payment.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/payment.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAI7B,IAAM,OAAO,GAAb,MAAM,OAAO;IAClB,CAAC,aAAa,CAAC,CAUM;IAGrB,EAAE,GAAW,UAAU,EAAE,CAAC;IAI1B,OAAO,CAAU;IAGjB,eAAe,CAAU;IAIzB,MAAM,GAMqB,kBAAkB,CAAC;IAG9C,MAAM,CAAU;IAEhB;;;OAGG;IAEH,cAAc,GAAW,GAAG,CAAC;IAG7B,QAAQ,CAAU;IAGlB,MAAM,CAAe;IAGrB,iBAAiB,CAAiB;IAElC,qEAAqE;IAErE,eAAe,CAAkC;IAEjD,sCAAsC;IAEtC,aAAa,CAAiB;IAE9B,mDAAmD;IAEnD,SAAS,GAAW,CAAC,CAAC;IAGtB,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;IAG7B,SAAS,GAAS,IAAI,IAAI,EAAE,CAAC;CAC9B,CAAA;AAvDC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;mCACH;AAI1B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE;;wCACS;AAGjB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;gDACF;AAIzB;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,KAAK,EAAE;;uCAOsC;AAG9C;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;;uCACvC;AAOhB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;;+CAC1B;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;;yCACtB;AAGlB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;uCAC1B;AAGrB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACxB;AAIlC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDACM;AAIjD;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CACb;AAI9B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;;0CACR;AAGtB;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;0CAAc;AAG7B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAChD,IAAI;0CAAc;AApElB,OAAO;IAFnB,YAAY,EAAE;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;GACrB,OAAO,CAqEnB"}

package/dist/backend/index.d.ts

@@ -0,0 +1,88 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { GatewayRefundRegistryPort, PaymentAdapterRegistryPort } from '@endora-commerce/contracts';
+import type { FastifyReply, FastifyRequest } from 'fastify';
+import type { EventBus } from '@endora-commerce/platform/events';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import type { OrganizationReadPort } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import { Payment } from './entities/payment.entity.js';
+import { ReceivePaymentHandler } from './services/receive-payment-handler.js';
+import { PaymentService } from './services/payment-service.js';
+import { PaymentRetryService } from './services/payment-retry-service.js';
+import { PaymentEmailNotifier } from './services/payment-email-notifier.js';
+import type { PaymentEmailNotifierDeps } from './services/payment-email-notifier.js';
+/**
+ * `payments` — the delivery-side twin of `shipments`, with the same history
+ * (feature 072, wave 3, T126).
+ *
+ * Like `shipments` before T124, this module owned a manifest, entities, two
+ * services, a route file and a transactional email, and registered none of it:
+ * `orders/plugin.ts` imported both services, constructed them inside its own
+ * plugin and mounted the routes there. So the payment lifecycle answered
+ * whenever `orders` was on, and switching `payments` off did nothing — there
+ * was no seam for a gate to sit on.
+ *
+ * The payment-status notifier moves in with it, and it is the same
+ * finding twice: both roots built it and called `attach(eventBus)`, subscribing
+ * to the raw bus rather than through `subscribeForModule`, so a payment-status
+ * e-mail went out whether or not the module was on. `ctx.subscribe` gates it and
+ * `attach()` is deleted, leaving no ungated path to fall back into.
+ *
+ * The order-status registry is already a port `delivery_methods` provides, and
+ * the manifest already declares that dependency. The transactional-email sender
+ * stays contributed: `transactional_emails` announces it through a callback a
+ * root holds, later than this module composes, so a port would point the
+ * dependency at a module that does not yet have the value.
+ *
+ * **The four built-in adapters came home in T143a cluster 6.** They live in
+ * this module (`adapters/built-in-adapters.ts`); `payment_methods` merely holds
+ * the registry, and its `backend.ts` says outright that seeding them from there
+ * would be a reach into another module's internals. Both roots did it instead,
+ * which made "which payment kinds this platform can settle" a property of the
+ * composition rather than of the module that implements them — and left the
+ * four registered with `payments` switched off.
+ */
+/** What `payments` resolves from the container, and the names it owns. */
+export interface PaymentsCradle {
+    readonly emFactory: () => EntityManager;
+    readonly eventBus: EventBus;
+    readonly requireAdmin: RequireAdminFactory;
+    /** How this composition authenticates and names the buyer on the retry route. */
+    readonly requireCustomer: (req: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly customerAccountIdResolver: (req: FastifyRequest) => string;
+    /** The tenancy read: a suspended Organization may not pay, as it may not place. */
+    readonly organizationReadPort: OrganizationReadPort;
+    /** Owned by `payment_methods`: the table this module's adapters are listed in. */
+    readonly paymentAdapterRegistry: PaymentAdapterRegistryPort;
+    /** Contribution point: absent means a payment-status e-mail is not sent. */
+    readonly paymentEmailSender: PaymentEmailNotifierDeps['getTransactionalEmailSender'];
+    readonly paymentEmailNotifier: PaymentEmailNotifier;
+    /**
+     * This module's own refund-handler table, as the container's value — the
+     * push seam the four gateways contribute to, ungated on purpose (see the
+     * registration).
+     */
+    readonly gatewayRefundRegistry: GatewayRefundRegistryPort;
+    readonly paymentService: PaymentService;
+    readonly paymentRetryService: PaymentRetryService;
+    readonly receivePaymentHandler: ReceivePaymentHandler;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table->owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ *
+ * One class, and the one that used to cross a boundary: `orders` constructed
+ * `Payment` directly until T048, which was the last cross-module entity-class
+ * reach in the tree. What crosses now is `PaymentPlacementApplyPort`, and D-168
+ * leaves a stranger no supported spelling for the class itself.
+ */
+export declare const entities: (typeof Payment)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAGV,yBAAyB,EAGzB,0BAA0B,EAO3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EACL,qBAAqB,EAGtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAO1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAE5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAKrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtF,QAAQ,CAAC,yBAAyB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,MAAM,CAAC;IACpE,mFAAmF;IACnF,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACpD,kFAAkF;IAClF,QAAQ,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;IAC5D,4EAA4E;IAC5E,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,6BAA6B,CAAC,CAAC;IACrF,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,EAAE,yBAAyB,CAAC;IAC1D,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;CACvD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA6WvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,oBAAY,CAAC"}