@mikeatlast/ponder 0.16.1-fork.1

package/dist/esm/utils/decodeAbiParameters.js

@@ -0,0 +1,290 @@
+import { InvalidHexBooleanError, } from "viem";
+import { AbiDecodingDataSizeTooSmallError, AbiDecodingZeroDataError, InvalidAbiDecodingTypeError, checksumAddress, hexToBigInt, hexToNumber, hexToString, } from "viem";
+const TRUE_BOOL = "0x0000000000000000000000000000000000000000000000000000000000000001";
+const FALSE_BOOL = "0x0000000000000000000000000000000000000000000000000000000000000000";
+const FIXED_ARRAY_REGEX = /^(.*)\[(\d+)\]$/;
+const DYNAMIC_ARRAY_REGEX = /^(.*)\[\]$/;
+const cursor = { index: 2, offset: 2, length: 2, readCount: 0, readLimit: 0 };
+function readWord(data) {
+    if (cursor.readCount > cursor.readLimit) {
+        throw new Error("Recursive read limit exceeded.");
+    }
+    cursor.readCount++;
+    if (data.length - cursor.index < 64) {
+        throw new Error("Invalid data length.");
+    }
+    return `0x${data.slice(cursor.index, cursor.index + 64)}`;
+}
+/**
+ * Decode a list of abi parameters.
+ *
+ * @param params - The abi parameters to decode.
+ * @param data - The data to decode.
+ * @param formatAddress - An optional function to format addresses.
+ * @param out - An optional array to store the decoded parameters.
+ *
+ * @see https://github.com/wevm/viem/blob/38525bf1d55ec3fe0569e47700c7f9e70d3c971c/src/utils/abi/decodeAbiParameters.ts
+ */
+export function decodeAbiParameters(params, data, { formatAddress = checksumAddress, out = [], } = {
+    formatAddress: checksumAddress,
+    out: [],
+}) {
+    if (data.length <= 2 && params.length > 0) {
+        throw new AbiDecodingZeroDataError();
+    }
+    if (data.length > 2 && data.length < 66) {
+        throw new AbiDecodingDataSizeTooSmallError({
+            data,
+            params: params,
+            size: (data.length - 2) / 2,
+        });
+    }
+    cursor.index = 2;
+    cursor.offset = 2;
+    cursor.length = data.length;
+    cursor.readCount = 0;
+    cursor.readLimit = Math.floor(data.length / 64) + 8192;
+    for (const param of params) {
+        if (data.length - cursor.index < 64) {
+            throw new Error("Invalid data length.");
+        }
+        out.push(_decodeAbiParameter(param, data, formatAddress));
+    }
+    return out;
+}
+function _decodeAbiParameter(param, data, formatAddress = checksumAddress) {
+    if (isAbiParameterFixedArray(param)) {
+        const _type = param.type;
+        const [_, type, length] = param.type.match(FIXED_ARRAY_REGEX);
+        param.type = type;
+        if (length === "0") {
+            throw new Error("Invalid data length.");
+        }
+        if (isAbiParameterDeeplyStatic(param) === false) {
+            const _offset = cursor.offset;
+            const _index = cursor.index;
+            const offset = readWord(data);
+            cursor.index = cursor.offset + hexToNumber(offset) * 2;
+            cursor.offset += hexToNumber(offset) * 2;
+            const value = [];
+            for (let i = 0; i < Number.parseInt(length, 10); ++i) {
+                cursor.index = cursor.offset + i * 64;
+                value.push(_decodeAbiParameter(param, data, formatAddress));
+            }
+            cursor.offset = _offset;
+            cursor.index = _index + 64;
+            param.type = _type;
+            return value;
+        }
+        const value = [];
+        for (let i = 0; i < Number.parseInt(length, 10); ++i) {
+            if (data.length - cursor.index < 64) {
+                throw new Error("Invalid data length.");
+            }
+            value.push(_decodeAbiParameter(param, data, formatAddress));
+        }
+        param.type = _type;
+        return value;
+    }
+    if (isAbiParameterDynamicArray(param)) {
+        const _offset = cursor.offset;
+        const _index = cursor.index;
+        const offset = readWord(data);
+        cursor.index = cursor.offset + hexToNumber(offset) * 2;
+        cursor.offset += hexToNumber(offset) * 2 + 64;
+        const length = readWord(data);
+        cursor.index += 64;
+        const _type = param.type;
+        const [_, type] = param.type.match(DYNAMIC_ARRAY_REGEX);
+        param.type = type;
+        const deeplyStatic = isAbiParameterDeeplyStatic(param);
+        const value = [];
+        for (let i = 0; i < hexToNumber(length); ++i) {
+            if (deeplyStatic === false) {
+                cursor.index = cursor.offset + i * 64;
+            }
+            if (data.length - cursor.index < 64) {
+                throw new Error("Invalid data length.");
+            }
+            value.push(_decodeAbiParameter(param, data, formatAddress));
+        }
+        cursor.offset = _offset;
+        cursor.index = _index + 64;
+        param.type = _type;
+        return value;
+    }
+    if (param.type === "tuple") {
+        const components = param.components;
+        const hasUnnamedChild = components.length === 0 ||
+            components.some((component) => component.name === undefined);
+        const value = hasUnnamedChild ? [] : {};
+        if (isAbiParameterDeeplyStatic(param)) {
+            for (let i = 0; i < components.length; ++i) {
+                const component = components[i];
+                const _value = _decodeAbiParameter(component, data, formatAddress);
+                if (hasUnnamedChild) {
+                    value.push(_value);
+                }
+                else {
+                    value[component.name] = _value;
+                }
+            }
+            return value;
+        }
+        const _offset = cursor.offset;
+        const _index = cursor.index;
+        const offset = readWord(data);
+        cursor.offset += hexToNumber(offset) * 2;
+        cursor.index = cursor.offset;
+        for (let i = 0; i < components.length; ++i) {
+            const component = components[i];
+            const _value = _decodeAbiParameter(component, data, formatAddress);
+            if (hasUnnamedChild) {
+                value.push(_value);
+            }
+            else {
+                value[component.name] = _value;
+            }
+        }
+        cursor.offset = _offset;
+        cursor.index = _index + 64;
+        return value;
+    }
+    if (param.type === "address") {
+        if (data.length - cursor.index < 64) {
+            throw new Error("Invalid data length.");
+        }
+        const address = `0x${data.slice(cursor.index + 24, cursor.index + 64)}`;
+        cursor.index += 64;
+        return formatAddress(address);
+    }
+    if (param.type.startsWith("uint") || param.type.startsWith("int")) {
+        const signed = param.type.startsWith("int");
+        const size = Number.parseInt(param.type.split("int")[1] || "256", 10);
+        const value = readWord(data);
+        cursor.index += 64;
+        return size > 48
+            ? hexToBigInt(value, { signed })
+            : hexToNumber(value, { signed });
+    }
+    if (param.type.startsWith("bytes") && param.type.length > 5) {
+        const [_, size] = param.type.split("bytes");
+        if (data.length - cursor.index < Number.parseInt(size, 10) * 2) {
+            throw new Error("Invalid data length.");
+        }
+        const value = `0x${data.slice(cursor.index, cursor.index + Number.parseInt(size, 10) * 2)}`;
+        cursor.index += 64;
+        return value;
+    }
+    if (param.type === "bool") {
+        const value = readWord(data);
+        cursor.index += 64;
+        if (value !== TRUE_BOOL && value !== FALSE_BOOL) {
+            throw new InvalidHexBooleanError(value);
+        }
+        return value === TRUE_BOOL;
+    }
+    if (param.type === "string") {
+        const _index = cursor.index;
+        const offset = readWord(data);
+        cursor.index = cursor.offset + hexToNumber(offset) * 2;
+        const length = readWord(data);
+        cursor.index += 64;
+        if (hexToNumber(length) === 0) {
+            cursor.index = _index + 64;
+            return "";
+        }
+        if (data.length - cursor.index < hexToNumber(length) * 2) {
+            throw new Error("Invalid data length.");
+        }
+        const value = `0x${data.slice(cursor.index, cursor.index + hexToNumber(length) * 2)}`;
+        cursor.index = _index + 64;
+        return hexToString(value);
+    }
+    if (param.type === "bytes") {
+        const index = cursor.index;
+        const offset = readWord(data);
+        cursor.index = cursor.offset + hexToNumber(offset) * 2;
+        const length = readWord(data);
+        cursor.index += 64;
+        if (hexToNumber(length) === 0) {
+            cursor.index = index + 64;
+            return "0x";
+        }
+        if (data.length - cursor.index < hexToNumber(length) * 2) {
+            throw new Error("Invalid data length.");
+        }
+        const value = `0x${data.slice(cursor.index, cursor.index + hexToNumber(length) * 2)}`;
+        cursor.index = index + 64;
+        return value;
+    }
+    throw new InvalidAbiDecodingTypeError(param.type, {
+        docsPath: "/docs/contract/decodeAbiParameters",
+    });
+}
+/**
+ * Decode a single abi parameter.
+ *
+ * @param param - The abi parameter to decode.
+ * @param data - The data to decode.
+ * @param formatAddress - An optional function to format addresses.
+ *
+ * @see https://github.com/wevm/viem/blob/38525bf1d55ec3fe0569e47700c7f9e70d3c971c/src/utils/abi/decodeAbiParameters.ts
+ */
+export function decodeAbiParameter(param, data, { formatAddress = checksumAddress, } = {
+    formatAddress: checksumAddress,
+}) {
+    if (data.length <= 2) {
+        throw new AbiDecodingZeroDataError();
+    }
+    if (data.length !== 66) {
+        throw new Error(`Invalid data length. Expected 66 bytes, got ${data.length}`);
+    }
+    if (param.type === "address") {
+        const address = `0x${data.slice(2 + 12 * 2)}`;
+        return formatAddress(address);
+    }
+    if (param.type.startsWith("uint") || param.type.startsWith("int")) {
+        const signed = param.type.startsWith("int");
+        const size = Number.parseInt(param.type.split("int")[1] || "256", 10);
+        return (size > 48 ? hexToBigInt(data, { signed }) : hexToNumber(data, { signed }));
+    }
+    if (param.type.startsWith("bytes") && param.type.length > 5) {
+        const [_, size] = param.type.split("bytes");
+        return data.slice(0, 2 + Number.parseInt(size, 10) * 2);
+    }
+    if (param.type === "bool") {
+        return (data === TRUE_BOOL);
+    }
+    throw new InvalidAbiDecodingTypeError(param.type, {
+        docsPath: "/docs/contract/decodeAbiParameters",
+    });
+}
+function isAbiParameterFixedArray(param) {
+    return FIXED_ARRAY_REGEX.test(param.type);
+}
+function isAbiParameterDynamicArray(param) {
+    return DYNAMIC_ARRAY_REGEX.test(param.type);
+}
+function isAbiParameterDeeplyStatic(param) {
+    const { type } = param;
+    if (type === "string")
+        return false;
+    if (type === "bytes")
+        return false;
+    if (type.endsWith("[]"))
+        return false;
+    if (type === "tuple") {
+        return param.components.every(isAbiParameterDeeplyStatic);
+    }
+    if (isAbiParameterFixedArray(param)) {
+        const _type = param.type;
+        const [_, type] = param.type.match(FIXED_ARRAY_REGEX);
+        param.type = type;
+        const result = isAbiParameterDeeplyStatic(param);
+        param.type = _type;
+        return result;
+    }
+    return true;
+}
+//# sourceMappingURL=decodeAbiParameters.js.map

