@open-mercato/core 0.6.6-develop.5617.1.62538c48ca → 0.6.6-develop.5637.1.7a68607cc6

package/dist/modules/sales/commands/returns.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/sales/commands/returns.ts"],
-  "sourcesContent": ["import { randomUUID } from 'crypto'\nimport { registerCommand, type CommandHandler } from '@open-mercato/shared/lib/commands'\nimport { withAtomicFlush } from '@open-mercato/shared/lib/commands/flush'\nimport { LockMode } from '@mikro-orm/core'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { emitCrudSideEffects } from '@open-mercato/shared/lib/commands/helpers'\nimport type { CrudEventsConfig } from '@open-mercato/shared/lib/crud/types'\nimport type { DataEngine } from '@open-mercato/shared/lib/data/engine'\nimport { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { SalesDocumentNumberGenerator } from '../services/salesDocumentNumberGenerator'\nimport type { SalesCalculationService } from '../services/salesCalculationService'\nimport type { SalesAdjustmentDraft, SalesLineSnapshot, SalesDocumentCalculationResult } from '../lib/types'\nimport { cloneJson, ensureOrganizationScope, ensureSameScope, ensureTenantScope, extractUndoPayload, toNumericString, enforceSalesDocumentOptimisticLock, SALES_RESOURCE_KIND_ORDER } from './shared'\nimport { resolveRedoSnapshot } from '@open-mercato/shared/lib/commands/redo'\nimport { SalesOrder, SalesOrderAdjustment, SalesOrderLine, SalesReturn, SalesReturnLine } from '../data/entities'\nimport { returnCreateSchema, type ReturnCreateInput } from '../data/validators'\nimport { E } from '#generated/entities.ids.generated'\n\ntype ReturnLineInput = { orderLineId: string; quantity: number }\n\ntype ReturnSnapshot = {\n  id: string\n  orderId: string\n  organizationId: string\n  tenantId: string\n  returnNumber: string\n  returnedAt: string | null\n  reason: string | null\n  notes: string | null\n  lines: Array<{\n    id: string\n    orderLineId: string\n    quantityReturned: number\n    unitPriceNet: number\n    unitPriceGross: number\n    totalNetAmount: number\n    totalGrossAmount: number\n  }>\n  adjustmentIds: string[]\n}\n\ntype ReturnUndoPayload = {\n  after?: ReturnSnapshot | null\n}\n\nconst returnCrudEvents: CrudEventsConfig = {\n  module: 'sales',\n  entity: 'return',\n  persistent: true,\n  buildPayload: (ctx) => ({\n    id: ctx.identifiers.id,\n    organizationId: ctx.identifiers.organizationId,\n    tenantId: ctx.identifiers.tenantId,\n  }),\n}\n\nfunction toNumeric(value: unknown): number {\n  if (typeof value === 'number' && Number.isFinite(value)) return value\n  if (typeof value === 'string' && value.trim().length) {\n    const parsed = Number(value)\n    if (Number.isFinite(parsed)) return parsed\n  }\n  return 0\n}\n\nfunction round(value: number): number {\n  return Math.round((value + Number.EPSILON) * 1e4) / 1e4\n}\n\nfunction applyOrderTotals(order: SalesOrder, totals: SalesDocumentCalculationResult['totals'], lineCount: number): void {\n  order.subtotalNetAmount = toNumericString(totals.subtotalNetAmount) ?? '0'\n  order.subtotalGrossAmount = toNumericString(totals.subtotalGrossAmount) ?? '0'\n  order.discountTotalAmount = toNumericString(totals.discountTotalAmount) ?? '0'\n  order.taxTotalAmount = toNumericString(totals.taxTotalAmount) ?? '0'\n  order.shippingNetAmount = toNumericString(totals.shippingNetAmount) ?? '0'\n  order.shippingGrossAmount = toNumericString(totals.shippingGrossAmount) ?? '0'\n  order.surchargeTotalAmount = toNumericString(totals.surchargeTotalAmount) ?? '0'\n  order.grandTotalNetAmount = toNumericString(totals.grandTotalNetAmount) ?? '0'\n  order.grandTotalGrossAmount = toNumericString(totals.grandTotalGrossAmount) ?? '0'\n  order.paidTotalAmount = toNumericString(totals.paidTotalAmount) ?? '0'\n  order.refundedTotalAmount = toNumericString(totals.refundedTotalAmount) ?? '0'\n  order.outstandingAmount = toNumericString(totals.outstandingAmount) ?? '0'\n  order.totalsSnapshot = cloneJson(totals)\n  order.lineItemCount = lineCount\n}\n\nfunction mapOrderLineEntityToSnapshot(line: SalesOrderLine): SalesLineSnapshot {\n  return {\n    id: line.id,\n    lineNumber: line.lineNumber,\n    kind: line.kind,\n    productId: line.productId ?? null,\n    productVariantId: line.productVariantId ?? null,\n    name: line.name ?? null,\n    description: line.description ?? null,\n    comment: line.comment ?? null,\n    quantity: toNumeric(line.quantity),\n    quantityUnit: line.quantityUnit ?? null,\n    normalizedQuantity: toNumeric(line.normalizedQuantity ?? line.quantity),\n    normalizedUnit: line.normalizedUnit ?? line.quantityUnit ?? null,\n    uomSnapshot: line.uomSnapshot ? cloneJson(line.uomSnapshot) : null,\n    currencyCode: line.currencyCode,\n    unitPriceNet: toNumeric(line.unitPriceNet),\n    unitPriceGross: toNumeric(line.unitPriceGross),\n    discountAmount: toNumeric(line.discountAmount),\n    discountPercent: toNumeric(line.discountPercent),\n    taxRate: toNumeric(line.taxRate),\n    taxAmount: toNumeric(line.taxAmount),\n    totalNetAmount: toNumeric(line.totalNetAmount),\n    totalGrossAmount: toNumeric(line.totalGrossAmount),\n    configuration: line.configuration ? cloneJson(line.configuration) : null,\n    promotionCode: line.promotionCode ?? null,\n    metadata: line.metadata ? cloneJson(line.metadata) : null,\n    customFieldSetId: line.customFieldSetId ?? null,\n  }\n}\n\nfunction mapOrderAdjustmentToDraft(adjustment: SalesOrderAdjustment): SalesAdjustmentDraft {\n  return {\n    id: adjustment.id,\n    scope: adjustment.scope ?? 'order',\n    kind: adjustment.kind,\n    code: adjustment.code ?? null,\n    label: adjustment.label ?? null,\n    calculatorKey: adjustment.calculatorKey ?? null,\n    promotionId: adjustment.promotionId ?? null,\n    rate: toNumeric(adjustment.rate),\n    amountNet: toNumeric(adjustment.amountNet),\n    amountGross: toNumeric(adjustment.amountGross),\n    currencyCode: adjustment.currencyCode ?? null,\n    metadata: adjustment.metadata ? cloneJson(adjustment.metadata) : null,\n    position: adjustment.position ?? 0,\n  }\n}\n\nfunction buildCalculationContext(order: SalesOrder) {\n  return {\n    tenantId: order.tenantId,\n    organizationId: order.organizationId,\n    currencyCode: order.currencyCode,\n    metadata: {\n      shippingMethod: order.shippingMethodSnapshot\n        ? cloneJson(order.shippingMethodSnapshot as Record<string, unknown>)\n        : null,\n      paymentMethod: order.paymentMethodSnapshot ? cloneJson(order.paymentMethodSnapshot as Record<string, unknown>) : null,\n    },\n  }\n}\n\n/**\n * Recalculates order totals (including line-scoped return adjustments) for display.\n * Returns the totals object to merge into an order API response, or null if order not found.\n */\nexport async function recalculateOrderTotalsForDisplay(\n  em: EntityManager,\n  container: { resolve: (key: string) => unknown },\n  orderId: string,\n  scope: { tenantId: string; organizationId: string },\n): Promise<SalesDocumentCalculationResult['totals'] | null> {\n  const order = await findOneWithDecryption(\n    em,\n    SalesOrder,\n    { id: orderId, deletedAt: null },\n    {},\n    scope,\n  )\n  if (!order) return null\n  const [orderLines, adjustments] = await Promise.all([\n    findWithDecryption(em, SalesOrderLine, { order: order.id, deletedAt: null }, {}, scope),\n    findWithDecryption(\n      em,\n      SalesOrderAdjustment,\n      { order: order.id, deletedAt: null },\n      { orderBy: { position: 'asc' } },\n      scope,\n    ),\n  ])\n  const lineSnapshots: SalesLineSnapshot[] = orderLines.map(mapOrderLineEntityToSnapshot)\n  const adjustmentDrafts: SalesAdjustmentDraft[] = adjustments.map(mapOrderAdjustmentToDraft)\n  const salesCalculationService = container.resolve('salesCalculationService') as SalesCalculationService\n  const calculation = await salesCalculationService.calculateDocumentTotals({\n    documentKind: 'order',\n    lines: lineSnapshots,\n    adjustments: adjustmentDrafts,\n    context: buildCalculationContext(order),\n    existingTotals: {\n      paidTotalAmount: toNumeric(order.paidTotalAmount),\n      refundedTotalAmount: toNumeric(order.refundedTotalAmount),\n    },\n  })\n  return calculation.totals\n}\n\nexport async function loadReturnSnapshot(em: EntityManager, id: string): Promise<ReturnSnapshot | null> {\n  const header = await findOneWithDecryption(\n    em,\n    SalesReturn,\n    { id, deletedAt: null },\n    { populate: ['order'] },\n    {},\n  )\n  if (!header || !header.order) return null\n  const orderId = typeof header.order === 'string' ? header.order : header.order.id\n  const lines = await findWithDecryption(\n    em,\n    SalesReturnLine,\n    { salesReturn: header.id, deletedAt: null },\n    { populate: ['orderLine'] },\n    { tenantId: header.tenantId, organizationId: header.organizationId },\n  )\n  const adjustmentIds: string[] = []\n  const adjustments = await findWithDecryption(\n    em,\n    SalesOrderAdjustment,\n    { order: orderId, kind: 'return', deletedAt: null },\n    {},\n    { tenantId: header.tenantId, organizationId: header.organizationId },\n  )\n  adjustments.forEach((adj) => {\n    const meta = adj.metadata as Record<string, unknown> | null | undefined\n    if (meta && meta.returnId === header.id) adjustmentIds.push(adj.id)\n  })\n\n  return {\n    id: header.id,\n    orderId,\n    organizationId: header.organizationId,\n    tenantId: header.tenantId,\n    returnNumber: header.returnNumber,\n    returnedAt: header.returnedAt ? header.returnedAt.toISOString() : null,\n    reason: header.reason ?? null,\n    notes: header.notes ?? null,\n    lines: lines.map((line) => ({\n      id: line.id,\n      orderLineId: typeof line.orderLine === 'string' ? line.orderLine : line.orderLine?.id ?? null,\n      quantityReturned: toNumeric(line.quantityReturned),\n      unitPriceNet: toNumeric(line.unitPriceNet),\n      unitPriceGross: toNumeric(line.unitPriceGross),\n      totalNetAmount: toNumeric(line.totalNetAmount),\n      totalGrossAmount: toNumeric(line.totalGrossAmount),\n    })),\n    adjustmentIds,\n  }\n}\n\nfunction normalizeLinesInput(lines: ReturnCreateInput['lines']): ReturnLineInput[] {\n  const seen = new Set<string>()\n  const result: ReturnLineInput[] = []\n  for (const line of lines) {\n    const orderLineId = line.orderLineId\n    if (!orderLineId || seen.has(orderLineId)) continue\n    const quantity = toNumeric(line.quantity)\n    if (!Number.isFinite(quantity) || quantity <= 0) continue\n    seen.add(orderLineId)\n    result.push({ orderLineId, quantity })\n  }\n  return result\n}\n\nconst createReturnCommand: CommandHandler<ReturnCreateInput, { returnId: string }> = {\n  id: 'sales.returns.create',\n  async execute(rawInput, ctx) {\n    const input = returnCreateSchema.parse(rawInput ?? {})\n    ensureTenantScope(ctx, input.tenantId)\n    ensureOrganizationScope(ctx, input.organizationId)\n\n    const { translate } = await resolveTranslations()\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n\n    const requested = normalizeLinesInput(input.lines)\n    if (!requested.length) {\n      throw new CrudHttpError(400, { error: translate('sales.returns.linesRequired', 'Select at least one line to return.') })\n    }\n\n    const salesCalculationService = ctx.container.resolve<SalesCalculationService>('salesCalculationService')\n    const { header, createdLines } = await em.transactional(async (tx) => {\n      const order = await findOneWithDecryption(\n        tx,\n        SalesOrder,\n        { id: input.orderId, deletedAt: null },\n        {},\n        { tenantId: input.tenantId, organizationId: input.organizationId },\n      )\n      if (!order) {\n        throw new CrudHttpError(404, { error: translate('sales.returns.orderMissing', 'Order not found.') })\n      }\n      ensureSameScope(order, input.organizationId, input.tenantId)\n      enforceSalesDocumentOptimisticLock(ctx, order, SALES_RESOURCE_KIND_ORDER)\n\n      const orderLines = await findWithDecryption(\n        tx,\n        SalesOrderLine,\n        { order: order.id, deletedAt: null },\n        { lockMode: LockMode.PESSIMISTIC_WRITE },\n        { tenantId: input.tenantId, organizationId: input.organizationId },\n      )\n      const lineMap = new Map(orderLines.map((line) => [line.id, line]))\n\n      requested.forEach(({ orderLineId, quantity }) => {\n        const line = lineMap.get(orderLineId)\n        if (!line) {\n          throw new CrudHttpError(404, { error: translate('sales.returns.lineMissing', 'Order line not found.') })\n        }\n        const available = toNumeric(line.quantity) - toNumeric(line.returnedQuantity)\n        if (quantity - 1e-6 > available) {\n          throw new CrudHttpError(400, { error: translate('sales.returns.quantityExceeded', 'Cannot return more than the remaining quantity.') })\n        }\n      })\n\n      const existingAdjustments = await findWithDecryption(\n        tx,\n        SalesOrderAdjustment,\n        { order: order.id, deletedAt: null },\n        { orderBy: { position: 'asc' } },\n        { tenantId: input.tenantId, organizationId: input.organizationId },\n      )\n      const positionStart = existingAdjustments.reduce((acc, adj) => Math.max(acc, adj.position ?? 0), 0) + 1\n\n      const numberGenerator = new SalesDocumentNumberGenerator(tx)\n      const generated = await numberGenerator.generate({\n        kind: 'return',\n        tenantId: input.tenantId,\n        organizationId: input.organizationId,\n      })\n      const returnId = randomUUID()\n      const entity = tx.create(SalesReturn, {\n        id: returnId,\n        order,\n        organizationId: input.organizationId,\n        tenantId: input.tenantId,\n        returnNumber: generated.number,\n        reason: input.reason ?? null,\n        notes: input.notes ?? null,\n        returnedAt: input.returnedAt ?? new Date(),\n        createdAt: new Date(),\n        updatedAt: new Date(),\n      })\n      tx.persist(entity)\n\n      const createdAdjustments: SalesOrderAdjustment[] = []\n      const createdReturnLines: SalesReturnLine[] = []\n      requested.forEach((lineInput, index) => {\n        const line = lineMap.get(lineInput.orderLineId)\n        if (!line) return\n        const quantity = lineInput.quantity\n        const lineQuantity = Math.max(toNumeric(line.quantity), 0)\n        const unitNet = lineQuantity > 0 ? toNumeric(line.totalNetAmount) / lineQuantity : toNumeric(line.unitPriceNet)\n        const unitGross = lineQuantity > 0 ? toNumeric(line.totalGrossAmount) / lineQuantity : toNumeric(line.unitPriceGross)\n        const totalNet = -round(Math.max(unitNet, 0) * quantity)\n        const totalGross = -round(Math.max(unitGross, 0) * quantity)\n\n        const returnLineId = randomUUID()\n        const returnLine = tx.create(SalesReturnLine, {\n          id: returnLineId,\n          salesReturn: entity,\n          orderLine: tx.getReference(SalesOrderLine, line.id),\n          organizationId: input.organizationId,\n          tenantId: input.tenantId,\n          quantityReturned: quantity.toString(),\n          unitPriceNet: round(unitNet).toString(),\n          unitPriceGross: round(unitGross).toString(),\n          totalNetAmount: totalNet.toString(),\n          totalGrossAmount: totalGross.toString(),\n          createdAt: new Date(),\n          updatedAt: new Date(),\n        })\n        createdReturnLines.push(returnLine)\n        tx.persist(returnLine)\n\n        const adjustment = tx.create(SalesOrderAdjustment, {\n          id: randomUUID(),\n          order,\n          orderLine: tx.getReference(SalesOrderLine, line.id),\n          organizationId: input.organizationId,\n          tenantId: input.tenantId,\n          scope: 'line',\n          kind: 'return',\n          rate: '0',\n          amountNet: totalNet.toString(),\n          amountGross: totalGross.toString(),\n          currencyCode: order.currencyCode,\n          metadata: { returnId, returnLineId },\n          position: positionStart + index,\n          createdAt: new Date(),\n          updatedAt: new Date(),\n        })\n        createdAdjustments.push(adjustment)\n        tx.persist(adjustment)\n\n        line.returnedQuantity = (toNumeric(line.returnedQuantity) + quantity).toString()\n        line.updatedAt = new Date()\n        tx.persist(line)\n      })\n\n      const lineSnapshots: SalesLineSnapshot[] = orderLines.map(mapOrderLineEntityToSnapshot)\n      const adjustmentDrafts: SalesAdjustmentDraft[] = [...existingAdjustments, ...createdAdjustments].map(mapOrderAdjustmentToDraft)\n      const calculation = await salesCalculationService.calculateDocumentTotals({\n        documentKind: 'order',\n        lines: lineSnapshots,\n        adjustments: adjustmentDrafts,\n        context: buildCalculationContext(order),\n      })\n      applyOrderTotals(order, calculation.totals, calculation.lines.length)\n      order.updatedAt = new Date()\n      tx.persist(order)\n\n      await tx.flush()\n\n      return { header: entity, createdLines: createdReturnLines }\n    })\n\n    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine\n    await emitCrudSideEffects({\n      dataEngine,\n      action: 'created',\n      entity: header,\n      identifiers: { id: header.id, organizationId: header.organizationId, tenantId: header.tenantId },\n      indexer: { entityType: E.sales.sales_return },\n      events: returnCrudEvents,\n    })\n\n    if (createdLines.length) {\n      await Promise.all(\n        createdLines.map((line) =>\n          emitCrudSideEffects({\n            dataEngine,\n            action: 'created',\n            entity: line,\n            identifiers: { id: line.id, organizationId: line.organizationId, tenantId: line.tenantId },\n            indexer: { entityType: E.sales.sales_return_line },\n          }),\n        ),\n      )\n    }\n\n    return { returnId: header.id }\n  },\n  captureAfter: async (_input, result, ctx) => {\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    return loadReturnSnapshot(em, result.returnId)\n  },\n  buildLog: async ({ result, snapshots }) => {\n    const after = snapshots.after as ReturnSnapshot | undefined\n    if (!after) return null\n    const { translate } = await resolveTranslations()\n    return {\n      actionLabel: translate('sales.audit.returns.create', 'Create return'),\n      resourceKind: 'sales.return',\n      resourceId: result.returnId,\n      parentResourceKind: 'sales.order',\n      parentResourceId: after.orderId ?? null,\n      tenantId: after.tenantId,\n      organizationId: after.organizationId,\n      snapshotAfter: after,\n      payload: {\n        undo: { after } satisfies ReturnUndoPayload,\n      },\n    }\n  },\n  undo: async ({ logEntry, ctx }) => {\n    const payload = extractUndoPayload<ReturnUndoPayload>(logEntry)\n    const after = payload?.after\n    if (!after) return\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    const order = await findOneWithDecryption(\n      em,\n      SalesOrder,\n      { id: after.orderId, deletedAt: null },\n      {},\n      { tenantId: after.tenantId, organizationId: after.organizationId },\n    )\n    if (!order) return\n\n    const salesCalculationService = ctx.container.resolve<SalesCalculationService>('salesCalculationService')\n\n    // Line reversals, adjustment/return removals, and the order-total recompute\n    // interleave queries on the same EntityManager with scalar mutations, so they\n    // must run inside an atomic flush to avoid lost updates and partial commits.\n    let lines: SalesOrderLine[] = []\n    await withAtomicFlush(\n      em,\n      [\n        async () => {\n          lines = await findWithDecryption(\n            em,\n            SalesOrderLine,\n            { order: order.id, deletedAt: null },\n            {},\n            { tenantId: after.tenantId, organizationId: after.organizationId },\n          )\n          const lineMap = new Map(lines.map((line) => [line.id, line]))\n          after.lines.forEach((entry) => {\n            const line = lineMap.get(entry.orderLineId)\n            if (!line) return\n            const next = Math.max(0, toNumeric(line.returnedQuantity) - entry.quantityReturned)\n            line.returnedQuantity = next.toString()\n            line.updatedAt = new Date()\n            em.persist(line)\n          })\n        },\n        // The line returnedQuantity reversals above are persisted by\n        // withAtomicFlush's per-phase flush boundary before the adjustment /\n        // header / return-line lookups below run any query on this\n        // EntityManager. MikroORM v7 would otherwise silently discard the pending\n        // scalar changes on the managed `lines` when the next read resets the\n        // changeset (see SPEC-018).\n        async () => {\n          if (after.adjustmentIds.length) {\n            const adjustments = await findWithDecryption(\n              em,\n              SalesOrderAdjustment,\n              { id: { $in: after.adjustmentIds }, deletedAt: null },\n              {},\n              { tenantId: after.tenantId, organizationId: after.organizationId },\n            )\n            adjustments.forEach((adj) => em.remove(adj))\n          }\n\n          const header = await findOneWithDecryption(\n            em,\n            SalesReturn,\n            { id: after.id, deletedAt: null },\n            {},\n            { tenantId: after.tenantId, organizationId: after.organizationId },\n          )\n          const returnLines = await findWithDecryption(\n            em,\n            SalesReturnLine,\n            { salesReturn: after.id, deletedAt: null },\n            {},\n            { tenantId: after.tenantId, organizationId: after.organizationId },\n          )\n          returnLines.forEach((line) => em.remove(line))\n          if (header) em.remove(header)\n\n          const existingAdjustments = await findWithDecryption(\n            em,\n            SalesOrderAdjustment,\n            { order: order.id, deletedAt: null },\n            { orderBy: { position: 'asc' } },\n            { tenantId: after.tenantId, organizationId: after.organizationId },\n          )\n          const lineSnapshots: SalesLineSnapshot[] = lines.map(mapOrderLineEntityToSnapshot)\n          const adjustmentDrafts: SalesAdjustmentDraft[] = existingAdjustments.map(mapOrderAdjustmentToDraft)\n          const calculation = await salesCalculationService.calculateDocumentTotals({\n            documentKind: 'order',\n            lines: lineSnapshots,\n            adjustments: adjustmentDrafts,\n            context: buildCalculationContext(order),\n          })\n          applyOrderTotals(order, calculation.totals, calculation.lines.length)\n          order.updatedAt = new Date()\n          em.persist(order)\n        },\n      ],\n      { transaction: true },\n    )\n  },\n  redo: async ({ ctx, logEntry }) => {\n    const after = resolveRedoSnapshot<ReturnSnapshot>(logEntry)\n    const returnId = after?.id ?? logEntry.resourceId ?? null\n    if (!after || !returnId) {\n      throw new CrudHttpError(400, { error: '[internal] redo snapshot unavailable for sales.returns.create' })\n    }\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    const salesCalculationService = ctx.container.resolve<SalesCalculationService>('salesCalculationService')\n\n    const createdLines: SalesReturnLine[] = []\n\n    await withAtomicFlush(\n      em,\n      [\n        async () => {\n          const order = await findOneWithDecryption(\n            em,\n            SalesOrder,\n            { id: after.orderId, deletedAt: null },\n            {},\n            { tenantId: after.tenantId, organizationId: after.organizationId },\n          )\n          if (!order) {\n            throw new CrudHttpError(404, { error: 'sales.returns.orderMissing' })\n          }\n          ensureSameScope(order, after.organizationId, after.tenantId)\n\n          const orderLines = await findWithDecryption(\n            em,\n            SalesOrderLine,\n            { order: order.id, deletedAt: null },\n            { lockMode: LockMode.PESSIMISTIC_WRITE },\n            { tenantId: after.tenantId, organizationId: after.organizationId },\n          )\n          const lineMap = new Map(orderLines.map((line) => [line.id, line]))\n\n          const existingAdjustments = await findWithDecryption(\n            em,\n            SalesOrderAdjustment,\n            { order: order.id, deletedAt: null },\n            { orderBy: { position: 'asc' } },\n            { tenantId: after.tenantId, organizationId: after.organizationId },\n          )\n          const positionStart = existingAdjustments.reduce((acc, adj) => Math.max(acc, adj.position ?? 0), 0) + 1\n\n          const restoredHeader =\n            (await findOneWithDecryption(\n              em,\n              SalesReturn,\n              { id: after.id },\n              {},\n              { tenantId: after.tenantId, organizationId: after.organizationId },\n            )) ??\n            em.create(SalesReturn, {\n              id: after.id,\n              order,\n              organizationId: after.organizationId,\n              tenantId: after.tenantId,\n              returnNumber: after.returnNumber,\n              reason: after.reason ?? null,\n              notes: after.notes ?? null,\n              returnedAt: after.returnedAt ? new Date(after.returnedAt) : new Date(),\n              createdAt: new Date(),\n              updatedAt: new Date(),\n            })\n          restoredHeader.order = order\n          restoredHeader.deletedAt = null\n          restoredHeader.organizationId = after.organizationId\n          restoredHeader.tenantId = after.tenantId\n          restoredHeader.returnNumber = after.returnNumber\n          restoredHeader.reason = after.reason ?? null\n          restoredHeader.notes = after.notes ?? null\n          restoredHeader.returnedAt = after.returnedAt ? new Date(after.returnedAt) : new Date()\n          restoredHeader.updatedAt = new Date()\n          em.persist(restoredHeader)\n\n          const createdAdjustments: SalesOrderAdjustment[] = []\n          after.lines.forEach((lineSnapshot, index) => {\n            const line = lineMap.get(lineSnapshot.orderLineId)\n            if (!line) return\n            const totalNet = lineSnapshot.totalNetAmount\n            const totalGross = lineSnapshot.totalGrossAmount\n            const adjustmentId = after.adjustmentIds[index] ?? randomUUID()\n\n            const returnLine = em.create(SalesReturnLine, {\n              id: lineSnapshot.id,\n              salesReturn: restoredHeader,\n              orderLine: em.getReference(SalesOrderLine, line.id),\n              organizationId: after.organizationId,\n              tenantId: after.tenantId,\n              quantityReturned: lineSnapshot.quantityReturned.toString(),\n              unitPriceNet: lineSnapshot.unitPriceNet.toString(),\n              unitPriceGross: lineSnapshot.unitPriceGross.toString(),\n              totalNetAmount: totalNet.toString(),\n              totalGrossAmount: totalGross.toString(),\n              createdAt: new Date(),\n              updatedAt: new Date(),\n            })\n            createdLines.push(returnLine)\n            em.persist(returnLine)\n\n            const adjustment = em.create(SalesOrderAdjustment, {\n              id: adjustmentId,\n              order,\n              orderLine: em.getReference(SalesOrderLine, line.id),\n              organizationId: after.organizationId,\n              tenantId: after.tenantId,\n              scope: 'line',\n              kind: 'return',\n              rate: '0',\n              amountNet: totalNet.toString(),\n              amountGross: totalGross.toString(),\n              currencyCode: order.currencyCode,\n              metadata: { returnId, returnLineId: lineSnapshot.id },\n              position: positionStart + index,\n              createdAt: new Date(),\n              updatedAt: new Date(),\n            })\n            createdAdjustments.push(adjustment)\n            em.persist(adjustment)\n\n            line.returnedQuantity = (toNumeric(line.returnedQuantity) + lineSnapshot.quantityReturned).toString()\n            line.updatedAt = new Date()\n            em.persist(line)\n          })\n\n          const lineSnapshots: SalesLineSnapshot[] = orderLines.map(mapOrderLineEntityToSnapshot)\n          const adjustmentDrafts: SalesAdjustmentDraft[] = [...existingAdjustments, ...createdAdjustments].map(\n            mapOrderAdjustmentToDraft,\n          )\n          const calculation = await salesCalculationService.calculateDocumentTotals({\n            documentKind: 'order',\n            lines: lineSnapshots,\n            adjustments: adjustmentDrafts,\n            context: buildCalculationContext(order),\n          })\n          applyOrderTotals(order, calculation.totals, calculation.lines.length)\n          order.updatedAt = new Date()\n          em.persist(order)\n        },\n      ],\n      { transaction: true },\n    )\n\n    const header = await findOneWithDecryption(\n      em,\n      SalesReturn,\n      { id: after.id, deletedAt: null },\n      {},\n      { tenantId: after.tenantId, organizationId: after.organizationId },\n    )\n    if (!header) {\n      throw new CrudHttpError(404, { error: 'sales.returns.orderMissing' })\n    }\n\n    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine\n    await emitCrudSideEffects({\n      dataEngine,\n      action: 'created',\n      entity: header,\n      identifiers: { id: header.id, organizationId: header.organizationId, tenantId: header.tenantId },\n      indexer: { entityType: E.sales.sales_return },\n      events: returnCrudEvents,\n    })\n\n    if (createdLines.length) {\n      await Promise.all(\n        createdLines.map((line) =>\n          emitCrudSideEffects({\n            dataEngine,\n            action: 'created',\n            entity: line,\n            identifiers: { id: line.id, organizationId: line.organizationId, tenantId: line.tenantId },\n            indexer: { entityType: E.sales.sales_return_line },\n          }),\n        ),\n      )\n    }\n\n    return { returnId: header.id }\n  },\n}\n\nregisterCommand(createReturnCommand)\n\nexport const returnCommands = [createReturnCommand]\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { randomUUID } from 'crypto'\nimport { registerCommand, type CommandHandler } from '@open-mercato/shared/lib/commands'\nimport { withAtomicFlush } from '@open-mercato/shared/lib/commands/flush'\nimport { LockMode } from '@mikro-orm/core'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\nimport { emitCrudSideEffects } from '@open-mercato/shared/lib/commands/helpers'\nimport type { CrudEventsConfig } from '@open-mercato/shared/lib/crud/types'\nimport type { DataEngine } from '@open-mercato/shared/lib/data/engine'\nimport { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { SalesDocumentNumberGenerator } from '../services/salesDocumentNumberGenerator'\nimport type { SalesCalculationService } from '../services/salesCalculationService'\nimport type { SalesAdjustmentDraft, SalesLineSnapshot, SalesDocumentCalculationResult } from '../lib/types'\nimport { cloneJson, ensureOrganizationScope, ensureSameScope, ensureTenantScope, extractUndoPayload, toNumericString, enforceSalesDocumentOptimisticLock, SALES_RESOURCE_KIND_ORDER, SALES_RESOURCE_KIND_RETURN } from './shared'\nimport { resolveRedoSnapshot } from '@open-mercato/shared/lib/commands/redo'\nimport { SalesOrder, SalesOrderAdjustment, SalesOrderLine, SalesReturn, SalesReturnLine } from '../data/entities'\nimport {\n  returnCreateSchema,\n  returnUpdateSchema,\n  returnDeleteSchema,\n  type ReturnCreateInput,\n  type ReturnUpdateInput,\n  type ReturnDeleteInput,\n} from '../data/validators'\nimport { E } from '#generated/entities.ids.generated'\n\ntype ReturnLineInput = { orderLineId: string; quantity: number }\n\ntype ReturnSnapshot = {\n  id: string\n  orderId: string\n  organizationId: string\n  tenantId: string\n  returnNumber: string\n  returnedAt: string | null\n  reason: string | null\n  notes: string | null\n  lines: Array<{\n    id: string\n    orderLineId: string\n    quantityReturned: number\n    unitPriceNet: number\n    unitPriceGross: number\n    totalNetAmount: number\n    totalGrossAmount: number\n  }>\n  adjustmentIds: string[]\n}\n\ntype ReturnUndoPayload = {\n  after?: ReturnSnapshot | null\n}\n\nconst returnCrudEvents: CrudEventsConfig = {\n  module: 'sales',\n  entity: 'return',\n  persistent: true,\n  buildPayload: (ctx) => ({\n    id: ctx.identifiers.id,\n    organizationId: ctx.identifiers.organizationId,\n    tenantId: ctx.identifiers.tenantId,\n  }),\n}\n\nfunction toNumeric(value: unknown): number {\n  if (typeof value === 'number' && Number.isFinite(value)) return value\n  if (typeof value === 'string' && value.trim().length) {\n    const parsed = Number(value)\n    if (Number.isFinite(parsed)) return parsed\n  }\n  return 0\n}\n\nfunction round(value: number): number {\n  return Math.round((value + Number.EPSILON) * 1e4) / 1e4\n}\n\nfunction applyOrderTotals(order: SalesOrder, totals: SalesDocumentCalculationResult['totals'], lineCount: number): void {\n  order.subtotalNetAmount = toNumericString(totals.subtotalNetAmount) ?? '0'\n  order.subtotalGrossAmount = toNumericString(totals.subtotalGrossAmount) ?? '0'\n  order.discountTotalAmount = toNumericString(totals.discountTotalAmount) ?? '0'\n  order.taxTotalAmount = toNumericString(totals.taxTotalAmount) ?? '0'\n  order.shippingNetAmount = toNumericString(totals.shippingNetAmount) ?? '0'\n  order.shippingGrossAmount = toNumericString(totals.shippingGrossAmount) ?? '0'\n  order.surchargeTotalAmount = toNumericString(totals.surchargeTotalAmount) ?? '0'\n  order.grandTotalNetAmount = toNumericString(totals.grandTotalNetAmount) ?? '0'\n  order.grandTotalGrossAmount = toNumericString(totals.grandTotalGrossAmount) ?? '0'\n  order.paidTotalAmount = toNumericString(totals.paidTotalAmount) ?? '0'\n  order.refundedTotalAmount = toNumericString(totals.refundedTotalAmount) ?? '0'\n  order.outstandingAmount = toNumericString(totals.outstandingAmount) ?? '0'\n  order.totalsSnapshot = cloneJson(totals)\n  order.lineItemCount = lineCount\n}\n\nfunction mapOrderLineEntityToSnapshot(line: SalesOrderLine): SalesLineSnapshot {\n  return {\n    id: line.id,\n    lineNumber: line.lineNumber,\n    kind: line.kind,\n    productId: line.productId ?? null,\n    productVariantId: line.productVariantId ?? null,\n    name: line.name ?? null,\n    description: line.description ?? null,\n    comment: line.comment ?? null,\n    quantity: toNumeric(line.quantity),\n    quantityUnit: line.quantityUnit ?? null,\n    normalizedQuantity: toNumeric(line.normalizedQuantity ?? line.quantity),\n    normalizedUnit: line.normalizedUnit ?? line.quantityUnit ?? null,\n    uomSnapshot: line.uomSnapshot ? cloneJson(line.uomSnapshot) : null,\n    currencyCode: line.currencyCode,\n    unitPriceNet: toNumeric(line.unitPriceNet),\n    unitPriceGross: toNumeric(line.unitPriceGross),\n    discountAmount: toNumeric(line.discountAmount),\n    discountPercent: toNumeric(line.discountPercent),\n    taxRate: toNumeric(line.taxRate),\n    taxAmount: toNumeric(line.taxAmount),\n    totalNetAmount: toNumeric(line.totalNetAmount),\n    totalGrossAmount: toNumeric(line.totalGrossAmount),\n    configuration: line.configuration ? cloneJson(line.configuration) : null,\n    promotionCode: line.promotionCode ?? null,\n    metadata: line.metadata ? cloneJson(line.metadata) : null,\n    customFieldSetId: line.customFieldSetId ?? null,\n  }\n}\n\nfunction mapOrderAdjustmentToDraft(adjustment: SalesOrderAdjustment): SalesAdjustmentDraft {\n  return {\n    id: adjustment.id,\n    scope: adjustment.scope ?? 'order',\n    kind: adjustment.kind,\n    code: adjustment.code ?? null,\n    label: adjustment.label ?? null,\n    calculatorKey: adjustment.calculatorKey ?? null,\n    promotionId: adjustment.promotionId ?? null,\n    rate: toNumeric(adjustment.rate),\n    amountNet: toNumeric(adjustment.amountNet),\n    amountGross: toNumeric(adjustment.amountGross),\n    currencyCode: adjustment.currencyCode ?? null,\n    metadata: adjustment.metadata ? cloneJson(adjustment.metadata) : null,\n    position: adjustment.position ?? 0,\n  }\n}\n\nfunction buildCalculationContext(order: SalesOrder) {\n  return {\n    tenantId: order.tenantId,\n    organizationId: order.organizationId,\n    currencyCode: order.currencyCode,\n    metadata: {\n      shippingMethod: order.shippingMethodSnapshot\n        ? cloneJson(order.shippingMethodSnapshot as Record<string, unknown>)\n        : null,\n      paymentMethod: order.paymentMethodSnapshot ? cloneJson(order.paymentMethodSnapshot as Record<string, unknown>) : null,\n    },\n  }\n}\n\n/**\n * Recalculates order totals (including line-scoped return adjustments) for display.\n * Returns the totals object to merge into an order API response, or null if order not found.\n */\nexport async function recalculateOrderTotalsForDisplay(\n  em: EntityManager,\n  container: { resolve: (key: string) => unknown },\n  orderId: string,\n  scope: { tenantId: string; organizationId: string },\n): Promise<SalesDocumentCalculationResult['totals'] | null> {\n  const order = await findOneWithDecryption(\n    em,\n    SalesOrder,\n    { id: orderId, deletedAt: null },\n    {},\n    scope,\n  )\n  if (!order) return null\n  const [orderLines, adjustments] = await Promise.all([\n    findWithDecryption(em, SalesOrderLine, { order: order.id, deletedAt: null }, {}, scope),\n    findWithDecryption(\n      em,\n      SalesOrderAdjustment,\n      { order: order.id, deletedAt: null },\n      { orderBy: { position: 'asc' } },\n      scope,\n    ),\n  ])\n  const lineSnapshots: SalesLineSnapshot[] = orderLines.map(mapOrderLineEntityToSnapshot)\n  const adjustmentDrafts: SalesAdjustmentDraft[] = adjustments.map(mapOrderAdjustmentToDraft)\n  const salesCalculationService = container.resolve('salesCalculationService') as SalesCalculationService\n  const calculation = await salesCalculationService.calculateDocumentTotals({\n    documentKind: 'order',\n    lines: lineSnapshots,\n    adjustments: adjustmentDrafts,\n    context: buildCalculationContext(order),\n    existingTotals: {\n      paidTotalAmount: toNumeric(order.paidTotalAmount),\n      refundedTotalAmount: toNumeric(order.refundedTotalAmount),\n    },\n  })\n  return calculation.totals\n}\n\nexport async function loadReturnSnapshot(em: EntityManager, id: string): Promise<ReturnSnapshot | null> {\n  const header = await findOneWithDecryption(\n    em,\n    SalesReturn,\n    { id, deletedAt: null },\n    { populate: ['order'] },\n    {},\n  )\n  if (!header || !header.order) return null\n  const orderId = typeof header.order === 'string' ? header.order : header.order.id\n  const lines = await findWithDecryption(\n    em,\n    SalesReturnLine,\n    { salesReturn: header.id, deletedAt: null },\n    { populate: ['orderLine'] },\n    { tenantId: header.tenantId, organizationId: header.organizationId },\n  )\n  const adjustmentIds: string[] = []\n  const adjustments = await findWithDecryption(\n    em,\n    SalesOrderAdjustment,\n    { order: orderId, kind: 'return', deletedAt: null },\n    {},\n    { tenantId: header.tenantId, organizationId: header.organizationId },\n  )\n  adjustments.forEach((adj) => {\n    const meta = adj.metadata as Record<string, unknown> | null | undefined\n    if (meta && meta.returnId === header.id) adjustmentIds.push(adj.id)\n  })\n\n  return {\n    id: header.id,\n    orderId,\n    organizationId: header.organizationId,\n    tenantId: header.tenantId,\n    returnNumber: header.returnNumber,\n    returnedAt: header.returnedAt ? header.returnedAt.toISOString() : null,\n    reason: header.reason ?? null,\n    notes: header.notes ?? null,\n    lines: lines.map((line) => ({\n      id: line.id,\n      orderLineId: typeof line.orderLine === 'string' ? line.orderLine : line.orderLine?.id ?? null,\n      quantityReturned: toNumeric(line.quantityReturned),\n      unitPriceNet: toNumeric(line.unitPriceNet),\n      unitPriceGross: toNumeric(line.unitPriceGross),\n      totalNetAmount: toNumeric(line.totalNetAmount),\n      totalGrossAmount: toNumeric(line.totalGrossAmount),\n    })),\n    adjustmentIds,\n  }\n}\n\ntype ReturnHeaderSnapshot = {\n  id: string\n  orderId: string\n  organizationId: string\n  tenantId: string\n  reason: string | null\n  notes: string | null\n  returnedAt: string | null\n}\n\ntype ReturnHeaderUndoPayload = {\n  before?: ReturnHeaderSnapshot | null\n  after?: ReturnHeaderSnapshot | null\n}\n\ntype ReturnDeleteUndoPayload = {\n  before?: ReturnSnapshot | null\n}\n\nasync function loadReturnHeaderSnapshot(em: EntityManager, id: string): Promise<ReturnHeaderSnapshot | null> {\n  const header = await findOneWithDecryption(em, SalesReturn, { id, deletedAt: null }, { populate: ['order'] }, {})\n  if (!header || !header.order) return null\n  const orderId = typeof header.order === 'string' ? header.order : header.order.id\n  return {\n    id: header.id,\n    orderId,\n    organizationId: header.organizationId,\n    tenantId: header.tenantId,\n    reason: header.reason ?? null,\n    notes: header.notes ?? null,\n    returnedAt: header.returnedAt ? header.returnedAt.toISOString() : null,\n  }\n}\n\n/**\n * Reverse the order-level effects of a return: restore each order line's\n * `returnedQuantity`, drop the return's line-scoped credit adjustments, remove\n * the return header + lines, and recalculate the order totals. Shared by the\n * create command's undo and the delete command's execute \u2014 both need the exact\n * same teardown. No-op when the order is gone.\n *\n * The line reversals, adjustment/return removals, and the order-total recompute\n * interleave queries on the same EntityManager with scalar mutations, so they\n * run inside an atomic flush to avoid lost updates and partial commits\n * (SPEC-018): the per-phase flush boundary persists the line `returnedQuantity`\n * reversals before the adjustment/header/return-line lookups in the next phase\n * run any query, which under MikroORM v7 would otherwise silently discard the\n * pending scalar changes on the managed lines.\n */\nasync function reverseReturnEffects(\n  em: EntityManager,\n  salesCalculationService: SalesCalculationService,\n  snapshot: ReturnSnapshot,\n): Promise<void> {\n  const order = await findOneWithDecryption(\n    em,\n    SalesOrder,\n    { id: snapshot.orderId, deletedAt: null },\n    {},\n    { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n  )\n  if (!order) return\n\n  let lines: SalesOrderLine[] = []\n  await withAtomicFlush(\n    em,\n    [\n      async () => {\n        lines = await findWithDecryption(\n          em,\n          SalesOrderLine,\n          { order: order.id, deletedAt: null },\n          {},\n          { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n        )\n        const lineMap = new Map(lines.map((line) => [line.id, line]))\n        snapshot.lines.forEach((entry) => {\n          const line = lineMap.get(entry.orderLineId)\n          if (!line) return\n          const next = Math.max(0, toNumeric(line.returnedQuantity) - entry.quantityReturned)\n          line.returnedQuantity = next.toString()\n          line.updatedAt = new Date()\n          em.persist(line)\n        })\n      },\n      async () => {\n        if (snapshot.adjustmentIds.length) {\n          const adjustments = await findWithDecryption(\n            em,\n            SalesOrderAdjustment,\n            { id: { $in: snapshot.adjustmentIds }, deletedAt: null },\n            {},\n            { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n          )\n          adjustments.forEach((adj) => em.remove(adj))\n        }\n\n        const header = await findOneWithDecryption(\n          em,\n          SalesReturn,\n          { id: snapshot.id, deletedAt: null },\n          {},\n          { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n        )\n        const returnLines = await findWithDecryption(\n          em,\n          SalesReturnLine,\n          { salesReturn: snapshot.id, deletedAt: null },\n          {},\n          { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n        )\n        returnLines.forEach((line) => em.remove(line))\n        if (header) em.remove(header)\n\n        const existingAdjustments = await findWithDecryption(\n          em,\n          SalesOrderAdjustment,\n          { order: order.id, deletedAt: null },\n          { orderBy: { position: 'asc' } },\n          { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n        )\n        const lineSnapshots: SalesLineSnapshot[] = lines.map(mapOrderLineEntityToSnapshot)\n        const adjustmentDrafts: SalesAdjustmentDraft[] = existingAdjustments.map(mapOrderAdjustmentToDraft)\n        const calculation = await salesCalculationService.calculateDocumentTotals({\n          documentKind: 'order',\n          lines: lineSnapshots,\n          adjustments: adjustmentDrafts,\n          context: buildCalculationContext(order),\n        })\n        applyOrderTotals(order, calculation.totals, calculation.lines.length)\n        order.updatedAt = new Date()\n        em.persist(order)\n      },\n    ],\n    { transaction: true },\n  )\n}\n\n/**\n * Re-apply a return from a snapshot: recreate the return header + lines and the\n * line-scoped credit adjustments, bump each order line's `returnedQuantity`, and\n * recalculate the order totals. Shared by the create command's redo and the\n * delete command's undo. Returns the recreated return lines so callers can emit\n * index side effects. Throws a 404 when the order is gone.\n */\nasync function restoreReturnEffects(\n  em: EntityManager,\n  salesCalculationService: SalesCalculationService,\n  snapshot: ReturnSnapshot,\n): Promise<SalesReturnLine[]> {\n  const returnId = snapshot.id\n  const createdLines: SalesReturnLine[] = []\n\n  await withAtomicFlush(\n    em,\n    [\n      async () => {\n        const order = await findOneWithDecryption(\n          em,\n          SalesOrder,\n          { id: snapshot.orderId, deletedAt: null },\n          {},\n          { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n        )\n        if (!order) {\n          throw new CrudHttpError(404, { error: 'sales.returns.orderMissing' })\n        }\n        ensureSameScope(order, snapshot.organizationId, snapshot.tenantId)\n\n        const orderLines = await findWithDecryption(\n          em,\n          SalesOrderLine,\n          { order: order.id, deletedAt: null },\n          { lockMode: LockMode.PESSIMISTIC_WRITE },\n          { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n        )\n        const lineMap = new Map(orderLines.map((line) => [line.id, line]))\n\n        const existingAdjustments = await findWithDecryption(\n          em,\n          SalesOrderAdjustment,\n          { order: order.id, deletedAt: null },\n          { orderBy: { position: 'asc' } },\n          { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n        )\n        const positionStart = existingAdjustments.reduce((acc, adj) => Math.max(acc, adj.position ?? 0), 0) + 1\n\n        const restoredHeader =\n          (await findOneWithDecryption(\n            em,\n            SalesReturn,\n            { id: snapshot.id },\n            {},\n            { tenantId: snapshot.tenantId, organizationId: snapshot.organizationId },\n          )) ??\n          em.create(SalesReturn, {\n            id: snapshot.id,\n            order,\n            organizationId: snapshot.organizationId,\n            tenantId: snapshot.tenantId,\n            returnNumber: snapshot.returnNumber,\n            reason: snapshot.reason ?? null,\n            notes: snapshot.notes ?? null,\n            returnedAt: snapshot.returnedAt ? new Date(snapshot.returnedAt) : new Date(),\n            createdAt: new Date(),\n            updatedAt: new Date(),\n          })\n        restoredHeader.order = order\n        restoredHeader.deletedAt = null\n        restoredHeader.organizationId = snapshot.organizationId\n        restoredHeader.tenantId = snapshot.tenantId\n        restoredHeader.returnNumber = snapshot.returnNumber\n        restoredHeader.reason = snapshot.reason ?? null\n        restoredHeader.notes = snapshot.notes ?? null\n        restoredHeader.returnedAt = snapshot.returnedAt ? new Date(snapshot.returnedAt) : new Date()\n        restoredHeader.updatedAt = new Date()\n        em.persist(restoredHeader)\n\n        const createdAdjustments: SalesOrderAdjustment[] = []\n        snapshot.lines.forEach((lineSnapshot, index) => {\n          const line = lineMap.get(lineSnapshot.orderLineId)\n          if (!line) return\n          const totalNet = lineSnapshot.totalNetAmount\n          const totalGross = lineSnapshot.totalGrossAmount\n          const adjustmentId = snapshot.adjustmentIds[index] ?? randomUUID()\n\n          const returnLine = em.create(SalesReturnLine, {\n            id: lineSnapshot.id,\n            salesReturn: restoredHeader,\n            orderLine: em.getReference(SalesOrderLine, line.id),\n            organizationId: snapshot.organizationId,\n            tenantId: snapshot.tenantId,\n            quantityReturned: lineSnapshot.quantityReturned.toString(),\n            unitPriceNet: lineSnapshot.unitPriceNet.toString(),\n            unitPriceGross: lineSnapshot.unitPriceGross.toString(),\n            totalNetAmount: totalNet.toString(),\n            totalGrossAmount: totalGross.toString(),\n            createdAt: new Date(),\n            updatedAt: new Date(),\n          })\n          createdLines.push(returnLine)\n          em.persist(returnLine)\n\n          const adjustment = em.create(SalesOrderAdjustment, {\n            id: adjustmentId,\n            order,\n            orderLine: em.getReference(SalesOrderLine, line.id),\n            organizationId: snapshot.organizationId,\n            tenantId: snapshot.tenantId,\n            scope: 'line',\n            kind: 'return',\n            rate: '0',\n            amountNet: totalNet.toString(),\n            amountGross: totalGross.toString(),\n            currencyCode: order.currencyCode,\n            metadata: { returnId, returnLineId: lineSnapshot.id },\n            position: positionStart + index,\n            createdAt: new Date(),\n            updatedAt: new Date(),\n          })\n          createdAdjustments.push(adjustment)\n          em.persist(adjustment)\n\n          line.returnedQuantity = (toNumeric(line.returnedQuantity) + lineSnapshot.quantityReturned).toString()\n          line.updatedAt = new Date()\n          em.persist(line)\n        })\n\n        const lineSnapshots: SalesLineSnapshot[] = orderLines.map(mapOrderLineEntityToSnapshot)\n        const adjustmentDrafts: SalesAdjustmentDraft[] = [...existingAdjustments, ...createdAdjustments].map(\n          mapOrderAdjustmentToDraft,\n        )\n        const calculation = await salesCalculationService.calculateDocumentTotals({\n          documentKind: 'order',\n          lines: lineSnapshots,\n          adjustments: adjustmentDrafts,\n          context: buildCalculationContext(order),\n        })\n        applyOrderTotals(order, calculation.totals, calculation.lines.length)\n        order.updatedAt = new Date()\n        em.persist(order)\n      },\n    ],\n    { transaction: true },\n  )\n\n  return createdLines\n}\n\nfunction normalizeLinesInput(lines: ReturnCreateInput['lines']): ReturnLineInput[] {\n  const seen = new Set<string>()\n  const result: ReturnLineInput[] = []\n  for (const line of lines) {\n    const orderLineId = line.orderLineId\n    if (!orderLineId || seen.has(orderLineId)) continue\n    const quantity = toNumeric(line.quantity)\n    if (!Number.isFinite(quantity) || quantity <= 0) continue\n    seen.add(orderLineId)\n    result.push({ orderLineId, quantity })\n  }\n  return result\n}\n\nconst createReturnCommand: CommandHandler<ReturnCreateInput, { returnId: string }> = {\n  id: 'sales.returns.create',\n  async execute(rawInput, ctx) {\n    const input = returnCreateSchema.parse(rawInput ?? {})\n    ensureTenantScope(ctx, input.tenantId)\n    ensureOrganizationScope(ctx, input.organizationId)\n\n    const { translate } = await resolveTranslations()\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n\n    const requested = normalizeLinesInput(input.lines)\n    if (!requested.length) {\n      throw new CrudHttpError(400, { error: translate('sales.returns.linesRequired', 'Select at least one line to return.') })\n    }\n\n    const salesCalculationService = ctx.container.resolve<SalesCalculationService>('salesCalculationService')\n    const { header, createdLines } = await em.transactional(async (tx) => {\n      const order = await findOneWithDecryption(\n        tx,\n        SalesOrder,\n        { id: input.orderId, deletedAt: null },\n        {},\n        { tenantId: input.tenantId, organizationId: input.organizationId },\n      )\n      if (!order) {\n        throw new CrudHttpError(404, { error: translate('sales.returns.orderMissing', 'Order not found.') })\n      }\n      ensureSameScope(order, input.organizationId, input.tenantId)\n      enforceSalesDocumentOptimisticLock(ctx, order, SALES_RESOURCE_KIND_ORDER)\n\n      const orderLines = await findWithDecryption(\n        tx,\n        SalesOrderLine,\n        { order: order.id, deletedAt: null },\n        { lockMode: LockMode.PESSIMISTIC_WRITE },\n        { tenantId: input.tenantId, organizationId: input.organizationId },\n      )\n      const lineMap = new Map(orderLines.map((line) => [line.id, line]))\n\n      requested.forEach(({ orderLineId, quantity }) => {\n        const line = lineMap.get(orderLineId)\n        if (!line) {\n          throw new CrudHttpError(404, { error: translate('sales.returns.lineMissing', 'Order line not found.') })\n        }\n        const available = toNumeric(line.quantity) - toNumeric(line.returnedQuantity)\n        if (quantity - 1e-6 > available) {\n          throw new CrudHttpError(400, { error: translate('sales.returns.quantityExceeded', 'Cannot return more than the remaining quantity.') })\n        }\n      })\n\n      const existingAdjustments = await findWithDecryption(\n        tx,\n        SalesOrderAdjustment,\n        { order: order.id, deletedAt: null },\n        { orderBy: { position: 'asc' } },\n        { tenantId: input.tenantId, organizationId: input.organizationId },\n      )\n      const positionStart = existingAdjustments.reduce((acc, adj) => Math.max(acc, adj.position ?? 0), 0) + 1\n\n      const numberGenerator = new SalesDocumentNumberGenerator(tx)\n      const generated = await numberGenerator.generate({\n        kind: 'return',\n        tenantId: input.tenantId,\n        organizationId: input.organizationId,\n      })\n      const returnId = randomUUID()\n      const entity = tx.create(SalesReturn, {\n        id: returnId,\n        order,\n        organizationId: input.organizationId,\n        tenantId: input.tenantId,\n        returnNumber: generated.number,\n        reason: input.reason ?? null,\n        notes: input.notes ?? null,\n        returnedAt: input.returnedAt ?? new Date(),\n        createdAt: new Date(),\n        updatedAt: new Date(),\n      })\n      tx.persist(entity)\n\n      const createdAdjustments: SalesOrderAdjustment[] = []\n      const createdReturnLines: SalesReturnLine[] = []\n      requested.forEach((lineInput, index) => {\n        const line = lineMap.get(lineInput.orderLineId)\n        if (!line) return\n        const quantity = lineInput.quantity\n        const lineQuantity = Math.max(toNumeric(line.quantity), 0)\n        const unitNet = lineQuantity > 0 ? toNumeric(line.totalNetAmount) / lineQuantity : toNumeric(line.unitPriceNet)\n        const unitGross = lineQuantity > 0 ? toNumeric(line.totalGrossAmount) / lineQuantity : toNumeric(line.unitPriceGross)\n        const totalNet = -round(Math.max(unitNet, 0) * quantity)\n        const totalGross = -round(Math.max(unitGross, 0) * quantity)\n\n        const returnLineId = randomUUID()\n        const returnLine = tx.create(SalesReturnLine, {\n          id: returnLineId,\n          salesReturn: entity,\n          orderLine: tx.getReference(SalesOrderLine, line.id),\n          organizationId: input.organizationId,\n          tenantId: input.tenantId,\n          quantityReturned: quantity.toString(),\n          unitPriceNet: round(unitNet).toString(),\n          unitPriceGross: round(unitGross).toString(),\n          totalNetAmount: totalNet.toString(),\n          totalGrossAmount: totalGross.toString(),\n          createdAt: new Date(),\n          updatedAt: new Date(),\n        })\n        createdReturnLines.push(returnLine)\n        tx.persist(returnLine)\n\n        const adjustment = tx.create(SalesOrderAdjustment, {\n          id: randomUUID(),\n          order,\n          orderLine: tx.getReference(SalesOrderLine, line.id),\n          organizationId: input.organizationId,\n          tenantId: input.tenantId,\n          scope: 'line',\n          kind: 'return',\n          rate: '0',\n          amountNet: totalNet.toString(),\n          amountGross: totalGross.toString(),\n          currencyCode: order.currencyCode,\n          metadata: { returnId, returnLineId },\n          position: positionStart + index,\n          createdAt: new Date(),\n          updatedAt: new Date(),\n        })\n        createdAdjustments.push(adjustment)\n        tx.persist(adjustment)\n\n        line.returnedQuantity = (toNumeric(line.returnedQuantity) + quantity).toString()\n        line.updatedAt = new Date()\n        tx.persist(line)\n      })\n\n      const lineSnapshots: SalesLineSnapshot[] = orderLines.map(mapOrderLineEntityToSnapshot)\n      const adjustmentDrafts: SalesAdjustmentDraft[] = [...existingAdjustments, ...createdAdjustments].map(mapOrderAdjustmentToDraft)\n      const calculation = await salesCalculationService.calculateDocumentTotals({\n        documentKind: 'order',\n        lines: lineSnapshots,\n        adjustments: adjustmentDrafts,\n        context: buildCalculationContext(order),\n      })\n      applyOrderTotals(order, calculation.totals, calculation.lines.length)\n      order.updatedAt = new Date()\n      tx.persist(order)\n\n      await tx.flush()\n\n      return { header: entity, createdLines: createdReturnLines }\n    })\n\n    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine\n    await emitCrudSideEffects({\n      dataEngine,\n      action: 'created',\n      entity: header,\n      identifiers: { id: header.id, organizationId: header.organizationId, tenantId: header.tenantId },\n      indexer: { entityType: E.sales.sales_return },\n      events: returnCrudEvents,\n    })\n\n    if (createdLines.length) {\n      await Promise.all(\n        createdLines.map((line) =>\n          emitCrudSideEffects({\n            dataEngine,\n            action: 'created',\n            entity: line,\n            identifiers: { id: line.id, organizationId: line.organizationId, tenantId: line.tenantId },\n            indexer: { entityType: E.sales.sales_return_line },\n          }),\n        ),\n      )\n    }\n\n    return { returnId: header.id }\n  },\n  captureAfter: async (_input, result, ctx) => {\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    return loadReturnSnapshot(em, result.returnId)\n  },\n  buildLog: async ({ result, snapshots }) => {\n    const after = snapshots.after as ReturnSnapshot | undefined\n    if (!after) return null\n    const { translate } = await resolveTranslations()\n    return {\n      actionLabel: translate('sales.audit.returns.create', 'Create return'),\n      resourceKind: 'sales.return',\n      resourceId: result.returnId,\n      parentResourceKind: 'sales.order',\n      parentResourceId: after.orderId ?? null,\n      tenantId: after.tenantId,\n      organizationId: after.organizationId,\n      snapshotAfter: after,\n      payload: {\n        undo: { after } satisfies ReturnUndoPayload,\n      },\n    }\n  },\n  undo: async ({ logEntry, ctx }) => {\n    const payload = extractUndoPayload<ReturnUndoPayload>(logEntry)\n    const after = payload?.after\n    if (!after) return\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    const salesCalculationService = ctx.container.resolve<SalesCalculationService>('salesCalculationService')\n    await reverseReturnEffects(em, salesCalculationService, after)\n  },\n  redo: async ({ ctx, logEntry }) => {\n    const after = resolveRedoSnapshot<ReturnSnapshot>(logEntry)\n    if (!after || !after.id) {\n      throw new CrudHttpError(400, { error: '[internal] redo snapshot unavailable for sales.returns.create' })\n    }\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    const salesCalculationService = ctx.container.resolve<SalesCalculationService>('salesCalculationService')\n\n    const createdLines = await restoreReturnEffects(em, salesCalculationService, after)\n\n    const header = await findOneWithDecryption(\n      em,\n      SalesReturn,\n      { id: after.id, deletedAt: null },\n      {},\n      { tenantId: after.tenantId, organizationId: after.organizationId },\n    )\n    if (!header) {\n      throw new CrudHttpError(404, { error: 'sales.returns.orderMissing' })\n    }\n\n    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine\n    await emitCrudSideEffects({\n      dataEngine,\n      action: 'created',\n      entity: header,\n      identifiers: { id: header.id, organizationId: header.organizationId, tenantId: header.tenantId },\n      indexer: { entityType: E.sales.sales_return },\n      events: returnCrudEvents,\n    })\n\n    if (createdLines.length) {\n      await Promise.all(\n        createdLines.map((line) =>\n          emitCrudSideEffects({\n            dataEngine,\n            action: 'created',\n            entity: line,\n            identifiers: { id: line.id, organizationId: line.organizationId, tenantId: line.tenantId },\n            indexer: { entityType: E.sales.sales_return_line },\n          }),\n        ),\n      )\n    }\n\n    return { returnId: header.id }\n  },\n}\n\nconst updateReturnCommand: CommandHandler<ReturnUpdateInput, { returnId: string }> = {\n  id: 'sales.returns.update',\n  async prepare(rawInput, ctx) {\n    const parsed = returnUpdateSchema.parse(rawInput ?? {})\n    const em = ctx.container.resolve('em') as EntityManager\n    const snapshot = await loadReturnHeaderSnapshot(em, parsed.id)\n    if (snapshot) {\n      ensureTenantScope(ctx, snapshot.tenantId)\n      ensureOrganizationScope(ctx, snapshot.organizationId)\n    }\n    return snapshot ? { before: snapshot } : {}\n  },\n  async execute(rawInput, ctx) {\n    const input = returnUpdateSchema.parse(rawInput ?? {})\n    ensureTenantScope(ctx, input.tenantId)\n    ensureOrganizationScope(ctx, input.organizationId)\n    const { translate } = await resolveTranslations()\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n\n    const header = await em.transactional(async (tx) => {\n      const entity = await findOneWithDecryption(\n        tx,\n        SalesReturn,\n        { id: input.id, deletedAt: null },\n        { populate: ['order'] },\n        { tenantId: input.tenantId, organizationId: input.organizationId },\n      )\n      if (!entity || !entity.order) {\n        throw new CrudHttpError(404, { error: translate('sales.returns.notFound', 'Return not found.') })\n      }\n      ensureSameScope(entity, input.organizationId, input.tenantId)\n      const orderId = typeof entity.order === 'string' ? entity.order : entity.order.id\n      if (input.orderId !== orderId) {\n        throw new CrudHttpError(400, { error: translate('sales.returns.orderMismatch', 'Return does not belong to this order.') })\n      }\n      // Lock on the return's own version \u2014 editing header fields (reason / notes /\n      // returnedAt) only touches the return, not the order totals.\n      enforceSalesDocumentOptimisticLock(ctx, entity, SALES_RESOURCE_KIND_RETURN)\n\n      if (input.reason !== undefined) entity.reason = input.reason.length ? input.reason : null\n      if (input.notes !== undefined) entity.notes = input.notes.length ? input.notes : null\n      if (input.returnedAt !== undefined) entity.returnedAt = input.returnedAt ?? null\n      entity.updatedAt = new Date()\n      tx.persist(entity)\n      await tx.flush()\n      return entity\n    })\n\n    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine\n    await emitCrudSideEffects({\n      dataEngine,\n      action: 'updated',\n      entity: header,\n      identifiers: { id: header.id, organizationId: header.organizationId, tenantId: header.tenantId },\n      indexer: { entityType: E.sales.sales_return },\n      events: returnCrudEvents,\n    })\n\n    return { returnId: header.id }\n  },\n  captureAfter: async (_input, result, ctx) => {\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    return loadReturnHeaderSnapshot(em, result.returnId)\n  },\n  buildLog: async ({ snapshots, result }) => {\n    const { translate } = await resolveTranslations()\n    const before = snapshots.before as ReturnHeaderSnapshot | undefined\n    const after = snapshots.after as ReturnHeaderSnapshot | undefined\n    return {\n      actionLabel: translate('sales.audit.returns.update', 'Update return'),\n      resourceKind: 'sales.return',\n      resourceId: result.returnId,\n      parentResourceKind: 'sales.order',\n      parentResourceId: after?.orderId ?? before?.orderId ?? null,\n      tenantId: after?.tenantId ?? before?.tenantId ?? null,\n      organizationId: after?.organizationId ?? before?.organizationId ?? null,\n      snapshotBefore: before ?? null,\n      snapshotAfter: after ?? null,\n      payload: {\n        undo: { before, after } satisfies ReturnHeaderUndoPayload,\n      },\n    }\n  },\n  undo: async ({ logEntry, ctx }) => {\n    const payload = extractUndoPayload<ReturnHeaderUndoPayload>(logEntry)\n    const before = payload?.before\n    if (!before) return\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    await em.transactional(async (tx) => {\n      const entity = await findOneWithDecryption(\n        tx,\n        SalesReturn,\n        { id: before.id, deletedAt: null },\n        {},\n        { tenantId: before.tenantId, organizationId: before.organizationId },\n      )\n      if (!entity) return\n      entity.reason = before.reason\n      entity.notes = before.notes\n      entity.returnedAt = before.returnedAt ? new Date(before.returnedAt) : null\n      entity.updatedAt = new Date()\n      tx.persist(entity)\n      await tx.flush()\n    })\n\n    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine\n    const restored = await findOneWithDecryption(\n      em,\n      SalesReturn,\n      { id: before.id, deletedAt: null },\n      {},\n      { tenantId: before.tenantId, organizationId: before.organizationId },\n    )\n    if (restored) {\n      await emitCrudSideEffects({\n        dataEngine,\n        action: 'updated',\n        entity: restored,\n        identifiers: { id: restored.id, organizationId: restored.organizationId, tenantId: restored.tenantId },\n        indexer: { entityType: E.sales.sales_return },\n        events: returnCrudEvents,\n      })\n    }\n  },\n}\n\nconst deleteReturnCommand: CommandHandler<ReturnDeleteInput, { returnId: string }> = {\n  id: 'sales.returns.delete',\n  async prepare(rawInput, ctx) {\n    const parsed = returnDeleteSchema.parse(rawInput ?? {})\n    const em = ctx.container.resolve('em') as EntityManager\n    const snapshot = await loadReturnSnapshot(em, parsed.id)\n    if (snapshot) {\n      ensureTenantScope(ctx, snapshot.tenantId)\n      ensureOrganizationScope(ctx, snapshot.organizationId)\n    }\n    return snapshot ? { before: snapshot } : {}\n  },\n  async execute(rawInput, ctx) {\n    const input = returnDeleteSchema.parse(rawInput ?? {})\n    ensureTenantScope(ctx, input.tenantId)\n    ensureOrganizationScope(ctx, input.organizationId)\n    const { translate } = await resolveTranslations()\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    const salesCalculationService = ctx.container.resolve<SalesCalculationService>('salesCalculationService')\n\n    const snapshot = await loadReturnSnapshot(em, input.id)\n    if (!snapshot) {\n      throw new CrudHttpError(404, { error: translate('sales.returns.notFound', 'Return not found.') })\n    }\n    ensureSameScope(snapshot, input.organizationId, input.tenantId)\n    if (input.orderId !== snapshot.orderId) {\n      throw new CrudHttpError(400, { error: translate('sales.returns.orderMismatch', 'Return does not belong to this order.') })\n    }\n\n    const header = await findOneWithDecryption(\n      em,\n      SalesReturn,\n      { id: input.id, deletedAt: null },\n      {},\n      { tenantId: input.tenantId, organizationId: input.organizationId },\n    )\n    if (!header) {\n      throw new CrudHttpError(404, { error: translate('sales.returns.notFound', 'Return not found.') })\n    }\n    ensureSameScope(header, input.organizationId, input.tenantId)\n    // Lock on the return's own version, captured before any mutation.\n    enforceSalesDocumentOptimisticLock(ctx, header, SALES_RESOURCE_KIND_RETURN)\n\n    await reverseReturnEffects(em, salesCalculationService, snapshot)\n\n    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine\n    await emitCrudSideEffects({\n      dataEngine,\n      action: 'deleted',\n      entity: header,\n      identifiers: { id: snapshot.id, organizationId: snapshot.organizationId, tenantId: snapshot.tenantId },\n      indexer: { entityType: E.sales.sales_return },\n      events: returnCrudEvents,\n    })\n\n    if (snapshot.lines.length) {\n      await Promise.all(\n        snapshot.lines.map((line) =>\n          emitCrudSideEffects({\n            dataEngine,\n            action: 'deleted',\n            entity: { id: line.id, organizationId: snapshot.organizationId, tenantId: snapshot.tenantId },\n            identifiers: { id: line.id, organizationId: snapshot.organizationId, tenantId: snapshot.tenantId },\n            indexer: { entityType: E.sales.sales_return_line },\n          }),\n        ),\n      )\n    }\n\n    return { returnId: snapshot.id }\n  },\n  buildLog: async ({ snapshots, result }) => {\n    const before = snapshots.before as ReturnSnapshot | undefined\n    if (!before) return null\n    const { translate } = await resolveTranslations()\n    return {\n      actionLabel: translate('sales.audit.returns.delete', 'Delete return'),\n      resourceKind: 'sales.return',\n      resourceId: result.returnId,\n      parentResourceKind: 'sales.order',\n      parentResourceId: before.orderId ?? null,\n      tenantId: before.tenantId,\n      organizationId: before.organizationId,\n      snapshotBefore: before,\n      payload: {\n        undo: { before } satisfies ReturnDeleteUndoPayload,\n      },\n    }\n  },\n  undo: async ({ logEntry, ctx }) => {\n    const payload = extractUndoPayload<ReturnDeleteUndoPayload>(logEntry)\n    const before = payload?.before\n    if (!before) return\n    const em = (ctx.container.resolve('em') as EntityManager).fork()\n    const salesCalculationService = ctx.container.resolve<SalesCalculationService>('salesCalculationService')\n\n    const createdLines = await restoreReturnEffects(em, salesCalculationService, before)\n\n    const header = await findOneWithDecryption(\n      em,\n      SalesReturn,\n      { id: before.id, deletedAt: null },\n      {},\n      { tenantId: before.tenantId, organizationId: before.organizationId },\n    )\n    if (!header) return\n\n    const dataEngine = ctx.container.resolve('dataEngine') as DataEngine\n    await emitCrudSideEffects({\n      dataEngine,\n      action: 'created',\n      entity: header,\n      identifiers: { id: header.id, organizationId: header.organizationId, tenantId: header.tenantId },\n      indexer: { entityType: E.sales.sales_return },\n      events: returnCrudEvents,\n    })\n\n    if (createdLines.length) {\n      await Promise.all(\n        createdLines.map((line) =>\n          emitCrudSideEffects({\n            dataEngine,\n            action: 'created',\n            entity: line,\n            identifiers: { id: line.id, organizationId: line.organizationId, tenantId: line.tenantId },\n            indexer: { entityType: E.sales.sales_return_line },\n          }),\n        ),\n      )\n    }\n  },\n}\n\nregisterCommand(createReturnCommand)\nregisterCommand(updateReturnCommand)\nregisterCommand(deleteReturnCommand)\n\nexport const returnCommands = [createReturnCommand, updateReturnCommand, deleteReturnCommand]\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/sales/commands/shared.js

@@ -6,6 +6,7 @@ import { ensureOrganizationScope, ensureSameScope, ensureTenantScope } from "@op
 import { extractUndoPayload } from "@open-mercato/shared/lib/commands/undo";
 const SALES_RESOURCE_KIND_ORDER = "sales.order";
 const SALES_RESOURCE_KIND_QUOTE = "sales.quote";
+const SALES_RESOURCE_KIND_RETURN = "sales.return";
 function enforceSalesDocumentOptimisticLock(ctx, document, resourceKind) {
   if (!document) return;
   enforceCommandOptimisticLock({
@@ -34,6 +35,7 @@ async function requireScopedEntity(em, entityClass, id, message, scope = { organ
 export {
   SALES_RESOURCE_KIND_ORDER,
   SALES_RESOURCE_KIND_QUOTE,
+  SALES_RESOURCE_KIND_RETURN,
   assertFound,
   cloneJson,
   enforceSalesDocumentOptimisticLock,

package/dist/modules/sales/commands/shared.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/sales/commands/shared.ts"],
-  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport type { CommandRuntimeContext } from '@open-mercato/shared/lib/commands'\nimport { enforceCommandOptimisticLock } from '@open-mercato/shared/lib/crud/optimistic-lock-command'\nexport { assertFound } from '@open-mercato/shared/lib/crud/errors'\nexport { ensureOrganizationScope, ensureSameScope, ensureTenantScope } from '@open-mercato/shared/lib/commands/scope'\nexport { extractUndoPayload } from '@open-mercato/shared/lib/commands/undo'\n\n/** Resource kinds used by the document-aggregate optimistic-lock check. */\nexport const SALES_RESOURCE_KIND_ORDER = 'sales.order'\nexport const SALES_RESOURCE_KIND_QUOTE = 'sales.quote'\n\n/**\n * Enforce the document-aggregate OSS optimistic lock for a sales sub-resource\n * command (lines, adjustments, shipments, payments, returns, quote\n * conversion). The client sends the parent order/quote's expected `updated_at`\n * via the optimistic-lock extension header; this compares it against the\n * already-loaded document and throws the structured 409 on mismatch.\n *\n * The parent document is the consistency boundary: sub-resource mutations\n * recalculate document totals (or transition the document), which dirties the\n * parent so its `updated_at` advances on flush \u2014 meaning concurrent sub-edits\n * observe each other and conflict. Call this AFTER loading + scope-checking the\n * document and BEFORE mutating, so `document.updatedAt` is the pre-mutation\n * version.\n *\n * Strictly additive: when the client sends no header the check is a no-op, so\n * existing API consumers are unaffected. Respects `OM_OPTIMISTIC_LOCK`.\n */\nexport function enforceSalesDocumentOptimisticLock(\n  ctx: CommandRuntimeContext,\n  document: { id: string; updatedAt?: Date | string | null } | null | undefined,\n  resourceKind: string,\n): void {\n  if (!document) return\n  enforceCommandOptimisticLock({\n    resourceKind,\n    resourceId: document.id,\n    current: document.updatedAt ?? null,\n    request: ctx.request ?? null,\n  })\n}\n\nexport function cloneJson<T>(value: T): T {\n  if (value === null || value === undefined) return value\n  return JSON.parse(JSON.stringify(value)) as T\n}\n\nexport function toNumericString(value: number | null | undefined): string | null {\n  if (value === undefined || value === null) return null\n  return value.toString()\n}\n\nexport async function requireScopedEntity<T extends { id: string; deletedAt?: Date | null }>(\n  em: EntityManager,\n  entityClass: { new (): T },\n  id: string,\n  message: string,\n  scope: { organizationId: string | null; tenantId: string | null } = { organizationId: null, tenantId: null },\n): Promise<T> {\n  const where: Record<string, unknown> = { id, deletedAt: null }\n  if (scope.organizationId) where.organizationId = scope.organizationId\n  if (scope.tenantId) where.tenantId = scope.tenantId\n  const entity = await findOneWithDecryption(em, entityClass, where, {}, scope)\n  if (!entity) throw new CrudHttpError(404, { error: message })\n  return entity\n}\n"],
-  "mappings": "AACA,SAAS,qBAAqB;AAC9B,SAAS,6BAA6B;AAEtC,SAAS,oCAAoC;AAC7C,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB,iBAAiB,yBAAyB;AAC5E,SAAS,0BAA0B;AAG5B,MAAM,4BAA4B;AAClC,MAAM,4BAA4B;AAmBlC,SAAS,mCACd,KACA,UACA,cACM;AACN,MAAI,CAAC,SAAU;AACf,+BAA6B;AAAA,IAC3B;AAAA,IACA,YAAY,SAAS;AAAA,IACrB,SAAS,SAAS,aAAa;AAAA,IAC/B,SAAS,IAAI,WAAW;AAAA,EAC1B,CAAC;AACH;AAEO,SAAS,UAAa,OAAa;AACxC,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,SAAO,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AACzC;AAEO,SAAS,gBAAgB,OAAiD;AAC/E,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,SAAO,MAAM,SAAS;AACxB;AAEA,eAAsB,oBACpB,IACA,aACA,IACA,SACA,QAAoE,EAAE,gBAAgB,MAAM,UAAU,KAAK,GAC/F;AACZ,QAAM,QAAiC,EAAE,IAAI,WAAW,KAAK;AAC7D,MAAI,MAAM,eAAgB,OAAM,iBAAiB,MAAM;AACvD,MAAI,MAAM,SAAU,OAAM,WAAW,MAAM;AAC3C,QAAM,SAAS,MAAM,sBAAsB,IAAI,aAAa,OAAO,CAAC,GAAG,KAAK;AAC5E,MAAI,CAAC,OAAQ,OAAM,IAAI,cAAc,KAAK,EAAE,OAAO,QAAQ,CAAC;AAC5D,SAAO;AACT;",
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport type { CommandRuntimeContext } from '@open-mercato/shared/lib/commands'\nimport { enforceCommandOptimisticLock } from '@open-mercato/shared/lib/crud/optimistic-lock-command'\nexport { assertFound } from '@open-mercato/shared/lib/crud/errors'\nexport { ensureOrganizationScope, ensureSameScope, ensureTenantScope } from '@open-mercato/shared/lib/commands/scope'\nexport { extractUndoPayload } from '@open-mercato/shared/lib/commands/undo'\n\n/** Resource kinds used by the document-aggregate optimistic-lock check. */\nexport const SALES_RESOURCE_KIND_ORDER = 'sales.order'\nexport const SALES_RESOURCE_KIND_QUOTE = 'sales.quote'\nexport const SALES_RESOURCE_KIND_RETURN = 'sales.return'\n\n/**\n * Enforce the document-aggregate OSS optimistic lock for a sales sub-resource\n * command (lines, adjustments, shipments, payments, returns, quote\n * conversion). The client sends the parent order/quote's expected `updated_at`\n * via the optimistic-lock extension header; this compares it against the\n * already-loaded document and throws the structured 409 on mismatch.\n *\n * The parent document is the consistency boundary: sub-resource mutations\n * recalculate document totals (or transition the document), which dirties the\n * parent so its `updated_at` advances on flush \u2014 meaning concurrent sub-edits\n * observe each other and conflict. Call this AFTER loading + scope-checking the\n * document and BEFORE mutating, so `document.updatedAt` is the pre-mutation\n * version.\n *\n * Strictly additive: when the client sends no header the check is a no-op, so\n * existing API consumers are unaffected. Respects `OM_OPTIMISTIC_LOCK`.\n */\nexport function enforceSalesDocumentOptimisticLock(\n  ctx: CommandRuntimeContext,\n  document: { id: string; updatedAt?: Date | string | null } | null | undefined,\n  resourceKind: string,\n): void {\n  if (!document) return\n  enforceCommandOptimisticLock({\n    resourceKind,\n    resourceId: document.id,\n    current: document.updatedAt ?? null,\n    request: ctx.request ?? null,\n  })\n}\n\nexport function cloneJson<T>(value: T): T {\n  if (value === null || value === undefined) return value\n  return JSON.parse(JSON.stringify(value)) as T\n}\n\nexport function toNumericString(value: number | null | undefined): string | null {\n  if (value === undefined || value === null) return null\n  return value.toString()\n}\n\nexport async function requireScopedEntity<T extends { id: string; deletedAt?: Date | null }>(\n  em: EntityManager,\n  entityClass: { new (): T },\n  id: string,\n  message: string,\n  scope: { organizationId: string | null; tenantId: string | null } = { organizationId: null, tenantId: null },\n): Promise<T> {\n  const where: Record<string, unknown> = { id, deletedAt: null }\n  if (scope.organizationId) where.organizationId = scope.organizationId\n  if (scope.tenantId) where.tenantId = scope.tenantId\n  const entity = await findOneWithDecryption(em, entityClass, where, {}, scope)\n  if (!entity) throw new CrudHttpError(404, { error: message })\n  return entity\n}\n"],
+  "mappings": "AACA,SAAS,qBAAqB;AAC9B,SAAS,6BAA6B;AAEtC,SAAS,oCAAoC;AAC7C,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB,iBAAiB,yBAAyB;AAC5E,SAAS,0BAA0B;AAG5B,MAAM,4BAA4B;AAClC,MAAM,4BAA4B;AAClC,MAAM,6BAA6B;AAmBnC,SAAS,mCACd,KACA,UACA,cACM;AACN,MAAI,CAAC,SAAU;AACf,+BAA6B;AAAA,IAC3B;AAAA,IACA,YAAY,SAAS;AAAA,IACrB,SAAS,SAAS,aAAa;AAAA,IAC/B,SAAS,IAAI,WAAW;AAAA,EAC1B,CAAC;AACH;AAEO,SAAS,UAAa,OAAa;AACxC,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,SAAO,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AACzC;AAEO,SAAS,gBAAgB,OAAiD;AAC/E,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,SAAO,MAAM,SAAS;AACxB;AAEA,eAAsB,oBACpB,IACA,aACA,IACA,SACA,QAAoE,EAAE,gBAAgB,MAAM,UAAU,KAAK,GAC/F;AACZ,QAAM,QAAiC,EAAE,IAAI,WAAW,KAAK;AAC7D,MAAI,MAAM,eAAgB,OAAM,iBAAiB,MAAM;AACvD,MAAI,MAAM,SAAU,OAAM,WAAW,MAAM;AAC3C,QAAM,SAAS,MAAM,sBAAsB,IAAI,aAAa,OAAO,CAAC,GAAG,KAAK;AAC5E,MAAI,CAAC,OAAQ,OAAM,IAAI,cAAc,KAAK,EAAE,OAAO,QAAQ,CAAC;AAC5D,SAAO;AACT;",
   "names": []
 }

package/dist/modules/sales/components/documents/ReturnEditDialog.js

@@ -0,0 +1,126 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { Dialog, DialogContent, DialogHeader, DialogTitle } from "@open-mercato/ui/primitives/dialog";
+import { useDialogKeyHandler } from "@open-mercato/ui/hooks/useDialogKeyHandler";
+import { CrudForm } from "@open-mercato/ui/backend/CrudForm";
+import { updateCrud } from "@open-mercato/ui/backend/utils/crud";
+import { flash } from "@open-mercato/ui/backend/FlashMessages";
+import { useT } from "@open-mercato/shared/lib/i18n/context";
+import { E } from "../../../../generated/entities.ids.generated.js";
+import { handleSectionMutationError } from "./optimisticLock.js";
+function toDateInputValue(value) {
+  if (!value) return "";
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return "";
+  return date.toISOString().slice(0, 10);
+}
+function ReturnEditDialog({
+  open,
+  returnRecord,
+  orderId,
+  organizationId,
+  tenantId,
+  onClose,
+  onSaved
+}) {
+  const t = useT();
+  const dialogContentRef = React.useRef(null);
+  const initialValues = React.useMemo(
+    () => ({
+      id: returnRecord?.id ?? "",
+      // Drives CrudForm's automatic optimistic-lock header derivation.
+      updatedAt: returnRecord?.updatedAt ?? null,
+      reason: returnRecord?.reason ?? "",
+      notes: returnRecord?.notes ?? "",
+      returnedAt: toDateInputValue(returnRecord?.returnedAt)
+    }),
+    [returnRecord]
+  );
+  const fields = React.useMemo(
+    () => [
+      {
+        id: "reason",
+        label: t("sales.returns.reason", "Reason"),
+        type: "text",
+        placeholder: t("sales.returns.reason.placeholder", "Optional")
+      },
+      {
+        id: "returnedAt",
+        label: t("sales.returns.returnedAt", "Returned at"),
+        type: "date",
+        maxDate: /* @__PURE__ */ new Date()
+      },
+      {
+        id: "notes",
+        label: t("sales.returns.notes", "Notes"),
+        type: "textarea",
+        placeholder: t("sales.returns.notes.placeholder", "Optional")
+      }
+    ],
+    [t]
+  );
+  const handleSubmit = React.useCallback(
+    async (values) => {
+      if (!returnRecord) return;
+      const reason = typeof values.reason === "string" ? values.reason.trim() : "";
+      const notes = typeof values.notes === "string" ? values.notes.trim() : "";
+      const returnedAt = typeof values.returnedAt === "string" ? values.returnedAt.trim() : "";
+      try {
+        const result = await updateCrud(
+          "sales/returns",
+          {
+            id: returnRecord.id,
+            orderId,
+            ...organizationId ? { organizationId } : {},
+            ...tenantId ? { tenantId } : {},
+            reason,
+            notes,
+            ...returnedAt ? { returnedAt } : {}
+          },
+          {
+            errorMessage: t("sales.returns.errors.update", "Failed to update return.")
+          }
+        );
+        if (result.ok) {
+          flash(t("sales.returns.updated", "Return updated."), "success");
+          onClose();
+          await onSaved();
+        }
+      } catch (err) {
+        if (handleSectionMutationError(err, t, () => void onSaved())) {
+          onClose();
+          return;
+        }
+        throw err;
+      }
+    },
+    [onClose, onSaved, orderId, organizationId, returnRecord, t, tenantId]
+  );
+  const handleSubmitForm = React.useCallback(
+    () => dialogContentRef.current?.querySelector("form")?.requestSubmit(),
+    []
+  );
+  const handleKeyDown = useDialogKeyHandler({
+    onConfirm: handleSubmitForm,
+    onCancel: onClose
+  });
+  return /* @__PURE__ */ jsx(Dialog, { open, onOpenChange: (next) => !next ? onClose() : void 0, children: /* @__PURE__ */ jsxs(DialogContent, { className: "max-w-2xl", onKeyDown: handleKeyDown, ref: dialogContentRef, children: [
+    /* @__PURE__ */ jsx(DialogHeader, { children: /* @__PURE__ */ jsx(DialogTitle, { children: t("sales.returns.edit.title", "Edit return") }) }),
+    /* @__PURE__ */ jsx(
+      CrudForm,
+      {
+        embedded: true,
+        fields,
+        entityId: E.sales.sales_return,
+        initialValues,
+        submitLabel: t("sales.returns.edit.submit", "Save changes"),
+        onSubmit: handleSubmit
+      }
+    )
+  ] }) });
+}
+export {
+  ReturnEditDialog
+};
+//# sourceMappingURL=ReturnEditDialog.js.map

package/dist/modules/sales/components/documents/ReturnEditDialog.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/sales/components/documents/ReturnEditDialog.tsx"],
+  "sourcesContent": ["\"use client\"\n\nimport * as React from 'react'\nimport { Dialog, DialogContent, DialogHeader, DialogTitle } from '@open-mercato/ui/primitives/dialog'\nimport { useDialogKeyHandler } from '@open-mercato/ui/hooks/useDialogKeyHandler'\nimport { CrudForm, type CrudField } from '@open-mercato/ui/backend/CrudForm'\nimport { updateCrud } from '@open-mercato/ui/backend/utils/crud'\nimport { flash } from '@open-mercato/ui/backend/FlashMessages'\nimport { useT } from '@open-mercato/shared/lib/i18n/context'\nimport { E } from '#generated/entities.ids.generated'\nimport { handleSectionMutationError } from './optimisticLock'\n\nexport type ReturnEditRecord = {\n  id: string\n  reason: string | null\n  notes: string | null\n  returnedAt: string | null\n  updatedAt: string | null\n}\n\ntype ReturnEditFormValues = {\n  id: string\n  updatedAt: string | null\n  reason: string\n  notes: string\n  returnedAt: string\n}\n\ntype ReturnEditDialogProps = {\n  open: boolean\n  returnRecord: ReturnEditRecord | null\n  orderId: string\n  organizationId: string | null\n  tenantId: string | null\n  onClose: () => void\n  onSaved: () => Promise<void>\n}\n\nfunction toDateInputValue(value: string | null | undefined): string {\n  if (!value) return ''\n  const date = new Date(value)\n  if (Number.isNaN(date.getTime())) return ''\n  return date.toISOString().slice(0, 10)\n}\n\nexport function ReturnEditDialog({\n  open,\n  returnRecord,\n  orderId,\n  organizationId,\n  tenantId,\n  onClose,\n  onSaved,\n}: ReturnEditDialogProps) {\n  const t = useT()\n  const dialogContentRef = React.useRef<HTMLDivElement | null>(null)\n\n  const initialValues = React.useMemo<ReturnEditFormValues>(\n    () => ({\n      id: returnRecord?.id ?? '',\n      // Drives CrudForm's automatic optimistic-lock header derivation.\n      updatedAt: returnRecord?.updatedAt ?? null,\n      reason: returnRecord?.reason ?? '',\n      notes: returnRecord?.notes ?? '',\n      returnedAt: toDateInputValue(returnRecord?.returnedAt),\n    }),\n    [returnRecord],\n  )\n\n  const fields = React.useMemo<CrudField[]>(\n    () => [\n      {\n        id: 'reason',\n        label: t('sales.returns.reason', 'Reason'),\n        type: 'text',\n        placeholder: t('sales.returns.reason.placeholder', 'Optional'),\n      },\n      {\n        id: 'returnedAt',\n        label: t('sales.returns.returnedAt', 'Returned at'),\n        type: 'date',\n        maxDate: new Date(),\n      },\n      {\n        id: 'notes',\n        label: t('sales.returns.notes', 'Notes'),\n        type: 'textarea',\n        placeholder: t('sales.returns.notes.placeholder', 'Optional'),\n      },\n    ],\n    [t],\n  )\n\n  const handleSubmit = React.useCallback(\n    async (values: ReturnEditFormValues) => {\n      if (!returnRecord) return\n      const reason = typeof values.reason === 'string' ? values.reason.trim() : ''\n      const notes = typeof values.notes === 'string' ? values.notes.trim() : ''\n      const returnedAt = typeof values.returnedAt === 'string' ? values.returnedAt.trim() : ''\n      try {\n        const result = await updateCrud(\n          'sales/returns',\n          {\n            id: returnRecord.id,\n            orderId,\n            ...(organizationId ? { organizationId } : {}),\n            ...(tenantId ? { tenantId } : {}),\n            reason,\n            notes,\n            ...(returnedAt ? { returnedAt } : {}),\n          },\n          {\n            errorMessage: t('sales.returns.errors.update', 'Failed to update return.'),\n          },\n        )\n        if (result.ok) {\n          flash(t('sales.returns.updated', 'Return updated.'), 'success')\n          onClose()\n          await onSaved()\n        }\n      } catch (err) {\n        if (handleSectionMutationError(err, t, () => void onSaved())) {\n          onClose()\n          return\n        }\n        throw err\n      }\n    },\n    [onClose, onSaved, orderId, organizationId, returnRecord, t, tenantId],\n  )\n\n  const handleSubmitForm = React.useCallback(\n    () => dialogContentRef.current?.querySelector('form')?.requestSubmit(),\n    [],\n  )\n  const handleKeyDown = useDialogKeyHandler({\n    onConfirm: handleSubmitForm,\n    onCancel: onClose,\n  })\n\n  return (\n    <Dialog open={open} onOpenChange={(next) => (!next ? onClose() : undefined)}>\n      <DialogContent className=\"max-w-2xl\" onKeyDown={handleKeyDown} ref={dialogContentRef}>\n        <DialogHeader>\n          <DialogTitle>{t('sales.returns.edit.title', 'Edit return')}</DialogTitle>\n        </DialogHeader>\n        <CrudForm<ReturnEditFormValues>\n          embedded\n          fields={fields}\n          entityId={E.sales.sales_return}\n          initialValues={initialValues}\n          submitLabel={t('sales.returns.edit.submit', 'Save changes')}\n          onSubmit={handleSubmit}\n        />\n      </DialogContent>\n    </Dialog>\n  )\n}\n"],
+  "mappings": "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",
+  "names": []
+}