@endora-commerce/mod-payments 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-payments
+
+The platform payment capability: the built-in payment adapters (bank transfer, in-person pickup, credit limit, gateway), the payment record every order carries, and the settlement lifecycle that PSP integrations plug into. Switched off, checkout offers no payment method and the shop takes no orders.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `payments` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-payments` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-payments/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-payments/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-payments/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-payments/tailwind.css` | the Tailwind source declaration for the admin code above |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/admin-kit` — *optional*
+- `@endora-commerce/contracts`
+- `@endora-commerce/email-components`
+- `@endora-commerce/mod-orders`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+- `lucide-react` ^1 — *optional*
+- `react` ^19 — *optional*
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+- `tailwind.css` — the Tailwind source declaration
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-payments
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * `payments`' admin surface — one zone contribution and nothing else (feature
+ * 091, P7d;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-component-contribution.md`
+ * §10).
+ *
+ * **This module contributes no route and no sidebar entry.** It has never had
+ * one: its operator surface is a tab on `orders`' order detail, which is
+ * exactly what made it an FR-007 case — there was no place for the owner to
+ * contribute to, so the host named the owner instead. `order.detail.payment`
+ * is that place.
+ *
+ * **What it retires**: the `visibility-gate` key
+ * `admin/src/modules/orders/OrderDetail.tsx:visibility-gate:payments` in
+ * `backend/scripts/ledgers/foreign-module-ids.ts`, whose recorded retiring
+ * condition is this contribution. `orders` computed
+ * `isVisible({ module: 'payments', requiredPermission: 'payments:read' })` for
+ * the tab button and passed the same answer down to the body; it counts the
+ * zone now (Z15) and knows only that it has a tab called Payment.
+ *
+ * **No `match`, and it is a decision rather than an omission.** `match`
+ * narrows the *mounts of one place* (Z13), and this place has one host and one
+ * mount, so there is nothing to narrow.
+ * `admin/test/modules/payments/order-payments-zone.test.tsx` asserts it absent
+ * so a later author cannot add one quietly.
+ *
+ * **This entry exports data and nothing else** (R2); every component is a
+ * dynamic-import factory (R6).
+ */
+import { type AdminContributions } from '@endora-commerce/admin-kit/contributions';
+export declare const contributions: AdminContributions;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,0CAA0C,CAAC;AAsBlD,eAAO,MAAM,aAAa,EAAE,kBAU3B,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,61 @@
+/**
+ * `payments`' admin surface — one zone contribution and nothing else (feature
+ * 091, P7d;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-component-contribution.md`
+ * §10).
+ *
+ * **This module contributes no route and no sidebar entry.** It has never had
+ * one: its operator surface is a tab on `orders`' order detail, which is
+ * exactly what made it an FR-007 case — there was no place for the owner to
+ * contribute to, so the host named the owner instead. `order.detail.payment`
+ * is that place.
+ *
+ * **What it retires**: the `visibility-gate` key
+ * `admin/src/modules/orders/OrderDetail.tsx:visibility-gate:payments` in
+ * `backend/scripts/ledgers/foreign-module-ids.ts`, whose recorded retiring
+ * condition is this contribution. `orders` computed
+ * `isVisible({ module: 'payments', requiredPermission: 'payments:read' })` for
+ * the tab button and passed the same answer down to the body; it counts the
+ * zone now (Z15) and knows only that it has a tab called Payment.
+ *
+ * **No `match`, and it is a decision rather than an omission.** `match`
+ * narrows the *mounts of one place* (Z13), and this place has one host and one
+ * mount, so there is nothing to narrow.
+ * `admin/test/modules/payments/order-payments-zone.test.tsx` asserts it absent
+ * so a later author cannot add one quietly.
+ *
+ * **This entry exports data and nothing else** (R2); every component is a
+ * dynamic-import factory (R6).
+ */
+import { zoneComponent, } from '@endora-commerce/admin-kit/contributions';
+/**
+ * The code that opens the contributed tab, read off the route in this merge
+ * request as §9.3 requires: `packages/modules/payments/src/backend/routes.ts`
+ * gates `GET /api/v1/admin/orders/:id/payments` with
+ * `requireAdmin('payments:read')`, which is also the code `orders`' own
+ * `useSurfaceVisibility` call named. §10.6's line agrees, measured rather than
+ * copied.
+ *
+ * **The panel calls a second route this code does not open**, and it is
+ * recorded rather than repaired: its invoice list is
+ * `GET /api/v1/admin/invoices?filter[orderId]=…`, gated `invoices:read` by
+ * `packages/modules/invoices/src/backend/routes.admin.ts`. A contribution
+ * declares one code, and an operator holding `payments:read` without
+ * `invoices:read` sees the tab and an error inside it — which is the behaviour
+ * the tab already had before the conversion, unchanged by it. Splitting the
+ * invoice half into an `invoices` contribution of its own is a product change
+ * and is outside P7d.
+ */
+const PAYMENTS_READ = 'payments:read';
+export const contributions = {
+    zones: [
+        // The only contribution to this member, so the weight orders nothing
+        // today. Declared rather than defaulted so a second contributor arrives
+        // beside it rather than ahead of it by accident.
+        zoneComponent('order.detail.payment', () => import('./zones/OrderPaymentsTab.js'), {
+            weight: 100,
+            requiredPermission: PAYMENTS_READ,
+        }),
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,EACL,aAAa,GAEd,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,aAAa,GAAG,eAAe,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,KAAK,EAAE;QACL,qEAAqE;QACrE,wEAAwE;QACxE,iDAAiD;QACjD,aAAa,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,6BAA6B,CAAC,EAAE;YACjF,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,aAAa;SAClC,CAAC;KACH;CACF,CAAC"}

package/dist/admin/zones/OrderPaymentsTab.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode } from 'react';
+import type { AdminZoneProps } from '@endora-commerce/contracts';
+/**
+ * Payment tab — the order's payment attempts
+ * (`GET /api/v1/admin/orders/:id/payments`) plus the invoices generated for it
+ * (`GET /api/v1/admin/invoices?filter[orderId]=…`). The PDF download reuses the
+ * order invoice endpoint already linked from the page header; it serves the
+ * most recent ready invoice, so the link is offered only for ready invoices.
+ *
+ * ## It is this module's surface on `orders`' screen now (feature 091, P7d)
+ *
+ * It stood at `admin/src/modules/orders/OrderPaymentsTab.tsx` and was rendered
+ * by `OrderDetail.tsx` behind
+ * `isVisible({ module: 'payments', requiredPermission: 'payments:read' })` —
+ * `orders` naming this module in its own file, which is the `visibility-gate`
+ * key of `backend/scripts/ledgers/foreign-module-ids.ts` that this
+ * contribution retires. The host renders `order.detail.payment` instead and
+ * shows the tab button by counting the zone (Z15); the presence axis, the
+ * permission and the ordering are the zone renderer's.
+ *
+ * **`useTranslation('core')` is kept, deliberately.** Twenty-three of the keys
+ * below are `orderDetail.*` in `_i18n`'s bundle and one family —
+ * `orderDetail.paymentStatus.*` — is read by `orders`' own list screen through
+ * `admin/src/modules/orders/paymentStatus.ts` as well. That is R-1 §9.2's
+ * *second* population, module code rendering out of `core`, which that ruling
+ * names and deliberately does **not** rule on; P7a and P7b left their moved
+ * panels on `core` for the same reason. Moving a family the host still reads
+ * would be the failure §9.2's own correction records: no throw, no 404, the
+ * raw key on the operator's screen.
+ *
+ * `apiBaseUrl` and not `import.meta.env`: this file compiles under `tsc` inside
+ * a module package, which carries no `vite/client` types, and the kit publishes
+ * the one place that expression is read.
+ */
+export type OrderPaymentsTabProps = AdminZoneProps<'order.detail.payment'>;
+export declare function OrderPaymentsTab(props: OrderPaymentsTabProps): ReactNode;
+/**
+ * The zone renderer loads a contribution through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013).
+ */
+export default OrderPaymentsTab;
+//# sourceMappingURL=OrderPaymentsTab.d.ts.map

package/dist/admin/zones/OrderPaymentsTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderPaymentsTab.d.ts","sourceRoot":"","sources":["../../../src/admin/zones/OrderPaymentsTab.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAsHjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,sBAAsB,CAAC,CAAC;AAE3E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CA+HxE;AAED;;;GAGG;AACH,eAAe,gBAAgB,CAAC"}

package/dist/admin/zones/OrderPaymentsTab.js

@@ -0,0 +1,104 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { FileDown } from 'lucide-react';
+import { apiBaseUrl, apiClient, formatDateTime, formatMoney } from '@endora-commerce/admin-kit/lib';
+import { Badge, Button, Section, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+function toLedger(payments) {
+    const entries = [];
+    for (const p of payments) {
+        const wasPaid = p.paidAt != null || p.status === 'refunded' || p.status === 'partially_refunded';
+        entries.push({
+            key: `${p.id}-charge`,
+            attemptNo: p.attemptNo,
+            amount: p.amount,
+            currency: p.currency,
+            // Keep the charge shown as "paid" even after a later refund.
+            status: wasPaid ? 'paid' : p.status,
+            at: p.paidAt,
+            reference: p.externalReference,
+            failure: p.failureReason,
+        });
+        if (p.refundedAmount > 0) {
+            entries.push({
+                key: `${p.id}-refund`,
+                attemptNo: p.attemptNo,
+                amount: -p.refundedAmount,
+                currency: p.currency,
+                status: p.refundedAmount >= p.amount ? 'refunded' : 'partially_refunded',
+                // Exact refund time when recorded; else the payment's last-updated time
+                // (when the refund was reflected) so pre-existing refunds still show a date.
+                at: p.refundedAt ?? p.updatedAt,
+                reference: p.refundReference ?? p.externalReference,
+                failure: null,
+            });
+        }
+    }
+    return entries;
+}
+const PAYMENT_STATUS_VARIANT = {
+    awaiting_payment: 'warning',
+    paid: 'success',
+    failed: 'destructive',
+    deferred: 'secondary',
+    refunded: 'outline',
+    partially_refunded: 'outline',
+};
+const INVOICE_STATUS_VARIANT = {
+    pending: 'warning',
+    ready: 'success',
+    cancelled: 'outline',
+};
+function money(amount, currency) {
+    return formatMoney(amount, currency);
+}
+export function OrderPaymentsTab(props) {
+    const t = useTranslation('core');
+    const [payments, setPayments] = useState([]);
+    const [invoices, setInvoices] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(false);
+    useEffect(() => {
+        let alive = true;
+        setLoading(true);
+        setError(false);
+        void Promise.all([
+            apiClient.get(`/api/v1/admin/orders/${props.orderId}/payments`),
+            apiClient.get(`/api/v1/admin/invoices?filter[orderId]=${props.orderId}`),
+        ])
+            .then(([p, inv]) => {
+            if (!alive)
+                return;
+            setPayments(p.data);
+            setInvoices(inv.data);
+        })
+            .catch(() => {
+            if (!alive)
+                return;
+            setError(true);
+            setPayments([]);
+            setInvoices([]);
+        })
+            .finally(() => {
+            if (alive)
+                setLoading(false);
+        });
+        return () => {
+            alive = false;
+        };
+    }, [props.orderId]);
+    const invoiceHref = `${apiBaseUrl}/api/v1/orders/${props.orderId}/invoice`;
+    if (loading) {
+        return _jsx("p", { className: "text-sm text-muted-foreground", children: t('common.state.loading') });
+    }
+    if (error) {
+        return _jsx("p", { className: "text-sm text-destructive", children: t('common.state.error') });
+    }
+    return (_jsxs(_Fragment, { children: [_jsx(Section, { title: t('orderDetail.payments.title'), children: payments.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('orderDetail.payments.empty') })) : (_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('orderDetail.payments.columns.attempt') }), _jsx(TableHead, { children: t('orderDetail.payments.columns.amount') }), _jsx(TableHead, { children: t('orderDetail.payments.columns.status') }), _jsx(TableHead, { children: t('orderDetail.payments.columns.actionDate') }), _jsx(TableHead, { children: t('orderDetail.payments.columns.reference') }), _jsx(TableHead, { children: t('orderDetail.payments.columns.failure') })] }) }), _jsx(TableBody, { children: toLedger(payments).map((e) => (_jsxs(TableRow, { children: [_jsxs(TableCell, { children: ["#", e.attemptNo] }), _jsx(TableCell, { className: "tabular-nums", children: money(e.amount, e.currency) }), _jsx(TableCell, { children: _jsx(Badge, { variant: PAYMENT_STATUS_VARIANT[e.status], children: t(`orderDetail.paymentStatus.${e.status}`) }) }), _jsx(TableCell, { children: e.at ? formatDateTime(e.at) : '—' }), _jsx(TableCell, { className: "font-mono text-xs", children: e.reference ?? '—' }), _jsx(TableCell, { className: "text-destructive", children: e.failure ?? '' })] }, e.key))) })] })) }), _jsx(Section, { title: t('orderDetail.invoices.title'), children: invoices.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('orderDetail.invoices.empty') })) : (_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('orderDetail.invoices.columns.number') }), _jsx(TableHead, { children: t('orderDetail.invoices.columns.kind') }), _jsx(TableHead, { children: t('orderDetail.invoices.columns.issuedAt') }), _jsx(TableHead, { children: t('orderDetail.invoices.columns.total') }), _jsx(TableHead, { children: t('orderDetail.invoices.columns.status') }), _jsx(TableHead, {})] }) }), _jsx(TableBody, { children: invoices.map((inv) => (_jsxs(TableRow, { children: [_jsx(TableCell, { className: "font-medium", children: inv.number }), _jsx(TableCell, { children: t(`orderDetail.invoices.kind.${inv.kind}`) }), _jsx(TableCell, { children: formatDateTime(inv.issuedAt) }), _jsx(TableCell, { className: "tabular-nums", children: money(inv.total, inv.currency) }), _jsx(TableCell, { children: _jsx(Badge, { variant: INVOICE_STATUS_VARIANT[inv.status], children: t(`orderDetail.invoices.status.${inv.status}`) }) }), _jsx(TableCell, { className: "text-right", children: inv.pdfReady ? (_jsx(Button, { asChild: true, variant: "outline", size: "sm", className: "bg-card", children: _jsxs("a", { href: invoiceHref, target: "_blank", rel: "noreferrer", children: [_jsx(FileDown, {}), t('orderDetail.invoices.download')] }) })) : null })] }, inv.id))) })] })) })] }));
+}
+/**
+ * The zone renderer loads a contribution through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013).
+ */
+export default OrderPaymentsTab;
+//# sourceMappingURL=OrderPaymentsTab.js.map

