zilla-util 1.2.27

package/lib/esm/sha256.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.js","sourceRoot":"","sources":["../../src/sha256.js"],"names":[],"mappings":"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"}

package/lib/esm/string.d.ts

@@ -0,0 +1,106 @@
+import { ZillaClock } from "./time.js";
+import { GenericLogger } from "./logger.js";
+import GraphemeSplitter from "grapheme-splitter";
+export declare const capitalize: (s?: string) => string;
+export declare const uncapitalize: (s?: string) => string;
+export declare const basefilename: (s: string) => string;
+export declare const ext: (s: string) => string;
+export declare const basefilenameWithoutExt: (s: string) => string;
+export declare const dateAsYYYYMMDD: (date: Date) => string;
+export declare const dateAsUTCYYYYMMDD: (date: Date) => string;
+export declare const nextDateAsYYYYMMDD: (d: string) => string;
+export declare const dateAsYYYYMMDDHHmmSS: (date: Date) => string;
+export declare const timestampAsYYYYMMDD: (timestamp: number) => string;
+export declare const timestampAsUTCYYYYMMDD: (timestamp: number) => string;
+export declare const timestampAsYYYYMMDDHHmmSS: (timestamp: number) => string;
+export declare const nowAsYYYYMMDD: () => string;
+export declare const nowAsYYYYMMDDHHmmSS: () => string;
+export declare const sluggize: (name: string, replaceChar?: string) => string;
+export declare const hyphenate: (name: string) => string;
+export declare const uuidv4: (squeezed?: boolean) => string;
+export declare const camel2kebab: (camelCaseString: string) => string;
+export declare const camel2snake: (camelCaseString: string) => string;
+export declare const kebab2camel: (kebabCaseString: string) => string;
+export declare const snake2camel: (kebabCaseString: string) => string;
+export declare const hasUpperCase: (str: string) => boolean;
+export declare const startsWithPrefix: (s: string, prefixes: string[]) => boolean;
+export declare const endsWithSuffix: (s: string, suffixes: string[]) => boolean;
+export declare const randomDigit: (min?: number, max?: number) => number;
+export declare const randomDigits: (n: number, min?: number, max?: number) => string;
+export declare const isOnlyDigits: (s: string) => boolean;
+export declare const BASE62_CHARS = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+export declare const BASE62_CHARS_WITHOUT_SIMILAR_CHARS = "23456789ABCEFGHJKLMNPRSTUVWXYZ";
+export declare const VOWEL_CHARS = "AEOIUaeoiu";
+export declare const DIGIT_CHARS = "0123456789";
+export declare const VOWEL_AND_DIGIT_CHARS: string;
+export declare const _randomSafeToken: (n: number, CHARS: string) => string;
+export declare const randomSafeToken: (n: number) => string;
+export declare const randomSuperSafeToken: (n: number) => string;
+export declare const epochToHttpDate: (epoch?: number, clock?: ZillaClock) => string;
+export declare const sortWords: (words: string[], dict: string[]) => string[];
+export declare const trimSpaces: (str: string) => string;
+export declare const trimNonalphanumeric: (str: string) => string;
+export declare const getRandomCodePoint: () => number;
+export declare const generateRandomString: (length: number) => string;
+export declare const sortObj: (o: Record<string, unknown>) => Record<string, unknown>;
+export declare const sortedStringify: (obj: Record<string, unknown>) => string;
+export declare const jsonHeader: () => {
+    "Content-Type": string;
+};
+export declare const ANSI: {
+    RESET: string;
+    BOLD: string;
+    DIM: string;
+    UNDERLINE: string;
+    BLINK: string;
+    INVERSE: string;
+    HIDDEN: string;
+    BLACK: string;
+    RED: string;
+    GREEN: string;
+    YELLOW: string;
+    BLUE: string;
+    MAGENTA: string;
+    CYAN: string;
+    WHITE: string;
+    BRIGHT_BLACK: string;
+    BRIGHT_RED: string;
+    BRIGHT_GREEN: string;
+    BRIGHT_YELLOW: string;
+    BRIGHT_BLUE: string;
+    BRIGHT_MAGENTA: string;
+    BRIGHT_CYAN: string;
+    BRIGHT_WHITE: string;
+};
+export declare const CSS: {
+    RESET: string;
+    BOLD: string;
+    DIM: string;
+    UNDERLINE: string;
+    BLINK: string;
+    INVERSE: string;
+    HIDDEN: string;
+    BLACK: string;
+    RED: string;
+    GREEN: string;
+    YELLOW: string;
+    BLUE: string;
+    MAGENTA: string;
+    CYAN: string;
+    WHITE: string;
+    BRIGHT_BLACK: string;
+    BRIGHT_RED: string;
+    BRIGHT_GREEN: string;
+    BRIGHT_YELLOW: string;
+    BRIGHT_BLUE: string;
+    BRIGHT_MAGENTA: string;
+    BRIGHT_CYAN: string;
+    BRIGHT_WHITE: string;
+};
+export declare const REGEX_ARRAY_OF_STRINGS: RegExp;
+export declare const REGEX_ARRAY_OF_BOOLEANS: RegExp;
+export declare const REGEX_ARRAY_OF_INTEGERS: RegExp;
+export declare const REGEX_ARRAY_OF_FLOATS: RegExp;
+export declare const safeStringify: (obj: unknown, logger?: GenericLogger) => string;
+export declare const splitter: GraphemeSplitter;
+export declare const countVisibleChars: (data: Uint8Array | string) => number;

