@endora-commerce/mod-returns 0.100.0

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

@@ -0,0 +1,260 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { recordAuditFromContext } from '@endora-commerce/platform/commands';
+import { ReturnCase } from '../entities/return-case.entity.js';
+import { ReturnCaseItem } from '../entities/return-case-item.entity.js';
+import { ReturnCaseComment } from '../entities/return-case-comment.entity.js';
+import { ReturnCaseAttachment } from '../entities/return-case-attachment.entity.js';
+import { ReturnReason } from '../entities/return-reason.entity.js';
+import { Refund } from '../entities/refund.entity.js';
+import { RETURN_STATUS_CANCELLED } from '../domain/return-status-graph.js';
+import { isWithinFreeWindow } from '../domain/free-return-window.js';
+import { defaultRefundForQuantity } from '../domain/refund-math.js';
+/** Statuses whose cases do NOT consume returnable quantity (FR-003). */
+const VOID_STATUS_CODES = new Set(['rejected', 'cancelled']);
+/**
+ * ReturnCaseService — feature 046 (US1).
+ *
+ * Eligibility evaluation, remaining-returnable computation, and case creation in
+ * the initial workflow status. Reads order facts only through the
+ * `OrderReturnContextPort` (Principle I).
+ */
+export class ReturnCaseService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    now() {
+        return this.deps.now ? this.deps.now() : new Date();
+    }
+    /** Lines a customer may still return for an order, with the eligibility verdict. */
+    async getReturnable(orderId, customerAccountId) {
+        const ctx = await this.deps.orderContext.getReturnContext(orderId);
+        if (!ctx || ctx.customerAccountId !== customerAccountId) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Order not found.');
+        }
+        const consumed = await this.consumedQuantities(orderId);
+        const lines = ctx.lines.map((l) => ({
+            orderItemId: l.orderItemId,
+            productId: l.productId,
+            name: l.name,
+            purchasedQty: l.purchasedQty,
+            remainingReturnableQty: Math.max(0, l.purchasedQty - (consumed.get(l.orderItemId) ?? 0)),
+            paidUnitAmount: l.paidUnitAmount,
+            currency: ctx.currency,
+        }));
+        const freeReturnEligible = await this.isWithinFreeWindow(ctx.salesChannelId, ctx.completingStatusEnteredAt);
+        if (ctx.completingStatusEnteredAt === null) {
+            return { eligible: false, reason: 'order_not_completing', freeReturnEligible: false, lines };
+        }
+        if (lines.every((l) => l.remainingReturnableQty === 0)) {
+            return { eligible: false, reason: 'fully_returned', freeReturnEligible, lines };
+        }
+        return { eligible: true, freeReturnEligible, lines };
+    }
+    /** Open a return/complaint case (FR-001/002/003/005). */
+    async createCase(input, customerAccountId) {
+        const ctx = await this.deps.orderContext.getReturnContext(input.orderId);
+        if (!ctx || ctx.customerAccountId !== customerAccountId) {
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Order not found.');
+        }
+        if (ctx.completingStatusEnteredAt === null) {
+            throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'This order is not yet eligible for returns.', { code: 'order_not_completing' });
+        }
+        const byOrderItem = new Map(ctx.lines.map((l) => [l.orderItemId, l]));
+        const consumed = await this.consumedQuantities(input.orderId);
+        const reasons = new Map((await this.deps.emFactory().find(ReturnReason, { isActive: true })).map((r) => [r.id, r]));
+        for (const line of input.lines) {
+            const ctxLine = byOrderItem.get(line.orderItemId);
+            if (!ctxLine) {
+                throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'Unknown order line.', {
+                    code: 'unknown_line',
+                });
+            }
+            const remaining = ctxLine.purchasedQty - (consumed.get(line.orderItemId) ?? 0);
+            if (line.quantity > remaining) {
+                throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, `Requested quantity (${line.quantity}) exceeds the returnable quantity (${remaining}).`, { code: 'qty_exceeds_returnable' });
+            }
+            if (!reasons.has(line.reasonId)) {
+                throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'Unknown or inactive reason.', {
+                    code: 'unknown_reason',
+                });
+            }
+        }
+        const em = this.deps.emFactory();
+        const graph = await this.deps.graphService.loadGraph();
+        const now = this.now();
+        const freeReturnEligible = input.kind === 'return'
+            ? await this.isWithinFreeWindow(ctx.salesChannelId, ctx.completingStatusEnteredAt)
+            : false;
+        const rc = em.create(ReturnCase, {
+            kind: input.kind,
+            orderId: input.orderId,
+            salesChannelId: ctx.salesChannelId,
+            customerAccountId,
+            organizationId: ctx.organizationId,
+            statusCode: graph.initialCode(),
+            currency: ctx.currency,
+            freeReturnEligible,
+            submittedAt: now,
+        });
+        em.persist(rc);
+        for (const line of input.lines) {
+            const ctxLine = byOrderItem.get(line.orderItemId);
+            const defaultRefund = defaultRefundForQuantity(ctxLine.paidUnitAmount, line.quantity);
+            em.persist(em.create(ReturnCaseItem, {
+                returnCaseId: rc.id,
+                orderItemId: line.orderItemId,
+                productId: ctxLine.productId,
+                productName: ctxLine.name,
+                quantity: line.quantity,
+                reasonId: line.reasonId,
+                description: line.description ?? null,
+                defaultRefundAmount: defaultRefund.toFixed(2),
+                approvedRefundAmount: defaultRefund.toFixed(2),
+            }));
+        }
+        for (const assetId of input.attachmentAssetIds ?? []) {
+            em.persist(em.create(ReturnCaseAttachment, { returnCaseId: rc.id, assetId }));
+        }
+        if (input.comment) {
+            em.persist(em.create(ReturnCaseComment, {
+                returnCaseId: rc.id,
+                authorCustomerAccountId: customerAccountId,
+                body: input.comment,
+                isCustomerVisible: true,
+                notifyCustomer: false,
+            }));
+        }
+        if (this.deps.auditLog) {
+            recordAuditFromContext(this.deps.auditLog, em, {
+                action: 'return_case.create',
+                objectType: 'return_case',
+                objectId: rc.id,
+                stateBefore: null,
+                stateAfter: {
+                    kind: rc.kind,
+                    orderId: rc.orderId,
+                    statusCode: rc.statusCode,
+                    lineCount: input.lines.length,
+                },
+            });
+        }
+        await em.flush();
+        return this.mapDetail(em, rc.id, { customerView: true });
+    }
+    async listForCustomer(customerAccountId) {
+        const em = this.deps.emFactory();
+        const cases = await em.find(ReturnCase, { customerAccountId }, { orderBy: { submittedAt: 'desc' } });
+        const graph = await this.deps.graphService.loadGraph();
+        return cases.map((rc) => this.toSummary(rc, graph.get(rc.statusCode)?.defaultName ?? rc.statusCode));
+    }
+    async getForCustomer(id, customerAccountId) {
+        const em = this.deps.emFactory();
+        const rc = await em.findOne(ReturnCase, { id, customerAccountId });
+        if (!rc)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Return case not found.');
+        return this.mapDetail(em, rc.id, { customerView: true });
+    }
+    /** Customer withdraws their own case (if the workflow permits the transition). */
+    async cancelByCustomer(id, customerAccountId) {
+        const em = this.deps.emFactory();
+        const rc = await em.findOne(ReturnCase, { id, customerAccountId });
+        if (!rc)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Return case not found.');
+        await this.deps.transitions.apply(id, RETURN_STATUS_CANCELLED, { kind: 'customer', customerAccountId });
+        return this.mapDetail(this.deps.emFactory(), id, { customerView: true });
+    }
+    /** Detail for the admin surface (includes internal comments). */
+    async getByIdForAdmin(id) {
+        const em = this.deps.emFactory();
+        const rc = await em.findOne(ReturnCase, { id });
+        if (!rc)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Return case not found.');
+        return this.mapDetail(em, rc.id, { customerView: false });
+    }
+    // --- internals ----------------------------------------------------------
+    async consumedQuantities(orderId) {
+        const em = this.deps.emFactory();
+        const cases = await em.find(ReturnCase, { orderId });
+        const liveCaseIds = cases.filter((c) => !VOID_STATUS_CODES.has(c.statusCode)).map((c) => c.id);
+        const out = new Map();
+        if (liveCaseIds.length === 0)
+            return out;
+        const items = await em.find(ReturnCaseItem, { returnCaseId: { $in: liveCaseIds } });
+        for (const it of items) {
+            out.set(it.orderItemId, (out.get(it.orderItemId) ?? 0) + it.quantity);
+        }
+        return out;
+    }
+    async isWithinFreeWindow(salesChannelId, completingAt) {
+        const days = await this.deps.resolveFreeReturnDays(salesChannelId);
+        return isWithinFreeWindow(this.now(), completingAt, days);
+    }
+    toSummary(rc, statusLabel) {
+        return {
+            id: rc.id,
+            rmaNumber: rc.rmaNumber ?? null,
+            kind: rc.kind,
+            orderId: rc.orderId,
+            statusCode: rc.statusCode,
+            statusLabel,
+            totalRefundAmount: Number(rc.totalRefundAmount),
+            currency: rc.currency,
+            submittedAt: rc.submittedAt.toISOString(),
+        };
+    }
+    async mapDetail(em, id, opts) {
+        const rc = await em.findOneOrFail(ReturnCase, { id });
+        const [items, comments, graph, refund] = await Promise.all([
+            em.find(ReturnCaseItem, { returnCaseId: id }),
+            em.find(ReturnCaseComment, { returnCaseId: id }, { orderBy: { createdAt: 'asc' } }),
+            this.deps.graphService.loadGraph(),
+            // D-92 — the settled case's corrective-invoice answer, which used to live
+            // only in the settlement response and the audit entry. A reloaded screen
+            // reads it here.
+            em.findOne(Refund, { returnCaseId: id }),
+        ]);
+        const visibleComments = comments.filter((c) => !opts.customerView || c.isCustomerVisible);
+        return {
+            ...this.toSummary(rc, graph.get(rc.statusCode)?.defaultName ?? rc.statusCode),
+            salesChannelId: rc.salesChannelId,
+            customerAccountId: rc.customerAccountId,
+            organizationId: rc.organizationId ?? null,
+            returnDeliveryMethodId: rc.returnDeliveryMethodId ?? null,
+            appliedReturnCost: Number(rc.appliedReturnCost),
+            returnCostBearer: rc.returnCostBearer,
+            freeReturnEligible: rc.freeReturnEligible,
+            resolutionType: rc.resolutionType ?? null,
+            rejectionReason: rc.rejectionReason ?? null,
+            items: items.map((it) => ({
+                id: it.id,
+                orderItemId: it.orderItemId,
+                productId: it.productId,
+                productName: it.productName,
+                quantity: it.quantity,
+                reasonId: it.reasonId ?? null,
+                description: it.description ?? null,
+                inspectionOutcome: it.inspectionOutcome ?? null,
+                defaultRefundAmount: Number(it.defaultRefundAmount),
+                approvedRefundAmount: Number(it.approvedRefundAmount),
+            })),
+            comments: visibleComments.map((c) => ({
+                id: c.id,
+                authorKind: c.authorAdminUserId ? 'admin' : 'customer',
+                body: c.body,
+                isCustomerVisible: c.isCustomerVisible,
+                createdAt: c.createdAt.toISOString(),
+            })),
+            // Null while the case has no refund row: never settled, or settled as a
+            // replacement or repair, which corrects no document at all.
+            correctiveInvoice: refund
+                ? {
+                    outcome: refund.correctiveInvoiceOutcome,
+                    invoiceId: refund.correctiveInvoiceId ?? null,
+                }
+                : null,
+        };
+    }
+}
+//# sourceMappingURL=return-case-service.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ReturnCaseCommentDto } from '@endora-commerce/contracts';
+import type { ReturnStatusGraphService } from './return-status-graph-service.js';
+export interface ReturnCommentServiceDeps {
+    emFactory: () => EntityManager;
+    graphService: ReturnStatusGraphService;
+}
+/**
+ * ReturnCommentService — feature 046 (US4).
+ *
+ * Threaded comments on a case. Admin comments carry a visibility choice and a
+ * notify flag; customer comments are always visible. Commenting is blocked once
+ * the case reaches a terminal status. Mirrors `OrderCommentService`.
+ */
+export declare class ReturnCommentService {
+    private readonly deps;
+    constructor(deps: ReturnCommentServiceDeps);
+    addByAdmin(id: string, adminUserId: string, input: {
+        body: string;
+        isCustomerVisible: boolean;
+        notifyCustomer: boolean;
+    }): Promise<ReturnCaseCommentDto>;
+    addByCustomer(id: string, customerAccountId: string, input: {
+        body: string;
+    }): Promise<ReturnCaseCommentDto>;
+    /**
+     * The whole thread, internal comments included, for the admin panel.
+     *
+     * The case read is the tenant boundary and not a formality: `ReturnCaseComment`
+     * is `@GlobalEntity`, so `em.find(ReturnCaseComment, { returnCaseId })` carries
+     * no filter and answers for every case on the platform, while `ReturnCase` is
+     * `@OrgScoped`. `listForCustomer` below has always keyed on the case *and* its
+     * customer; this one keyed on nothing, and every comment on this thread is one
+     * an operator wrote believing only their own colleagues would read it.
+     *
+     * `loadOpenCase` is the wrong helper here — it also refuses a closed case,
+     * which a reader is entitled to see. Same read, no lifecycle term.
+     */
+    listForAdmin(id: string): Promise<ReturnCaseCommentDto[]>;
+    listForCustomer(id: string, customerAccountId: string): Promise<ReturnCaseCommentDto[]>;
+    private loadOpenCase;
+}
+//# sourceMappingURL=return-comment-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"return-comment-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/return-comment-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEjF,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,YAAY,EAAE,wBAAwB,CAAC;CACxC;AAED;;;;;;GAMG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAErD,UAAU,CACd,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,GAC3E,OAAO,CAAC,oBAAoB,CAAC;IA0B1B,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GACtB,OAAO,CAAC,oBAAoB,CAAC;IAiBhC;;;;;;;;;;;;OAYG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAYzD,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAY/E,YAAY;CAc3B"}

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