package/dist/admin/zones/OrderPaymentsTab.js.map

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

package/dist/backend/adapters/built-in-adapters.d.ts

@@ -0,0 +1,58 @@
+import type { PaymentAdapter, PaymentEligibilityContext, ReceivePaymentContext, PaymentOutcome, StartPaymentResult } from '@endora-commerce/contracts';
+declare abstract class BaseAdapter implements PaymentAdapter {
+    abstract readonly adapterKey: string;
+    abstract readonly type: PaymentAdapter['type'];
+    validateUseOnStorefront(_ctx: PaymentEligibilityContext): Promise<boolean>;
+    validateUseOnAdmin(_ctx: PaymentEligibilityContext): Promise<boolean>;
+    validateUseInApi(_ctx: PaymentEligibilityContext): Promise<boolean>;
+    abstract onStorefrontOrderCreated(ctx: {
+        orderId: string;
+        paymentId: string;
+        amount: number;
+        currency: string;
+    }): Promise<StartPaymentResult>;
+    /**
+     * Default: the ingress is the source of truth for the outcome (offline
+     * methods are settled by an admin / out-of-band). Provider details and the
+     * external reference flow straight through onto the Payment row.
+     */
+    onReceivePayment(ctx: ReceivePaymentContext): Promise<PaymentOutcome>;
+}
+/** Bank transfer (Przelew bankowy) — awaits an out-of-band transfer. */
+export declare class BankTransferAdapter extends BaseAdapter {
+    readonly adapterKey = "bank_transfer";
+    readonly type: "bank_transfer";
+    onStorefrontOrderCreated(ctx: {
+        orderId: string;
+        paymentId: string;
+        amount: number;
+        currency: string;
+    }): Promise<StartPaymentResult>;
+}
+/** Cash on delivery / pickup (`Płatność przy odbiorze`) — settled on receipt. */
+export declare class PickupAdapter extends BaseAdapter {
+    readonly adapterKey = "pickup";
+    readonly type: "pickup";
+    onStorefrontOrderCreated(): Promise<StartPaymentResult>;
+}
+/** Credit limit (`Limit kredytowy`) — reservation handled inline by OrderService. */
+export declare class CreditLimitAdapter extends BaseAdapter {
+    readonly adapterKey = "credit_limit";
+    readonly type: "credit_limit";
+    onStorefrontOrderCreated(): Promise<StartPaymentResult>;
+}
+/**
+ * Payment gateway (`Bramka płatności`) — a vendor adapter ships separately and
+ * overrides `onStorefrontOrderCreated` to return a redirect. The bundled
+ * placeholder returns `none`; the real redirect comes from the wired
+ * GatewayAdapterPort.
+ */
+export declare class GatewayAdapter extends BaseAdapter {
+    readonly adapterKey = "gateway";
+    readonly type: "gateway";
+    onStorefrontOrderCreated(): Promise<StartPaymentResult>;
+}
+/** The adapters registered for the platform's built-in payment kinds. */
+export declare function builtInPaymentAdapters(): PaymentAdapter[];
+export {};
+//# sourceMappingURL=built-in-adapters.d.ts.map

