@open-mercato/core 0.4.8-develop-d16e2f51dc → 0.4.8-develop-4b58cde65d

package/dist/modules/sales/widgets/injection/document-history/widget.client.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/modules/sales/widgets/injection/document-history/widget.client.tsx"],
-  "sourcesContent": ["\"use client\"\n\nimport * as React from \"react\"\nimport { Spinner } from \"@open-mercato/ui/primitives/spinner\"\nimport { useT } from \"@open-mercato/shared/lib/i18n/context\"\nimport { apiCall } from \"@open-mercato/ui/backend/utils/apiCall\"\nimport { formatRelativeTime, formatDateTime } from \"@open-mercato/shared/lib/time\"\nimport { cn } from \"@open-mercato/shared/lib/utils\"\nimport type { InjectionWidgetComponentProps } from '@open-mercato/shared/modules/widgets/injection'\nimport { ArrowRightLeft, Zap, MessageSquare, User, Filter, ChevronDown, Check } from 'lucide-react'\n\nexport type TimelineEntry = {\n  id: string\n  occurredAt: string\n  kind: \"status\" | \"action\" | \"comment\"\n  action: string\n  actor: { id: string | null; label: string }\n  source: \"action_log\" | \"note\"\n  metadata?: {\n    statusFrom?: string | null\n    statusTo?: string | null\n    documentKind?: \"order\" | \"quote\"\n    commandId?: string\n  }\n}\n\ntype StatusOption = {\n  value: string\n  label: string\n  color: string | null\n  icon: string | null\n}\n\ntype TimelineContext = {\n  kind: \"order\" | \"quote\"\n  record: { id: string }\n}\n\nconst isValidContext = (ctx: unknown): ctx is TimelineContext =>\n  ctx !== null &&\n  typeof ctx === 'object' &&\n  'kind' in ctx &&\n  'record' in ctx &&\n  ((ctx as TimelineContext).kind === 'order' || (ctx as TimelineContext).kind === 'quote') &&\n  typeof (ctx as TimelineContext).record === 'object' &&\n  (ctx as TimelineContext).record !== null &&\n  'id' in (ctx as TimelineContext).record &&\n  typeof (ctx as TimelineContext).record.id === 'string'\n\nconst KIND_ICONS = {\n  status: ArrowRightLeft,\n  action: Zap,\n  comment: MessageSquare,\n}\n\nconst KIND_ICON_COLORS = {\n  status: 'text-foreground',\n  action: 'text-foreground',\n  comment: 'text-foreground',\n}\n\nconst KIND_BG_COLORS = {\n  status: 'bg-muted',\n  action: 'bg-muted',\n  comment: 'bg-muted',\n}\n\nfunction StatusDot({ color, className }: { color: string | null | undefined; className?: string }) {\n  if (!color) return <span className={cn('h-2.5 w-2.5 rounded-full bg-muted-foreground/40 border border-border inline-flex', className)} />\n  return (\n    <span\n      className={cn('h-2.5 w-2.5 rounded-full border border-border/60 inline-flex', className)}\n      style={{ backgroundColor: color }}\n      aria-hidden\n    />\n  )\n}\n\nfunction StatusTransition({\n  statusFrom,\n  statusTo,\n  statusMap,\n}: {\n  statusFrom: string | null | undefined\n  statusTo: string | null | undefined\n  statusMap: Record<string, StatusOption>\n}) {\n  const from = statusFrom ? (statusMap[statusFrom] ?? { value: statusFrom, label: statusFrom, color: null, icon: null }) : null\n  const to = statusTo ? (statusMap[statusTo] ?? { value: statusTo, label: statusTo, color: null, icon: null }) : null\n\n  return (\n    <div className=\"flex items-center gap-1.5 flex-wrap\">\n      {from ? (\n        <span className=\"inline-flex items-center gap-1 text-xs text-muted-foreground\">\n          <StatusDot color={from.color} />\n          <span>{from.label}</span>\n        </span>\n      ) : null}\n      {from && to ? (\n        <ArrowRightLeft className=\"h-3 w-3 text-muted-foreground/60 shrink-0\" />\n      ) : null}\n      {to ? (\n        <span className=\"inline-flex items-center gap-1 text-xs font-medium text-foreground\">\n          <StatusDot color={to.color} />\n          <span>{to.label}</span>\n        </span>\n      ) : null}\n    </div>\n  )\n}\n\nfunction TimelineItem({\n  entry,\n  statusMap,\n  isLast,\n}: {\n  entry: TimelineEntry\n  statusMap: Record<string, StatusOption>\n  isLast: boolean\n}) {\n  const KindIcon = KIND_ICONS[entry.kind]\n  const relativeTime = formatRelativeTime(entry.occurredAt)\n  const absoluteTime = formatDateTime(entry.occurredAt)\n\n  const isStatusChange = entry.kind === 'status' && entry.metadata?.statusTo\n\n  return (\n    <div data-testid=\"timeline-entry\" className=\"relative flex gap-3\">\n      {/* Vertical connector line */}\n      {!isLast && (\n        <div className=\"absolute left-[11px] top-6 bottom-0 w-px bg-border\" aria-hidden />\n      )}\n\n      {/* Icon circle */}\n      <div\n        className={cn(\n          'relative z-10 flex h-6 w-6 shrink-0 items-center justify-center rounded-full border border-border',\n          KIND_BG_COLORS[entry.kind],\n        )}\n      >\n        <KindIcon className={cn('h-3 w-3', KIND_ICON_COLORS[entry.kind])} aria-hidden />\n      </div>\n\n      {/* Content card */}\n      <div className=\"flex-1 pb-4\">\n        <div className=\"group rounded-lg border bg-card p-3 space-y-1.5\">\n          {/* Header: actor + time */}\n          <div className=\"flex items-center justify-between gap-2 flex-wrap\">\n            <span className=\"inline-flex items-center gap-1.5 text-xs font-medium text-foreground\">\n              <User className=\"h-3 w-3 text-muted-foreground\" aria-hidden />\n              {entry.actor.label}\n            </span>\n            <span\n              className=\"text-xs text-muted-foreground\"\n              title={absoluteTime ?? undefined}\n            >\n              {relativeTime ?? absoluteTime}\n            </span>\n          </div>\n\n          {/* Body */}\n          {isStatusChange ? (\n            <StatusTransition\n              statusFrom={entry.metadata?.statusFrom}\n              statusTo={entry.metadata?.statusTo}\n              statusMap={statusMap}\n            />\n          ) : (\n            <div className=\"text-sm text-foreground\">{entry.action}</div>\n          )}\n        </div>\n      </div>\n    </div>\n  )\n}\n\ntype FilterKind = 'all' | 'status' | 'action' | 'comment'\n\ntype FilterOption = { value: FilterKind; label: string }\n\nfunction FilterDropdown({ filter, onChange }: { filter: FilterKind; onChange: (kind: FilterKind) => void }) {\n  const t = useT()\n  const [open, setOpen] = React.useState(false)\n  const ref = React.useRef<HTMLDivElement>(null)\n\n  React.useEffect(() => {\n    if (!open) return\n    function onDocClick(e: MouseEvent) {\n      if (ref.current && !ref.current.contains(e.target as Node)) setOpen(false)\n    }\n    function onKey(e: KeyboardEvent) {\n      if (e.key === 'Escape') setOpen(false)\n    }\n    document.addEventListener('mousedown', onDocClick)\n    document.addEventListener('keydown', onKey)\n    return () => {\n      document.removeEventListener('mousedown', onDocClick)\n      document.removeEventListener('keydown', onKey)\n    }\n  }, [open])\n\n  const options: FilterOption[] = [\n    { value: 'all', label: t('sales.documents.history.filter.all', 'All') },\n    { value: 'status', label: t('sales.documents.history.filter.status', 'Status changes') },\n    { value: 'action', label: t('sales.documents.history.filter.actions', 'Actions') },\n    { value: 'comment', label: t('sales.documents.history.filter.comments', 'Comments') },\n  ]\n\n  const activeLabel = options.find(o => o.value === filter)?.label\n\n  return (\n    <div className=\"relative\" ref={ref}>\n      <button\n        type=\"button\"\n        aria-haspopup=\"listbox\"\n        aria-expanded={open}\n        onClick={() => setOpen(prev => !prev)}\n        className=\"inline-flex items-center gap-1.5 rounded-md border border-input bg-background px-2.5 py-1 text-xs font-medium shadow-sm hover:bg-accent hover:text-accent-foreground transition-colors select-none\"\n      >\n        <Filter className=\"h-3 w-3\" aria-hidden />\n        {t('sales.documents.history.filter.label', 'Filters')}\n        {filter !== 'all' && (\n          <span className=\"text-muted-foreground\">: {activeLabel}</span>\n        )}\n        <ChevronDown className={cn('h-3 w-3 transition-transform duration-150', open && 'rotate-180')} aria-hidden />\n      </button>\n      {open && (\n        <div\n          role=\"listbox\"\n          aria-label={t('sales.documents.history.filter.label', 'Filters')}\n          className=\"absolute left-0 top-full mt-1 z-50 w-48 rounded-md border bg-background p-1 shadow-md\"\n        >\n          {options.map(opt => (\n            <button\n              key={opt.value}\n              type=\"button\"\n              role=\"option\"\n              aria-selected={filter === opt.value}\n              onClick={() => { onChange(opt.value); setOpen(false) }}\n              className=\"flex w-full items-center gap-2 rounded px-2 py-1.5 text-sm hover:bg-accent\"\n            >\n              <Check className={cn('h-3.5 w-3.5 shrink-0', filter === opt.value ? 'opacity-100' : 'opacity-0')} aria-hidden />\n              {opt.label}\n            </button>\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n\nexport const DocumentHistoryWidget: React.FC<InjectionWidgetComponentProps<unknown, unknown>> = ({ context }) => {\n  const t = useT()\n  const [entries, setEntries] = React.useState<TimelineEntry[]>([])\n  const [loading, setLoading] = React.useState(true)\n  const [error, setError] = React.useState<string | null>(null)\n  const [statusMap, setStatusMap] = React.useState<Record<string, StatusOption>>({})\n  const [filter, setFilter] = React.useState<FilterKind>('all')\n\n  React.useEffect(() => {\n    apiCall<{ items?: unknown[] }>('/api/sales/order-statuses?pageSize=100')\n      .then((res) => {\n        if (res.ok && Array.isArray(res.result?.items)) {\n          const map: Record<string, StatusOption> = {}\n          for (const item of res.result.items) {\n            if (!item || typeof item !== 'object') continue\n            const d = item as Record<string, unknown>\n            const value = typeof d.value === 'string' ? d.value : null\n            if (!value) continue\n            map[value] = {\n              value,\n              label: typeof d.label === 'string' && d.label.length ? d.label : value,\n              color: typeof d.color === 'string' && d.color.length ? d.color : null,\n              icon: typeof d.icon === 'string' && d.icon.length ? d.icon : null,\n            }\n          }\n          setStatusMap(map)\n        }\n      })\n      .catch(() => {})\n  }, [])\n\n  React.useEffect(() => {\n    if (!isValidContext(context)) {\n      setLoading(false)\n      setError(t(\"sales.documents.history.error\", \"Failed to load history.\"))\n      return\n    }\n\n    setLoading(true)\n    setError(null)\n    apiCall<{ items: TimelineEntry[] }>(\n      `/api/sales/document-history?kind=${context.kind}&id=${context.record.id}`\n    )\n      .then((res) => {\n        if (res.ok && Array.isArray(res.result?.items)) {\n          setEntries(res.result.items)\n        } else {\n          setError(t(\"sales.documents.history.error\", \"Failed to load history.\"))\n        }\n      })\n      .catch(() => setError(t(\"sales.documents.history.error\", \"Failed to load history.\")))\n      .finally(() => setLoading(false))\n  }, [context, t])\n\n  const filtered = React.useMemo(\n    () => filter === 'all' ? entries : entries.filter(e => e.kind === filter),\n    [entries, filter]\n  )\n\n  return (\n    <div className=\"space-y-4\">\n      {/* Filter dropdown */}\n      <div>\n        <FilterDropdown filter={filter} onChange={setFilter} />\n      </div>\n\n      {/* Content */}\n      {loading ? (\n        <div className=\"flex items-center justify-center h-24\">\n          <Spinner />\n        </div>\n      ) : error ? (\n        <div className=\"text-destructive text-sm\">{error}</div>\n      ) : !filtered.length ? (\n        <div className=\"text-muted-foreground text-sm py-6 text-center\">\n          {t(\"sales.documents.history.empty\", \"No history entries yet.\")}\n        </div>\n      ) : (\n        <div className=\"relative\">\n          {filtered.map((entry, index) => (\n            <TimelineItem\n              key={entry.id}\n              entry={entry}\n              statusMap={statusMap}\n              isLast={index === filtered.length - 1}\n            />\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n\nexport default DocumentHistoryWidget\n"],
-  "mappings": "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",
+  "sourcesContent": ["\"use client\"\n\nimport * as React from \"react\"\nimport { Spinner } from \"@open-mercato/ui/primitives/spinner\"\nimport { useT } from \"@open-mercato/shared/lib/i18n/context\"\nimport { apiCall } from \"@open-mercato/ui/backend/utils/apiCall\"\nimport { formatRelativeTime, formatDateTime } from \"@open-mercato/shared/lib/time\"\nimport { cn } from \"@open-mercato/shared/lib/utils\"\nimport type { InjectionWidgetComponentProps } from '@open-mercato/shared/modules/widgets/injection'\nimport { ArrowRightLeft, Zap, MessageSquare, User, Filter, ChevronDown, Check } from 'lucide-react'\n\nexport type TimelineEntry = {\n  id: string\n  occurredAt: string\n  kind: \"status\" | \"action\" | \"comment\"\n  action: string\n  actor: { id: string | null; label: string }\n  source: \"action_log\" | \"note\"\n  metadata?: {\n    statusFrom?: string | null\n    statusTo?: string | null\n    documentKind?: \"order\" | \"quote\"\n    commandId?: string\n  }\n}\n\ntype StatusOption = {\n  value: string\n  label: string\n  color: string | null\n  icon: string | null\n}\n\ntype TimelineContext = {\n  kind: \"order\" | \"quote\"\n  record: { id: string }\n}\n\nconst isValidContext = (ctx: unknown): ctx is TimelineContext =>\n  ctx !== null &&\n  typeof ctx === 'object' &&\n  'kind' in ctx &&\n  'record' in ctx &&\n  ((ctx as TimelineContext).kind === 'order' || (ctx as TimelineContext).kind === 'quote') &&\n  typeof (ctx as TimelineContext).record === 'object' &&\n  (ctx as TimelineContext).record !== null &&\n  'id' in (ctx as TimelineContext).record &&\n  typeof (ctx as TimelineContext).record.id === 'string'\n\nconst KIND_ICONS = {\n  status: ArrowRightLeft,\n  action: Zap,\n  comment: MessageSquare,\n}\n\nconst KIND_ICON_COLORS = {\n  status: 'text-foreground',\n  action: 'text-foreground',\n  comment: 'text-foreground',\n}\n\nconst KIND_BG_COLORS = {\n  status: 'bg-muted',\n  action: 'bg-muted',\n  comment: 'bg-muted',\n}\n\nfunction StatusDot({ color, className }: { color: string | null | undefined; className?: string }) {\n  if (!color) return <span className={cn('h-2.5 w-2.5 rounded-full bg-muted-foreground/40 border border-border inline-flex', className)} />\n  return (\n    <span\n      className={cn('h-2.5 w-2.5 rounded-full border border-border/60 inline-flex', className)}\n      style={{ backgroundColor: color }}\n      aria-hidden\n    />\n  )\n}\n\nfunction StatusTransition({\n  statusFrom,\n  statusTo,\n  statusMap,\n}: {\n  statusFrom: string | null | undefined\n  statusTo: string | null | undefined\n  statusMap: Record<string, StatusOption>\n}) {\n  const from = statusFrom ? (statusMap[statusFrom] ?? { value: statusFrom, label: statusFrom, color: null, icon: null }) : null\n  const to = statusTo ? (statusMap[statusTo] ?? { value: statusTo, label: statusTo, color: null, icon: null }) : null\n\n  return (\n    <div className=\"flex items-center gap-1.5 flex-wrap\">\n      {from ? (\n        <span className=\"inline-flex items-center gap-1 text-xs text-muted-foreground\">\n          <StatusDot color={from.color} />\n          <span>{from.label}</span>\n        </span>\n      ) : null}\n      {from && to ? (\n        <ArrowRightLeft className=\"h-3 w-3 text-muted-foreground/60 shrink-0\" />\n      ) : null}\n      {to ? (\n        <span className=\"inline-flex items-center gap-1 text-xs font-medium text-foreground\">\n          <StatusDot color={to.color} />\n          <span>{to.label}</span>\n        </span>\n      ) : null}\n    </div>\n  )\n}\n\nfunction TimelineItem({\n  entry,\n  statusMap,\n  isLast,\n}: {\n  entry: TimelineEntry\n  statusMap: Record<string, StatusOption>\n  isLast: boolean\n}) {\n  const KindIcon = KIND_ICONS[entry.kind]\n  const relativeTime = formatRelativeTime(entry.occurredAt)\n  const absoluteTime = formatDateTime(entry.occurredAt)\n\n  const isStatusChange = entry.kind === 'status' && entry.metadata?.statusTo\n\n  return (\n    <div data-testid=\"timeline-entry\" className=\"relative flex gap-3\">\n      {/* Vertical connector line */}\n      {!isLast && (\n        <div className=\"absolute left-[11px] top-6 bottom-0 w-px bg-border\" aria-hidden />\n      )}\n\n      {/* Icon circle */}\n      <div\n        className={cn(\n          'relative z-10 flex h-6 w-6 shrink-0 items-center justify-center rounded-full border border-border',\n          KIND_BG_COLORS[entry.kind],\n        )}\n      >\n        <KindIcon className={cn('h-3 w-3', KIND_ICON_COLORS[entry.kind])} aria-hidden />\n      </div>\n\n      {/* Content card */}\n      <div className=\"flex-1 pb-4\">\n        <div className=\"group rounded-lg border bg-card p-3 space-y-1.5\">\n          {/* Header: actor + time */}\n          <div className=\"flex items-center justify-between gap-2 flex-wrap\">\n            <span className=\"inline-flex items-center gap-1.5 text-xs font-medium text-foreground\">\n              <User className=\"h-3 w-3 text-muted-foreground\" aria-hidden />\n              {entry.actor.label}\n            </span>\n            <span\n              className=\"text-xs text-muted-foreground\"\n              title={absoluteTime ?? undefined}\n            >\n              {relativeTime ?? absoluteTime}\n            </span>\n          </div>\n\n          {/* Body */}\n          {isStatusChange ? (\n            <StatusTransition\n              statusFrom={entry.metadata?.statusFrom}\n              statusTo={entry.metadata?.statusTo}\n              statusMap={statusMap}\n            />\n          ) : (\n            <div className=\"text-sm text-foreground\">{entry.action}</div>\n          )}\n        </div>\n      </div>\n    </div>\n  )\n}\n\ntype FilterKind = 'all' | 'status' | 'action' | 'comment'\n\ntype FilterOption = { value: FilterKind; label: string }\n\nfunction FilterDropdown({ filter, onChange }: { filter: FilterKind; onChange: (kind: FilterKind) => void }) {\n  const t = useT()\n  const [open, setOpen] = React.useState(false)\n  const ref = React.useRef<HTMLDivElement>(null)\n\n  React.useEffect(() => {\n    if (!open) return\n    function onDocClick(e: MouseEvent) {\n      if (ref.current && !ref.current.contains(e.target as Node)) setOpen(false)\n    }\n    function onKey(e: KeyboardEvent) {\n      if (e.key === 'Escape') setOpen(false)\n    }\n    document.addEventListener('mousedown', onDocClick)\n    document.addEventListener('keydown', onKey)\n    return () => {\n      document.removeEventListener('mousedown', onDocClick)\n      document.removeEventListener('keydown', onKey)\n    }\n  }, [open])\n\n  const options: FilterOption[] = [\n    { value: 'all', label: t('sales.documents.history.filter.all', 'All') },\n    { value: 'status', label: t('sales.documents.history.filter.status', 'Status changes') },\n    { value: 'action', label: t('sales.documents.history.filter.actions', 'Actions') },\n    { value: 'comment', label: t('sales.documents.history.filter.comments', 'Comments') },\n  ]\n\n  const activeLabel = options.find(o => o.value === filter)?.label\n\n  return (\n    <div className=\"relative\" ref={ref}>\n      <button\n        type=\"button\"\n        aria-haspopup=\"listbox\"\n        aria-expanded={open}\n        onClick={() => setOpen(prev => !prev)}\n        className=\"inline-flex items-center gap-1.5 rounded-md border border-input bg-background px-2.5 py-1 text-xs font-medium shadow-sm hover:bg-accent hover:text-accent-foreground transition-colors select-none\"\n      >\n        <Filter className=\"h-3 w-3\" aria-hidden />\n        {t('sales.documents.history.filter.label', 'Filters')}\n        {filter !== 'all' && (\n          <span className=\"text-muted-foreground\">: {activeLabel}</span>\n        )}\n        <ChevronDown className={cn('h-3 w-3 transition-transform duration-150', open && 'rotate-180')} aria-hidden />\n      </button>\n      {open && (\n        <div\n          role=\"listbox\"\n          aria-label={t('sales.documents.history.filter.label', 'Filters')}\n          className=\"absolute left-0 top-full mt-1 z-50 w-48 rounded-md border bg-background p-1 shadow-md\"\n        >\n          {options.map(opt => (\n            <button\n              key={opt.value}\n              type=\"button\"\n              role=\"option\"\n              aria-selected={filter === opt.value}\n              onClick={() => { onChange(opt.value); setOpen(false) }}\n              className=\"flex w-full items-center gap-2 rounded px-2 py-1.5 text-sm hover:bg-accent\"\n            >\n              <Check className={cn('h-3.5 w-3.5 shrink-0', filter === opt.value ? 'opacity-100' : 'opacity-0')} aria-hidden />\n              {opt.label}\n            </button>\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n\nexport const DocumentHistoryWidget: React.FC<InjectionWidgetComponentProps<unknown, unknown>> = ({ context }) => {\n  const t = useT()\n  const [entries, setEntries] = React.useState<TimelineEntry[]>([])\n  const [loading, setLoading] = React.useState(true)\n  const [error, setError] = React.useState<string | null>(null)\n  const [statusMap, setStatusMap] = React.useState<Record<string, StatusOption>>({})\n  const [filter, setFilter] = React.useState<FilterKind>('all')\n\n  React.useEffect(() => {\n    const urls = [\n      '/api/sales/order-statuses?pageSize=100',\n      '/api/sales/shipment-statuses?pageSize=100',\n      '/api/sales/payment-statuses?pageSize=100',\n    ]\n    const map: Record<string, StatusOption> = {}\n    const merge = (items: unknown[]) => {\n      if (!Array.isArray(items)) return\n      for (const item of items) {\n        if (!item || typeof item !== 'object') continue\n        const d = item as Record<string, unknown>\n        const value = typeof d.value === 'string' ? d.value : null\n        if (!value) continue\n        map[value] = {\n          value,\n          label: typeof d.label === 'string' && d.label.length ? d.label : value,\n          color: typeof d.color === 'string' && d.color.length ? d.color : null,\n          icon: typeof d.icon === 'string' && d.icon.length ? d.icon : null,\n        }\n      }\n    }\n    Promise.all(urls.map((url) => apiCall<{ items?: unknown[] }>(url)))\n      .then((responses) => {\n        for (const res of responses) {\n          if (res.ok && Array.isArray(res.result?.items)) merge(res.result.items)\n        }\n        setStatusMap(map)\n      })\n      .catch(() => {})\n  }, [])\n\n  React.useEffect(() => {\n    if (!isValidContext(context)) {\n      setLoading(false)\n      setError(t(\"sales.documents.history.error\", \"Failed to load history.\"))\n      return\n    }\n\n    setLoading(true)\n    setError(null)\n    apiCall<{ items: TimelineEntry[] }>(\n      `/api/sales/document-history?kind=${context.kind}&id=${context.record.id}`\n    )\n      .then((res) => {\n        if (res.ok && Array.isArray(res.result?.items)) {\n          setEntries(res.result.items)\n        } else {\n          setError(t(\"sales.documents.history.error\", \"Failed to load history.\"))\n        }\n      })\n      .catch(() => setError(t(\"sales.documents.history.error\", \"Failed to load history.\")))\n      .finally(() => setLoading(false))\n  }, [context, t])\n\n  const filtered = React.useMemo(\n    () => filter === 'all' ? entries : entries.filter(e => e.kind === filter),\n    [entries, filter]\n  )\n\n  return (\n    <div className=\"space-y-4\">\n      {/* Filter dropdown */}\n      <div>\n        <FilterDropdown filter={filter} onChange={setFilter} />\n      </div>\n\n      {/* Content */}\n      {loading ? (\n        <div className=\"flex items-center justify-center h-24\">\n          <Spinner />\n        </div>\n      ) : error ? (\n        <div className=\"text-destructive text-sm\">{error}</div>\n      ) : !filtered.length ? (\n        <div className=\"text-muted-foreground text-sm py-6 text-center\">\n          {t(\"sales.documents.history.empty\", \"No history entries yet.\")}\n        </div>\n      ) : (\n        <div className=\"relative\">\n          {filtered.map((entry, index) => (\n            <TimelineItem\n              key={entry.id}\n              entry={entry}\n              statusMap={statusMap}\n              isLast={index === filtered.length - 1}\n            />\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n\nexport default DocumentHistoryWidget\n"],
+  "mappings": "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",
   "names": []
 }