package/lib/esm/string.js

@@ -0,0 +1,257 @@
+import GraphemeSplitter from "grapheme-splitter";
+export const capitalize = (s) => s && s.length > 0 ? s.substring(0, 1).toUpperCase() + s.substring(1) : "";
+export const uncapitalize = (s) => s && s.length > 0 ? s.substring(0, 1).toLowerCase() + s.substring(1) : "";
+export const basefilename = (s) => {
+    if (!s)
+        return s; // return null/undefined as-is
+    // drop trailing slashes
+    while (s.endsWith("/")) {
+        s = s.substring(0, s.length - 1);
+    }
+    const i = s ? s.lastIndexOf("/") : -1;
+    return i === -1 ? s : s.substring(i + 1);
+};
+export const ext = (s) => {
+    if (!s)
+        return s; // return null/undefined/no-dot files as-is
+    const dot = s.lastIndexOf(".");
+    return dot === -1 || dot === s.length - 1 ? "" : s.substring(dot + 1);
+};
+export const basefilenameWithoutExt = (s) => {
+    s = basefilename(s);
+    if (!s)
+        return s; // return null/undefined as-is
+    // drop trailing dots
+    while (s.endsWith(".")) {
+        s = s.substring(0, s.length - 1);
+    }
+    const i = s ? s.lastIndexOf(".") : -1;
+    return i === -1 ? s : s.substring(0, i);
+};
+export const dateAsYYYYMMDD = (date) => `${date.getFullYear()}-${(date.getMonth() + 1).toString().padStart(2, "0")}-${date
+    .getDate()
+    .toString()
+    .padStart(2, "0")}`;
+export const dateAsUTCYYYYMMDD = (date) => `${date.getUTCFullYear()}-${(date.getUTCMonth() + 1).toString().padStart(2, "0")}-${date
+    .getUTCDate()
+    .toString()
+    .padStart(2, "0")}`;
+export const nextDateAsYYYYMMDD = (d) => {
+    const dt = new Date(`${d}T00:00:00Z`); // UTC midnight of current day
+    dt.setUTCDate(dt.getUTCDate() + 1); // +1 calendar day
+    return dt.toISOString().slice(0, 10); // back to YYYY‑MM‑DD
+};
+export const dateAsYYYYMMDDHHmmSS = (date) => `${date.getFullYear()}${(date.getMonth() + 1).toString().padStart(2, "0")}${date
+    .getDate()
+    .toString()
+    .padStart(2, "0")}-${("" + date.getHours()).padStart(2, "0")}${("" + date.getMinutes()).padStart(2, "0")}${("" + date.getSeconds()).padStart(2, "0")}`;
+export const timestampAsYYYYMMDD = (timestamp) => dateAsYYYYMMDD(new Date(timestamp));
+export const timestampAsUTCYYYYMMDD = (timestamp) => dateAsUTCYYYYMMDD(new Date(timestamp));
+export const timestampAsYYYYMMDDHHmmSS = (timestamp) => dateAsYYYYMMDDHHmmSS(new Date(timestamp));
+export const nowAsYYYYMMDD = () => timestampAsYYYYMMDD(Date.now());
+export const nowAsYYYYMMDDHHmmSS = () => timestampAsYYYYMMDDHHmmSS(Date.now());
+export const sluggize = (name, replaceChar = "_") => {
+    replaceChar ||= "_";
+    return name
+        .trim()
+        .replace(new RegExp(`[^A-Z\\d${replaceChar}]+`, "gi"), replaceChar)
+        .replace(/[\s_-]+/g, replaceChar)
+        .replace(new RegExp(`[${replaceChar}]+`, "gi"), replaceChar)
+        .replace(new RegExp(`^[${replaceChar}]+`, "gi"), "")
+        .replace(new RegExp(`[${replaceChar}]+$`, "gi"), "")
+        .toLowerCase();
+};
+export const hyphenate = (name) => sluggize(name, "-");
+const generateRandomValues = (count) => {
+    if (globalThis && globalThis.crypto && globalThis.crypto.getRandomValues) {
+        return globalThis.crypto.getRandomValues(new Uint8Array(count));
+    }
+    else {
+        const arr = new Uint8Array(count);
+        for (let i = 0; i < count; i++) {
+            arr[i] = (Math.random() * 256) | 0;
+        }
+        return arr;
+    }
+};
+export const uuidv4 = (squeezed) => {
+    const arr = generateRandomValues(16);
+    // Per 4.4, set bits for version and clock_seq_hi_and_reserved
+    arr[6] = (arr[6] & 0x0f) | 0x40;
+    arr[8] = (arr[8] & 0x3f) | 0x80;
+    // Join it all together
+    const pad = (n) => (n.length < 2 ? "0" + n : n);
+    const uuid = Array.from(arr)
+        .map((b) => pad(b.toString(16)))
+        .join("");
+    return squeezed
+        ? uuid
+        : `${uuid.slice(0, 8)}-${uuid.slice(8, 12)}-${uuid.slice(12, 16)}-${uuid.slice(16, 20)}-${uuid.slice(20)}`;
+};
+export const camel2kebab = (camelCaseString) => camelCaseString.replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, "$1-$2").toLowerCase();
+export const camel2snake = (camelCaseString) => camelCaseString.replace(/([a-z0-9]|(?=[A-Z]))([A-Z])/g, "$1_$2").toLowerCase();
+export const kebab2camel = (kebabCaseString) => kebabCaseString
+    .toLowerCase()
+    .replace(/([-_][a-z])/g, (group) => group.toUpperCase().replace("-", "").replace("_", ""));
+export const snake2camel = kebab2camel;
+export const hasUpperCase = (str) => /[A-Z]/.test(str);
+export const startsWithPrefix = (s, prefixes) => prefixes.some((prefix) => s.startsWith(prefix));
+export const endsWithSuffix = (s, suffixes) => suffixes.some((suffix) => s.endsWith(suffix));
+export const randomDigit = (min, max) => {
+    min = typeof min === "number" && min >= 0 && ((max && min <= max) || typeof max !== "number") ? min : 0;
+    max = typeof max === "number" && max <= 9 && max >= min ? max : 9;
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+};
+export const randomDigits = (n, min, max) => Array.from({ length: n }, () => `${randomDigit(min, max)}`).join("");
+export const isOnlyDigits = (s) => /^\d+$/.test(s);
+export const BASE62_CHARS = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+export const BASE62_CHARS_WITHOUT_SIMILAR_CHARS = "23456789ABCEFGHJKLMNPRSTUVWXYZ";
+export const VOWEL_CHARS = "AEOIUaeoiu";
+export const DIGIT_CHARS = "0123456789";
+export const VOWEL_AND_DIGIT_CHARS = VOWEL_CHARS + DIGIT_CHARS;
+// "safeToken" means safe in two ways:
+// 1. It's web-safe, using only characters than can appear un-encoded in URLs
+// 2. It's curse-word safe: after 2 consecutive letters, the next char will be a vowel or digit
+export const _randomSafeToken = (n, CHARS) => {
+    let result = "";
+    const allowedSet = new Set(CHARS);
+    const vowelsAndDigits = [...VOWEL_AND_DIGIT_CHARS].filter((char) => allowedSet.has(char)).join("");
+    for (let i = 0; i < n; i++) {
+        let newChar = CHARS[Math.floor(Math.random() * CHARS.length)];
+        // If we have at least 2 characters and they're all alphabetic
+        if (result.length >= 2 &&
+            isNaN(Number(result.charAt(result.length - 1))) &&
+            isNaN(Number(result.charAt(result.length - 2)))) {
+            // ensure next character is a vowel or a digit
+            newChar = vowelsAndDigits[Math.floor(Math.random() * vowelsAndDigits.length)];
+        }
+        result += newChar;
+    }
+    return result;
+};
+export const randomSafeToken = (n) => _randomSafeToken(n, BASE62_CHARS);
+export const randomSuperSafeToken = (n) => _randomSafeToken(n, BASE62_CHARS_WITHOUT_SIMILAR_CHARS);
+export const epochToHttpDate = (epoch, clock) => new Date(epoch ? epoch : clock ? clock.now() : Date.now()).toUTCString();
+export const sortWords = (words, dict) => words.sort((a, b) => dict.indexOf(a) - dict.indexOf(b) || dict.length + words.indexOf(a) - (dict.length + words.indexOf(b)));
+export const trimSpaces = (str) => str.trim().replace(/\s+/g, " ");
+export const trimNonalphanumeric = (str) => str.replace(/[^a-zA-Z0-9]/g, "");
+const commonUnicodeRanges = [
+    [0x0000, 0x007f], // Basic Latin (ASCII)
+    [0x0080, 0x00ff], // Latin-1 Supplement
+    [0x0100, 0x017f], // Latin Extended-A
+    [0x0370, 0x03ff], // Greek and Coptic
+    [0x0400, 0x04ff], // Cyrillic
+    [0x0530, 0x058f], // Armenian
+    [0x0590, 0x05ff], // Hebrew
+    [0x0600, 0x06ff], // Arabic
+    [0x0900, 0x097f], // Devanagari
+    [0xac00, 0xd7af], // Hangul Syllables
+    [0x4e00, 0x9fff], // CJK Unified Ideographs
+];
+const createUnifiedRange = (ranges) => {
+    const unifiedRange = [];
+    for (const [start, end] of ranges) {
+        for (let i = start; i <= end; i++) {
+            unifiedRange.push(i);
+        }
+    }
+    return unifiedRange;
+};
+const unifiedUnicodeRange = createUnifiedRange(commonUnicodeRanges);
+export const getRandomCodePoint = () => {
+    const randomIndex = Math.floor(Math.random() * unifiedUnicodeRange.length);
+    return unifiedUnicodeRange[randomIndex];
+};
+export const generateRandomString = (length) => {
+    return Array.from({ length }, () => String.fromCodePoint(getRandomCodePoint())).join("");
+};
+export const sortObj = (o) => Object.keys(o)
+    .sort()
+    .reduce((acc, key) => {
+    acc[key] =
+        typeof o[key] === "object" && o[key] !== null && !Array.isArray(o[key])
+            ? sortObj(o[key])
+            : o[key];
+    return acc;
+}, {});
+export const sortedStringify = (obj) => JSON.stringify(sortObj(obj));
+export const jsonHeader = () => ({ "Content-Type": "application/json" });
+export const ANSI = {
+    RESET: "\x1b[0m",
+    BOLD: "\x1b[1m",
+    DIM: "\x1b[2m",
+    UNDERLINE: "\x1b[4m",
+    BLINK: "\x1b[5m",
+    INVERSE: "\x1b[7m",
+    HIDDEN: "\x1b[8m",
+    // Foreground Colors
+    BLACK: "\x1b[30m",
+    RED: "\x1b[31m",
+    GREEN: "\x1b[32m",
+    YELLOW: "\x1b[33m",
+    BLUE: "\x1b[34m",
+    MAGENTA: "\x1b[35m",
+    CYAN: "\x1b[36m",
+    WHITE: "\x1b[37m",
+    // Bright Foreground Colors
+    BRIGHT_BLACK: "\x1b[90m",
+    BRIGHT_RED: "\x1b[91m",
+    BRIGHT_GREEN: "\x1b[92m",
+    BRIGHT_YELLOW: "\x1b[93m",
+    BRIGHT_BLUE: "\x1b[94m",
+    BRIGHT_MAGENTA: "\x1b[95m",
+    BRIGHT_CYAN: "\x1b[96m",
+    BRIGHT_WHITE: "\x1b[97m",
+};
+export const CSS = {
+    RESET: "color: inherit;",
+    BOLD: "font-weight: bold;",
+    DIM: "opacity: 0.7;",
+    UNDERLINE: "text-decoration: underline;",
+    // for BLINK to work, add the CSS below to some global CSS file that the browser will load:
+    // @keyframes blink { 50% { opacity: 0; } }
+    // If the CSS isn't defined, BLINK text will still appear, it just won't blink
+    BLINK: "animation: blink 1s step-start infinite;",
+    INVERSE: "filter: invert(100%);",
+    HIDDEN: "visibility: hidden;",
+    // Foreground Colors
+    BLACK: "color: black;",
+    RED: "color: red;",
+    GREEN: "color: green;",
+    YELLOW: "color: goldenrod;",
+    BLUE: "color: blue;",
+    MAGENTA: "color: purple;",
+    CYAN: "color: cyan;",
+    WHITE: "color: white;",
+    // Bright Foreground Colors
+    BRIGHT_BLACK: "color: gray;",
+    BRIGHT_RED: "color: lightcoral;",
+    BRIGHT_GREEN: "color: lightgreen;",
+    BRIGHT_YELLOW: "color: yellow;",
+    BRIGHT_BLUE: "color: lightskyblue;",
+    BRIGHT_MAGENTA: "color: violet;",
+    BRIGHT_CYAN: "color: lightcyan;",
+    BRIGHT_WHITE: "color: white;",
+};
+export const REGEX_ARRAY_OF_STRINGS = /^\[\s*(?:"[^"]*"\s*(?:,\s*"[^"]*"\s*)*)?]$/;
+export const REGEX_ARRAY_OF_BOOLEANS = /^\[\s*(?:true|false)(\s*,\s*(?:true|false))*\s*]$/;
+export const REGEX_ARRAY_OF_INTEGERS = /^\[\s*-?\d+(\s*,\s*-?\d+)*\s*]$/;
+export const REGEX_ARRAY_OF_FLOATS = /^\[\s*-?\d+(\.\d+)?([eE][-+]?\d+)?(\s*,\s*-?\d+(\.\d+)?([eE][-+]?\d+)?)*\s*]$/;
+export const safeStringify = (obj, logger) => {
+    const seen = new WeakSet();
+    return JSON.stringify(obj, (_key, val) => {
+        if (typeof val === "object" && val !== null) {
+            if (seen.has(val)) {
+                if (logger && logger.isDebugEnabled()) {
+                    logger.debug(`safeStringify: detected circular reference in obj: ${obj}${obj?.constructor?.name ? ` [constructor=${obj.constructor.name}]` : ""}`);
+                }
+                return "[Circular]";
+            }
+            seen.add(val);
+        }
+        return val;
+    });
+};
+export const splitter = new GraphemeSplitter();
+export const countVisibleChars = (data) => splitter.countGraphemes(typeof data === "string" ? data : new TextDecoder("utf-8").decode(data));
+//# sourceMappingURL=string.js.map

