ponder 0.9.4-debug.1 → 0.9.5-debug.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"partition.js","sourceRoot":"","sources":["../../../src/utils/partition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,KAAU,EACV,SAA+B,EACnB,EAAE;IACd,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;IAExB,OAAO,GAAG,GAAG,IAAI,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,CAAE,CAAC,EAAE,CAAC;YAC3B,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE/B,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvB,CAAC,CAAC"}

package/dist/esm/utils/pg.js

@@ -0,0 +1,126 @@
+import pg, {} from "pg";
+import { prettyPrint } from "./print.js";
+// The default parser for numeric[] (1231) seems to parse values as Number
+// or perhaps through JSON.parse(). Use the int8[] (1016) parser instead,
+// which properly returns an array of strings.
+const bigIntArrayParser = pg.types.getTypeParser(1016);
+pg.types.setTypeParser(1231, bigIntArrayParser);
+// Monkeypatch Pool.query to get more informative stack traces. I have no idea why this works.
+// https://stackoverflow.com/a/70601114
+const originalClientQuery = pg.Client.prototype.query;
+// @ts-ignore
+pg.Client.prototype.query = function query(...args) {
+    try {
+        return originalClientQuery.apply(this, args);
+    }
+    catch (error_) {
+        const error = error_;
+        const [statement, parameters_] = args ?? ["empty", []];
+        error.name = "PostgresError";
+        let parameters = parameters_ ?? [];
+        parameters =
+            parameters.length <= 25
+                ? parameters
+                : parameters.slice(0, 26).concat(["..."]);
+        const params = parameters.reduce((acc, parameter, idx) => {
+            acc[idx + 1] = parameter;
+            return acc;
+        }, {});
+        error.meta = Array.isArray(error.meta) ? error.meta : [];
+        if (error.detail)
+            error.meta.push(`Detail:\n  ${error.detail}`);
+        error.meta.push(`Statement:\n  ${statement}`);
+        error.meta.push(`Parameters:\n${prettyPrint(params)}`);
+        throw error;
+    }
+};
+export function createPool(config, logger) {
+    const pool = new pg.Pool({
+        // https://stackoverflow.com/questions/59155572/how-to-set-query-timeout-in-relation-to-statement-timeout
+        statement_timeout: 2 * 60 * 1000, // 2 minutes
+        ...config,
+    });
+    function onError(error) {
+        const client = error.client;
+        const pid = client?.processID ?? "unknown";
+        const applicationName = client?.connectionParameters?.application_name ??
+            "unknown";
+        logger.error({
+            service: "postgres",
+            msg: `Pool error (application_name: ${applicationName}, pid: ${pid})`,
+            error,
+        });
+        // NOTE: Errors thrown here cause an uncaughtException. It's better to just log and ignore -
+        // if the underlying problem persists, the process will crash due to downstream effects.
+    }
+    function onNotice(notice) {
+        logger.debug({
+            service: "postgres",
+            msg: `notice: ${notice.message} (code: ${notice.code})`,
+        });
+    }
+    pool.on("error", onError);
+    pool.on("connect", (client) => {
+        client.on("notice", onNotice);
+    });
+    return pool;
+}
+export function createReadonlyPool(config, logger, namespace) {
+    class ReadonlyClient extends pg.Client {
+        // @ts-expect-error
+        connect(callback) {
+            if (callback) {
+                super.connect(() => {
+                    this.query(`
+          SET search_path = "${namespace}";
+          SET SESSION CHARACTERISTICS AS TRANSACTION READ ONLY;
+          SET work_mem = '512MB';
+          SET statement_timeout = '500ms';
+          SET lock_timeout = '500ms';
+        `, callback);
+                });
+            }
+            else {
+                return super.connect().then(() => this.query(`
+          SET search_path = "${namespace}";
+          SET SESSION CHARACTERISTICS AS TRANSACTION READ ONLY;
+          SET work_mem = '512MB';
+          SET statement_timeout = '500ms';
+          SET lock_timeout = '500ms';
+        `).then(() => { }));
+            }
+        }
+    }
+    const pool = new pg.Pool({
+        // https://stackoverflow.com/questions/59155572/how-to-set-query-timeout-in-relation-to-statement-timeout
+        statement_timeout: 2 * 60 * 1000, // 2 minutes
+        // @ts-expect-error: The custom Client is an undocumented option.
+        Client: ReadonlyClient,
+        ...config,
+    });
+    function onError(error) {
+        const client = error.client;
+        const pid = client?.processID ?? "unknown";
+        const applicationName = client?.connectionParameters?.application_name ??
+            "unknown";
+        logger.error({
+            service: "postgres",
+            msg: `Pool error (application_name: ${applicationName}, pid: ${pid})`,
+            error,
+        });
+        // NOTE: Errors thrown here cause an uncaughtException. It's better to just log and ignore -
+        // if the underlying problem persists, the process will crash due to downstream effects.
+    }
+    function onNotice(notice) {
+        logger.debug({
+            service: "postgres",
+            msg: `notice: ${notice.message} (code: ${notice.code})`,
+        });
+    }
+    pool.on("error", onError);
+    pool.on("connect", (client) => {
+        client.on("notice", onNotice);
+    });
+    return pool;
+}
+//# sourceMappingURL=pg.js.map

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

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

