faucet-cli 1.13.1

// Small shared helpers for the console UI.

/** Format an integer with thousands separators (e.g. 1500000 → "1,500,000").
 * Non-numbers pass through as their string form. Shared so every list/detail
 * renders counts identically. */
export function fmtInt(v) {
  const n = Number(v);
  return Number.isFinite(n) ? n.toLocaleString("en-US") : String(v ?? "");
}

/** Format a duration in seconds as compact h/m/s, no spaces, showing only the
 * two highest units (e.g. 3723 → "1h2m", 184 → "3m4s", 45.2 → "45s",
 * <1s → "0.8s"). Seconds are dropped once the run is an hour or more — the exact
 * value belongs in a tooltip. Nullish → "—". */
export function fmtDuration(secs) {
  const s = Number(secs);
  if (!Number.isFinite(s)) return "—";
  if (s < 1) return `${s.toFixed(1)}s`;
  const t = Math.round(s);
  const h = Math.floor(t / 3600);
  const m = Math.floor((t % 3600) / 60);
  const sec = t % 60;
  if (h) return `${h}h${m}m`;
  if (m) return `${m}m${sec}s`;
  return `${sec}s`;
}

/** Format a count compactly with a K/M/B suffix (e.g. 4801657 → "4.8M",
 * 3_883_982 → "3.88M", 1234 → "1.23K", 999 → "999"). Trims trailing zeros;
 * under 1000 shows the exact integer. Non-numbers pass through. */
export function fmtCompact(v) {
  const n = Number(v);
  if (!Number.isFinite(n)) return String(v ?? "");
  const abs = Math.abs(n);
  if (abs < 1000) return String(n);
  const units = [
    [1e9, "B"],
    [1e6, "M"],
    [1e3, "K"],
  ];
  for (const [base, suf] of units) {
    if (abs >= base) {
      const val = n / base;
      // Fewer decimals as the value grows; trim trailing zeros ONLY after a
      // decimal point (4.80→4.8, 4.00→4) — never from an integer (200 must stay
      // 200, not become 2).
      let str = val.toFixed(val >= 100 ? 0 : val >= 10 ? 1 : 2);
      if (str.includes(".")) str = str.replace(/0+$/, "").replace(/\.$/, "");
      return `${str}${suf}`;
    }
  }
  return String(n);
}

/** Escape a string for safe interpolation into innerHTML. */
export function escapeHtml(s) {
  return String(s ?? "").replace(
    /[&<>"]/g,
    (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c],
  );
}

/**
 * Render the minimal inline markdown used in connector descriptions — `**bold**`
 * and `` `code` `` — as safe HTML. The text is HTML-escaped first, then our own
 * tags are injected, so it never introduces markup from the source string.
 */
export function mdInline(s) {
  return escapeHtml(s)
    .replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>")
    .replace(/`([^`]+)`/g, "<code>$1</code>");
}