package/dist/esm/utils/decodeAbiParameters.js.map

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

package/dist/esm/utils/decodeEventLog.js

@@ -0,0 +1,75 @@
+import { DecodeLogDataMismatch, DecodeLogTopicsMismatch, } from "viem";
+import { decodeAbiParameter, decodeAbiParameters, } from "./decodeAbiParameters.js";
+import { toLowerCase } from "./lowercase.js";
+/**
+ * Decode an event log.
+ *
+ * @see https://github.com/wevm/viem/blob/main/src/utils/abi/decodeEventLog.ts#L99
+ */
+export function decodeEventLog({ abiItem, topics, data, }) {
+    const { inputs } = abiItem;
+    const isUnnamed = inputs?.some((x) => !("name" in x && x.name));
+    const args = isUnnamed ? [] : {};
+    // Decode topics (indexed args).
+    const indexedInputs = inputs
+        .map((x, i) => [x, i])
+        .filter(([x]) => "indexed" in x && x.indexed);
+    for (let i = 0; i < indexedInputs.length; i++) {
+        const [param, argIndex] = indexedInputs[i];
+        const topic = topics[i + 1];
+        if (!topic) {
+            throw new DecodeLogTopicsMismatch({
+                abiItem,
+                param: param,
+            });
+        }
+        args[isUnnamed ? argIndex : param.name || argIndex] = decodeTopic({
+            param,
+            value: topic,
+        });
+    }
+    // Decode data (non-indexed args).
+    const nonIndexedInputs = inputs.filter((x) => !("indexed" in x && x.indexed));
+    if (nonIndexedInputs.length > 0) {
+        if (data && data !== "0x") {
+            const out = [];
+            decodeAbiParameters(nonIndexedInputs, data, {
+                out,
+                formatAddress: toLowerCase,
+            });
+            if (out) {
+                if (isUnnamed) {
+                    for (let i = 0; i < inputs.length; i++) {
+                        args[i] = args[i] ?? out.shift();
+                    }
+                }
+                else {
+                    for (let i = 0; i < nonIndexedInputs.length; i++) {
+                        args[nonIndexedInputs[i].name] = out[i];
+                    }
+                }
+                out.length = 0;
+            }
+        }
+        else {
+            throw new DecodeLogDataMismatch({
+                abiItem,
+                data: "0x",
+                params: nonIndexedInputs,
+                size: 0,
+            });
+        }
+    }
+    return Object.values(args).length > 0 ? args : undefined;
+}
+const ARRAY_REGEX = /^(.*)\[(\d+)?\]$/;
+function decodeTopic({ param, value }) {
+    if (param.type === "string" ||
+        param.type === "bytes" ||
+        param.type === "tuple" ||
+        param.type.match(ARRAY_REGEX)) {
+        return value;
+    }
+    return decodeAbiParameter(param, value, { formatAddress: toLowerCase });
+}
+//# sourceMappingURL=decodeEventLog.js.map

