@open-mercato/core 0.10.1-develop.7722.1.901c72b9e9 → 0.10.1-develop.7724.1.95e4e7d38e

package/dist/modules/sales/lib/providers/totals.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/modules/sales/lib/providers/totals.ts"],
-  "sourcesContent": ["import { registerSalesTotalsCalculator, rebuildDocumentResult } from '../calculations'\nimport type { SalesAdjustmentDraft, SalesDocumentCalculationResult } from '../types'\nimport {\n  getPaymentProvider,\n  getShippingProvider,\n  normalizeProviderSettings,\n} from './registry'\nimport type {\n  PaymentMethodContext,\n  ProviderAdjustment,\n  ProviderAdjustmentResult,\n  ShippingMethodContext,\n  ShippingMetrics,\n} from './types'\n\nconst SHIPPING_PREFIX = 'shipping-provider:'\nconst PAYMENT_PREFIX = 'payment-provider:'\n\nlet totalsRegistered = false\n\nfunction toNumber(value: unknown, fallback = 0): number {\n  if (typeof value === 'number' && Number.isFinite(value)) return value\n  if (typeof value === 'string' && value.trim() !== '' && !Number.isNaN(Number(value))) {\n    return Number(value)\n  }\n  return fallback\n}\n\nfunction isProviderAdjustment(adjustment: SalesAdjustmentDraft): boolean {\n  const key = adjustment.calculatorKey ?? ''\n  return typeof key === 'string' && (key.startsWith(SHIPPING_PREFIX) || key.startsWith(PAYMENT_PREFIX))\n}\n\nfunction isManualOverride(adjustment: SalesAdjustmentDraft): boolean {\n  const metadata = adjustment.metadata\n  if (!metadata || typeof metadata !== 'object') return false\n  const manual =\n    (metadata as Record<string, unknown>).manualOverride ??\n    (metadata as Record<string, unknown>).manual_override\n  return manual === true\n}\n\nfunction withoutPrefix(adjustments: SalesAdjustmentDraft[], prefix: string) {\n  return adjustments.filter((adj) => {\n    if (!(adj.calculatorKey ?? '').startsWith(prefix)) return true\n    return isManualOverride(adj)\n  })\n}\n\nfunction extractProviderSettings(\n  method: ShippingMethodContext | PaymentMethodContext | null | undefined\n): Record<string, unknown> | null {\n  if (!method) return null\n  if (method.providerSettings && typeof method.providerSettings === 'object') {\n    return method.providerSettings as Record<string, unknown>\n  }\n  if (method.metadata && typeof method.metadata === 'object') {\n    const meta = method.metadata as Record<string, unknown>\n    if (meta.providerSettings && typeof meta.providerSettings === 'object') {\n      return meta.providerSettings as Record<string, unknown>\n    }\n  }\n  return null\n}\n\nfunction computeMetrics(lines: SalesDocumentCalculationResult['lines']): ShippingMetrics {\n  let itemCount = 0\n  let totalWeight = 0\n  let totalVolume = 0\n  let subtotalNet = 0\n  let subtotalGross = 0\n\n  for (const entry of lines) {\n    const { line } = entry\n    const qty = toNumber(line.quantity, 0)\n    itemCount += qty\n    subtotalNet += toNumber(entry.netAmount, 0)\n    subtotalGross += toNumber(entry.grossAmount, 0)\n\n    const meta = (line.metadata ?? {}) as Record<string, unknown>\n    const configuration = (line.configuration ?? {}) as Record<string, unknown>\n    const weight =\n      toNumber((meta.weight as number | string | undefined) ?? (configuration.weight as number | string | undefined), 0) *\n      qty\n    const volume =\n      toNumber(\n        (meta.volume as number | string | undefined) ??\n          (configuration.volume as number | string | undefined),\n        0\n      ) * qty\n\n    totalWeight += weight\n    totalVolume += volume\n  }\n\n  return {\n    itemCount,\n    totalWeight,\n    totalVolume,\n    subtotalNet,\n    subtotalGross,\n  }\n}\n\nfunction normalizeAdjustments(params: {\n  providerKey: string\n  calculatorKey: string\n  adjustments: ProviderAdjustment[]\n  currencyCode: string\n  defaultKind: SalesAdjustmentDraft['kind']\n}) {\n  return params.adjustments.map<SalesAdjustmentDraft>((adj, index) => ({\n    scope: 'order',\n    kind: adj.kind ?? params.defaultKind,\n    code: adj.code ?? params.providerKey,\n    label: adj.label ?? params.providerKey,\n    calculatorKey: params.calculatorKey,\n    promotionId: null,\n    rate: null,\n    amountNet: toNumber(adj.amountNet, 0),\n    amountGross:\n      adj.amountGross === undefined || adj.amountGross === null\n        ? toNumber(adj.amountNet, 0)\n        : toNumber(adj.amountGross, 0),\n    currencyCode: (adj.currencyCode || params.currencyCode || '').toUpperCase() || params.currencyCode,\n    metadata: adj.metadata ?? null,\n    position: 10_000 + index,\n  }))\n}\n\nfunction mergeMetadata(\n  base: Record<string, unknown> | undefined,\n  key: string,\n  value: unknown\n): Record<string, unknown> {\n  const next = { ...(base ?? {}) }\n  next[key] = value\n  return next\n}\n\nfunction applyProviderResult(\n  current: SalesDocumentCalculationResult,\n  adjustments: SalesAdjustmentDraft[],\n  providerKey: string,\n  calculatorKey: string,\n  result: ProviderAdjustmentResult | null | undefined,\n  defaultKind: SalesAdjustmentDraft['kind']\n): SalesDocumentCalculationResult {\n  if (!result?.adjustments?.length) {\n    return rebuildDocumentResult({\n      documentKind: current.kind,\n      currencyCode: current.currencyCode,\n      lines: current.lines,\n      adjustments,\n      metadata: current.metadata,\n    })\n  }\n  const normalized = normalizeAdjustments({\n    providerKey,\n    calculatorKey,\n    adjustments: result.adjustments,\n    currencyCode: current.currencyCode,\n    defaultKind,\n  })\n  const nextAdjustments = [...adjustments, ...normalized]\n  const next = rebuildDocumentResult({\n    documentKind: current.kind,\n    currencyCode: current.currencyCode,\n    lines: current.lines,\n    adjustments: nextAdjustments,\n    metadata: current.metadata,\n  })\n  if (result.metadata) {\n    next.metadata = mergeMetadata(next.metadata, calculatorKey, result.metadata)\n  }\n  return next\n}\n\nexport function ensureProviderTotalsCalculator() {\n  if (totalsRegistered) return\n  totalsRegistered = true\n\n  registerSalesTotalsCalculator(async ({ documentKind, lines, context, current, eventBus }) => {\n    const metadata = (context.metadata ?? {}) as Record<string, unknown>\n    const shippingMethod = (metadata.shippingMethod ?? null) as ShippingMethodContext | null\n    const paymentMethod = (metadata.paymentMethod ?? null) as PaymentMethodContext | null\n\n    let runningAdjustments = (current.adjustments ?? []).filter(\n      (adj) => !isProviderAdjustment(adj) || isManualOverride(adj)\n    )\n    let working = rebuildDocumentResult({\n      documentKind,\n      currencyCode: current.currencyCode,\n      lines,\n      adjustments: runningAdjustments,\n      metadata: current.metadata,\n    })\n\n    if (shippingMethod?.providerKey) {\n      const provider = getShippingProvider(shippingMethod.providerKey)\n      if (provider?.calculate) {\n        const calculatorKey = `${SHIPPING_PREFIX}${provider.key}`\n        const hasManualOverride = runningAdjustments.some(\n          (adj) => (adj.calculatorKey ?? '').startsWith(calculatorKey) && isManualOverride(adj)\n        )\n        if (hasManualOverride) {\n          // Respect user overrides: keep existing provider-tagged adjustments and skip regeneration.\n          working = rebuildDocumentResult({\n            documentKind,\n            currencyCode: working.currencyCode,\n            lines: working.lines,\n            adjustments: runningAdjustments,\n            metadata: working.metadata,\n          })\n        } else {\n          const rawSettings = extractProviderSettings(shippingMethod)\n          const settings =\n            normalizeProviderSettings('shipping', provider.key, rawSettings) ?? rawSettings ?? {}\n          const metrics = computeMetrics(working.lines)\n          let result = await provider.calculate({\n            method: shippingMethod,\n            settings,\n            document: working,\n            lines: working.lines,\n            context,\n            metrics,\n          })\n          if (eventBus) {\n            await eventBus.emitEvent('sales.shipping.adjustments.apply.before', {\n              documentKind,\n              providerKey: provider.key,\n              calculatorKey,\n              method: shippingMethod,\n              settings,\n              document: working,\n              result,\n              setResult(next: ProviderAdjustmentResult | null | undefined) {\n                result = next ?? null\n              },\n            })\n          }\n          working = applyProviderResult(working, runningAdjustments, provider.key, calculatorKey, result, 'shipping')\n          runningAdjustments = working.adjustments\n          if (eventBus) {\n            let nextDocument = working\n            await eventBus.emitEvent('sales.shipping.adjustments.apply.after', {\n              documentKind,\n              providerKey: provider.key,\n              calculatorKey,\n              method: shippingMethod,\n              settings,\n              document: nextDocument,\n              adjustments: nextDocument.adjustments.filter((adj) =>\n                (adj.calculatorKey ?? '').startsWith(calculatorKey)\n              ),\n              setDocument(next: SalesDocumentCalculationResult | null | undefined) {\n                if (next) {\n                  nextDocument = next\n                }\n              },\n              setAdjustments(next: SalesAdjustmentDraft[] | null | undefined) {\n                if (!next) return\n                const preserved = nextDocument.adjustments.filter(\n                  (adj) => !(adj.calculatorKey ?? '').startsWith(calculatorKey)\n                )\n                nextDocument = rebuildDocumentResult({\n                  documentKind,\n                  currencyCode: nextDocument.currencyCode,\n                  lines: nextDocument.lines,\n                  adjustments: [...preserved, ...next],\n                  metadata: nextDocument.metadata,\n                })\n              },\n            })\n            working = nextDocument\n            runningAdjustments = working.adjustments\n          }\n        }\n      }\n    }\n\n    if (paymentMethod?.providerKey) {\n      const provider = getPaymentProvider(paymentMethod.providerKey)\n      if (provider?.calculate) {\n        const calculatorKey = `${PAYMENT_PREFIX}${provider.key}`\n        const hasManualOverride = runningAdjustments.some(\n          (adj) => (adj.calculatorKey ?? '').startsWith(calculatorKey) && isManualOverride(adj)\n        )\n        if (hasManualOverride) {\n          working = rebuildDocumentResult({\n            documentKind,\n            currencyCode: working.currencyCode,\n            lines: working.lines,\n            adjustments: runningAdjustments,\n            metadata: working.metadata,\n          })\n        } else {\n          runningAdjustments = withoutPrefix(runningAdjustments, PAYMENT_PREFIX)\n          const rawSettings = extractProviderSettings(paymentMethod)\n          const settings =\n            normalizeProviderSettings('payment', provider.key, rawSettings) ?? rawSettings ?? {}\n          let result = await provider.calculate({\n            method: paymentMethod,\n            settings,\n            document: working,\n            lines: working.lines,\n            context,\n          })\n          if (eventBus) {\n            await eventBus.emitEvent('sales.payment.adjustments.apply.before', {\n              documentKind,\n              providerKey: provider.key,\n              calculatorKey,\n              method: paymentMethod,\n              settings,\n              document: working,\n              result,\n              setResult(next: ProviderAdjustmentResult | null | undefined) {\n                result = next ?? null\n              },\n            })\n          }\n          working = applyProviderResult(\n            working,\n            runningAdjustments,\n            provider.key,\n            calculatorKey,\n            result,\n            'surcharge'\n          )\n          runningAdjustments = working.adjustments\n          if (eventBus) {\n            let nextDocument = working\n            await eventBus.emitEvent('sales.payment.adjustments.apply.after', {\n              documentKind,\n              providerKey: provider.key,\n              calculatorKey,\n              method: paymentMethod,\n              settings,\n              document: nextDocument,\n              adjustments: nextDocument.adjustments.filter((adj) =>\n                (adj.calculatorKey ?? '').startsWith(calculatorKey)\n              ),\n              setDocument(next: SalesDocumentCalculationResult | null | undefined) {\n                if (next) {\n                  nextDocument = next\n                }\n              },\n              setAdjustments(next: SalesAdjustmentDraft[] | null | undefined) {\n                if (!next) return\n                const preserved = nextDocument.adjustments.filter(\n                  (adj) => !(adj.calculatorKey ?? '').startsWith(calculatorKey)\n                )\n                nextDocument = rebuildDocumentResult({\n                  documentKind,\n                  currencyCode: nextDocument.currencyCode,\n                  lines: nextDocument.lines,\n                  adjustments: [...preserved, ...next],\n                  metadata: nextDocument.metadata,\n                })\n              },\n            })\n            working = nextDocument\n            runningAdjustments = working.adjustments\n          }\n        }\n      }\n    }\n\n    return working\n  })\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { isExternalAmountsMode, registerSalesTotalsCalculator, rebuildDocumentResult } from '../calculations'\nimport type { SalesAdjustmentDraft, SalesDocumentCalculationResult } from '../types'\nimport {\n  getPaymentProvider,\n  getShippingProvider,\n  normalizeProviderSettings,\n} from './registry'\nimport type {\n  PaymentMethodContext,\n  ProviderAdjustment,\n  ProviderAdjustmentResult,\n  ShippingMethodContext,\n  ShippingMetrics,\n} from './types'\n\nconst SHIPPING_PREFIX = 'shipping-provider:'\nconst PAYMENT_PREFIX = 'payment-provider:'\n\nlet totalsRegistered = false\n\nfunction toNumber(value: unknown, fallback = 0): number {\n  if (typeof value === 'number' && Number.isFinite(value)) return value\n  if (typeof value === 'string' && value.trim() !== '' && !Number.isNaN(Number(value))) {\n    return Number(value)\n  }\n  return fallback\n}\n\nfunction isProviderAdjustment(adjustment: SalesAdjustmentDraft): boolean {\n  const key = adjustment.calculatorKey ?? ''\n  return typeof key === 'string' && (key.startsWith(SHIPPING_PREFIX) || key.startsWith(PAYMENT_PREFIX))\n}\n\nfunction isManualOverride(adjustment: SalesAdjustmentDraft): boolean {\n  const metadata = adjustment.metadata\n  if (!metadata || typeof metadata !== 'object') return false\n  const manual =\n    (metadata as Record<string, unknown>).manualOverride ??\n    (metadata as Record<string, unknown>).manual_override\n  return manual === true\n}\n\nfunction withoutPrefix(adjustments: SalesAdjustmentDraft[], prefix: string) {\n  return adjustments.filter((adj) => {\n    if (!(adj.calculatorKey ?? '').startsWith(prefix)) return true\n    return isManualOverride(adj)\n  })\n}\n\nfunction extractProviderSettings(\n  method: ShippingMethodContext | PaymentMethodContext | null | undefined\n): Record<string, unknown> | null {\n  if (!method) return null\n  if (method.providerSettings && typeof method.providerSettings === 'object') {\n    return method.providerSettings as Record<string, unknown>\n  }\n  if (method.metadata && typeof method.metadata === 'object') {\n    const meta = method.metadata as Record<string, unknown>\n    if (meta.providerSettings && typeof meta.providerSettings === 'object') {\n      return meta.providerSettings as Record<string, unknown>\n    }\n  }\n  return null\n}\n\nfunction computeMetrics(lines: SalesDocumentCalculationResult['lines']): ShippingMetrics {\n  let itemCount = 0\n  let totalWeight = 0\n  let totalVolume = 0\n  let subtotalNet = 0\n  let subtotalGross = 0\n\n  for (const entry of lines) {\n    const { line } = entry\n    const qty = toNumber(line.quantity, 0)\n    itemCount += qty\n    subtotalNet += toNumber(entry.netAmount, 0)\n    subtotalGross += toNumber(entry.grossAmount, 0)\n\n    const meta = (line.metadata ?? {}) as Record<string, unknown>\n    const configuration = (line.configuration ?? {}) as Record<string, unknown>\n    const weight =\n      toNumber((meta.weight as number | string | undefined) ?? (configuration.weight as number | string | undefined), 0) *\n      qty\n    const volume =\n      toNumber(\n        (meta.volume as number | string | undefined) ??\n          (configuration.volume as number | string | undefined),\n        0\n      ) * qty\n\n    totalWeight += weight\n    totalVolume += volume\n  }\n\n  return {\n    itemCount,\n    totalWeight,\n    totalVolume,\n    subtotalNet,\n    subtotalGross,\n  }\n}\n\nfunction normalizeAdjustments(params: {\n  providerKey: string\n  calculatorKey: string\n  adjustments: ProviderAdjustment[]\n  currencyCode: string\n  defaultKind: SalesAdjustmentDraft['kind']\n}) {\n  return params.adjustments.map<SalesAdjustmentDraft>((adj, index) => ({\n    scope: 'order',\n    kind: adj.kind ?? params.defaultKind,\n    code: adj.code ?? params.providerKey,\n    label: adj.label ?? params.providerKey,\n    calculatorKey: params.calculatorKey,\n    promotionId: null,\n    rate: null,\n    amountNet: toNumber(adj.amountNet, 0),\n    amountGross:\n      adj.amountGross === undefined || adj.amountGross === null\n        ? toNumber(adj.amountNet, 0)\n        : toNumber(adj.amountGross, 0),\n    currencyCode: (adj.currencyCode || params.currencyCode || '').toUpperCase() || params.currencyCode,\n    metadata: adj.metadata ?? null,\n    position: 10_000 + index,\n  }))\n}\n\nfunction mergeMetadata(\n  base: Record<string, unknown> | undefined,\n  key: string,\n  value: unknown\n): Record<string, unknown> {\n  const next = { ...(base ?? {}) }\n  next[key] = value\n  return next\n}\n\nfunction applyProviderResult(\n  current: SalesDocumentCalculationResult,\n  adjustments: SalesAdjustmentDraft[],\n  providerKey: string,\n  calculatorKey: string,\n  result: ProviderAdjustmentResult | null | undefined,\n  defaultKind: SalesAdjustmentDraft['kind']\n): SalesDocumentCalculationResult {\n  if (!result?.adjustments?.length) {\n    return rebuildDocumentResult({\n      documentKind: current.kind,\n      currencyCode: current.currencyCode,\n      lines: current.lines,\n      adjustments,\n      metadata: current.metadata,\n    })\n  }\n  const normalized = normalizeAdjustments({\n    providerKey,\n    calculatorKey,\n    adjustments: result.adjustments,\n    currencyCode: current.currencyCode,\n    defaultKind,\n  })\n  const nextAdjustments = [...adjustments, ...normalized]\n  const next = rebuildDocumentResult({\n    documentKind: current.kind,\n    currencyCode: current.currencyCode,\n    lines: current.lines,\n    adjustments: nextAdjustments,\n    metadata: current.metadata,\n  })\n  if (result.metadata) {\n    next.metadata = mergeMetadata(next.metadata, calculatorKey, result.metadata)\n  }\n  return next\n}\n\nexport function ensureProviderTotalsCalculator() {\n  if (totalsRegistered) return\n  totalsRegistered = true\n\n  registerSalesTotalsCalculator(async ({ documentKind, lines, context, current, eventBus, totalsMode }) => {\n    // A provider charge here could not move the caller's header, so it would show\n    // in the breakdown and be absent from the total.\n    if (isExternalAmountsMode(totalsMode)) return current\n    const metadata = (context.metadata ?? {}) as Record<string, unknown>\n    const shippingMethod = (metadata.shippingMethod ?? null) as ShippingMethodContext | null\n    const paymentMethod = (metadata.paymentMethod ?? null) as PaymentMethodContext | null\n\n    let runningAdjustments = (current.adjustments ?? []).filter(\n      (adj) => !isProviderAdjustment(adj) || isManualOverride(adj)\n    )\n    let working = rebuildDocumentResult({\n      documentKind,\n      currencyCode: current.currencyCode,\n      lines,\n      adjustments: runningAdjustments,\n      metadata: current.metadata,\n    })\n\n    if (shippingMethod?.providerKey) {\n      const provider = getShippingProvider(shippingMethod.providerKey)\n      if (provider?.calculate) {\n        const calculatorKey = `${SHIPPING_PREFIX}${provider.key}`\n        const hasManualOverride = runningAdjustments.some(\n          (adj) => (adj.calculatorKey ?? '').startsWith(calculatorKey) && isManualOverride(adj)\n        )\n        if (hasManualOverride) {\n          // Respect user overrides: keep existing provider-tagged adjustments and skip regeneration.\n          working = rebuildDocumentResult({\n            documentKind,\n            currencyCode: working.currencyCode,\n            lines: working.lines,\n            adjustments: runningAdjustments,\n            metadata: working.metadata,\n          })\n        } else {\n          const rawSettings = extractProviderSettings(shippingMethod)\n          const settings =\n            normalizeProviderSettings('shipping', provider.key, rawSettings) ?? rawSettings ?? {}\n          const metrics = computeMetrics(working.lines)\n          let result = await provider.calculate({\n            method: shippingMethod,\n            settings,\n            document: working,\n            lines: working.lines,\n            context,\n            metrics,\n          })\n          if (eventBus) {\n            await eventBus.emitEvent('sales.shipping.adjustments.apply.before', {\n              documentKind,\n              providerKey: provider.key,\n              calculatorKey,\n              method: shippingMethod,\n              settings,\n              document: working,\n              result,\n              setResult(next: ProviderAdjustmentResult | null | undefined) {\n                result = next ?? null\n              },\n            })\n          }\n          working = applyProviderResult(working, runningAdjustments, provider.key, calculatorKey, result, 'shipping')\n          runningAdjustments = working.adjustments\n          if (eventBus) {\n            let nextDocument = working\n            await eventBus.emitEvent('sales.shipping.adjustments.apply.after', {\n              documentKind,\n              providerKey: provider.key,\n              calculatorKey,\n              method: shippingMethod,\n              settings,\n              document: nextDocument,\n              adjustments: nextDocument.adjustments.filter((adj) =>\n                (adj.calculatorKey ?? '').startsWith(calculatorKey)\n              ),\n              setDocument(next: SalesDocumentCalculationResult | null | undefined) {\n                if (next) {\n                  nextDocument = next\n                }\n              },\n              setAdjustments(next: SalesAdjustmentDraft[] | null | undefined) {\n                if (!next) return\n                const preserved = nextDocument.adjustments.filter(\n                  (adj) => !(adj.calculatorKey ?? '').startsWith(calculatorKey)\n                )\n                nextDocument = rebuildDocumentResult({\n                  documentKind,\n                  currencyCode: nextDocument.currencyCode,\n                  lines: nextDocument.lines,\n                  adjustments: [...preserved, ...next],\n                  metadata: nextDocument.metadata,\n                })\n              },\n            })\n            working = nextDocument\n            runningAdjustments = working.adjustments\n          }\n        }\n      }\n    }\n\n    if (paymentMethod?.providerKey) {\n      const provider = getPaymentProvider(paymentMethod.providerKey)\n      if (provider?.calculate) {\n        const calculatorKey = `${PAYMENT_PREFIX}${provider.key}`\n        const hasManualOverride = runningAdjustments.some(\n          (adj) => (adj.calculatorKey ?? '').startsWith(calculatorKey) && isManualOverride(adj)\n        )\n        if (hasManualOverride) {\n          working = rebuildDocumentResult({\n            documentKind,\n            currencyCode: working.currencyCode,\n            lines: working.lines,\n            adjustments: runningAdjustments,\n            metadata: working.metadata,\n          })\n        } else {\n          runningAdjustments = withoutPrefix(runningAdjustments, PAYMENT_PREFIX)\n          const rawSettings = extractProviderSettings(paymentMethod)\n          const settings =\n            normalizeProviderSettings('payment', provider.key, rawSettings) ?? rawSettings ?? {}\n          let result = await provider.calculate({\n            method: paymentMethod,\n            settings,\n            document: working,\n            lines: working.lines,\n            context,\n          })\n          if (eventBus) {\n            await eventBus.emitEvent('sales.payment.adjustments.apply.before', {\n              documentKind,\n              providerKey: provider.key,\n              calculatorKey,\n              method: paymentMethod,\n              settings,\n              document: working,\n              result,\n              setResult(next: ProviderAdjustmentResult | null | undefined) {\n                result = next ?? null\n              },\n            })\n          }\n          working = applyProviderResult(\n            working,\n            runningAdjustments,\n            provider.key,\n            calculatorKey,\n            result,\n            'surcharge'\n          )\n          runningAdjustments = working.adjustments\n          if (eventBus) {\n            let nextDocument = working\n            await eventBus.emitEvent('sales.payment.adjustments.apply.after', {\n              documentKind,\n              providerKey: provider.key,\n              calculatorKey,\n              method: paymentMethod,\n              settings,\n              document: nextDocument,\n              adjustments: nextDocument.adjustments.filter((adj) =>\n                (adj.calculatorKey ?? '').startsWith(calculatorKey)\n              ),\n              setDocument(next: SalesDocumentCalculationResult | null | undefined) {\n                if (next) {\n                  nextDocument = next\n                }\n              },\n              setAdjustments(next: SalesAdjustmentDraft[] | null | undefined) {\n                if (!next) return\n                const preserved = nextDocument.adjustments.filter(\n                  (adj) => !(adj.calculatorKey ?? '').startsWith(calculatorKey)\n                )\n                nextDocument = rebuildDocumentResult({\n                  documentKind,\n                  currencyCode: nextDocument.currencyCode,\n                  lines: nextDocument.lines,\n                  adjustments: [...preserved, ...next],\n                  metadata: nextDocument.metadata,\n                })\n              },\n            })\n            working = nextDocument\n            runningAdjustments = working.adjustments\n          }\n        }\n      }\n    }\n\n    return working\n  })\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/sales/migrations/Migration20260910120000_sales_external_amounts_mode.js

@@ -0,0 +1,19 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260910120000_sales_external_amounts_mode extends Migration {
+  async up() {
+    this.addSql(
+      `alter table "sales_orders" add column if not exists "totals_mode" text not null default 'computed';`
+    );
+    this.addSql(
+      `alter table "sales_order_lines" add column if not exists "amounts_mode" text not null default 'computed';`
+    );
+  }
+  async down() {
+    this.addSql(`alter table "sales_order_lines" drop column if exists "amounts_mode";`);
+    this.addSql(`alter table "sales_orders" drop column if exists "totals_mode";`);
+  }
+}
+export {
+  Migration20260910120000_sales_external_amounts_mode
+};
+//# sourceMappingURL=Migration20260910120000_sales_external_amounts_mode.js.map

package/dist/modules/sales/migrations/Migration20260910120000_sales_external_amounts_mode.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/sales/migrations/Migration20260910120000_sales_external_amounts_mode.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\n// Opt-in `external` amounts mode for sales orders: the row-level statement that\n// the stored amounts are a caller's assertion mirrored from an external book of\n// record, not something core derived. Two defaulted columns, no backfill \u2014 every\n// existing row takes 'computed', which is exactly today's behaviour, so the\n// change is observably inert until a caller sets the mode.\n//\n// PostgreSQL has not rewritten a table for a defaulted column add since 11, so\n// both statements are metadata-only regardless of table size.\nexport class Migration20260910120000_sales_external_amounts_mode extends Migration {\n  override async up(): Promise<void> {\n    this.addSql(\n      `alter table \"sales_orders\" add column if not exists \"totals_mode\" text not null default 'computed';`,\n    );\n    this.addSql(\n      `alter table \"sales_order_lines\" add column if not exists \"amounts_mode\" text not null default 'computed';`,\n    );\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`alter table \"sales_order_lines\" drop column if exists \"amounts_mode\";`);\n    this.addSql(`alter table \"sales_orders\" drop column if exists \"totals_mode\";`);\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAUnB,MAAM,4DAA4D,UAAU;AAAA,EACjF,MAAe,KAAoB;AACjC,SAAK;AAAA,MACH;AAAA,IACF;AACA,SAAK;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,uEAAuE;AACnF,SAAK,OAAO,iEAAiE;AAAA,EAC/E;AACF;",
+  "names": []
+}