package/dist/backend/adapters/built-in-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-adapters.d.ts","sourceRoot":"","sources":["../../../src/backend/adapters/built-in-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAiBpC,uBAAe,WAAY,YAAW,cAAc;IAClD,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAEzC,uBAAuB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAG1E,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAGrE,gBAAgB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE,QAAQ,CAAC,wBAAwB,CAAC,GAAG,EAAE;QACrC,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAE/B;;;;OAIG;IACG,gBAAgB,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;CAO5E;AAED,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,QAAQ,CAAC,UAAU,mBAAmB;IACtC,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAU;IAEnC,wBAAwB,CAAC,GAAG,EAAE;QAClC,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAGhC;AAED,iFAAiF;AACjF,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,UAAU,YAAY;IAC/B,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAE5B,wBAAwB,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAG9D;AAED,qFAAqF;AACrF,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,QAAQ,CAAC,UAAU,kBAAkB;IACrC,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IAElC,wBAAwB,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAG9D;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,UAAU,aAAa;IAChC,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IAE7B,wBAAwB,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAG9D;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,IAAI,cAAc,EAAE,CAOzD"}

package/dist/backend/adapters/built-in-adapters.js

@@ -0,0 +1,83 @@
+/**
+ * Built-in payment adapters (feature 034). These formalise the pre-existing
+ * `payments/drivers/*` logic as `PaymentAdapter` implementations registered in
+ * the PaymentAdapterRegistry. All bundled adapters are offline (no external
+ * integration) except `gateway`, which delegates to the GatewayAdapterPort
+ * wired by the integrations module.
+ *
+ * Validators default to `() => true` (FR-011). `onReceivePayment` echoes the
+ * outcome the ingress already validated — the offline adapters do not
+ * independently verify a payment; the gateway adapter overrides this in a
+ * follow-up vendor module.
+ */
+const orderReference = (orderId) => `ORDER-${orderId.slice(0, 8).toUpperCase()}`;
+class BaseAdapter {
+    async validateUseOnStorefront(_ctx) {
+        return true;
+    }
+    async validateUseOnAdmin(_ctx) {
+        return true;
+    }
+    async validateUseInApi(_ctx) {
+        return true;
+    }
+    /**
+     * Default: the ingress is the source of truth for the outcome (offline
+     * methods are settled by an admin / out-of-band). Provider details and the
+     * external reference flow straight through onto the Payment row.
+     */
+    async onReceivePayment(ctx) {
+        return {
+            result: 'success',
+            externalReference: ctx.externalReference ?? null,
+            ...(ctx.providerDetails ? { providerDetails: ctx.providerDetails } : {}),
+        };
+    }
+}
+/** Bank transfer (Przelew bankowy) — awaits an out-of-band transfer. */
+export class BankTransferAdapter extends BaseAdapter {
+    adapterKey = 'bank_transfer';
+    type = 'bank_transfer';
+    async onStorefrontOrderCreated(ctx) {
+        return { kind: 'awaiting_transfer', iban: null, reference: orderReference(ctx.orderId) };
+    }
+}
+/** Cash on delivery / pickup (`Płatność przy odbiorze`) — settled on receipt. */
+export class PickupAdapter extends BaseAdapter {
+    adapterKey = 'pickup';
+    type = 'pickup';
+    async onStorefrontOrderCreated() {
+        return { kind: 'none' };
+    }
+}
+/** Credit limit (`Limit kredytowy`) — reservation handled inline by OrderService. */
+export class CreditLimitAdapter extends BaseAdapter {
+    adapterKey = 'credit_limit';
+    type = 'credit_limit';
+    async onStorefrontOrderCreated() {
+        return { kind: 'none' };
+    }
+}
+/**
+ * Payment gateway (`Bramka płatności`) — a vendor adapter ships separately and
+ * overrides `onStorefrontOrderCreated` to return a redirect. The bundled
+ * placeholder returns `none`; the real redirect comes from the wired
+ * GatewayAdapterPort.
+ */
+export class GatewayAdapter extends BaseAdapter {
+    adapterKey = 'gateway';
+    type = 'gateway';
+    async onStorefrontOrderCreated() {
+        return { kind: 'none' };
+    }
+}
+/** The adapters registered for the platform's built-in payment kinds. */
+export function builtInPaymentAdapters() {
+    return [
+        new BankTransferAdapter(),
+        new PickupAdapter(),
+        new CreditLimitAdapter(),
+        new GatewayAdapter(),
+    ];
+}
+//# sourceMappingURL=built-in-adapters.js.map

