@endora-commerce/mod-returns 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,60 @@
+<!-- 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-returns
+
+Return/complaint (RMA) case management, settlement, and refunds.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `returns` — 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-returns` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-returns/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-returns/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-returns/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-returns/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/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+- `lucide-react` ^1 — *optional*
+- `react` ^19 — *optional*
+- `react-router-dom` ^7 — *optional*
+- `zod` ^4
+
+## 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-returns
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/api/returns-client.d.ts

@@ -0,0 +1,69 @@
+import type { AdminReturnsListResponse, BulkTransitionResult, ReturnCaseCommentDto, ReturnCaseDetail, ReturnDeliveryMethodDto, ReturnReasonDto, ReturnStatusGraphResponse, SettlementPrefill, SettlementResult } from '@endora-commerce/contracts';
+/** Typed admin client for the returns module (feature 046). */
+export declare const returnsClient: {
+    list: (qs: string) => Promise<AdminReturnsListResponse>;
+    get: (id: string) => Promise<ReturnCaseDetail>;
+    authorize: (id: string) => Promise<{
+        rmaNumber: string;
+        statusCode: string;
+    }>;
+    reject: (id: string, reason: string) => Promise<ReturnCaseDetail>;
+    transition: (id: string, to: string, reason?: string) => Promise<ReturnCaseDetail>;
+    bulkTransition: (ids: string[], to: string) => Promise<BulkTransitionResult>;
+    comments: (id: string) => Promise<ReturnCaseCommentDto[]>;
+    addComment: (id: string, body: string, isCustomerVisible: boolean, notifyCustomer: boolean) => Promise<ReturnCaseCommentDto>;
+    settlementPrefill: (id: string) => Promise<SettlementPrefill>;
+    settle: (id: string, body: {
+        resolutionType: string;
+        lines: Array<{
+            returnCaseItemId: string;
+            approvedRefundAmount: number;
+        }>;
+        refundPaymentMethodId?: string;
+        createCorrectiveInvoice?: boolean;
+    }) => Promise<SettlementResult>;
+    shipments: (id: string) => Promise<Array<{
+        id: string;
+        direction: string;
+        status: string;
+        externalReference: string | null;
+    }>>;
+    createShipment: (id: string, direction: string, externalReference?: string) => Promise<{
+        id: string;
+    }>;
+    receiveShipment: (id: string, shipmentId: string) => Promise<{
+        status: string;
+    }>;
+    statuses: () => Promise<ReturnStatusGraphResponse>;
+    createStatus: (body: {
+        code: string;
+        name: Record<string, string>;
+        defaultName: string;
+        isTerminal?: boolean;
+        weight?: number;
+    }) => Promise<ReturnStatusGraphResponse>;
+    deleteStatus: (code: string) => Promise<ReturnStatusGraphResponse>;
+    setTransitions: (transitions: Array<{
+        fromStatusCode: string;
+        toStatusCode: string;
+    }>) => Promise<ReturnStatusGraphResponse>;
+    reasons: () => Promise<ReturnReasonDto[]>;
+    createReason: (body: {
+        label: Record<string, string>;
+        appliesTo: string;
+        weight?: number;
+    }) => Promise<ReturnReasonDto>;
+    updateReason: (id: string, patch: {
+        isActive?: boolean;
+        weight?: number;
+    }) => Promise<ReturnReasonDto>;
+    deleteReason: (id: string) => Promise<unknown>;
+    deliveryMethods: () => Promise<ReturnDeliveryMethodDto[]>;
+    createDeliveryMethod: (body: {
+        deliveryMethodId: string;
+        returnCost: number;
+        currency: string;
+    }) => Promise<ReturnDeliveryMethodDto>;
+    deleteDeliveryMethod: (id: string) => Promise<unknown>;
+};
+//# sourceMappingURL=returns-client.d.ts.map

package/dist/admin/api/returns-client.d.ts.map

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

package/dist/admin/api/returns-client.js

@@ -0,0 +1,36 @@
+import { apiClient } from '@endora-commerce/admin-kit/lib';
+const unwrap = (p) => p.then((r) => r.data);
+/** Typed admin client for the returns module (feature 046). */
+export const returnsClient = {
+    list: (qs) => unwrap(apiClient.get(`/api/v1/admin/returns${qs}`)),
+    get: (id) => unwrap(apiClient.get(`/api/v1/admin/returns/${id}`)),
+    authorize: (id) => unwrap(apiClient.post(`/api/v1/admin/returns/${id}/authorize`, {})),
+    reject: (id, reason) => unwrap(apiClient.post(`/api/v1/admin/returns/${id}/reject`, { reason })),
+    transition: (id, to, reason) => unwrap(apiClient.post(`/api/v1/admin/returns/${id}/transition`, { to, ...(reason ? { reason } : {}) })),
+    bulkTransition: (ids, to) => unwrap(apiClient.post('/api/v1/admin/returns/bulk-transition', { ids, to })),
+    // Comments
+    comments: (id) => unwrap(apiClient.get(`/api/v1/admin/returns/${id}/comments`)),
+    addComment: (id, body, isCustomerVisible, notifyCustomer) => unwrap(apiClient.post(`/api/v1/admin/returns/${id}/comments`, { body, isCustomerVisible, notifyCustomer })),
+    // Settlement
+    settlementPrefill: (id) => unwrap(apiClient.get(`/api/v1/admin/returns/${id}/settlement`)),
+    settle: (id, body) => unwrap(apiClient.post(`/api/v1/admin/returns/${id}/settlement`, body)),
+    // Shipments
+    shipments: (id) => unwrap(apiClient.get(`/api/v1/admin/returns/${id}/shipments`)),
+    createShipment: (id, direction, externalReference) => unwrap(apiClient.post(`/api/v1/admin/returns/${id}/shipments`, { direction, ...(externalReference ? { externalReference } : {}) })),
+    receiveShipment: (id, shipmentId) => unwrap(apiClient.post(`/api/v1/admin/returns/${id}/shipments/${shipmentId}/receive`, {})),
+    // Status graph config
+    statuses: () => unwrap(apiClient.get('/api/v1/admin/returns/statuses')),
+    createStatus: (body) => unwrap(apiClient.post('/api/v1/admin/returns/statuses', body)),
+    deleteStatus: (code) => unwrap(apiClient.delete(`/api/v1/admin/returns/statuses/${code}`)),
+    setTransitions: (transitions) => unwrap(apiClient.put('/api/v1/admin/returns/transitions', { transitions })),
+    // Reasons
+    reasons: () => unwrap(apiClient.get('/api/v1/admin/returns/reasons')),
+    createReason: (body) => unwrap(apiClient.post('/api/v1/admin/returns/reasons', body)),
+    updateReason: (id, patch) => unwrap(apiClient.patch(`/api/v1/admin/returns/reasons/${id}`, patch)),
+    deleteReason: (id) => apiClient.delete(`/api/v1/admin/returns/reasons/${id}`),
+    // Return delivery methods
+    deliveryMethods: () => unwrap(apiClient.get('/api/v1/admin/returns/delivery-methods')),
+    createDeliveryMethod: (body) => unwrap(apiClient.post('/api/v1/admin/returns/delivery-methods', body)),
+    deleteDeliveryMethod: (id) => apiClient.delete(`/api/v1/admin/returns/delivery-methods/${id}`),
+};
+//# sourceMappingURL=returns-client.js.map

package/dist/admin/api/returns-client.js.map

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

package/dist/admin/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `returns`' admin surface — five routes and one sidebar entry, declared by the
+ * module that owns them (feature 091, Phase 4, batch 8;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-contribution.md`).
+ *
+ * **Its two drains were both `orders`'**, and both took the same exit:
+ * publication into `@endora-commerce/admin-kit`.
+ * `backend/scripts/ledgers/cross-module-imports/returns.ts` recorded
+ * `orderStatusBadgeStyle` — two pure functions over a hex string that cannot
+ * tell an order status from a return one, so it is published as
+ * `statusBadgeStyle` — and `StatusTransitionGraph`, which
+ * `admin-component-contribution.md` Z1 question 1 classifies as a published
+ * component rather than a zone contribution: it takes data in and callbacks out
+ * and holds no `orders` vocabulary. The shard is deleted rather than edited.
+ *
+ * **Five routes and one nav entry, and the four sub-screens deliberately have
+ * none.** `/returns/statuses`, `/returns/reasons` and
+ * `/returns/delivery-methods` are configuration surfaces reached from the list,
+ * and `/returns/:id` is a row's detail; a nav entry is a landing surface, and
+ * `registryCrumbs` derives all four trails from this entry's own `to` because
+ * it matches anything beneath it.
+ *
+ * **Route order is load-bearing here and nowhere else in this batch.** The
+ * three literal sub-paths are declared before `/returns/:id`, because
+ * `react-router` ranks a static segment above a dynamic one but the registry's
+ * order is what the generated table preserves, and a `:id` route that matched
+ * `statuses` first would render the detail screen over a configuration URL.
+ *
+ * **Both palette actions are already the manifest's** (`open-returns`,
+ * `return-statuses`), so nothing about the ⌘K surface moves here.
+ *
+ * **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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAanF,eAAO,MAAM,aAAa,EAAE,kBA8C3B,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,57 @@
+/** The module's landing route: the returns/RMA case list. */
+const LIST_ROUTE = '/returns';
+/**
+ * Every `/api/v1/admin/returns/*` `GET` enforces this, the three configuration
+ * screens' included — so it is the code that opens all five screens, and the
+ * write code gates the mutations they offer. Hiding a screen a read-only
+ * operator can legitimately open is issue #232's finding.
+ */
+const RETURNS_READ = 'returns:read';
+export const contributions = {
+    routes: [
+        {
+            path: LIST_ROUTE,
+            component: () => import('./pages/ReturnsList.js'),
+            requiredPermission: RETURNS_READ,
+            index: true,
+        },
+        {
+            path: '/returns/statuses',
+            component: () => import('./pages/ReturnStatusesConfigPage.js'),
+            requiredPermission: RETURNS_READ,
+        },
+        {
+            path: '/returns/reasons',
+            component: () => import('./pages/ReturnReasonsPage.js'),
+            requiredPermission: RETURNS_READ,
+        },
+        {
+            path: '/returns/delivery-methods',
+            component: () => import('./pages/ReturnDeliveryMethodsPage.js'),
+            requiredPermission: RETURNS_READ,
+        },
+        {
+            path: '/returns/:id',
+            component: () => import('./pages/ReturnDetail.js'),
+            requiredPermission: RETURNS_READ,
+        },
+    ],
+    nav: [
+        {
+            to: LIST_ROUTE,
+            // Module-relative (R8), out of `packages/modules/returns/i18n/`. It was
+            // `appShell.nav.returns` in the shared `_i18n` bundle.
+            labelKey: 'nav.returns.label',
+            icon: 'Package',
+            section: 'sales',
+            // Fourth of seven in the hand-written *Sales* table, after the three
+            // `/orders*` rows and before `/quote-requests`. Every other row there is
+            // still the host's, so this appends after all of them; the weight is what
+            // restores the position once `orders` (batch 12) and `quote_requests`
+            // (batch 10) convert.
+            weight: 400,
+            requiredPermission: RETURNS_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":"AAoCA,6DAA6D;AAC7D,MAAM,UAAU,GAAG,UAAU,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC;YACjD,kBAAkB,EAAE,YAAY;YAChC,KAAK,EAAE,IAAI;SACZ;QACD;YACE,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,qCAAqC,CAAC;YAC9D,kBAAkB,EAAE,YAAY;SACjC;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,8BAA8B,CAAC;YACvD,kBAAkB,EAAE,YAAY;SACjC;QACD;YACE,IAAI,EAAE,2BAA2B;YACjC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sCAAsC,CAAC;YAC/D,kBAAkB,EAAE,YAAY;SACjC;QACD;YACE,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC;YAClD,kBAAkB,EAAE,YAAY;SACjC;KACF;IACD,GAAG,EAAE;QACH;YACE,EAAE,EAAE,UAAU;YACd,wEAAwE;YACxE,uDAAuD;YACvD,QAAQ,EAAE,mBAAmB;YAC7B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAO;YAChB,qEAAqE;YACrE,yEAAyE;YACzE,0EAA0E;YAC1E,sEAAsE;YACtE,sBAAsB;YACtB,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,YAAY;SACjC;KACF;CACF,CAAC"}

package/dist/admin/pages/ReturnDeliveryMethodsPage.d.ts

@@ -0,0 +1,5 @@
+import { type ReactNode } from 'react';
+/** Allowed return delivery methods + cost (feature 046, US6). */
+export declare function ReturnDeliveryMethodsPage(): ReactNode;
+export default ReturnDeliveryMethodsPage;
+//# sourceMappingURL=ReturnDeliveryMethodsPage.d.ts.map

package/dist/admin/pages/ReturnDeliveryMethodsPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReturnDeliveryMethodsPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/ReturnDeliveryMethodsPage.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AASzE,iEAAiE;AACjE,wBAAgB,yBAAyB,IAAI,SAAS,CA0GrD;AACD,eAAe,yBAAyB,CAAC"}

package/dist/admin/pages/ReturnDeliveryMethodsPage.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { Trash2 } from 'lucide-react';
+import { ApiError } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Badge, Button, Card, CardContent, CardHeader, CardTitle, Label, PageHeader, Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+import { returnsClient } from '../api/returns-client.js';
+/** Allowed return delivery methods + cost (feature 046, US6). */
+export function ReturnDeliveryMethodsPage() {
+    const t = useTranslation('core');
+    const [rows, setRows] = useState([]);
+    const [error, setError] = useState(null);
+    const [deliveryMethodId, setDeliveryMethodId] = useState('');
+    const [returnCost, setReturnCost] = useState(0);
+    const [currency, setCurrency] = useState('PLN');
+    const refresh = useCallback(async () => {
+        setError(null);
+        try {
+            setRows(await returnsClient.deliveryMethods());
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : 'Failed to load.');
+        }
+    }, []);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const run = useCallback(async (fn) => {
+        setError(null);
+        try {
+            await fn();
+            await refresh();
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : 'Action failed.');
+        }
+    }, [refresh]);
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx(PageHeader, { title: t('returns.methods.title'), description: t('returns.methods.description') }), error && (_jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) })), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: "Methods" }) }), _jsxs(CardContent, { className: "space-y-3", children: [_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: "Delivery method id" }), _jsx(TableHead, { children: "Return cost" }), _jsx(TableHead, { children: "Currency" }), _jsx(TableHead, { children: "Active" }), _jsx(TableHead, {})] }) }), _jsx(TableBody, { children: rows.map((r) => (_jsxs(TableRow, { children: [_jsx(TableCell, { className: "font-mono text-xs", children: r.deliveryMethodId }), _jsx(TableCell, { children: r.returnCost.toFixed(2) }), _jsx(TableCell, { children: r.currency }), _jsx(TableCell, { children: _jsx(Badge, { variant: r.isActive ? 'default' : 'secondary', children: r.isActive ? 'active' : 'inactive' }) }), _jsx(TableCell, { children: _jsx(Button, { variant: "ghost", size: "sm", onClick: () => void run(() => returnsClient.deleteDeliveryMethod(r.id)), children: _jsx(Trash2, { className: "size-4" }) }) })] }, r.id))) })] }), _jsxs("div", { className: "flex flex-wrap items-end gap-2", children: [_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "dm", children: "Delivery method id" }), _jsx("input", { id: "dm", className: "h-9 w-80 rounded-md border border-input bg-background px-3 text-sm", value: deliveryMethodId, onChange: (e) => setDeliveryMethodId(e.target.value), placeholder: "uuid" })] }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "cost", children: "Return cost" }), _jsx("input", { id: "cost", type: "number", step: "0.01", className: "h-9 w-28 rounded-md border border-input bg-background px-3 text-sm", value: returnCost, onChange: (e) => setReturnCost(Number(e.target.value)) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "cur", children: "Currency" }), _jsx("input", { id: "cur", className: "h-9 w-20 rounded-md border border-input bg-background px-3 text-sm", value: currency, onChange: (e) => setCurrency(e.target.value) })] }), _jsx(Button, { size: "sm", disabled: !deliveryMethodId.trim(), onClick: () => void run(async () => {
+                                            await returnsClient.createDeliveryMethod({ deliveryMethodId: deliveryMethodId.trim(), returnCost, currency });
+                                            setDeliveryMethodId('');
+                                        }), children: "Add method" })] })] })] })] }));
+}
+export default ReturnDeliveryMethodsPage;
+//# sourceMappingURL=ReturnDeliveryMethodsPage.js.map