@@ -0,0 +1,109 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { ReturnCase } from '../entities/return-case.entity.js';
+import { ReturnCaseComment } from '../entities/return-case-comment.entity.js';
+/**
+ * ReturnCommentService — feature 046 (US4).
+ *
+ * Threaded comments on a case. Admin comments carry a visibility choice and a
+ * notify flag; customer comments are always visible. Commenting is blocked once
+ * the case reaches a terminal status. Mirrors `OrderCommentService`.
+ */
+export class ReturnCommentService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async addByAdmin(id, adminUserId, input) {
+        // command-coverage-ignore: return-case comments are an append-only
+        // communication thread, not audited domain-state (no before-state, no undo).
+        const em = this.deps.emFactory();
+        const rc = await this.loadOpenCase(em, { id });
+        const comment = em.create(ReturnCaseComment, {
+            returnCaseId: rc.id,
+            authorAdminUserId: adminUserId,
+            body: input.body,
+            isCustomerVisible: input.isCustomerVisible,
+            notifyCustomer: input.notifyCustomer,
+        });
+        em.persist(comment);
+        await em.flush();
+        // `notifyCustomer` is recorded on the row and nothing sends on it. The
+        // optional `notifier` that used to stand here went with
+        // `specs/110-instance-repository/` T118c: it was declared, guarded and
+        // supplied by nobody — `plugin.ts` builds this service with `emFactory` and
+        // `graphService` and no third member — so its `catch` was a tolerance around
+        // an expression that could not run. This module's own `exposeServices` was
+        // deleted on the same argument in feature 072. Sending on a comment is a
+        // product decision; when it is taken, it takes a notifier the composition
+        // really supplies and an off-state answer of its own.
+        return toDto(comment);
+    }
+    async addByCustomer(id, customerAccountId, input) {
+        // command-coverage-ignore: return-case comments are an append-only
+        // communication thread, not audited domain-state (no before-state, no undo).
+        const em = this.deps.emFactory();
+        const rc = await this.loadOpenCase(em, { id, customerAccountId });
+        const comment = em.create(ReturnCaseComment, {
+            returnCaseId: rc.id,
+            authorCustomerAccountId: customerAccountId,
+            body: input.body,
+            isCustomerVisible: true,
+            notifyCustomer: false,
+        });
+        em.persist(comment);
+        await em.flush();
+        return toDto(comment);
+    }
+    /**
+     * The whole thread, internal comments included, for the admin panel.
+     *
+     * The case read is the tenant boundary and not a formality: `ReturnCaseComment`
+     * is `@GlobalEntity`, so `em.find(ReturnCaseComment, { returnCaseId })` carries
+     * no filter and answers for every case on the platform, while `ReturnCase` is
+     * `@OrgScoped`. `listForCustomer` below has always keyed on the case *and* its
+     * customer; this one keyed on nothing, and every comment on this thread is one
+     * an operator wrote believing only their own colleagues would read it.
+     *
+     * `loadOpenCase` is the wrong helper here — it also refuses a closed case,
+     * which a reader is entitled to see. Same read, no lifecycle term.
+     */
+    async listForAdmin(id) {
+        const em = this.deps.emFactory();
+        const rc = await em.findOne(ReturnCase, { id });
+        if (!rc)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Return case not found.');
+        const comments = await em.find(ReturnCaseComment, { returnCaseId: id }, { orderBy: { createdAt: 'asc' } });
+        return comments.map(toDto);
+    }
+    async listForCustomer(id, customerAccountId) {
+        const em = this.deps.emFactory();
+        const rc = await em.findOne(ReturnCase, { id, customerAccountId });
+        if (!rc)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Return case not found.');
+        const comments = await em.find(ReturnCaseComment, { returnCaseId: id, isCustomerVisible: true }, { orderBy: { createdAt: 'asc' } });
+        return comments.map(toDto);
+    }
+    async loadOpenCase(em, where) {
+        const rc = await em.findOne(ReturnCase, where);
+        if (!rc)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Return case not found.');
+        const graph = await this.deps.graphService.loadGraph();
+        if (graph.isTerminal(rc.statusCode)) {
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, 'Commenting is closed for finished cases.', {
+                code: 'case_terminal',
+            });
+        }
+        return rc;
+    }
+}
+function toDto(c) {
+    return {
+        id: c.id,
+        authorKind: c.authorAdminUserId ? 'admin' : 'customer',
+        body: c.body,
+        isCustomerVisible: c.isCustomerVisible,
+        createdAt: c.createdAt.toISOString(),
+    };
+}
+//# sourceMappingURL=return-comment-service.js.map

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

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

