@endora-commerce/mod-returns 0.100.0

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

@@ -0,0 +1,89 @@
+import type { EmailMailerPort, TransactionalEmailSender } from '@endora-commerce/contracts';
+import type { ReturnCase } from '../entities/return-case.entity.js';
+import type { ReturnNotifier } from './return-authorization-service.js';
+/** Resolves a customer account's email address (injected to avoid importing
+ *  the customer_accounts module's internals into returns). */
+export type CustomerEmailResolver = (customerAccountId: string) => Promise<string | null>;
+/**
+ * Why the authorize / reject e-mail did — or did not — go out (issue #78).
+ *
+ * Both methods answered `void`, and reaching the transactional sender counted
+ * as done: they returned right after the send whatever it reported, so a
+ * deactivated template, a transport-less composition and a code with no
+ * definition were indistinguishable from a delivered message — and from the
+ * legacy-builder path, which is the only one that put an e-mail anywhere in
+ * those cases.
+ */
+export type ReturnEmailNotSentReason = 
+/** The case carries no RMA number, so there is no authorization to announce. */
+'no_rma'
+/** No address resolves for the case's customer account. */
+ | 'no_recipient'
+/** The operator switched this return e-mail off. */
+ | 'deactivated'
+/** No mailer is wired behind the sender. */
+ | 'no_transport'
+/** No template exists for this code yet. */
+ | 'no_definition'
+/**
+ * The transport itself declined to send (D-59) — today, an already-accepted
+ * `messageId`, so an earlier call delivered the message and this one did not.
+ */
+ | 'suppressed'
+/** The send raised, and the workflow transition stays applied. */
+ | 'failed';
+export type ReturnEmailResult = {
+    sent: true;
+} | {
+    sent: false;
+    reason: ReturnEmailNotSentReason;
+};
+/**
+ * Where a send that did not happen is reported. Injectable so a test can read
+ * it; defaults to `console.warn`, which is what the rest of this layer uses.
+ */
+export type ReturnEmailLog = (message: string, context: Record<string, unknown>) => void;
+/** Feature 047 — optional transactional-email wiring (admin-editable templates). */
+export interface ReturnNotifierEmailOptions {
+    getTransactionalEmailSender?: () => TransactionalEmailSender | undefined;
+    resolveLanguage?: (salesChannelId: string) => Promise<string>;
+    log?: ReturnEmailLog;
+}
+/**
+ * ReturnEmailNotifier — feature 046 (US2, FR-017).
+ *
+ * Sends the authorize / reject notifications through the platform Mailer.
+ * Best-effort: the caller (`ReturnAuthorizationService`) already wraps these in
+ * a try/catch so a mail failure never blocks the workflow transition — which is
+ * exactly why every non-sent path is written to the log here as well as named
+ * in the result. That caller discards the result, so the log is what an
+ * operator has; a direct caller and the tests read the result.
+ *
+ * **Which message goes out is unchanged.** The legacy in-code builder still
+ * runs only when no sender is wired at all, including when the sender answers
+ * `no_definition` — where `templateEmailPort` would fall back. Making returns
+ * fall back too is a decision about what mail a client receives, not a
+ * reporting repair, so it is named here and in the result rather than slipped
+ * in: the reason reaches the log, and nothing is sent silently.
+ */
+export declare class ReturnEmailNotifier implements ReturnNotifier {
+    private readonly mailer;
+    private readonly resolveCustomerEmail;
+    private readonly emailOptions;
+    private readonly log;
+    constructor(mailer: EmailMailerPort, resolveCustomerEmail: CustomerEmailResolver, emailOptions?: ReturnNotifierEmailOptions);
+    private language;
+    authorized(rc: ReturnCase): Promise<ReturnEmailResult>;
+    rejected(rc: ReturnCase): Promise<ReturnEmailResult>;
+    /**
+     * The tolerance the workflow transition needs, narrowed to what it is for.
+     *
+     * A switched-off module is a presence answer about the whole operation rather
+     * than one message that failed to render, so it travels on. Everything else
+     * is contained: the return case has already moved to its new status and must
+     * not move back because the customer could not be told.
+     */
+    private contained;
+    private notSent;
+}
+//# sourceMappingURL=return-email-notifier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"return-email-notifier.d.ts","sourceRoot":"","sources":["../../../src/backend/services/return-email-notifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAIxE;8DAC8D;AAC9D,MAAM,MAAM,qBAAqB,GAAG,CAAC,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE1F;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB;AAClC,gFAAgF;AAC9E,QAAQ;AACV,2DAA2D;GACzD,cAAc;AAChB,oDAAoD;GAClD,aAAa;AACf,4CAA4C;GAC1C,cAAc;AAChB,4CAA4C;GAC1C,eAAe;AACjB;;;GAGG;GACD,YAAY;AACd,kEAAkE;GAChE,QAAQ,CAAC;AAEb,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAEnG;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEzF,oFAAoF;AACpF,MAAM,WAAW,0BAA0B;IACzC,2BAA2B,CAAC,EAAE,MAAM,wBAAwB,GAAG,SAAS,CAAC;IACzE,eAAe,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IAItD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAL/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;gBAGlB,MAAM,EAAE,eAAe,EACvB,oBAAoB,EAAE,qBAAqB,EAC3C,YAAY,GAAE,0BAA+B;YAKlD,QAAQ;IAShB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+BtD,QAAQ,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8B1D;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,OAAO;CAchB"}

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