package/lib/esm/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/string.ts"],"names":[],"mappings":"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"}

package/lib/esm/subst.d.ts

@@ -0,0 +1,6 @@
+export type StringXformFunction = (args?: string[]) => string;
+export type StringXformContext = Record<string, string | StringXformFunction | undefined | null>;
+export declare const ERR_UNKNOWN_SUBST_CONTEXT_VAR = "Unknown context variable";
+export declare const substContext: (obj: unknown, context: StringXformContext, opts?: {
+    strict: boolean;
+}) => unknown;

package/lib/esm/subst.js

@@ -0,0 +1,37 @@
+export const ERR_UNKNOWN_SUBST_CONTEXT_VAR = "Unknown context variable";
+export const substContext = (obj, context, opts) => {
+    const transformString = (str) => {
+        return str.replace(/{{(.*?)}}/g, (_, key) => {
+            const parts = key
+                .trim()
+                .split(/\s+/)
+                .filter((s) => s.length > 0)
+                .map((s) => s.trim());
+            const k = parts[0];
+            const args = parts.length > 1 ? parts.slice(1) : [];
+            const subst = context[k];
+            if (typeof subst === "string")
+                return subst;
+            if (typeof subst === "function") {
+                return subst(args);
+            }
+            if (!opts || opts?.strict !== false)
+                throw new Error(`${ERR_UNKNOWN_SUBST_CONTEXT_VAR} var=${k}`);
+            return `??${k}`;
+        });
+    };
+    const transform = (item) => {
+        if (typeof item === "string") {
+            return transformString(item);
+        }
+        else if (Array.isArray(item)) {
+            return item.map(transform);
+        }
+        else if (item && typeof item === "object") {
+            return Object.fromEntries(Object.entries(item).map(([k, v]) => [k, transform(v)]));
+        }
+        return item;
+    };
+    return transform(obj);
+};
+//# sourceMappingURL=subst.js.map