package/dist/esm/utils/decodeEventLog.js.map

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

package/dist/esm/utils/dedupe.js

@@ -0,0 +1,29 @@
+/**
+ * Remove duplicate values from an array.
+ *
+ * @param getId callback used to calculate a unique value for an element of the array.
+ *
+ * @example
+ * dedupe([1,1,2,3]) // [1,2,3]
+ *
+ * dedupe(
+ *   [
+ *     { a: 1, b: 2 },
+ *     { a: 1, b: 2 },
+ *     { a: 2, b: 2 },
+ *   ],
+ *   (e) => `${e.a}_${e.b}`,
+ * ) // [{a: 1, b: 2}, {a: 2, b: 2}]
+ *
+ */
+export function dedupe(arr, getId) {
+    const seen = new Set();
+    return arr.filter((x) => {
+        const id = getId ? getId(x) : x;
+        if (seen.has(id))
+            return false;
+        seen.add(id);
+        return true;
+    });
+}
+//# sourceMappingURL=dedupe.js.map

package/dist/esm/utils/dedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.js","sourceRoot":"","sources":["../../../src/utils/dedupe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,MAAM,CACpB,GAA6B,EAC7B,KAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAa,CAAC;IAElC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QAE/B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/utils/duplicates.js

@@ -0,0 +1,19 @@
+/**
+ * Returns a Set containing all the duplicate elements in an array of strings.
+ * @param arr - The input array of strings.
+ * @returns A Set object containing the duplicate elements found in the input array.
+ */
+export function getDuplicateElements(arr) {
+    const uniqueElements = new Set();
+    const duplicates = new Set();
+    arr.forEach((element) => {
+        if (uniqueElements.has(element)) {
+            duplicates.add(element);
+        }
+        else {
+            uniqueElements.add(element);
+        }
+    });
+    return duplicates;
+}
+//# sourceMappingURL=duplicates.js.map

