@open-mercato/core 0.10.1-develop.7723.1.3b2ea82ea7 → 0.10.1-develop.7726.1.a447cc5525

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

@@ -74,7 +74,9 @@ import {
   orderCreateSchema,
   ORDER_PAYMENT_LEDGER_WARNING_CODE,
   resolveSuppliedOrderPaymentLedgerFields,
+  amountsModeSchema,
   orderLineCreateSchema,
+  orderHeaderTotalsSchema,
   orderAdjustmentCreateSchema,
   invoiceCreateSchema,
   invoiceUpdateSchema,
@@ -109,6 +111,18 @@ import {
   resolveUpsertTotalsOrigin,
   resolveUpsertCalculatedAmounts
 } from "../lib/lineSnapshots.js";
+import {
+  assertAmountsModeUnsupportedOnQuote,
+  assertExternalHeaderComplete,
+  assertExternalLineComplete,
+  assertUniformAmountsMode,
+  buildExternalHeaderTotals,
+  hasAnySuppliedHeaderTotal,
+  readPersistedHeaderTotals,
+  refuseOnExternalOrder,
+  requireOrderTotalsForExternalWrite
+} from "../lib/externalAmounts.js";
+import { isExternalAmountsMode } from "../lib/calculations.js";
 import { loadShippedQuantityByLine } from "../lib/shipments/snapshots.js";
 import { resolveDictionaryEntryValue, resolveCachedDictionaryEntryValue } from "../lib/dictionaries.js";
 import { assertOrderCanBeCancelled, isCancelledOrderStatus } from "../lib/orderCancellationGuard.js";
@@ -151,7 +165,7 @@ const dateOnlySchema = z.string().trim().regex(/^\d{4}-\d{2}-\d{2}$/, { message:
 });
 const addressSnapshotSchema = z.record(z.string(), z.unknown()).nullable().optional();
 const exchangeRateSchema = z.coerce.number().min(0);
-const documentUpdateSchema = z.object({
+const documentUpdateFieldsSchema = z.object({
   id: z.string().uuid(),
   customerEntityId: z.string().uuid().nullable().optional(),
   customerContactId: z.string().uuid().nullable().optional(),
@@ -191,11 +205,20 @@ const documentUpdateSchema = z.object({
   paymentMethodSnapshot: z.record(z.string(), z.unknown()).nullable().optional(),
   tags: z.array(z.string().uuid()).optional(),
   customFields: z.record(z.string(), z.unknown()).optional(),
-  customFieldSetId: z.string().uuid().nullable().optional()
-}).refine(
-  (input) => typeof input.currencyCode === "string" || input.placedAt !== void 0 || input.expectedDeliveryAt !== void 0 || input.channelId !== void 0 || input.statusEntryId !== void 0 || input.exchangeRate !== void 0 || input.paymentStatusEntryId !== void 0 || input.fulfillmentStatusEntryId !== void 0 || input.shippingAddressId !== void 0 || input.billingAddressId !== void 0 || input.customerEntityId !== void 0 || input.customerContactId !== void 0 || input.customerSnapshot !== void 0 || input.metadata !== void 0 || input.customerReference !== void 0 || input.externalReference !== void 0 || input.comment !== void 0 || input.comments !== void 0 || input.internalNotes !== void 0 || input.orderNumber !== void 0 || input.quoteNumber !== void 0 || input.shippingAddressSnapshot !== void 0 || input.billingAddressSnapshot !== void 0 || input.shippingMethodId !== void 0 || input.shippingMethodCode !== void 0 || input.shippingMethodSnapshot !== void 0 || input.paymentMethodId !== void 0 || input.paymentMethodCode !== void 0 || input.paymentMethodSnapshot !== void 0 || input.tags !== void 0 || input.customFields !== void 0 || input.customFieldSetId !== void 0,
+  customFieldSetId: z.string().uuid().nullable().optional(),
+  totalsMode: amountsModeSchema.optional(),
+  ...orderHeaderTotalsSchema.shape
+});
+function carriesDocumentEdit(input) {
+  return typeof input.currencyCode === "string" || input.placedAt !== void 0 || input.expectedDeliveryAt !== void 0 || input.channelId !== void 0 || input.statusEntryId !== void 0 || input.exchangeRate !== void 0 || input.paymentStatusEntryId !== void 0 || input.fulfillmentStatusEntryId !== void 0 || input.shippingAddressId !== void 0 || input.billingAddressId !== void 0 || input.customerEntityId !== void 0 || input.customerContactId !== void 0 || input.customerSnapshot !== void 0 || input.metadata !== void 0 || input.customerReference !== void 0 || input.externalReference !== void 0 || input.comment !== void 0 || input.comments !== void 0 || input.internalNotes !== void 0 || input.orderNumber !== void 0 || input.quoteNumber !== void 0 || input.shippingAddressSnapshot !== void 0 || input.billingAddressSnapshot !== void 0 || input.shippingMethodId !== void 0 || input.shippingMethodCode !== void 0 || input.shippingMethodSnapshot !== void 0 || input.paymentMethodId !== void 0 || input.paymentMethodCode !== void 0 || input.paymentMethodSnapshot !== void 0 || input.tags !== void 0 || input.customFields !== void 0 || input.customFieldSetId !== void 0;
+}
+const documentUpdateSchema = documentUpdateFieldsSchema.refine(
+  (input) => carriesDocumentEdit(input) || input.totalsMode !== void 0 || hasAnySuppliedHeaderTotal(input),
   { message: "update_payload_empty" }
 );
+const documentEditSchema = documentUpdateFieldsSchema.refine(carriesDocumentEdit, {
+  message: "update_payload_empty"
+});
 function cloneJson(value) {
   if (value === null || value === void 0) return value;
   return JSON.parse(JSON.stringify(value));
@@ -1230,7 +1253,8 @@ async function loadOrderSnapshot(em, id) {
       refundedTotalAmount: order.refundedTotalAmount,
       outstandingAmount: order.outstandingAmount,
       totalsSnapshot: order.totalsSnapshot ? cloneJson(order.totalsSnapshot) : null,
-      lineItemCount: order.lineItemCount
+      lineItemCount: order.lineItemCount,
+      totalsMode: order.totalsMode ?? "computed"
     },
     lines: lines.map((line) => ({
       id: line.id,
@@ -1262,6 +1286,7 @@ async function loadOrderSnapshot(em, id) {
       taxAmount: line.taxAmount,
       totalNetAmount: line.totalNetAmount,
       totalGrossAmount: line.totalGrossAmount,
+      amountsMode: line.amountsMode ?? "computed",
       configuration: line.configuration ? cloneJson(line.configuration) : null,
       promotionCode: line.promotionCode ?? null,
       promotionSnapshot: line.promotionSnapshot ? cloneJson(line.promotionSnapshot) : null,
@@ -1991,7 +2016,8 @@ function createLineSnapshotFromInput(line, lineNumber) {
     promotionCode: line.promotionCode ?? null,
     metadata: line.metadata ? cloneJson(line.metadata) : null,
     customFieldSetId: "customFieldSetId" in line ? line.customFieldSetId ?? null : null,
-    customFields: "customFields" in line && line.customFields ? cloneJson(line.customFields) : null
+    customFields: "customFields" in line && line.customFields ? cloneJson(line.customFields) : null,
+    amountsMode: line.amountsMode ?? null
   };
 }
 function createAdjustmentDraftFromInput(adjustment) {
@@ -2019,7 +2045,8 @@ function createAdjustmentDraftFromInput(adjustment) {
 }
 function convertLineCalculationToEntityInput(lineResult, sourceLine, document, index) {
   const line = lineResult.line;
-  return reconcileLinePersistedTotals({
+  const persistTotals = isExternalAmountsMode(line.amountsMode) ? (payload) => payload : reconcileLinePersistedTotals;
+  return persistTotals({
     lineNumber: line.lineNumber ?? index + 1,
     kind: line.kind ?? "product",
     statusEntryId: sourceLine.statusEntryId ?? null,
@@ -2047,6 +2074,8 @@ function convertLineCalculationToEntityInput(lineResult, sourceLine, document, i
     taxAmount: toNumericString(lineResult.taxAmount) ?? "0",
     totalNetAmount: toNumericString(lineResult.netAmount) ?? "0",
     totalGrossAmount: toNumericString(lineResult.grossAmount) ?? "0",
+    // Conditional: this converter also serves quote lines, which have no column.
+    ...line.amountsMode ? { amountsMode: line.amountsMode } : {},
     configuration: line.configuration ? cloneJson(line.configuration) : null,
     promotionCode: line.promotionCode ?? null,
     promotionSnapshot: sourceLine.promotionSnapshot ? cloneJson(sourceLine.promotionSnapshot) : null,
@@ -2426,6 +2455,19 @@ function applyOrderTotals(order, totals, lineCount) {
   order.totalsSnapshot = cloneJson(totals);
   order.lineItemCount = lineCount;
 }
+function applyOrderLineAmountsFromCalculation(params) {
+  const { em, lines, calculation, amountsMode } = params;
+  lines.forEach((line, index) => {
+    const result = calculation.lines[index];
+    if (!result) return;
+    line.amountsMode = amountsMode;
+    line.discountAmount = toNumericString(result.discountAmount) ?? "0";
+    line.taxAmount = toNumericString(result.taxAmount) ?? "0";
+    line.totalNetAmount = toNumericString(result.netAmount) ?? "0";
+    line.totalGrossAmount = toNumericString(result.grossAmount) ?? "0";
+    em.persist(line);
+  });
+}
 function normalizePaymentTotal(value) {
   if (typeof value === "number" && Number.isFinite(value))
     return Math.max(value, 0);
@@ -2679,6 +2721,7 @@ function applyOrderSnapshot(order, snapshot) {
   order.outstandingAmount = snapshot.outstandingAmount;
   order.totalsSnapshot = snapshot.totalsSnapshot ? cloneJson(snapshot.totalsSnapshot) : null;
   order.lineItemCount = snapshot.lineItemCount;
+  order.totalsMode = snapshot.totalsMode ?? "computed";
 }
 async function assertQuoteGraphUndoCurrent(em, quoteId, expected) {
   const current = await loadQuoteSnapshot(em, quoteId);
@@ -3202,6 +3245,7 @@ async function restoreOrderGraph(em, snapshot, verified = null) {
       outstandingAmount: snapshot.order.outstandingAmount,
       totalsSnapshot: snapshot.order.totalsSnapshot ? cloneJson(snapshot.order.totalsSnapshot) : null,
       lineItemCount: snapshot.order.lineItemCount,
+      totalsMode: snapshot.order.totalsMode ?? "computed",
       createdAt: /* @__PURE__ */ new Date(),
       updatedAt: /* @__PURE__ */ new Date()
     });
@@ -3302,10 +3346,12 @@ async function restoreOrderGraph(em, snapshot, verified = null) {
       discountPercent: line.discountPercent,
       taxRate: line.taxRate,
       taxAmount: line.taxAmount,
-      totalNetAmount: toNumericString(
+      // Not repaired from gross: an external line's net is the caller's figure.
+      totalNetAmount: isExternalAmountsMode(line.amountsMode) ? line.totalNetAmount : toNumericString(
         deriveLineNetFromGross(line.totalNetAmount, line.totalGrossAmount, line.taxRate)
       ),
       totalGrossAmount: line.totalGrossAmount,
+      amountsMode: line.amountsMode ?? "computed",
       configuration: line.configuration ? cloneJson(line.configuration) : null,
       promotionCode: line.promotionCode ?? null,
       promotionSnapshot: line.promotionSnapshot ? cloneJson(line.promotionSnapshot) : null,
@@ -3549,6 +3595,7 @@ const createQuoteCommand = {
       createdAt: /* @__PURE__ */ new Date(),
       updatedAt: /* @__PURE__ */ new Date()
     });
+    await assertAmountsModeUnsupportedOnQuote(parsed.lines ?? []);
     const lineInputs = (parsed.lines ?? []).map(
       (line, index) => quoteLineCreateSchema.parse({
         ...line,
@@ -3894,6 +3941,8 @@ const updateQuoteCommand = {
   },
   async execute(rawInput, ctx) {
     const parsed = documentUpdateSchema.parse(rawInput ?? {});
+    await assertAmountsModeUnsupportedOnQuote([parsed]);
+    documentEditSchema.parse(rawInput ?? {});
     const em = ctx.container.resolve("em").fork();
     const quote = await findOneWithDecryption(em, SalesQuote, {
       id: parsed.id,
@@ -4151,6 +4200,16 @@ const updateOrderCommand = {
     if (!order)
       throw notFound("Sales order not found");
     ensureOrderScope(ctx, order.organizationId, order.tenantId);
+    const currentTotalsMode = order.totalsMode ?? "computed";
+    const nextTotalsMode = parsed.totalsMode ?? currentTotalsMode;
+    const totalsModeChanged = nextTotalsMode !== currentTotalsMode;
+    const externalHeaderSupplied = isExternalAmountsMode(nextTotalsMode) && hasAnySuppliedHeaderTotal(parsed);
+    if (!totalsModeChanged && !externalHeaderSupplied) {
+      documentEditSchema.parse(rawInput ?? {});
+    }
+    if (isExternalAmountsMode(nextTotalsMode) && (totalsModeChanged || externalHeaderSupplied)) {
+      await requireOrderTotalsForExternalWrite(parsed);
+    }
     await enforceSalesDocumentOptimisticLock(ctx, order, SALES_RESOURCE_KIND_ORDER);
     const previousStatus = normalizeStatusValue(order.status);
     if (parsed.statusEntryId && !isCancelledOrderStatus(previousStatus)) {
@@ -4164,7 +4223,10 @@ const updateOrderCommand = {
       }
     }
     let statusChangeNote = null;
-    const shouldRecalculateTotals = parsed.shippingMethodId !== void 0 || parsed.shippingMethodSnapshot !== void 0 || parsed.shippingMethodCode !== void 0 || parsed.paymentMethodId !== void 0 || parsed.paymentMethodSnapshot !== void 0 || parsed.paymentMethodCode !== void 0 || parsed.currencyCode !== void 0;
+    const suppliedTotals = isExternalAmountsMode(
+      nextTotalsMode
+    ) ? externalHeaderSupplied ? buildExternalHeaderTotals(parsed) : readPersistedHeaderTotals(order) : null;
+    const shouldRecalculateTotals = parsed.shippingMethodId !== void 0 || parsed.shippingMethodSnapshot !== void 0 || parsed.shippingMethodCode !== void 0 || parsed.paymentMethodId !== void 0 || parsed.paymentMethodSnapshot !== void 0 || parsed.paymentMethodCode !== void 0 || parsed.currencyCode !== void 0 || totalsModeChanged || externalHeaderSupplied;
     await withAtomicFlush(
       em,
       [
@@ -4197,10 +4259,13 @@ const updateOrderCommand = {
               )
             ]);
             const lineSnapshots = existingLines.map(mapOrderLineEntityToSnapshot);
+            const leavingExternal = totalsModeChanged && !isExternalAmountsMode(nextTotalsMode);
             const calcLines = lineSnapshots.map(
               (line, index) => createLineSnapshotFromInput(
                 {
                   ...line,
+                  ...leavingExternal ? { taxAmount: null, totalGrossAmount: null } : {},
+                  amountsMode: nextTotalsMode,
                   organizationId: order.organizationId,
                   tenantId: order.tenantId,
                   orderId: order.id,
@@ -4232,7 +4297,9 @@ const updateOrderCommand = {
               lines: calcLines,
               adjustments: adjustmentDrafts,
               context: calculationContext,
-              existingTotals: resolveExistingPaymentTotals(order)
+              existingTotals: resolveExistingPaymentTotals(order),
+              totalsMode: nextTotalsMode,
+              suppliedTotals
             });
             const adjustmentInputs = adjustmentDrafts.map((adj, index) => ({
               organizationId: order.organizationId,
@@ -4257,6 +4324,15 @@ const updateOrderCommand = {
               calculation,
               adjustmentInputs
             );
+            if (totalsModeChanged) {
+              applyOrderLineAmountsFromCalculation({
+                em,
+                lines: existingLines,
+                calculation,
+                amountsMode: nextTotalsMode
+              });
+              order.totalsMode = nextTotalsMode;
+            }
             applyOrderTotals(order, calculation.totals, calculation.lines.length);
             let eventBus = null;
             try {
@@ -4545,7 +4621,21 @@ const createOrderCommand = {
         orderId: order.id
       })
     ) : null;
-    const lineSnapshots = normalizedLineInputs.map(
+    const totalsMode = parsed.totalsMode ?? "computed";
+    await assertUniformAmountsMode(totalsMode, normalizedLineInputs);
+    const modedLineInputs = normalizedLineInputs.map((line) => ({
+      ...line,
+      amountsMode: totalsMode
+    }));
+    if (isExternalAmountsMode(totalsMode)) {
+      await assertExternalHeaderComplete(parsed);
+      for (const [index, line] of modedLineInputs.entries()) {
+        await assertExternalLineComplete(line, line.lineNumber ?? index + 1);
+      }
+    }
+    order.totalsMode = totalsMode;
+    const suppliedTotals = isExternalAmountsMode(totalsMode) ? buildExternalHeaderTotals(parsed) : null;
+    const lineSnapshots = modedLineInputs.map(
       (line, index) => createLineSnapshotFromInput(line, line.lineNumber ?? index + 1)
     );
     const adjustmentDrafts = adjustmentInputs ? adjustmentInputs.map((adj) => createAdjustmentDraftFromInput(adj)) : [];
@@ -4566,7 +4656,9 @@ const createOrderCommand = {
       lines: lineSnapshots,
       adjustments: adjustmentDrafts,
       context: calculationContext,
-      existingTotals: resolveExistingPaymentTotals(order)
+      existingTotals: resolveExistingPaymentTotals(order),
+      totalsMode,
+      suppliedTotals
     });
     let eventBus = null;
     try {
@@ -4579,7 +4671,7 @@ const createOrderCommand = {
       [
         async () => {
           em.persist(order);
-          await replaceOrderLines(em, order, calculation, normalizedLineInputs);
+          await replaceOrderLines(em, order, calculation, modedLineInputs);
           await replaceOrderAdjustments(
             em,
             order,
@@ -5315,11 +5407,13 @@ const convertQuoteToOrderCommand = {
   }
 };
 const orderLineUpsertSchema = orderLineCreateSchema.extend({
-  id: z.string().uuid().optional()
+  id: z.string().uuid().optional(),
+  orderTotals: orderHeaderTotalsSchema.optional()
 });
 const orderLineDeleteSchema = z.object({
   id: z.string().uuid(),
-  orderId: z.string().uuid()
+  orderId: z.string().uuid(),
+  orderTotals: orderHeaderTotalsSchema.optional()
 });
 const quoteLineUpsertSchema = quoteLineCreateSchema.extend({
   id: z.string().uuid().optional()
@@ -5517,12 +5611,19 @@ const orderLineUpsertCommand = {
     ]);
     const lineSnapshots = existingLines.map(mapOrderLineEntityToSnapshot);
     const existingSnapshot = parsed.id ? lineSnapshots.find((line) => line.id === parsed.id) ?? null : null;
+    const totalsMode = order.totalsMode ?? "computed";
+    await assertUniformAmountsMode(totalsMode, [parsed]);
+    if (isExternalAmountsMode(totalsMode)) {
+      await requireOrderTotalsForExternalWrite(parsed.orderTotals);
+    }
+    const suppliedTotals = isExternalAmountsMode(totalsMode) ? buildExternalHeaderTotals(parsed.orderTotals) : null;
     await assertOrderAcceptsNewLine(order, existingSnapshot);
     await assertShippedOrderLineEditable(em, order, existingSnapshot, parsed);
     const priceMode = parsed.priceMode === "gross" ? "gross" : parsed.priceMode === "net" ? "net" : null;
     let unitPriceNet = parsed.unitPriceNet ?? existingSnapshot?.unitPriceNet ?? null;
     let unitPriceGross = parsed.unitPriceGross ?? existingSnapshot?.unitPriceGross ?? null;
     let taxRate = parsed.taxRate ?? existingSnapshot?.taxRate ?? null;
+    const unitPriceSupplied = unitPriceNet !== null || unitPriceGross !== null;
     if (priceMode && (unitPriceNet === null || unitPriceGross === null)) {
       let taxService = null;
       try {
@@ -5624,12 +5725,22 @@ const orderLineUpsertCommand = {
       promotionCode: parsed.promotionCode ?? existingSnapshot?.promotionCode ?? null,
       metadata,
       customFieldSetId: parsed.customFieldSetId ?? existingSnapshot?.customFieldSetId ?? null,
-      customFields: parsed.customFields && typeof parsed.customFields === "object" ? cloneJson(parsed.customFields) : existingSnapshot?.customFields ?? null
+      customFields: parsed.customFields && typeof parsed.customFields === "object" ? cloneJson(parsed.customFields) : existingSnapshot?.customFields ?? null,
+      amountsMode: totalsMode
     };
     Object.assign(
       updatedSnapshot,
       resolveUpsertCalculatedAmounts(parsed, updatedSnapshot, existingSnapshot)
     );
+    if (isExternalAmountsMode(totalsMode)) {
+      await assertExternalLineComplete(
+        {
+          ...updatedSnapshot,
+          unitPriceNet: unitPriceSupplied ? unitPriceNet : null
+        },
+        updatedSnapshot.lineNumber ?? 1
+      );
+    }
     updatedSnapshot.statusEntryId = statusEntryId;
     updatedSnapshot.catalogSnapshot = parsed.catalogSnapshot ?? existingSnapshot?.catalogSnapshot ?? null;
     updatedSnapshot.promotionSnapshot = parsed.promotionSnapshot ?? existingSnapshot?.promotionSnapshot ?? null;
@@ -5668,7 +5779,9 @@ const orderLineUpsertCommand = {
       lines: calcLines,
       adjustments: adjustmentDrafts,
       context: calculationContext,
-      existingTotals: resolveExistingPaymentTotals(order)
+      existingTotals: resolveExistingPaymentTotals(order),
+      totalsMode,
+      suppliedTotals
     });
     let eventBus = null;
     try {
@@ -5805,6 +5918,11 @@ const orderLineDeleteCommand = {
         )
       });
     }
+    const totalsMode = order.totalsMode ?? "computed";
+    if (isExternalAmountsMode(totalsMode)) {
+      await requireOrderTotalsForExternalWrite(parsed.orderTotals);
+    }
+    const suppliedTotals = isExternalAmountsMode(totalsMode) ? buildExternalHeaderTotals(parsed.orderTotals) : null;
     const sourceInputs = filtered.map((line, index) => ({
       ...mapOrderLineEntityToSnapshot(line),
       statusEntryId: line.statusEntryId ?? null,
@@ -5836,7 +5954,9 @@ const orderLineDeleteCommand = {
       lines: calcLines,
       adjustments: adjustmentDrafts,
       context: calculationContext,
-      existingTotals: resolveExistingPaymentTotals(order)
+      existingTotals: resolveExistingPaymentTotals(order),
+      totalsMode,
+      suppliedTotals
     });
     let eventBus = null;
     try {
@@ -5922,6 +6042,7 @@ const quoteLineUpsertCommand = {
   async execute(input, ctx) {
     const rawBody = input?.body ?? {};
     const parsed = quoteLineUpsertSchema.parse(rawBody);
+    await assertAmountsModeUnsupportedOnQuote([parsed]);
     const em = ctx.container.resolve("em").fork();
     const quote = await findOneWithDecryption(em, SalesQuote, {
       id: parsed.quoteId,
@@ -6325,6 +6446,7 @@ const orderAdjustmentUpsertCommand = {
       throw notFound("Sales order not found");
     ensureOrderScope(ctx, order.organizationId, order.tenantId);
     await enforceSalesDocumentOptimisticLock(ctx, order, SALES_RESOURCE_KIND_ORDER);
+    if (isExternalAmountsMode(order.totalsMode ?? "computed")) await refuseOnExternalOrder();
     if (parsed.scope === "line") {
       throw new CrudHttpError(400, {
         error: "Line-scoped adjustments are not supported yet."
@@ -6575,6 +6697,7 @@ const orderAdjustmentDeleteCommand = {
       throw notFound("Sales order not found");
     ensureOrderScope(ctx, order.organizationId, order.tenantId);
     await enforceSalesDocumentOptimisticLock(ctx, order, SALES_RESOURCE_KIND_ORDER);
+    if (isExternalAmountsMode(order.totalsMode ?? "computed")) await refuseOnExternalOrder();
     const [existingLines, adjustments] = await Promise.all([
       em.find(SalesOrderLine, { order }, { orderBy: { lineNumber: "asc" } }),
       em.find(