package/dist/esm/utils/pglite.js

@@ -0,0 +1,80 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _PGliteDriver_client, _PGliteConnection_client;
+import { mkdirSync } from "node:fs";
+import { PGlite } from "@electric-sql/pglite";
+import { CompiledQuery, PostgresAdapter, PostgresIntrospector, PostgresQueryCompiler, } from "kysely";
+export function createPglite(options) {
+    // PGlite uses the memory FS by default, and Windows doesn't like the
+    // "memory://" path, so it's better to pass `undefined` here.
+    if (options.dataDir === "memory://") {
+        // @ts-expect-error
+        options.dataDir = undefined;
+    }
+    else {
+        mkdirSync(options.dataDir, { recursive: true });
+    }
+    return new PGlite(options);
+}
+// Adapted from dnlsandiego/kysely-pglite
+// https://github.com/dnlsandiego/kysely-pglite/blob/3891a0c4d9327a21bff26addf371784f0109260b/src/kysely-pglite.ts
+export function createPgliteKyselyDialect(instance) {
+    return {
+        createAdapter: () => new PostgresAdapter(),
+        createDriver: () => new PGliteDriver(instance),
+        createIntrospector: (db) => new PostgresIntrospector(db),
+        createQueryCompiler: () => new PostgresQueryCompiler(),
+    };
+}
+// Adapted from dnlsandiego/kysely-pglite
+// https://github.com/dnlsandiego/kysely-pglite/blob/3891a0c4d9327a21bff26addf371784f0109260b/src/pglite-driver.ts
+export class PGliteDriver {
+    constructor(client) {
+        _PGliteDriver_client.set(this, void 0);
+        __classPrivateFieldSet(this, _PGliteDriver_client, client, "f");
+    }
+    async acquireConnection() {
+        return new PGliteConnection(__classPrivateFieldGet(this, _PGliteDriver_client, "f"));
+    }
+    async beginTransaction(connection, _settings) {
+        await connection.executeQuery(CompiledQuery.raw("BEGIN"));
+    }
+    async commitTransaction(connection) {
+        await connection.executeQuery(CompiledQuery.raw("COMMIT"));
+    }
+    async rollbackTransaction(connection) {
+        await connection.executeQuery(CompiledQuery.raw("ROLLBACK"));
+    }
+    async destroy() {
+        await __classPrivateFieldGet(this, _PGliteDriver_client, "f").close();
+    }
+    async init() { }
+    async releaseConnection(_connection) { }
+}
+_PGliteDriver_client = new WeakMap();
+class PGliteConnection {
+    constructor(client) {
+        _PGliteConnection_client.set(this, void 0);
+        __classPrivateFieldSet(this, _PGliteConnection_client, client, "f");
+    }
+    async executeQuery(compiledQuery) {
+        return await __classPrivateFieldGet(this, _PGliteConnection_client, "f").query(compiledQuery.sql, [
+            ...compiledQuery.parameters,
+        ]);
+    }
+    // biome-ignore lint/correctness/useYield: <explanation>
+    async *streamQuery() {
+        throw new Error("PGlite does not support streaming.");
+    }
+}
+_PGliteConnection_client = new WeakMap();
+//# sourceMappingURL=pglite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pglite.js","sourceRoot":"","sources":["../../../src/utils/pglite.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EAAiC,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EACL,aAAa,EAIb,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GAGtB,MAAM,QAAQ,CAAC;AAIhB,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,qEAAqE;IACrE,6DAA6D;IAC7D,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACpC,mBAAmB;QACnB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,yCAAyC;AACzC,kHAAkH;AAClH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO;QACL,aAAa,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE;QAC1C,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC;QAC9C,kBAAkB,EAAE,CAAC,EAAe,EAAE,EAAE,CAAC,IAAI,oBAAoB,CAAC,EAAE,CAAC;QACrE,mBAAmB,EAAE,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAE;KACrC,CAAC;AACtB,CAAC;AAED,yCAAyC;AACzC,kHAAkH;AAClH,MAAM,OAAO,YAAY;IAGvB,YAAY,MAAc;QAF1B,uCAAgB;QAGd,uBAAA,IAAI,wBAAW,MAAM,MAAA,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAI,gBAAgB,CAAC,uBAAA,IAAI,4BAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,UAA8B,EAC9B,SAA8B;QAE9B,MAAM,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,UAA8B;QACpD,MAAM,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,UAA8B;QACtD,MAAM,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,uBAAA,IAAI,4BAAQ,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,KAAmB,CAAC;IAC9B,KAAK,CAAC,iBAAiB,CAAC,WAA+B,IAAkB,CAAC;CAC3E;;AAED,MAAM,gBAAgB;IAGpB,YAAY,MAAc;QAF1B,2CAAgB;QAGd,uBAAA,IAAI,4BAAW,MAAM,MAAA,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,aAAiC;QAEjC,OAAO,MAAM,uBAAA,IAAI,gCAAQ,CAAC,KAAK,CAAI,aAAa,CAAC,GAAG,EAAE;YACpD,GAAG,aAAa,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,CAAC,WAAW;QAChB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/esm/utils/port.js