package/dist/esm/utils/duplicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicates.js","sourceRoot":"","sources":["../../../src/utils/duplicates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAa;IAChD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAe,EAAE,EAAE;QAC9B,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;YAC/B,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;SACzB;aAAM;YACL,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;SAC7B;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/esm/utils/estimate.js

@@ -0,0 +1,6 @@
+export const estimate = ({ from, to, target, result, min, max, prev, maxIncrease, }) => {
+    const density = (to - from) / (result || 1);
+    // min <= estimate <= prev * maxIncrease or max
+    return Math.min(Math.max(min, Math.round(target * density)), Math.round(prev * maxIncrease), max);
+};
+//# sourceMappingURL=estimate.js.map

package/dist/esm/utils/estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.js","sourceRoot":"","sources":["../../../src/utils/estimate.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EACvB,IAAI,EACJ,EAAE,EACF,MAAM,EACN,MAAM,EACN,GAAG,EACH,GAAG,EACH,IAAI,EACJ,WAAW,GAUZ,EAAE,EAAE;IACH,MAAM,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC5C,+CAA+C;IAC/C,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,EAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,EAC9B,GAAG,CACJ,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/utils/finality.js

@@ -0,0 +1,38 @@
+/**
+ * Returns the number of blocks that must pass before a block is considered final.
+ * Note that a value of `0` indicates that blocks are considered final immediately.
+ *
+ * @param chain The chain to get the finality block count for.
+ * @returns The finality block count.
+ */
+export function getFinalityBlockCount({ chain }) {
+    let finalityBlockCount;
+    switch (chain?.id) {
+        // Mainnet and mainnet testnets.
+        case 1:
+        case 3:
+        case 4:
+        case 5:
+        case 42:
+        case 11155111:
+            finalityBlockCount = 65;
+            break;
+        // Polygon.
+        case 137:
+        case 80001:
+            finalityBlockCount = 200;
+            break;
+        // Arbitrum.
+        case 42161:
+        case 42170:
+        case 421611:
+        case 421613:
+            finalityBlockCount = 240;
+            break;
+        default:
+            // Assume a 2-second block time, e.g. OP stack chains.
+            finalityBlockCount = 30;
+    }
+    return finalityBlockCount;
+}
+//# sourceMappingURL=finality.js.map