@@ -0,0 +1,128 @@
+import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
+import { buildReturnAuthorizedEmail } from '../email-templates/return-authorized.js';
+import { buildReturnRejectedEmail } from '../email-templates/return-rejected.js';
+/**
+ * ReturnEmailNotifier — feature 046 (US2, FR-017).
+ *
+ * Sends the authorize / reject notifications through the platform Mailer.
+ * Best-effort: the caller (`ReturnAuthorizationService`) already wraps these in
+ * a try/catch so a mail failure never blocks the workflow transition — which is
+ * exactly why every non-sent path is written to the log here as well as named
+ * in the result. That caller discards the result, so the log is what an
+ * operator has; a direct caller and the tests read the result.
+ *
+ * **Which message goes out is unchanged.** The legacy in-code builder still
+ * runs only when no sender is wired at all, including when the sender answers
+ * `no_definition` — where `templateEmailPort` would fall back. Making returns
+ * fall back too is a decision about what mail a client receives, not a
+ * reporting repair, so it is named here and in the result rather than slipped
+ * in: the reason reaches the log, and nothing is sent silently.
+ */
+export class ReturnEmailNotifier {
+    mailer;
+    resolveCustomerEmail;
+    emailOptions;
+    log;
+    constructor(mailer, resolveCustomerEmail, emailOptions = {}) {
+        this.mailer = mailer;
+        this.resolveCustomerEmail = resolveCustomerEmail;
+        this.emailOptions = emailOptions;
+        this.log = emailOptions.log ?? ((message, context) => console.warn(message, context));
+    }
+    async language(salesChannelId) {
+        if (!this.emailOptions.resolveLanguage)
+            return 'en-US';
+        try {
+            return await this.emailOptions.resolveLanguage(salesChannelId);
+        }
+        catch {
+            return 'en-US';
+        }
+    }
+    async authorized(rc) {
+        const kind = 'return_authorized';
+        if (!rc.rmaNumber)
+            return this.notSent(rc, kind, 'no_rma');
+        const to = await this.resolveCustomerEmail(rc.customerAccountId);
+        if (!to)
+            return this.notSent(rc, kind, 'no_recipient');
+        const rmaNumber = rc.rmaNumber;
+        const sender = this.emailOptions.getTransactionalEmailSender?.();
+        try {
+            if (sender) {
+                const outcome = await sender.send({
+                    code: kind,
+                    salesChannelId: rc.salesChannelId,
+                    language: await this.language(rc.salesChannelId),
+                    to,
+                    messageId: `${kind}:${rc.id}`,
+                    variables: { rmaNumber, returnCaseId: rc.id },
+                    meta: { returnCaseId: rc.id, kind },
+                });
+                if (outcome.status !== 'sent')
+                    return this.notSent(rc, kind, outcome.status);
+                return { sent: true };
+            }
+            const outcome = await this.mailer.send(buildReturnAuthorizedEmail({ to, rmaNumber, returnCaseId: rc.id }));
+            if (outcome.status !== 'sent')
+                return this.notSent(rc, kind, 'suppressed');
+            return { sent: true };
+        }
+        catch (error) {
+            return this.contained(rc, kind, error);
+        }
+    }
+    async rejected(rc) {
+        const kind = 'return_rejected';
+        const to = await this.resolveCustomerEmail(rc.customerAccountId);
+        if (!to)
+            return this.notSent(rc, kind, 'no_recipient');
+        const reason = rc.rejectionReason ?? '';
+        const sender = this.emailOptions.getTransactionalEmailSender?.();
+        try {
+            if (sender) {
+                const outcome = await sender.send({
+                    code: kind,
+                    salesChannelId: rc.salesChannelId,
+                    language: await this.language(rc.salesChannelId),
+                    to,
+                    messageId: `${kind}:${rc.id}`,
+                    variables: { reason, returnCaseId: rc.id },
+                    meta: { returnCaseId: rc.id, kind },
+                });
+                if (outcome.status !== 'sent')
+                    return this.notSent(rc, kind, outcome.status);
+                return { sent: true };
+            }
+            const outcome = await this.mailer.send(buildReturnRejectedEmail({ to, reason, returnCaseId: rc.id }));
+            if (outcome.status !== 'sent')
+                return this.notSent(rc, kind, 'suppressed');
+            return { sent: true };
+        }
+        catch (error) {
+            return this.contained(rc, kind, error);
+        }
+    }
+    /**
+     * The tolerance the workflow transition needs, narrowed to what it is for.
+     *
+     * A switched-off module is a presence answer about the whole operation rather
+     * than one message that failed to render, so it travels on. Everything else
+     * is contained: the return case has already moved to its new status and must
+     * not move back because the customer could not be told.
+     */
+    contained(rc, kind, error) {
+        rethrowIfModuleDisabled(error);
+        return this.notSent(rc, kind, 'failed', error);
+    }
+    notSent(rc, kind, reason, error) {
+        this.log('[returns] the return e-mail was not sent', {
+            returnCaseId: rc.id,
+            kind,
+            reason,
+            ...(error === undefined ? {} : { error: error instanceof Error ? error.message : error }),
+        });
+        return { sent: false, reason };
+    }
+}
+//# sourceMappingURL=return-email-notifier.js.map

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

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