package/dist/backend/services/return-delivery-method-service.d.ts

@@ -0,0 +1,44 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ReturnDeliveryMethodDto } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { ReturnStatusGraphService } from './return-status-graph-service.js';
+export interface ReturnDeliveryMethodServiceDeps {
+    emFactory: () => EntityManager;
+    graphService: ReturnStatusGraphService;
+    /** `'customer'` | `'shop'` default bearer once the free-return window passes. */
+    resolveDefaultCostBearer: (salesChannelId: string) => Promise<'customer' | 'shop'>;
+    /** Feature 054 — audits method writes co-transactionally when provided. */
+    auditLog?: AuditPort;
+}
+/**
+ * ReturnDeliveryMethodService — feature 046 (US6).
+ *
+ * CRUD for the allowed return delivery methods (with per-method return cost,
+ * 0 = free/shop-paid) and selection of a method on a case, which resolves the
+ * applied cost and the cost bearer from the free-return window (FR-021/022/023).
+ */
+export declare class ReturnDeliveryMethodService {
+    #private;
+    private readonly deps;
+    constructor(deps: ReturnDeliveryMethodServiceDeps);
+    list(): Promise<ReturnDeliveryMethodDto[]>;
+    create(input: {
+        deliveryMethodId: string;
+        returnCost: number;
+        currency: string;
+        isActive?: boolean | undefined;
+    }): Promise<ReturnDeliveryMethodDto>;
+    update(id: string, patch: {
+        returnCost?: number | undefined;
+        currency?: string | undefined;
+        isActive?: boolean | undefined;
+    }): Promise<ReturnDeliveryMethodDto>;
+    remove(id: string): Promise<void>;
+    /** Apply an allowed return delivery method to a case and resolve cost + bearer. */
+    selectForCase(caseId: string, customerAccountId: string, returnDeliveryMethodId: string): Promise<{
+        appliedReturnCost: number;
+        returnCostBearer: 'customer' | 'shop';
+        currency: string;
+    }>;
+}
+//# sourceMappingURL=return-delivery-method-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"return-delivery-method-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/return-delivery-method-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAG1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGlE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEjF,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,YAAY,EAAE,wBAAwB,CAAC;IACvC,iFAAiF;IACjF,wBAAwB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC;IACnF,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;GAMG;AACH,qBAAa,2BAA2B;;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,+BAA+B;IAe5D,IAAI,IAAI,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAM1C,MAAM,CAAC,KAAK,EAAE;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KAChC,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAkB9B,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KAChC,GACA,OAAO,CAAC,uBAAuB,CAAC;IAgB7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvC,mFAAmF;IAC7E,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,sBAAsB,EAAE,MAAM,GAC7B,OAAO,CAAC;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,UAAU,GAAG,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CA6BnG"}