package/lib/esm/subst.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subst.js","sourceRoot":"","sources":["../../src/subst.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAExE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAY,EAAE,OAA2B,EAAE,IAA0B,EAAW,EAAE;IAC3G,MAAM,eAAe,GAAG,CAAC,GAAW,EAAU,EAAE;QAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YACxC,MAAM,KAAK,GAAa,GAAG;iBACtB,IAAI,EAAE;iBACN,KAAK,CAAC,KAAK,CAAC;iBACZ,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;iBACnC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEpD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAEzB,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC5C,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;YACD,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,MAAM,KAAK,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,6BAA6B,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClG,OAAO,KAAK,CAAC,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,IAAa,EAAW,EAAE;QACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC,CAAC"}

package/lib/esm/time.d.ts

@@ -0,0 +1,27 @@
+import { GenericLogger } from "./logger.js";
+export type ZillaNowFunc = () => number;
+export type ZillaClock = {
+    now: ZillaNowFunc;
+};
+export declare const DEFAULT_CLOCK: ZillaClock;
+export type ZillaClockSource = () => ZillaClock;
+export declare const DEFAULT_CLOCK_SOURCE: ZillaClockSource;
+export declare class MockClock {
+    private time;
+    private start;
+    private logger?;
+    private name;
+    constructor(startTime?: number, logger?: GenericLogger, name?: string);
+    now(): number;
+    setTime(time: number): void;
+    advance(timeDelta: number): void;
+}
+export declare const mockClock: (startTime?: number) => ZillaClock;
+export declare const sleep: (ms: number) => Promise<unknown>;
+export declare const DEFAULT_NAP_CHECK = 1000;
+export type NapAlarm = {
+    wake?: boolean;
+};
+export declare const nap: (clock: ZillaClock, alarm: NapAlarm, ms: number, check?: number) => Promise<unknown>;
+export declare const parseSimpleTime: (t: string) => number;
+export declare const delay: (duration?: number | string) => Promise<void>;