package/generated/entities/sales_return/index.ts

@@ -0,0 +1,14 @@
+export const id = 'id'
+export const order = 'order'
+export const organization_id = 'organization_id'
+export const tenant_id = 'tenant_id'
+export const return_number = 'return_number'
+export const status_entry_id = 'status_entry_id'
+export const status = 'status'
+export const reason = 'reason'
+export const notes = 'notes'
+export const returned_at = 'returned_at'
+export const created_at = 'created_at'
+export const updated_at = 'updated_at'
+export const deleted_at = 'deleted_at'
+export const lines = 'lines'

package/generated/entities/sales_return_line/index.ts

@@ -0,0 +1,13 @@
+export const id = 'id'
+export const sales_return = 'sales_return'
+export const order_line = 'order_line'
+export const organization_id = 'organization_id'
+export const tenant_id = 'tenant_id'
+export const quantity_returned = 'quantity_returned'
+export const unit_price_net = 'unit_price_net'
+export const unit_price_gross = 'unit_price_gross'
+export const total_net_amount = 'total_net_amount'
+export const total_gross_amount = 'total_gross_amount'
+export const created_at = 'created_at'
+export const updated_at = 'updated_at'
+export const deleted_at = 'deleted_at'

package/generated/entities.ids.generated.ts

@@ -135,6 +135,8 @@ export const E = {
     "sales_quote_adjustment": "sales:sales_quote_adjustment",
     "sales_shipment": "sales:sales_shipment",
     "sales_shipment_item": "sales:sales_shipment_item",
+    "sales_return": "sales:sales_return",
+    "sales_return_line": "sales:sales_return_line",
     "sales_invoice": "sales:sales_invoice",
     "sales_invoice_line": "sales:sales_invoice_line",
     "sales_credit_memo": "sales:sales_credit_memo",

package/generated/entity-fields-registry.ts

@@ -121,6 +121,8 @@ import * as sales_payment_method from './entities/sales_payment_method/index'
 import * as sales_quote from './entities/sales_quote/index'
 import * as sales_quote_adjustment from './entities/sales_quote_adjustment/index'
 import * as sales_quote_line from './entities/sales_quote_line/index'
+import * as sales_return from './entities/sales_return/index'
+import * as sales_return_line from './entities/sales_return_line/index'
 import * as sales_settings from './entities/sales_settings/index'
 import * as sales_shipment from './entities/sales_shipment/index'
 import * as sales_shipment_item from './entities/sales_shipment_item/index'
@@ -277,6 +279,8 @@ export const entityFieldsRegistry: Record<string, Record<string, string>> = {
   sales_quote,
   sales_quote_adjustment,
   sales_quote_line,
+  sales_return,
+  sales_return_line,
   sales_settings,
   sales_shipment,
   sales_shipment_item,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.4.8-develop-d16e2f51dc",
+  "version": "0.4.8-develop-4b58cde65d",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -217,10 +217,10 @@
     "semver": "^7.6.3"
   },
   "peerDependencies": {
-    "@open-mercato/shared": "0.4.8-develop-d16e2f51dc"
+    "@open-mercato/shared": "0.4.8-develop-4b58cde65d"
   },
   "devDependencies": {
-    "@open-mercato/shared": "0.4.8-develop-d16e2f51dc",
+    "@open-mercato/shared": "0.4.8-develop-4b58cde65d",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",

package/src/modules/sales/AGENTS.md

@@ -45,6 +45,7 @@ const calcService = container.resolve('salesCalculationService')
 ### Fulfillment
 - **Shipments** — delivery tracking. MUST follow status workflow
 - **Payments** — payment recording. MUST follow status workflow
+- **Returns** — order returns with line selection; create return generates line-level adjustments (kind `return`, negative amounts), updates `returned_quantity`, recalculates order totals. Use `sales.return.create` command; list via `GET /api/sales/returns?orderId=...`
 
 ### Configuration — MUST NOT Modify Directly
 - **Channels** — sales channels (web, POS). Configure via admin UI

package/src/modules/sales/acl.ts

@@ -9,6 +9,8 @@ export const features = [
   { id: 'sales.documents.number.edit', title: 'Edit sales document numbers', module: 'sales' },
   { id: 'sales.shipments.manage', title: 'Manage order shipments', module: 'sales' },
   { id: 'sales.payments.manage', title: 'Manage order payments', module: 'sales' },
+  { id: 'sales.returns.view', title: 'View order returns', module: 'sales' },
+  { id: 'sales.returns.create', title: 'Create order returns', module: 'sales' },
   { id: 'sales.invoices.manage', title: 'Manage sales invoices', module: 'sales' },
   { id: 'sales.credit_memos.manage', title: 'Manage credit memos', module: 'sales' },
   { id: 'sales.channels.manage', title: 'Manage sales channels', module: 'sales' },

package/src/modules/sales/api/document-history/route.ts

@@ -29,6 +29,26 @@ const querySchema = z.object({
   types: z.string().optional(), // comma-separated: status,action,comment
 })
 
+export type DocumentHistoryEntryKind = 'status' | 'action' | 'comment'
+
+const HISTORY_TYPES: ReadonlySet<DocumentHistoryEntryKind> = new Set(['status', 'action', 'comment'])
+
+export function parseDocumentHistoryTypes(input: string | null | undefined): Set<DocumentHistoryEntryKind> {
+  const raw = typeof input === 'string' ? input.trim() : ''
+  if (!raw) return new Set()
+  const values = raw
+    .split(',')
+    .map((part) => part.trim().toLowerCase())
+    .filter((value) => value.length > 0)
+  const result = new Set<DocumentHistoryEntryKind>()
+  values.forEach((value) => {
+    if (HISTORY_TYPES.has(value as DocumentHistoryEntryKind)) {
+      result.add(value as DocumentHistoryEntryKind)
+    }
+  })
+  return result
+}
+
 export async function GET(req: Request) {
   try {
     const url = new URL(req.url)
@@ -92,7 +112,11 @@ export async function GET(req: Request) {
       organizationIds: [],
     })
 
-    const items = buildHistoryEntries({ actionLogs: logs, notes, kind: query.kind, displayUsers: displayMaps.users })
+    let items = buildHistoryEntries({ actionLogs: logs, notes, kind: query.kind, displayUsers: displayMaps.users })
+    const typesFilter = parseDocumentHistoryTypes(query.types)
+    if (typesFilter.size > 0) {
+      items = items.filter((entry) => typesFilter.has(entry.kind as DocumentHistoryEntryKind))
+    }
 
     let nextCursor: string | undefined = undefined
     if (logs.length === query.limit && items.length > 0) {

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

@@ -20,6 +20,7 @@ import { documentUpdateSchema } from '../../commands/documents'
 import { escapeLikePattern } from '@open-mercato/shared/lib/db/escapeLikePattern'
 import { parseBooleanToken } from '@open-mercato/shared/lib/boolean'
 import type { RbacService } from '@open-mercato/core/modules/auth/services/rbacService'
+import { recalculateOrderTotalsForDisplay } from '../../commands/returns'
 
 type DocumentKind = 'order' | 'quote'
 
@@ -467,6 +468,40 @@ export function buildDocumentCrudOptions(binding: DocumentBinding) {
     hooks: {
       afterList: async (payload: any, ctx: CrudCtx) => {
         await attachTags(payload, { ...ctx, bindingKind: binding.kind })
+        if (binding.kind === 'order' && Array.isArray(payload?.items) && payload.items.length === 1) {
+          const item = payload.items[0] as Record<string, unknown>
+          const orderId = typeof item?.id === 'string' ? item.id : null
+          const tenantId = typeof item?.tenantId === 'string' ? item.tenantId : ctx?.auth?.tenantId ?? null
+          const organizationId =
+            typeof item?.organizationId === 'string' ? item.organizationId : ctx?.selectedOrganizationId ?? ctx?.auth?.orgId ?? null
+          if (orderId && tenantId && organizationId) {
+            const em = ctx?.container?.resolve?.('em') as import('@mikro-orm/postgresql').EntityManager | undefined
+            if (em) {
+              const totals = await recalculateOrderTotalsForDisplay(
+                em,
+                ctx.container,
+                orderId,
+                { tenantId, organizationId },
+              )
+              if (totals) {
+                Object.assign(item, {
+                  subtotalNetAmount: totals.subtotalNetAmount,
+                  subtotalGrossAmount: totals.subtotalGrossAmount,
+                  discountTotalAmount: totals.discountTotalAmount,
+                  taxTotalAmount: totals.taxTotalAmount,
+                  shippingNetAmount: totals.shippingNetAmount,
+                  shippingGrossAmount: totals.shippingGrossAmount,
+                  surchargeTotalAmount: totals.surchargeTotalAmount,
+                  grandTotalNetAmount: totals.grandTotalNetAmount,
+                  grandTotalGrossAmount: totals.grandTotalGrossAmount,
+                  paidTotalAmount: totals.paidTotalAmount,
+                  refundedTotalAmount: totals.refundedTotalAmount,
+                  outstandingAmount: totals.outstandingAmount,
+                })
+              }
+            }
+          }
+        }
       },
     },
   }

package/src/modules/sales/api/returns/[id]/route.ts

@@ -0,0 +1,156 @@
+import { z } from 'zod'
+import { NextResponse } from 'next/server'
+import type { EntityManager } from '@mikro-orm/postgresql'
+import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
+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 { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
+import { findOneWithDecryption, findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import { SalesReturn, SalesReturnLine } from '../../../data/entities'
+
+export const metadata = {
+  GET: { requireAuth: true, requireFeatures: ['sales.returns.view'] },
+}
+
+const paramsSchema = z.object({ id: z.string().uuid() })
+
+const toNumber = (value: unknown): number => {
+  if (typeof value === 'number') return value
+  if (typeof value === 'string') {
+    const parsed = Number(value)
+    if (!Number.isNaN(parsed)) return parsed
+  }
+  return 0
+}
+
+export async function GET(req: Request, ctx: { params: { id: string } }) {
+  try {
+    const { id } = paramsSchema.parse(ctx.params ?? {})
+    const container = await createRequestContainer()
+    const auth = await getAuthFromRequest(req)
+    const { translate } = await resolveTranslations()
+
+    if (!auth || !auth.tenantId) {
+      throw new CrudHttpError(401, { error: translate('sales.documents.errors.unauthorized', 'Unauthorized') })
+    }
+
+    const scope = await resolveOrganizationScopeForRequest({ container, auth, request: req })
+    const organizationId = scope?.selectedId ?? auth.orgId ?? null
+    if (!organizationId) {
+      throw new CrudHttpError(400, {
+        error: translate('sales.documents.errors.organization_required', 'Organization context is required'),
+      })
+    }
+
+    const em = (container.resolve('em') as EntityManager).fork()
+    const header = await findOneWithDecryption(
+      em,
+      SalesReturn,
+      { id, deletedAt: null, tenantId: auth.tenantId, organizationId },
+      { populate: ['order'] },
+      { tenantId: auth.tenantId, organizationId },
+    )
+    if (!header || !header.order) {
+      throw new CrudHttpError(404, { error: translate('sales.returns.notFound', 'Return not found.') })
+    }
+
+    const lines = await findWithDecryption(
+      em,
+      SalesReturnLine,
+      { salesReturn: header.id, deletedAt: null },
+      { populate: ['orderLine'] },
+      { tenantId: auth.tenantId, organizationId },
+    )
+
+    const totals = lines.reduce(
+      (acc, line) => {
+        acc.net += toNumber(line.totalNetAmount)
+        acc.gross += toNumber(line.totalGrossAmount)
+        return acc
+      },
+      { net: 0, gross: 0 },
+    )
+
+    return NextResponse.json({
+      return: {
+        id: header.id,
+        orderId: typeof header.order === 'string' ? header.order : header.order.id,
+        returnNumber: header.returnNumber,
+        statusEntryId: header.statusEntryId ?? null,
+        status: header.status ?? null,
+        reason: header.reason ?? null,
+        notes: header.notes ?? null,
+        returnedAt: header.returnedAt ? header.returnedAt.toISOString() : null,
+        createdAt: header.createdAt ? header.createdAt.toISOString() : null,
+        updatedAt: header.updatedAt ? header.updatedAt.toISOString() : null,
+        totalNetAmount: totals.net,
+        totalGrossAmount: totals.gross,
+      },
+      lines: lines.map((line) => ({
+        id: line.id,
+        orderLineId: typeof line.orderLine === 'string' ? line.orderLine : line.orderLine?.id ?? null,
+        quantityReturned: line.quantityReturned,
+        unitPriceNet: line.unitPriceNet,
+        unitPriceGross: line.unitPriceGross,
+        totalNetAmount: line.totalNetAmount,
+        totalGrossAmount: line.totalGrossAmount,
+      })),
+    })
+  } catch (err) {
+    if (err instanceof CrudHttpError) {
+      return NextResponse.json(err.body, { status: err.status })
+    }
+    console.error('sales.returns.get failed', err)
+    const { translate } = await resolveTranslations()
+    return NextResponse.json({ error: translate('sales.returns.error', 'Failed to load return.') }, { status: 400 })
+  }
+}
+
+const returnLineSchema = z.object({
+  id: z.string().uuid(),
+  orderLineId: z.string().uuid().nullable(),
+  quantityReturned: z.string(),
+  unitPriceNet: z.string(),
+  unitPriceGross: z.string(),
+  totalNetAmount: z.string(),
+  totalGrossAmount: z.string(),
+})
+
+export const openApi: OpenApiRouteDoc = {
+  tag: 'Sales',
+  summary: 'Get a return',
+  pathParams: paramsSchema,
+  methods: {
+    GET: {
+      summary: 'Get return details',
+      responses: [
+        {
+          status: 200,
+          description: 'Return details',
+          schema: z.object({
+            return: z.object({
+              id: z.string().uuid(),
+              orderId: z.string().uuid(),
+              returnNumber: z.string(),
+              statusEntryId: z.string().uuid().nullable(),
+              status: z.string().nullable(),
+              reason: z.string().nullable(),
+              notes: z.string().nullable(),
+              returnedAt: z.string().nullable(),
+              createdAt: z.string().nullable(),
+              updatedAt: z.string().nullable(),
+              totalNetAmount: z.number(),
+              totalGrossAmount: z.number(),
+            }),
+            lines: z.array(returnLineSchema),
+          }),
+        },
+        { status: 401, description: 'Unauthorized', schema: z.object({ error: z.string() }) },
+        { status: 404, description: 'Not found', schema: z.object({ error: z.string() }) },
+      ],
+    },
+  },
+}
+

package/src/modules/sales/api/returns/route.ts

@@ -0,0 +1,171 @@
+import { z } from 'zod'
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'
+import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import { splitCustomFieldPayload } from '@open-mercato/shared/lib/crud/custom-fields'
+import { withScopedPayload } from '../utils'
+import { SalesReturn, SalesReturnLine } from '../../data/entities'
+import { returnCreateSchema } from '../../data/validators'
+import { E } from '#generated/entities.ids.generated'
+import * as F from '#generated/entities/sales_return'
+import { createPagedListResponseSchema } from '../openapi'
+import { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
+import type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'
+
+const rawBodySchema = z.object({}).passthrough()
+
+const listSchema = z
+  .object({
+    page: z.coerce.number().min(1).default(1),
+    pageSize: z.coerce.number().min(1).max(200).default(50),
+    orderId: z.string().uuid().optional(),
+    sortField: z.string().optional(),
+    sortDir: z.enum(['asc', 'desc']).optional(),
+  })
+  .passthrough()
+
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ['sales.returns.view'] },
+  POST: { requireAuth: true, requireFeatures: ['sales.returns.create'] },
+}
+
+const toNumber = (value: unknown): number => {
+  if (typeof value === 'number') return value
+  if (typeof value === 'string') {
+    const parsed = Number(value)
+    if (!Number.isNaN(parsed)) return parsed
+  }
+  return 0
+}
+
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: SalesReturn,
+    idField: 'id',
+    orgField: 'organizationId',
+    tenantField: 'tenantId',
+    softDeleteField: 'deletedAt',
+  },
+  indexer: {
+    entityType: E.sales.sales_return,
+  },
+  list: {
+    schema: listSchema,
+    entityId: E.sales.sales_return,
+    fields: [
+      F.id,
+      'order_id',
+      F.return_number,
+      F.status_entry_id,
+      F.status,
+      F.reason,
+      F.notes,
+      F.returned_at,
+      F.created_at,
+      F.updated_at,
+    ],
+    sortFieldMap: {
+      createdAt: F.created_at,
+      updatedAt: F.updated_at,
+      returnedAt: F.returned_at,
+    },
+    buildFilters: async (query: Record<string, unknown>) => {
+      const filters: Record<string, unknown> = {}
+      if (typeof query.orderId === 'string' && query.orderId.length > 0) {
+        filters.order_id = { $eq: query.orderId }
+      }
+      return filters
+    },
+  },
+  actions: {
+    create: {
+      commandId: 'sales.returns.create',
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations()
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate)
+        const { base } = splitCustomFieldPayload(scoped)
+        return returnCreateSchema.parse(base)
+      },
+      response: ({ result }) => ({ id: result?.returnId ?? null }),
+      status: 201,
+    },
+  },
+  hooks: {
+    afterList: async (payload, ctx) => {
+      const items = Array.isArray(payload.items) ? payload.items : []
+      if (!items.length) return
+      const returnIds = items
+        .map((item: unknown) => (item && typeof item === 'object' ? (item as Record<string, unknown>).id : null))
+        .filter((value: string | null): value is string => typeof value === 'string')
+      if (!returnIds.length) return
+      const em = ctx.container.resolve('em') as EntityManager
+      const lines = await findWithDecryption(
+        em,
+        SalesReturnLine,
+        { salesReturn: { $in: returnIds }, deletedAt: null },
+        {},
+        { tenantId: ctx.auth?.tenantId ?? null, organizationId: ctx.auth?.orgId ?? null },
+      )
+      const totals = lines.reduce<Map<string, { net: number; gross: number }>>((acc, line) => {
+        const returnId = typeof line.salesReturn === 'string' ? line.salesReturn : line.salesReturn?.id ?? null
+        if (!returnId) return acc
+        const current = acc.get(returnId) ?? { net: 0, gross: 0 }
+        current.net += toNumber(line.totalNetAmount)
+        current.gross += toNumber(line.totalGrossAmount)
+        acc.set(returnId, current)
+        return acc
+      }, new Map())
+      items.forEach((item: unknown) => {
+        if (!item || typeof item !== 'object') return
+        const map = item as Record<string, unknown>
+        const id = map.id
+        if (typeof id !== 'string') return
+        const sum = totals.get(id)
+        if (!sum) return
+        map['total_net_amount'] = sum.net
+        map['total_gross_amount'] = sum.gross
+      })
+    },
+  },
+})
+
+const { GET, POST } = crud
+
+export { GET, POST }
+
+const returnSchema = z
+  .object({
+    id: z.string().uuid(),
+    order_id: z.string().uuid(),
+    return_number: z.string(),
+    status_entry_id: z.string().uuid().nullable().optional(),
+    status: z.string().nullable().optional(),
+    reason: z.string().nullable().optional(),
+    notes: z.string().nullable().optional(),
+    returned_at: z.string().nullable().optional(),
+    created_at: z.string(),
+    updated_at: z.string(),
+    total_net_amount: z.number().optional(),
+    total_gross_amount: z.number().optional(),
+  })
+  .passthrough()
+
+export const openApi: OpenApiRouteDoc = {
+  tag: 'Sales',
+  summary: 'Manage order returns',
+  methods: {
+    GET: {
+      summary: 'List returns',
+      query: listSchema,
+      responses: [{ status: 200, description: 'Returns list', schema: createPagedListResponseSchema(returnSchema) }],
+    },
+    POST: {
+      summary: 'Create return',
+      requestBody: { schema: returnCreateSchema },
+      responses: [{ status: 201, description: 'Return created', schema: z.object({ id: z.string().uuid().nullable() }) }],
+    },
+  },
+}
+