package/dist/backend/adapters/built-in-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-adapters.js","sourceRoot":"","sources":["../../../src/backend/adapters/built-in-adapters.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;GAWG;AAEH,MAAM,cAAc,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,SAAS,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AAEjG,MAAe,WAAW;IAIxB,KAAK,CAAC,uBAAuB,CAAC,IAA+B;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,kBAAkB,CAAC,IAA+B;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,gBAAgB,CAAC,IAA+B;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IASD;;;;OAIG;IACH,KAAK,CAAC,gBAAgB,CAAC,GAA0B;QAC/C,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,IAAI;YAChD,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzE,CAAC;IACJ,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IACzC,UAAU,GAAG,eAAe,CAAC;IAC7B,IAAI,GAAG,eAAwB,CAAC;IAEzC,KAAK,CAAC,wBAAwB,CAAC,GAK9B;QACC,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3F,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,OAAO,aAAc,SAAQ,WAAW;IACnC,UAAU,GAAG,QAAQ,CAAC;IACtB,IAAI,GAAG,QAAiB,CAAC;IAElC,KAAK,CAAC,wBAAwB;QAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;CACF;AAED,qFAAqF;AACrF,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACxC,UAAU,GAAG,cAAc,CAAC;IAC5B,IAAI,GAAG,cAAuB,CAAC;IAExC,KAAK,CAAC,wBAAwB;QAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,WAAW;IACpC,UAAU,GAAG,SAAS,CAAC;IACvB,IAAI,GAAG,SAAkB,CAAC;IAEnC,KAAK,CAAC,wBAAwB;QAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;CACF;AAED,yEAAyE;AACzE,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,IAAI,mBAAmB,EAAE;QACzB,IAAI,aAAa,EAAE;QACnB,IAAI,kBAAkB,EAAE;QACxB,IAAI,cAAc,EAAE;KACrB,CAAC;AACJ,CAAC"}

