@aztec/foundation 0.38.0 → 0.40.0

package/dest/collection/index.d.ts

@@ -1,2 +1,3 @@
 export * from './array.js';
+export * from './object.js';
 //# sourceMappingURL=index.d.ts.map

package/dest/collection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collection/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collection/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dest/collection/index.js

@@ -1,2 +1,3 @@
 export * from './array.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29sbGVjdGlvbi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLFlBQVksQ0FBQyJ9
+export * from './object.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29sbGVjdGlvbi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLFlBQVksQ0FBQztBQUMzQixjQUFjLGFBQWEsQ0FBQyJ9

package/dest/collection/object.d.ts

@@ -0,0 +1,4 @@
+/** Returns a new object with the same keys and where each value has been passed through the mapping function. */
+export declare function mapValues<K extends string | number | symbol, T, U>(obj: Record<K, T>, fn: (value: T) => U): Record<K, U>;
+export declare function mapValues<K extends string | number | symbol, T, U>(obj: Partial<Record<K, T>>, fn: (value: T) => U): Partial<Record<K, U>>;
+//# sourceMappingURL=object.d.ts.map

package/dest/collection/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/collection/object.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,EAChE,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACjB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAClB,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAChB,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,EAChE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAC1B,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAClB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC"}

package/dest/collection/object.js

