@iwentsourcing/core 0.1.0

package/dist/utils/combine-abort-signal.js

@@ -0,0 +1,15 @@
+export function combineAbortSignal(first, second) {
+    const ctrl = new AbortController();
+    const firstListener = () => {
+        ctrl.abort();
+        second.removeEventListener('abort', firstListener);
+    };
+    const secondListener = () => {
+        ctrl.abort();
+        first.removeEventListener('abort', secondListener);
+    };
+    first.addEventListener('abort', firstListener, { once: true });
+    second.addEventListener('abort', secondListener, { once: true });
+    return ctrl.signal;
+}
+//# sourceMappingURL=combine-abort-signal.js.map

package/dist/utils/combine-abort-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combine-abort-signal.js","sourceRoot":"","sources":["../../src/utils/combine-abort-signal.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,KAAkB,EAAE,MAAmB;IACxE,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;IAEnC,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACrD,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,GAAG,EAAE;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC,CAAC;IAEF,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjE,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC"}

package/dist/utils/create-lazy-async-map.d.ts

@@ -0,0 +1,3 @@
+export declare function createLazyAsyncMap<Source, Value>(array: Source[], mapper: (source: Source) => Promise<Value>, keySelector: (val: Value) => string): {
+    get(key: string): Promise<Value | null>;
+};

package/dist/utils/create-lazy-async-map.js

@@ -0,0 +1,25 @@
+export function createLazyAsyncMap(array, mapper, keySelector) {
+    const map = {};
+    let index = 0;
+    return {
+        async get(key) {
+            const existing = map[key];
+            if (existing) {
+                return existing;
+            }
+            for (; index < array.length; index++) {
+                const item = array[index];
+                if (item) {
+                    const mapped = await mapper(item);
+                    const mappedKey = keySelector(mapped);
+                    map[mappedKey] = mapped;
+                    if (key === mappedKey) {
+                        return mapped;
+                    }
+                }
+            }
+            return null;
+        },
+    };
+}
+//# sourceMappingURL=create-lazy-async-map.js.map

package/dist/utils/create-lazy-async-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-lazy-async-map.js","sourceRoot":"","sources":["../../src/utils/create-lazy-async-map.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAChC,KAAe,EACf,MAA0C,EAC1C,WAAmC;IAEnC,MAAM,GAAG,GAA0B,EAAE,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC1B,IAAI,IAAI,EAAE,CAAC;oBACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;oBAClC,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;oBACtC,GAAG,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;oBACxB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;wBACtB,OAAO,MAAM,CAAC;oBAChB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/distinct-array.d.ts

@@ -0,0 +1 @@
+export declare function distinctArray<T>(array: T[]): T[];

package/dist/utils/distinct-array.js

@@ -0,0 +1,4 @@
+export function distinctArray(array) {
+    return array.filter((item, index) => array.indexOf(item) === index);
+}
+//# sourceMappingURL=distinct-array.js.map

package/dist/utils/distinct-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distinct-array.js","sourceRoot":"","sources":["../../src/utils/distinct-array.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAI,KAAU;IACzC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;AACtE,CAAC"}

package/dist/utils/expect-first-item.d.ts

@@ -0,0 +1,2 @@
+export declare function expectFirstItem<T>(array: T[] | T): T;
+export declare function expectArrayItem<T>(array: T[] | T, index: number): T;

package/dist/utils/expect-first-item.js

@@ -0,0 +1,24 @@
+import { CustomError } from '../error/custom-error.js';
+export function expectFirstItem(array) {
+    if (array instanceof Array) {
+        if (!array[0]) {
+            throw new CustomError('expected array item value on', {
+                index: '0',
+            });
+        }
+        return array[0];
+    }
+    return array;
+}
+export function expectArrayItem(array, index) {
+    if (array instanceof Array) {
+        if (!array[index]) {
+            throw new CustomError('expected array item value on', {
+                index: index.toString(),
+            });
+        }
+        return array[index];
+    }
+    return array;
+}
+//# sourceMappingURL=expect-first-item.js.map