package/dist/backend/drivers/bank-transfer-driver.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Bank-transfer driver (T139 — already implicitly exercised by order-service).
+ *
+ * The driver is intentionally pure metadata: bank-transfer orders carry
+ * no external state beyond the proforma invoice generated at placement.
+ * The order is left in `paymentStatus='awaiting_payment'` until an admin
+ * marks it paid via `POST /api/v1/admin/orders/:id/payment-status`.
+ *
+ * Captured here so the file layout matches T141's "drivers/" directory
+ * convention; a future order-service refactor can dispatch through a
+ * registry that lives next to it.
+ */
+export interface BankTransferReserveResult {
+    paymentRef: null;
+    nextAction: {
+        kind: 'awaiting_transfer';
+        iban: string | null;
+        reference: string;
+    };
+}
+export declare class BankTransferDriver {
+    readonly kind: "bank_transfer";
+    reserve(input: {
+        orderId: string;
+        iban?: string | null;
+    }): BankTransferReserveResult;
+}
+//# sourceMappingURL=bank-transfer-driver.d.ts.map

package/dist/backend/drivers/bank-transfer-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-transfer-driver.d.ts","sourceRoot":"","sources":["../../../src/backend/drivers/bank-transfer-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE;QAAE,IAAI,EAAE,mBAAmB,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACnF;AAED,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAU;IAEzC,OAAO,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,yBAAyB;CAUrF"}

