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

package/src/modules/warranty_claims/lib/vendorPolicyRecovery.ts

@@ -0,0 +1,182 @@
+import { computeHeaderRollups } from './stateMachine'
+import type { WarrantyClaimLineStatus } from '../data/validators'
+
+type AmountValue = number | string | null | undefined
+
+export type VendorRecoveryClaimInput = {
+  id: string
+  claimType?: string | null
+  status?: string | null
+  reasonCode?: string | null
+  vendorName?: string | null
+}
+
+export type VendorRecoveryLineInput = {
+  id: string
+  lineNo?: number
+  productName?: string | null
+  sku?: string | null
+  vendorName?: string | null
+  lineStatus?: WarrantyClaimLineStatus | null
+  vendorClaimLineId?: string | null
+  faultCode?: string | null
+  creditAmount?: AmountValue
+  credit_amount?: AmountValue
+  restockingFee?: AmountValue
+  restocking_fee?: AmountValue
+  coreCreditAmount?: AmountValue
+  core_credit_amount?: AmountValue
+}
+
+export type VendorPolicyRecoveryInput = {
+  id: string
+  vendorName: string
+  vendorRef?: string | null
+  claimableReasonCodes?: readonly string[] | null
+  recoveryRatePct?: number | string | null
+  autoGenerateRecovery?: boolean | null
+  isActive?: boolean | null
+}
+
+export type VendorRecoveryMatch = {
+  line: VendorRecoveryLineInput
+  policy: VendorPolicyRecoveryInput
+  estimatedRecovery: string | null
+  causalFault: string | null
+}
+
+export type VendorRecoveryCommandRequest = {
+  claimId: string
+  vendorName: string
+  vendorRef: string | null
+  lineIds: string[]
+}
+
+function normalizeText(value: string | null | undefined): string | null {
+  const normalized = value?.trim()
+  return normalized ? normalized : null
+}
+
+function normalizeVendorKey(value: string | null | undefined): string | null {
+  return normalizeText(value)?.toLocaleLowerCase() ?? null
+}
+
+function normalizeReasonCodes(codes: readonly string[] | null | undefined): string[] {
+  if (!Array.isArray(codes)) return []
+  const result: string[] = []
+  for (const code of codes) {
+    const normalized = normalizeText(code)
+    if (normalized && !result.includes(normalized)) result.push(normalized)
+  }
+  return result
+}
+
+function reasonMatchesPolicy(policy: VendorPolicyRecoveryInput, reasonCode: string | null): boolean {
+  const claimableReasonCodes = normalizeReasonCodes(policy.claimableReasonCodes)
+  if (!claimableReasonCodes.length) return true
+  if (!reasonCode) return false
+  return claimableReasonCodes.includes(reasonCode)
+}
+
+function reasonMatchRank(policy: VendorPolicyRecoveryInput, reasonCode: string | null): number {
+  const claimableReasonCodes = normalizeReasonCodes(policy.claimableReasonCodes)
+  if (reasonCode && claimableReasonCodes.includes(reasonCode)) return 0
+  return claimableReasonCodes.length ? 2 : 1
+}
+
+function parseRecoveryRatePct(value: number | string | null | undefined): number | null {
+  if (typeof value === 'number') return Number.isFinite(value) ? value : null
+  if (typeof value !== 'string') return null
+  const parsed = Number(value)
+  return Number.isFinite(parsed) ? parsed : null
+}
+
+function formatMoney(value: number): string {
+  if (!Number.isFinite(value)) return '0.00'
+  return (Math.round(value * 100) / 100).toFixed(2)
+}
+
+function estimateRecovery(line: VendorRecoveryLineInput, policy: VendorPolicyRecoveryInput): string | null {
+  const rate = parseRecoveryRatePct(policy.recoveryRatePct)
+  if (rate === null) return null
+  const approvedAmount = computeHeaderRollups([line]).totalApprovedAmount
+  return formatMoney(approvedAmount * (rate / 100))
+}
+
+function selectMatchingPolicy(
+  line: VendorRecoveryLineInput,
+  policies: readonly VendorPolicyRecoveryInput[],
+  reasonCode: string | null,
+  autoOnly: boolean,
+  claimVendorName: string | null,
+): VendorPolicyRecoveryInput | null {
+  // Fall back to the claim-level vendor name: the standard line editors do not expose a
+  // per-line vendor field, so without this fallback automatic matching was unreachable from
+  // normal intake (VENDOR-05).
+  const vendorKey = normalizeVendorKey(line.vendorName) ?? normalizeVendorKey(claimVendorName)
+  if (!vendorKey) return null
+  const candidates = policies
+    .filter((policy) => policy.isActive !== false)
+    .filter((policy) => !autoOnly || policy.autoGenerateRecovery === true)
+    .filter((policy) => normalizeVendorKey(policy.vendorName) === vendorKey)
+    .filter((policy) => reasonMatchesPolicy(policy, reasonCode))
+    .sort((left, right) => reasonMatchRank(left, reasonCode) - reasonMatchRank(right, reasonCode))
+  return candidates[0] ?? null
+}
+
+export function isWarrantyClaimResolvedForVendorRecovery(claim: VendorRecoveryClaimInput): boolean {
+  return claim.claimType === 'warranty' && (claim.status === 'resolved' || claim.status === 'closed')
+}
+
+export function findVendorRecoveryMatches(input: {
+  claim: VendorRecoveryClaimInput
+  lines: readonly VendorRecoveryLineInput[]
+  policies: readonly VendorPolicyRecoveryInput[]
+  autoOnly?: boolean
+  requireWarrantyResolved?: boolean
+}): VendorRecoveryMatch[] {
+  if (input.requireWarrantyResolved === true && !isWarrantyClaimResolvedForVendorRecovery(input.claim)) {
+    return []
+  }
+  const reasonCode = normalizeText(input.claim.reasonCode)
+  const claimVendorName = normalizeText(input.claim.vendorName)
+  const matches: VendorRecoveryMatch[] = []
+  for (const line of input.lines) {
+    if (line.lineStatus !== 'resolved') continue
+    if (normalizeText(line.vendorClaimLineId)) continue
+    const policy = selectMatchingPolicy(line, input.policies, reasonCode, input.autoOnly === true, claimVendorName)
+    if (!policy) continue
+    matches.push({
+      line,
+      policy,
+      estimatedRecovery: estimateRecovery(line, policy),
+      causalFault: normalizeText(line.faultCode) ?? reasonCode,
+    })
+  }
+  return matches
+}
+
+export function buildVendorRecoveryCommandRequests(
+  claimId: string,
+  matches: readonly VendorRecoveryMatch[],
+): VendorRecoveryCommandRequest[] {
+  const grouped = new Map<string, VendorRecoveryCommandRequest>()
+  for (const match of matches) {
+    const vendorName = normalizeText(match.policy.vendorName) ?? normalizeText(match.line.vendorName)
+    if (!vendorName) continue
+    const vendorRef = normalizeText(match.policy.vendorRef)
+    const key = `${match.policy.id}:${vendorName}:${vendorRef ?? ''}`
+    const existing = grouped.get(key)
+    if (existing) {
+      existing.lineIds.push(match.line.id)
+      continue
+    }
+    grouped.set(key, {
+      claimId,
+      vendorName,
+      vendorRef,
+      lineIds: [match.line.id],
+    })
+  }
+  return Array.from(grouped.values())
+}

