@peasant-labs/fairtrade 0.0.37 → 0.0.38

package/dist/lib/types/transcript/time.d.ts

@@ -1,5 +1,14 @@
 /**
- * Human-readable relative time: "3m ago", "2h ago", "4d ago", "Jan 12".
+ * Is this a real recorded time? A missing, unparseable, zero, epoch or Go zero-time value
+ * ("0001-01-01T00:00:00Z") is unknown: nothing may render it, and no "ago" math runs on it.
+ *
+ * @param {string | null | undefined} iso
+ * @returns {boolean}
+ */
+export function isKnownTime(iso: string | null | undefined): boolean;
+/**
+ * Human-readable relative time: "just now", "3m ago", "2h ago", "4d ago"; past a week it reads as
+ * a date ("oct 14", or "oct 14, 2025" in another year). An unknown time reads as nothing.
  *
  * @param {string} iso        an ISO 8601 timestamp
  * @param {number} [now]      reference "now" in epoch millis (defaults to `Date.now()`; pass explicitly for deterministic tests)
@@ -7,12 +16,28 @@
  */
 export function formatRelative(iso: string, now?: number): string;
 /**
- * A duration expressed in minutes → "1h 16m" / "9m" / "42s".
+ * The one duration format: human and short. "12s", "4m 30s", "4m", "1h 12m", "1h"; under a
+ * second "<1s"; zero, negative or unknown reads as nothing, so a caller hides the figure.
+ *
+ * @param {number | null | undefined} seconds
+ * @returns {string}
+ */
+export function formatDurationSeconds(seconds: number | null | undefined): string;
+/**
+ * A duration in minutes, in the one format: 4.5 -> "4m 30s", 76 -> "1h 16m", 0 -> "".
+ *
+ * @param {number | null | undefined} mins
+ * @returns {string}
+ */
+export function formatDurationMins(mins: number | null | undefined): string;
+/**
+ * A duration in milliseconds: a tool call reads "820ms" or "1.4s" while short, then the one
+ * format ("1m 15s"); zero or unknown reads as nothing.
  *
- * @param {number | undefined} mins
+ * @param {number | null | undefined} ms
  * @returns {string}
  */
-export function formatDurationMins(mins: number | undefined): string;
+export function formatDurationMs(ms: number | null | undefined): string;
 /**
  * "Jan 12, 4:23 PM" — long datetime for tooltips.
  *