package/dist/backend/drivers/bank-transfer-driver.js

@@ -0,0 +1,26 @@
+/**
+ * Bank-transfer driver (T139 — already implicitly exercised by order-service).
+ *
+ * The driver is intentionally pure metadata: bank-transfer orders carry
+ * no external state beyond the proforma invoice generated at placement.
+ * The order is left in `paymentStatus='awaiting_payment'` until an admin
+ * marks it paid via `POST /api/v1/admin/orders/:id/payment-status`.
+ *
+ * Captured here so the file layout matches T141's "drivers/" directory
+ * convention; a future order-service refactor can dispatch through a
+ * registry that lives next to it.
+ */
+export class BankTransferDriver {
+    kind = 'bank_transfer';
+    reserve(input) {
+        return {
+            paymentRef: null,
+            nextAction: {
+                kind: 'awaiting_transfer',
+                iban: input.iban ?? null,
+                reference: `ORDER-${input.orderId.slice(0, 8).toUpperCase()}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=bank-transfer-driver.js.map

package/dist/backend/drivers/bank-transfer-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bank-transfer-driver.js","sourceRoot":"","sources":["../../../src/backend/drivers/bank-transfer-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,eAAwB,CAAC;IAEzC,OAAO,CAAC,KAAgD;QACtD,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE;gBACV,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;gBACxB,SAAS,EAAE,SAAS,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE;aAC9D;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/backend/drivers/gateway-adapter-port.d.ts

@@ -0,0 +1,71 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+/**
+ * Gateway adapter port (T141 / FR-009).
+ *
+ * Per-vendor payment-gateway adapters implement this interface in
+ * follow-up specs (Stripe, Przelewy24, PayU, …). The port stays in the
+ * core so the order-placement transaction has a stable contract to
+ * dispatch through, and so a gateway adapter can be swapped without
+ * touching `order-service.ts`.
+ *
+ * Until a real adapter ships, `GatewayAdapterPortNotWired` returns
+ * `501 NOT_IMPLEMENTED` from any reserve/settle call. Order placement
+ * with a `gateway`-kind PaymentMethod therefore fails fast with a clear
+ * error rather than silently 500'ing.
+ */
+export type Currency = string;
+export interface GatewayReserveInput {
+    orderId: string;
+    organizationId: string;
+    amount: number;
+    currency: Currency;
+    /** Per-payment-method config; opaque to the port. */
+    vendorConfig: Record<string, unknown>;
+    tx: EntityManager;
+}
+export interface GatewaySettleInput {
+    orderId: string;
+    paymentRef: string;
+    vendorConfig: Record<string, unknown>;
+    tx: EntityManager;
+}
+export type GatewayReserveResult = {
+    ok: true;
+    paymentRef: string;
+    nextAction: {
+        kind: 'redirect';
+        url: string;
+    } | {
+        kind: 'none';
+    };
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+export interface GatewayAdapterPort {
+    /** Vendor identifier, e.g. `stripe`. Matches the adapter's own module. */
+    readonly vendor: string;
+    reserve(input: GatewayReserveInput): Promise<GatewayReserveResult>;
+    settle(input: GatewaySettleInput): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        code: string;
+    }>;
+}
+/**
+ * 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 declare class GatewayAdapterPortNotWired implements GatewayAdapterPort {
+    readonly vendor = "unwired";
+    reserve(_input: GatewayReserveInput): Promise<GatewayReserveResult>;
+    settle(_input: GatewaySettleInput): Promise<{
+        ok: false;
+        code: string;
+    }>;
+}
+//# sourceMappingURL=gateway-adapter-port.d.ts.map

package/dist/backend/drivers/gateway-adapter-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-adapter-port.d.ts","sourceRoot":"","sources":["../../../src/backend/drivers/gateway-adapter-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,EAAE,EAAE,aAAa,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,EAAE,EAAE,aAAa,CAAC;CACnB;AAED,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAClG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnE,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxF;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,QAAQ,CAAC,MAAM,aAAa;IAEtB,OAAO,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQnE,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAO/E"}