@@ -0,0 +1,30 @@
+import http from "node:http";
+export const getNextAvailablePort = async ({ common }) => {
+    const server = http.createServer();
+    let port = common.options.port;
+    return new Promise((resolve, reject) => {
+        server.once("error", (error) => {
+            if (error.code === "EADDRINUSE") {
+                common.logger.warn({
+                    service: "server",
+                    msg: `Port ${port} was in use, trying port ${port + 1}`,
+                });
+                port += 1;
+                setTimeout(() => {
+                    server.close();
+                    server.listen(port, common.options.hostname);
+                }, 5);
+            }
+            else {
+                reject(error);
+            }
+        });
+        server.once("listening", () => {
+            // Port is available
+            server.close();
+            resolve(port);
+        });
+        server.listen(port, common.options.hostname);
+    });
+};
+//# sourceMappingURL=port.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../../src/utils/port.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,EAAE,MAAM,EAAsB,EAAE,EAAE;IAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IAEnC,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IAE/B,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAA+B,EAAE,EAAE;YACvD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAChC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;oBACjB,OAAO,EAAE,QAAQ;oBACjB,GAAG,EAAE,QAAQ,IAAI,4BAA4B,IAAI,GAAG,CAAC,EAAE;iBACxD,CAAC,CAAC;gBACH,IAAI,IAAI,CAAC,CAAC;gBACV,UAAU,CAAC,GAAG,EAAE;oBACd,MAAM,CAAC,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC/C,CAAC,EAAE,CAAC,CAAC,CAAC;YACR,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,oBAAoB;YACpB,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/utils/print.js