package/dist/backend/services/return-delivery-method-service.js

@@ -0,0 +1,114 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { recordAuditFromContext } from '@endora-commerce/platform/commands';
+import { ReturnCase } from '../entities/return-case.entity.js';
+import { ReturnDeliveryMethod } from '../entities/return-delivery-method.entity.js';
+/**
+ * ReturnDeliveryMethodService — feature 046 (US6).
+ *
+ * CRUD for the allowed return delivery methods (with per-method return cost,
+ * 0 = free/shop-paid) and selection of a method on a case, which resolves the
+ * applied cost and the cost bearer from the free-return window (FR-021/022/023).
+ */
+export class ReturnDeliveryMethodService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    #audit(em, action, objectType, objectId, stateBefore, stateAfter) {
+        if (this.deps.auditLog) {
+            recordAuditFromContext(this.deps.auditLog, em, { action, objectType, objectId, stateBefore, stateAfter });
+        }
+    }
+    async list() {
+        const em = this.deps.emFactory();
+        const rows = await em.find(ReturnDeliveryMethod, {}, { orderBy: { createdAt: 'asc' } });
+        return rows.map(toDto);
+    }
+    async create(input) {
+        const em = this.deps.emFactory();
+        const row = em.create(ReturnDeliveryMethod, {
+            deliveryMethodId: input.deliveryMethodId,
+            returnCost: input.returnCost.toFixed(2),
+            currency: input.currency,
+            isActive: input.isActive ?? true,
+        });
+        em.persist(row);
+        this.#audit(em, 'return_delivery_method.create', 'return_delivery_method', row.id, null, {
+            deliveryMethodId: row.deliveryMethodId,
+            returnCost: row.returnCost,
+            currency: row.currency,
+        });
+        await em.flush();
+        return toDto(row);
+    }
+    async update(id, patch) {
+        const em = this.deps.emFactory();
+        const row = await em.findOne(ReturnDeliveryMethod, { id });
+        if (!row)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Return delivery method not found.');
+        if (patch.returnCost !== undefined)
+            row.returnCost = patch.returnCost.toFixed(2);
+        if (patch.currency !== undefined)
+            row.currency = patch.currency;
+        if (patch.isActive !== undefined)
+            row.isActive = patch.isActive;
+        this.#audit(em, 'return_delivery_method.update', 'return_delivery_method', row.id, null, {
+            returnCost: row.returnCost,
+            currency: row.currency,
+            isActive: row.isActive,
+        });
+        await em.flush();
+        return toDto(row);
+    }
+    async remove(id) {
+        const em = this.deps.emFactory();
+        const row = await em.findOne(ReturnDeliveryMethod, { id });
+        if (!row)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Return delivery method not found.');
+        this.#audit(em, 'return_delivery_method.delete', 'return_delivery_method', row.id, {
+            deliveryMethodId: row.deliveryMethodId,
+        }, null);
+        await em.removeAndFlush(row);
+    }
+    /** Apply an allowed return delivery method to a case and resolve cost + bearer. */
+    async selectForCase(caseId, customerAccountId, returnDeliveryMethodId) {
+        const em = this.deps.emFactory();
+        const rc = await em.findOne(ReturnCase, { id: caseId, customerAccountId });
+        if (!rc)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Return case not found.');
+        const graph = await this.deps.graphService.loadGraph();
+        if (graph.isTerminal(rc.statusCode)) {
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, 'The case is closed.', { code: 'case_terminal' });
+        }
+        const method = await em.findOne(ReturnDeliveryMethod, { id: returnDeliveryMethodId, isActive: true });
+        if (!method) {
+            throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'Return delivery method is not available.', {
+                code: 'method_not_allowed',
+            });
+        }
+        const bearer = rc.freeReturnEligible
+            ? 'shop'
+            : await this.deps.resolveDefaultCostBearer(rc.salesChannelId);
+        rc.returnDeliveryMethodId = method.id;
+        rc.appliedReturnCost = method.returnCost;
+        rc.returnCostBearer = bearer;
+        this.#audit(em, 'return_case.select_delivery_method', 'return_case', rc.id, null, {
+            returnDeliveryMethodId: method.id,
+            appliedReturnCost: method.returnCost,
+            returnCostBearer: bearer,
+        });
+        await em.flush();
+        return { appliedReturnCost: Number(method.returnCost), returnCostBearer: bearer, currency: method.currency };
+    }
+}
+function toDto(r) {
+    return {
+        id: r.id,
+        deliveryMethodId: r.deliveryMethodId,
+        returnCost: Number(r.returnCost),
+        currency: r.currency,
+        isActive: r.isActive,
+    };
+}
+//# sourceMappingURL=return-delivery-method-service.js.map

package/dist/backend/services/return-delivery-method-service.js.map

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