package/lib/esm/time.js

@@ -0,0 +1,84 @@
+import { uuidv4 } from "./string.js";
+const DEFAULT_NOW_FUNC = () => Date.now();
+export const DEFAULT_CLOCK = {
+    now: DEFAULT_NOW_FUNC,
+};
+export const DEFAULT_CLOCK_SOURCE = () => DEFAULT_CLOCK;
+export class MockClock {
+    time;
+    start;
+    logger;
+    name;
+    constructor(startTime, logger, name) {
+        this.start = Date.now();
+        this.time = typeof startTime === "number" && startTime > 0 ? startTime : Date.now();
+        this.logger = logger;
+        this.name = name ? name : `MockClock-${uuidv4()}`;
+    }
+    now() {
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`MockClock ID=${this.name} RETURNING now=${this.time}`);
+        }
+        return this.time + (Date.now() - this.start);
+    }
+    setTime(time) {
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`MockClock ID=${this.name} SET-TIME now=${this.time} setting-to=${time}`);
+        }
+        this.time = time;
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`MockClock ID=${this.name} SET-TIME now=${this.time}`);
+        }
+    }
+    advance(timeDelta) {
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`MockClock ID=${this.name} ADVANCING now=${this.time} timeDelta=${timeDelta}`);
+        }
+        this.time += timeDelta;
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`MockClock ID=${this.name} ADVANCED now=${this.time}`);
+        }
+    }
+}
+export const mockClock = (startTime = 0) => new MockClock(startTime);
+// adapted from https://stackoverflow.com/a/39914235
+export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export const DEFAULT_NAP_CHECK = 1000;
+const _nap = (resolve, clock, alarm, ms, check) => async () => {
+    try {
+        alarm.wake = false;
+        const start = clock.now();
+        while (!alarm.wake && clock.now() - start < ms) {
+            await sleep(check);
+        }
+    }
+    finally {
+        resolve();
+    }
+};
+export const nap = (clock, alarm, ms, check) => new Promise((r) => _nap(r, clock, alarm, ms, check || DEFAULT_NAP_CHECK)());
+export const parseSimpleTime = (t) => {
+    const match = /^(\d+(\.\d+)?)([smhd])?$/.exec(t);
+    if (!match)
+        throw new Error(`Invalid time format: ${t}`);
+    const value = Number(match[1]);
+    const unit = match[3];
+    switch (unit) {
+        case "s":
+            return value * 1000;
+        case "m":
+            return value * 60 * 1000;
+        case "h":
+            return value * 3600 * 1000;
+        case "d":
+            return value * 24 * 3600 * 1000;
+        default:
+            return value;
+    }
+};
+export const delay = async (duration) => {
+    if (!duration)
+        return;
+    await sleep(typeof duration === "number" ? duration : parseSimpleTime(duration));
+};
+//# sourceMappingURL=time.js.map

package/lib/esm/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/time.ts"],"names":[],"mappings":"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"}

package/lib/esm/url.d.ts

@@ -0,0 +1,9 @@
+export type CanonicalizedUrl = {
+    original: string;
+    normalized: string;
+    redirectChain: string[];
+    landing: string;
+    canonical: string;
+};
+export declare const normalizeUrl: (input: string) => string;
+export declare const canonicalizeUrl: (url: string) => Promise<CanonicalizedUrl>;