package/dist/utils/expect-first-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect-first-item.js","sourceRoot":"","sources":["../../src/utils/expect-first-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,UAAU,eAAe,CAAI,KAAc;IAC/C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,WAAW,CAAC,8BAA8B,EAAE;gBACpD,KAAK,EAAE,GAAG;aACX,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,KAAc,EAAE,KAAa;IAC9D,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,WAAW,CAAC,8BAA8B,EAAE;gBACpD,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;aACxB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/expect-value.d.ts

@@ -0,0 +1 @@
+export declare function expectValue<T, K extends keyof T & string>(map: T, key: K): NonNullable<T[K]>;

package/dist/utils/expect-value.js

@@ -0,0 +1,11 @@
+import { CustomError } from '../error/custom-error.js';
+export function expectValue(map, key) {
+    const value = map[key];
+    if (!value) {
+        throw new CustomError('expected value', {
+            key,
+        });
+    }
+    return value;
+}
+//# sourceMappingURL=expect-value.js.map

package/dist/utils/expect-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect-value.js","sourceRoot":"","sources":["../../src/utils/expect-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,UAAU,WAAW,CACzB,GAAM,EACN,GAAM;IAEN,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CAAC,gBAAgB,EAAE;YACtC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/extract-date-from-uuid.d.ts

@@ -0,0 +1 @@
+export declare function extractTimestampFromUUIDv7(uuid: string): Date;

package/dist/utils/extract-date-from-uuid.js

@@ -0,0 +1,16 @@
+import { CustomError } from '../error/custom-error.js';
+export function extractTimestampFromUUIDv7(uuid) {
+    // split the UUID into its components
+    const parts = uuid.split('-');
+    if (parts.length != 5) {
+        throw new CustomError('invalid uuid v7', {});
+    }
+    // the second part of the UUID contains the high bits of the timestamp (48 bits in total)
+    const highBitsHex = parts[0] + (parts[1] ?? '').slice(0, 4);
+    // convert the high bits from hex to decimal
+    // the UUID v7 timestamp is the number of milliseconds since Unix epoch (January 1, 1970)
+    const timestampInMilliseconds = parseInt(highBitsHex, 16);
+    // convert the timestamp to a Date object
+    return new Date(timestampInMilliseconds);
+}
+//# sourceMappingURL=extract-date-from-uuid.js.map

package/dist/utils/extract-date-from-uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-date-from-uuid.js","sourceRoot":"","sources":["../../src/utils/extract-date-from-uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,qCAAqC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE9B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,WAAW,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,yFAAyF;IACzF,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5D,4CAA4C;IAC5C,yFAAyF;IACzF,MAAM,uBAAuB,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAE1D,yCAAyC;IACzC,OAAO,IAAI,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAC3C,CAAC"}

package/dist/utils/fail-never.d.ts

@@ -0,0 +1 @@
+export declare function failNever(x: never, error: string): never;

package/dist/utils/fail-never.js

@@ -0,0 +1,4 @@
+export function failNever(x, error) {
+    throw new Error(`Unexpected error: ${error}`);
+}
+//# sourceMappingURL=fail-never.js.map

package/dist/utils/fail-never.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail-never.js","sourceRoot":"","sources":["../../src/utils/fail-never.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,CAAQ,EAAE,KAAa;IAC/C,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/utils/get-or-create.d.ts

@@ -0,0 +1,6 @@
+export declare function getOrCreate<T>(map: {
+    [key: string]: T;
+}, key: string, create: () => T): T;
+export declare function setIfEmpty<T>(map: {
+    [key: string]: T;
+}, key: string, value: T): void;

package/dist/utils/get-or-create.js

@@ -0,0 +1,18 @@
+import { CustomError } from '../error/custom-error.js';
+export function getOrCreate(map, key, create) {
+    const existing = map[key];
+    if (existing === undefined) {
+        const value = create();
+        map[key] = value;
+        return value;
+    }
+    return existing;
+}
+export function setIfEmpty(map, key, value) {
+    const existing = map[key];
+    if (existing) {
+        throw new CustomError('key already exists', { key });
+    }
+    map[key] = value;
+}
+//# sourceMappingURL=get-or-create.js.map

