return new Error(`${prefix} Use values like 500ms, 30s, 5m, 2h, or 1h30m.`);

}

function roundSafeDurationMs(raw: string, value: number): number {

const ms = Math.round(value);

if (!Number.isSafeInteger(ms)) {

throw invalidDuration(raw);

}

return ms;

}

export function parseDurationMs(raw: string, opts?: DurationMsParseOptions): number {

const trimmed = normalizeLowercaseStringOrEmpty(normalizeOptionalString(raw) ?? "");

if (!trimmed) {

throw invalidDuration(raw);

}

const unit = (single[2] ?? opts?.defaultUnit ?? "ms") as "ms" | "s" | "m" | "h" | "d";

const ms = Math.round(value * DURATION_MULTIPLIERS[unit]);

if (!Number.isFinite(ms)) {

throw invalidDuration(raw);

}

return ms;

return roundSafeDurationMs(raw, value * DURATION_MULTIPLIERS[unit]);

}

// Composite form (e.g. "1h30m", "2m500ms"); each token must include a unit.

throw invalidDuration(raw);

}

const ms = Math.round(totalMs);

if (!Number.isFinite(ms)) {

throw invalidDuration(raw);

}

return ms;

return roundSafeDurationMs(raw, totalMs);

}