@@ -0,0 +1,8 @@
+export function mapValues(obj, fn) {
+    const result = {};
+    for (const key in obj) {
+        result[key] = fn(obj[key]);
+    }
+    return result;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib2JqZWN0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvbGxlY3Rpb24vb2JqZWN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQVNBLE1BQU0sVUFBVSxTQUFTLENBQ3ZCLEdBQWlCLEVBQ2pCLEVBQW1CO0lBRW5CLE1BQU0sTUFBTSxHQUFpQixFQUFrQixDQUFDO0lBQ2hELEtBQUssTUFBTSxHQUFHLElBQUksR0FBRyxFQUFFLENBQUM7UUFDdEIsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQztJQUM3QixDQUFDO0lBQ0QsT0FBTyxNQUFNLENBQUM7QUFDaEIsQ0FBQyJ9

package/dest/iterable/all.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Collects all values from an (async) iterable and returns them as an array
+ * @param source - Iterable to collect all values from
+ * @returns All of the iterable's values as an array.
+ */
+declare function all<T>(source: Iterable<T>): T[];
+declare function all<T>(source: Iterable<T> | AsyncIterable<T>): Promise<T[]>;
+export { all };
+//# sourceMappingURL=all.d.ts.map

package/dest/iterable/all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"all.d.ts","sourceRoot":"","sources":["../../src/iterable/all.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,iBAAS,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1C,iBAAS,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;AAuBtE,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dest/iterable/all.js

@@ -0,0 +1,19 @@
+import { isAsyncIterable } from './isAsyncIt.js';
+function all(source) {
+    if (isAsyncIterable(source)) {
+        return (async () => {
+            const arr = [];
+            for await (const entry of source) {
+                arr.push(entry);
+            }
+            return arr;
+        })();
+    }
+    const arr = [];
+    for (const entry of source) {
+        arr.push(entry);
+    }
+    return arr;
+}
+export { all };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWxsLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2l0ZXJhYmxlL2FsbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFTakQsU0FBUyxHQUFHLENBQUksTUFBc0M7SUFDcEQsSUFBSSxlQUFlLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztRQUM1QixPQUFPLENBQUMsS0FBSyxJQUFJLEVBQUU7WUFDakIsTUFBTSxHQUFHLEdBQUcsRUFBRSxDQUFDO1lBRWYsSUFBSSxLQUFLLEVBQUUsTUFBTSxLQUFLLElBQUksTUFBTSxFQUFFLENBQUM7Z0JBQ2pDLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDbEIsQ0FBQztZQUVELE9BQU8sR0FBRyxDQUFDO1FBQ2IsQ0FBQyxDQUFDLEVBQUUsQ0FBQztJQUNQLENBQUM7SUFFRCxNQUFNLEdBQUcsR0FBRyxFQUFFLENBQUM7SUFFZixLQUFLLE1BQU0sS0FBSyxJQUFJLE1BQU0sRUFBRSxDQUFDO1FBQzNCLEdBQUcsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDbEIsQ0FBQztJQUVELE9BQU8sR0FBRyxDQUFDO0FBQ2IsQ0FBQztBQUVELE9BQU8sRUFBRSxHQUFHLEVBQUUsQ0FBQyJ9

package/dest/iterable/filter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Filters the passed (async) iterable by using the filter function.
+ * @param source - An iterable to filter.
+ * @returns A generator of the filtered values.
+ */
+declare function filter<T>(source: Iterable<T>, fn: (val: T, index: number) => Promise<boolean>): AsyncGenerator<T, void, undefined>;
+declare function filter<T>(source: Iterable<T>, fn: (val: T, index: number) => boolean): Generator<T, void, undefined>;
+declare function filter<T>(source: Iterable<T> | AsyncIterable<T>, fn: (val: T, index: number) => boolean | Promise<boolean>): AsyncGenerator<T, void, undefined>;
+export { filter };
+//# sourceMappingURL=filter.d.ts.map

package/dest/iterable/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/iterable/filter.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,iBAAS,MAAM,CAAC,CAAC,EACf,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC9C,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACtC,iBAAS,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC/G,iBAAS,MAAM,CAAC,CAAC,EACf,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EACtC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GACxD,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAyDtC,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dest/iterable/filter.js

@@ -0,0 +1,49 @@
+import { peek } from './peek.js';
+function isAsyncIterable(thing) {
+    return thing[Symbol.asyncIterator] != null;
+}
+function filter(source, fn) {
+    let index = 0;
+    if (isAsyncIterable(source)) {
+        return (async function* () {
+            for await (const entry of source) {
+                if (await fn(entry, index++)) {
+                    yield entry;
+                }
+            }
+        })();
+    }
+    // if mapping function returns a promise we have to return an async generator
+    const peekable = peek(source);
+    const { value, done } = peekable.next();
+    if (done === true) {
+        return (function* () { })();
+    }
+    const res = fn(value, index++);
+    // @ts-expect-error .then is not present on O
+    if (typeof res.then === 'function') {
+        return (async function* () {
+            if (await res) {
+                yield value;
+            }
+            for await (const entry of peekable) {
+                if (await fn(entry, index++)) {
+                    yield entry;
+                }
+            }
+        })();
+    }
+    const func = fn;
+    return (function* () {
+        if (res === true) {
+            yield value;
+        }
+        for (const entry of peekable) {
+            if (func(entry, index++)) {
+                yield entry;
+            }
+        }
+    })();
+}
+export { filter };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmlsdGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2l0ZXJhYmxlL2ZpbHRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBRWpDLFNBQVMsZUFBZSxDQUFJLEtBQVU7SUFDcEMsT0FBTyxLQUFLLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxJQUFJLElBQUksQ0FBQztBQUM3QyxDQUFDO0FBZ0JELFNBQVMsTUFBTSxDQUNiLE1BQXNDLEVBQ3RDLEVBQXlEO0lBRXpELElBQUksS0FBSyxHQUFHLENBQUMsQ0FBQztJQUVkLElBQUksZUFBZSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7UUFDNUIsT0FBTyxDQUFDLEtBQUssU0FBUyxDQUFDO1lBQ3JCLElBQUksS0FBSyxFQUFFLE1BQU0sS0FBSyxJQUFJLE1BQU0sRUFBRSxDQUFDO2dCQUNqQyxJQUFJLE1BQU0sRUFBRSxDQUFDLEtBQUssRUFBRSxLQUFLLEVBQUUsQ0FBQyxFQUFFLENBQUM7b0JBQzdCLE1BQU0sS0FBSyxDQUFDO2dCQUNkLENBQUM7WUFDSCxDQUFDO1FBQ0gsQ0FBQyxDQUFDLEVBQUUsQ0FBQztJQUNQLENBQUM7SUFFRCw2RUFBNkU7SUFDN0UsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQzlCLE1BQU0sRUFBRSxLQUFLLEVBQUUsSUFBSSxFQUFFLEdBQUcsUUFBUSxDQUFDLElBQUksRUFBRSxDQUFDO0lBRXhDLElBQUksSUFBSSxLQUFLLElBQUksRUFBRSxDQUFDO1FBQ2xCLE9BQU8sQ0FBQyxRQUFRLENBQUMsTUFBSyxDQUFDLENBQUMsRUFBRSxDQUFDO0lBQzdCLENBQUM7SUFFRCxNQUFNLEdBQUcsR0FBRyxFQUFFLENBQUMsS0FBSyxFQUFFLEtBQUssRUFBRSxDQUFDLENBQUM7SUFFL0IsNkNBQTZDO0lBQzdDLElBQUksT0FBTyxHQUFHLENBQUMsSUFBSSxLQUFLLFVBQVUsRUFBRSxDQUFDO1FBQ25DLE9BQU8sQ0FBQyxLQUFLLFNBQVMsQ0FBQztZQUNyQixJQUFJLE1BQU0sR0FBRyxFQUFFLENBQUM7Z0JBQ2QsTUFBTSxLQUFLLENBQUM7WUFDZCxDQUFDO1lBRUQsSUFBSSxLQUFLLEVBQUUsTUFBTSxLQUFLLElBQUksUUFBUSxFQUFFLENBQUM7Z0JBQ25DLElBQUksTUFBTSxFQUFFLENBQUMsS0FBSyxFQUFFLEtBQUssRUFBRSxDQUFDLEVBQUUsQ0FBQztvQkFDN0IsTUFBTSxLQUFLLENBQUM7Z0JBQ2QsQ0FBQztZQUNILENBQUM7UUFDSCxDQUFDLENBQUMsRUFBRSxDQUFDO0lBQ1AsQ0FBQztJQUVELE1BQU0sSUFBSSxHQUFHLEVBQXdDLENBQUM7SUFFdEQsT0FBTyxDQUFDLFFBQVEsQ0FBQztRQUNmLElBQUksR0FBRyxLQUFLLElBQUksRUFBRSxDQUFDO1lBQ2pCLE1BQU0sS0FBSyxDQUFDO1FBQ2QsQ0FBQztRQUVELEtBQUssTUFBTSxLQUFLLElBQUksUUFBUSxFQUFFLENBQUM7WUFDN0IsSUFBSSxJQUFJLENBQUMsS0FBSyxFQUFFLEtBQUssRUFBRSxDQUFDLEVBQUUsQ0FBQztnQkFDekIsTUFBTSxLQUFLLENBQUM7WUFDZCxDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUMsQ0FBQyxFQUFFLENBQUM7QUFDUCxDQUFDO0FBRUQsT0FBTyxFQUFFLE1BQU0sRUFBRSxDQUFDIn0=

package/dest/iterable/index.d.ts

@@ -0,0 +1,7 @@
+export * from './map.js';
+export * from './filter.js';
+export * from './sort.js';
+export * from './take.js';
+export * from './all.js';
+export * from './peek.js';
+//# sourceMappingURL=index.d.ts.map

package/dest/iterable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/iterable/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dest/iterable/index.js

@@ -0,0 +1,7 @@
+export * from './map.js';
+export * from './filter.js';
+export * from './sort.js';
+export * from './take.js';
+export * from './all.js';
+export * from './peek.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaXRlcmFibGUvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxVQUFVLENBQUM7QUFDekIsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxXQUFXLENBQUM7QUFDMUIsY0FBYyxXQUFXLENBQUM7QUFDMUIsY0FBYyxVQUFVLENBQUM7QUFDekIsY0FBYyxXQUFXLENBQUMifQ==

package/dest/iterable/isAsyncIt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility function to type check an AsyncIterable
+ * @param thing - Input to type check
+ * @returns Type-checked input
+ */
+export declare function isAsyncIterable<T>(thing: any): thing is AsyncIterable<T>;
+//# sourceMappingURL=isAsyncIt.d.ts.map

package/dest/iterable/isAsyncIt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isAsyncIt.d.ts","sourceRoot":"","sources":["../../src/iterable/isAsyncIt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC,CAExE"}

package/dest/iterable/isAsyncIt.js

@@ -0,0 +1,9 @@
+/**
+ * Utility function to type check an AsyncIterable
+ * @param thing - Input to type check
+ * @returns Type-checked input
+ */
+export function isAsyncIterable(thing) {
+    return thing[Symbol.asyncIterator] != null;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaXNBc3luY0l0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2l0ZXJhYmxlL2lzQXN5bmNJdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLGVBQWUsQ0FBSSxLQUFVO0lBQzNDLE9BQU8sS0FBSyxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsSUFBSSxJQUFJLENBQUM7QUFDN0MsQ0FBQyJ9

package/dest/iterable/map.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Takes an (async) iterable and returns one with each item mapped by the passed
+ * function.
+ * @param source - The iterable to run the map function on.
+ * @param func - The function to run over the iterable's items.
+ * @returns A generator of the mapped items.
+ */
+declare function map<I, O>(source: Iterable<I>, func: (val: I, index: number) => Promise<O>): AsyncGenerator<O, void, undefined>;
+declare function map<I, O>(source: Iterable<I>, func: (val: I, index: number) => O): Generator<O, void, undefined>;
+declare function map<I, O>(source: AsyncIterable<I> | Iterable<I>, func: (val: I, index: number) => O | Promise<O>): AsyncGenerator<O, void, undefined>;
+export { map };
+//# sourceMappingURL=map.d.ts.map

package/dest/iterable/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/iterable/map.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,iBAAS,GAAG,CAAC,CAAC,EAAE,CAAC,EACf,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1C,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACtC,iBAAS,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC3G,iBAAS,GAAG,CAAC,CAAC,EAAE,CAAC,EACf,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EACtC,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC9C,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AA+CtC,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dest/iterable/map.js

@@ -0,0 +1,37 @@
+import { isAsyncIterable } from './isAsyncIt.js';
+import { peek } from './peek.js';
+function map(source, func) {
+    let index = 0;
+    if (isAsyncIterable(source)) {
+        return (async function* () {
+            for await (const val of source) {
+                yield func(val, index++);
+            }
+        })();
+    }
+    // if mapping function returns a promise we have to return an async generator
+    const peekable = peek(source);
+    const { value, done } = peekable.next();
+    if (done === true) {
+        return (function* () { })();
+    }
+    const res = func(value, index++);
+    // @ts-expect-error .then is not present on O
+    if (typeof res.then === 'function') {
+        return (async function* () {
+            yield await res;
+            for await (const val of peekable) {
+                yield func(val, index++);
+            }
+        })();
+    }
+    const fn = func;
+    return (function* () {
+        yield res;
+        for (const val of peekable) {
+            yield fn(val, index++);
+        }
+    })();
+}
+export { map };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWFwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2l0ZXJhYmxlL21hcC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFDakQsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLFdBQVcsQ0FBQztBQWtCakMsU0FBUyxHQUFHLENBQ1YsTUFBc0MsRUFDdEMsSUFBK0M7SUFFL0MsSUFBSSxLQUFLLEdBQUcsQ0FBQyxDQUFDO0lBRWQsSUFBSSxlQUFlLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztRQUM1QixPQUFPLENBQUMsS0FBSyxTQUFTLENBQUM7WUFDckIsSUFBSSxLQUFLLEVBQUUsTUFBTSxHQUFHLElBQUksTUFBTSxFQUFFLENBQUM7Z0JBQy9CLE1BQU0sSUFBSSxDQUFDLEdBQUcsRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO1lBQzNCLENBQUM7UUFDSCxDQUFDLENBQUMsRUFBRSxDQUFDO0lBQ1AsQ0FBQztJQUVELDZFQUE2RTtJQUM3RSxNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDOUIsTUFBTSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsR0FBRyxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7SUFFeEMsSUFBSSxJQUFJLEtBQUssSUFBSSxFQUFFLENBQUM7UUFDbEIsT0FBTyxDQUFDLFFBQVEsQ0FBQyxNQUFLLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFDN0IsQ0FBQztJQUVELE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxLQUFLLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQztJQUVqQyw2Q0FBNkM7SUFDN0MsSUFBSSxPQUFPLEdBQUcsQ0FBQyxJQUFJLEtBQUssVUFBVSxFQUFFLENBQUM7UUFDbkMsT0FBTyxDQUFDLEtBQUssU0FBUyxDQUFDO1lBQ3JCLE1BQU0sTUFBTSxHQUFHLENBQUM7WUFFaEIsSUFBSSxLQUFLLEVBQUUsTUFBTSxHQUFHLElBQUksUUFBUSxFQUFFLENBQUM7Z0JBQ2pDLE1BQU0sSUFBSSxDQUFDLEdBQUcsRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO1lBQzNCLENBQUM7UUFDSCxDQUFDLENBQUMsRUFBRSxDQUFDO0lBQ1AsQ0FBQztJQUVELE1BQU0sRUFBRSxHQUFHLElBQW9DLENBQUM7SUFFaEQsT0FBTyxDQUFDLFFBQVEsQ0FBQztRQUNmLE1BQU0sR0FBUSxDQUFDO1FBRWYsS0FBSyxNQUFNLEdBQUcsSUFBSSxRQUFRLEVBQUUsQ0FBQztZQUMzQixNQUFNLEVBQUUsQ0FBQyxHQUFHLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQztRQUN6QixDQUFDO0lBQ0gsQ0FBQyxDQUFDLEVBQUUsQ0FBQztBQUNQLENBQUM7QUFFRCxPQUFPLEVBQUUsR0FBRyxFQUFFLENBQUMifQ==

package/dest/iterable/peek.d.ts

@@ -0,0 +1,19 @@
+export interface Peek<T> {
+    peek(): IteratorResult<T, undefined>;
+}
+export interface AsyncPeek<T> {
+    peek(): Promise<IteratorResult<T, undefined>>;
+}
+export interface Push<T> {
+    push(value: T): void;
+}
+export type Peekable<T> = Iterable<T> & Peek<T> & Push<T> & Iterator<T>;
+export type AsyncPeekable<T> = AsyncIterable<T> & AsyncPeek<T> & Push<T> & AsyncIterator<T>;
+/**
+ * Utility function that allows peeking into the contents of an async iterator.
+ * @param iterable - The async iterator to peek the values of.
+ */
+declare function peekable<T>(iterable: Iterable<T>): Peekable<T>;
+declare function peekable<T>(iterable: AsyncIterable<T>): AsyncPeekable<T>;
+export { peekable as peek };
+//# sourceMappingURL=peek.d.ts.map

package/dest/iterable/peek.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peek.d.ts","sourceRoot":"","sources":["../../src/iterable/peek.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,IAAI,IAAI,cAAc,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAExE,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAE5F;;;GAGG;AACH,iBAAS,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AACzD,iBAAS,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAoCnE,OAAO,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC"}

package/dest/iterable/peek.js

@@ -0,0 +1,33 @@
+function peekable(iterable) {
+    const [iterator, symbol] = 
+    // @ts-expect-error can't use Symbol.asyncIterator to index iterable since it might be Iterable
+    iterable[Symbol.asyncIterator] != null
+        ? // @ts-expect-error can't use Symbol.asyncIterator to index iterable since it might be Iterable
+            [iterable[Symbol.asyncIterator](), Symbol.asyncIterator]
+        : // @ts-expect-error can't use Symbol.iterator to index iterable since it might be AsyncIterable
+            [iterable[Symbol.iterator](), Symbol.iterator];
+    const queue = [];
+    // @ts-expect-error can't use symbol to index peekable
+    return {
+        peek: () => {
+            return iterator.next();
+        },
+        push: (value) => {
+            queue.push(value);
+        },
+        next: () => {
+            if (queue.length > 0) {
+                return {
+                    done: false,
+                    value: queue.shift(),
+                };
+            }
+            return iterator.next();
+        },
+        [symbol]() {
+            return this;
+        },
+    };
+}
+export { peekable as peek };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGVlay5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9pdGVyYWJsZS9wZWVrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQXNCQSxTQUFTLFFBQVEsQ0FBSSxRQUF3QztJQUMzRCxNQUFNLENBQUMsUUFBUSxFQUFFLE1BQU0sQ0FBQztJQUN0QiwrRkFBK0Y7SUFDL0YsUUFBUSxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsSUFBSSxJQUFJO1FBQ3BDLENBQUMsQ0FBQywrRkFBK0Y7WUFDL0YsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxFQUFFLEVBQUUsTUFBTSxDQUFDLGFBQWEsQ0FBQztRQUMxRCxDQUFDLENBQUMsK0ZBQStGO1lBQy9GLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsRUFBRSxFQUFFLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUVyRCxNQUFNLEtBQUssR0FBVSxFQUFFLENBQUM7SUFFeEIsc0RBQXNEO0lBQ3RELE9BQU87UUFDTCxJQUFJLEVBQUUsR0FBRyxFQUFFO1lBQ1QsT0FBTyxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDekIsQ0FBQztRQUNELElBQUksRUFBRSxDQUFDLEtBQVUsRUFBRSxFQUFFO1lBQ25CLEtBQUssQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDcEIsQ0FBQztRQUNELElBQUksRUFBRSxHQUFHLEVBQUU7WUFDVCxJQUFJLEtBQUssQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUM7Z0JBQ3JCLE9BQU87b0JBQ0wsSUFBSSxFQUFFLEtBQUs7b0JBQ1gsS0FBSyxFQUFFLEtBQUssQ0FBQyxLQUFLLEVBQUU7aUJBQ3JCLENBQUM7WUFDSixDQUFDO1lBRUQsT0FBTyxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDekIsQ0FBQztRQUNELENBQUMsTUFBTSxDQUFDO1lBQ04sT0FBTyxJQUFJLENBQUM7UUFDZCxDQUFDO0tBQ0YsQ0FBQztBQUNKLENBQUM7QUFFRCxPQUFPLEVBQUUsUUFBUSxJQUFJLElBQUksRUFBRSxDQUFDIn0=

package/dest/iterable/sort.d.ts

@@ -0,0 +1,14 @@
+export interface CompareFunction<T> {
+    (a: T, b: T): number;
+}
+/**
+ * Collects all values from an async iterator, sorts them
+ * using the passed function and yields them.
+ * @param source - Iterable to sort.
+ * @param sorter - Sorting function.
+ * @returns A generator of the sorted values.
+ */
+declare function sort<T>(source: Iterable<T>, sorter: CompareFunction<T>): Generator<T, void, undefined>;
+declare function sort<T>(source: Iterable<T> | AsyncIterable<T>, sorter: CompareFunction<T>): AsyncGenerator<T, void, undefined>;
+export { sort };
+//# sourceMappingURL=sort.d.ts.map

package/dest/iterable/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../../src/iterable/sort.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,iBAAS,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACjG,iBAAS,IAAI,CAAC,CAAC,EACb,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EACtC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAoBtC,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dest/iterable/sort.js

@@ -0,0 +1,16 @@
+import { all } from './all.js';
+import { isAsyncIterable } from './isAsyncIt.js';
+function sort(source, sorter) {
+    if (isAsyncIterable(source)) {
+        return (async function* () {
+            const arr = await all(source);
+            yield* arr.sort(sorter);
+        })();
+    }
+    return (function* () {
+        const arr = all(source);
+        yield* arr.sort(sorter);
+    })();
+}
+export { sort };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic29ydC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9pdGVyYWJsZS9zb3J0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxHQUFHLEVBQUUsTUFBTSxVQUFVLENBQUM7QUFDL0IsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBa0JqRCxTQUFTLElBQUksQ0FDWCxNQUFzQyxFQUN0QyxNQUEwQjtJQUUxQixJQUFJLGVBQWUsQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO1FBQzVCLE9BQU8sQ0FBQyxLQUFLLFNBQVMsQ0FBQztZQUNyQixNQUFNLEdBQUcsR0FBRyxNQUFNLEdBQUcsQ0FBQyxNQUFNLENBQUMsQ0FBQztZQUU5QixLQUFLLENBQUMsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO1FBQzFCLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFDUCxDQUFDO0lBRUQsT0FBTyxDQUFDLFFBQVEsQ0FBQztRQUNmLE1BQU0sR0FBRyxHQUFHLEdBQUcsQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUV4QixLQUFLLENBQUMsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQzFCLENBQUMsQ0FBQyxFQUFFLENBQUM7QUFDUCxDQUFDO0FBRUQsT0FBTyxFQUFFLElBQUksRUFBRSxDQUFDIn0=

package/dest/iterable/take.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Stop iteration after n items have been received.
+ * @param source - An iterable to take n items from.
+ * @param limit - The number of items to take from the iterable.
+ * @returns A generator, limited to n items.
+ */
+declare function take<T>(source: Iterable<T>, limit: number): Generator<T, void, undefined>;
+declare function take<T>(source: Iterable<T> | AsyncIterable<T>, limit: number): AsyncGenerator<T, void, undefined>;
+export { take };
+//# sourceMappingURL=take.d.ts.map

package/dest/iterable/take.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"take.d.ts","sourceRoot":"","sources":["../../src/iterable/take.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,iBAAS,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACpF,iBAAS,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AA4C5G,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dest/iterable/take.js

@@ -0,0 +1,33 @@
+import { isAsyncIterable } from './isAsyncIt.js';
+function take(source, limit) {
+    if (isAsyncIterable(source)) {
+        return (async function* () {
+            let items = 0;
+            if (limit < 1) {
+                return;
+            }
+            for await (const entry of source) {
+                yield entry;
+                items++;
+                if (items === limit) {
+                    return;
+                }
+            }
+        })();
+    }
+    return (function* () {
+        let items = 0;
+        if (limit < 1) {
+            return;
+        }
+        for (const entry of source) {
+            yield entry;
+            items++;
+            if (items === limit) {
+                return;
+            }
+        }
+    })();
+}
+export { take };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFrZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9pdGVyYWJsZS90YWtlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQVVqRCxTQUFTLElBQUksQ0FDWCxNQUFzQyxFQUN0QyxLQUFhO0lBRWIsSUFBSSxlQUFlLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztRQUM1QixPQUFPLENBQUMsS0FBSyxTQUFTLENBQUM7WUFDckIsSUFBSSxLQUFLLEdBQUcsQ0FBQyxDQUFDO1lBRWQsSUFBSSxLQUFLLEdBQUcsQ0FBQyxFQUFFLENBQUM7Z0JBQ2QsT0FBTztZQUNULENBQUM7WUFFRCxJQUFJLEtBQUssRUFBRSxNQUFNLEtBQUssSUFBSSxNQUFNLEVBQUUsQ0FBQztnQkFDakMsTUFBTSxLQUFLLENBQUM7Z0JBRVosS0FBSyxFQUFFLENBQUM7Z0JBRVIsSUFBSSxLQUFLLEtBQUssS0FBSyxFQUFFLENBQUM7b0JBQ3BCLE9BQU87Z0JBQ1QsQ0FBQztZQUNILENBQUM7UUFDSCxDQUFDLENBQUMsRUFBRSxDQUFDO0lBQ1AsQ0FBQztJQUVELE9BQU8sQ0FBQyxRQUFRLENBQUM7UUFDZixJQUFJLEtBQUssR0FBRyxDQUFDLENBQUM7UUFFZCxJQUFJLEtBQUssR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUNkLE9BQU87UUFDVCxDQUFDO1FBRUQsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLEVBQUUsQ0FBQztZQUMzQixNQUFNLEtBQUssQ0FBQztZQUVaLEtBQUssRUFBRSxDQUFDO1lBRVIsSUFBSSxLQUFLLEtBQUssS0FBSyxFQUFFLENBQUM7Z0JBQ3BCLE9BQU87WUFDVCxDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUMsQ0FBQyxFQUFFLENBQUM7QUFDUCxDQUFDO0FBRUQsT0FBTyxFQUFFLElBQUksRUFBRSxDQUFDIn0=

package/dest/log/debug.d.ts

@@ -40,4 +40,17 @@ export declare function enableLogs(str: string): void;
  * @returns A boolean indicating whether logging is enabled for the given namespace.
  */
 export declare function isLogEnabled(str: string): boolean;
+/**
+ * Format a debug string filling in `'{0}'` entries with their
+ * corresponding values from the args array, amd `'{}'` with the whole array.
+ *
+ * @param formatStr - str of form `'this is a string with some entries like {0} and {1}'`
+ * @param args - array of fields to fill in the string format entries with
+ * @returns formatted string
+ */
+interface Printable {
+    toString(): string;
+}
+export declare function applyStringFormatting(formatStr: string, args: Printable[]): string;
+export {};
 //# sourceMappingURL=debug.d.ts.map

package/dest/log/debug.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/log/debug.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAyBzC;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAGzD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,QAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,QAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,QAErC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,WAEvC"}
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/log/debug.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAyBzC;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAGzD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,QAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,QAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,QAErC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,WAEvC;AAED;;;;;;;GAOG;AACH,UAAU,SAAS;IACjB,QAAQ,IAAI,MAAM,CAAC;CACpB;AACD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAQlF"}

package/dest/log/debug.js

@@ -72,4 +72,13 @@ export function enableLogs(str) {
 export function isLogEnabled(str) {
     return debug.enabled(str);
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVidWcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9nL2RlYnVnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxNQUFNLE9BQU8sQ0FBQztBQUkxQixJQUFJLFVBQWtELENBQUM7QUFDdkQsSUFBSSxXQUFtRCxDQUFDO0FBRXhEOzs7Ozs7R0FNRztBQUNILFNBQVMsa0NBQWtDLENBQUMsTUFBVyxFQUFFLEdBQUcsSUFBVztJQUNyRSxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsU0FBUyxDQUFDLEVBQUUsQ0FBQztRQUNyQyxPQUFPO0lBQ1QsQ0FBQztJQUNELElBQUksVUFBVSxFQUFFLENBQUM7UUFDZixVQUFVLENBQUMsTUFBTSxDQUFDLFNBQVMsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQ3hDLENBQUM7SUFDRCxNQUFNLENBQUMsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUNoQixJQUFJLFdBQVcsRUFBRSxDQUFDO1FBQ2hCLFdBQVcsQ0FBQyxNQUFNLENBQUMsU0FBUyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDekMsQ0FBQztBQUNILENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQixDQUFDLElBQVk7SUFDaEQsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzNCLE9BQU8sQ0FBQyxHQUFHLElBQVcsRUFBRSxFQUFFLENBQUMsa0NBQWtDLENBQUMsTUFBTSxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7QUFDakYsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLFVBQVUsa0JBQWtCLENBQUMsRUFBNEI7SUFDN0QsVUFBVSxHQUFHLEVBQUUsQ0FBQztBQUNsQixDQUFDO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsTUFBTSxVQUFVLG1CQUFtQixDQUFDLEVBQTRCO0lBQzlELFdBQVcsR0FBRyxFQUFFLENBQUM7QUFDbkIsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLFVBQVUsVUFBVSxDQUFDLEdBQVc7SUFDcEMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUNwQixDQUFDO0FBRUQ7Ozs7Ozs7R0FPRztBQUNILE1BQU0sVUFBVSxZQUFZLENBQUMsR0FBVztJQUN0QyxPQUFPLEtBQUssQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUM7QUFDNUIsQ0FBQyJ9
+export function applyStringFormatting(formatStr, args) {
+    return formatStr
+        .replace(/{(\d+)}/g, (match, index) => {
+        return typeof args[index] === 'undefined' ? match : args[index].toString();
+    })
+        .replace(/{}/g, (_match, _index) => {
+        return args.toString();
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVidWcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbG9nL2RlYnVnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxNQUFNLE9BQU8sQ0FBQztBQUkxQixJQUFJLFVBQWtELENBQUM7QUFDdkQsSUFBSSxXQUFtRCxDQUFDO0FBRXhEOzs7Ozs7R0FNRztBQUNILFNBQVMsa0NBQWtDLENBQUMsTUFBVyxFQUFFLEdBQUcsSUFBVztJQUNyRSxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsU0FBUyxDQUFDLEVBQUUsQ0FBQztRQUNyQyxPQUFPO0lBQ1QsQ0FBQztJQUNELElBQUksVUFBVSxFQUFFLENBQUM7UUFDZixVQUFVLENBQUMsTUFBTSxDQUFDLFNBQVMsRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQ3hDLENBQUM7SUFDRCxNQUFNLENBQUMsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUNoQixJQUFJLFdBQVcsRUFBRSxDQUFDO1FBQ2hCLFdBQVcsQ0FBQyxNQUFNLENBQUMsU0FBUyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDekMsQ0FBQztBQUNILENBQUM7QUFFRDs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQixDQUFDLElBQVk7SUFDaEQsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzNCLE9BQU8sQ0FBQyxHQUFHLElBQVcsRUFBRSxFQUFFLENBQUMsa0NBQWtDLENBQUMsTUFBTSxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7QUFDakYsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLFVBQVUsa0JBQWtCLENBQUMsRUFBNEI7SUFDN0QsVUFBVSxHQUFHLEVBQUUsQ0FBQztBQUNsQixDQUFDO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsTUFBTSxVQUFVLG1CQUFtQixDQUFDLEVBQTRCO0lBQzlELFdBQVcsR0FBRyxFQUFFLENBQUM7QUFDbkIsQ0FBQztBQUVEOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLFVBQVUsVUFBVSxDQUFDLEdBQVc7SUFDcEMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUNwQixDQUFDO0FBRUQ7Ozs7Ozs7R0FPRztBQUNILE1BQU0sVUFBVSxZQUFZLENBQUMsR0FBVztJQUN0QyxPQUFPLEtBQUssQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUM7QUFDNUIsQ0FBQztBQWFELE1BQU0sVUFBVSxxQkFBcUIsQ0FBQyxTQUFpQixFQUFFLElBQWlCO0lBQ3hFLE9BQU8sU0FBUztTQUNiLE9BQU8sQ0FBQyxVQUFVLEVBQUUsQ0FBQyxLQUFLLEVBQUUsS0FBSyxFQUFFLEVBQUU7UUFDcEMsT0FBTyxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsS0FBSyxXQUFXLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDLFFBQVEsRUFBRSxDQUFDO0lBQzdFLENBQUMsQ0FBQztTQUNELE9BQU8sQ0FBQyxLQUFLLEVBQUUsQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLEVBQUU7UUFDakMsT0FBTyxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7SUFDekIsQ0FBQyxDQUFDLENBQUM7QUFDUCxDQUFDIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/foundation",
-  "version": "0.38.0",
+  "version": "0.40.0",
   "packageManager": "yarn@3.4.1",
   "type": "module",
   "main": "./dest/index.js",
@@ -20,6 +20,7 @@
     "./json-rpc": "./dest/json-rpc/index.js",
     "./json-rpc/server": "./dest/json-rpc/server/index.js",
     "./json-rpc/client": "./dest/json-rpc/client/index.js",
+    "./iterable": "./dest/iterable/index.js",
     "./log": "./dest/log/index.js",
     "./mutex": "./dest/mutex/index.js",
     "./fields": "./dest/fields/index.js",
@@ -78,7 +79,7 @@
     ]
   },
   "dependencies": {
-    "@aztec/bb.js": "0.38.0",
+    "@aztec/bb.js": "0.40.0",
     "@koa/cors": "^5.0.0",
     "@noble/curves": "^1.2.0",
     "bn.js": "^5.2.1",

package/src/collection/index.ts

@@ -1 +1,2 @@
 export * from './array.js';
+export * from './object.js';

package/src/collection/object.ts

@@ -0,0 +1,19 @@
+/** Returns a new object with the same keys and where each value has been passed through the mapping function. */
+export function mapValues<K extends string | number | symbol, T, U>(
+  obj: Record<K, T>,
+  fn: (value: T) => U,
+): Record<K, U>;
+export function mapValues<K extends string | number | symbol, T, U>(
+  obj: Partial<Record<K, T>>,
+  fn: (value: T) => U,
+): Partial<Record<K, U>>;
+export function mapValues<K extends string | number | symbol, T, U>(
+  obj: Record<K, T>,
+  fn: (value: T) => U,
+): Record<K, U> {
+  const result: Record<K, U> = {} as Record<K, U>;
+  for (const key in obj) {
+    result[key] = fn(obj[key]);
+  }
+  return result;
+}

package/src/iterable/all.ts

@@ -0,0 +1,32 @@
+import { isAsyncIterable } from './isAsyncIt.js';
+
+/**
+ * Collects all values from an (async) iterable and returns them as an array
+ * @param source - Iterable to collect all values from
+ * @returns All of the iterable's values as an array.
+ */
+function all<T>(source: Iterable<T>): T[];
+function all<T>(source: Iterable<T> | AsyncIterable<T>): Promise<T[]>;
+function all<T>(source: Iterable<T> | AsyncIterable<T>): Promise<T[]> | T[] {
+  if (isAsyncIterable(source)) {
+    return (async () => {
+      const arr = [];
+
+      for await (const entry of source) {
+        arr.push(entry);
+      }
+
+      return arr;
+    })();
+  }
+
+  const arr = [];
+
+  for (const entry of source) {
+    arr.push(entry);
+  }
+
+  return arr;
+}
+
+export { all };

package/src/iterable/filter.ts

@@ -0,0 +1,77 @@
+import { peek } from './peek.js';
+
+function isAsyncIterable<T>(thing: any): thing is AsyncIterable<T> {
+  return thing[Symbol.asyncIterator] != null;
+}
+
+/**
+ * Filters the passed (async) iterable by using the filter function.
+ * @param source - An iterable to filter.
+ * @returns A generator of the filtered values.
+ */
+function filter<T>(
+  source: Iterable<T>,
+  fn: (val: T, index: number) => Promise<boolean>,
+): AsyncGenerator<T, void, undefined>;
+function filter<T>(source: Iterable<T>, fn: (val: T, index: number) => boolean): Generator<T, void, undefined>;
+function filter<T>(
+  source: Iterable<T> | AsyncIterable<T>,
+  fn: (val: T, index: number) => boolean | Promise<boolean>,
+): AsyncGenerator<T, void, undefined>;
+function filter<T>(
+  source: Iterable<T> | AsyncIterable<T>,
+  fn: (val: T, index: number) => boolean | Promise<boolean>,
+): Generator<T, void, undefined> | AsyncGenerator<T, void, undefined> {
+  let index = 0;
+
+  if (isAsyncIterable(source)) {
+    return (async function* () {
+      for await (const entry of source) {
+        if (await fn(entry, index++)) {
+          yield entry;
+        }
+      }
+    })();
+  }
+
+  // if mapping function returns a promise we have to return an async generator
+  const peekable = peek(source);
+  const { value, done } = peekable.next();
+
+  if (done === true) {
+    return (function* () {})();
+  }
+
+  const res = fn(value, index++);
+
+  // @ts-expect-error .then is not present on O
+  if (typeof res.then === 'function') {
+    return (async function* () {
+      if (await res) {
+        yield value;
+      }
+
+      for await (const entry of peekable) {
+        if (await fn(entry, index++)) {
+          yield entry;
+        }
+      }
+    })();
+  }
+
+  const func = fn as (val: T, index: number) => boolean;
+
+  return (function* () {
+    if (res === true) {
+      yield value;
+    }
+
+    for (const entry of peekable) {
+      if (func(entry, index++)) {
+        yield entry;
+      }
+    }
+  })();
+}
+
+export { filter };

package/src/iterable/index.ts

@@ -0,0 +1,6 @@
+export * from './map.js';
+export * from './filter.js';
+export * from './sort.js';
+export * from './take.js';
+export * from './all.js';
+export * from './peek.js';

package/src/iterable/isAsyncIt.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility function to type check an AsyncIterable
+ * @param thing - Input to type check
+ * @returns Type-checked input
+ */
+export function isAsyncIterable<T>(thing: any): thing is AsyncIterable<T> {
+  return thing[Symbol.asyncIterator] != null;
+}

package/src/iterable/map.ts

@@ -0,0 +1,66 @@
+import { isAsyncIterable } from './isAsyncIt.js';
+import { peek } from './peek.js';
+
+/**
+ * Takes an (async) iterable and returns one with each item mapped by the passed
+ * function.
+ * @param source - The iterable to run the map function on.
+ * @param func - The function to run over the iterable's items.
+ * @returns A generator of the mapped items.
+ */
+function map<I, O>(
+  source: Iterable<I>,
+  func: (val: I, index: number) => Promise<O>,
+): AsyncGenerator<O, void, undefined>;
+function map<I, O>(source: Iterable<I>, func: (val: I, index: number) => O): Generator<O, void, undefined>;
+function map<I, O>(
+  source: AsyncIterable<I> | Iterable<I>,
+  func: (val: I, index: number) => O | Promise<O>,
+): AsyncGenerator<O, void, undefined>;
+function map<I, O>(
+  source: AsyncIterable<I> | Iterable<I>,
+  func: (val: I, index: number) => O | Promise<O>,
+): AsyncGenerator<O, void, undefined> | Generator<O, void, undefined> {
+  let index = 0;
+
+  if (isAsyncIterable(source)) {
+    return (async function* () {
+      for await (const val of source) {
+        yield func(val, index++);
+      }
+    })();
+  }
+
+  // if mapping function returns a promise we have to return an async generator
+  const peekable = peek(source);
+  const { value, done } = peekable.next();
+
+  if (done === true) {
+    return (function* () {})();
+  }
+
+  const res = func(value, index++);
+
+  // @ts-expect-error .then is not present on O
+  if (typeof res.then === 'function') {
+    return (async function* () {
+      yield await res;
+
+      for await (const val of peekable) {
+        yield func(val, index++);
+      }
+    })();
+  }
+
+  const fn = func as (val: I, index: number) => O;
+
+  return (function* () {
+    yield res as O;
+
+    for (const val of peekable) {
+      yield fn(val, index++);
+    }
+  })();
+}
+
+export { map };

package/src/iterable/peek.ts

@@ -0,0 +1,58 @@
+export interface Peek<T> {
+  peek(): IteratorResult<T, undefined>;
+}
+
+export interface AsyncPeek<T> {
+  peek(): Promise<IteratorResult<T, undefined>>;
+}
+
+export interface Push<T> {
+  push(value: T): void;
+}
+
+export type Peekable<T> = Iterable<T> & Peek<T> & Push<T> & Iterator<T>;
+
+export type AsyncPeekable<T> = AsyncIterable<T> & AsyncPeek<T> & Push<T> & AsyncIterator<T>;
+
+/**
+ * Utility function that allows peeking into the contents of an async iterator.
+ * @param iterable - The async iterator to peek the values of.
+ */
+function peekable<T>(iterable: Iterable<T>): Peekable<T>;
+function peekable<T>(iterable: AsyncIterable<T>): AsyncPeekable<T>;
+function peekable<T>(iterable: Iterable<T> | AsyncIterable<T>): Peekable<T> | AsyncPeekable<T> {
+  const [iterator, symbol] =
+    // @ts-expect-error can't use Symbol.asyncIterator to index iterable since it might be Iterable
+    iterable[Symbol.asyncIterator] != null
+      ? // @ts-expect-error can't use Symbol.asyncIterator to index iterable since it might be Iterable
+        [iterable[Symbol.asyncIterator](), Symbol.asyncIterator]
+      : // @ts-expect-error can't use Symbol.iterator to index iterable since it might be AsyncIterable
+        [iterable[Symbol.iterator](), Symbol.iterator];
+
+  const queue: any[] = [];
+
+  // @ts-expect-error can't use symbol to index peekable
+  return {
+    peek: () => {
+      return iterator.next();
+    },
+    push: (value: any) => {
+      queue.push(value);
+    },
+    next: () => {
+      if (queue.length > 0) {
+        return {
+          done: false,
+          value: queue.shift(),
+        };
+      }
+
+      return iterator.next();
+    },
+    [symbol]() {
+      return this;
+    },
+  };
+}
+
+export { peekable as peek };

package/src/iterable/sort.ts

@@ -0,0 +1,39 @@
+import { all } from './all.js';
+import { isAsyncIterable } from './isAsyncIt.js';
+
+export interface CompareFunction<T> {
+  (a: T, b: T): number;
+}
+
+/**
+ * Collects all values from an async iterator, sorts them
+ * using the passed function and yields them.
+ * @param source - Iterable to sort.
+ * @param sorter - Sorting function.
+ * @returns A generator of the sorted values.
+ */
+function sort<T>(source: Iterable<T>, sorter: CompareFunction<T>): Generator<T, void, undefined>;
+function sort<T>(
+  source: Iterable<T> | AsyncIterable<T>,
+  sorter: CompareFunction<T>,
+): AsyncGenerator<T, void, undefined>;
+function sort<T>(
+  source: Iterable<T> | AsyncIterable<T>,
+  sorter: CompareFunction<T>,
+): AsyncGenerator<T, void, undefined> | Generator<T, void, undefined> {
+  if (isAsyncIterable(source)) {
+    return (async function* () {
+      const arr = await all(source);
+
+      yield* arr.sort(sorter);
+    })();
+  }
+
+  return (function* () {
+    const arr = all(source);
+
+    yield* arr.sort(sorter);
+  })();
+}
+
+export { sort };

package/src/iterable/take.ts

@@ -0,0 +1,54 @@
+import { isAsyncIterable } from './isAsyncIt.js';
+
+/**
+ * Stop iteration after n items have been received.
+ * @param source - An iterable to take n items from.
+ * @param limit - The number of items to take from the iterable.
+ * @returns A generator, limited to n items.
+ */
+function take<T>(source: Iterable<T>, limit: number): Generator<T, void, undefined>;
+function take<T>(source: Iterable<T> | AsyncIterable<T>, limit: number): AsyncGenerator<T, void, undefined>;
+function take<T>(
+  source: Iterable<T> | AsyncIterable<T>,
+  limit: number,
+): AsyncGenerator<T, void, undefined> | Generator<T, void, undefined> {
+  if (isAsyncIterable(source)) {
+    return (async function* () {
+      let items = 0;
+
+      if (limit < 1) {
+        return;
+      }
+
+      for await (const entry of source) {
+        yield entry;
+
+        items++;
+
+        if (items === limit) {
+          return;
+        }
+      }
+    })();
+  }
+
+  return (function* () {
+    let items = 0;
+
+    if (limit < 1) {
+      return;
+    }
+
+    for (const entry of source) {
+      yield entry;
+
+      items++;
+
+      if (items === limit) {
+        return;
+      }
+    }
+  })();
+}
+
+export { take };

package/src/log/debug.ts

@@ -81,3 +81,24 @@ export function enableLogs(str: string) {
 export function isLogEnabled(str: string) {
   return debug.enabled(str);
 }
+
+/**
+ * Format a debug string filling in `'{0}'` entries with their
+ * corresponding values from the args array, amd `'{}'` with the whole array.
+ *
+ * @param formatStr - str of form `'this is a string with some entries like {0} and {1}'`
+ * @param args - array of fields to fill in the string format entries with
+ * @returns formatted string
+ */
+interface Printable {
+  toString(): string;
+}
+export function applyStringFormatting(formatStr: string, args: Printable[]): string {
+  return formatStr
+    .replace(/{(\d+)}/g, (match, index) => {
+      return typeof args[index] === 'undefined' ? match : args[index].toString();
+    })
+    .replace(/{}/g, (_match, _index) => {
+      return args.toString();
+    });
+}