@open-mercato/core 0.6.7-develop.6552.1.5208a19369 → 0.6.7-develop.6565.1.1026d85fff

package/dist/modules/sales/lib/calculations.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/sales/lib/calculations.ts"],
-  "sourcesContent": ["import {\n  type SalesAdjustmentDraft,\n  type SalesCalculationContext,\n  type CalculateDocumentOptions,\n  type CalculateLineOptions,\n  type SalesDocumentCalculationResult,\n  type SalesDocumentKind,\n  type SalesLineCalculationHook,\n  type SalesLineCalculationResult,\n  type SalesLineSnapshot,\n  type SalesTotalsCalculationHook,\n} from './types'\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 round(value: number): number {\n  return Math.round((value + Number.EPSILON) * 1e4) / 1e4\n}\n\nfunction extractAdjustmentTaxRate(adjustment: SalesAdjustmentDraft): number | null {\n  const metadata = (adjustment.metadata ?? {}) as Record<string, unknown>\n  const candidate =\n    metadata.taxRate ??\n    (metadata as any)?.tax_rate ??\n    (metadata as any)?.taxRateValue ??\n    (metadata as any)?.tax_rate_value ??\n    null\n  const parsed = toNumber(candidate, NaN)\n  return Number.isFinite(parsed) ? parsed : null\n}\n\nfunction resolveAdjustmentAmounts(\n  adjustments: SalesAdjustmentDraft[],\n  baseNet: number,\n  baseGross: number\n): SalesAdjustmentDraft[] {\n  return adjustments.map((adj) => {\n    const rate = toNumber(adj.rate, NaN)\n    const taxRate = extractAdjustmentTaxRate(adj)\n    const hasAmountNet = Number.isFinite(toNumber(adj.amountNet, NaN))\n    const hasAmountGross = Number.isFinite(toNumber(adj.amountGross, NaN))\n    const hasRate = Number.isFinite(rate) && !hasAmountNet && !hasAmountGross\n    const hasTaxRate = taxRate !== null\n    let amountNet = toNumber(adj.amountNet, NaN)\n    let amountGross = toNumber(adj.amountGross, NaN)\n\n    if (hasRate) {\n      const multiplier = (rate as number) / 100\n      amountNet = round(Math.max(baseNet, 0) * multiplier)\n      if (adj.kind === 'tax') {\n        amountGross = amountNet\n      } else if (hasTaxRate) {\n        amountGross = round(amountNet * (1 + (taxRate as number) / 100))\n      } else {\n        amountGross = round(Math.max(baseGross, 0) * multiplier)\n      }\n    } else {\n      if (!Number.isFinite(amountNet) && Number.isFinite(amountGross) && hasTaxRate) {\n        amountNet = round((amountGross as number) / (1 + (taxRate as number) / 100))\n      }\n      if (!Number.isFinite(amountGross) && Number.isFinite(amountNet) && hasTaxRate) {\n        amountGross = round((amountNet as number) * (1 + (taxRate as number) / 100))\n      }\n    }\n\n    return {\n      ...adj,\n      amountNet: Number.isFinite(amountNet) ? amountNet : adj.amountNet,\n      amountGross: Number.isFinite(amountGross) ? amountGross : adj.amountGross,\n    }\n  })\n}\n\nfunction buildBaseLineResult(line: SalesLineSnapshot): SalesLineCalculationResult {\n  const quantity = Math.max(toNumber(line.quantity, 0), 0)\n  const taxRate = toNumber(line.taxRate, 0) / 100\n  const unitNet =\n    line.unitPriceNet ??\n    (line.unitPriceGross !== null && line.unitPriceGross !== undefined\n      ? toNumber(line.unitPriceGross) / (1 + taxRate)\n      : 0)\n  const discountPerUnit =\n    line.discountAmount ??\n    (line.discountPercent !== null && line.discountPercent !== undefined\n      ? toNumber(line.discountPercent, 0) / 100 * toNumber(unitNet, 0)\n      : 0)\n\n  const netSubtotalBeforeDiscount = toNumber(unitNet, 0) * quantity\n  const discountTotal = Math.min(Math.max(discountPerUnit * quantity, 0), netSubtotalBeforeDiscount)\n  const netSubtotal = Math.max(netSubtotalBeforeDiscount - discountTotal, 0)\n  const explicitTaxAmount = line.taxAmount !== null && line.taxAmount !== undefined\n  let taxAmount = explicitTaxAmount\n    ? toNumber(line.taxAmount, 0)\n    : round(netSubtotal * Math.max(taxRate, 0))\n  const grossSubtotal =\n    line.totalGrossAmount !== null && line.totalGrossAmount !== undefined\n      ? toNumber(line.totalGrossAmount, 0)\n      : round(netSubtotal + taxAmount)\n  // When tax was not supplied explicitly and the rate-derived tax is zero but\n  // the gross total already embeds tax (gross > net) \u2014 e.g. a tax-class-priced\n  // line whose resolved rate was not persisted \u2014 derive the tax from the\n  // net/gross delta so the document-level tax total is not silently zeroed\n  // while per-line net/gross stay correct (#2457).\n  if (!explicitTaxAmount && taxAmount <= 0) {\n    const grossNetDelta = round(grossSubtotal - netSubtotal)\n    if (grossNetDelta > 0) taxAmount = grossNetDelta\n  }\n\n  return {\n    line,\n    netAmount: round(netSubtotal),\n    grossAmount: round(grossSubtotal),\n    taxAmount: round(taxAmount),\n    discountAmount: round(discountTotal),\n    adjustments: [],\n  }\n}\n\nfunction buildBaseDocumentResult(params: {\n  documentKind: SalesDocumentKind\n  lines: SalesLineCalculationResult[]\n  adjustments: SalesAdjustmentDraft[]\n  currencyCode: string\n  existingTotals?: { paidTotalAmount?: number | null; refundedTotalAmount?: number | null }\n}): SalesDocumentCalculationResult {\n  const { documentKind, lines, adjustments, currencyCode } = params\n  const orderedAdjustments = [...(adjustments ?? [])].sort(\n    (a, b) => (a.position ?? 0) - (b.position ?? 0)\n  )\n  let baseSubtotalNet = 0\n  let baseSubtotalGross = 0\n  let subtotalNet = 0\n  let subtotalGross = 0\n  let discountTotal = 0\n  let taxTotal = 0\n  let shippingNet = 0\n  let shippingGross = 0\n  let surchargeTotal = 0\n\n  for (const line of lines) {\n    const net = toNumber(line.netAmount, 0)\n    const gross = toNumber(line.grossAmount, 0)\n    subtotalNet += net\n    subtotalGross += gross\n    baseSubtotalNet += net\n    baseSubtotalGross += gross\n    discountTotal += toNumber(line.discountAmount, 0)\n    taxTotal += toNumber(line.taxAmount, 0)\n  }\n\n  const resolvedAdjustments = resolveAdjustmentAmounts(orderedAdjustments, baseSubtotalNet, baseSubtotalGross)\n  const scopedAdjustments = resolvedAdjustments.filter(\n    (adj) => !adj.scope || adj.scope === 'order'\n  )\n\n  for (const adj of scopedAdjustments) {\n    const rawNet = toNumber(adj.amountNet, toNumber(adj.amountGross))\n    const rawGross = toNumber(adj.amountGross, rawNet)\n    // Each adjustment kind has an intrinsic sign convention. The API edge\n    // (enforceAdjustmentSign) rejects values that would invert the kind's\n    // semantic effect, but the calculation engine normalizes defensively so\n    // direct DB writes or seeded data can't inflate the grand total either.\n    // See #1905 (mirrors the existing return normalization a few lines below\n    // introduced for #1705).\n    const isNonNegativeKind =\n      adj.kind === 'discount' ||\n      adj.kind === 'surcharge' ||\n      adj.kind === 'shipping' ||\n      adj.kind === 'tax'\n    const net = isNonNegativeKind ? Math.abs(rawNet) : rawNet\n    const gross = isNonNegativeKind ? Math.abs(rawGross) : rawGross\n    const taxRate = extractAdjustmentTaxRate(adj)\n    const taxPortion = taxRate !== null ? round(gross - net) : 0\n    switch (adj.kind) {\n      case 'discount':\n        discountTotal += net\n        subtotalNet = Math.max(subtotalNet - net, 0)\n        subtotalGross = Math.max(subtotalGross - gross, 0)\n        if (taxPortion) {\n          taxTotal = round(taxTotal - taxPortion)\n        }\n        break\n      case 'tax':\n        taxTotal += gross || net\n        subtotalGross += gross || net\n        break\n      case 'shipping':\n        shippingNet += net\n        shippingGross += gross\n        subtotalNet += net\n        subtotalGross += gross\n        if (taxPortion) {\n          taxTotal += taxPortion\n        }\n        break\n      case 'surcharge':\n        surchargeTotal += net || gross\n        subtotalNet += net || gross\n        subtotalGross += gross || net\n        if (taxPortion) {\n          taxTotal += taxPortion\n        }\n        break\n      default:\n        break\n    }\n  }\n\n  // Line-scoped and any other return (credit) adjustments reduce grand total.\n  // Sign is normalized to negative regardless of the stored sign so a positive\n  // amountNet / amountGross can never inflate totals (issue #1705).\n  for (const adj of resolvedAdjustments) {\n    if (adj.kind !== 'return') continue\n    const net = toNumber(adj.amountNet, toNumber(adj.amountGross))\n    const gross = toNumber(adj.amountGross, net)\n    const netDelta = -Math.abs(net)\n    const grossDelta = -Math.abs(gross)\n    subtotalNet = Math.max(subtotalNet + netDelta, 0)\n    subtotalGross = Math.max(subtotalGross + grossDelta, 0)\n  }\n\n  const grandTotalNet = round(subtotalNet)\n  const grandTotalGross = round(subtotalGross)\n  const paidTotalAmount = Math.max(toNumber(params.existingTotals?.paidTotalAmount, 0), 0)\n  const refundedTotalAmount = Math.max(toNumber(params.existingTotals?.refundedTotalAmount, 0), 0)\n  const outstandingAmount = Math.max(grandTotalGross - paidTotalAmount + refundedTotalAmount, 0)\n\n  return {\n    kind: documentKind,\n    currencyCode,\n    lines,\n    adjustments: resolvedAdjustments,\n    metadata: {},\n    totals: {\n      subtotalNetAmount: round(subtotalNet),\n      subtotalGrossAmount: round(subtotalGross),\n      discountTotalAmount: round(discountTotal),\n      taxTotalAmount: round(taxTotal),\n      shippingNetAmount: round(shippingNet),\n      shippingGrossAmount: round(shippingGross),\n      surchargeTotalAmount: round(surchargeTotal),\n      grandTotalNetAmount: grandTotalNet,\n      grandTotalGrossAmount: grandTotalGross,\n      paidTotalAmount,\n      refundedTotalAmount,\n      outstandingAmount,\n    },\n  }\n}\n\nclass SalesCalculationRegistry {\n  private lineCalculators: SalesLineCalculationHook[] = []\n  private totalsCalculators: SalesTotalsCalculationHook[] = []\n\n  registerLineCalculator(hook: SalesLineCalculationHook, opts?: { prepend?: boolean }): () => void {\n    if (opts?.prepend) this.lineCalculators.unshift(hook)\n    else this.lineCalculators.push(hook)\n    return () => {\n      this.lineCalculators = this.lineCalculators.filter((item) => item !== hook)\n    }\n  }\n\n  registerTotalsCalculator(hook: SalesTotalsCalculationHook, opts?: { prepend?: boolean }): () => void {\n    if (opts?.prepend) this.totalsCalculators.unshift(hook)\n    else this.totalsCalculators.push(hook)\n    return () => {\n      this.totalsCalculators = this.totalsCalculators.filter((item) => item !== hook)\n    }\n  }\n\n  async calculateLine(opts: CalculateLineOptions): Promise<SalesLineCalculationResult> {\n    const { documentKind, line, context, eventBus } = opts\n    let current = buildBaseLineResult(line)\n\n    if (eventBus) {\n      await eventBus.emitEvent('sales.line.calculate.before', {\n        documentKind,\n        line,\n        context,\n        result: current,\n        setResult(next: SalesLineCalculationResult) {\n          current = next\n        },\n      })\n    }\n\n    for (const hook of this.lineCalculators) {\n      const next = await hook({ documentKind, line, context, current })\n      if (next) current = next\n    }\n\n    if (eventBus) {\n      await eventBus.emitEvent('sales.line.calculate.after', {\n        documentKind,\n        line,\n        context,\n        result: current,\n        setResult(next: SalesLineCalculationResult) {\n          current = next\n        },\n      })\n    }\n\n    return current\n  }\n\n  async calculateDocument(opts: CalculateDocumentOptions): Promise<SalesDocumentCalculationResult> {\n    const { documentKind, lines, adjustments = [], context, eventBus, existingTotals } = opts\n    const resolvedLines: SalesLineCalculationResult[] = []\n\n    for (const line of lines) {\n      const result = await this.calculateLine({ documentKind, line, context, eventBus })\n      resolvedLines.push(result)\n    }\n\n    let current = buildBaseDocumentResult({\n      documentKind,\n      lines: resolvedLines,\n      adjustments,\n      currencyCode: context.currencyCode,\n      existingTotals,\n    })\n\n    if (eventBus) {\n      await eventBus.emitEvent('sales.document.calculate.before', {\n        documentKind,\n        lines: resolvedLines,\n        context,\n        adjustments,\n        result: current,\n        setResult(next: SalesDocumentCalculationResult) {\n          current = next\n        },\n      })\n    }\n\n    for (const hook of this.totalsCalculators) {\n      const next = await hook({\n        documentKind,\n        lines: resolvedLines,\n        existingAdjustments: adjustments,\n        context,\n        current,\n        eventBus,\n      })\n      if (next) current = next\n    }\n\n    if (eventBus) {\n      await eventBus.emitEvent('sales.document.calculate.after', {\n        documentKind,\n        lines: resolvedLines,\n        context,\n        adjustments,\n        result: current,\n        setResult(next: SalesDocumentCalculationResult) {\n          current = next\n        },\n      })\n    }\n\n    // Payment totals (paid/refunded) are authoritative inputs, not derived from\n    // lines or adjustments. Totals calculators rebuild the document result from\n    // lines+adjustments and would otherwise reset paid/refunded to 0 (and\n    // outstanding back to the full grand total), producing a stale paid/\n    // outstanding display after a payment. Re-apply the input totals last and\n    // recompute outstanding against the post-calculation grand total.\n    if (existingTotals) {\n      const paidTotalAmount = Math.max(toNumber(existingTotals.paidTotalAmount, 0), 0)\n      const refundedTotalAmount = Math.max(toNumber(existingTotals.refundedTotalAmount, 0), 0)\n      current.totals = {\n        ...current.totals,\n        paidTotalAmount,\n        refundedTotalAmount,\n        outstandingAmount: round(\n          Math.max(current.totals.grandTotalGrossAmount - paidTotalAmount + refundedTotalAmount, 0)\n        ),\n      }\n    }\n\n    return current\n  }\n}\n\nexport function createSalesCalculationRegistry(): SalesCalculationRegistry {\n  return new SalesCalculationRegistry()\n}\n\nexport const salesCalculations = createSalesCalculationRegistry()\n\nexport async function calculateLine(\n  opts: CalculateLineOptions\n): Promise<SalesLineCalculationResult> {\n  return salesCalculations.calculateLine(opts)\n}\n\nexport async function calculateDocumentTotals(\n  opts: CalculateDocumentOptions\n): Promise<SalesDocumentCalculationResult> {\n  return salesCalculations.calculateDocument(opts)\n}\n\nexport function registerSalesLineCalculator(\n  hook: SalesLineCalculationHook,\n  opts?: { prepend?: boolean }\n): () => void {\n  return salesCalculations.registerLineCalculator(hook, opts)\n}\n\nexport function registerSalesTotalsCalculator(\n  hook: SalesTotalsCalculationHook,\n  opts?: { prepend?: boolean }\n): () => void {\n  return salesCalculations.registerTotalsCalculator(hook, opts)\n}\n\nexport function rebuildDocumentResult(params: {\n  documentKind: SalesDocumentKind\n  currencyCode: string\n  lines: SalesLineCalculationResult[]\n  adjustments: SalesAdjustmentDraft[]\n  metadata?: Record<string, unknown>\n}): SalesDocumentCalculationResult {\n  const result = buildBaseDocumentResult({\n    documentKind: params.documentKind,\n    lines: params.lines,\n    adjustments: params.adjustments,\n    currencyCode: params.currencyCode,\n  })\n  result.metadata = params.metadata ?? {}\n  return result\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  type SalesAdjustmentDraft,\n  type SalesCalculationContext,\n  type CalculateDocumentOptions,\n  type CalculateLineOptions,\n  type SalesDocumentCalculationResult,\n  type SalesDocumentKind,\n  type SalesLineCalculationHook,\n  type SalesLineCalculationResult,\n  type SalesLineSnapshot,\n  type SalesTotalsCalculationHook,\n} from './types'\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 round(value: number): number {\n  return Math.round((value + Number.EPSILON) * 1e4) / 1e4\n}\n\nfunction extractAdjustmentTaxRate(adjustment: SalesAdjustmentDraft): number | null {\n  const metadata = (adjustment.metadata ?? {}) as Record<string, unknown>\n  const candidate =\n    metadata.taxRate ??\n    (metadata as any)?.tax_rate ??\n    (metadata as any)?.taxRateValue ??\n    (metadata as any)?.tax_rate_value ??\n    null\n  const parsed = toNumber(candidate, NaN)\n  return Number.isFinite(parsed) ? parsed : null\n}\n\nfunction resolveAdjustmentAmounts(\n  adjustments: SalesAdjustmentDraft[],\n  baseNet: number,\n  baseGross: number\n): SalesAdjustmentDraft[] {\n  return adjustments.map((adj) => {\n    const rate = toNumber(adj.rate, NaN)\n    const taxRate = extractAdjustmentTaxRate(adj)\n    const hasAmountNet = Number.isFinite(toNumber(adj.amountNet, NaN))\n    const hasAmountGross = Number.isFinite(toNumber(adj.amountGross, NaN))\n    const hasRate = Number.isFinite(rate) && !hasAmountNet && !hasAmountGross\n    const hasTaxRate = taxRate !== null\n    let amountNet = toNumber(adj.amountNet, NaN)\n    let amountGross = toNumber(adj.amountGross, NaN)\n\n    if (hasRate) {\n      const multiplier = (rate as number) / 100\n      amountNet = round(Math.max(baseNet, 0) * multiplier)\n      if (adj.kind === 'tax') {\n        amountGross = amountNet\n      } else if (hasTaxRate) {\n        amountGross = round(amountNet * (1 + (taxRate as number) / 100))\n      } else {\n        amountGross = round(Math.max(baseGross, 0) * multiplier)\n      }\n    } else {\n      if (!Number.isFinite(amountNet) && Number.isFinite(amountGross) && hasTaxRate) {\n        amountNet = round((amountGross as number) / (1 + (taxRate as number) / 100))\n      }\n      if (!Number.isFinite(amountGross) && Number.isFinite(amountNet) && hasTaxRate) {\n        amountGross = round((amountNet as number) * (1 + (taxRate as number) / 100))\n      }\n    }\n\n    return {\n      ...adj,\n      amountNet: Number.isFinite(amountNet) ? amountNet : adj.amountNet,\n      amountGross: Number.isFinite(amountGross) ? amountGross : adj.amountGross,\n    }\n  })\n}\n\nfunction buildBaseLineResult(line: SalesLineSnapshot): SalesLineCalculationResult {\n  const quantity = Math.max(toNumber(line.quantity, 0), 0)\n  const taxRate = toNumber(line.taxRate, 0) / 100\n  const unitNet =\n    line.unitPriceNet ??\n    (line.unitPriceGross !== null && line.unitPriceGross !== undefined\n      ? toNumber(line.unitPriceGross) / (1 + taxRate)\n      : 0)\n  const discountPerUnit =\n    line.discountAmount ??\n    (line.discountPercent !== null && line.discountPercent !== undefined\n      ? toNumber(line.discountPercent, 0) / 100 * toNumber(unitNet, 0)\n      : 0)\n\n  const netSubtotalBeforeDiscount = toNumber(unitNet, 0) * quantity\n  const discountTotal = Math.min(Math.max(discountPerUnit * quantity, 0), netSubtotalBeforeDiscount)\n  const netSubtotal = Math.max(netSubtotalBeforeDiscount - discountTotal, 0)\n  const explicitTaxAmount = line.taxAmount !== null && line.taxAmount !== undefined\n  let taxAmount = explicitTaxAmount\n    ? toNumber(line.taxAmount, 0)\n    : round(netSubtotal * Math.max(taxRate, 0))\n  const grossSubtotal =\n    line.totalGrossAmount !== null && line.totalGrossAmount !== undefined\n      ? toNumber(line.totalGrossAmount, 0)\n      : round(netSubtotal + taxAmount)\n  // When tax was not supplied explicitly and the rate-derived tax is zero but\n  // the gross total already embeds tax (gross > net) \u2014 e.g. a tax-class-priced\n  // line whose resolved rate was not persisted \u2014 derive the tax from the\n  // net/gross delta so the document-level tax total is not silently zeroed\n  // while per-line net/gross stay correct (#2457).\n  if (!explicitTaxAmount && taxAmount <= 0) {\n    const grossNetDelta = round(grossSubtotal - netSubtotal)\n    if (grossNetDelta > 0) taxAmount = grossNetDelta\n  }\n\n  return {\n    line,\n    netAmount: round(netSubtotal),\n    grossAmount: round(grossSubtotal),\n    taxAmount: round(taxAmount),\n    discountAmount: round(discountTotal),\n    adjustments: [],\n  }\n}\n\nfunction buildBaseDocumentResult(params: {\n  documentKind: SalesDocumentKind\n  lines: SalesLineCalculationResult[]\n  adjustments: SalesAdjustmentDraft[]\n  currencyCode: string\n  existingTotals?: { paidTotalAmount?: number | null; refundedTotalAmount?: number | null }\n}): SalesDocumentCalculationResult {\n  const { documentKind, lines, adjustments, currencyCode } = params\n  const orderedAdjustments = [...(adjustments ?? [])].sort(\n    (a, b) => (a.position ?? 0) - (b.position ?? 0)\n  )\n  let baseSubtotalNet = 0\n  let baseSubtotalGross = 0\n  let subtotalNet = 0\n  let subtotalGross = 0\n  let discountTotal = 0\n  let taxTotal = 0\n  let shippingNet = 0\n  let shippingGross = 0\n  let surchargeTotal = 0\n\n  for (const line of lines) {\n    const net = toNumber(line.netAmount, 0)\n    const gross = toNumber(line.grossAmount, 0)\n    subtotalNet += net\n    subtotalGross += gross\n    baseSubtotalNet += net\n    baseSubtotalGross += gross\n    discountTotal += toNumber(line.discountAmount, 0)\n    taxTotal += toNumber(line.taxAmount, 0)\n  }\n\n  const resolvedAdjustments = resolveAdjustmentAmounts(orderedAdjustments, baseSubtotalNet, baseSubtotalGross)\n  const scopedAdjustments = resolvedAdjustments.filter(\n    (adj) => !adj.scope || adj.scope === 'order'\n  )\n\n  for (const adj of scopedAdjustments) {\n    const rawNet = toNumber(adj.amountNet, toNumber(adj.amountGross))\n    const rawGross = toNumber(adj.amountGross, rawNet)\n    // Each adjustment kind has an intrinsic sign convention. The API edge\n    // (enforceAdjustmentSign) rejects values that would invert the kind's\n    // semantic effect, but the calculation engine normalizes defensively so\n    // direct DB writes or seeded data can't inflate the grand total either.\n    // See #1905 (mirrors the existing return normalization a few lines below\n    // introduced for #1705).\n    const isNonNegativeKind =\n      adj.kind === 'discount' ||\n      adj.kind === 'surcharge' ||\n      adj.kind === 'shipping' ||\n      adj.kind === 'tax'\n    const net = isNonNegativeKind ? Math.abs(rawNet) : rawNet\n    const gross = isNonNegativeKind ? Math.abs(rawGross) : rawGross\n    const taxRate = extractAdjustmentTaxRate(adj)\n    const taxPortion = taxRate !== null ? round(gross - net) : 0\n    switch (adj.kind) {\n      case 'discount':\n        discountTotal += net\n        subtotalNet = Math.max(subtotalNet - net, 0)\n        subtotalGross = Math.max(subtotalGross - gross, 0)\n        if (taxPortion) {\n          taxTotal = round(taxTotal - taxPortion)\n        }\n        break\n      case 'tax':\n        taxTotal += gross || net\n        subtotalGross += gross || net\n        break\n      case 'shipping':\n        shippingNet += net\n        shippingGross += gross\n        subtotalNet += net\n        subtotalGross += gross\n        if (taxPortion) {\n          taxTotal += taxPortion\n        }\n        break\n      case 'surcharge':\n        surchargeTotal += net || gross\n        subtotalNet += net || gross\n        subtotalGross += gross || net\n        if (taxPortion) {\n          taxTotal += taxPortion\n        }\n        break\n      default:\n        // `return` (credit) adjustments are handled by the dedicated loop below;\n        // skip them here so an order-scoped return is not counted twice.\n        if (adj.kind === 'return') break\n        // Custom / operator-defined kinds carry an operator-controlled sign\n        // (positive adds, negative credits). Fold the raw signed amount into the\n        // grand total so a persisted adjustment can never be silently dropped\n        // from the headline total while still appearing in the itemized\n        // breakdown (#4052). No abs()/clamp here: unlike the sign-constrained\n        // kinds above, custom kinds are intentionally unconstrained\n        // (see enforceAdjustmentSign).\n        subtotalNet += net\n        subtotalGross += gross\n        if (taxPortion) {\n          taxTotal += taxPortion\n        }\n        break\n    }\n  }\n\n  // Line-scoped and any other return (credit) adjustments reduce grand total.\n  // Sign is normalized to negative regardless of the stored sign so a positive\n  // amountNet / amountGross can never inflate totals (issue #1705).\n  for (const adj of resolvedAdjustments) {\n    if (adj.kind !== 'return') continue\n    const net = toNumber(adj.amountNet, toNumber(adj.amountGross))\n    const gross = toNumber(adj.amountGross, net)\n    const netDelta = -Math.abs(net)\n    const grossDelta = -Math.abs(gross)\n    subtotalNet = Math.max(subtotalNet + netDelta, 0)\n    subtotalGross = Math.max(subtotalGross + grossDelta, 0)\n  }\n\n  const grandTotalNet = round(subtotalNet)\n  const grandTotalGross = round(subtotalGross)\n  const paidTotalAmount = Math.max(toNumber(params.existingTotals?.paidTotalAmount, 0), 0)\n  const refundedTotalAmount = Math.max(toNumber(params.existingTotals?.refundedTotalAmount, 0), 0)\n  const outstandingAmount = Math.max(grandTotalGross - paidTotalAmount + refundedTotalAmount, 0)\n\n  return {\n    kind: documentKind,\n    currencyCode,\n    lines,\n    adjustments: resolvedAdjustments,\n    metadata: {},\n    totals: {\n      subtotalNetAmount: round(subtotalNet),\n      subtotalGrossAmount: round(subtotalGross),\n      discountTotalAmount: round(discountTotal),\n      taxTotalAmount: round(taxTotal),\n      shippingNetAmount: round(shippingNet),\n      shippingGrossAmount: round(shippingGross),\n      surchargeTotalAmount: round(surchargeTotal),\n      grandTotalNetAmount: grandTotalNet,\n      grandTotalGrossAmount: grandTotalGross,\n      paidTotalAmount,\n      refundedTotalAmount,\n      outstandingAmount,\n    },\n  }\n}\n\nclass SalesCalculationRegistry {\n  private lineCalculators: SalesLineCalculationHook[] = []\n  private totalsCalculators: SalesTotalsCalculationHook[] = []\n\n  registerLineCalculator(hook: SalesLineCalculationHook, opts?: { prepend?: boolean }): () => void {\n    if (opts?.prepend) this.lineCalculators.unshift(hook)\n    else this.lineCalculators.push(hook)\n    return () => {\n      this.lineCalculators = this.lineCalculators.filter((item) => item !== hook)\n    }\n  }\n\n  registerTotalsCalculator(hook: SalesTotalsCalculationHook, opts?: { prepend?: boolean }): () => void {\n    if (opts?.prepend) this.totalsCalculators.unshift(hook)\n    else this.totalsCalculators.push(hook)\n    return () => {\n      this.totalsCalculators = this.totalsCalculators.filter((item) => item !== hook)\n    }\n  }\n\n  async calculateLine(opts: CalculateLineOptions): Promise<SalesLineCalculationResult> {\n    const { documentKind, line, context, eventBus } = opts\n    let current = buildBaseLineResult(line)\n\n    if (eventBus) {\n      await eventBus.emitEvent('sales.line.calculate.before', {\n        documentKind,\n        line,\n        context,\n        result: current,\n        setResult(next: SalesLineCalculationResult) {\n          current = next\n        },\n      })\n    }\n\n    for (const hook of this.lineCalculators) {\n      const next = await hook({ documentKind, line, context, current })\n      if (next) current = next\n    }\n\n    if (eventBus) {\n      await eventBus.emitEvent('sales.line.calculate.after', {\n        documentKind,\n        line,\n        context,\n        result: current,\n        setResult(next: SalesLineCalculationResult) {\n          current = next\n        },\n      })\n    }\n\n    return current\n  }\n\n  async calculateDocument(opts: CalculateDocumentOptions): Promise<SalesDocumentCalculationResult> {\n    const { documentKind, lines, adjustments = [], context, eventBus, existingTotals } = opts\n    const resolvedLines: SalesLineCalculationResult[] = []\n\n    for (const line of lines) {\n      const result = await this.calculateLine({ documentKind, line, context, eventBus })\n      resolvedLines.push(result)\n    }\n\n    let current = buildBaseDocumentResult({\n      documentKind,\n      lines: resolvedLines,\n      adjustments,\n      currencyCode: context.currencyCode,\n      existingTotals,\n    })\n\n    if (eventBus) {\n      await eventBus.emitEvent('sales.document.calculate.before', {\n        documentKind,\n        lines: resolvedLines,\n        context,\n        adjustments,\n        result: current,\n        setResult(next: SalesDocumentCalculationResult) {\n          current = next\n        },\n      })\n    }\n\n    for (const hook of this.totalsCalculators) {\n      const next = await hook({\n        documentKind,\n        lines: resolvedLines,\n        existingAdjustments: adjustments,\n        context,\n        current,\n        eventBus,\n      })\n      if (next) current = next\n    }\n\n    if (eventBus) {\n      await eventBus.emitEvent('sales.document.calculate.after', {\n        documentKind,\n        lines: resolvedLines,\n        context,\n        adjustments,\n        result: current,\n        setResult(next: SalesDocumentCalculationResult) {\n          current = next\n        },\n      })\n    }\n\n    // Payment totals (paid/refunded) are authoritative inputs, not derived from\n    // lines or adjustments. Totals calculators rebuild the document result from\n    // lines+adjustments and would otherwise reset paid/refunded to 0 (and\n    // outstanding back to the full grand total), producing a stale paid/\n    // outstanding display after a payment. Re-apply the input totals last and\n    // recompute outstanding against the post-calculation grand total.\n    if (existingTotals) {\n      const paidTotalAmount = Math.max(toNumber(existingTotals.paidTotalAmount, 0), 0)\n      const refundedTotalAmount = Math.max(toNumber(existingTotals.refundedTotalAmount, 0), 0)\n      current.totals = {\n        ...current.totals,\n        paidTotalAmount,\n        refundedTotalAmount,\n        outstandingAmount: round(\n          Math.max(current.totals.grandTotalGrossAmount - paidTotalAmount + refundedTotalAmount, 0)\n        ),\n      }\n    }\n\n    return current\n  }\n}\n\nexport function createSalesCalculationRegistry(): SalesCalculationRegistry {\n  return new SalesCalculationRegistry()\n}\n\nexport const salesCalculations = createSalesCalculationRegistry()\n\nexport async function calculateLine(\n  opts: CalculateLineOptions\n): Promise<SalesLineCalculationResult> {\n  return salesCalculations.calculateLine(opts)\n}\n\nexport async function calculateDocumentTotals(\n  opts: CalculateDocumentOptions\n): Promise<SalesDocumentCalculationResult> {\n  return salesCalculations.calculateDocument(opts)\n}\n\nexport function registerSalesLineCalculator(\n  hook: SalesLineCalculationHook,\n  opts?: { prepend?: boolean }\n): () => void {\n  return salesCalculations.registerLineCalculator(hook, opts)\n}\n\nexport function registerSalesTotalsCalculator(\n  hook: SalesTotalsCalculationHook,\n  opts?: { prepend?: boolean }\n): () => void {\n  return salesCalculations.registerTotalsCalculator(hook, opts)\n}\n\nexport function rebuildDocumentResult(params: {\n  documentKind: SalesDocumentKind\n  currencyCode: string\n  lines: SalesLineCalculationResult[]\n  adjustments: SalesAdjustmentDraft[]\n  metadata?: Record<string, unknown>\n}): SalesDocumentCalculationResult {\n  const result = buildBaseDocumentResult({\n    documentKind: params.documentKind,\n    lines: params.lines,\n    adjustments: params.adjustments,\n    currencyCode: params.currencyCode,\n  })\n  result.metadata = params.metadata ?? {}\n  return result\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.6.7-develop.6552.1.5208a19369",
+  "version": "0.6.7-develop.6565.1.1026d85fff",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -253,16 +253,16 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.6.7-develop.6552.1.5208a19369",
-    "@open-mercato/shared": "0.6.7-develop.6552.1.5208a19369",
-    "@open-mercato/ui": "0.6.7-develop.6552.1.5208a19369",
+    "@open-mercato/ai-assistant": "0.6.7-develop.6565.1.1026d85fff",
+    "@open-mercato/shared": "0.6.7-develop.6565.1.1026d85fff",
+    "@open-mercato/ui": "0.6.7-develop.6565.1.1026d85fff",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.6.7-develop.6552.1.5208a19369",
-    "@open-mercato/shared": "0.6.7-develop.6552.1.5208a19369",
-    "@open-mercato/ui": "0.6.7-develop.6552.1.5208a19369",
+    "@open-mercato/ai-assistant": "0.6.7-develop.6565.1.1026d85fff",
+    "@open-mercato/shared": "0.6.7-develop.6565.1.1026d85fff",
+    "@open-mercato/ui": "0.6.7-develop.6565.1.1026d85fff",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",

package/src/modules/attachments/lib/reconcileOrganization.ts

@@ -132,13 +132,22 @@ export async function reconcileAttachmentOrganizations(opts: {
     for (let index = 0; index < recordIds.length; index += batchSize) {
       const chunk = recordIds.slice(index, index + batchSize)
       try {
-        const result = await queryEngine.query(entityId as any, {
-          fields: ['id', 'organization_id'],
-          filters: { id: chunk.length === 1 ? { $eq: chunk[0] } : { $in: chunk } },
-          tenantId,
-          withDeleted: true,
-          page: { pageSize: Math.max(chunk.length, 1) },
-        })
+        // An unregistrable entity id makes the Query Engine emit SQL against a
+        // non-existent relation, and a failed statement aborts the surrounding
+        // Postgres transaction the caller runs this reconcile in — poisoning
+        // the whole backfill (#4145). Running each resolution query inside a
+        // nested transaction scopes the failure to a savepoint, so the catch
+        // below can mark just this group unresolved while every other group
+        // and the final flush keep working.
+        const result = await em.transactional(async () =>
+          queryEngine.query(entityId as any, {
+            fields: ['id', 'organization_id'],
+            filters: { id: chunk.length === 1 ? { $eq: chunk[0] } : { $in: chunk } },
+            tenantId,
+            withDeleted: true,
+            page: { pageSize: Math.max(chunk.length, 1) },
+          }),
+        )
         for (const item of result.items ?? []) {
           const record = item as Record<string, unknown>
           const recordId = record.id != null ? String(record.id) : null

package/src/modules/customer_accounts/i18n/de.json

@@ -104,7 +104,9 @@
   "customer_accounts.admin.flash.deleted": "User deleted",
   "customer_accounts.admin.inactive": "Inactive",
   "customer_accounts.admin.portalFeatures.addresses.manage": "Adressen verwalten",
+  "customer_accounts.admin.portalFeatures.addresses.manage.description": "Ermöglicht das Hinzufügen, Bearbeiten und Entfernen von Adressen",
   "customer_accounts.admin.portalFeatures.addresses.view": "Adressen anzeigen",
+  "customer_accounts.admin.portalFeatures.addresses.view.description": "Ermöglicht das Anzeigen gespeicherter Liefer- und Rechnungsadressen",
   "customer_accounts.admin.portalFeatures.groups.addresses": "Adressen",
   "customer_accounts.admin.portalFeatures.groups.invoices": "Rechnungen",
   "customer_accounts.admin.portalFeatures.groups.orders": "Bestellungen",
@@ -112,15 +114,25 @@
   "customer_accounts.admin.portalFeatures.groups.quotes": "Angebote",
   "customer_accounts.admin.portalFeatures.groups.users": "Benutzer",
   "customer_accounts.admin.portalFeatures.invoices.view": "Rechnungen anzeigen",
+  "customer_accounts.admin.portalFeatures.invoices.view.description": "Ermöglicht das Anzeigen von Rechnungen und der Zahlungshistorie",
   "customer_accounts.admin.portalFeatures.orders.create": "Bestellungen erstellen",
+  "customer_accounts.admin.portalFeatures.orders.create.description": "Ermöglicht das Aufgeben neuer Bestellungen über das Portal",
   "customer_accounts.admin.portalFeatures.orders.view": "Bestellungen anzeigen",
+  "customer_accounts.admin.portalFeatures.orders.view.description": "Ermöglicht das Anzeigen des Bestellverlaufs und der Bestelldetails",
   "customer_accounts.admin.portalFeatures.profile.edit": "Profil bearbeiten",
+  "customer_accounts.admin.portalFeatures.profile.edit.description": "Ermöglicht das Bearbeiten des Anzeigenamens und anderer Profileinstellungen",
   "customer_accounts.admin.portalFeatures.profile.view": "Profil anzeigen",
+  "customer_accounts.admin.portalFeatures.profile.view.description": "Ermöglicht das Anzeigen der eigenen Profilinformationen und Kontodetails",
   "customer_accounts.admin.portalFeatures.quotes.request": "Angebote anfordern",
+  "customer_accounts.admin.portalFeatures.quotes.request.description": "Ermöglicht das Anfordern neuer Angebote vom Unternehmen",
   "customer_accounts.admin.portalFeatures.quotes.view": "Angebote anzeigen",
+  "customer_accounts.admin.portalFeatures.quotes.view.description": "Ermöglicht das Anzeigen erhaltener Angebote und deren Details",
   "customer_accounts.admin.portalFeatures.users.invite": "Teammitglieder einladen",
+  "customer_accounts.admin.portalFeatures.users.invite.description": "Ermöglicht das Senden von Portaleinladungen an neue Teammitglieder",
   "customer_accounts.admin.portalFeatures.users.manage": "Teammitglieder verwalten",
+  "customer_accounts.admin.portalFeatures.users.manage.description": "Ermöglicht das Bearbeiten von Rollen und das Entfernen von Teammitgliedern",
   "customer_accounts.admin.portalFeatures.users.view": "Teammitglieder anzeigen",
+  "customer_accounts.admin.portalFeatures.users.view.description": "Ermöglicht das Anzeigen anderer Teammitglieder in der Organisation",
   "customer_accounts.admin.portalInfo.credentials": "Demo credentials: alice.johnson@example.com / Password123!",
   "customer_accounts.admin.portalInfo.description": "Manage customer portal accounts. Customers can self-register, log in, and access orders, quotes, and invoices through the portal.",
   "customer_accounts.admin.portalInfo.open": "Open Portal",

package/src/modules/customer_accounts/i18n/en.json

@@ -104,7 +104,9 @@
   "customer_accounts.admin.flash.deleted": "User deleted",
   "customer_accounts.admin.inactive": "Inactive",
   "customer_accounts.admin.portalFeatures.addresses.manage": "Manage addresses",
+  "customer_accounts.admin.portalFeatures.addresses.manage.description": "Allows adding, editing, and removing addresses",
   "customer_accounts.admin.portalFeatures.addresses.view": "View addresses",
+  "customer_accounts.admin.portalFeatures.addresses.view.description": "Allows viewing saved shipping and billing addresses",
   "customer_accounts.admin.portalFeatures.groups.addresses": "Addresses",
   "customer_accounts.admin.portalFeatures.groups.invoices": "Invoices",
   "customer_accounts.admin.portalFeatures.groups.orders": "Orders",
@@ -112,15 +114,25 @@
   "customer_accounts.admin.portalFeatures.groups.quotes": "Quotes",
   "customer_accounts.admin.portalFeatures.groups.users": "Users",
   "customer_accounts.admin.portalFeatures.invoices.view": "View invoices",
+  "customer_accounts.admin.portalFeatures.invoices.view.description": "Allows viewing invoices and payment history",
   "customer_accounts.admin.portalFeatures.orders.create": "Create orders",
+  "customer_accounts.admin.portalFeatures.orders.create.description": "Allows placing new orders through the portal",
   "customer_accounts.admin.portalFeatures.orders.view": "View orders",
+  "customer_accounts.admin.portalFeatures.orders.view.description": "Allows viewing order history and order details",
   "customer_accounts.admin.portalFeatures.profile.edit": "Edit profile",
+  "customer_accounts.admin.portalFeatures.profile.edit.description": "Allows editing display name and other profile settings",
   "customer_accounts.admin.portalFeatures.profile.view": "View profile",
+  "customer_accounts.admin.portalFeatures.profile.view.description": "Allows viewing own profile information and account details",
   "customer_accounts.admin.portalFeatures.quotes.request": "Request quotes",
+  "customer_accounts.admin.portalFeatures.quotes.request.description": "Allows requesting new quotes from the company",
   "customer_accounts.admin.portalFeatures.quotes.view": "View quotes",
+  "customer_accounts.admin.portalFeatures.quotes.view.description": "Allows viewing received quotes and their details",
   "customer_accounts.admin.portalFeatures.users.invite": "Invite team members",
+  "customer_accounts.admin.portalFeatures.users.invite.description": "Allows sending portal invitations to new team members",
   "customer_accounts.admin.portalFeatures.users.manage": "Manage team members",
+  "customer_accounts.admin.portalFeatures.users.manage.description": "Allows editing roles and removing team members",
   "customer_accounts.admin.portalFeatures.users.view": "View team members",
+  "customer_accounts.admin.portalFeatures.users.view.description": "Allows viewing other team members in the organization",
   "customer_accounts.admin.portalInfo.credentials": "Demo credentials: alice.johnson@example.com / Password123!",
   "customer_accounts.admin.portalInfo.description": "Manage customer portal accounts. Customers can self-register, log in, and access orders, quotes, and invoices through the portal.",
   "customer_accounts.admin.portalInfo.open": "Open Portal",

package/src/modules/customer_accounts/i18n/es.json

@@ -103,24 +103,36 @@
   "customer_accounts.admin.flash.deactivated": "User deactivated",
   "customer_accounts.admin.flash.deleted": "User deleted",
   "customer_accounts.admin.inactive": "Inactive",
-  "customer_accounts.admin.portalFeatures.addresses.manage": "Manage addresses",
-  "customer_accounts.admin.portalFeatures.addresses.view": "View addresses",
-  "customer_accounts.admin.portalFeatures.groups.addresses": "Addresses",
-  "customer_accounts.admin.portalFeatures.groups.invoices": "Invoices",
-  "customer_accounts.admin.portalFeatures.groups.orders": "Orders",
-  "customer_accounts.admin.portalFeatures.groups.profile": "Profile",
-  "customer_accounts.admin.portalFeatures.groups.quotes": "Quotes",
-  "customer_accounts.admin.portalFeatures.groups.users": "Users",
-  "customer_accounts.admin.portalFeatures.invoices.view": "View invoices",
-  "customer_accounts.admin.portalFeatures.orders.create": "Create orders",
-  "customer_accounts.admin.portalFeatures.orders.view": "View orders",
-  "customer_accounts.admin.portalFeatures.profile.edit": "Edit profile",
-  "customer_accounts.admin.portalFeatures.profile.view": "View profile",
-  "customer_accounts.admin.portalFeatures.quotes.request": "Request quotes",
-  "customer_accounts.admin.portalFeatures.quotes.view": "View quotes",
-  "customer_accounts.admin.portalFeatures.users.invite": "Invite team members",
-  "customer_accounts.admin.portalFeatures.users.manage": "Manage team members",
-  "customer_accounts.admin.portalFeatures.users.view": "View team members",
+  "customer_accounts.admin.portalFeatures.addresses.manage": "Gestionar direcciones",
+  "customer_accounts.admin.portalFeatures.addresses.manage.description": "Permite añadir, editar y eliminar direcciones",
+  "customer_accounts.admin.portalFeatures.addresses.view": "Ver direcciones",
+  "customer_accounts.admin.portalFeatures.addresses.view.description": "Permite ver las direcciones de envío y facturación guardadas",
+  "customer_accounts.admin.portalFeatures.groups.addresses": "Direcciones",
+  "customer_accounts.admin.portalFeatures.groups.invoices": "Facturas",
+  "customer_accounts.admin.portalFeatures.groups.orders": "Pedidos",
+  "customer_accounts.admin.portalFeatures.groups.profile": "Perfil",
+  "customer_accounts.admin.portalFeatures.groups.quotes": "Presupuestos",
+  "customer_accounts.admin.portalFeatures.groups.users": "Usuarios",
+  "customer_accounts.admin.portalFeatures.invoices.view": "Ver facturas",
+  "customer_accounts.admin.portalFeatures.invoices.view.description": "Permite ver las facturas y el historial de pagos",
+  "customer_accounts.admin.portalFeatures.orders.create": "Crear pedidos",
+  "customer_accounts.admin.portalFeatures.orders.create.description": "Permite realizar nuevos pedidos a través del portal",
+  "customer_accounts.admin.portalFeatures.orders.view": "Ver pedidos",
+  "customer_accounts.admin.portalFeatures.orders.view.description": "Permite ver el historial y los detalles de los pedidos",
+  "customer_accounts.admin.portalFeatures.profile.edit": "Editar perfil",
+  "customer_accounts.admin.portalFeatures.profile.edit.description": "Permite editar el nombre visible y otros ajustes del perfil",
+  "customer_accounts.admin.portalFeatures.profile.view": "Ver perfil",
+  "customer_accounts.admin.portalFeatures.profile.view.description": "Permite ver la información del propio perfil y los detalles de la cuenta",
+  "customer_accounts.admin.portalFeatures.quotes.request": "Solicitar presupuestos",
+  "customer_accounts.admin.portalFeatures.quotes.request.description": "Permite solicitar nuevos presupuestos a la empresa",
+  "customer_accounts.admin.portalFeatures.quotes.view": "Ver presupuestos",
+  "customer_accounts.admin.portalFeatures.quotes.view.description": "Permite ver los presupuestos recibidos y sus detalles",
+  "customer_accounts.admin.portalFeatures.users.invite": "Invitar a miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.invite.description": "Permite enviar invitaciones al portal a nuevos miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.manage": "Gestionar miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.manage.description": "Permite editar roles y eliminar miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.view": "Ver miembros del equipo",
+  "customer_accounts.admin.portalFeatures.users.view.description": "Permite ver a otros miembros del equipo en la organización",
   "customer_accounts.admin.portalInfo.credentials": "Demo credentials: alice.johnson@example.com / Password123!",
   "customer_accounts.admin.portalInfo.description": "Manage customer portal accounts. Customers can self-register, log in, and access orders, quotes, and invoices through the portal.",
   "customer_accounts.admin.portalInfo.open": "Open Portal",
@@ -162,10 +174,10 @@
   "customer_accounts.admin.roleDetail.fields.name": "Name",
   "customer_accounts.admin.roleDetail.flash.saved": "Role updated",
   "customer_accounts.admin.roleDetail.loading": "Loading role...",
-  "customer_accounts.admin.roleDetail.sections.details": "Role Details",
-  "customer_accounts.admin.roleDetail.sections.options": "Options",
-  "customer_accounts.admin.roleDetail.sections.permissions": "Portal Permissions",
-  "customer_accounts.admin.roleDetail.selectAll": "Select all",
+  "customer_accounts.admin.roleDetail.sections.details": "Detalles del rol",
+  "customer_accounts.admin.roleDetail.sections.options": "Opciones",
+  "customer_accounts.admin.roleDetail.sections.permissions": "Permisos del portal",
+  "customer_accounts.admin.roleDetail.selectAll": "Seleccionar todo",
   "customer_accounts.admin.roles": "Roles",
   "customer_accounts.admin.roles.actions.create": "Create Role",
   "customer_accounts.admin.roles.actions.delete": "Delete",

package/src/modules/customer_accounts/i18n/pl.json

@@ -103,24 +103,36 @@
   "customer_accounts.admin.flash.deactivated": "Użytkownik dezaktywowany",
   "customer_accounts.admin.flash.deleted": "Użytkownik usunięty",
   "customer_accounts.admin.inactive": "Nieaktywny",
-  "customer_accounts.admin.portalFeatures.addresses.manage": "Manage addresses",
-  "customer_accounts.admin.portalFeatures.addresses.view": "View addresses",
-  "customer_accounts.admin.portalFeatures.groups.addresses": "Addresses",
-  "customer_accounts.admin.portalFeatures.groups.invoices": "Invoices",
-  "customer_accounts.admin.portalFeatures.groups.orders": "Orders",
-  "customer_accounts.admin.portalFeatures.groups.profile": "Profile",
-  "customer_accounts.admin.portalFeatures.groups.quotes": "Quotes",
-  "customer_accounts.admin.portalFeatures.groups.users": "Users",
-  "customer_accounts.admin.portalFeatures.invoices.view": "View invoices",
-  "customer_accounts.admin.portalFeatures.orders.create": "Create orders",
-  "customer_accounts.admin.portalFeatures.orders.view": "View orders",
-  "customer_accounts.admin.portalFeatures.profile.edit": "Edit profile",
-  "customer_accounts.admin.portalFeatures.profile.view": "View profile",
-  "customer_accounts.admin.portalFeatures.quotes.request": "Request quotes",
-  "customer_accounts.admin.portalFeatures.quotes.view": "View quotes",
-  "customer_accounts.admin.portalFeatures.users.invite": "Invite team members",
-  "customer_accounts.admin.portalFeatures.users.manage": "Manage team members",
-  "customer_accounts.admin.portalFeatures.users.view": "View team members",
+  "customer_accounts.admin.portalFeatures.addresses.manage": "Zarządzanie adresami",
+  "customer_accounts.admin.portalFeatures.addresses.manage.description": "Umożliwia dodawanie, edycję i usuwanie adresów",
+  "customer_accounts.admin.portalFeatures.addresses.view": "Wyświetlanie adresów",
+  "customer_accounts.admin.portalFeatures.addresses.view.description": "Umożliwia przeglądanie zapisanych adresów wysyłki i rozliczeniowych",
+  "customer_accounts.admin.portalFeatures.groups.addresses": "Adresy",
+  "customer_accounts.admin.portalFeatures.groups.invoices": "Faktury",
+  "customer_accounts.admin.portalFeatures.groups.orders": "Zamówienia",
+  "customer_accounts.admin.portalFeatures.groups.profile": "Profil",
+  "customer_accounts.admin.portalFeatures.groups.quotes": "Oferty",
+  "customer_accounts.admin.portalFeatures.groups.users": "Użytkownicy",
+  "customer_accounts.admin.portalFeatures.invoices.view": "Wyświetlanie faktur",
+  "customer_accounts.admin.portalFeatures.invoices.view.description": "Umożliwia przeglądanie faktur i historii płatności",
+  "customer_accounts.admin.portalFeatures.orders.create": "Tworzenie zamówień",
+  "customer_accounts.admin.portalFeatures.orders.create.description": "Umożliwia składanie nowych zamówień przez portal",
+  "customer_accounts.admin.portalFeatures.orders.view": "Wyświetlanie zamówień",
+  "customer_accounts.admin.portalFeatures.orders.view.description": "Umożliwia przeglądanie historii i szczegółów zamówień",
+  "customer_accounts.admin.portalFeatures.profile.edit": "Edycja profilu",
+  "customer_accounts.admin.portalFeatures.profile.edit.description": "Umożliwia edycję nazwy wyświetlanej i innych ustawień profilu",
+  "customer_accounts.admin.portalFeatures.profile.view": "Wyświetlanie profilu",
+  "customer_accounts.admin.portalFeatures.profile.view.description": "Umożliwia przeglądanie własnych informacji profilowych i szczegółów konta",
+  "customer_accounts.admin.portalFeatures.quotes.request": "Prośba o oferty",
+  "customer_accounts.admin.portalFeatures.quotes.request.description": "Umożliwia zamawianie nowych ofert od firmy",
+  "customer_accounts.admin.portalFeatures.quotes.view": "Wyświetlanie ofert",
+  "customer_accounts.admin.portalFeatures.quotes.view.description": "Umożliwia przeglądanie otrzymanych ofert i ich szczegółów",
+  "customer_accounts.admin.portalFeatures.users.invite": "Zapraszanie członków zespołu",
+  "customer_accounts.admin.portalFeatures.users.invite.description": "Umożliwia wysyłanie zaproszeń do portalu nowym członkom zespołu",
+  "customer_accounts.admin.portalFeatures.users.manage": "Zarządzanie członkami zespołu",
+  "customer_accounts.admin.portalFeatures.users.manage.description": "Umożliwia edycję ról i usuwanie członków zespołu",
+  "customer_accounts.admin.portalFeatures.users.view": "Wyświetlanie członków zespołu",
+  "customer_accounts.admin.portalFeatures.users.view.description": "Umożliwia przeglądanie innych członków zespołu w organizacji",
   "customer_accounts.admin.portalInfo.credentials": "Demo credentials: alice.johnson@example.com / Password123!",
   "customer_accounts.admin.portalInfo.description": "Manage customer portal accounts. Customers can self-register, log in, and access orders, quotes, and invoices through the portal.",
   "customer_accounts.admin.portalInfo.open": "Open Portal",
@@ -163,9 +175,9 @@
   "customer_accounts.admin.roleDetail.flash.saved": "Rola zaktualizowana",
   "customer_accounts.admin.roleDetail.loading": "Ładowanie roli...",
   "customer_accounts.admin.roleDetail.sections.details": "Szczegóły roli",
-  "customer_accounts.admin.roleDetail.sections.options": "Options",
+  "customer_accounts.admin.roleDetail.sections.options": "Opcje",
   "customer_accounts.admin.roleDetail.sections.permissions": "Uprawnienia portalu",
-  "customer_accounts.admin.roleDetail.selectAll": "Select all",
+  "customer_accounts.admin.roleDetail.selectAll": "Zaznacz wszystko",
   "customer_accounts.admin.roles": "Role",
   "customer_accounts.admin.roles.actions.create": "Utwórz rolę",
   "customer_accounts.admin.roles.actions.delete": "Usuń",

package/src/modules/customers/api/companies/[id]/people/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/postgresql'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
@@ -116,7 +116,7 @@ export async function GET(req: Request, ctx: { params?: { id?: string } }) {
       decryptionScope,
     )
     if (!company) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.company_not_found', 'Company not found') })
+      throw notFound(translate('customers.errors.company_not_found', 'Company not found'))
     }
 
     if (!isOrganizationReadAccessAllowed({ scope, auth, organizationId: company.organizationId })) {

package/src/modules/customers/api/deals/[id]/companies/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/postgresql'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
@@ -98,7 +98,7 @@ export async function GET(req: Request, ctx: { params?: { id?: string } }) {
       decryptionScope,
     )
     if (!deal) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.deal_not_found', 'Deal not found') })
+      throw notFound(translate('customers.errors.deal_not_found', 'Deal not found'))
     }
 
     if (!isOrganizationReadAccessAllowed({ scope, auth, organizationId: deal.organizationId })) {

package/src/modules/customers/api/deals/[id]/people/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/postgresql'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
@@ -98,7 +98,7 @@ export async function GET(req: Request, ctx: { params?: { id?: string } }) {
       decryptionScope,
     )
     if (!deal) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.deal_not_found', 'Deal not found') })
+      throw notFound(translate('customers.errors.deal_not_found', 'Deal not found'))
     }
 
     if (!isOrganizationReadAccessAllowed({ scope, auth, organizationId: deal.organizationId })) {

package/src/modules/customers/api/dictionaries/[kind]/[id]/route.ts

@@ -1,7 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import type { CommandBus } from '@open-mercato/shared/lib/commands'
 import { serializeOperationMetadata } from '@open-mercato/shared/lib/commands/operationMetadata'
 import type { CommandExecuteResult } from '@open-mercato/shared/lib/commands/types'
@@ -86,7 +86,7 @@ export async function PATCH(req: Request, ctx: { params?: { kind?: string; id?:
     } catch (err) {
       if (isCrudHttpError(err)) {
         if (err.status === 404) {
-          throw new CrudHttpError(404, { error: routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found') })
+          throw notFound(routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found'))
         }
         if (err.status === 409) {
           if ((err.body as Record<string, unknown> | undefined)?.code === 'role_type_in_use') {
@@ -123,7 +123,7 @@ export async function PATCH(req: Request, ctx: { params?: { kind?: string; id?:
       },
     )
     if (!entry) {
-      throw new CrudHttpError(404, { error: routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found') })
+      throw notFound(routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found'))
     }
 
     if (result.changed) {
@@ -218,7 +218,7 @@ export async function DELETE(req: Request, ctx: { params?: { kind?: string; id?:
       })) as CommandExecuteResult<{ entryId: string }>
     } catch (err) {
       if (isCrudHttpError(err) && err.status === 404) {
-        throw new CrudHttpError(404, { error: routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found') })
+        throw notFound(routeContext.translate('customers.errors.lookup_failed', 'Dictionary entry not found'))
       }
       if (isCrudHttpError(err) && err.status === 409 && (err.body as Record<string, unknown> | undefined)?.code === 'role_type_in_use') {
         const usageCount = Number((err.body as Record<string, unknown> | undefined)?.usageCount ?? 0)

package/src/modules/customers/api/entity-roles-factory.ts

@@ -4,7 +4,7 @@ import type { CommandBus } from '@open-mercato/shared/lib/commands'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
 import { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'
 import { validateCrudMutationGuard, runCrudMutationGuardAfterSuccess } from '@open-mercato/shared/lib/crud/mutation-guard'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
 import { isOrganizationReadAccessAllowed } from '@open-mercato/core/modules/directory/utils/organizationScopeGuard'
@@ -130,7 +130,7 @@ async function resolveEntityRouteScope(
     { tenantId: auth.tenantId, organizationId: scope?.selectedId ?? auth.orgId ?? null },
   )
   if (!entity || entity.tenantId !== auth.tenantId) {
-    throw new CrudHttpError(404, { error: translate('customers.errors.customer_not_found', 'Customer not found') })
+    throw notFound(translate('customers.errors.customer_not_found', 'Customer not found'))
   }
   ensureRouteOrganizationAccess(entity.organizationId, scope, auth, translate)
   return {
@@ -162,7 +162,7 @@ async function resolveRoleRouteScope(
     role.entityType !== entityType ||
     role.entityId !== entityId
   ) {
-    throw new CrudHttpError(404, { error: translate('customers.errors.role_not_found', 'Role not found') })
+    throw notFound(translate('customers.errors.role_not_found', 'Role not found'))
   }
   ensureRouteOrganizationAccess(role.organizationId, scope, auth, translate)
   return {

package/src/modules/customers/api/labels/assign/route.ts

@@ -4,7 +4,7 @@ import { labelAssignCommandSchema, labelAssignmentSchema, type LabelAssignComman
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import type { CommandBus } from '@open-mercato/shared/lib/commands'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
@@ -80,7 +80,7 @@ export async function POST(req: Request) {
       { tenantId: auth.tenantId, organizationId },
     )
     if (!targetEntity) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.entity_not_found', 'Entity not found') })
+      throw notFound(translate('customers.errors.entity_not_found', 'Entity not found'))
     }
     const entityKind = targetEntity.kind === 'person' || targetEntity.kind === 'company' ? targetEntity.kind : null
     const resourceKind = resolveResourceKind(entityKind)

package/src/modules/customers/api/labels/unassign/route.ts

@@ -4,7 +4,7 @@ import { labelUnassignCommandSchema, labelAssignmentSchema, type LabelUnassignCo
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import type { EntityManager } from '@mikro-orm/postgresql'
 import type { CommandBus } from '@open-mercato/shared/lib/commands'
 import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
@@ -80,7 +80,7 @@ export async function POST(req: Request) {
       { tenantId: auth.tenantId, organizationId },
     )
     if (!targetEntity) {
-      throw new CrudHttpError(404, { error: translate('customers.errors.entity_not_found', 'Entity not found') })
+      throw notFound(translate('customers.errors.entity_not_found', 'Entity not found'))
     }
     const entityKind = targetEntity.kind === 'person' || targetEntity.kind === 'company' ? targetEntity.kind : null
     const resourceKind = resolveResourceKind(entityKind)

package/src/modules/customers/api/people/[id]/companies/[linkId]/route.ts

@@ -1,6 +1,6 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
-import { CrudHttpError, isCrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { CrudHttpError, isCrudHttpError, notFound } from '@open-mercato/shared/lib/crud/errors'
 import {
   runCrudMutationGuardAfterSuccess,
   validateCrudMutationGuard,
@@ -147,9 +147,7 @@ export async function PATCH(req: Request, ctx: { params?: { id?: string; linkId?
       selectedOrganizationId,
     )
     if (!resolvedLinkId) {
-      throw new CrudHttpError(404, {
-        error: translate('customers.errors.person_company_link_not_found', 'Person-company link not found'),
-      })
+      throw notFound(translate('customers.errors.person_company_link_not_found', 'Person-company link not found'))
     }
 
     const commandInput = personCompanyLinkUpdateSchema.parse({
@@ -265,9 +263,7 @@ export async function DELETE(req: Request, ctx: { params?: { id?: string; linkId
       selectedOrganizationId,
     )
     if (!resolvedLinkId) {
-      throw new CrudHttpError(404, {
-        error: translate('customers.errors.person_company_link_not_found', 'Person-company link not found'),
-      })
+      throw notFound(translate('customers.errors.person_company_link_not_found', 'Person-company link not found'))
     }
 
     const commandInput = personCompanyLinkDeleteSchema.parse({