@@ -0,0 +1,23 @@
+// Adapted from viem.
+// https://github.com/wagmi-dev/viem/blob/021ce8e5a3fb02db6139564345a91fc77cba08a6/src/errors/transaction.ts#L6-L19
+export function prettyPrint(args) {
+    if (args === undefined)
+        return "(undefined)";
+    const entries = Object.entries(args)
+        .map(([key, value]) => {
+        if (value === undefined)
+            return null;
+        const trimmedValue = typeof value === "string" && value.length > 80
+            ? value.slice(0, 80).concat("...")
+            : value;
+        return [key, trimmedValue];
+    })
+        .filter(Boolean);
+    if (entries.length === 0)
+        return "  (empty object)";
+    const maxLength = entries.reduce((acc, [key]) => Math.max(acc, key.length), 0);
+    return entries
+        .map(([key, value]) => `  ${`${key}`.padEnd(maxLength + 1)}  ${value}`)
+        .join("\n");
+}
+//# sourceMappingURL=print.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../../src/utils/print.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,mHAAmH;AACnH,MAAM,UAAU,WAAW,CACzB,IAA6E;IAE7E,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IAE7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpB,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAErC,MAAM,YAAY,GAChB,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;YAC5C,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAClC,CAAC,CAAC,KAAK,CAAC;QAEZ,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC7B,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAuB,CAAC;IAEzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAEpD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAC9B,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EACzC,CAAC,CACF,CAAC;IAEF,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;SACtE,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/esm/utils/promiseWithResolvers.js

@@ -0,0 +1,13 @@
+/**
+ * @description Application level polyfill.
+ */
+export const promiseWithResolvers = () => {
+    let resolve;
+    let reject;
+    const promise = new Promise((_resolve, _reject) => {
+        resolve = _resolve;
+        reject = _reject;
+    });
+    return { resolve: resolve, reject: reject, promise };
+};
+//# sourceMappingURL=promiseWithResolvers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promiseWithResolvers.js","sourceRoot":"","sources":["../../../src/utils/promiseWithResolvers.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAEA,EAAE;IACpC,IAAI,OAAgC,CAAC;IACrC,IAAI,MAA8B,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC1D,OAAO,GAAG,QAAQ,CAAC;QACnB,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,OAAQ,EAAE,MAAM,EAAE,MAAO,EAAE,OAAO,EAAE,CAAC;AACzD,CAAC,CAAC"}

package/dist/esm/utils/queue.js