package/generated/entities/sales_order/index.ts

@@ -43,6 +43,7 @@ export const totals_snapshot = "totals_snapshot";
 export const paid_total_amount = "paid_total_amount";
 export const refunded_total_amount = "refunded_total_amount";
 export const outstanding_amount = "outstanding_amount";
+export const totals_mode = "totals_mode";
 export const line_item_count = "line_item_count";
 export const metadata = "metadata";
 export const custom_field_set_id = "custom_field_set_id";

package/generated/entities/sales_order_line/index.ts

@@ -30,6 +30,7 @@ export const tax_rate = "tax_rate";
 export const tax_amount = "tax_amount";
 export const total_net_amount = "total_net_amount";
 export const total_gross_amount = "total_gross_amount";
+export const amounts_mode = "amounts_mode";
 export const configuration = "configuration";
 export const promotion_code = "promotion_code";
 export const promotion_snapshot = "promotion_snapshot";

package/generated/entity-fields-registry.ts

@@ -3054,6 +3054,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
       "paid_total_amount": "paid_total_amount",
       "refunded_total_amount": "refunded_total_amount",
       "outstanding_amount": "outstanding_amount",
+      "totals_mode": "totals_mode",
       "line_item_count": "line_item_count",
       "metadata": "metadata",
       "custom_field_set_id": "custom_field_set_id",
