zilla-util 1.2.27

package/lib/esm/lru.js

@@ -0,0 +1,137 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { DEFAULT_CLOCK } from "zilla-util";
+import { safeStringify } from "./string.js";
+export class LRUCache {
+    maxSize;
+    maxAge;
+    cache;
+    clock;
+    touchOnGet;
+    logger;
+    constructor({ maxSize = 100, maxAge, clock = DEFAULT_CLOCK, touchOnGet = true, logger } = {}) {
+        if (maxSize <= 0)
+            throw new Error("maxSize must be positive");
+        this.maxSize = maxSize;
+        this.maxAge = maxAge;
+        this.cache = new Map();
+        this.clock = clock;
+        this.touchOnGet = touchOnGet;
+        this.logger = logger;
+        if (this.logger && this.logger.isTraceEnabled()) {
+            if (clock.constructor) {
+                this.logger.trace(`LRUCache.constructor now=${this.clock.now()} using clock=${clock.constructor}`);
+            }
+            else {
+                this.logger.trace(`LRUCache.constructor now=${this.clock.now()} using clock=${clock === DEFAULT_CLOCK ? "DEFAULT_CLOCK" : "custom-clock"}`);
+            }
+        }
+    }
+    get(key) {
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.get(${key}) now=${this.clock.now()} starting`);
+        }
+        const entry = this.cache.get(key);
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.get(${key}) now=${this.clock.now()} entry=${entry ? safeStringify(entry) : "undefined"}`);
+        }
+        if (!entry) {
+            return undefined;
+        }
+        if (this.maxAge !== undefined && this.clock.now() - entry.timestamp > this.maxAge) {
+            if (this.logger && this.logger.isTraceEnabled()) {
+                this.logger.trace(`LRUCache.get(${key}) now=${this.clock.now()} EXPIRED entry=${entry ? safeStringify(entry) : "undefined"}`);
+            }
+            this.cache.delete(key);
+            return undefined;
+        }
+        if (this.touchOnGet) {
+            if (this.logger && this.logger.isTraceEnabled()) {
+                this.logger.trace(`LRUCache.get(${key}) now=${this.clock.now()} TOUCH-ON-GET entry=${entry ? safeStringify(entry) : "undefined"}`);
+            }
+            this.cache.delete(key);
+            this.cache.set(key, { ...entry, timestamp: this.clock.now() });
+        }
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.get(${key}) now=${this.clock.now()} RETURNING entry.value=${entry.value}`);
+        }
+        return entry.value;
+    }
+    set(key, value) {
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.set(${key}) now=${this.clock.now()} starting`);
+        }
+        if (this.cache.has(key)) {
+            if (this.logger && this.logger.isTraceEnabled()) {
+                this.logger.trace(`LRUCache.set(${key}) now=${this.clock.now()} KEY FOUND DELETING`);
+            }
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.maxSize) {
+            if (this.logger && this.logger.isTraceEnabled()) {
+                this.logger.trace(`LRUCache.set(${key}) now=${this.clock.now()} this.cache.size=${this.cache.size} >= this.maxSize=${this.maxSize} EVICTING`);
+            }
+            this.evict();
+        }
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.set(${key}) now=${this.clock.now()} SETTING value=${safeStringify(value)}`);
+        }
+        this.cache.set(key, { value, timestamp: this.clock.now() });
+    }
+    evict() {
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.evict now=${this.clock.now()} starting`);
+        }
+        const oldestKey = this.cache.keys().next().value;
+        if (oldestKey !== undefined) {
+            if (this.logger && this.logger.isTraceEnabled()) {
+                this.logger.trace(`LRUCache.evict now=${this.clock.now()} DELETING oldestKey=${oldestKey}`);
+            }
+            this.cache.delete(oldestKey);
+        }
+        else {
+            if (this.logger && this.logger.isTraceEnabled()) {
+                this.logger.trace(`LRUCache.evict now=${this.clock.now()} NOTHING TO DELETE oldestKey=undefined`);
+            }
+        }
+    }
+    delete(key) {
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.delete(${key}) now=${this.clock.now()} starting`);
+        }
+        this.cache.delete(key);
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.delete(${key}) now=${this.clock.now()} finished`);
+        }
+    }
+    clear() {
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.clear now=${this.clock.now()} starting`);
+        }
+        this.cache.clear();
+        if (this.logger && this.logger.isTraceEnabled()) {
+            this.logger.trace(`LRUCache.clear now=${this.clock.now()} finished`);
+        }
+    }
+}
+export function withLRUCache(fn, cacheOrConfig, keyFn) {
+    const cache = cacheOrConfig instanceof LRUCache ? cacheOrConfig : new LRUCache(cacheOrConfig);
+    const defaultKeyFn = (...args) => JSON.stringify(args, (key, value) => (typeof value === "function" ? value.toString() : value));
+    return (...args) => {
+        const key = (keyFn ?? defaultKeyFn)(...args);
+        const cachedValue = cache.get(key);
+        if (cachedValue !== undefined)
+            return cachedValue;
+        const result = fn(...args);
+        if (result instanceof Promise) {
+            return result.then((resolvedResult) => {
+                cache.set(key, resolvedResult);
+                return resolvedResult;
+            });
+        }
+        else {
+            cache.set(key, result);
+            return result;
+        }
+    };
+}
+//# sourceMappingURL=lru.js.map

package/lib/esm/lru.js.map

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

package/lib/esm/msg.d.ts

@@ -0,0 +1,29 @@
+export declare enum ZillaMsgTransportType {
+    email = "email",
+    sms = "sms"
+}
+export declare const MESSAGE_TYPE_VALUES: ZillaMsgTransportType[];
+export type ZillaMsgRecipient = {
+    name?: string;
+    destination: string;
+};
+export type ZillaMessage = {
+    transport: string;
+    type: ZillaMsgTransportType;
+    via: string;
+    template: string;
+    locale: string;
+    from: string;
+    to: string;
+    messages: Record<string, string>;
+    ctime: number;
+};
+export type ZillaMsgTransport = {
+    name: string;
+    type: ZillaMsgTransportType;
+    sender: string;
+    via: () => string;
+    templates: string[];
+    formatTo: (recipient: ZillaMsgRecipient) => string;
+    send: (recipient: ZillaMsgRecipient, rendered: Record<string, string>) => Promise<unknown>;
+};

package/lib/esm/msg.js

@@ -0,0 +1,7 @@
+export var ZillaMsgTransportType;
+(function (ZillaMsgTransportType) {
+    ZillaMsgTransportType["email"] = "email";
+    ZillaMsgTransportType["sms"] = "sms";
+})(ZillaMsgTransportType || (ZillaMsgTransportType = {}));
+export const MESSAGE_TYPE_VALUES = Object.values(ZillaMsgTransportType);
+//# sourceMappingURL=msg.js.map

package/lib/esm/msg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg.js","sourceRoot":"","sources":["../../src/msg.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC7B,wCAAe,CAAA;IACf,oCAAW,CAAA;AACf,CAAC,EAHW,qBAAqB,KAArB,qBAAqB,QAGhC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAA4B,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC"}

package/lib/esm/object.d.ts

@@ -0,0 +1,8 @@
+import { SortedSet } from "./array.js";
+export type EmptyObjectType = Record<string, never>;
+export declare const keysByValue: <K extends string, V>(obj: Record<K, V>, val: V) => K[];
+export declare const firstKeyByValue: <K extends string, V>(obj: Record<K, V>, val: V) => K | undefined;
+export declare const enumRecord: <E extends string | number | symbol, V>(e: Record<string, E>, init: V | ((e?: E) => V)) => Record<E, V>;
+export declare const setsToArrays: <K extends string, V>(input: Record<K, SortedSet<V>>) => Record<K, V[]>;
+export declare const findDuplicates: <T>(items: T[], field: keyof T) => string[];
+export declare const reverseEnum: <E extends Record<string, string>>(enumObj: E) => Record<string, string>;

package/lib/esm/object.js

@@ -0,0 +1,31 @@
+export const keysByValue = (obj, val) => {
+    return Object.keys(obj).filter((k) => obj[k] === val);
+};
+export const firstKeyByValue = (obj, val) => {
+    return Object.keys(obj).find((k) => obj[k] === val);
+};
+export const enumRecord = (e, init) => {
+    const o = {};
+    for (const k of Object.values(e)) {
+        o[k] = typeof init === "function" ? init(k) : init;
+    }
+    return o;
+};
+export const setsToArrays = (input) => Object.fromEntries(Object.entries(input).map(([k, set]) => [k, set.toArray()]));
+export const findDuplicates = (items, field) => {
+    const counts = new Map();
+    for (const item of items) {
+        const key = String(item[field]);
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    return [...counts].filter(([, n]) => n > 1).map(([k]) => k);
+};
+export const reverseEnum = (enumObj) => {
+    const rev = {};
+    Object.keys(enumObj).forEach((key) => {
+        const value = enumObj[key];
+        rev[value] = key;
+    });
+    return rev;
+};
+//# sourceMappingURL=object.js.map

package/lib/esm/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/object.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAsB,GAAiB,EAAE,GAAM,EAAO,EAAE;IAC/E,OAAQ,MAAM,CAAC,IAAI,CAAC,GAAG,CAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAsB,GAAiB,EAAE,GAAM,EAAiB,EAAE;IAC7F,OAAQ,MAAM,CAAC,IAAI,CAAC,GAAG,CAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CACtB,CAAoB,EACpB,IAAwB,EACZ,EAAE;IACd,MAAM,CAAC,GAAG,EAAkB,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAQ,EAAE,CAAC;QACtC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAE,IAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,CAAC;IACD,OAAO,CAAC,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAsB,KAA8B,EAAkB,EAAE,CAChG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAG,GAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAmB,CAAC;AAExH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAI,KAAU,EAAE,KAAc,EAAY,EAAE;IACtE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAmC,OAAU,EAA0B,EAAE;IAChG,MAAM,GAAG,GAA2B,EAAE,CAAC;IACtC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAoB,CAAC,OAAO,CAAC,CAAC,GAAY,EAAQ,EAAE;QACpE,MAAM,KAAK,GAAW,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAa,CAAC;IAC/B,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACf,CAAC,CAAC"}

package/lib/esm/package.d.ts

@@ -0,0 +1,2 @@
+import { GenericLogger } from "./logger.js";
+export declare const packageVersion: (importMetaUrl?: string, logger?: GenericLogger) => Promise<string | undefined>;

package/lib/esm/package.js

@@ -0,0 +1,38 @@
+const packageJsonUrl = async (startUrl) => {
+    let currentUrl = new URL(startUrl);
+    while (true) {
+        const packageUrl = new URL("package.json", currentUrl);
+        try {
+            const packageJson = await import(packageUrl.toString(), { assert: { type: "json" } });
+            if (packageJson)
+                return packageUrl; // Found package.json
+        }
+        catch {
+            const parentUrl = new URL("..", currentUrl);
+            if (parentUrl.toString() === currentUrl.toString())
+                break; // Stop if we reach the root
+            currentUrl = parentUrl; // Move up one level
+        }
+    }
+    return null; // Not found
+};
+export const packageVersion = async (importMetaUrl = import.meta.url, logger) => {
+    try {
+        const packageUrl = await packageJsonUrl(new URL(importMetaUrl));
+        if (!packageUrl)
+            throw new Error("package.json not found");
+        const packageJson = await import(packageUrl.toString(), { assert: { type: "json" } });
+        return packageJson.version;
+    }
+    catch (e) {
+        const msg = `packageVersion importMetaUrl=${importMetaUrl} error determining package version: error=${e}`;
+        if (logger) {
+            logger.error(msg, e);
+        }
+        else {
+            console.error(msg);
+        }
+        return undefined;
+    }
+};
+//# sourceMappingURL=package.js.map

package/lib/esm/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/package.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,KAAK,EAAE,QAAa,EAAuB,EAAE;IAChE,IAAI,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEnC,OAAO,IAAI,EAAE,CAAC;QACV,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC;YACD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACtF,IAAI,WAAW;gBAAE,OAAO,UAAU,CAAC,CAAC,qBAAqB;QAC7D,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC5C,IAAI,SAAS,CAAC,QAAQ,EAAE,KAAK,UAAU,CAAC,QAAQ,EAAE;gBAAE,MAAM,CAAC,4BAA4B;YACvF,UAAU,GAAG,SAAS,CAAC,CAAC,oBAAoB;QAChD,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,YAAY;AAC7B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAC/B,gBAAwB,MAAM,CAAC,IAAI,CAAC,GAAG,EACvC,MAAsB,EACK,EAAE;IAC7B,IAAI,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAE3D,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACtF,OAAO,WAAW,CAAC,OAAO,CAAC;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,GAAG,GAAG,gCAAgC,aAAa,6CAA6C,CAAC,EAAE,CAAC;QAC1G,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC,CAAC"}

package/lib/esm/regex.d.ts

@@ -0,0 +1 @@
+export declare const shortStringMatch: (regex: RegExp) => string;

package/lib/esm/regex.js

@@ -0,0 +1,22 @@
+export const shortStringMatch = (regex) => {
+    if (regex.test(""))
+        return "";
+    const chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+    for (let length = 1; length <= 3; length++) {
+        const stack = [{ text: "", index: 0 }];
+        while (stack.length) {
+            const { text, index } = stack.pop();
+            if (index === length) {
+                if (regex.test(text))
+                    return text;
+            }
+            else {
+                for (const c of chars) {
+                    stack.push({ text: text + c, index: index + 1 });
+                }
+            }
+        }
+    }
+    throw new Error("No short match found up to length 3");
+};
+//# sourceMappingURL=regex.js.map

package/lib/esm/regex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.js","sourceRoot":"","sources":["../../src/regex.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE;IACtD,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,gEAAgE,CAAC;IAC/E,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;QACzC,MAAM,KAAK,GAAsC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,EAAqC,CAAC;YACvE,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACnB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;oBAAE,OAAO,IAAI,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACJ,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;oBACpB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrD,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;AAC3D,CAAC,CAAC"}

package/lib/esm/retry.d.ts

@@ -0,0 +1,13 @@
+import { GenericLogger } from "./logger.js";
+export type RetryOptions = {
+    maxAttempts?: number;
+    backoffBaseMillis?: number;
+    backoffMultiplier?: number;
+    canRetry?: (e: Error) => Promise<boolean> | boolean;
+};
+export declare const DEFAULT_RETRY_MAX_ATTEMPTS = 3;
+export declare const DEFAULT_RETRY_BACKOFF_BASE_MILLIS = 250;
+export declare const DEFAULT_RETRY_BACKOFF_MULTIPLIER = 3;
+export declare const DEFAULT_RETRY_CAN_RETRY_FUNC: () => boolean;
+export declare const DEFAULT_RETRY_OPTS: RetryOptions;
+export declare const retry: <T>(fn: () => Promise<T>, opts?: RetryOptions, logger?: GenericLogger, action?: string) => Promise<T>;

package/lib/esm/retry.js

@@ -0,0 +1,57 @@
+import { sleep } from "./time.js";
+import { safeStringify } from "./string.js";
+export const DEFAULT_RETRY_MAX_ATTEMPTS = 3;
+export const DEFAULT_RETRY_BACKOFF_BASE_MILLIS = 250;
+export const DEFAULT_RETRY_BACKOFF_MULTIPLIER = 3;
+export const DEFAULT_RETRY_CAN_RETRY_FUNC = () => true;
+export const DEFAULT_RETRY_OPTS = {
+    maxAttempts: DEFAULT_RETRY_MAX_ATTEMPTS,
+    backoffBaseMillis: DEFAULT_RETRY_BACKOFF_BASE_MILLIS,
+    backoffMultiplier: DEFAULT_RETRY_BACKOFF_MULTIPLIER,
+    canRetry: DEFAULT_RETRY_CAN_RETRY_FUNC,
+};
+export const retry = async (fn, opts, logger, action) => {
+    const maxAttempts = opts?.maxAttempts || DEFAULT_RETRY_MAX_ATTEMPTS;
+    const backoffBaseMillis = opts?.backoffBaseMillis || DEFAULT_RETRY_BACKOFF_BASE_MILLIS;
+    const backoffMultiplier = opts?.backoffMultiplier || DEFAULT_RETRY_BACKOFF_MULTIPLIER;
+    const canRetry = opts?.canRetry || DEFAULT_RETRY_CAN_RETRY_FUNC;
+    const prefix = logger ? (action ? `@@@ retry[${action}]:` : "retry:") : "";
+    let backoffTime = backoffBaseMillis;
+    let error;
+    if (logger && logger.isDebugEnabled()) {
+        logger.debug(`${prefix} starting with opts=${opts ? safeStringify(opts) : "undefined"}`);
+    }
+    for (let i = 0; i < maxAttempts; i++) {
+        const iPrefix = `${prefix} [${i + 1}/${maxAttempts}]:`;
+        if (i > 0) {
+            if (logger && logger.isDebugEnabled()) {
+                logger.debug(`${iPrefix} waiting for ${backoffTime} before retrying`);
+            }
+            await sleep(backoffTime);
+            backoffTime = Math.floor(backoffTime * backoffMultiplier);
+        }
+        try {
+            if (logger && logger.isDebugEnabled()) {
+                logger.debug(`${iPrefix} calling function`);
+            }
+            return await fn();
+        }
+        catch (e) {
+            error = e;
+            if (!(await canRetry(e))) {
+                if (logger && logger.isDebugEnabled()) {
+                    logger.debug(`${iPrefix} function threw error and canRetry=false, throwing e=${e}`, e);
+                }
+                throw e;
+            }
+            if (logger && logger.isDebugEnabled()) {
+                logger.debug(`${iPrefix} function threw error=${e} and canRetry=true, continuing`, e);
+            }
+        }
+    }
+    if (logger && logger.isDebugEnabled()) {
+        logger.debug(`${prefix} maxAttempts exceeded, throwing most recent error=${error}`, error);
+    }
+    throw error;
+};
+//# sourceMappingURL=retry.js.map

package/lib/esm/retry.js.map

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

package/lib/esm/sha256.d.ts

@@ -0,0 +1,50 @@
+export default Sha256;
+/**
+ * SHA-256 hash function reference implementation.
+ *
+ * This is an annotated direct implementation of FIPS 180-4, without any optimisations. It is
+ * intended to aid understanding of the algorithm rather than for production use.
+ *
+ * While it could be used where performance is not critical, I would recommend using the ‘Web
+ * Cryptography API’ (developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/digest) for the browser,
+ * or the ‘crypto’ library (nodejs.org/api/crypto.html#crypto_class_hash) in Node.js.
+ *
+ * See csrc.nist.gov/groups/ST/toolkit/secure_hashing.html
+ *     csrc.nist.gov/groups/ST/toolkit/examples.html
+ */
+declare class Sha256 {
+    /**
+     * Generates SHA-256 hash of string.
+     *
+     * @param   {string} msg - (Unicode) string to be hashed.
+     * @param   {Object} [options]
+     * @param   {string} [options.msgFormat=string] - Message format: 'string' for JavaScript string
+     *   (gets converted to UTF-8 for hashing); 'hex-bytes' for string of hex bytes ('616263' ≡ 'abc') .
+     * @param   {string} [options.outFormat=hex] - Output format: 'hex' for string of contiguous
+     *   hex bytes; 'hex-w' for grouping hex bytes into groups of (4 byte / 8 character) words.
+     * @returns {string} Hash of msg as hex character string.
+     *
+     * @example
+     *   import Sha256 from './sha256.js';
+     *   const hash = Sha256.hash('abc'); // 'ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad'
+     */
+    static hash(msg: string, options?: {
+        msgFormat?: string | undefined;
+        outFormat?: string | undefined;
+    }): string;
+    /**
+     * Rotates right (circular right shift) value x by n positions [§3.2.4].
+     * @private
+     */
+    private static ROTR;
+    /**
+     * Logical functions [§4.1.2].
+     * @private
+     */
+    private static Σ0;
+    static Σ1(x: any): number;
+    static σ0(x: any): number;
+    static σ1(x: any): number;
+    static Ch(x: any, y: any, z: any): number;
+    static Maj(x: any, y: any, z: any): number;
+}

package/lib/esm/sha256.js

@@ -0,0 +1,181 @@
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+/* SHA-256 (FIPS 180-4) implementation in JavaScript                  (c) Chris Veness 2002-2019  */
+/*                                                                                   MIT Licence  */
+/* www.movable-type.co.uk/scripts/sha256.html                                                     */
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+/**
+ * SHA-256 hash function reference implementation.
+ *
+ * This is an annotated direct implementation of FIPS 180-4, without any optimisations. It is
+ * intended to aid understanding of the algorithm rather than for production use.
+ *
+ * While it could be used where performance is not critical, I would recommend using the ‘Web
+ * Cryptography API’ (developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/digest) for the browser,
+ * or the ‘crypto’ library (nodejs.org/api/crypto.html#crypto_class_hash) in Node.js.
+ *
+ * See csrc.nist.gov/groups/ST/toolkit/secure_hashing.html
+ *     csrc.nist.gov/groups/ST/toolkit/examples.html
+ */
+class Sha256 {
+    /**
+     * Generates SHA-256 hash of string.
+     *
+     * @param   {string} msg - (Unicode) string to be hashed.
+     * @param   {Object} [options]
+     * @param   {string} [options.msgFormat=string] - Message format: 'string' for JavaScript string
+     *   (gets converted to UTF-8 for hashing); 'hex-bytes' for string of hex bytes ('616263' ≡ 'abc') .
+     * @param   {string} [options.outFormat=hex] - Output format: 'hex' for string of contiguous
+     *   hex bytes; 'hex-w' for grouping hex bytes into groups of (4 byte / 8 character) words.
+     * @returns {string} Hash of msg as hex character string.
+     *
+     * @example
+     *   import Sha256 from './sha256.js';
+     *   const hash = Sha256.hash('abc'); // 'ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad'
+     */
+    static hash(msg, options) {
+        const defaults = { msgFormat: "string", outFormat: "hex" };
+        const opt = Object.assign(defaults, options);
+        // note use throughout this routine of 'n >>> 0' to coerce Number 'n' to unsigned 32-bit integer
+        switch (opt.msgFormat) {
+            default: // default is to convert string to UTF-8, as SHA only deals with byte-streams
+            case "string":
+                msg = utf8Encode(msg);
+                break;
+            case "hex-bytes":
+                msg = hexBytesToString(msg);
+                break; // mostly for running tests
+        }
+        // constants [§4.2.2]
+        const K = [
+            0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5, 0xd807aa98,
+            0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, 0xe49b69c1, 0xefbe4786,
+            0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da, 0x983e5152, 0xa831c66d, 0xb00327c8,
+            0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967, 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13,
+            0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819,
+            0xd6990624, 0xf40e3585, 0x106aa070, 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a,
+            0x5b9cca4f, 0x682e6ff3, 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7,
+            0xc67178f2,
+        ];
+        // initial hash value [§5.3.3]
+        const H = [0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19];
+        // PREPROCESSING [§6.2.1]
+        msg += String.fromCharCode(0x80); // add trailing '1' bit (+ 0's padding) to string [§5.1.1]
+        // convert string msg into 512-bit blocks (array of 16 32-bit integers) [§5.2.1]
+        const l = msg.length / 4 + 2; // length (in 32-bit integers) of msg + ‘1’ + appended length
+        const N = Math.ceil(l / 16); // number of 16-integer (512-bit) blocks required to hold 'l' ints
+        const M = new Array(N); // message M is N×16 array of 32-bit integers
+        for (let i = 0; i < N; i++) {
+            M[i] = new Array(16);
+            for (let j = 0; j < 16; j++) {
+                // encode 4 chars per integer (64 per block), big-endian encoding
+                M[i][j] =
+                    (msg.charCodeAt(i * 64 + j * 4 + 0) << 24) |
+                        (msg.charCodeAt(i * 64 + j * 4 + 1) << 16) |
+                        (msg.charCodeAt(i * 64 + j * 4 + 2) << 8) |
+                        (msg.charCodeAt(i * 64 + j * 4 + 3) << 0);
+            } // note running off the end of msg is ok 'cos bitwise ops on NaN return 0
+        }
+        // add length (in bits) into final pair of 32-bit integers (big-endian) [§5.1.1]
+        // note: most significant word would be (len-1)*8 >>> 32, but since JS converts
+        // bitwise-op args to 32 bits, we need to simulate this by arithmetic operators
+        const lenHi = ((msg.length - 1) * 8) / Math.pow(2, 32);
+        const lenLo = ((msg.length - 1) * 8) >>> 0;
+        M[N - 1][14] = Math.floor(lenHi);
+        M[N - 1][15] = lenLo;
+        // HASH COMPUTATION [§6.2.2]
+        for (let i = 0; i < N; i++) {
+            const W = new Array(64);
+            // 1 - prepare message schedule 'W'
+            for (let t = 0; t < 16; t++)
+                W[t] = M[i][t];
+            for (let t = 16; t < 64; t++) {
+                W[t] = (Sha256.σ1(W[t - 2]) + W[t - 7] + Sha256.σ0(W[t - 15]) + W[t - 16]) >>> 0;
+            }
+            // 2 - initialise working variables a, b, c, d, e, f, g, h with previous hash value
+            let a = H[0], b = H[1], c = H[2], d = H[3], e = H[4], f = H[5], g = H[6], h = H[7];
+            // 3 - main loop (note '>>> 0' for 'addition modulo 2^32')
+            for (let t = 0; t < 64; t++) {
+                const T1 = h + Sha256.Σ1(e) + Sha256.Ch(e, f, g) + K[t] + W[t];
+                const T2 = Sha256.Σ0(a) + Sha256.Maj(a, b, c);
+                h = g;
+                g = f;
+                f = e;
+                e = (d + T1) >>> 0;
+                d = c;
+                c = b;
+                b = a;
+                a = (T1 + T2) >>> 0;
+            }
+            // 4 - compute the new intermediate hash value (note '>>> 0' for 'addition modulo 2^32')
+            H[0] = (H[0] + a) >>> 0;
+            H[1] = (H[1] + b) >>> 0;
+            H[2] = (H[2] + c) >>> 0;
+            H[3] = (H[3] + d) >>> 0;
+            H[4] = (H[4] + e) >>> 0;
+            H[5] = (H[5] + f) >>> 0;
+            H[6] = (H[6] + g) >>> 0;
+            H[7] = (H[7] + h) >>> 0;
+        }
+        // convert H0..H7 to hex strings (with leading zeros)
+        for (let h = 0; h < H.length; h++)
+            H[h] = ("00000000" + H[h].toString(16)).slice(-8);
+        // concatenate H0..H7, with separator if required
+        const separator = opt.outFormat == "hex-w" ? " " : "";
+        return H.join(separator);
+        /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+        function utf8Encode(str) {
+            try {
+                return new TextEncoder()
+                    .encode(str, "utf-8")
+                    .reduce((prev, curr) => prev + String.fromCharCode(curr), "");
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            }
+            catch (e) {
+                // no TextEncoder available?
+                return unescape(encodeURIComponent(str)); // monsur.hossa.in/2012/07/20/utf-8-in-javascript.html
+            }
+        }
+        function hexBytesToString(hexStr) {
+            // convert string of hex numbers to a string of chars (eg '616263' -> 'abc').
+            const str = hexStr.replace(" ", ""); // allow space-separated groups
+            return str == ""
+                ? ""
+                : str
+                    .match(/.{2}/g)
+                    .map((byte) => String.fromCharCode(parseInt(byte, 16)))
+                    .join("");
+        }
+    }
+    /**
+     * Rotates right (circular right shift) value x by n positions [§3.2.4].
+     * @private
+     */
+    static ROTR(n, x) {
+        return (x >>> n) | (x << (32 - n));
+    }
+    /**
+     * Logical functions [§4.1.2].
+     * @private
+     */
+    static Σ0(x) {
+        return Sha256.ROTR(2, x) ^ Sha256.ROTR(13, x) ^ Sha256.ROTR(22, x);
+    }
+    static Σ1(x) {
+        return Sha256.ROTR(6, x) ^ Sha256.ROTR(11, x) ^ Sha256.ROTR(25, x);
+    }
+    static σ0(x) {
+        return Sha256.ROTR(7, x) ^ Sha256.ROTR(18, x) ^ (x >>> 3);
+    }
+    static σ1(x) {
+        return Sha256.ROTR(17, x) ^ Sha256.ROTR(19, x) ^ (x >>> 10);
+    }
+    static Ch(x, y, z) {
+        return (x & y) ^ (~x & z);
+    } // 'choice'
+    static Maj(x, y, z) {
+        return (x & y) ^ (x & z) ^ (y & z);
+    } // 'majority'
+}
+/* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
+export default Sha256;
+//# sourceMappingURL=sha256.js.map