@@ -0,0 +1,145 @@
+import { promiseWithResolvers, } from "./promiseWithResolvers.js";
+const validateParameters = ({ concurrency, frequency, }) => {
+    if (concurrency === undefined && frequency === undefined) {
+        throw new Error("Invalid queue configuration, must specify either 'concurrency' or 'frequency'.");
+    }
+    if (concurrency !== undefined && concurrency <= 0) {
+        throw new Error(`Invalid value for queue 'concurrency' option. Got ${concurrency}, expected a number greater than zero.`);
+    }
+    if (frequency !== undefined && frequency <= 0) {
+        throw new Error(`Invalid value for queue 'frequency' option. Got ${frequency}, expected a number greater than zero.`);
+    }
+};
+export const createQueue = ({ worker, initialStart = false, browser = true, ..._parameters }) => {
+    validateParameters(_parameters);
+    const parameters = _parameters;
+    let queue = new Array();
+    let pending = 0;
+    let timestamp = 0;
+    let requests = 0;
+    let isStarted = initialStart;
+    let timer;
+    let emptyPromiseWithResolvers = undefined;
+    let idlePromiseWithResolvers = undefined;
+    const next = () => {
+        if (!isStarted)
+            return;
+        const _timestamp = Date.now();
+        if (Math.floor(_timestamp / 1000) !== timestamp) {
+            requests = 0;
+            timestamp = Math.floor(_timestamp / 1000);
+        }
+        if (timer)
+            return;
+        while ((parameters.frequency !== undefined
+            ? requests < parameters.frequency
+            : true) &&
+            (parameters.concurrency !== undefined
+                ? pending < parameters.concurrency
+                : true) &&
+            queue.length > 0) {
+            const { task, resolve, reject } = queue.shift();
+            requests++;
+            pending++;
+            worker(task)
+                .then(resolve)
+                .catch(reject)
+                .finally(() => {
+                pending--;
+                if (idlePromiseWithResolvers !== undefined &&
+                    queue.length === 0 &&
+                    pending === 0) {
+                    idlePromiseWithResolvers.resolve();
+                    idlePromiseWithResolvers.completed = true;
+                }
+                browser ? next() : process.nextTick(next);
+            });
+            if (emptyPromiseWithResolvers !== undefined && queue.length === 0) {
+                emptyPromiseWithResolvers.resolve();
+                emptyPromiseWithResolvers.completed = true;
+            }
+        }
+        if (parameters.frequency !== undefined &&
+            requests >= parameters.frequency) {
+            timer = setTimeout(() => {
+                timer = undefined;
+                next();
+            }, 1000 - (_timestamp % 1000));
+            return;
+        }
+    };
+    return {
+        size: () => queue.length,
+        pending: () => {
+            if (browser) {
+                return new Promise((resolve) => setTimeout(() => resolve(pending)));
+            }
+            else {
+                return new Promise((resolve) => setImmediate(() => resolve(pending)));
+            }
+        },
+        add: (task) => {
+            const { promise, resolve, reject } = promiseWithResolvers();
+            queue.push({ task, resolve, reject });
+            next();
+            return promise;
+        },
+        clear: () => {
+            queue = new Array();
+            clearTimeout(timer);
+            timer = undefined;
+        },
+        isStarted: () => isStarted,
+        start: () => {
+            if (browser) {
+                return new Promise((resolve) => setTimeout(() => resolve(pending))).then(() => {
+                    isStarted = true;
+                    next();
+                });
+            }
+            else {
+                return new Promise((resolve) => process.nextTick(() => resolve(pending))).then(() => {
+                    isStarted = true;
+                    next();
+                });
+            }
+        },
+        pause: () => {
+            isStarted = false;
+        },
+        onIdle: () => {
+            if (idlePromiseWithResolvers === undefined ||
+                idlePromiseWithResolvers.completed) {
+                if (queue.length === 0 && pending === 0)
+                    return Promise.resolve();
+                idlePromiseWithResolvers = {
+                    ...promiseWithResolvers(),
+                    completed: false,
+                };
+            }
+            return idlePromiseWithResolvers.promise;
+        },
+        onEmpty: () => {
+            if (emptyPromiseWithResolvers === undefined ||
+                emptyPromiseWithResolvers.completed) {
+                if (queue.length === 0)
+                    return Promise.resolve();
+                emptyPromiseWithResolvers = {
+                    ...promiseWithResolvers(),
+                    completed: false,
+                };
+            }
+            return emptyPromiseWithResolvers.promise;
+        },
+        setParameters: (_parameters) => {
+            validateParameters(_parameters);
+            if ("frequency" in _parameters) {
+                parameters.frequency = _parameters.frequency;
+            }
+            if ("concurrency" in _parameters) {
+                parameters.concurrency = _parameters.concurrency;
+            }
+        },
+    };
+};
+//# sourceMappingURL=queue.js.map

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

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

package/dist/esm/utils/range.js

@@ -0,0 +1,8 @@
+/**
+ * Generates an array of integers between two bounds. Exclusive on the right.
+ *
+ * @param start Integer to start at.
+ * @param stop Integer to stop at (exclusive).
+ */
+export const range = (start, stop) => Array.from({ length: stop - start }, (_, i) => start + i);
+//# sourceMappingURL=range.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../../../src/utils/range.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,EAAE,CACnD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC"}

package/dist/esm/utils/requestQueue.js