package/dist/esm/utils/finality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finality.js","sourceRoot":"","sources":["../../../src/utils/finality.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAE,KAAK,EAAgC;IAC3E,IAAI,kBAA0B,CAAC;IAC/B,QAAQ,KAAK,EAAE,EAAE,EAAE;QACjB,gCAAgC;QAChC,KAAK,CAAC,CAAC;QACP,KAAK,CAAC,CAAC;QACP,KAAK,CAAC,CAAC;QACP,KAAK,CAAC,CAAC;QACP,KAAK,EAAE,CAAC;QACR,KAAK,QAAQ;YACX,kBAAkB,GAAG,EAAE,CAAC;YACxB,MAAM;QACR,WAAW;QACX,KAAK,GAAG,CAAC;QACT,KAAK,KAAK;YACR,kBAAkB,GAAG,GAAG,CAAC;YACzB,MAAM;QACR,YAAY;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,kBAAkB,GAAG,GAAG,CAAC;YACzB,MAAM;QACR;YACE,sDAAsD;YACtD,kBAAkB,GAAG,EAAE,CAAC;KAC3B;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/esm/utils/format.js

@@ -0,0 +1,20 @@
+export const formatEta = (ms) => {
+    // If less than 1 second, return ms.
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    const seconds = Math.floor(ms / 1000);
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds - h * 3600) / 60);
+    const s = seconds - h * 3600 - m * 60;
+    const hstr = h > 0 ? `${h}h ` : "";
+    const mstr = m > 0 || h > 0 ? `${m < 10 && h > 0 ? "0" : ""}${m}m ` : "";
+    const sstr = s > 0 || m > 0 ? `${s < 10 && m > 0 ? "0" : ""}${s}s` : "";
+    return `${hstr}${mstr}${sstr}`;
+};
+export const formatPercentage = (cacheRate) => {
+    const decimal = Math.round(cacheRate * 1000) / 10;
+    return Number.isInteger(decimal) && decimal < 100
+        ? `${decimal}.0%`
+        : `${decimal}%`;
+};
+//# sourceMappingURL=format.js.map