@@ -3136,6 +3137,7 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
       "tax_amount": "tax_amount",
       "total_net_amount": "total_net_amount",
       "total_gross_amount": "total_gross_amount",
+      "amounts_mode": "amounts_mode",
       "configuration": "configuration",
       "promotion_code": "promotion_code",
       "promotion_snapshot": "promotion_snapshot",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.10.1-develop.7722.1.901c72b9e9",
+  "version": "0.10.1-develop.7724.1.95e4e7d38e",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -265,16 +265,16 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.10.1-develop.7722.1.901c72b9e9",
-    "@open-mercato/shared": "0.10.1-develop.7722.1.901c72b9e9",
-    "@open-mercato/ui": "0.10.1-develop.7722.1.901c72b9e9",
+    "@open-mercato/ai-assistant": "0.10.1-develop.7724.1.95e4e7d38e",
+    "@open-mercato/shared": "0.10.1-develop.7724.1.95e4e7d38e",
+    "@open-mercato/ui": "0.10.1-develop.7724.1.95e4e7d38e",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.10.1-develop.7722.1.901c72b9e9",
-    "@open-mercato/shared": "0.10.1-develop.7722.1.901c72b9e9",
-    "@open-mercato/ui": "0.10.1-develop.7722.1.901c72b9e9",
+    "@open-mercato/ai-assistant": "0.10.1-develop.7724.1.95e4e7d38e",
+    "@open-mercato/shared": "0.10.1-develop.7724.1.95e4e7d38e",
+    "@open-mercato/ui": "0.10.1-develop.7724.1.95e4e7d38e",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",