@@ -0,0 +1,127 @@
+import { ShutdownError } from '../internal/errors.js';
+import { createQueue } from './queue.js';
+import { getLogsRetryHelper, } from "@ponder/utils";
+import { HttpRequestError, JsonRpcVersionUnsupportedError, MethodNotFoundRpcError, MethodNotSupportedRpcError, ParseRpcError, isHex, } from "viem";
+import { startClock } from "./timer.js";
+import { wait } from "./wait.js";
+const RETRY_COUNT = 9;
+const BASE_DURATION = 125;
+/**
+ * Creates a queue built to manage rpc requests.
+ */
+export const createRequestQueue = ({ common, network, }) => {
+    // @ts-ignore
+    const fetchRequest = async (request) => {
+        for (let i = 0; i <= RETRY_COUNT; i++) {
+            try {
+                const stopClock = startClock();
+                if (common.shutdown.isKilled) {
+                    throw new ShutdownError();
+                }
+                common.logger.trace({
+                    service: "rpc",
+                    msg: `Sent ${request.method} request (params=${JSON.stringify(request.params)})`,
+                });
+                const response = await network.transport.request(request);
+                common.metrics.ponder_rpc_request_duration.observe({ method: request.method, network: network.name }, stopClock());
+                if (common.shutdown.isKilled) {
+                    throw new ShutdownError();
+                }
+                common.logger.trace({
+                    service: "rpc",
+                    msg: `Received ${request.method} response (duration=${stopClock()}, params=${JSON.stringify(request.params)})`,
+                });
+                return response;
+            }
+            catch (_error) {
+                const error = _error;
+                if (common.shutdown.isKilled) {
+                    throw new ShutdownError();
+                }
+                if (request.method === "eth_getLogs" &&
+                    isHex(request.params[0].fromBlock) &&
+                    isHex(request.params[0].toBlock)) {
+                    const getLogsErrorResponse = getLogsRetryHelper({
+                        params: request.params,
+                        error: error,
+                    });
+                    if (getLogsErrorResponse.shouldRetry === true)
+                        throw error;
+                }
+                if (shouldRetry(error) === false) {
+                    common.logger.warn({
+                        service: "rpc",
+                        msg: `Failed ${request.method} request`,
+                    });
+                    throw error;
+                }
+                if (i === RETRY_COUNT) {
+                    common.logger.warn({
+                        service: "rpc",
+                        msg: `Failed ${request.method} request after ${i + 1} attempts`,
+                        error,
+                    });
+                    throw error;
+                }
+                const duration = BASE_DURATION * 2 ** i;
+                common.logger.debug({
+                    service: "rpc",
+                    msg: `Failed ${request.method} request, retrying after ${duration} milliseconds`,
+                    error,
+                });
+                await wait(duration);
+            }
+        }
+    };
+    const requestQueue = createQueue({
+        frequency: network.maxRequestsPerSecond,
+        concurrency: Math.ceil(network.maxRequestsPerSecond / 4),
+        initialStart: true,
+        browser: false,
+        worker: async (task) => {
+            common.metrics.ponder_rpc_request_lag.observe({ method: task.request.method, network: network.name }, task.stopClockLag());
+            return await fetchRequest(task.request);
+        },
+    });
+    return {
+        request: (params) => {
+            const stopClockLag = startClock();
+            return requestQueue.add({ request: params, stopClockLag });
+        },
+    };
+};
+/**
+ * @link https://github.com/wevm/viem/blob/main/src/utils/buildRequest.ts#L192
+ */
+function shouldRetry(error) {
+    if ("code" in error && typeof error.code === "number") {
+        // Invalid JSON
+        if (error.code === ParseRpcError.code)
+            return false;
+        // Method does not exist
+        if (error.code === MethodNotFoundRpcError.code)
+            return false;
+        // Method is not implemented
+        if (error.code === MethodNotSupportedRpcError.code)
+            return false;
+        // Version of JSON-RPC protocol is not supported
+        if (error.code === JsonRpcVersionUnsupportedError.code)
+            return false;
+    }
+    if (error instanceof HttpRequestError && error.status) {
+        // Method Not Allowed
+        if (error.status === 405)
+            return false;
+        // Not Found
+        if (error.status === 404)
+            return false;
+        // Not Implemented
+        if (error.status === 501)
+            return false;
+        // HTTP Version Not Supported
+        if (error.status === 505)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=requestQueue.js.map

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

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

package/dist/esm/utils/result.js

@@ -0,0 +1,10 @@
+export const mergeResults = (results) => {
+    for (const result of results) {
+        if (result.status === "error") {
+            return result;
+        }
+    }
+    // @ts-ignore
+    return { status: "success", result: results.map((result) => result.result) };
+};
+//# sourceMappingURL=result.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../src/utils/result.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAAU,EACe,EAAE;IAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,aAAa;IACb,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/E,CAAC,CAAC"}