package/src/modules/warranty_claims/lib/warrantyPreview.ts

@@ -0,0 +1,20 @@
+export type WarrantyEntitlementPreview = 'in_warranty' | 'out_of_warranty' | 'unknown'
+
+export function addWarrantyMonths(date: Date, months: number): Date {
+  const target = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + months, 1))
+  const lastDay = new Date(Date.UTC(target.getUTCFullYear(), target.getUTCMonth() + 1, 0)).getUTCDate()
+  const copy = new Date(date.getTime())
+  copy.setUTCDate(1)
+  copy.setUTCFullYear(target.getUTCFullYear(), target.getUTCMonth(), Math.min(date.getUTCDate(), lastDay))
+  return copy
+}
+
+export function computeWarrantyEntitlementPreview(
+  purchaseDate: Date | null,
+  warrantyMonths: number | null,
+  at: Date = new Date(),
+): WarrantyEntitlementPreview {
+  if (!purchaseDate || Number.isNaN(purchaseDate.getTime())) return 'unknown'
+  if (warrantyMonths === null || !Number.isFinite(warrantyMonths)) return 'unknown'
+  return addWarrantyMonths(purchaseDate, warrantyMonths).getTime() >= at.getTime() ? 'in_warranty' : 'out_of_warranty'
+}