package/dist/esm/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/utils/format.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAU,EAAE,EAAE;IACtC,oCAAoC;IACpC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAEtC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;IAEtC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAExE,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAiB,EAAE,EAAE;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAClD,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,GAAG;QAC/C,CAAC,CAAC,GAAG,OAAO,KAAK;QACjB,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;AACpB,CAAC,CAAC"}

package/dist/esm/utils/generators.js

@@ -0,0 +1,121 @@
+import { promiseWithResolvers } from './promiseWithResolvers.js';
+import { startClock } from "./timer.js";
+/**
+ * Merges multiple async generators into a single async generator.
+ *
+ * @param generators - The generators to merge.
+ * @returns A single async generator that yields results from all input generators.
+ */
+export async function* mergeAsyncGenerators(generators) {
+    const promises = generators.map((gen) => gen.next());
+    while (promises.length > 0) {
+        const wrappedPromises = promises.map((promise, index) => promise.then((result) => ({ index, result })));
+        const { result, index } = await Promise.race(wrappedPromises);
+        if (result.done) {
+            generators.splice(index, 1);
+            promises.splice(index, 1);
+        }
+        else {
+            const generator = generators[index];
+            const promise = generator.next();
+            promises.splice(index, 1);
+            generators.splice(index, 1);
+            generators.push(generator);
+            promises.push(promise);
+            yield result.value;
+        }
+    }
+}
+/**
+ * Buffers the results of an async generator.
+ *
+ * @param generator - The generator to buffer.
+ * @param size - The size of the buffer.
+ * @returns An async generator that yields results from the input generator.
+ */
+export async function* bufferAsyncGenerator(generator, size, bufferCallback) {
+    const buffer = [];
+    let done = false;
+    let pwr1 = promiseWithResolvers();
+    let pwr2 = promiseWithResolvers();
+    (async () => {
+        for await (const result of generator) {
+            buffer.push(result);
+            bufferCallback?.(buffer.length);
+            pwr1.resolve();
+            if (buffer.length >= size)
+                await pwr2.promise;
+            pwr2 = promiseWithResolvers();
+        }
+        done = true;
+        pwr1.resolve();
+    })();
+    while (done === false || buffer.length > 0) {
+        if (buffer.length > 0) {
+            pwr2.resolve();
+            yield buffer.shift();
+        }
+        else {
+            await pwr1.promise;
+            pwr1 = promiseWithResolvers();
+        }
+    }
+}
+/**
+ * Drains an async generator into an array.
+ *
+ * @param asyncGenerator - The async generator to drain.
+ * @returns An array of results from the input generator.
+ */
+export async function drainAsyncGenerator(asyncGenerator) {
+    const result = [];
+    for await (const events of asyncGenerator) {
+        result.push(events);
+    }
+    return result;
+}
+/**
+ * Records the total time taken to yield results from an async generator.
+ *
+ * @param asyncGenerator - The async generator to record.
+ * @param callback - A callback function that receives duration metrics.
+ * @returns An async generator that yields results from the input generator.
+ */
+export async function* recordAsyncGenerator(asyncGenerator, callback) {
+    let endClockTotal = startClock();
+    for await (const result of asyncGenerator) {
+        const endClockInner = startClock();
+        yield result;
+        callback({
+            await: endClockTotal() - endClockInner(),
+            yield: endClockInner(),
+            total: endClockTotal(),
+        });
+        endClockTotal = startClock();
+    }
+}
+/**
+ * Creates an async generator that yields values from a callback.
+ */
+export function createCallbackGenerator(bufferCallback) {
+    const buffer = [];
+    let pwr = promiseWithResolvers();
+    const callback = (value) => {
+        buffer.push(value);
+        bufferCallback?.(buffer.length);
+        pwr.resolve();
+    };
+    async function* generator() {
+        while (true) {
+            if (buffer.length > 0) {
+                yield buffer.shift();
+            }
+            else {
+                await pwr.promise;
+                pwr = promiseWithResolvers();
+            }
+        }
+    }
+    return { callback, generator: generator() };
+}
+//# sourceMappingURL=generators.js.map

package/dist/esm/utils/generators.js.map

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