package/dist/backend/services/return-export-service.d.ts

@@ -0,0 +1,16 @@
+import type { AdminReturnsListQuery } from '@endora-commerce/contracts';
+import type { ReturnListService } from './return-list-service.js';
+/**
+ * ReturnExportService — feature 046 (US8). Exports the current returns-list
+ * view to CSV (RFC-4180 quoting, hard row cap). Mirrors `OrderExportService`.
+ */
+export declare class ReturnExportService {
+    private readonly listService;
+    constructor(listService: ReturnListService);
+    exportCsv(query: AdminReturnsListQuery): Promise<{
+        csv: string;
+        rowCount: number;
+        truncated: boolean;
+    }>;
+}
+//# sourceMappingURL=return-export-service.d.ts.map

package/dist/backend/services/return-export-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-export-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/return-export-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAKlE;;;GAGG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,iBAAiB;IAErD,SAAS,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CAY9G"}

package/dist/backend/services/return-export-service.js

@@ -0,0 +1,29 @@
+const MAX_EXPORT_ROWS = 10_000;
+const COLUMNS = ['rmaNumber', 'kind', 'orderId', 'statusCode', 'totalRefundAmount', 'currency', 'submittedAt'];
+/**
+ * ReturnExportService — feature 046 (US8). Exports the current returns-list
+ * view to CSV (RFC-4180 quoting, hard row cap). Mirrors `OrderExportService`.
+ */
+export class ReturnExportService {
+    listService;
+    constructor(listService) {
+        this.listService = listService;
+    }
+    async exportCsv(query) {
+        const result = await this.listService.list({ ...query, page: 1, pageSize: MAX_EXPORT_ROWS });
+        const header = COLUMNS.join(',');
+        const lines = result.rows.map((r) => COLUMNS.map((c) => csvCell(String(r[c] ?? ''))).join(','));
+        return {
+            csv: [header, ...lines].join('\r\n'),
+            rowCount: result.rows.length,
+            truncated: result.total > result.rows.length,
+        };
+    }
+}
+/** RFC-4180: quote when the cell contains a quote, comma, or newline. */
+function csvCell(value) {
+    if (/[",\r\n]/.test(value))
+        return `"${value.replace(/"/g, '""')}"`;
+    return value;
+}
+//# sourceMappingURL=return-export-service.js.map

package/dist/backend/services/return-export-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-export-service.js","sourceRoot":"","sources":["../../../src/backend/services/return-export-service.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAExH;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,WAA8B;QAA9B,gBAAW,GAAX,WAAW,CAAmB;IAAG,CAAC;IAE/D,KAAK,CAAC,SAAS,CAAC,KAA4B;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAClC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAE,CAA6B,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACvF,CAAC;QACF,OAAO;YACL,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YACpC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;YAC5B,SAAS,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM;SAC7C,CAAC;IACJ,CAAC;CACF;AAED,yEAAyE;AACzE,SAAS,OAAO,CAAC,KAAa;IAC5B,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/backend/services/return-list-service.d.ts

@@ -0,0 +1,27 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { FilterQuery } from '@mikro-orm/core';
+import type { AdminReturnsListQuery, AdminReturnsListResponse, BulkTransitionResult } from '@endora-commerce/contracts';
+import { ReturnCase } from '../entities/return-case.entity.js';
+import type { ReturnStatusGraphService } from './return-status-graph-service.js';
+import type { ReturnTransitionService } from './return-transition-service.js';
+export interface ReturnListServiceDeps {
+    emFactory: () => EntityManager;
+    graphService: ReturnStatusGraphService;
+    transitions: ReturnTransitionService;
+}
+/**
+ * ReturnListService — feature 046 (US8).
+ *
+ * Filter/search/sort the admin returns list with per-status counts, plus a
+ * bulk status change that skips cases whose current status does not permit the
+ * target transition. Mirrors `OrderListService`.
+ */
+export declare class ReturnListService {
+    private readonly deps;
+    constructor(deps: ReturnListServiceDeps);
+    list(query: AdminReturnsListQuery): Promise<AdminReturnsListResponse>;
+    bulkTransition(ids: string[], to: string, adminUserId: string, reason?: string): Promise<BulkTransitionResult>;
+    buildWhere(query: AdminReturnsListQuery): FilterQuery<ReturnCase>;
+    private statusCounts;
+}
+//# sourceMappingURL=return-list-service.d.ts.map

package/dist/backend/services/return-list-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-list-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/return-list-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAEV,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAE/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,YAAY,EAAE,wBAAwB,CAAC;IACvC,WAAW,EAAE,uBAAuB,CAAC;CACtC;AAID;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,qBAAqB;IAElD,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAgCrE,cAAc,CAClB,GAAG,EAAE,MAAM,EAAE,EACb,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC;IA0BhC,UAAU,CAAC,KAAK,EAAE,qBAAqB,GAAG,WAAW,CAAC,UAAU,CAAC;YAiBnD,YAAY;CA0B3B"}

package/dist/backend/services/return-list-service.js

@@ -0,0 +1,114 @@
+import { ReturnCase } from '../entities/return-case.entity.js';
+import { orgConstraintFor } from '@endora-commerce/platform/tenancy';
+const DEFAULT_PAGE_SIZE = 25;
+/**
+ * ReturnListService — feature 046 (US8).
+ *
+ * Filter/search/sort the admin returns list with per-status counts, plus a
+ * bulk status change that skips cases whose current status does not permit the
+ * target transition. Mirrors `OrderListService`.
+ */
+export class ReturnListService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async list(query) {
+        const em = this.deps.emFactory();
+        const where = this.buildWhere(query);
+        const page = query.page ?? 1;
+        const pageSize = query.pageSize ?? DEFAULT_PAGE_SIZE;
+        const [field, dir] = (query.sort ?? 'submittedAt:desc').split(':');
+        const orderBy = field === 'rmaNumber' ? { rmaNumber: dir } : { submittedAt: dir };
+        const [cases, total] = await em.findAndCount(ReturnCase, where, {
+            orderBy,
+            limit: pageSize,
+            offset: (page - 1) * pageSize,
+        });
+        const graph = await this.deps.graphService.loadGraph();
+        const rows = cases.map((rc) => ({
+            id: rc.id,
+            rmaNumber: rc.rmaNumber ?? null,
+            kind: rc.kind,
+            orderId: rc.orderId,
+            statusCode: rc.statusCode,
+            statusLabel: graph.get(rc.statusCode)?.defaultName ?? rc.statusCode,
+            totalRefundAmount: Number(rc.totalRefundAmount),
+            currency: rc.currency,
+            submittedAt: rc.submittedAt.toISOString(),
+            customerName: null,
+            organizationName: null,
+        }));
+        return { rows, total, counts: await this.statusCounts() };
+    }
+    async bulkTransition(ids, to, adminUserId, reason) {
+        const em = this.deps.emFactory();
+        const graph = await this.deps.graphService.loadGraph();
+        const moved = [];
+        const skipped = [];
+        for (const id of ids) {
+            const rc = await em.findOne(ReturnCase, { id });
+            if (!rc) {
+                skipped.push({ id, reason: 'not_found' });
+                continue;
+            }
+            if (!graph.canTransition(rc.statusCode, to)) {
+                skipped.push({ id, reason: `cannot transition from "${rc.statusCode}"` });
+                continue;
+            }
+            await this.deps.transitions.apply(id, to, { kind: 'admin', adminUserId }, reason !== undefined ? { reason } : undefined);
+            moved.push(id);
+        }
+        return { moved, skipped };
+    }
+    buildWhere(query) {
+        const where = {};
+        const statuses = (query.status ?? '')
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+        if (statuses.length > 0)
+            Object.assign(where, { statusCode: { $in: statuses } });
+        if (query.kind)
+            Object.assign(where, { kind: query.kind });
+        if (query.rmaNumber)
+            Object.assign(where, { rmaNumber: { $ilike: `%${query.rmaNumber}%` } });
+        if (query.q) {
+            Object.assign(where, {
+                $or: [{ rmaNumber: { $ilike: `%${query.q}%` } }, { orderId: query.q }],
+            });
+        }
+        return where;
+    }
+    async statusCounts() {
+        const em = this.deps.emFactory();
+        // The main list uses em.findAndCount (auto-filtered), but this aggregate is
+        // raw knex, so apply the tenant org constraint explicitly (feature 050).
+        const qb = em
+            .getKnex()
+            .from('return_cases')
+            .select('status_code')
+            .count('* as count')
+            .groupBy('status_code');
+        const constraint = orgConstraintFor();
+        if (constraint.kind === 'single') {
+            // `whereNull` matches nothing since D-178: the only actor that reached it
+            // was a signed-in customer with no Organization, and
+            // `customer_accounts.organization_id` is `NOT NULL` now. Kept because the
+            // constraint type still admits a null.
+            if (constraint.organizationId === null)
+                void qb.whereNull('organization_id');
+            else
+                void qb.where('organization_id', constraint.organizationId);
+        }
+        else if (constraint.kind === 'set') {
+            void qb.whereIn('organization_id', [...constraint.organizationIds]);
+        }
+        const rows = await qb;
+        const out = {};
+        for (const r of rows)
+            out[r.status_code] = Number(r.count);
+        return out;
+    }
+}
+//# sourceMappingURL=return-list-service.js.map

package/dist/backend/services/return-list-service.js.map

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

package/dist/backend/services/return-list-view-service.d.ts

@@ -0,0 +1,36 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ReturnSavedViewDto } from '@endora-commerce/contracts';
+/**
+ * ReturnListViewService — feature 046 (US8).
+ *
+ * Saved admin list presets (filters + sort + visible columns), private to the
+ * owner or shared with everyone with list access. Mirrors
+ * `OrderListViewService`.
+ */
+export declare class ReturnListViewService {
+    private readonly emFactory;
+    constructor(emFactory: () => EntityManager);
+    listFor(adminUserId: string): Promise<ReturnSavedViewDto[]>;
+    create(adminUserId: string, input: {
+        name: string;
+        shared?: boolean | undefined;
+        filters: Record<string, unknown>;
+        sort: {
+            field: string;
+            dir: 'asc' | 'desc';
+        };
+        visibleColumns?: string[] | undefined;
+    }): Promise<ReturnSavedViewDto>;
+    update(id: string, adminUserId: string, patch: {
+        name?: string | undefined;
+        shared?: boolean | undefined;
+        filters?: Record<string, unknown> | undefined;
+        sort?: {
+            field: string;
+            dir: 'asc' | 'desc';
+        } | undefined;
+        visibleColumns?: string[] | null | undefined;
+    }): Promise<ReturnSavedViewDto>;
+    remove(id: string, adminUserId: string): Promise<void>;
+}
+//# sourceMappingURL=return-list-view-service.d.ts.map

