@endora-commerce/contracts 0.100.0

package/dist/payment-methods.d.ts

@@ -0,0 +1,472 @@
+import { z } from 'zod';
+import { type PaymentMethodKind } from './payments.js';
+/**
+ * Payment Method adapter framework (feature 034 — Metoda Płatności).
+ *
+ * Source-of-truth schemas for the admin-managed payment-method entry and the
+ * adapter ingress, plus the behavioural `PaymentAdapter` contract a module
+ * implements to act as a payment method. The adapter `type` mirrors the
+ * existing `PaymentMethod.kind`.
+ */
+/** Adapter type — kept aligned with the existing `PaymentMethod.kind`. */
+export declare const paymentAdapterTypeSchema: z.ZodEnum<{
+    bank_transfer: "bank_transfer";
+    pickup: "pickup";
+    credit_limit: "credit_limit";
+    gateway: "gateway";
+}>;
+export type PaymentAdapterType = PaymentMethodKind;
+/**
+ * Localised name: a non-empty record of `lang → label`. A surface in language
+ * `xx` uses `name[xx]` when present; otherwise the `default` key, otherwise the
+ * first available value (see the backend name-resolver). Kept as an open record
+ * for compatibility with the existing locale-keyed payloads (`en-US`, `pl-PL`).
+ */
+export declare const paymentMethodNameSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+export type PaymentMethodName = z.infer<typeof paymentMethodNameSchema>;
+/** One selectable Order-status option (from the OrderStatusRegistry port). */
+export declare const orderStatusOptionSchema: z.ZodObject<{
+    code: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strip>;
+export type OrderStatusOption = z.infer<typeof orderStatusOptionSchema>;
+/**
+ * Admin upsert body for a payment-method entry. `kind` is required (the core
+ * discriminator); `adapter` defaults to `kind` and `statusOn*` to the seed
+ * order statuses when omitted — keeping the pre-feature-034 payload
+ * (`{ code, name, kind }`) valid while letting the richer admin form send the
+ * full configuration.
+ */
+export declare const paymentMethodUpsertSchema: z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    name: z.ZodRecord<z.ZodString, z.ZodString>;
+    kind: z.ZodEnum<{
+        bank_transfer: "bank_transfer";
+        pickup: "pickup";
+        credit_limit: "credit_limit";
+        gateway: "gateway";
+    }>;
+    adapter: z.ZodOptional<z.ZodString>;
+    additionalPrice: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+    }>>;
+    statusOnPending: z.ZodOptional<z.ZodString>;
+    statusOnSuccess: z.ZodOptional<z.ZodString>;
+    statusOnFailure: z.ZodOptional<z.ZodString>;
+    salesChannelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type PaymentMethodUpsert = z.infer<typeof paymentMethodUpsertSchema>;
+/**
+ * Whether the method is offered to buyers — feature 076, D-82.
+ *
+ * Its own body, because it is its own operation. `paymentMethodUpsertSchema`
+ * requires `name` and `kind`, so a toggle expressed through the `PUT` would
+ * have to resend the whole record, and a stale client that did would clobber a
+ * concurrent edit of fields it never meant to touch.
+ *
+ * `status` stays on the upsert as well: a full edit that happens to include
+ * availability is one legitimate operation, and removing it there would force
+ * two round trips for one form.
+ */
+export declare const paymentMethodStatusPatchSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+    }>;
+}, z.core.$strip>;
+export type PaymentMethodStatusPatch = z.infer<typeof paymentMethodStatusPatchSchema>;
+/** Admin detail (full config) response. */
+export declare const paymentMethodAdminSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+    adapter: z.ZodString;
+    kind: z.ZodEnum<{
+        bank_transfer: "bank_transfer";
+        pickup: "pickup";
+        credit_limit: "credit_limit";
+        gateway: "gateway";
+    }>;
+    name: z.ZodRecord<z.ZodString, z.ZodString>;
+    status: z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+    }>;
+    additionalPrice: z.ZodNumber;
+    statusOnPending: z.ZodString;
+    statusOnSuccess: z.ZodString;
+    statusOnFailure: z.ZodString;
+    salesChannelIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type PaymentMethodAdmin = z.infer<typeof paymentMethodAdminSchema>;
+/**
+ * Why a method can — or cannot — be offered to a buyer (issue #96).
+ *
+ * A payment method is realised by an adapter, and an adapter is contributed by
+ * a module. When that module is absent on either axis the method disappears
+ * from cart and checkout entirely, because a buyer must never be shown a
+ * payment option that cannot take their money. The *admin* keeps seeing the
+ * row — off is not uninstall — so it needs the reason, and the reason is the
+ * owning module's presence, carried verbatim rather than restated: an admin
+ * that renders `/platform/modules` can render this without learning a second
+ * vocabulary.
+ *
+ * `ownerModule` is `null` when no module contributes the method's adapter at
+ * all (a legacy row, or a module removed from the deployment); `ownerPresence`
+ * is then `null` too, and `available` is false.
+ */
+export declare const paymentMethodAvailabilitySchema: z.ZodObject<{
+    ownerModule: z.ZodNullable<z.ZodString>;
+    available: z.ZodBoolean;
+    ownerPresence: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        present: z.ZodBoolean;
+        platformState: z.ZodUnion<[z.ZodEnum<{
+            installing: "installing";
+            installed: "installed";
+            disabled: "disabled";
+            uninstalled: "uninstalled";
+        }>, z.ZodLiteral<"not-installed">]>;
+        activated: z.ZodBoolean;
+        deactivatable: z.ZodBoolean;
+        nonDeactivatableReason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PaymentMethodAvailability = z.infer<typeof paymentMethodAvailabilitySchema>;
+/** One row of the admin payment-method list: the stored config plus its availability. */
+export declare const paymentMethodAdminListItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+    adapter: z.ZodString;
+    kind: z.ZodEnum<{
+        bank_transfer: "bank_transfer";
+        pickup: "pickup";
+        credit_limit: "credit_limit";
+        gateway: "gateway";
+    }>;
+    name: z.ZodRecord<z.ZodString, z.ZodString>;
+    status: z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+    }>;
+    additionalPrice: z.ZodNumber;
+    statusOnPending: z.ZodString;
+    statusOnSuccess: z.ZodString;
+    statusOnFailure: z.ZodString;
+    salesChannelIds: z.ZodArray<z.ZodString>;
+    rendererKey: z.ZodNullable<z.ZodString>;
+    availability: z.ZodObject<{
+        ownerModule: z.ZodNullable<z.ZodString>;
+        available: z.ZodBoolean;
+        ownerPresence: z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            present: z.ZodBoolean;
+            platformState: z.ZodUnion<[z.ZodEnum<{
+                installing: "installing";
+                installed: "installed";
+                disabled: "disabled";
+                uninstalled: "uninstalled";
+            }>, z.ZodLiteral<"not-installed">]>;
+            activated: z.ZodBoolean;
+            deactivatable: z.ZodBoolean;
+            nonDeactivatableReason: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type PaymentMethodAdminListItem = z.infer<typeof paymentMethodAdminListItemSchema>;
+/** Storefront list item — what checkout needs to render an eligible method. */
+export declare const paymentMethodListItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+    adapter: z.ZodString;
+    kind: z.ZodEnum<{
+        bank_transfer: "bank_transfer";
+        pickup: "pickup";
+        credit_limit: "credit_limit";
+        gateway: "gateway";
+    }>;
+    name: z.ZodRecord<z.ZodString, z.ZodString>;
+    additionalPrice: z.ZodNumber;
+    rendererKey: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PaymentMethodListItem = z.infer<typeof paymentMethodListItemSchema>;
+/** `receive_payment` ingress payload (FR-022). */
+export declare const receivePaymentSchema: z.ZodObject<{
+    providerDetails: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    paymentId: z.ZodOptional<z.ZodString>;
+    orderId: z.ZodOptional<z.ZodString>;
+    externalReference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodEnum<{
+        success: "success";
+        failure: "failure";
+    }>;
+    failureReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type ReceivePayment = z.infer<typeof receivePaymentSchema>;
+/**
+ * What an **operator** may write into `payments.provider_details`.
+ *
+ * That column is a JSON bag, and `POST /api/v1/payments/receive` is one of the
+ * paths that fills it — the caller-supplied one. It took
+ * `z.record(z.string(), z.unknown())` and persisted the result verbatim, which
+ * is the caller deciding what the platform stores: any JSON document, of any
+ * depth and any size, echoed back in full by
+ * `GET /api/v1/admin/orders/:id/payments`. What we persist there has to be
+ * bounded by our schema rather than by somebody else's.
+ *
+ * A flat map of scalars is the bound, not a named field set, and the reason is
+ * that the column has several authors. The key vocabulary belongs to whichever
+ * adapter wrote the row — `refundedAt` and `refundReference` are the two the
+ * platform itself reads back — so enumerating keys here would be this route
+ * claiming an ownership it does not have. What it can refuse is the part that
+ * makes an unbounded bag dangerous: arbitrary nesting, unbounded strings and an
+ * unbounded number of entries. An operator settling an offline payment by hand
+ * records a bank statement line or a reference, which this admits.
+ *
+ * The bound is on the route body only. The gateway modules build `ReceivePayment`
+ * in code with their own shapes, including nested ones, and bounding *their*
+ * writes is a different repair with a different owner.
+ */
+export declare const operatorProviderDetailsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+export type OperatorProviderDetails = z.infer<typeof operatorProviderDetailsSchema>;
+/**
+ * The body of `POST /api/v1/payments/receive` — `receivePaymentSchema` with the
+ * operator's bound on `providerDetails`. Its output is assignable to
+ * `ReceivePayment`, so the handler is unchanged.
+ */
+export declare const receivePaymentRequestSchema: z.ZodObject<{
+    providerDetails: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    paymentId: z.ZodOptional<z.ZodString>;
+    orderId: z.ZodOptional<z.ZodString>;
+    externalReference: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    outcome: z.ZodEnum<{
+        success: "success";
+        failure: "failure";
+    }>;
+    failureReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type ReceivePaymentRequest = z.infer<typeof receivePaymentRequestSchema>;
+export type PaymentSurface = 'storefront' | 'admin' | 'api';
+export interface PaymentEligibilityContext {
+    paymentMethod: PaymentMethodAdmin;
+    /**
+     * The channel the buyer is on, or `null` when none is resolved — a checkout
+     * reached without a channel, an admin-created order, a direct API submission.
+     *
+     * Widened from `string` (issue #103): the narrower type left a caller with no
+     * way to say "there is no channel", so `''` was passed instead, and an empty
+     * string is not a spelling of platform-wide — it is rejected by the settings
+     * seam guard, which made every adapter that reads its own configuration
+     * answer "not eligible". An adapter must treat `null` as the platform-wide
+     * tier (or resolve the system-default channel), never as "match nothing".
+     */
+    salesChannelId: string | null;
+    organizationId: string | null;
+    customerAccountId: string | null;
+    surface: PaymentSurface;
+    /** Present at storefront checkout; opaque to the contract. */
+    cartSnapshot?: unknown;
+}
+export type StartPaymentResult = {
+    kind: 'awaiting_transfer';
+    iban: string | null;
+    reference: string;
+} | {
+    kind: 'redirect';
+    url: string;
+} | {
+    kind: 'none';
+};
+export interface ReceivePaymentContext {
+    orderId: string;
+    paymentId: string;
+    externalReference?: string | null;
+    providerDetails?: Record<string, unknown>;
+}
+export type PaymentOutcome = {
+    result: 'success';
+    externalReference?: string | null;
+    providerDetails?: Record<string, unknown>;
+} | {
+    result: 'failure';
+    failureReason: string;
+    providerDetails?: Record<string, unknown>;
+};
+export interface PaymentAdapter {
+    readonly adapterKey: string;
+    readonly type: PaymentAdapterType;
+    validateUseOnStorefront(ctx: PaymentEligibilityContext): Promise<boolean>;
+    validateUseOnAdmin(ctx: PaymentEligibilityContext): Promise<boolean>;
+    validateUseInApi(ctx: PaymentEligibilityContext): Promise<boolean>;
+    onStorefrontOrderCreated(ctx: {
+        orderId: string;
+        paymentId: string;
+        amount: number;
+        currency: string;
+        /**
+         * Preferred over a DB reload: place-order runs inside a transaction, so a
+         * forked EM often cannot see the just-flushed Payment/Order rows yet.
+         */
+        paymentMethodCode?: string;
+        paymentMethodId?: string;
+        salesChannelId?: string | null;
+        /** Buyer identity for gateway create (TPay requires payer.email + payer.name). */
+        payerEmail?: string | null;
+        payerName?: string | null;
+        billingCountry?: string | null;
+        orderBusinessId?: string | null;
+    }): Promise<StartPaymentResult>;
+    onReceivePayment(ctx: ReceivePaymentContext): Promise<PaymentOutcome>;
+    /** Optional renderer keys; absent ⇒ the default fallback renderer is used. */
+    readonly renderers?: {
+        storefront?: string;
+        admin?: string;
+        email?: string;
+    };
+}
+/**
+ * A payment method as it crosses a module boundary — a plain shape, never the
+ * ORM entity (FR-011).
+ *
+ * `additionalPrice` stays a string: it is `decimal(14,2)` and lands in an
+ * order's `paymentMethodSnapshot`, where the figure has to survive verbatim.
+ *
+ * The three `statusOn…` fields name **order statuses**, which are
+ * admin-configurable, so they are `string` rather than a union — see
+ * `OrderStatusRegistry` below for what validates them.
+ */
+export interface PaymentMethodRecord {
+    id: string;
+    code: string;
+    name: Record<string, string>;
+    kind: PaymentMethodKind;
+    /** The adapter registry key this method settles through. */
+    adapter: string;
+    status: 'active' | 'inactive';
+    additionalPrice: string;
+    statusOnPending: string;
+    statusOnSuccess: string;
+    statusOnFailure: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Container name: `paymentMethodReadPort`. Owner: `payment_methods`.
+ *
+ * Nineteen of this module's 33 inbound sites are `em.findOne(PaymentMethod, …)`
+ * — four gateways resolving the method behind a payment, `orders` resolving it
+ * at placement, `quick_order` resolving a buyer's default, and `payments`
+ * mapping an outcome onto an order status.
+ *
+ * `listActive` exists because two of those callers filter on
+ * `status: 'active'` and two do not, and which of the two is right depends on
+ * whether the read is a catalogue (active only) or a settlement of an order
+ * placed earlier (any, or a paid order stops being explicable the day an
+ * operator retires a method).
+ *
+ * **Owner off:** the seam fails closed — resolving this port throws
+ * `ModuleDisabledError` and the call answers 503 `MODULE_DISABLED`, so nothing
+ * half-executes. Whether `payment_methods` has an off state at all is its manifest's
+ * `activation` to say, not this line's: a module declaring
+ * `nonDeactivatable` never enters one.
+ */
+export interface PaymentMethodReadPort {
+    findById(id: string): Promise<PaymentMethodRecord | null>;
+    findByIds(ids: readonly string[]): Promise<PaymentMethodRecord[]>;
+    findByCode(code: string): Promise<PaymentMethodRecord | null>;
+    /** Every method, ordered by code — the admin catalogue and the export adapter. */
+    listAll(): Promise<PaymentMethodRecord[]>;
+    /** Only `status === 'active'`, ordered by code — the buyer-facing catalogue. */
+    listActive(): Promise<PaymentMethodRecord[]>;
+}
+/**
+ * Container name: `paymentAdapterRegistry`. Owner: `payment_methods`.
+ *
+ * A **contribution seam**: the four gateway modules push their adapter in from
+ * their boot hook and this module's catalogue reads the table. Every edge into
+ * it classifies as `contributes`, and publishing the shape must not change
+ * that.
+ *
+ * **Three members, which is the measured cross-module demand** (D-98.4).
+ * `register` names its contributor and is the extension point: a deployment's
+ * own gateway module contributes exactly as `tpay`, `stripe`, `payu`, `autopay`
+ * and `payments`' built-ins do. `get` and `ownerOf` are the two reads `orders`
+ * makes. `get` filters on the contributor's effective state and **returns
+ * `undefined` when the key is unregistered or its owner is absent** — one
+ * answer for both, which is what a cross-module caller has to handle — while
+ * `ownerOf` deliberately does not filter, because an admin screen has to keep
+ * showing a method *and* the reason it is unavailable. That sentence is why
+ * `ownerOf` is published at all.
+ *
+ * **The enumeration and throwing-resolution halves are the owner's own**, and
+ * this says so rather than leaving them to be restored as an oversight.
+ * `list` and `isAvailable` are how the catalogue decides what a buyer may pick;
+ * `listAll` is how the admin screen shows a method whose gateway is off;
+ * `isRegistered` is `payment_methods`' own route guard; `resolve` is the
+ * throwing twin `get` exists to avoid across a boundary. They are correct
+ * methods on a correct class — which keeps all nine and keeps `implements` —
+ * and a cross-module caller gets `get` and handles `undefined`. `unregister` is
+ * the same and stronger: withdrawing another module's contribution is the
+ * deactivation axis wearing a method name. (`entry` is on the class too and
+ * never was on this interface.)
+ *
+ * A member returns here when a cross-module caller can be quoted for it with
+ * `file:line` — the standard D-98.4 sets for every widening, not just this one.
+ *
+ * **Owner off:** nothing throws here. This is a **contribution seam**, a plain
+ * `di.register` rather than a `providePort`, so a push still lands and
+ * `payment_methods` filters by contributor when it enumerates. Converting it to
+ * `providePort` would move every edge into it from `contributes` to
+ * `fails-closed` in the deactivation-consequence ledger, and change the
+ * sentence the operator's confirmation dialog renders.
+ */
+export interface PaymentAdapterRegistryPort {
+    /** Contribute an adapter, naming the module it belongs to. */
+    register(adapter: PaymentAdapter, module: string): void;
+    /** The adapter, or `undefined` when unregistered or its owner is absent. */
+    get(adapterKey: string): PaymentAdapter | undefined;
+    /** Which module contributed the key, or `null` when nobody did. */
+    ownerOf(adapterKey: string): string | null;
+}
+/**
+ * Container name: `paymentOrderStatusRegistry`. Owner: `payment_methods`.
+ * Container name: `shippingOrderStatusRegistry`. Owner: `delivery_methods`.
+ *
+ * **One shape, two providers, and that is why the type is declared once.** Both
+ * modules map an outcome onto an order status, and each registers its own
+ * `EnumOrderStatusRegistry` under its own container name; the interface was
+ * declared twice, in the same words, until feature 075's Phase P moved it here.
+ * A consumer resolves whichever of the two names belongs to the outcome it is
+ * mapping — `payments` the payment one, `shipments` the shipping one — and
+ * neither name is a substitute for the other.
+ *
+ * `statusOnPending` / `statusOnSuccess` / `statusOnFailure` on a payment method
+ * reference *order statuses*. This port answers which codes are nameable, and
+ * consumers depend only on it — so the eventual admin-configurable registry
+ * drops in with no change here.
+ *
+ * It deliberately does not touch the order: applying a status is done by the
+ * caller, which already owns it (Principle I).
+ *
+ * **The absent-owner policy is honour, and the reason is that there is nothing
+ * to skip** (issue #129). The option set is fixed at compile time, so the
+ * registry holds no per-contributor state an operator's flip could invalidate.
+ * The reads are guards, not surfaces: `payments` asks `has` before moving an
+ * order into the status a settled payment names, so a skip would silently
+ * leave a paid order in its old status and a throw would make a PSP webhook
+ * retry forever. A status a live order is in has to stay nameable while the
+ * module holding the table is off. `shipments` reads the shipping name the
+ * same way and for the same reason, which is why **both** registrations are
+ * ordinary `ctx.di.register` calls rather than gated ports: publication says
+ * what the name promises, not whether a gate stands in front of it.
+ */
+export interface OrderStatusRegistry {
+    /** The selectable order-status options (code + human label). */
+    list(): OrderStatusOption[];
+    /** True when `code` is a known order status. */
+    has(code: string): boolean;
+    /** Throws when `code` is not a known order status. */
+    assertValid(code: string): void;
+}
+//# sourceMappingURL=payment-methods.d.ts.map

package/dist/payment-methods.d.ts.map

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

package/dist/payment-methods.js

@@ -0,0 +1,175 @@
+import { z } from 'zod';
+import { uuidSchema } from './common.js';
+import { ModulePresenceSchema } from './modules.js';
+import { paymentMethodKindSchema } from './payments.js';
+/**
+ * Payment Method adapter framework (feature 034 — Metoda Płatności).
+ *
+ * Source-of-truth schemas for the admin-managed payment-method entry and the
+ * adapter ingress, plus the behavioural `PaymentAdapter` contract a module
+ * implements to act as a payment method. The adapter `type` mirrors the
+ * existing `PaymentMethod.kind`.
+ */
+/** Adapter type — kept aligned with the existing `PaymentMethod.kind`. */
+export const paymentAdapterTypeSchema = paymentMethodKindSchema;
+/**
+ * Localised name: a non-empty record of `lang → label`. A surface in language
+ * `xx` uses `name[xx]` when present; otherwise the `default` key, otherwise the
+ * first available value (see the backend name-resolver). Kept as an open record
+ * for compatibility with the existing locale-keyed payloads (`en-US`, `pl-PL`).
+ */
+export const paymentMethodNameSchema = z
+    .record(z.string(), z.string().min(1))
+    .refine((r) => Object.keys(r).length > 0, { message: 'name requires at least one entry' });
+/** One selectable Order-status option (from the OrderStatusRegistry port). */
+export const orderStatusOptionSchema = z.object({
+    code: z.string().min(1).max(64),
+    label: z.string().min(1),
+});
+/**
+ * Admin upsert body for a payment-method entry. `kind` is required (the core
+ * discriminator); `adapter` defaults to `kind` and `statusOn*` to the seed
+ * order statuses when omitted — keeping the pre-feature-034 payload
+ * (`{ code, name, kind }`) valid while letting the richer admin form send the
+ * full configuration.
+ */
+export const paymentMethodUpsertSchema = z.object({
+    code: z.string().min(1).max(64).optional(),
+    name: paymentMethodNameSchema,
+    kind: paymentAdapterTypeSchema,
+    adapter: z.string().min(1).max(64).optional(),
+    additionalPrice: z.number().finite().nonnegative().optional(),
+    status: z.enum(['active', 'inactive']).optional(),
+    statusOnPending: z.string().min(1).max(64).optional(),
+    statusOnSuccess: z.string().min(1).max(64).optional(),
+    statusOnFailure: z.string().min(1).max(64).optional(),
+    salesChannelIds: z.array(uuidSchema).optional(),
+});
+/**
+ * Whether the method is offered to buyers — feature 076, D-82.
+ *
+ * Its own body, because it is its own operation. `paymentMethodUpsertSchema`
+ * requires `name` and `kind`, so a toggle expressed through the `PUT` would
+ * have to resend the whole record, and a stale client that did would clobber a
+ * concurrent edit of fields it never meant to touch.
+ *
+ * `status` stays on the upsert as well: a full edit that happens to include
+ * availability is one legitimate operation, and removing it there would force
+ * two round trips for one form.
+ */
+export const paymentMethodStatusPatchSchema = z.object({
+    status: z.enum(['active', 'inactive']),
+});
+/** Admin detail (full config) response. */
+export const paymentMethodAdminSchema = z.object({
+    id: uuidSchema,
+    code: z.string(),
+    adapter: z.string(),
+    kind: paymentAdapterTypeSchema,
+    name: paymentMethodNameSchema,
+    status: z.enum(['active', 'inactive']),
+    additionalPrice: z.number(),
+    statusOnPending: z.string(),
+    statusOnSuccess: z.string(),
+    statusOnFailure: z.string(),
+    salesChannelIds: z.array(uuidSchema),
+});
+/**
+ * Why a method can — or cannot — be offered to a buyer (issue #96).
+ *
+ * A payment method is realised by an adapter, and an adapter is contributed by
+ * a module. When that module is absent on either axis the method disappears
+ * from cart and checkout entirely, because a buyer must never be shown a
+ * payment option that cannot take their money. The *admin* keeps seeing the
+ * row — off is not uninstall — so it needs the reason, and the reason is the
+ * owning module's presence, carried verbatim rather than restated: an admin
+ * that renders `/platform/modules` can render this without learning a second
+ * vocabulary.
+ *
+ * `ownerModule` is `null` when no module contributes the method's adapter at
+ * all (a legacy row, or a module removed from the deployment); `ownerPresence`
+ * is then `null` too, and `available` is false.
+ */
+export const paymentMethodAvailabilitySchema = z.object({
+    ownerModule: z.string().nullable(),
+    /** Registered AND its owning module effectively present. */
+    available: z.boolean(),
+    ownerPresence: ModulePresenceSchema.nullable(),
+});
+/** One row of the admin payment-method list: the stored config plus its availability. */
+export const paymentMethodAdminListItemSchema = paymentMethodAdminSchema.extend({
+    rendererKey: z.string().nullable(),
+    availability: paymentMethodAvailabilitySchema,
+});
+/** Storefront list item — what checkout needs to render an eligible method. */
+export const paymentMethodListItemSchema = z.object({
+    id: uuidSchema,
+    code: z.string(),
+    adapter: z.string(),
+    kind: paymentAdapterTypeSchema,
+    name: paymentMethodNameSchema,
+    additionalPrice: z.number(),
+    rendererKey: z.string().nullable(),
+});
+/**
+ * The fields a settlement carries whichever door it arrives through. Split out
+ * so the operator's HTTP body and the gateway modules' in-code payload differ
+ * in exactly one place — `providerDetails` — and cannot drift anywhere else.
+ */
+const receivePaymentBaseShape = {
+    paymentId: uuidSchema.optional(),
+    orderId: uuidSchema.optional(),
+    externalReference: z.string().max(255).nullish(),
+    outcome: z.enum(['success', 'failure']),
+    failureReason: z.string().max(2000).nullish(),
+};
+const RECEIVE_PAYMENT_IDENTIFIER_MESSAGE = 'paymentId or (orderId + externalReference) is required';
+const hasReceivePaymentIdentifier = (d) => Boolean(d.paymentId) || Boolean(d.orderId && d.externalReference);
+/** `receive_payment` ingress payload (FR-022). */
+export const receivePaymentSchema = z
+    .object({
+    ...receivePaymentBaseShape,
+    providerDetails: z.record(z.string(), z.unknown()).optional(),
+})
+    .refine(hasReceivePaymentIdentifier, { message: RECEIVE_PAYMENT_IDENTIFIER_MESSAGE });
+/**
+ * What an **operator** may write into `payments.provider_details`.
+ *
+ * That column is a JSON bag, and `POST /api/v1/payments/receive` is one of the
+ * paths that fills it — the caller-supplied one. It took
+ * `z.record(z.string(), z.unknown())` and persisted the result verbatim, which
+ * is the caller deciding what the platform stores: any JSON document, of any
+ * depth and any size, echoed back in full by
+ * `GET /api/v1/admin/orders/:id/payments`. What we persist there has to be
+ * bounded by our schema rather than by somebody else's.
+ *
+ * A flat map of scalars is the bound, not a named field set, and the reason is
+ * that the column has several authors. The key vocabulary belongs to whichever
+ * adapter wrote the row — `refundedAt` and `refundReference` are the two the
+ * platform itself reads back — so enumerating keys here would be this route
+ * claiming an ownership it does not have. What it can refuse is the part that
+ * makes an unbounded bag dangerous: arbitrary nesting, unbounded strings and an
+ * unbounded number of entries. An operator settling an offline payment by hand
+ * records a bank statement line or a reference, which this admits.
+ *
+ * The bound is on the route body only. The gateway modules build `ReceivePayment`
+ * in code with their own shapes, including nested ones, and bounding *their*
+ * writes is a different repair with a different owner.
+ */
+export const operatorProviderDetailsSchema = z
+    .record(z.string().min(1).max(64), z.union([z.string().max(1000), z.number().finite(), z.boolean(), z.null()]))
+    .refine((details) => Object.keys(details).length <= 50, {
+    message: 'providerDetails may carry at most 50 entries',
+});
+/**
+ * The body of `POST /api/v1/payments/receive` — `receivePaymentSchema` with the
+ * operator's bound on `providerDetails`. Its output is assignable to
+ * `ReceivePayment`, so the handler is unchanged.
+ */
+export const receivePaymentRequestSchema = z
+    .object({
+    ...receivePaymentBaseShape,
+    providerDetails: operatorProviderDetailsSchema.optional(),
+})
+    .refine(hasReceivePaymentIdentifier, { message: RECEIVE_PAYMENT_IDENTIFIER_MESSAGE });
+//# sourceMappingURL=payment-methods.js.map

package/dist/payment-methods.js.map

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