package/dist/utils/get-or-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-or-create.js","sourceRoot":"","sources":["../../src/utils/get-or-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,UAAU,WAAW,CACzB,GAAyB,EACzB,GAAW,EACX,MAAe;IAEf,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,GAAyB,EACzB,GAAW,EACX,KAAQ;IAER,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,WAAW,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AACnB,CAAC"}

package/dist/utils/get-or-fail.d.ts

@@ -0,0 +1,6 @@
+export declare function getOrFail<T extends {
+    [key: string]: any;
+}, K extends keyof T & string>(map: T, key: K): T[K];
+export declare function getOrFailAsync<T>(map: {
+    get(key: string): Promise<T | null>;
+}, key: string): Promise<T>;

package/dist/utils/get-or-fail.js

@@ -0,0 +1,20 @@
+import { CustomError } from '../error/custom-error.js';
+export function getOrFail(map, key) {
+    const value = map ? map[key] : undefined;
+    if (!value) {
+        throw new CustomError('missing key', {
+            key,
+        });
+    }
+    return value;
+}
+export async function getOrFailAsync(map, key) {
+    const value = await map.get(key);
+    if (!value) {
+        throw new CustomError('missing key', {
+            key,
+        });
+    }
+    return value;
+}
+//# sourceMappingURL=get-or-fail.js.map

package/dist/utils/get-or-fail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-or-fail.js","sourceRoot":"","sources":["../../src/utils/get-or-fail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,UAAU,SAAS,CAGvB,GAAM,EAAE,GAAM;IACd,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CAAC,aAAa,EAAE;YACnC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAA4C,EAC5C,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,WAAW,CAAC,aAAa,EAAE;YACnC,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/get-or-fallback.d.ts

@@ -0,0 +1,3 @@
+export declare function getOrFallback<T extends {
+    [key: string]: any;
+}>(map: T, key: string | undefined, fallback: keyof T): any;

package/dist/utils/get-or-fallback.js

@@ -0,0 +1,8 @@
+export function getOrFallback(map, key, fallback) {
+    const existing = key ? map[key] : undefined;
+    if (existing === undefined) {
+        return map[fallback];
+    }
+    return existing;
+}
+//# sourceMappingURL=get-or-fallback.js.map

package/dist/utils/get-or-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-or-fallback.js","sourceRoot":"","sources":["../../src/utils/get-or-fallback.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAC3B,GAAM,EACN,GAAuB,EACvB,QAAiB;IAEjB,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/is-defined.d.ts

@@ -0,0 +1 @@
+export declare function isDefined<T>(val: T | undefined | null): asserts val is T;

package/dist/utils/is-defined.js

@@ -0,0 +1,6 @@
+export function isDefined(val) {
+    if (val === undefined || val === null) {
+        throw new Error('value is not defined');
+    }
+}
+//# sourceMappingURL=is-defined.js.map

package/dist/utils/is-defined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-defined.js","sourceRoot":"","sources":["../../src/utils/is-defined.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAI,GAAyB;IACpD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/utils/is-false.d.ts

@@ -0,0 +1 @@
+export declare function isFalse(val: true | false | undefined): asserts val is false;

package/dist/utils/is-false.js

@@ -0,0 +1,6 @@
+export function isFalse(val) {
+    if (val !== false || val === undefined || val === null) {
+        throw new Error('value is not false');
+    }
+}
+//# sourceMappingURL=is-false.js.map

package/dist/utils/is-false.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-false.js","sourceRoot":"","sources":["../../src/utils/is-false.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,GAA6B;IACnD,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/utils/iter-record.d.ts

@@ -0,0 +1,4 @@
+type StringKeyedReadonlyRecord = Readonly<Record<string, unknown>>;
+export declare function recordValues<R extends StringKeyedReadonlyRecord>(r: R): NonNullable<R[string]>[];
+export declare function recordEntries<R extends StringKeyedReadonlyRecord>(r: R): [string, NonNullable<R[string]>][];
+export {};

package/dist/utils/iter-record.js