package/src/modules/sales/api/documents/factory.ts

@@ -424,6 +424,7 @@ export function buildDocumentCrudOptions(binding: DocumentBinding) {
 
   const orderOnlyFields = [
     'expected_delivery_at',
+    'totals_mode',
     'shipping_net_amount',
     'shipping_gross_amount',
     'surcharge_total_amount',
@@ -535,6 +536,7 @@ export function buildDocumentCrudOptions(binding: DocumentBinding) {
           paidTotalAmount: toNumber(item.paid_total_amount),
           refundedTotalAmount: toNumber(item.refunded_total_amount),
           outstandingAmount: toNumber(item.outstanding_amount),
+          ...(binding.kind === 'order' ? { totalsMode: item.totals_mode ?? 'computed' } : {}),
           customerSnapshot: normalizeJsonRecord(item.customer_snapshot),
           billingAddressSnapshot: normalizeJsonRecord(item.billing_address_snapshot),
           shippingAddressSnapshot: normalizeJsonRecord(item.shipping_address_snapshot),
@@ -665,6 +667,7 @@ export function buildDocumentOpenApi(binding: DocumentBinding) {
     paidTotalAmount: z.number().nullable().optional(),
     refundedTotalAmount: z.number().nullable().optional(),
     outstandingAmount: z.number().nullable().optional(),
+    totalsMode: z.enum(['computed', 'external']).optional(),
     createdAt: z.string(),
     updatedAt: z.string(),
     customFields: z.record(z.string(), z.unknown()).optional(),

package/src/modules/sales/api/order-lines/route.ts

@@ -1,5 +1,5 @@
 import { SalesOrderLine } from "../../data/entities";
-import { orderLineCreateSchema } from "../../data/validators";
+import { orderHeaderTotalsSchema, orderLineCreateSchema } from "../../data/validators";
 import { E } from "#generated/entities.ids.generated";
 import * as F from "#generated/entities/sales_order_line";
 import { makeSalesLineRoute } from "../../lib/makeSalesLineRoute";
@@ -11,6 +11,7 @@ const route = makeSalesLineRoute({
   parentFkColumn: "order_id",
   parentFkParam: "orderId",
   createSchema: orderLineCreateSchema,
+  writeExtensionShape: { orderTotals: orderHeaderTotalsSchema.optional() },
   features: { view: "sales.orders.view", manage: "sales.orders.manage" },
   commandPrefix: "sales.orders.lines",
   openApi: {

package/src/modules/sales/backend/sales/documents/[id]/page.tsx

@@ -77,6 +77,7 @@ import { useGuardedMutation } from '@open-mercato/ui/backend/injection/useGuarde
 import { buildRecordInjectionContext, useSetCurrentRecordInjectionContext } from '@open-mercato/ui/backend/injection/recordContext'
 import { useSalesChannelsEnabled } from '@open-mercato/core/modules/sales/components/useSalesChannelsEnabled'
 import { createLogger } from '@open-mercato/shared/lib/logger'
+import { getTelemetryRuntime } from '@open-mercato/shared/lib/telemetry/runtime'
 
 const logger = createLogger('sales')
 
@@ -899,6 +900,7 @@ type DocumentRecord = {
   paidTotalAmount?: number | null
   refundedTotalAmount?: number | null
   outstandingAmount?: number | null
+  totalsMode?: 'computed' | 'external' | null
   createdAt?: string
   updatedAt?: string
   metadata?: Record<string, unknown> | null
@@ -1478,6 +1480,7 @@ function MethodInlineEditor({
   emptyResultsLabel,
   selectedHint,
   icon,
+  note,
   allowClear = true,
 }: {
   label: string
@@ -1494,6 +1497,7 @@ function MethodInlineEditor({
   emptyResultsLabel: string
   selectedHint: (id: string) => string
   icon: React.ReactNode
+  note?: string | null
   allowClear?: boolean
 }) {
   const t = useT()
@@ -1607,6 +1611,7 @@ function MethodInlineEditor({
       <div className="flex items-start justify-between gap-2">
         <div className="flex-1 min-w-0">
           <p className="text-xs uppercase tracking-wide text-muted-foreground">{label}</p>
+          {note ? <p className="mt-1 text-xs text-muted-foreground">{note}</p> : null}
           {editing ? (
             <div
               className="mt-2 space-y-2"
@@ -1937,6 +1942,7 @@ export default function SalesDocumentDetailPage({
   const [generating, setGenerating] = React.useState(false)
   const [converting, setConverting] = React.useState(false)
   const [deleting, setDeleting] = React.useState(false)
+  const [switchingToComputedAmounts, setSwitchingToComputedAmounts] = React.useState(false)
   const [sending, setSending] = React.useState(false)
   const [sendOpen, setSendOpen] = React.useState(false)
   const [validForDays, setValidForDays] = React.useState(DEFAULT_QUOTE_VALID_FOR_DAYS)
@@ -2844,6 +2850,8 @@ export default function SalesDocumentDetailPage({
     },
     [t]
   )
+  const amountsAreExternal = kind === 'order' && record?.totalsMode === 'external'
+
   const totalsItems = React.useMemo(() => {
     if (!record) return []
     const items: { key: string; label: string; amount: number | null | undefined; emphasize?: boolean }[] = [
@@ -3791,6 +3799,48 @@ export default function SalesDocumentDetailPage({
     }
   }, [fetchDocumentByKind, kind, record, runMutationWithContext, t, validForDays])
 
+  const handleSwitchToComputedAmounts = React.useCallback(async () => {
+    if (!record || kind !== 'order') return
+    const ok = await confirm({
+      title: t(
+        'sales.documents.amountsSwitchConfirm',
+        'Recompute this order\u2019s amounts from its lines? The totals supplied by the source system will be replaced and cannot be restored from here.',
+      ),
+      variant: 'default',
+    })
+    if (!ok) return
+    setSwitchingToComputedAmounts(true)
+    try {
+      await runMutationWithContext(async () => {
+        await withScopedApiRequestHeaders(buildOptimisticLockHeader(record.updatedAt), () =>
+          apiCallOrThrow('/api/sales/orders', {
+            method: 'PUT',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ id: record.id, totalsMode: 'computed' }),
+          }),
+        )
+      }, { id: record.id, totalsMode: 'computed' })
+      flash(t('sales.documents.amountsSwitchDone', 'Amounts are now computed from the lines.'), 'success')
+      await refreshDocumentTotals()
+    } catch (err) {
+      logger.error('sales.documents.amounts.switchToComputed', { err })
+      try {
+        getTelemetryRuntime()?.reportError(err, {
+          module: 'sales',
+          code: 'sales.amounts_switch_to_computed_failed',
+          attributes: { orderId: record.id },
+        })
+      } catch (reportFailure) {
+        logger.warn('sales.documents.amounts.switchToComputed.reportFailed', { err: reportFailure })
+      }
+      if (!handleDocumentMutationError(err, t, () => setReloadKey((prev) => prev + 1))) {
+        flash(t('sales.documents.amountsSwitchFailed', 'Could not switch to computed amounts.'), 'error')
+      }
+    } finally {
+      setSwitchingToComputedAmounts(false)
+    }
+  }, [confirm, kind, record, refreshDocumentTotals, runMutationWithContext, t])
+
   const handleDelete = React.useCallback(async () => {
     if (!record) return
     const ok = await confirm({
@@ -3851,6 +3901,14 @@ export default function SalesDocumentDetailPage({
               t('sales.documents.detail.shippingMethod.selected', 'Selected shipping method: {{id}}', { id })
             }
             icon={<Truck className="h-5 w-5 text-muted-foreground" />}
+            note={
+              amountsAreExternal
+                ? t(
+                    'sales.documents.amountsExternalMethodNote',
+                    'The method is recorded, but no charge is added \u2014 this order\u2019s totals come from the source system.',
+                  )
+                : null
+            }
           />
         ),
       },
@@ -3877,6 +3935,14 @@ export default function SalesDocumentDetailPage({
               t('sales.documents.detail.paymentMethod.selected', 'Selected payment method: {{id}}', { id })
             }
             icon={<CreditCard className="h-5 w-5 text-muted-foreground" />}
+            note={
+              amountsAreExternal
+                ? t(
+                    'sales.documents.amountsExternalMethodNote',
+                    'The method is recorded, but no charge is added \u2014 this order\u2019s totals come from the source system.',
+                  )
+                : null
+            }
           />
         ),
       },
@@ -3949,6 +4015,7 @@ export default function SalesDocumentDetailPage({
     )
     return fields
   }, [
+    amountsAreExternal,
     handleUpdateComment,
     handleUpdateCustomerReference,
     handleUpdateExpectedDeliveryAt,
@@ -4266,6 +4333,9 @@ export default function SalesDocumentDetailPage({
     if (activeTab === 'items') {
       return (
         <SalesDocumentItemsSection
+          // Remount on a mode flip: the switch rewrites every line server-side, and the
+          // section loads its lines only once per `documentId`, which does not change.
+          key={`items:${amountsAreExternal ? 'external' : 'computed'}`}
           documentId={record.id}
           kind={kind}
           currencyCode={record.currencyCode ?? null}
@@ -4274,6 +4344,7 @@ export default function SalesDocumentDetailPage({
           tenantId={(record as any)?.tenantId ?? (record as any)?.tenant_id ?? null}
           onActionChange={handleSectionActionChange}
           onItemsChange={(items) => setHasItems(items.length > 0)}
+          amountsReadOnly={amountsAreExternal}
         />
       )
     }
@@ -4332,6 +4403,7 @@ export default function SalesDocumentDetailPage({
           tenantId={(record as any)?.tenantId ?? (record as any)?.tenant_id ?? null}
           onActionChange={handleSectionActionChange}
           onRowsChange={setAdjustmentRows}
+          amountsReadOnly={amountsAreExternal}
         />
       )
     }
@@ -4914,6 +4986,30 @@ export default function SalesDocumentDetailPage({
           title={t('sales.documents.detail.totals.title', 'Totals')}
           currency={record.currencyCode ?? null}
           items={totalsItems}
+          sourceBadge={
+            amountsAreExternal
+              ? {
+                  label: t('sales.documents.amountsExternal', 'Amounts from source'),
+                  hint: t(
+                    'sales.documents.amountsExternalHint',
+                    'Totals on this document come from an external system and are stored as supplied.',
+                  ),
+                }
+              : null
+          }
+          footerAction={
+            amountsAreExternal ? (
+              <Button
+                type="button"
+                variant="outline"
+                size="sm"
+                disabled={switchingToComputedAmounts}
+                onClick={handleSwitchToComputedAmounts}
+              >
+                {t('sales.documents.amountsSwitchToComputed', 'Switch to computed amounts')}
+              </Button>
+            ) : null
+          }
         />
 
         <div className="space-y-4" ref={detailSectionRef}>