utils/time.test.ts

Rama main · réplica de lectura del repositorio original.

import { describe, expect, it } from "vitest";
import { isValidTimeString, parseTimeString, resolveTimeoutMs } from "./time.ts";

describe("parseTimeString", () => {
  it.each([
    ["10m", 600000], // 10 minutes
    ["1h", 3600000], // 1 hour
    ["30s", 30000], // 30 seconds
    ["1h30m", 5400000], // 1 hour 30 minutes
    ["10m12s", 612000], // 10 minutes 12 seconds
    ["1h30m45s", 5445000], // 1 hour 30 minutes 45 seconds
    ["2h", 7200000], // 2 hours
    ["90m", 5400000], // 90 minutes
    ["0m", 0], // 0 minutes (edge case)
    ["0s", 0], // 0 seconds (edge case)
  ])("parses '%s' to %d ms", (input, expected) => {
    expect(parseTimeString(input)).toBe(expected);
  });

  it.each([
    [""], // empty string
    ["abc"], // no numbers
    ["10"], // no unit
    ["10x"], // invalid unit
    ["h10m"], // hours without number
    ["m10"], // units before number
    ["10 m"], // space between number and unit
    ["-10m"], // negative number
    ["10.5m"], // decimal
    ["10m 30s"], // space between components
  ])("returns null for invalid input '%s'", (input) => {
    expect(parseTimeString(input)).toBeNull();
  });
});

describe("isValidTimeString", () => {
  it.each(["10m", "1h", "30s", "1h30m", "10m12s", "1h30m45s"])(
    "returns true for valid '%s'",
    (input) => {
      expect(isValidTimeString(input)).toBe(true);
    }
  );

  it.each(["", "abc", "10", "10x", "-10m", "10.5m"])("returns false for invalid '%s'", (input) => {
    expect(isValidTimeString(input)).toBe(false);
  });
});

describe("resolveTimeoutMs", () => {
  it.each([
    ["1h", 3_600_000],
    ["10m", 600_000],
    ["1h30m", 5_400_000],
  ])("returns ms for valid '%s'", (input, expected) => {
    expect(resolveTimeoutMs(input)).toBe(expected);
  });

  it("returns null for undefined input (no timeout configured)", () => {
    expect(resolveTimeoutMs(undefined)).toBeNull();
  });

  it.each([["0m"], ["0s"], ["0h"], ["0h0m0s"]])(
    "returns null for zero-value '%s' so the caller doesn't insta-timeout",
    (input) => {
      // 0ms setTimeout fires in the same tick — without this guard, a user
      // typo like "0m" rejected the run as "timed out after 0m" the instant
      // it started. see also the matching payload.timeout handling in main.ts.
      expect(resolveTimeoutMs(input)).toBeNull();
    }
  );

  it.each([["abc"], ["10"], ["10x"], ["-10m"], ["10.5m"], [""]])(
    "returns null for unparseable input '%s'",
    (input) => {
      expect(resolveTimeoutMs(input)).toBeNull();
    }
  );

  it("returns null for values past node's setTimeout ceiling (~24.8 days)", () => {
    // 2^31 - 1 ms = 2147483647 ms = 596h31m23s647ms. node silently clamps any
    // delay above that down to 1ms — a user asking for "999h" would have the
    // run terminate with "timed out after 999h" within a single tick. reject
    // here so the caller's warn + fallback kicks in instead.
    expect(resolveTimeoutMs("999h")).toBeNull();
    // 600h = 2_160_000_000 ms, safely past the cap.
    expect(resolveTimeoutMs("600h")).toBeNull();
  });

  it("accepts the largest value that setTimeout can still honor", () => {
    // 596h31m23s = 2_147_483_000 ms — just under 2^31-1. this must remain
    // usable so the "reject over-max" rule doesn't accidentally reject the
    // boundary itself.
    expect(resolveTimeoutMs("596h31m23s")).toBe(2_147_483_000);
  });
});