@@ -0,0 +1,21 @@
+export function recordValues(r) {
+    const out = [];
+    for (const k of Object.keys(r)) {
+        const v = r[k];
+        if (v !== undefined) {
+            out.push(v);
+        }
+    }
+    return out;
+}
+export function recordEntries(r) {
+    const out = [];
+    for (const k of Object.keys(r)) {
+        const v = r[k];
+        if (v !== undefined) {
+            out.push([k, v]);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=iter-record.js.map

package/dist/utils/iter-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iter-record.js","sourceRoot":"","sources":["../../src/utils/iter-record.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAC1B,CAAI;IAEJ,MAAM,GAAG,GAA6B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,CAA2B,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,CAAI;IAEJ,MAAM,GAAG,GAAuC,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAA2B,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/iter-record.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/iter-record.test.js

@@ -0,0 +1,15 @@
+import { describe, it } from 'node:test';
+import { deepEqual } from 'node:assert';
+import { recordEntries, recordValues } from './iter-record.js';
+describe('iter-record', () => {
+    it('recordValues collects defined values', () => {
+        deepEqual(recordValues({ a: 1, b: 2 }), [1, 2]);
+    });
+    it('recordEntries collects defined entries in key order', () => {
+        deepEqual(recordEntries({ x: 10, y: 20 }), [
+            ['x', 10],
+            ['y', 20],
+        ]);
+    });
+});
+//# sourceMappingURL=iter-record.test.js.map

package/dist/utils/iter-record.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iter-record.test.js","sourceRoot":"","sources":["../../src/utils/iter-record.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE/D,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE;YACzC,CAAC,GAAG,EAAE,EAAE,CAAC;YACT,CAAC,GAAG,EAAE,EAAE,CAAC;SACV,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/iterate.d.ts

@@ -0,0 +1 @@
+export declare function iterate(val: string | string[]): string[];

package/dist/utils/iterate.js

@@ -0,0 +1,4 @@
+export function iterate(val) {
+    return Array.isArray(val) ? val : [val];
+}
+//# sourceMappingURL=iterate.js.map

package/dist/utils/iterate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterate.js","sourceRoot":"","sources":["../../src/utils/iterate.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,GAAsB;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC"}

package/dist/utils/lru-cache.d.ts

@@ -0,0 +1,11 @@
+export declare class LruCache<K, V> {
+    private readonly map;
+    private readonly maxSize;
+    constructor(maxSize: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    has(key: K): boolean;
+    delete(key: K): boolean;
+    clear(): void;
+    private evict;
+}

package/dist/utils/lru-cache.js

@@ -0,0 +1,44 @@
+export class LruCache {
+    map;
+    maxSize;
+    constructor(maxSize) {
+        this.maxSize = Math.max(1, Math.floor(maxSize));
+        this.map = new Map();
+    }
+    get(key) {
+        const value = this.map.get(key);
+        if (value !== undefined) {
+            this.map.delete(key);
+            this.map.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        if (this.map.has(key)) {
+            this.map.delete(key);
+        }
+        this.map.set(key, value);
+        this.evict();
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    delete(key) {
+        return this.map.delete(key);
+    }
+    clear() {
+        this.map.clear();
+    }
+    evict() {
+        while (this.map.size > this.maxSize) {
+            const oldestKey = this.map.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.map.delete(oldestKey);
+            }
+            else {
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=lru-cache.js.map

package/dist/utils/lru-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-cache.js","sourceRoot":"","sources":["../../src/utils/lru-cache.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAQ;IACF,GAAG,CAAY;IACf,OAAO,CAAS;IAEjC,YAAY,OAAe;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,GAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,GAAM;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAEO,KAAK;QACX,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAsB,CAAC;YAChE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/utils/nested-abort.d.ts

@@ -0,0 +1 @@
+export declare function nestedAbort(signal: AbortSignal): AbortController;

package/dist/utils/nested-abort.js

@@ -0,0 +1,8 @@
+export function nestedAbort(signal) {
+    const ctrl = new AbortController();
+    signal.addEventListener('abort', () => {
+        ctrl.abort();
+    }, { once: true });
+    return ctrl;
+}
+//# sourceMappingURL=nested-abort.js.map

package/dist/utils/nested-abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nested-abort.js","sourceRoot":"","sources":["../../src/utils/nested-abort.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;IAEnC,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE;QACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/now-in-seconds.d.ts

@@ -0,0 +1 @@
+export declare function nowInSeconds(): number;

package/dist/utils/now-in-seconds.js

@@ -0,0 +1,4 @@
+export function nowInSeconds() {
+    return new Date().getTime() / 1000;
+}
+//# sourceMappingURL=now-in-seconds.js.map

package/dist/utils/now-in-seconds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"now-in-seconds.js","sourceRoot":"","sources":["../../src/utils/now-in-seconds.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;AACrC,CAAC"}

package/dist/utils/reusable-map.d.ts

@@ -0,0 +1,6 @@
+export interface ReusableMap<T> {
+    remove(key: string): void;
+    sessions(): string[];
+    getOrCreate(key: string, signal: AbortSignal, fn: (signal: AbortSignal) => T): T;
+}
+export declare function createReusableMap<T>(): ReusableMap<T>;

package/dist/utils/reusable-map.js

@@ -0,0 +1,45 @@
+// TODO implement min pool and keep some entries alive
+export function createReusableMap() {
+    const map = {};
+    function attachAbort(key, signal, entry) {
+        signal.addEventListener('abort', () => {
+            entry.handleCount--;
+            if (entry.handleCount === 0) {
+                entry.abortController.abort();
+                delete map[key];
+            }
+        }, { once: true });
+    }
+    return {
+        remove(key) {
+            const existing = map[key];
+            if (existing) {
+                existing.abortController.abort();
+                delete map[key];
+            }
+        },
+        sessions() {
+            return Object.keys(map);
+        },
+        getOrCreate: (key, signal, fn) => {
+            const existing = map[key];
+            if (existing) {
+                existing.handleCount++;
+                attachAbort(key, signal, existing);
+                return existing.value;
+            }
+            else {
+                const abortController = new AbortController();
+                const newValue = {
+                    value: fn(abortController.signal),
+                    abortController,
+                    handleCount: 1,
+                };
+                map[key] = newValue;
+                attachAbort(key, signal, newValue);
+                return newValue.value;
+            }
+        },
+    };
+}
+//# sourceMappingURL=reusable-map.js.map

package/dist/utils/reusable-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reusable-map.js","sourceRoot":"","sources":["../../src/utils/reusable-map.ts"],"names":[],"mappings":"AAgBA,sDAAsD;AACtD,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAmC,EAAE,CAAC;IAE/C,SAAS,WAAW,CAClB,GAAW,EACX,MAAmB,EACnB,KAAqB;QAErB,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,GAAG,EAAE;YACH,KAAK,CAAC,WAAW,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;gBAC5B,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;gBAC9B,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,CAAC,GAAW;YAChB,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;gBACjC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,QAAQ;YACN,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,WAAW,EAAE,CACX,GAAW,EACX,MAAmB,EACnB,EAA8B,EAC9B,EAAE;YACF,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YAE1B,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACvB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACnC,OAAO,QAAQ,CAAC,KAAK,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;gBAC9C,MAAM,QAAQ,GAAmB;oBAC/B,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC;oBACjC,eAAe;oBACf,WAAW,EAAE,CAAC;iBACf,CAAC;gBACF,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;gBACpB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACnC,OAAO,QAAQ,CAAC,KAAK,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/reusable-resolvable.d.ts

@@ -0,0 +1,3 @@
+export declare function reusableResolvable<T>(): {
+    resolve(fn: () => Promise<T>): Promise<T>;
+};

package/dist/utils/reusable-resolvable.js

@@ -0,0 +1,14 @@
+export function reusableResolvable() {
+    let promise = null;
+    return {
+        resolve(fn) {
+            if (!promise) {
+                promise = fn().finally(() => {
+                    promise = null;
+                });
+            }
+            return promise;
+        },
+    };
+}
+//# sourceMappingURL=reusable-resolvable.js.map

package/dist/utils/reusable-resolvable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reusable-resolvable.js","sourceRoot":"","sources":["../../src/utils/reusable-resolvable.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB;IAChC,IAAI,OAAO,GAAsB,IAAI,CAAC;IACtC,OAAO;QACL,OAAO,CAAC,EAAoB;YAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;oBAC1B,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/rotating-map.d.ts

@@ -0,0 +1,19 @@
+export interface RotatingMap<T> {
+    get(key: string): T | undefined;
+    getOrCreate(key: string, create: (signal: AbortSignal) => T, signal?: AbortSignal): T;
+    delete(key: string): void;
+}
+/**
+ * Fixed-capacity cache. When the entry count exceeds `limit` the
+ * oldest-inserted entry is dropped (FIFO rotation).
+ *
+ * Each entry is created with its own AbortSignal that aborts when the entry
+ * leaves the cache — capacity eviction, an explicit `delete`, the process
+ * signal aborting, or the optional per-entry `signal` (e.g. a TTL handed in
+ * from outside) aborting. That lets the cached value release whatever
+ * resources it holds; once an entry is gone the next lookup recreates it.
+ */
+export declare function createRotatingMap<T>(opts: {
+    limit: number;
+    signal: AbortSignal;
+}): RotatingMap<T>;

package/dist/utils/rotating-map.js

@@ -0,0 +1,53 @@
+import { combineAbortSignal } from './combine-abort-signal.js';
+/**
+ * Fixed-capacity cache. When the entry count exceeds `limit` the
+ * oldest-inserted entry is dropped (FIFO rotation).
+ *
+ * Each entry is created with its own AbortSignal that aborts when the entry
+ * leaves the cache — capacity eviction, an explicit `delete`, the process
+ * signal aborting, or the optional per-entry `signal` (e.g. a TTL handed in
+ * from outside) aborting. That lets the cached value release whatever
+ * resources it holds; once an entry is gone the next lookup recreates it.
+ */
+export function createRotatingMap(opts) {
+    const map = new Map();
+    return {
+        get(key) {
+            return map.get(key)?.value;
+        },
+        delete(key) {
+            // Aborting triggers the lifetime listener, which removes the entry.
+            map.get(key)?.abortController.abort();
+        },
+        getOrCreate(key, create, signal) {
+            const existing = map.get(key);
+            if (existing !== undefined) {
+                return existing.value;
+            }
+            // The entry ends when it is evicted or deleted (abortController), when
+            // the process stops (opts.signal), or when its own signal aborts.
+            const abortController = new AbortController();
+            let lifetime = combineAbortSignal(opts.signal, abortController.signal);
+            if (signal !== undefined) {
+                lifetime = combineAbortSignal(lifetime, signal);
+            }
+            const entry = { value: create(lifetime), abortController };
+            map.set(key, entry);
+            lifetime.addEventListener('abort', () => {
+                if (map.get(key) === entry) {
+                    map.delete(key);
+                }
+            }, { once: true });
+            while (map.size > opts.limit) {
+                const oldest = map.keys().next().value;
+                if (oldest === undefined) {
+                    break;
+                }
+                // Aborts the oldest entry's lifetime, which removes it from the map.
+                map.get(oldest)?.abortController.abort();
+            }
+            return entry.value;
+        },
+    };
+}
+//# sourceMappingURL=rotating-map.js.map

package/dist/utils/rotating-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotating-map.js","sourceRoot":"","sources":["../../src/utils/rotating-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAY/D;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAI,IAGpC;IAKC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAiB,CAAC;IAErC,OAAO;QACL,GAAG,CAAC,GAAW;YACb,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;QAC7B,CAAC;QACD,MAAM,CAAC,GAAW;YAChB,oEAAoE;YACpE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,KAAK,EAAE,CAAC;QACxC,CAAC;QACD,WAAW,CACT,GAAW,EACX,MAAkC,EAClC,MAAoB;YAEpB,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,QAAQ,CAAC,KAAK,CAAC;YACxB,CAAC;YAED,uEAAuE;YACvE,kEAAkE;YAClE,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;YAC9C,IAAI,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;YACvE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,CAAC;YAED,MAAM,KAAK,GAAU,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;YAClE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAEpB,QAAQ,CAAC,gBAAgB,CACvB,OAAO,EACP,GAAG,EAAE;gBACH,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;oBAC3B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAC;YAEF,OAAO,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,MAAM;gBACR,CAAC;gBACD,qEAAqE;gBACrE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,KAAK,EAAE,CAAC;YAC3C,CAAC;YAED,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/rotating-map.test.d.ts

@@ -0,0 +1 @@
+export {};