package/dist/backend/services/return-list-view-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-list-view-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/return-list-view-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIrE;;;;;;GAMG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,aAAa;IAErD,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAU3D,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;SAAE,CAAC;QAC7C,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;KACvC,GACA,OAAO,CAAC,kBAAkB,CAAC;IAgBxB,MAAM,CACV,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC9C,IAAI,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;SAAE,GAAG,SAAS,CAAC;QAC1D,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;KAC9C,GACA,OAAO,CAAC,kBAAkB,CAAC;IAkBxB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAW7D"}

package/dist/backend/services/return-list-view-service.js

@@ -0,0 +1,82 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { ReturnListSavedView } from '../entities/return-list-saved-view.entity.js';
+/**
+ * ReturnListViewService — feature 046 (US8).
+ *
+ * Saved admin list presets (filters + sort + visible columns), private to the
+ * owner or shared with everyone with list access. Mirrors
+ * `OrderListViewService`.
+ */
+export class ReturnListViewService {
+    emFactory;
+    constructor(emFactory) {
+        this.emFactory = emFactory;
+    }
+    async listFor(adminUserId) {
+        const em = this.emFactory();
+        const views = await em.find(ReturnListSavedView, { $or: [{ ownerAdminUserId: adminUserId }, { shared: true }] }, { orderBy: { createdAt: 'asc' } });
+        return views.map(toDto);
+    }
+    async create(adminUserId, input) {
+        // command-coverage-ignore: saved list views are per-admin UI presets
+        // (filters/sort/columns), not audited domain-state.
+        const em = this.emFactory();
+        const view = em.create(ReturnListSavedView, {
+            ownerAdminUserId: adminUserId,
+            name: input.name,
+            shared: input.shared ?? false,
+            filters: input.filters,
+            sort: input.sort,
+            visibleColumns: input.visibleColumns ?? null,
+        });
+        await em.persistAndFlush(view);
+        return toDto(view);
+    }
+    async update(id, adminUserId, patch) {
+        // command-coverage-ignore: saved list views are per-admin UI presets, not
+        // audited domain-state.
+        const em = this.emFactory();
+        const view = await em.findOne(ReturnListSavedView, { id });
+        if (!view)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Saved view not found.');
+        if (view.ownerAdminUserId !== adminUserId) {
+            throw new HttpError(403, ERROR_CODES.FORBIDDEN, 'Only the owner can edit this view.');
+        }
+        if (patch.name !== undefined)
+            view.name = patch.name;
+        if (patch.shared !== undefined)
+            view.shared = patch.shared;
+        if (patch.filters !== undefined)
+            view.filters = patch.filters;
+        if (patch.sort !== undefined)
+            view.sort = patch.sort;
+        if (patch.visibleColumns !== undefined)
+            view.visibleColumns = patch.visibleColumns;
+        await em.flush();
+        return toDto(view);
+    }
+    async remove(id, adminUserId) {
+        // command-coverage-ignore: saved list views are per-admin UI presets, not
+        // audited domain-state.
+        const em = this.emFactory();
+        const view = await em.findOne(ReturnListSavedView, { id });
+        if (!view)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Saved view not found.');
+        if (view.ownerAdminUserId !== adminUserId) {
+            throw new HttpError(403, ERROR_CODES.FORBIDDEN, 'Only the owner can delete this view.');
+        }
+        await em.removeAndFlush(view);
+    }
+}
+function toDto(v) {
+    return {
+        id: v.id,
+        name: v.name,
+        shared: v.shared,
+        filters: v.filters,
+        sort: v.sort,
+        visibleColumns: v.visibleColumns ?? null,
+    };
+}
+//# sourceMappingURL=return-list-view-service.js.map