package/dist/admin/pages/ReturnDeliveryMethodsPage.js.map

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

package/dist/admin/pages/ReturnDetail.d.ts

@@ -0,0 +1,5 @@
+import { type ReactNode } from 'react';
+/** Returns / RMA case detail (feature 046, US2/US4/US5/US6). */
+export declare function ReturnDetail(): ReactNode;
+export default ReturnDetail;
+//# sourceMappingURL=ReturnDetail.d.ts.map

package/dist/admin/pages/ReturnDetail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReturnDetail.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/ReturnDetail.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAezE,gEAAgE;AAChE,wBAAgB,YAAY,IAAI,SAAS,CAkcxC;AACD,eAAe,YAAY,CAAC"}

package/dist/admin/pages/ReturnDetail.js

@@ -0,0 +1,115 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { Link, useParams } from 'react-router-dom';
+import { ArrowLeft } from 'lucide-react';
+import { ApiError, formatDateTime } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Badge, Button, Card, CardContent, CardHeader, CardTitle, Checkbox, Label, Select, PageHeader, Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+import { returnsClient } from '../api/returns-client.js';
+/** Returns / RMA case detail (feature 046, US2/US4/US5/US6). */
+export function ReturnDetail() {
+    const t = useTranslation('core');
+    const { id = '' } = useParams();
+    const [rc, setRc] = useState(null);
+    const [transitions, setTransitions] = useState([]);
+    const [shipments, setShipments] = useState([]);
+    const [prefill, setPrefill] = useState(null);
+    const [error, setError] = useState(null);
+    const [info, setInfo] = useState(null);
+    const [commentBody, setCommentBody] = useState('');
+    const [commentVisible, setCommentVisible] = useState(true);
+    const [commentNotify, setCommentNotify] = useState(false);
+    const [resolution, setResolution] = useState('refund');
+    const [paymentMethodId, setPaymentMethodId] = useState('');
+    const [approved, setApproved] = useState({});
+    // Issue #150 — a correction is asked for by default, as the screen always
+    // did; the control exists because "not requested" is one of the three
+    // outcomes below and an operator has to be able to reach it deliberately.
+    const [createCorrectiveInvoice, setCreateCorrectiveInvoice] = useState(true);
+    const [settlement, setSettlement] = useState(null);
+    const refresh = useCallback(async () => {
+        setError(null);
+        try {
+            const [detail, graph, ship] = await Promise.all([
+                returnsClient.get(id),
+                returnsClient.statuses(),
+                returnsClient.shipments(id).catch(() => []),
+            ]);
+            setRc(detail);
+            setTransitions(graph.transitions.filter((t) => t.fromStatusCode === detail.statusCode));
+            setShipments(ship);
+            if (detail.statusCode === 'received') {
+                const pf = await returnsClient.settlementPrefill(id);
+                setPrefill(pf);
+                setApproved(Object.fromEntries(pf.items.map((it) => [it.returnCaseItemId, it.defaultRefundAmount])));
+            }
+            else {
+                setPrefill(null);
+            }
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : 'Failed to load case.');
+        }
+    }, [id]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const run = useCallback(async (fn, ok) => {
+        setError(null);
+        setInfo(null);
+        try {
+            await fn();
+            setInfo(ok);
+            await refresh();
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : 'Action failed.');
+        }
+    }, [refresh]);
+    if (!rc) {
+        return (_jsxs("div", { className: "space-y-4", children: [_jsx(PageHeader, { title: t('returns.detail.title') }), error && (_jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) }))] }));
+    }
+    const isNew = rc.statusCode === 'new';
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx(Button, { asChild: true, variant: "ghost", size: "sm", children: _jsxs(Link, { to: "/returns", children: [_jsx(ArrowLeft, { className: "size-4" }), " Back to returns"] }) }), _jsx(PageHeader, { title: _jsxs("span", { className: "flex items-center gap-2", children: [rc.rmaNumber ?? 'Return case', " ", _jsx(Badge, { variant: "secondary", children: rc.statusLabel }), _jsx(Badge, { variant: "outline", children: rc.kind })] }), description: `Order ${rc.orderId}` }), error && (_jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) })), info && (_jsx(Alert, { children: _jsx(AlertDescription, { children: info }) })), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: "Actions" }) }), _jsxs(CardContent, { className: "flex flex-wrap items-center gap-2", children: [isNew && (_jsx(Button, { size: "sm", onClick: () => void run(() => returnsClient.authorize(id), 'Authorized.'), children: "Authorize (assign RMA)" })), _jsx(Button, { variant: "destructive", size: "sm", onClick: () => {
+                                    const reason = window.prompt('Rejection reason');
+                                    if (reason)
+                                        void run(() => returnsClient.reject(id, reason), 'Rejected.');
+                                }, children: "Reject" }), transitions.map((t) => (_jsxs(Button, { variant: "outline", size: "sm", onClick: () => void run(() => returnsClient.transition(id, t.toStatusCode), `Moved to ${t.toStatusCode}.`), children: ["\u2192 ", t.toStatusCode] }, t.toStatusCode)))] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: "Returned items" }) }), _jsx(CardContent, { children: _jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: "Product" }), _jsx(TableHead, { children: "Qty" }), _jsx(TableHead, { children: "Default refund" }), _jsx(TableHead, { children: "Approved" })] }) }), _jsx(TableBody, { children: rc.items.map((it) => (_jsxs(TableRow, { children: [_jsx(TableCell, { children: it.productName }), _jsx(TableCell, { children: it.quantity }), _jsx(TableCell, { children: it.defaultRefundAmount.toFixed(2) }), _jsx(TableCell, { children: it.approvedRefundAmount.toFixed(2) })] }, it.id))) })] }) })] }), prefill && (_jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: t('returns.detail.settlement.title') }) }), _jsxs(CardContent, { className: "space-y-3", children: [_jsxs("div", { className: "flex flex-wrap items-end gap-3", children: [_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "resolution", children: t('returns.detail.settlement.resolution') }), _jsxs(Select, { id: "resolution", value: resolution, onChange: (e) => setResolution(e.target.value), children: [_jsx("option", { value: "refund", children: t('returns.detail.resolution.refund') }), _jsx("option", { value: "credit", children: t('returns.detail.resolution.credit') }), _jsx("option", { value: "replacement", children: t('returns.detail.resolution.replacement') }), _jsx("option", { value: "repair", children: t('returns.detail.resolution.repair') })] })] }), resolution === 'refund' && (_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "pm", children: t('returns.detail.settlement.paymentMethodId') }), _jsx("input", { id: "pm", className: "h-9 rounded-md border border-input bg-background px-3 text-sm", value: paymentMethodId, onChange: (e) => setPaymentMethodId(e.target.value) })] }))] }), _jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('returns.detail.col.product') }), _jsx(TableHead, { children: t('returns.detail.settlement.maxPaid') }), _jsx(TableHead, { children: t('returns.detail.col.approved') })] }) }), _jsx(TableBody, { children: prefill.items.map((it) => (_jsxs(TableRow, { children: [_jsx(TableCell, { children: it.productName }), _jsx(TableCell, { children: it.defaultRefundAmount.toFixed(2) }), _jsx(TableCell, { children: _jsx("input", { type: "number", step: "0.01", className: "h-8 w-28 rounded-md border border-input bg-background px-2 text-sm", value: approved[it.returnCaseItemId] ?? 0, onChange: (e) => setApproved((prev) => ({ ...prev, [it.returnCaseItemId]: Number(e.target.value) })) }) })] }, it.returnCaseItemId))) })] }), _jsxs("label", { className: "flex items-center gap-2 text-sm", htmlFor: "createCorrectiveInvoice", children: [_jsx(Checkbox, { id: "createCorrectiveInvoice", checked: createCorrectiveInvoice, onChange: (e) => setCreateCorrectiveInvoice(e.target.checked) }), t('returns.detail.settlement.createCorrectiveInvoice')] }), _jsx(Button, { size: "sm", onClick: () => void (async () => {
+                                    setError(null);
+                                    setInfo(null);
+                                    try {
+                                        const settled = await returnsClient.settle(id, {
+                                            resolutionType: resolution,
+                                            lines: prefill.items.map((it) => ({
+                                                returnCaseItemId: it.returnCaseItemId,
+                                                approvedRefundAmount: approved[it.returnCaseItemId] ?? 0,
+                                            })),
+                                            ...(resolution === 'refund' && paymentMethodId
+                                                ? { refundPaymentMethodId: paymentMethodId }
+                                                : {}),
+                                            createCorrectiveInvoice,
+                                        });
+                                        // Issue #150 — kept whatever the gateway said, because the
+                                        // corrective invoice is a separate answer: a settlement can
+                                        // succeed and still, correctly, produce no document.
+                                        setSettlement(settled);
+                                        if (settled.refund?.settlementState === 'failed') {
+                                            setError(settled.refund.failureReason ?? t('returns.detail.settlement.gatewayRejected'));
+                                        }
+                                        else {
+                                            setInfo(t('returns.detail.settlement.done'));
+                                        }
+                                        await refresh();
+                                    }
+                                    catch (err) {
+                                        setError(err instanceof ApiError
+                                            ? err.envelope.error.message
+                                            : t('returns.detail.actionFailed'));
+                                    }
+                                })(), children: t('returns.detail.settlement.settle') })] })] })), (settlement || rc.correctiveInvoice) && (_jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: t('returns.detail.correctiveInvoice.title') }) }), _jsx(CardContent, { className: "text-sm", children: settlement ? (settlement.correctiveInvoice === undefined ? (_jsx("p", { className: "text-muted-foreground", children: t('returns.detail.correctiveInvoice.notRequested') })) : settlement.correctiveInvoice.issued ? (_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(Badge, { variant: "secondary", children: t('returns.detail.correctiveInvoice.issued') }), _jsx(Button, { asChild: true, variant: "outline", size: "sm", children: _jsx(Link, { to: `/invoices/${settlement.correctiveInvoice.invoiceId}`, children: settlement.correctiveInvoice.number }) })] })) : (_jsx("p", { className: "text-muted-foreground", children: t(`returns.detail.correctiveInvoice.notDue.${settlement.correctiveInvoice.reason}`) }))) : rc.correctiveInvoice?.outcome === 'issued' ? (_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [_jsx(Badge, { variant: "secondary", children: t('returns.detail.correctiveInvoice.issued') }), rc.correctiveInvoice.invoiceId && (_jsx(Button, { asChild: true, variant: "outline", size: "sm", children: _jsx(Link, { to: `/invoices/${rc.correctiveInvoice.invoiceId}`, children: t('returns.detail.correctiveInvoice.open') }) }))] })) : rc.correctiveInvoice?.outcome === 'not_due' ? (_jsx("p", { className: "text-muted-foreground", children: t('returns.detail.correctiveInvoice.notDue.order_not_invoiced') })) : (_jsx("p", { className: "text-muted-foreground", children: t('returns.detail.correctiveInvoice.notRequested') })) })] })), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: "Return shipments" }) }), _jsxs(CardContent, { className: "space-y-3", children: [_jsx(Button, { variant: "outline", size: "sm", onClick: () => void run(() => returnsClient.createShipment(id, 'inbound'), 'Inbound shipment recorded.'), children: "Record inbound shipment" }), _jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: "Direction" }), _jsx(TableHead, { children: "Status" }), _jsx(TableHead, { children: "Tracking" }), _jsx(TableHead, {})] }) }), _jsx(TableBody, { children: shipments.map((s) => (_jsxs(TableRow, { children: [_jsx(TableCell, { children: s.direction }), _jsx(TableCell, { children: s.status }), _jsx(TableCell, { children: s.externalReference ?? '—' }), _jsx(TableCell, { children: s.status === 'pending' && s.direction === 'inbound' && (_jsx(Button, { variant: "ghost", size: "sm", onClick: () => void run(() => returnsClient.receiveShipment(id, s.id), 'Received.'), children: "Mark received" })) })] }, s.id))) })] })] })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: "Comments" }) }), _jsxs(CardContent, { className: "space-y-3", children: [_jsxs("div", { className: "space-y-2", children: [rc.comments.map((c) => (_jsxs("div", { className: "rounded-md border p-2 text-sm", children: [_jsxs("div", { className: "flex items-center gap-2 text-xs text-muted-foreground", children: [_jsx("span", { children: c.authorKind }), _jsx("span", { children: formatDateTime(c.createdAt) }), !c.isCustomerVisible && _jsx(Badge, { variant: "outline", children: "internal" })] }), _jsx("div", { children: c.body })] }, c.id))), rc.comments.length === 0 && _jsx("p", { className: "text-sm text-muted-foreground", children: "No comments." })] }), _jsx("textarea", { className: "min-h-[60px] w-full rounded-md border border-input bg-background p-2 text-sm", value: commentBody, onChange: (e) => setCommentBody(e.target.value), placeholder: "Add a comment\u2026" }), _jsxs("div", { className: "flex flex-wrap items-center gap-3 text-sm", children: [_jsxs("label", { className: "flex items-center gap-1", children: [_jsx("input", { type: "checkbox", checked: commentVisible, onChange: (e) => setCommentVisible(e.target.checked) }), "Visible to customer"] }), _jsxs("label", { className: "flex items-center gap-1", children: [_jsx("input", { type: "checkbox", checked: commentNotify, onChange: (e) => setCommentNotify(e.target.checked) }), "Notify customer"] }), _jsx(Button, { size: "sm", disabled: !commentBody.trim(), onClick: () => void run(async () => {
+                                            await returnsClient.addComment(id, commentBody.trim(), commentVisible, commentNotify);
+                                            setCommentBody('');
+                                        }, 'Comment added.'), children: "Add comment" })] })] })] })] }));
+}
+export default ReturnDetail;
+//# sourceMappingURL=ReturnDetail.js.map

