mgv-backoffice 1.24.0 → 1.27.0

package/src/utils/format.test.ts

@@ -7,6 +7,7 @@ import {
   fmtPrice,
   fmtPct,
   fmtUsd,
+  fmtDuration,
 } from './format'
 
 const EM_DASH = '—'
@@ -127,3 +128,37 @@ describe('fmtUsd', () => {
     expect(fmtUsd(0)).toBe('+$0.00')
   })
 })
+
+describe('fmtDuration', () => {
+  it('renders an em-dash for null/undefined/non-finite input', () => {
+    expect(fmtDuration(null)).toBe(EM_DASH)
+    expect(fmtDuration(undefined)).toBe(EM_DASH)
+    expect(fmtDuration(NaN)).toBe(EM_DASH)
+    expect(fmtDuration(Infinity)).toBe(EM_DASH)
+  })
+
+  it('drops zero-value leading units', () => {
+    expect(fmtDuration(12 * 60_000)).toBe('12m')
+    expect(fmtDuration((5 * 60 + 12) * 60_000)).toBe('5h 12m')
+    expect(fmtDuration((3 * 1440 + 5 * 60 + 12) * 60_000)).toBe('3d 5h')
+  })
+
+  it('caps the rendered units at maxUnits', () => {
+    const ms = (2 * 1440 + 5 * 60 + 13) * 60_000
+    expect(fmtDuration(ms, 3)).toBe('2d 5h 13m')
+    expect(fmtDuration(ms, 2)).toBe('2d 5h')
+    expect(fmtDuration(ms, 1)).toBe('2d')
+  })
+
+  it('keeps the hours unit when days are present even if hours are zero', () => {
+    expect(fmtDuration(2 * 1440 * 60_000, 3)).toBe('2d 0h 0m')
+  })
+
+  it('clamps negative durations to zero', () => {
+    expect(fmtDuration(-5000)).toBe('0m')
+  })
+
+  it('renders sub-minute durations as 0m', () => {
+    expect(fmtDuration(59_000)).toBe('0m')
+  })
+})

package/src/utils/format.ts

@@ -87,3 +87,22 @@ export function fmtUsd(v: number): string {
   const sign = v < 0 ? '-' : '+'
   return `${sign}$${Math.abs(v).toFixed(2)}`
 }
+
+/**
+ * Format a millisecond duration as compact day/hour/minute units, e.g.
+ * "3d 5h", "5h 12m" or "12m". Zero-value leading units are dropped;
+ * `maxUnits` caps how many units render (2 → "3d 5h", 3 → "3d 5h 12m").
+ * Renders an em-dash for null/undefined/non-finite input.
+ */
+export function fmtDuration(ms: number | null | undefined, maxUnits = 2): string {
+  if (ms === null || ms === undefined || !isFinite(ms)) return EM_DASH
+  const totalMins = Math.floor(Math.max(0, ms) / 60_000)
+  const days = Math.floor(totalMins / 1440)
+  const hours = Math.floor((totalMins % 1440) / 60)
+  const mins = totalMins % 60
+  const parts: string[] = []
+  if (days > 0) parts.push(`${days}d`)
+  if (days > 0 || hours > 0) parts.push(`${hours}h`)
+  parts.push(`${mins}m`)
+  return parts.slice(0, maxUnits).join(' ')
+}