package/dist/backend/services/return-list-view-service.js.map

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

package/dist/backend/services/return-reason-service.d.ts

@@ -0,0 +1,33 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ReturnReasonDto } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+/**
+ * ReturnReasonService — feature 046 (US7, FR-030).
+ *
+ * Manages the return/complaint reason list. The storefront form reads the active
+ * reasons (optionally filtered by case kind) in `weight` order.
+ */
+export declare class ReturnReasonService {
+    #private;
+    private readonly emFactory;
+    private readonly auditLog?;
+    constructor(emFactory: () => EntityManager, auditLog?: AuditPort | undefined);
+    /** All reasons (admin view), ordered by weight. */
+    listAll(): Promise<ReturnReasonDto[]>;
+    /** Active reasons for a case kind (storefront), ordered by weight. */
+    listActive(kind?: 'return' | 'complaint'): Promise<ReturnReasonDto[]>;
+    create(input: {
+        label: Record<string, string>;
+        appliesTo: 'return' | 'complaint' | 'both';
+        isActive?: boolean | undefined;
+        weight?: number | undefined;
+    }): Promise<ReturnReasonDto>;
+    update(id: string, patch: {
+        label?: Record<string, string> | undefined;
+        appliesTo?: 'return' | 'complaint' | 'both' | undefined;
+        isActive?: boolean | undefined;
+        weight?: number | undefined;
+    }): Promise<ReturnReasonDto>;
+    remove(id: string): Promise<void>;
+}
+//# sourceMappingURL=return-reason-service.d.ts.map

package/dist/backend/services/return-reason-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"return-reason-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/return-reason-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGlE;;;;;GAKG;AACH,qBAAa,mBAAmB;;IAE5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBADT,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,CAAC,EAAE,SAAS,YAAA;IAqBvC,mDAAmD;IAC7C,OAAO,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAM3C,sEAAsE;IAChE,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IASrE,MAAM,CAAC,KAAK,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,SAAS,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;QAC3C,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7B,GAAG,OAAO,CAAC,eAAe,CAAC;IActB,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;QAC3C,SAAS,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;QACxD,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7B,GACA,OAAO,CAAC,eAAe,CAAC;IAiBrB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOxC"}