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

package/src/modules/warranty_claims/backend/warranty_claims/vendor-policies/vendorPolicyForm.tsx

@@ -0,0 +1,220 @@
+"use client"
+
+import * as React from 'react'
+import type { CrudField, CrudFieldOption, CrudFormGroup } from '@open-mercato/ui/backend/CrudForm'
+import { Switch } from '@open-mercato/ui/primitives/switch'
+import type { TranslateFn } from '@open-mercato/shared/lib/i18n/context'
+import { fetchClaimReasonOptions } from '../../components/claimReasonOptions'
+
+export type VendorPolicyRecord = {
+  id: string
+  vendorName: string | null
+  vendorRef: string | null
+  coverageMonths: number | null
+  claimableReasonCodes: string[] | null
+  recoveryRatePct: string | null
+  contactEmail: string | null
+  autoGenerateRecovery: boolean
+  isActive: boolean
+  updatedAt: string | null
+}
+
+export type VendorPolicyFormValues = Partial<VendorPolicyRecord> & {
+  claimableReasonCodesCsv?: string | string[] | null
+} & Record<string, unknown>
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+function toStringOrNull(value: unknown): string | null {
+  return typeof value === 'string' && value.trim().length ? value.trim() : null
+}
+
+function toNumberOrNull(value: unknown): number | null {
+  if (typeof value === 'number') return Number.isFinite(value) ? value : null
+  if (typeof value !== 'string' || !value.trim()) return null
+  const parsed = Number(value)
+  return Number.isFinite(parsed) ? parsed : null
+}
+
+function toStringArray(value: unknown): string[] | null {
+  if (!Array.isArray(value)) return null
+  return value
+    .filter((entry): entry is string => typeof entry === 'string')
+    .map((entry) => entry.trim())
+    .filter(Boolean)
+}
+
+function nullableText(value: unknown): string | null {
+  return toStringOrNull(value)
+}
+
+function nullableInteger(value: unknown): number | null {
+  const parsed = toNumberOrNull(value)
+  if (parsed === null) return null
+  return Number.isInteger(parsed) && parsed >= 0 ? parsed : null
+}
+
+function nullableDecimalString(value: unknown): string | null {
+  if (typeof value === 'number') return Number.isFinite(value) ? String(value) : null
+  if (typeof value !== 'string') return null
+  const trimmed = value.trim()
+  return trimmed ? trimmed : null
+}
+
+function parseReasonCodes(value: unknown): string[] {
+  if (Array.isArray(value)) return toStringArray(value) ?? []
+  if (typeof value !== 'string') return []
+  const result: string[] = []
+  for (const part of value.split(',')) {
+    const normalized = part.trim()
+    if (normalized && !result.includes(normalized)) result.push(normalized)
+  }
+  return result
+}
+
+function createSwitchField(
+  id: 'autoGenerateRecovery' | 'isActive',
+  label: string,
+  enabledLabel: string,
+  disabledLabel: string,
+  description?: string,
+): CrudField {
+  return {
+    id,
+    label,
+    type: 'custom',
+    description,
+    component: ({ value, setValue, disabled }) => {
+      const checked = value === true
+      return (
+        <div className="flex items-center gap-3">
+          <Switch
+            aria-label={label}
+            checked={checked}
+            disabled={disabled}
+            onCheckedChange={(next) => setValue(next)}
+          />
+          <span className="text-sm text-muted-foreground">
+            {checked ? enabledLabel : disabledLabel}
+          </span>
+        </div>
+      )
+    },
+  }
+}
+
+export function normalizeVendorPolicy(value: unknown): VendorPolicyRecord | null {
+  if (!isRecord(value)) return null
+  const id = toStringOrNull(value.id)
+  if (!id) return null
+  return {
+    id,
+    vendorName: toStringOrNull(value.vendorName),
+    vendorRef: toStringOrNull(value.vendorRef),
+    coverageMonths: toNumberOrNull(value.coverageMonths),
+    claimableReasonCodes: toStringArray(value.claimableReasonCodes),
+    recoveryRatePct: toStringOrNull(value.recoveryRatePct),
+    contactEmail: toStringOrNull(value.contactEmail),
+    autoGenerateRecovery: value.autoGenerateRecovery === true,
+    isActive: value.isActive !== false,
+    updatedAt: toStringOrNull(value.updatedAt),
+  }
+}
+
+export function toVendorPolicyInitialValues(policy: VendorPolicyRecord): VendorPolicyFormValues {
+  return {
+    ...policy,
+    claimableReasonCodesCsv: policy.claimableReasonCodes ?? [],
+  }
+}
+
+export function buildVendorPolicyPayload(values: VendorPolicyFormValues, id?: string): Record<string, unknown> {
+  const payload: Record<string, unknown> = {}
+  if (id) payload.id = id
+  payload.vendorName = nullableText(values.vendorName) ?? ''
+  payload.vendorRef = nullableText(values.vendorRef)
+  payload.coverageMonths = nullableInteger(values.coverageMonths)
+  payload.claimableReasonCodes = parseReasonCodes(values.claimableReasonCodesCsv ?? values.claimableReasonCodes)
+  payload.recoveryRatePct = nullableDecimalString(values.recoveryRatePct)
+  payload.contactEmail = nullableText(values.contactEmail)
+  payload.autoGenerateRecovery = values.autoGenerateRecovery === true
+  payload.isActive = values.isActive !== false
+  return payload
+}
+
+export function useVendorPolicyFormConfig(t: TranslateFn): { fields: CrudField[]; groups: CrudFormGroup[] } {
+  const loadReasonCodeOptions = React.useCallback(() => fetchClaimReasonOptions(t), [t])
+
+  const fields = React.useMemo<CrudField[]>(() => [
+    {
+      id: 'vendorName',
+      label: t('warranty_claims.vendorPolicies.form.vendorName', 'Vendor name'),
+      type: 'text',
+      required: true,
+    },
+    {
+      id: 'vendorRef',
+      label: t('warranty_claims.vendorPolicies.form.vendorRef', 'Vendor reference'),
+      type: 'text',
+    },
+    {
+      id: 'contactEmail',
+      label: t('warranty_claims.vendorPolicies.form.contactEmail', 'Contact email'),
+      type: 'text',
+    },
+    {
+      id: 'coverageMonths',
+      label: t('warranty_claims.vendorPolicies.form.coverageMonths', 'Coverage months'),
+      type: 'number',
+    },
+    {
+      id: 'claimableReasonCodesCsv',
+      label: t('warranty_claims.vendorPolicies.form.claimableReasonCodes', 'Claimable reason codes'),
+      type: 'tags',
+      layout: 'full',
+      loadOptions: loadReasonCodeOptions,
+      placeholder: t('warranty_claims.vendorPolicies.form.claimableReasonCodes.placeholder', 'Add reason code'),
+      description: t('warranty_claims.vendorPolicies.form.claimableReasonCodes.multiHelp', 'Pick claim reasons from the dictionary, or type a custom code and press Enter. Leave empty to match any reason.'),
+    },
+    {
+      id: 'recoveryRatePct',
+      label: t('warranty_claims.vendorPolicies.form.recoveryRatePct', 'Recovery rate percent'),
+      type: 'number',
+    },
+    createSwitchField(
+      'autoGenerateRecovery',
+      t('warranty_claims.vendorPolicies.form.autoGenerateRecovery', 'Auto-generate recovery'),
+      t('warranty_claims.vendorPolicies.form.autoGenerateRecovery.enabled', 'Automatic recovery enabled'),
+      t('warranty_claims.vendorPolicies.form.autoGenerateRecovery.disabled', 'Manual suggestion only'),
+      t('warranty_claims.vendorPolicies.form.autoGenerateRecovery.help', 'When enabled, resolved matching lines generate supplier recovery claims automatically.'),
+    ),
+    createSwitchField(
+      'isActive',
+      t('warranty_claims.vendorPolicies.form.isActive', 'Active'),
+      t('warranty_claims.vendorPolicies.form.isActive.enabled', 'Policy active'),
+      t('warranty_claims.vendorPolicies.form.isActive.disabled', 'Policy inactive'),
+    ),
+  ], [loadReasonCodeOptions, t])
+
+  const groups = React.useMemo<CrudFormGroup[]>(() => [
+    {
+      id: 'identity',
+      title: t('warranty_claims.vendorPolicies.form.group.identity', 'Vendor'),
+      fields: ['vendorName', 'vendorRef', 'contactEmail'],
+    },
+    {
+      id: 'coverage',
+      title: t('warranty_claims.vendorPolicies.form.group.coverage', 'Coverage'),
+      fields: ['coverageMonths', 'claimableReasonCodesCsv', 'recoveryRatePct'],
+    },
+    {
+      id: 'automation',
+      title: t('warranty_claims.vendorPolicies.form.group.automation', 'Automation'),
+      fields: ['autoGenerateRecovery', 'isActive'],
+    },
+  ], [t])
+
+  return { fields, groups }
+}