package/dist/admin/pages/ReturnDetail.js.map

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

package/dist/admin/pages/ReturnReasonsPage.d.ts

@@ -0,0 +1,5 @@
+import { type ReactNode } from 'react';
+/** Managed return/complaint reasons (feature 046, US7). */
+export declare function ReturnReasonsPage(): ReactNode;
+export default ReturnReasonsPage;
+//# sourceMappingURL=ReturnReasonsPage.d.ts.map

package/dist/admin/pages/ReturnReasonsPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReturnReasonsPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/ReturnReasonsPage.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AASzE,2DAA2D;AAC3D,wBAAgB,iBAAiB,IAAI,SAAS,CAoH7C;AACD,eAAe,iBAAiB,CAAC"}

package/dist/admin/pages/ReturnReasonsPage.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { Trash2 } from 'lucide-react';
+import { ApiError } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Badge, Button, Card, CardContent, CardHeader, CardTitle, Label, Select, PageHeader, Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+import { returnsClient } from '../api/returns-client.js';
+/** Managed return/complaint reasons (feature 046, US7). */
+export function ReturnReasonsPage() {
+    const t = useTranslation('core');
+    const [rows, setRows] = useState([]);
+    const [error, setError] = useState(null);
+    const [label, setLabel] = useState('');
+    const [appliesTo, setAppliesTo] = useState('both');
+    const [weight, setWeight] = useState(100);
+    const refresh = useCallback(async () => {
+        setError(null);
+        try {
+            setRows(await returnsClient.reasons());
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : 'Failed to load.');
+        }
+    }, []);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const run = useCallback(async (fn) => {
+        setError(null);
+        try {
+            await fn();
+            await refresh();
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : 'Action failed.');
+        }
+    }, [refresh]);
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx(PageHeader, { title: t('returns.reasons.title'), description: t('returns.reasons.description') }), error && (_jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) })), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: "Reasons" }) }), _jsxs(CardContent, { className: "space-y-3", children: [_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: "Label" }), _jsx(TableHead, { children: "Applies to" }), _jsx(TableHead, { children: "Weight" }), _jsx(TableHead, { children: "Active" }), _jsx(TableHead, {})] }) }), _jsx(TableBody, { children: rows.map((r) => (_jsxs(TableRow, { children: [_jsx(TableCell, { children: r.label['en'] ?? Object.values(r.label)[0] ?? '—' }), _jsx(TableCell, { children: r.appliesTo }), _jsx(TableCell, { children: r.weight }), _jsx(TableCell, { children: _jsx(Button, { variant: "ghost", size: "sm", onClick: () => void run(() => returnsClient.updateReason(r.id, { isActive: !r.isActive })), children: _jsx(Badge, { variant: r.isActive ? 'default' : 'secondary', children: r.isActive ? 'active' : 'inactive' }) }) }), _jsx(TableCell, { children: _jsx(Button, { variant: "ghost", size: "sm", onClick: () => void run(() => returnsClient.deleteReason(r.id)), children: _jsx(Trash2, { className: "size-4" }) }) })] }, r.id))) })] }), _jsxs("div", { className: "flex flex-wrap items-end gap-2", children: [_jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "label", children: "Label (EN)" }), _jsx("input", { id: "label", className: "h-9 rounded-md border border-input bg-background px-3 text-sm", value: label, onChange: (e) => setLabel(e.target.value) })] }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "applies", children: "Applies to" }), _jsxs(Select, { id: "applies", value: appliesTo, onChange: (e) => setAppliesTo(e.target.value), children: [_jsx("option", { value: "both", children: "Both" }), _jsx("option", { value: "return", children: "Return" }), _jsx("option", { value: "complaint", children: "Complaint" })] })] }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "weight", children: "Weight" }), _jsx("input", { id: "weight", type: "number", className: "h-9 w-24 rounded-md border border-input bg-background px-3 text-sm", value: weight, onChange: (e) => setWeight(Number(e.target.value)) })] }), _jsx(Button, { size: "sm", disabled: !label.trim(), onClick: () => void run(async () => {
+                                            await returnsClient.createReason({ label: { en: label.trim() }, appliesTo, weight });
+                                            setLabel('');
+                                        }), children: "Add reason" })] })] })] })] }));
+}
+export default ReturnReasonsPage;
+//# sourceMappingURL=ReturnReasonsPage.js.map