@open-mercato/core 0.6.8-develop.6998.1.d2bc46c56c → 0.6.8-develop.7001.1.03608ab252

package/dist/modules/warranty_claims/lib/risk.js

@@ -0,0 +1,204 @@
+import { sql } from "kysely";
+import { loadWarrantyClaimSettings } from "./settings.js";
+const DUPLICATE_SERIAL_LEVEL = "high";
+const REPEAT_CLAIMER_MEDIUM_COUNT = 3;
+const REPEAT_CLAIMER_HIGH_COUNT = 5;
+const VALUE_VELOCITY_MEDIUM_TOTAL = 1e4;
+const VALUE_VELOCITY_HIGH_TOTAL = 5e4;
+const RISK_WINDOW_DAYS = 90;
+const MILLISECONDS_PER_DAY = 864e5;
+const QUANTITY_SCALE = 1e4;
+const LEVEL_RANK = { none: 0, low: 1, medium: 2, high: 3 };
+function parseNumeric(value) {
+  if (value === null) return 0;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+function parseNullableNumeric(value) {
+  if (value === null) return null;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function roundQuantity(value) {
+  return Math.round((value + Number.EPSILON) * QUANTITY_SCALE) / QUANTITY_SCALE;
+}
+function isMissingTableError(err, tableName) {
+  if (typeof err !== "object" || err === null) return false;
+  const candidate = err;
+  return candidate.code === "42P01" || typeof candidate.message === "string" && candidate.message.includes(tableName) && candidate.message.includes("does not exist");
+}
+function maxRiskLevel(signals) {
+  let level = "none";
+  for (const signal of signals) {
+    if (LEVEL_RANK[signal.level] > LEVEL_RANK[level]) {
+      level = signal.level;
+    }
+  }
+  return level;
+}
+function riskWindowStart(now = /* @__PURE__ */ new Date()) {
+  return new Date(now.getTime() - RISK_WINDOW_DAYS * 24 * 60 * 60 * 1e3);
+}
+async function evaluateClaimRisk(em, claim, lines, now = /* @__PURE__ */ new Date()) {
+  const db = em.getKysely();
+  const signals = [];
+  const scope = { tenantId: claim.tenantId, organizationId: claim.organizationId };
+  const serials = Array.from(new Set(lines.map((line) => line.serialNumber?.trim() ?? "").filter((serial) => serial.length > 0)));
+  if (serials.length > 0) {
+    const rows = await db.selectFrom("warranty_claim_lines").innerJoin("warranty_claims", "warranty_claims.id", "warranty_claim_lines.claim_id").select([
+      "warranty_claim_lines.serial_number as serialNumber",
+      "warranty_claims.claim_number as claimNumber"
+    ]).where("warranty_claim_lines.tenant_id", "=", scope.tenantId).where("warranty_claim_lines.organization_id", "=", scope.organizationId).where("warranty_claim_lines.deleted_at", "is", null).where("warranty_claims.tenant_id", "=", scope.tenantId).where("warranty_claims.organization_id", "=", scope.organizationId).where("warranty_claims.deleted_at", "is", null).where("warranty_claims.id", "!=", claim.id).where("warranty_claims.status", "!=", "cancelled").where("warranty_claim_lines.serial_number", "in", serials).execute();
+    const relatedBySerial = /* @__PURE__ */ new Map();
+    for (const row of rows) {
+      if (!row.serialNumber || !row.claimNumber) continue;
+      const related = relatedBySerial.get(row.serialNumber) ?? /* @__PURE__ */ new Set();
+      related.add(row.claimNumber);
+      relatedBySerial.set(row.serialNumber, related);
+    }
+    for (const serial of serials) {
+      const related = relatedBySerial.get(serial);
+      if (!related || related.size === 0) continue;
+      signals.push({
+        id: "duplicate_serial",
+        level: DUPLICATE_SERIAL_LEVEL,
+        messageKey: "warranty_claims.risk.duplicateSerial",
+        params: { serial, count: related.size },
+        relatedClaimNumbers: Array.from(related).sort((left, right) => left.localeCompare(right))
+      });
+    }
+  }
+  const orderId = claim.orderId ?? null;
+  if (orderId) {
+    const orderRows = await db.selectFrom("warranty_claims").select("claim_number as claimNumber").where("tenant_id", "=", scope.tenantId).where("organization_id", "=", scope.organizationId).where("deleted_at", "is", null).where("order_id", "=", orderId).where("status", "!=", "cancelled").where("id", "!=", claim.id).execute();
+    const relatedOrderClaims = Array.from(new Set(
+      orderRows.map((row) => row.claimNumber).filter((claimNumber) => typeof claimNumber === "string" && claimNumber.length > 0)
+    )).sort((left, right) => left.localeCompare(right));
+    if (relatedOrderClaims.length > 0) {
+      signals.push({
+        id: "duplicate_order_claim",
+        level: "medium",
+        messageKey: "warranty_claims.risk.duplicateOrderClaim",
+        params: { count: relatedOrderClaims.length },
+        relatedClaimNumbers: relatedOrderClaims
+      });
+    }
+  }
+  if (orderId && (claim.claimType === "return" || claim.claimType === "core_return")) {
+    const settings = await loadWarrantyClaimSettings(em, scope);
+    const returnWindowDays = settings?.returnWindowDays ?? null;
+    if (returnWindowDays !== null && returnWindowDays > 0) {
+      let order;
+      try {
+        order = await db.selectFrom("sales_orders").select(["placed_at as placedAt", "created_at as createdAt"]).where("id", "=", orderId).where("tenant_id", "=", scope.tenantId).where("organization_id", "=", scope.organizationId).where("deleted_at", "is", null).executeTakeFirst();
+      } catch (err) {
+        if (!isMissingTableError(err, "sales_orders")) throw err;
+      }
+      const anchorValue = order?.placedAt ?? order?.createdAt ?? null;
+      if (anchorValue !== null) {
+        const anchor = anchorValue instanceof Date ? anchorValue : new Date(anchorValue);
+        if (!Number.isNaN(anchor.getTime())) {
+          const days = Math.floor((now.getTime() - anchor.getTime()) / MILLISECONDS_PER_DAY);
+          if (days > returnWindowDays) {
+            signals.push({
+              id: "outside_return_window",
+              level: days > 2 * returnWindowDays ? "high" : "medium",
+              messageKey: "warranty_claims.risk.outsideReturnWindow",
+              params: { days, window: returnWindowDays }
+            });
+          }
+        }
+      }
+    }
+  }
+  const currentQuantityByOrderLine = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    const orderLineId = line.orderLineId ?? null;
+    if (!orderLineId || line.deletedAt || line.lineStatus === "rejected") continue;
+    const current = currentQuantityByOrderLine.get(orderLineId) ?? 0;
+    currentQuantityByOrderLine.set(orderLineId, roundQuantity(current + parseNumeric(line.qtyClaimed)));
+  }
+  const orderLineIds = Array.from(currentQuantityByOrderLine.keys()).sort((left, right) => left.localeCompare(right));
+  if (orderLineIds.length > 0) {
+    let soldRows;
+    try {
+      soldRows = await db.selectFrom("sales_order_lines").select(["id", "quantity"]).where("tenant_id", "=", scope.tenantId).where("organization_id", "=", scope.organizationId).where("deleted_at", "is", null).where("id", "in", orderLineIds).execute();
+    } catch (err) {
+      if (!isMissingTableError(err, "sales_order_lines")) throw err;
+      soldRows = [];
+    }
+    const soldByOrderLine = /* @__PURE__ */ new Map();
+    for (const row of soldRows) {
+      const quantity = parseNullableNumeric(row.quantity);
+      if (quantity !== null) soldByOrderLine.set(row.id, roundQuantity(quantity));
+    }
+    const scopedOrderLineIds = orderLineIds.filter((id) => soldByOrderLine.has(id));
+    if (scopedOrderLineIds.length > 0) {
+      const otherRows = await db.selectFrom("warranty_claim_lines").innerJoin("warranty_claims", "warranty_claims.id", "warranty_claim_lines.claim_id").select([
+        "warranty_claim_lines.order_line_id as orderLineId",
+        "warranty_claim_lines.qty_claimed as qtyClaimed",
+        "warranty_claims.claim_number as claimNumber"
+      ]).where("warranty_claim_lines.tenant_id", "=", scope.tenantId).where("warranty_claim_lines.organization_id", "=", scope.organizationId).where("warranty_claim_lines.deleted_at", "is", null).where("warranty_claim_lines.line_status", "!=", "rejected").where("warranty_claim_lines.order_line_id", "in", scopedOrderLineIds).where("warranty_claims.tenant_id", "=", scope.tenantId).where("warranty_claims.organization_id", "=", scope.organizationId).where("warranty_claims.deleted_at", "is", null).where("warranty_claims.id", "!=", claim.id).where("warranty_claims.status", "!=", "cancelled").execute();
+      const otherQuantityByOrderLine = /* @__PURE__ */ new Map();
+      const relatedClaimsByOrderLine = /* @__PURE__ */ new Map();
+      for (const row of otherRows) {
+        if (!row.orderLineId) continue;
+        const current = otherQuantityByOrderLine.get(row.orderLineId) ?? 0;
+        otherQuantityByOrderLine.set(row.orderLineId, roundQuantity(current + parseNumeric(row.qtyClaimed)));
+        if (row.claimNumber) {
+          const related = relatedClaimsByOrderLine.get(row.orderLineId) ?? /* @__PURE__ */ new Set();
+          related.add(row.claimNumber);
+          relatedClaimsByOrderLine.set(row.orderLineId, related);
+        }
+      }
+      for (const orderLineId of scopedOrderLineIds) {
+        const sold = soldByOrderLine.get(orderLineId);
+        if (sold === void 0) continue;
+        const count = roundQuantity(
+          (currentQuantityByOrderLine.get(orderLineId) ?? 0) + (otherQuantityByOrderLine.get(orderLineId) ?? 0)
+        );
+        if (count <= sold) continue;
+        signals.push({
+          id: "over_quantity_claim",
+          level: count >= sold * 2 ? "high" : "medium",
+          messageKey: "warranty_claims.risk.overQuantityClaim",
+          params: { count, sold },
+          relatedClaimNumbers: Array.from(relatedClaimsByOrderLine.get(orderLineId) ?? []).sort((left, right) => left.localeCompare(right))
+        });
+      }
+    }
+  }
+  const customerId = claim.customerId ?? null;
+  if (customerId) {
+    const windowStart = riskWindowStart(now);
+    const repeatRow = await db.selectFrom("warranty_claims").select(sql`count(*)`.as("count")).where("tenant_id", "=", scope.tenantId).where("organization_id", "=", scope.organizationId).where("deleted_at", "is", null).where("customer_id", "=", customerId).where("created_at", ">=", windowStart).where("status", "!=", "cancelled").where("id", "!=", claim.id).executeTakeFirst();
+    const otherClaimCount = Math.trunc(parseNumeric(repeatRow?.count ?? null));
+    const windowClaimCount = otherClaimCount + 1;
+    if (windowClaimCount >= REPEAT_CLAIMER_MEDIUM_COUNT) {
+      signals.push({
+        id: "repeat_claimer",
+        level: windowClaimCount >= REPEAT_CLAIMER_HIGH_COUNT ? "high" : "medium",
+        messageKey: "warranty_claims.risk.repeatClaimer",
+        params: { count: otherClaimCount }
+      });
+    }
+    const currencyCode = claim.currencyCode?.trim() || null;
+    if (currencyCode) {
+      const valueRow = await db.selectFrom("warranty_claims").select(sql`coalesce(sum(total_claimed_amount), 0)`.as("total")).where("tenant_id", "=", scope.tenantId).where("organization_id", "=", scope.organizationId).where("deleted_at", "is", null).where("customer_id", "=", customerId).where("currency_code", "=", currencyCode).where("created_at", ">=", windowStart).where("status", "!=", "cancelled").executeTakeFirst();
+      const total = parseNumeric(valueRow?.total ?? null);
+      if (total >= VALUE_VELOCITY_MEDIUM_TOTAL) {
+        signals.push({
+          id: "value_velocity",
+          level: total >= VALUE_VELOCITY_HIGH_TOTAL ? "high" : "medium",
+          messageKey: "warranty_claims.risk.valueVelocity",
+          params: { total: Number(total.toFixed(2)), currencyCode }
+        });
+      }
+    }
+  }
+  return { level: maxRiskLevel(signals), signals };
+}
+export {
+  evaluateClaimRisk
+};
+//# sourceMappingURL=risk.js.map

package/dist/modules/warranty_claims/lib/risk.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/warranty_claims/lib/risk.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { sql } from 'kysely'\nimport { WarrantyClaim, WarrantyClaimLine } from '../data/entities'\nimport { loadWarrantyClaimSettings } from './settings'\n\nexport type ClaimRiskLevel = 'none' | 'low' | 'medium' | 'high'\n\nexport type ClaimRiskSignal = {\n  id: 'duplicate_serial' | 'duplicate_order_claim' | 'outside_return_window' | 'over_quantity_claim' | 'repeat_claimer' | 'value_velocity'\n  level: 'low' | 'medium' | 'high'\n  messageKey: string\n  params?: Record<string, string | number>\n  relatedClaimNumbers?: string[]\n}\n\nexport type ClaimRiskAssessment = { level: ClaimRiskLevel; signals: ClaimRiskSignal[] }\n\ntype NumericAggregateValue = string | number | bigint | null\n\ntype WarrantyClaimsTable = {\n  id: string\n  organization_id: string\n  tenant_id: string\n  claim_number: string\n  status: string\n  customer_id: string | null\n  order_id: string | null\n  currency_code: string | null\n  total_claimed_amount: string | number | null\n  created_at: Date\n  deleted_at: Date | null\n}\n\ntype WarrantyClaimLinesTable = {\n  id: string\n  claim_id: string\n  organization_id: string\n  tenant_id: string\n  order_line_id: string | null\n  qty_claimed: string | number | null\n  line_status: string\n  serial_number: string | null\n  deleted_at: Date | null\n}\n\ntype SalesOrderLinesTable = {\n  id: string\n  organization_id: string\n  tenant_id: string\n  quantity: string | number | null\n  deleted_at: Date | null\n}\n\ntype SalesOrdersTable = {\n  id: string\n  organization_id: string\n  tenant_id: string\n  placed_at: Date | string | null\n  created_at: Date | string | null\n  deleted_at: Date | null\n}\n\ntype WarrantyClaimsRiskDb = {\n  warranty_claims: WarrantyClaimsTable\n  warranty_claim_lines: WarrantyClaimLinesTable\n  sales_order_lines: SalesOrderLinesTable\n  sales_orders: SalesOrdersTable\n}\n\nconst DUPLICATE_SERIAL_LEVEL = 'high' satisfies ClaimRiskSignal['level']\nconst REPEAT_CLAIMER_MEDIUM_COUNT = 3\nconst REPEAT_CLAIMER_HIGH_COUNT = 5\nconst VALUE_VELOCITY_MEDIUM_TOTAL = 10000\nconst VALUE_VELOCITY_HIGH_TOTAL = 50000\nconst RISK_WINDOW_DAYS = 90\nconst MILLISECONDS_PER_DAY = 86_400_000\nconst QUANTITY_SCALE = 10_000\nconst LEVEL_RANK: Record<ClaimRiskLevel, number> = { none: 0, low: 1, medium: 2, high: 3 }\n\nfunction parseNumeric(value: NumericAggregateValue): number {\n  if (value === null) return 0\n  const parsed = Number(value)\n  return Number.isFinite(parsed) ? parsed : 0\n}\n\nfunction parseNullableNumeric(value: NumericAggregateValue): number | null {\n  if (value === null) return null\n  const parsed = Number(value)\n  return Number.isFinite(parsed) ? parsed : null\n}\n\nfunction roundQuantity(value: number): number {\n  return Math.round((value + Number.EPSILON) * QUANTITY_SCALE) / QUANTITY_SCALE\n}\n\nfunction isMissingTableError(err: unknown, tableName: string): boolean {\n  if (typeof err !== 'object' || err === null) return false\n  const candidate = err as { code?: unknown; message?: unknown }\n  return candidate.code === '42P01'\n    || (typeof candidate.message === 'string'\n      && candidate.message.includes(tableName)\n      && candidate.message.includes('does not exist'))\n}\n\nfunction maxRiskLevel(signals: ClaimRiskSignal[]): ClaimRiskLevel {\n  let level: ClaimRiskLevel = 'none'\n  for (const signal of signals) {\n    if (LEVEL_RANK[signal.level] > LEVEL_RANK[level]) {\n      level = signal.level\n    }\n  }\n  return level\n}\n\nfunction riskWindowStart(now = new Date()): Date {\n  return new Date(now.getTime() - RISK_WINDOW_DAYS * 24 * 60 * 60 * 1000)\n}\n\nexport async function evaluateClaimRisk(\n  em: EntityManager,\n  claim: WarrantyClaim,\n  lines: WarrantyClaimLine[],\n  now = new Date(),\n): Promise<ClaimRiskAssessment> {\n  const db = em.getKysely<WarrantyClaimsRiskDb>()\n  const signals: ClaimRiskSignal[] = []\n  const scope = { tenantId: claim.tenantId, organizationId: claim.organizationId }\n  const serials = Array.from(new Set(lines\n    .map((line) => line.serialNumber?.trim() ?? '')\n    .filter((serial): serial is string => serial.length > 0)))\n\n  if (serials.length > 0) {\n    const rows = await db\n      .selectFrom('warranty_claim_lines')\n      .innerJoin('warranty_claims', 'warranty_claims.id', 'warranty_claim_lines.claim_id')\n      .select([\n        'warranty_claim_lines.serial_number as serialNumber',\n        'warranty_claims.claim_number as claimNumber',\n      ])\n      .where('warranty_claim_lines.tenant_id', '=', scope.tenantId)\n      .where('warranty_claim_lines.organization_id', '=', scope.organizationId)\n      .where('warranty_claim_lines.deleted_at', 'is', null)\n      .where('warranty_claims.tenant_id', '=', scope.tenantId)\n      .where('warranty_claims.organization_id', '=', scope.organizationId)\n      .where('warranty_claims.deleted_at', 'is', null)\n      .where('warranty_claims.id', '!=', claim.id)\n      .where('warranty_claims.status', '!=', 'cancelled')\n      .where('warranty_claim_lines.serial_number', 'in', serials)\n      .execute()\n\n    const relatedBySerial = new Map<string, Set<string>>()\n    for (const row of rows) {\n      if (!row.serialNumber || !row.claimNumber) continue\n      const related = relatedBySerial.get(row.serialNumber) ?? new Set<string>()\n      related.add(row.claimNumber)\n      relatedBySerial.set(row.serialNumber, related)\n    }\n\n    for (const serial of serials) {\n      const related = relatedBySerial.get(serial)\n      if (!related || related.size === 0) continue\n      signals.push({\n        id: 'duplicate_serial',\n        level: DUPLICATE_SERIAL_LEVEL,\n        messageKey: 'warranty_claims.risk.duplicateSerial',\n        params: { serial, count: related.size },\n        relatedClaimNumbers: Array.from(related).sort((left, right) => left.localeCompare(right)),\n      })\n    }\n  }\n\n  const orderId = claim.orderId ?? null\n  if (orderId) {\n    const orderRows = await db\n      .selectFrom('warranty_claims')\n      .select('claim_number as claimNumber')\n      .where('tenant_id', '=', scope.tenantId)\n      .where('organization_id', '=', scope.organizationId)\n      .where('deleted_at', 'is', null)\n      .where('order_id', '=', orderId)\n      .where('status', '!=', 'cancelled')\n      .where('id', '!=', claim.id)\n      .execute()\n    const relatedOrderClaims = Array.from(new Set(\n      orderRows\n        .map((row) => row.claimNumber)\n        .filter((claimNumber): claimNumber is string => typeof claimNumber === 'string' && claimNumber.length > 0),\n    )).sort((left, right) => left.localeCompare(right))\n    if (relatedOrderClaims.length > 0) {\n      signals.push({\n        id: 'duplicate_order_claim',\n        level: 'medium',\n        messageKey: 'warranty_claims.risk.duplicateOrderClaim',\n        params: { count: relatedOrderClaims.length },\n        relatedClaimNumbers: relatedOrderClaims,\n      })\n    }\n  }\n\n  if (orderId && (claim.claimType === 'return' || claim.claimType === 'core_return')) {\n    const settings = await loadWarrantyClaimSettings(em, scope)\n    const returnWindowDays = settings?.returnWindowDays ?? null\n    if (returnWindowDays !== null && returnWindowDays > 0) {\n      let order: { placedAt: Date | string | null; createdAt: Date | string | null } | undefined\n      try {\n        order = await db\n          .selectFrom('sales_orders')\n          .select(['placed_at as placedAt', 'created_at as createdAt'])\n          .where('id', '=', orderId)\n          .where('tenant_id', '=', scope.tenantId)\n          .where('organization_id', '=', scope.organizationId)\n          .where('deleted_at', 'is', null)\n          .executeTakeFirst()\n      } catch (err) {\n        if (!isMissingTableError(err, 'sales_orders')) throw err\n      }\n\n      const anchorValue = order?.placedAt ?? order?.createdAt ?? null\n      if (anchorValue !== null) {\n        const anchor = anchorValue instanceof Date ? anchorValue : new Date(anchorValue)\n        if (!Number.isNaN(anchor.getTime())) {\n          const days = Math.floor((now.getTime() - anchor.getTime()) / MILLISECONDS_PER_DAY)\n          if (days > returnWindowDays) {\n            signals.push({\n              id: 'outside_return_window',\n              level: days > 2 * returnWindowDays ? 'high' : 'medium',\n              messageKey: 'warranty_claims.risk.outsideReturnWindow',\n              params: { days, window: returnWindowDays },\n            })\n          }\n        }\n      }\n    }\n  }\n\n  const currentQuantityByOrderLine = new Map<string, number>()\n  for (const line of lines) {\n    const orderLineId = line.orderLineId ?? null\n    if (!orderLineId || line.deletedAt || line.lineStatus === 'rejected') continue\n    const current = currentQuantityByOrderLine.get(orderLineId) ?? 0\n    currentQuantityByOrderLine.set(orderLineId, roundQuantity(current + parseNumeric(line.qtyClaimed)))\n  }\n  const orderLineIds = Array.from(currentQuantityByOrderLine.keys()).sort((left, right) => left.localeCompare(right))\n  if (orderLineIds.length > 0) {\n    let soldRows: Array<{ id: string; quantity: string | number | null }>\n    try {\n      soldRows = await db\n        .selectFrom('sales_order_lines')\n        .select(['id', 'quantity'])\n        .where('tenant_id', '=', scope.tenantId)\n        .where('organization_id', '=', scope.organizationId)\n        .where('deleted_at', 'is', null)\n        .where('id', 'in', orderLineIds)\n        .execute()\n    } catch (err) {\n      if (!isMissingTableError(err, 'sales_order_lines')) throw err\n      soldRows = []\n    }\n\n    const soldByOrderLine = new Map<string, number>()\n    for (const row of soldRows) {\n      const quantity = parseNullableNumeric(row.quantity)\n      if (quantity !== null) soldByOrderLine.set(row.id, roundQuantity(quantity))\n    }\n    const scopedOrderLineIds = orderLineIds.filter((id) => soldByOrderLine.has(id))\n    if (scopedOrderLineIds.length > 0) {\n      const otherRows = await db\n        .selectFrom('warranty_claim_lines')\n        .innerJoin('warranty_claims', 'warranty_claims.id', 'warranty_claim_lines.claim_id')\n        .select([\n          'warranty_claim_lines.order_line_id as orderLineId',\n          'warranty_claim_lines.qty_claimed as qtyClaimed',\n          'warranty_claims.claim_number as claimNumber',\n        ])\n        .where('warranty_claim_lines.tenant_id', '=', scope.tenantId)\n        .where('warranty_claim_lines.organization_id', '=', scope.organizationId)\n        .where('warranty_claim_lines.deleted_at', 'is', null)\n        .where('warranty_claim_lines.line_status', '!=', 'rejected')\n        .where('warranty_claim_lines.order_line_id', 'in', scopedOrderLineIds)\n        .where('warranty_claims.tenant_id', '=', scope.tenantId)\n        .where('warranty_claims.organization_id', '=', scope.organizationId)\n        .where('warranty_claims.deleted_at', 'is', null)\n        .where('warranty_claims.id', '!=', claim.id)\n        .where('warranty_claims.status', '!=', 'cancelled')\n        .execute()\n\n      const otherQuantityByOrderLine = new Map<string, number>()\n      const relatedClaimsByOrderLine = new Map<string, Set<string>>()\n      for (const row of otherRows) {\n        if (!row.orderLineId) continue\n        const current = otherQuantityByOrderLine.get(row.orderLineId) ?? 0\n        otherQuantityByOrderLine.set(row.orderLineId, roundQuantity(current + parseNumeric(row.qtyClaimed)))\n        if (row.claimNumber) {\n          const related = relatedClaimsByOrderLine.get(row.orderLineId) ?? new Set<string>()\n          related.add(row.claimNumber)\n          relatedClaimsByOrderLine.set(row.orderLineId, related)\n        }\n      }\n\n      for (const orderLineId of scopedOrderLineIds) {\n        const sold = soldByOrderLine.get(orderLineId)\n        if (sold === undefined) continue\n        const count = roundQuantity(\n          (currentQuantityByOrderLine.get(orderLineId) ?? 0)\n          + (otherQuantityByOrderLine.get(orderLineId) ?? 0),\n        )\n        if (count <= sold) continue\n        signals.push({\n          id: 'over_quantity_claim',\n          level: count >= sold * 2 ? 'high' : 'medium',\n          messageKey: 'warranty_claims.risk.overQuantityClaim',\n          params: { count, sold },\n          relatedClaimNumbers: Array.from(relatedClaimsByOrderLine.get(orderLineId) ?? [])\n            .sort((left, right) => left.localeCompare(right)),\n        })\n      }\n    }\n  }\n\n  const customerId = claim.customerId ?? null\n  if (customerId) {\n    const windowStart = riskWindowStart(now)\n    const repeatRow = await db\n      .selectFrom('warranty_claims')\n      .select(sql<NumericAggregateValue>`count(*)`.as('count'))\n      .where('tenant_id', '=', scope.tenantId)\n      .where('organization_id', '=', scope.organizationId)\n      .where('deleted_at', 'is', null)\n      .where('customer_id', '=', customerId)\n      .where('created_at', '>=', windowStart)\n      .where('status', '!=', 'cancelled')\n      .where('id', '!=', claim.id)\n      .executeTakeFirst()\n    const otherClaimCount = Math.trunc(parseNumeric(repeatRow?.count ?? null))\n    const windowClaimCount = otherClaimCount + 1\n    if (windowClaimCount >= REPEAT_CLAIMER_MEDIUM_COUNT) {\n      signals.push({\n        id: 'repeat_claimer',\n        level: windowClaimCount >= REPEAT_CLAIMER_HIGH_COUNT ? 'high' : 'medium',\n        messageKey: 'warranty_claims.risk.repeatClaimer',\n        params: { count: otherClaimCount },\n      })\n    }\n\n    const currencyCode = claim.currencyCode?.trim() || null\n    if (currencyCode) {\n      const valueRow = await db\n        .selectFrom('warranty_claims')\n        .select(sql<NumericAggregateValue>`coalesce(sum(total_claimed_amount), 0)`.as('total'))\n        .where('tenant_id', '=', scope.tenantId)\n        .where('organization_id', '=', scope.organizationId)\n        .where('deleted_at', 'is', null)\n        .where('customer_id', '=', customerId)\n        .where('currency_code', '=', currencyCode)\n        .where('created_at', '>=', windowStart)\n        .where('status', '!=', 'cancelled')\n        .executeTakeFirst()\n      const total = parseNumeric(valueRow?.total ?? null)\n      if (total >= VALUE_VELOCITY_MEDIUM_TOTAL) {\n        signals.push({\n          id: 'value_velocity',\n          level: total >= VALUE_VELOCITY_HIGH_TOTAL ? 'high' : 'medium',\n          messageKey: 'warranty_claims.risk.valueVelocity',\n          params: { total: Number(total.toFixed(2)), currencyCode },\n        })\n      }\n    }\n  }\n\n  return { level: maxRiskLevel(signals), signals }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/warranty_claims/lib/settings.js

@@ -0,0 +1,55 @@
+import { DEFAULT_SLA_HOURS } from "../data/constants.js";
+import { WarrantyClaimSettings } from "../data/entities.js";
+const WARRANTY_CLAIM_SETTINGS_DEFAULTS = {
+  slaHours: DEFAULT_SLA_HOURS,
+  slaPauseOnInfoRequested: true,
+  slaAtRiskThresholdPct: 75,
+  autoApproveEnabled: false,
+  autoApproveMaxAmount: null,
+  autoApproveCurrencyCode: null,
+  autoApproveRequireInWarranty: true,
+  defaultWarrantyMonths: null,
+  businessHours: null,
+  escalationTiers: null,
+  adjudicationUseRules: false,
+  quarantineGrades: null,
+  returnLabelProvider: null
+};
+function parseNullableNumber(value) {
+  if (value === null || value === void 0) return null;
+  const parsed = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+async function loadWarrantyClaimSettings(em, scope) {
+  if (!scope.organizationId) return null;
+  return em.findOne(WarrantyClaimSettings, {
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    deletedAt: null
+  });
+}
+async function resolveEffectiveWarrantyClaimSettings(em, scope) {
+  const settings = await loadWarrantyClaimSettings(em, scope);
+  if (!settings) return WARRANTY_CLAIM_SETTINGS_DEFAULTS;
+  return {
+    slaHours: settings.slaHours ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.slaHours,
+    slaPauseOnInfoRequested: settings.slaPauseOnInfoRequested ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.slaPauseOnInfoRequested,
+    slaAtRiskThresholdPct: settings.slaAtRiskThresholdPct ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.slaAtRiskThresholdPct,
+    autoApproveEnabled: settings.autoApproveEnabled ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.autoApproveEnabled,
+    autoApproveMaxAmount: parseNullableNumber(settings.autoApproveMaxAmount),
+    autoApproveCurrencyCode: settings.autoApproveCurrencyCode ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.autoApproveCurrencyCode,
+    autoApproveRequireInWarranty: settings.autoApproveRequireInWarranty ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.autoApproveRequireInWarranty,
+    defaultWarrantyMonths: settings.defaultWarrantyMonths ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.defaultWarrantyMonths,
+    businessHours: settings.businessHours ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.businessHours,
+    escalationTiers: settings.escalationTiers ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.escalationTiers,
+    adjudicationUseRules: settings.adjudicationUseRules ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.adjudicationUseRules,
+    quarantineGrades: settings.quarantineGrades ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.quarantineGrades,
+    returnLabelProvider: settings.returnLabelProvider ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.returnLabelProvider
+  };
+}
+export {
+  WARRANTY_CLAIM_SETTINGS_DEFAULTS,
+  loadWarrantyClaimSettings,
+  resolveEffectiveWarrantyClaimSettings
+};
+//# sourceMappingURL=settings.js.map

package/dist/modules/warranty_claims/lib/settings.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/warranty_claims/lib/settings.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { DEFAULT_SLA_HOURS } from '../data/constants'\nimport { WarrantyClaimSettings } from '../data/entities'\n\nexport type WarrantyClaimEffectiveSettings = {\n  slaHours: number\n  slaPauseOnInfoRequested: boolean\n  slaAtRiskThresholdPct: number\n  autoApproveEnabled: boolean\n  autoApproveMaxAmount: number | null\n  autoApproveCurrencyCode: string | null\n  autoApproveRequireInWarranty: boolean\n  defaultWarrantyMonths: number | null\n  businessHours: Record<string, unknown> | null\n  escalationTiers: unknown[] | null\n  adjudicationUseRules: boolean\n  quarantineGrades: string[] | null\n  returnLabelProvider: string | null\n}\n\nexport const WARRANTY_CLAIM_SETTINGS_DEFAULTS: WarrantyClaimEffectiveSettings = {\n  slaHours: DEFAULT_SLA_HOURS,\n  slaPauseOnInfoRequested: true,\n  slaAtRiskThresholdPct: 75,\n  autoApproveEnabled: false,\n  autoApproveMaxAmount: null,\n  autoApproveCurrencyCode: null,\n  autoApproveRequireInWarranty: true,\n  defaultWarrantyMonths: null,\n  businessHours: null,\n  escalationTiers: null,\n  adjudicationUseRules: false,\n  quarantineGrades: null,\n  returnLabelProvider: null,\n}\n\nfunction parseNullableNumber(value: string | number | null | undefined): number | null {\n  if (value === null || value === undefined) return null\n  const parsed = typeof value === 'number' ? value : Number(value)\n  return Number.isFinite(parsed) ? parsed : null\n}\n\nexport async function loadWarrantyClaimSettings(\n  em: EntityManager,\n  scope: { tenantId: string; organizationId: string | null },\n): Promise<WarrantyClaimSettings | null> {\n  if (!scope.organizationId) return null\n  return em.findOne(WarrantyClaimSettings, {\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n    deletedAt: null,\n  })\n}\n\nexport async function resolveEffectiveWarrantyClaimSettings(\n  em: EntityManager,\n  scope: { tenantId: string; organizationId: string | null },\n): Promise<WarrantyClaimEffectiveSettings> {\n  const settings = await loadWarrantyClaimSettings(em, scope)\n  if (!settings) return WARRANTY_CLAIM_SETTINGS_DEFAULTS\n  return {\n    slaHours: settings.slaHours ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.slaHours,\n    slaPauseOnInfoRequested: settings.slaPauseOnInfoRequested ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.slaPauseOnInfoRequested,\n    slaAtRiskThresholdPct: settings.slaAtRiskThresholdPct ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.slaAtRiskThresholdPct,\n    autoApproveEnabled: settings.autoApproveEnabled ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.autoApproveEnabled,\n    autoApproveMaxAmount: parseNullableNumber(settings.autoApproveMaxAmount),\n    autoApproveCurrencyCode: settings.autoApproveCurrencyCode ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.autoApproveCurrencyCode,\n    autoApproveRequireInWarranty: settings.autoApproveRequireInWarranty ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.autoApproveRequireInWarranty,\n    defaultWarrantyMonths: settings.defaultWarrantyMonths ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.defaultWarrantyMonths,\n    businessHours: settings.businessHours ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.businessHours,\n    escalationTiers: settings.escalationTiers ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.escalationTiers,\n    adjudicationUseRules: settings.adjudicationUseRules ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.adjudicationUseRules,\n    quarantineGrades: settings.quarantineGrades ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.quarantineGrades,\n    returnLabelProvider: settings.returnLabelProvider ?? WARRANTY_CLAIM_SETTINGS_DEFAULTS.returnLabelProvider,\n  }\n}\n"],
+  "mappings": "AACA,SAAS,yBAAyB;AAClC,SAAS,6BAA6B;AAkB/B,MAAM,mCAAmE;AAAA,EAC9E,UAAU;AAAA,EACV,yBAAyB;AAAA,EACzB,uBAAuB;AAAA,EACvB,oBAAoB;AAAA,EACpB,sBAAsB;AAAA,EACtB,yBAAyB;AAAA,EACzB,8BAA8B;AAAA,EAC9B,uBAAuB;AAAA,EACvB,eAAe;AAAA,EACf,iBAAiB;AAAA,EACjB,sBAAsB;AAAA,EACtB,kBAAkB;AAAA,EAClB,qBAAqB;AACvB;AAEA,SAAS,oBAAoB,OAA0D;AACrF,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,QAAM,SAAS,OAAO,UAAU,WAAW,QAAQ,OAAO,KAAK;AAC/D,SAAO,OAAO,SAAS,MAAM,IAAI,SAAS;AAC5C;AAEA,eAAsB,0BACpB,IACA,OACuC;AACvC,MAAI,CAAC,MAAM,eAAgB,QAAO;AAClC,SAAO,GAAG,QAAQ,uBAAuB;AAAA,IACvC,UAAU,MAAM;AAAA,IAChB,gBAAgB,MAAM;AAAA,IACtB,WAAW;AAAA,EACb,CAAC;AACH;AAEA,eAAsB,sCACpB,IACA,OACyC;AACzC,QAAM,WAAW,MAAM,0BAA0B,IAAI,KAAK;AAC1D,MAAI,CAAC,SAAU,QAAO;AACtB,SAAO;AAAA,IACL,UAAU,SAAS,YAAY,iCAAiC;AAAA,IAChE,yBAAyB,SAAS,2BAA2B,iCAAiC;AAAA,IAC9F,uBAAuB,SAAS,yBAAyB,iCAAiC;AAAA,IAC1F,oBAAoB,SAAS,sBAAsB,iCAAiC;AAAA,IACpF,sBAAsB,oBAAoB,SAAS,oBAAoB;AAAA,IACvE,yBAAyB,SAAS,2BAA2B,iCAAiC;AAAA,IAC9F,8BAA8B,SAAS,gCAAgC,iCAAiC;AAAA,IACxG,uBAAuB,SAAS,yBAAyB,iCAAiC;AAAA,IAC1F,eAAe,SAAS,iBAAiB,iCAAiC;AAAA,IAC1E,iBAAiB,SAAS,mBAAmB,iCAAiC;AAAA,IAC9E,sBAAsB,SAAS,wBAAwB,iCAAiC;AAAA,IACxF,kBAAkB,SAAS,oBAAoB,iCAAiC;AAAA,IAChF,qBAAqB,SAAS,uBAAuB,iCAAiC;AAAA,EACxF;AACF;",
+  "names": []
+}

package/dist/modules/warranty_claims/lib/stateMachine.js

@@ -0,0 +1,88 @@
+import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
+import { CLAIM_STATUS_TRANSITIONS } from "../data/constants.js";
+import { claimTypeAllowsLineFinancialAdjustments } from "./claimTypeConfig.js";
+const lineStatusGuards = {
+  // `approved -> resolved` supports the credit-only / field-destroy flow where no
+  // physical return is received (the line is resolved without the goods lifecycle).
+  pending: ["approved", "rejected"],
+  approved: ["received", "resolved"],
+  rejected: [],
+  received: ["inspected"],
+  inspected: ["resolved"],
+  resolved: []
+};
+const approvedRollupStatuses = /* @__PURE__ */ new Set(["approved", "received", "inspected", "resolved"]);
+const resolvedHeaderLineStatuses = /* @__PURE__ */ new Set(["rejected", "resolved"]);
+const terminalStatuses = /* @__PURE__ */ new Set(["closed", "cancelled"]);
+function amount(value) {
+  if (value === null || value === void 0) return 0;
+  const parsed = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+function lineCreditAmount(line) {
+  return amount(line.creditAmount ?? line.credit_amount);
+}
+function lineRestockingFee(line) {
+  return amount(line.restockingFee ?? line.restocking_fee);
+}
+function lineCoreCreditAmount(line) {
+  return amount(line.coreCreditAmount ?? line.core_credit_amount);
+}
+function lineStatus(line) {
+  return line.lineStatus ?? line.line_status ?? null;
+}
+function isDeleted(line) {
+  return Boolean(line.deletedAt ?? line.deleted_at ?? null);
+}
+function nextStatuses(status) {
+  return [...CLAIM_STATUS_TRANSITIONS[status] ?? []];
+}
+function canTransition(from, to) {
+  return nextStatuses(from).includes(to);
+}
+function assertTransition(from, to) {
+  if (canTransition(from, to)) return;
+  throw new CrudHttpError(400, { error: "warranty_claims.errors.invalidTransition" });
+}
+function isTerminal(status) {
+  return terminalStatuses.has(status);
+}
+function canResolveWithLineStatuses(lines) {
+  return lines.every((line) => {
+    if (isDeleted(line)) return true;
+    const status = lineStatus(line);
+    return Boolean(status && resolvedHeaderLineStatuses.has(status));
+  });
+}
+const ROLLUP_AMOUNT_SCALE = 1e4;
+function roundRollupAmount(value) {
+  return Math.round((value + Number.EPSILON) * ROLLUP_AMOUNT_SCALE) / ROLLUP_AMOUNT_SCALE;
+}
+function computeHeaderRollups(lines, options) {
+  const applyFinancialAdjustments = options?.claimType === void 0 ? true : claimTypeAllowsLineFinancialAdjustments(options.claimType);
+  let totalClaimedAmount = 0;
+  let totalApprovedAmount = 0;
+  for (const line of lines) {
+    if (isDeleted(line)) continue;
+    const creditAmount = lineCreditAmount(line);
+    totalClaimedAmount += creditAmount;
+    const status = lineStatus(line);
+    if (status && approvedRollupStatuses.has(status)) {
+      totalApprovedAmount += applyFinancialAdjustments ? Math.max(0, creditAmount - lineRestockingFee(line) + lineCoreCreditAmount(line)) : Math.max(0, creditAmount);
+    }
+  }
+  return {
+    totalClaimedAmount: roundRollupAmount(totalClaimedAmount),
+    totalApprovedAmount: roundRollupAmount(totalApprovedAmount)
+  };
+}
+export {
+  assertTransition,
+  canResolveWithLineStatuses,
+  canTransition,
+  computeHeaderRollups,
+  isTerminal,
+  lineStatusGuards,
+  nextStatuses
+};
+//# sourceMappingURL=stateMachine.js.map

package/dist/modules/warranty_claims/lib/stateMachine.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/warranty_claims/lib/stateMachine.ts"],
+  "sourcesContent": ["import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { CLAIM_STATUS_TRANSITIONS } from '../data/constants'\nimport type { WarrantyClaimLineStatus, WarrantyClaimStatus } from '../data/validators'\nimport { claimTypeAllowsLineFinancialAdjustments } from './claimTypeConfig'\n\ntype AmountValue = number | string | null | undefined\n\nexport type ClaimLineRollupInput = {\n  creditAmount?: AmountValue\n  credit_amount?: AmountValue\n  restockingFee?: AmountValue\n  restocking_fee?: AmountValue\n  coreCreditAmount?: AmountValue\n  core_credit_amount?: AmountValue\n  lineStatus?: WarrantyClaimLineStatus | null\n  line_status?: WarrantyClaimLineStatus | null\n  deletedAt?: Date | string | null\n  deleted_at?: Date | string | null\n}\n\nexport const lineStatusGuards: Record<WarrantyClaimLineStatus, readonly WarrantyClaimLineStatus[]> = {\n  // `approved -> resolved` supports the credit-only / field-destroy flow where no\n  // physical return is received (the line is resolved without the goods lifecycle).\n  pending: ['approved', 'rejected'],\n  approved: ['received', 'resolved'],\n  rejected: [],\n  received: ['inspected'],\n  inspected: ['resolved'],\n  resolved: [],\n}\n\nconst approvedRollupStatuses = new Set<WarrantyClaimLineStatus>(['approved', 'received', 'inspected', 'resolved'])\nconst resolvedHeaderLineStatuses = new Set<WarrantyClaimLineStatus>(['rejected', 'resolved'])\nconst terminalStatuses = new Set<WarrantyClaimStatus>(['closed', 'cancelled'])\n\nfunction amount(value: AmountValue): number {\n  if (value === null || value === undefined) return 0\n  const parsed = typeof value === 'number' ? value : Number(value)\n  return Number.isFinite(parsed) ? parsed : 0\n}\n\nfunction lineCreditAmount(line: ClaimLineRollupInput): number {\n  return amount(line.creditAmount ?? line.credit_amount)\n}\n\nfunction lineRestockingFee(line: ClaimLineRollupInput): number {\n  return amount(line.restockingFee ?? line.restocking_fee)\n}\n\nfunction lineCoreCreditAmount(line: ClaimLineRollupInput): number {\n  return amount(line.coreCreditAmount ?? line.core_credit_amount)\n}\n\nfunction lineStatus(line: ClaimLineRollupInput): WarrantyClaimLineStatus | null {\n  return line.lineStatus ?? line.line_status ?? null\n}\n\nfunction isDeleted(line: ClaimLineRollupInput): boolean {\n  return Boolean(line.deletedAt ?? line.deleted_at ?? null)\n}\n\nexport function nextStatuses(status: WarrantyClaimStatus): WarrantyClaimStatus[] {\n  return [...(CLAIM_STATUS_TRANSITIONS[status] ?? [])]\n}\n\nexport function canTransition(from: WarrantyClaimStatus, to: WarrantyClaimStatus): boolean {\n  return nextStatuses(from).includes(to)\n}\n\nexport function assertTransition(from: WarrantyClaimStatus, to: WarrantyClaimStatus): void {\n  if (canTransition(from, to)) return\n  throw new CrudHttpError(400, { error: 'warranty_claims.errors.invalidTransition' })\n}\n\nexport function isTerminal(status: string): boolean {\n  return (terminalStatuses as Set<string>).has(status)\n}\n\nexport function canResolveWithLineStatuses(lines: readonly ClaimLineRollupInput[]): boolean {\n  return lines.every((line) => {\n    if (isDeleted(line)) return true\n    const status = lineStatus(line)\n    return Boolean(status && resolvedHeaderLineStatuses.has(status))\n  })\n}\n\n// Matches the numeric(18,4) scale of the warranty_claims total columns so the\n// float sums serialize without artifacts like \"0.30000000000000004\".\nconst ROLLUP_AMOUNT_SCALE = 10_000\n\nfunction roundRollupAmount(value: number): number {\n  return Math.round((value + Number.EPSILON) * ROLLUP_AMOUNT_SCALE) / ROLLUP_AMOUNT_SCALE\n}\n\nexport function computeHeaderRollups(\n  lines: readonly ClaimLineRollupInput[],\n  options?: { claimType?: string | null },\n): {\n  totalClaimedAmount: number\n  totalApprovedAmount: number\n} {\n  // Restocking / core adjustments only belong to return-family claims. When a claimType is\n  // supplied, warranty and vendor-recovery claims roll up the credit amount alone so they can\n  // never inherit a return's restock/core math (LINE-05). When omitted, behavior is unchanged.\n  const applyFinancialAdjustments = options?.claimType === undefined\n    ? true\n    : claimTypeAllowsLineFinancialAdjustments(options.claimType)\n  let totalClaimedAmount = 0\n  let totalApprovedAmount = 0\n\n  for (const line of lines) {\n    if (isDeleted(line)) continue\n    const creditAmount = lineCreditAmount(line)\n    totalClaimedAmount += creditAmount\n\n    const status = lineStatus(line)\n    if (status && approvedRollupStatuses.has(status)) {\n      // A restocking fee larger than the line's credit must not drag the\n      // approved header total negative \u2014 clamp the line contribution at zero.\n      totalApprovedAmount += applyFinancialAdjustments\n        ? Math.max(0, creditAmount - lineRestockingFee(line) + lineCoreCreditAmount(line))\n        : Math.max(0, creditAmount)\n    }\n  }\n\n  return {\n    totalClaimedAmount: roundRollupAmount(totalClaimedAmount),\n    totalApprovedAmount: roundRollupAmount(totalApprovedAmount),\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAC9B,SAAS,gCAAgC;AAEzC,SAAS,+CAA+C;AAiBjD,MAAM,mBAAwF;AAAA;AAAA;AAAA,EAGnG,SAAS,CAAC,YAAY,UAAU;AAAA,EAChC,UAAU,CAAC,YAAY,UAAU;AAAA,EACjC,UAAU,CAAC;AAAA,EACX,UAAU,CAAC,WAAW;AAAA,EACtB,WAAW,CAAC,UAAU;AAAA,EACtB,UAAU,CAAC;AACb;AAEA,MAAM,yBAAyB,oBAAI,IAA6B,CAAC,YAAY,YAAY,aAAa,UAAU,CAAC;AACjH,MAAM,6BAA6B,oBAAI,IAA6B,CAAC,YAAY,UAAU,CAAC;AAC5F,MAAM,mBAAmB,oBAAI,IAAyB,CAAC,UAAU,WAAW,CAAC;AAE7E,SAAS,OAAO,OAA4B;AAC1C,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,QAAM,SAAS,OAAO,UAAU,WAAW,QAAQ,OAAO,KAAK;AAC/D,SAAO,OAAO,SAAS,MAAM,IAAI,SAAS;AAC5C;AAEA,SAAS,iBAAiB,MAAoC;AAC5D,SAAO,OAAO,KAAK,gBAAgB,KAAK,aAAa;AACvD;AAEA,SAAS,kBAAkB,MAAoC;AAC7D,SAAO,OAAO,KAAK,iBAAiB,KAAK,cAAc;AACzD;AAEA,SAAS,qBAAqB,MAAoC;AAChE,SAAO,OAAO,KAAK,oBAAoB,KAAK,kBAAkB;AAChE;AAEA,SAAS,WAAW,MAA4D;AAC9E,SAAO,KAAK,cAAc,KAAK,eAAe;AAChD;AAEA,SAAS,UAAU,MAAqC;AACtD,SAAO,QAAQ,KAAK,aAAa,KAAK,cAAc,IAAI;AAC1D;AAEO,SAAS,aAAa,QAAoD;AAC/E,SAAO,CAAC,GAAI,yBAAyB,MAAM,KAAK,CAAC,CAAE;AACrD;AAEO,SAAS,cAAc,MAA2B,IAAkC;AACzF,SAAO,aAAa,IAAI,EAAE,SAAS,EAAE;AACvC;AAEO,SAAS,iBAAiB,MAA2B,IAA+B;AACzF,MAAI,cAAc,MAAM,EAAE,EAAG;AAC7B,QAAM,IAAI,cAAc,KAAK,EAAE,OAAO,2CAA2C,CAAC;AACpF;AAEO,SAAS,WAAW,QAAyB;AAClD,SAAQ,iBAAiC,IAAI,MAAM;AACrD;AAEO,SAAS,2BAA2B,OAAiD;AAC1F,SAAO,MAAM,MAAM,CAAC,SAAS;AAC3B,QAAI,UAAU,IAAI,EAAG,QAAO;AAC5B,UAAM,SAAS,WAAW,IAAI;AAC9B,WAAO,QAAQ,UAAU,2BAA2B,IAAI,MAAM,CAAC;AAAA,EACjE,CAAC;AACH;AAIA,MAAM,sBAAsB;AAE5B,SAAS,kBAAkB,OAAuB;AAChD,SAAO,KAAK,OAAO,QAAQ,OAAO,WAAW,mBAAmB,IAAI;AACtE;AAEO,SAAS,qBACd,OACA,SAIA;AAIA,QAAM,4BAA4B,SAAS,cAAc,SACrD,OACA,wCAAwC,QAAQ,SAAS;AAC7D,MAAI,qBAAqB;AACzB,MAAI,sBAAsB;AAE1B,aAAW,QAAQ,OAAO;AACxB,QAAI,UAAU,IAAI,EAAG;AACrB,UAAM,eAAe,iBAAiB,IAAI;AAC1C,0BAAsB;AAEtB,UAAM,SAAS,WAAW,IAAI;AAC9B,QAAI,UAAU,uBAAuB,IAAI,MAAM,GAAG;AAGhD,6BAAuB,4BACnB,KAAK,IAAI,GAAG,eAAe,kBAAkB,IAAI,IAAI,qBAAqB,IAAI,CAAC,IAC/E,KAAK,IAAI,GAAG,YAAY;AAAA,IAC9B;AAAA,EACF;AAEA,SAAO;AAAA,IACL,oBAAoB,kBAAkB,kBAAkB;AAAA,IACxD,qBAAqB,kBAAkB,mBAAmB;AAAA,EAC5D;AACF;",
+  "names": []
+}

package/dist/modules/warranty_claims/lib/timelineFilters.js

@@ -0,0 +1,16 @@
+const TIMELINE_FILTERS = ["all", "comments", "status_changes", "customer_visible"];
+function isTimelineFilterId(value) {
+  return TIMELINE_FILTERS.includes(value);
+}
+function filterTimelineEvents(events, filter) {
+  if (filter === "comments") return events.filter((event) => event.kind === "comment");
+  if (filter === "status_changes") return events.filter((event) => event.kind === "status_changed");
+  if (filter === "customer_visible") return events.filter((event) => event.visibility === "customer");
+  return events;
+}
+export {
+  TIMELINE_FILTERS,
+  filterTimelineEvents,
+  isTimelineFilterId
+};
+//# sourceMappingURL=timelineFilters.js.map

package/dist/modules/warranty_claims/lib/timelineFilters.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/warranty_claims/lib/timelineFilters.ts"],
+  "sourcesContent": ["export const TIMELINE_FILTERS = ['all', 'comments', 'status_changes', 'customer_visible'] as const\n\nexport type TimelineFilterId = (typeof TIMELINE_FILTERS)[number]\n\nexport type TimelineFilterableEvent = {\n  kind: string\n  visibility: string\n}\n\nexport function isTimelineFilterId(value: string): value is TimelineFilterId {\n  return (TIMELINE_FILTERS as readonly string[]).includes(value)\n}\n\nexport function filterTimelineEvents<TEvent extends TimelineFilterableEvent>(\n  events: TEvent[],\n  filter: TimelineFilterId,\n): TEvent[] {\n  if (filter === 'comments') return events.filter((event) => event.kind === 'comment')\n  if (filter === 'status_changes') return events.filter((event) => event.kind === 'status_changed')\n  if (filter === 'customer_visible') return events.filter((event) => event.visibility === 'customer')\n  return events\n}\n"],
+  "mappings": "AAAO,MAAM,mBAAmB,CAAC,OAAO,YAAY,kBAAkB,kBAAkB;AASjF,SAAS,mBAAmB,OAA0C;AAC3E,SAAQ,iBAAuC,SAAS,KAAK;AAC/D;AAEO,SAAS,qBACd,QACA,QACU;AACV,MAAI,WAAW,WAAY,QAAO,OAAO,OAAO,CAAC,UAAU,MAAM,SAAS,SAAS;AACnF,MAAI,WAAW,iBAAkB,QAAO,OAAO,OAAO,CAAC,UAAU,MAAM,SAAS,gBAAgB;AAChG,MAAI,WAAW,mBAAoB,QAAO,OAAO,OAAO,CAAC,UAAU,MAAM,eAAe,UAAU;AAClG,SAAO;AACT;",
+  "names": []
+}