package/src/modules/warranty_claims/ce.ts

@@ -0,0 +1,44 @@
+export const entities = [
+  {
+    id: 'warranty_claims:warranty_claim',
+    label: 'Warranty Claim',
+    description: 'Warranty, return, core-return, or vendor-recovery claim.',
+    labelField: 'claimNumber',
+    showInSidebar: false,
+    fields: [],
+  },
+  {
+    id: 'warranty_claims:warranty_claim_line',
+    label: 'Warranty Claim Line',
+    description: 'Line-level product, quantity, disposition, and inspection details for a claim.',
+    labelField: 'lineNo',
+    showInSidebar: false,
+    fields: [],
+  },
+  {
+    id: 'warranty_claims:warranty_claim_registration',
+    label: 'Warranty Registration',
+    description: 'Product/serial registration = entitlement base.',
+    labelField: 'serialNumber',
+    showInSidebar: false,
+    fields: [],
+  },
+  {
+    id: 'warranty_claims:warranty_vendor_policy',
+    label: 'Warranty Vendor Policy',
+    description: 'Per-vendor warranty policy for supplier recovery.',
+    labelField: 'vendorName',
+    showInSidebar: false,
+    fields: [],
+  },
+  {
+    id: 'warranty_claims:warranty_troubleshooting_guide',
+    label: 'Warranty Troubleshooting Guide',
+    description: 'Guided troubleshooting decision tree.',
+    labelField: 'title',
+    showInSidebar: false,
+    fields: [],
+  },
+]
+
+export default entities