@aztec-labs/foundation 6.0.0-nightly.20260829

package/dest/testing/files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/files/index.ts"],"names":[],"mappings":"AAOA,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,sBAAsB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,GAAE,OAAe,QAS5G;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,sBAAsB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAmBnG;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAMnF;AAED,wBAAgB,aAAa,CAAC,sBAAsB,EAAE,MAAM,UAO3D"}

package/dest/testing/files/index.js

@@ -0,0 +1,59 @@
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { createConsoleLogger } from '../../log/console.js';
+import { fileURLToPath } from '../../url/index.js';
+import { isGenerateTestDataEnabled } from '../test_data.js';
+/** Writes the contents specified to the target file if test data generation is enabled. */ export function writeTestData(targetFileFromRepoRoot, contents, raw = false) {
+    if (!isGenerateTestDataEnabled()) {
+        return;
+    }
+    const targetFile = getPathToFile(targetFileFromRepoRoot);
+    const toWrite = raw ? contents : typeof contents === 'string' ? contents : contents.toString('hex');
+    writeFileSync(targetFile, toWrite);
+    const logger = createConsoleLogger('aztec:testing:test_data');
+    logger(`Wrote test data to ${targetFile}`);
+}
+export function readTestData(repoPath) {
+    const targetFile = getPathToFile(repoPath);
+    return readFileSync(targetFile);
+}
+/**
+ * Looks for a variable assignment in the target file and updates the value, only if test data generation is enabled.
+ * Note that a magic inline comment would be a cleaner approach, like `/* TEST-DATA-START *\/` and `/* TEST-DATA-END *\/`,
+ * but running nargo fmt on it panics since the comment would be erased, so we roll with this for now.
+ * @remarks Requires AZTEC_GENERATE_TEST_DATA=1 to be set
+ */ export function updateInlineTestData(targetFileFromRepoRoot, itemName, value) {
+    if (!isGenerateTestDataEnabled()) {
+        return;
+    }
+    const logger = createConsoleLogger('aztec:testing:test_data');
+    const targetFile = getPathToFile(targetFileFromRepoRoot);
+    const contents = readFileSync(targetFile, 'utf8').toString();
+    const regex = new RegExp(`(let|pub\\s+global)\\s+${itemName}(\\s*:\\s*[^=]+)?\\s*=\\s*([\\s\\S]*?);`, 'g');
+    if (!regex.exec(contents)) {
+        throw new Error(`Test data marker for ${itemName} not found in ${targetFile}`);
+    }
+    const updatedContents = contents.replace(regex, (_, declareKeyword, typeAnnotation)=>`${declareKeyword} ${itemName}${(typeAnnotation || '').trimEnd()} = ${value};`);
+    writeFileSync(targetFile, updatedContents);
+    logger(`Updated test data in ${targetFile} for ${itemName} to ${value}`);
+}
+/**
+ * Updates the sample Prover.toml files in noir-projects/fnd/noir-protocol-circuits/crates/.
+ * @remarks Requires AZTEC_GENERATE_TEST_DATA=1 to be set. The block-root, block-merge, checkpoint,
+ * tx-merge, and root rollup samples are regenerated by the prover-client
+ * `regenerate_rollup_sample_inputs.test.ts` suite; the private-kernel and transaction-base rollup
+ * samples by the e2e 'AZTEC_GENERATE_TEST_DATA=1 FAKE_PROOFS=1 yarn test:e2e single-node/prover/server/full.test' dump.
+ */ export function updateProtocolCircuitSampleInputs(circuitName, value) {
+    const logger = createConsoleLogger('aztec:testing:test_data');
+    const targetFileFromRepoRoot = `noir-projects/fnd/noir-protocol-circuits/crates/${circuitName}/Prover.toml`;
+    const targetFile = getPathToFile(targetFileFromRepoRoot);
+    writeFileSync(targetFile, value);
+    logger(`Updated test data in ${targetFile} for ${circuitName}`);
+}
+export function getPathToFile(targetFileFromRepoRoot) {
+    const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../../../../../');
+    if (!existsSync(join(repoRoot, 'CODEOWNERS'))) {
+        throw new Error(`Path to repo root is incorrect (got ${repoRoot})`);
+    }
+    return join(repoRoot, targetFileFromRepoRoot);
+}

package/dest/testing/formatting.d.ts

@@ -0,0 +1,4 @@
+export declare function toInlineStrArray(arr: {
+    toString: () => string;
+}[]): string;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZm9ybWF0dGluZy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3Rlc3RpbmcvZm9ybWF0dGluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSx3QkFBZ0IsZ0JBQWdCLENBQUMsR0FBRyxFQUFFO0lBQUUsUUFBUSxFQUFFLE1BQU0sTUFBTSxDQUFBO0NBQUUsRUFBRSxHQUFHLE1BQU0sQ0FFMUUifQ==

package/dest/testing/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/testing/formatting.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,CAE1E"}

package/dest/testing/formatting.js

@@ -0,0 +1,3 @@
+export function toInlineStrArray(arr) {
+    return `[${arr.map((f)=>f.toString()).join(',')}]`;
+}

package/dest/testing/index.d.ts

@@ -0,0 +1,5 @@
+export * from './formatting.js';
+export * from './snapshot_serializer.js';
+export * from './port_allocator.js';
+export * from './test_data.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0aW5nL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsaUJBQWlCLENBQUM7QUFDaEMsY0FBYywwQkFBMEIsQ0FBQztBQUN6QyxjQUFjLHFCQUFxQixDQUFDO0FBQ3BDLGNBQWMsZ0JBQWdCLENBQUMifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dest/testing/index.js

@@ -0,0 +1,4 @@
+export * from './formatting.js';
+export * from './snapshot_serializer.js';
+export * from './port_allocator.js';
+export * from './test_data.js';

package/dest/testing/port_allocator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get a random port that is free to use.
+ * Returns undefined if it fails to get a port.
+ *
+ * @attribution: adapted from https://stackoverflow.com/a/71178451
+ *
+ * @returns a random port that is free to use.
+ */
+export declare function getRandomPort(): Promise<number | undefined>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicG9ydF9hbGxvY2F0b3IuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90ZXN0aW5nL3BvcnRfYWxsb2NhdG9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBOzs7Ozs7O0dBT0c7QUFDSCx3QkFBZ0IsYUFBYSxJQUFJLE9BQU8sQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDLENBb0IzRCJ9

package/dest/testing/port_allocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port_allocator.d.ts","sourceRoot":"","sources":["../../src/testing/port_allocator.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB3D"}

package/dest/testing/port_allocator.js

@@ -0,0 +1,29 @@
+import net from 'net';
+/**
+ * Get a random port that is free to use.
+ * Returns undefined if it fails to get a port.
+ *
+ * @attribution: adapted from https://stackoverflow.com/a/71178451
+ *
+ * @returns a random port that is free to use.
+ */ export function getRandomPort() {
+    return new Promise((resolve)=>{
+        const server = net.createServer();
+        server.listen(0, ()=>{
+            const address = server.address();
+            if (address && typeof address === 'object' && 'port' in address) {
+                const port = address.port;
+                server.close(()=>{
+                    resolve(port);
+                });
+            } else {
+                server.close(()=>{
+                    resolve(undefined);
+                });
+            }
+        });
+        server.on('error', ()=>{
+            resolve(undefined);
+        });
+    });
+}

package/dest/testing/snapshot_serializer.d.ts

@@ -0,0 +1,5 @@
+import type { NewPlugin } from 'pretty-format';
+export declare function setupCustomSnapshotSerializers(expect: {
+    addSnapshotSerializer: (serializer: NewPlugin) => void;
+}): void;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic25hcHNob3Rfc2VyaWFsaXplci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3Rlc3Rpbmcvc25hcHNob3Rfc2VyaWFsaXplci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxTQUFTLEVBQUUsTUFBTSxlQUFlLENBQUM7QUEyQi9DLHdCQUFnQiw4QkFBOEIsQ0FBQyxNQUFNLEVBQUU7SUFBRSxxQkFBcUIsRUFBRSxDQUFDLFVBQVUsRUFBRSxTQUFTLEtBQUssSUFBSSxDQUFBO0NBQUUsUUFLaEgifQ==

package/dest/testing/snapshot_serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot_serializer.d.ts","sourceRoot":"","sources":["../../src/testing/snapshot_serializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA2B/C,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IAAE,qBAAqB,EAAE,CAAC,UAAU,EAAE,SAAS,KAAK,IAAI,CAAA;CAAE,QAKhH"}

package/dest/testing/snapshot_serializer.js

@@ -0,0 +1,32 @@
+import { inspect } from 'util';
+function makeSerializerForCustomInspect(prefix) {
+    return {
+        serialize (val) {
+            return inspect(val);
+        },
+        test (arg) {
+            return inspect(arg).startsWith(prefix);
+        }
+    };
+}
+const bufferSerializer = {
+    serialize (val) {
+        return `Buffer<0x${val.toString('hex')}>`;
+    },
+    test (arg) {
+        return Buffer.isBuffer(arg);
+    }
+};
+const CUSTOM_INSPECT_SERIALIZABLE_TYPES = [
+    'AztecAddress',
+    'Fr',
+    'Fq',
+    'Selector',
+    'EthAddress'
+];
+export function setupCustomSnapshotSerializers(expect) {
+    for (const type of CUSTOM_INSPECT_SERIALIZABLE_TYPES){
+        expect.addSnapshotSerializer(makeSerializerForCustomInspect(type));
+    }
+    expect.addSnapshotSerializer(bufferSerializer);
+}

package/dest/testing/test_data.d.ts

@@ -0,0 +1,7 @@
+/** Returns whether test data generation is enabled */
+export declare function isGenerateTestDataEnabled(): boolean;
+/** Pushes test data with the given name, only if test data generation is enabled. */
+export declare function pushTestData<T>(itemName: string, data: T): void;
+/** Returns all instances of pushed test data with the given name, or empty if test data generation is not enabled. */
+export declare function getTestData(itemName: string): unknown[];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdF9kYXRhLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdGVzdGluZy90ZXN0X2RhdGEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsc0RBQXNEO0FBQ3RELHdCQUFnQix5QkFBeUIsWUFFeEM7QUFFRCxxRkFBcUY7QUFDckYsd0JBQWdCLFlBQVksQ0FBQyxDQUFDLEVBQUUsUUFBUSxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsQ0FBQyxRQWdCeEQ7QUFFRCxzSEFBc0g7QUFDdEgsd0JBQWdCLFdBQVcsQ0FBQyxRQUFRLEVBQUUsTUFBTSxHQUFHLE9BQU8sRUFBRSxDQVF2RCJ9

package/dest/testing/test_data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_data.d.ts","sourceRoot":"","sources":["../../src/testing/test_data.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,wBAAgB,yBAAyB,YAExC;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,QAgBxD;AAED,sHAAsH;AACtH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAQvD"}

package/dest/testing/test_data.js

@@ -0,0 +1,29 @@
+const testData = {};
+/** Returns whether test data generation is enabled */ export function isGenerateTestDataEnabled() {
+    return [
+        '1',
+        'true'
+    ].includes(process.env.AZTEC_GENERATE_TEST_DATA ?? '') && typeof expect !== 'undefined';
+}
+/** Pushes test data with the given name, only if test data generation is enabled. */ export function pushTestData(itemName, data) {
+    if (!isGenerateTestDataEnabled()) {
+        return;
+    }
+    if (typeof expect === 'undefined') {
+        return;
+    }
+    const testName = expect.getState().currentTestName;
+    const fullItemName = `${testName} ${itemName}`;
+    if (!testData[fullItemName]) {
+        testData[fullItemName] = [];
+    }
+    testData[fullItemName].push(data);
+}
+/** Returns all instances of pushed test data with the given name, or empty if test data generation is not enabled. */ export function getTestData(itemName) {
+    if (!isGenerateTestDataEnabled()) {
+        return [];
+    }
+    const testName = expect.getState().currentTestName;
+    const fullItemName = `${testName} ${itemName}`;
+    return testData[fullItemName];
+}

package/dest/timer/date.d.ts

@@ -0,0 +1,39 @@
+/** Returns current datetime. */
+export declare class DateProvider {
+    now(): number;
+    nowInSeconds(): number;
+    nowAsDate(): Date;
+}
+/** Returns current datetime and allows to override it. */
+export declare class TestDateProvider extends DateProvider {
+    private readonly logger;
+    private offset;
+    constructor(logger?: import("../log/pino-logger.js").Logger);
+    now(): number;
+    setTime(timeMs: number): void;
+    /** Resets the time back to real time (offset = 0). */
+    reset(): void;
+    /** Advances the time by the given number of seconds. */
+    advanceTime(seconds: number): void;
+}
+/**
+ * A date provider for tests that only advances time via explicit advanceTime() calls.
+ * Unlike TestDateProvider, this does NOT track real time progression - time is completely
+ * frozen until explicitly advanced. This eliminates flakiness from tests taking
+ * varying amounts of real time to execute.
+ */
+export declare class ManualDateProvider extends DateProvider {
+    private currentTimeMs;
+    /**
+     * @param initialTimeMs - Initial time in milliseconds. Defaults to a round timestamp for easy visualization.
+     */
+    constructor(initialTimeMs?: number);
+    now(): number;
+    /** Sets the current time to the given timestamp in milliseconds. */
+    setTime(timeMs: number): void;
+    /** Advances the time by the given number of seconds. */
+    advanceTime(seconds: number): void;
+    /** Advances the time by the given number of milliseconds. */
+    advanceTimeMs(ms: number): void;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0ZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3RpbWVyL2RhdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsZ0NBQWdDO0FBQ2hDLHFCQUFhLFlBQVk7SUFDaEIsR0FBRyxJQUFJLE1BQU0sQ0FFbkI7SUFFTSxZQUFZLElBQUksTUFBTSxDQUU1QjtJQUVNLFNBQVMsSUFBSSxJQUFJLENBRXZCO0NBQ0Y7QUFFRCwwREFBMEQ7QUFDMUQscUJBQWEsZ0JBQWlCLFNBQVEsWUFBWTtJQUdwQyxPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU07SUFGbkMsT0FBTyxDQUFDLE1BQU0sQ0FBSztJQUVuQixZQUE2QixNQUFNLHlDQUFnRCxFQUVsRjtJQUVlLEdBQUcsSUFBSSxNQUFNLENBRTVCO0lBRU0sT0FBTyxDQUFDLE1BQU0sRUFBRSxNQUFNLFFBRzVCO0lBRUQsc0RBQXNEO0lBQy9DLEtBQUssU0FHWDtJQUVELHdEQUF3RDtJQUNqRCxXQUFXLENBQUMsT0FBTyxFQUFFLE1BQU0sUUFFakM7Q0FDRjtBQUVEOzs7OztHQUtHO0FBQ0gscUJBQWEsa0JBQW1CLFNBQVEsWUFBWTtJQUNsRCxPQUFPLENBQUMsYUFBYSxDQUFTO0lBRTlCOztPQUVHO0lBQ0gsWUFBWSxhQUFhLEdBQUUsTUFBc0MsRUFHaEU7SUFFZSxHQUFHLElBQUksTUFBTSxDQUU1QjtJQUVELG9FQUFvRTtJQUM3RCxPQUFPLENBQUMsTUFBTSxFQUFFLE1BQU0sUUFFNUI7SUFFRCx3REFBd0Q7SUFDakQsV0FBVyxDQUFDLE9BQU8sRUFBRSxNQUFNLFFBRWpDO0lBRUQsNkRBQTZEO0lBQ3RELGFBQWEsQ0FBQyxFQUFFLEVBQUUsTUFBTSxRQUU5QjtDQUNGIn0=

package/dest/timer/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/timer/date.ts"],"names":[],"mappings":"AAEA,gCAAgC;AAChC,qBAAa,YAAY;IAChB,GAAG,IAAI,MAAM,CAEnB;IAEM,YAAY,IAAI,MAAM,CAE5B;IAEM,SAAS,IAAI,IAAI,CAEvB;CACF;AAED,0DAA0D;AAC1D,qBAAa,gBAAiB,SAAQ,YAAY;IAGpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,MAAM,CAAK;IAEnB,YAA6B,MAAM,yCAAgD,EAElF;IAEe,GAAG,IAAI,MAAM,CAE5B;IAEM,OAAO,CAAC,MAAM,EAAE,MAAM,QAG5B;IAED,sDAAsD;IAC/C,KAAK,SAGX;IAED,wDAAwD;IACjD,WAAW,CAAC,OAAO,EAAE,MAAM,QAEjC;CACF;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,aAAa,CAAS;IAE9B;;OAEG;IACH,YAAY,aAAa,GAAE,MAAsC,EAGhE;IAEe,GAAG,IAAI,MAAM,CAE5B;IAED,oEAAoE;IAC7D,OAAO,CAAC,MAAM,EAAE,MAAM,QAE5B;IAED,wDAAwD;IACjD,WAAW,CAAC,OAAO,EAAE,MAAM,QAEjC;IAED,6DAA6D;IACtD,aAAa,CAAC,EAAE,EAAE,MAAM,QAE9B;CACF"}

package/dest/timer/date.js

@@ -0,0 +1,62 @@
+import { createLogger } from '../log/pino-logger.js';
+/** Returns current datetime. */ export class DateProvider {
+    now() {
+        return Date.now();
+    }
+    nowInSeconds() {
+        return Math.floor(this.now() / 1000);
+    }
+    nowAsDate() {
+        return new Date(this.now());
+    }
+}
+/** Returns current datetime and allows to override it. */ export class TestDateProvider extends DateProvider {
+    logger;
+    offset;
+    constructor(logger = createLogger('foundation:test-date-provider')){
+        super(), this.logger = logger, this.offset = 0;
+    }
+    now() {
+        return Date.now() + this.offset;
+    }
+    setTime(timeMs) {
+        this.offset = timeMs - Date.now();
+        this.logger.warn(`Time set to ${new Date(timeMs).toISOString()}`, {
+            offset: this.offset,
+            timeMs
+        });
+    }
+    /** Resets the time back to real time (offset = 0). */ reset() {
+        this.offset = 0;
+        this.logger.warn('Time reset to real time');
+    }
+    /** Advances the time by the given number of seconds. */ advanceTime(seconds) {
+        this.offset += seconds * 1000;
+    }
+}
+/**
+ * A date provider for tests that only advances time via explicit advanceTime() calls.
+ * Unlike TestDateProvider, this does NOT track real time progression - time is completely
+ * frozen until explicitly advanced. This eliminates flakiness from tests taking
+ * varying amounts of real time to execute.
+ */ export class ManualDateProvider extends DateProvider {
+    currentTimeMs;
+    /**
+   * @param initialTimeMs - Initial time in milliseconds. Defaults to a round timestamp for easy visualization.
+   */ constructor(initialTimeMs = Date.UTC(2025, 0, 1, 0, 0, 0)){
+        super();
+        this.currentTimeMs = initialTimeMs;
+    }
+    now() {
+        return this.currentTimeMs;
+    }
+    /** Sets the current time to the given timestamp in milliseconds. */ setTime(timeMs) {
+        this.currentTimeMs = timeMs;
+    }
+    /** Advances the time by the given number of seconds. */ advanceTime(seconds) {
+        this.currentTimeMs += seconds * 1000;
+    }
+    /** Advances the time by the given number of milliseconds. */ advanceTimeMs(ms) {
+        this.currentTimeMs += ms;
+    }
+}

package/dest/timer/elapsed.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Measures the elapsed execution time of a function call or promise once it is awaited.
+ * @param fn - Function or promise.
+ * @returns The number of ms and the result.
+ */
+export declare function elapsed<T>(fn: Promise<T> | (() => T | Promise<T>)): Promise<[number, T]>;
+/**
+ * Measures the elapsed execution time of a synchronous function call once it is awaited.
+ * @param fn - Function.
+ * @returns The number of ms and the result.
+ */
+export declare function elapsedSync<T>(fn: () => T): [number, T];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZWxhcHNlZC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3RpbWVyL2VsYXBzZWQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUE7Ozs7R0FJRztBQUNILHdCQUFzQixPQUFPLENBQUMsQ0FBQyxFQUFFLEVBQUUsRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxPQUFPLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FJOUY7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQWdCLFdBQVcsQ0FBQyxDQUFDLEVBQUUsRUFBRSxFQUFFLE1BQU0sQ0FBQyxHQUFHLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUl2RCJ9

package/dest/timer/elapsed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elapsed.d.ts","sourceRoot":"","sources":["../../src/timer/elapsed.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAI9F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAIvD"}

package/dest/timer/elapsed.js

@@ -0,0 +1,25 @@
+import { Timer } from './timer.js';
+/**
+ * Measures the elapsed execution time of a function call or promise once it is awaited.
+ * @param fn - Function or promise.
+ * @returns The number of ms and the result.
+ */ export async function elapsed(fn) {
+    const timer = new Timer();
+    const result = await (typeof fn === 'function' ? fn() : fn);
+    return [
+        timer.ms(),
+        result
+    ];
+}
+/**
+ * Measures the elapsed execution time of a synchronous function call once it is awaited.
+ * @param fn - Function.
+ * @returns The number of ms and the result.
+ */ export function elapsedSync(fn) {
+    const timer = new Timer();
+    const result = fn();
+    return [
+        timer.ms(),
+        result
+    ];
+}

package/dest/timer/index.d.ts

@@ -0,0 +1,5 @@
+export * from './date.js';
+export { elapsed, elapsedSync } from './elapsed.js';
+export { TimeoutTask, execWithSignal, executeTimeout, timeoutPromise } from './timeout.js';
+export { Timer } from './timer.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90aW1lci9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLFdBQVcsQ0FBQztBQUMxQixPQUFPLEVBQUUsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUNwRCxPQUFPLEVBQUUsV0FBVyxFQUFFLGNBQWMsRUFBRSxjQUFjLEVBQUUsY0FBYyxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBQzNGLE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxZQUFZLENBQUMifQ==

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/timer/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dest/timer/index.js

@@ -0,0 +1,4 @@
+export * from './date.js';
+export { elapsed, elapsedSync } from './elapsed.js';
+export { TimeoutTask, execWithSignal, executeTimeout, timeoutPromise } from './timeout.js';
+export { Timer } from './timer.js';

package/dest/timer/timeout.d.ts

@@ -0,0 +1,56 @@
+/**
+ * TimeoutTask class creates an instance for managing and executing a given asynchronous function with a specified timeout duration.
+ * The task will be automatically interrupted if it exceeds the given timeout duration, and will throw a custom error message.
+ * Additional information such as execution time can be retrieved using getTime method after the task has been executed.
+ *
+ * @typeparam T - The return type of the asynchronous function to be executed.
+ */
+export declare class TimeoutTask<T> {
+    private fn;
+    private timeout;
+    private errorFn;
+    private onAbort?;
+    private totalTime;
+    private timeoutPromise;
+    constructor(fn: (signal: AbortSignal) => Promise<T>, timeout: number, errorFn: () => Error, onAbort?: (() => void) | undefined);
+    /**
+     * Executes the given function with a specified timeout.
+     * If the function takes longer than the timeout, it will be interrupted and an error will be thrown.
+     * The total execution time of the function will be stored in the totalTime property.
+     *
+     * @returns The result of the executed function if completed within the timeout.
+     * @throws An error with a message indicating the function was interrupted due to exceeding the specified timeout.
+     */
+    exec(): Promise<T>;
+    /**
+     * Returns the interrupt promise associated with the TimeoutTask instance.
+     * The interrupt promise is used internally to reject the task when a timeout occurs.
+     * This method can be helpful when debugging or tracking the state of the task.
+     *
+     * @returns The interrupt promise associated with the task.
+     */
+    getInterruptPromise(): Promise<never> | undefined;
+    /**
+     * Get the total time spent on the most recent execution of the wrapped function.
+     * This method provides the duration from the start to the end of the function execution, whether it completed or timed out.
+     *
+     * @returns The total time in milliseconds spent on the most recent function execution.
+     */
+    getTime(): number;
+}
+/**
+ * Executes a function with a timeout.
+ * @param fn - The function to execute, accepts AbortSignal and returns a Promise.
+ * @param timeout - The maximum time in milliseconds to allow the function to run.
+ * @param errorOrFnName - Optional function name or a function that returns an Error to throw if the timeout is reached.
+ * @param onAbort - Optional callback to execute when the task is aborted.
+ *
+ * @returns A Promise that resolves with the result of the function fn if it completes within the timeout
+ *
+ * */
+export declare function executeTimeout<T>(fn: (signal: AbortSignal) => Promise<T>, timeout: number, errorOrFnName?: string | (() => Error), onAbort?: () => void): Promise<T>;
+/** Executes a function until it completes or the given signal aborts. */
+export declare function execWithSignal<T>(fn: (signal: AbortSignal) => Promise<T>, signal: AbortSignal, errorFn?: (signal: AbortSignal) => Error): Promise<T>;
+/** Returns a promise that rejects after the given timeout */
+export declare function timeoutPromise(timeoutMs: number, errorMessage?: string): Promise<never>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGltZW91dC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3RpbWVyL3RpbWVvdXQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBR0E7Ozs7OztHQU1HO0FBQ0gscUJBQWEsV0FBVyxDQUFDLENBQUM7SUFLdEIsT0FBTyxDQUFDLEVBQUU7SUFDVixPQUFPLENBQUMsT0FBTztJQUNmLE9BQU8sQ0FBQyxPQUFPO0lBQ2YsT0FBTyxDQUFDLE9BQU8sQ0FBQztJQVBsQixPQUFPLENBQUMsU0FBUyxDQUFLO0lBQ3RCLE9BQU8sQ0FBQyxjQUFjLENBQTZCO0lBRW5ELFlBQ1UsRUFBRSxFQUFFLENBQUMsTUFBTSxFQUFFLFdBQVcsS0FBSyxPQUFPLENBQUMsQ0FBQyxDQUFDLEVBQ3ZDLE9BQU8sRUFBRSxNQUFNLEVBQ2YsT0FBTyxFQUFFLE1BQU0sS0FBSyxFQUNwQixPQUFPLENBQUMsMEJBQVksRUFDMUI7SUFFSjs7Ozs7OztPQU9HO0lBQ1UsSUFBSSxlQWlCaEI7SUFFRDs7Ozs7O09BTUc7SUFDSSxtQkFBbUIsK0JBRXpCO0lBRUQ7Ozs7O09BS0c7SUFDSSxPQUFPLFdBRWI7Q0FDRjtBQUVEOzs7Ozs7Ozs7S0FTSztBQUNMLHdCQUFzQixjQUFjLENBQUMsQ0FBQyxFQUNwQyxFQUFFLEVBQUUsQ0FBQyxNQUFNLEVBQUUsV0FBVyxLQUFLLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFDdkMsT0FBTyxFQUFFLE1BQU0sRUFDZixhQUFhLENBQUMsRUFBRSxNQUFNLEdBQUcsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUN0QyxPQUFPLENBQUMsRUFBRSxNQUFNLElBQUksY0FRckI7QUFVRCx5RUFBeUU7QUFDekUsd0JBQXNCLGNBQWMsQ0FBQyxDQUFDLEVBQ3BDLEVBQUUsRUFBRSxDQUFDLE1BQU0sRUFBRSxXQUFXLEtBQUssT0FBTyxDQUFDLENBQUMsQ0FBQyxFQUN2QyxNQUFNLEVBQUUsV0FBVyxFQUNuQixPQUFPLEdBQUUsQ0FBQyxNQUFNLEVBQUUsV0FBVyxLQUFLLEtBQTBCLGNBaUI3RDtBQUVELDZEQUE2RDtBQUM3RCx3QkFBZ0IsY0FBYyxDQUFDLFNBQVMsRUFBRSxNQUFNLEVBQUUsWUFBWSxDQUFDLEVBQUUsTUFBTSxrQkFTdEUifQ==

package/dest/timer/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/timer/timeout.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,qBAAa,WAAW,CAAC,CAAC;IAKtB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO,CAAC;IAPlB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,cAAc,CAA6B;IAEnD,YACU,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,KAAK,EACpB,OAAO,CAAC,0BAAY,EAC1B;IAEJ;;;;;;;OAOG;IACU,IAAI,eAiBhB;IAED;;;;;;OAMG;IACI,mBAAmB,+BAEzB;IAED;;;;;OAKG;IACI,OAAO,WAEb;CACF;AAED;;;;;;;;;KASK;AACL,wBAAsB,cAAc,CAAC,CAAC,EACpC,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM,IAAI,cAQrB;AAUD,yEAAyE;AACzE,wBAAsB,cAAc,CAAC,CAAC,EACpC,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,CAAC,MAAM,EAAE,WAAW,KAAK,KAA0B,cAiB7D;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,kBAStE"}

package/dest/timer/timeout.js

@@ -0,0 +1,113 @@
+import { TimeoutError } from '../error/index.js';
+import { promiseWithResolvers } from '../promise/utils.js';
+/**
+ * TimeoutTask class creates an instance for managing and executing a given asynchronous function with a specified timeout duration.
+ * The task will be automatically interrupted if it exceeds the given timeout duration, and will throw a custom error message.
+ * Additional information such as execution time can be retrieved using getTime method after the task has been executed.
+ *
+ * @typeparam T - The return type of the asynchronous function to be executed.
+ */ export class TimeoutTask {
+    fn;
+    timeout;
+    errorFn;
+    onAbort;
+    totalTime;
+    timeoutPromise;
+    constructor(fn, timeout, errorFn, onAbort){
+        this.fn = fn;
+        this.timeout = timeout;
+        this.errorFn = errorFn;
+        this.onAbort = onAbort;
+        this.totalTime = 0;
+    }
+    /**
+   * Executes the given function with a specified timeout.
+   * If the function takes longer than the timeout, it will be interrupted and an error will be thrown.
+   * The total execution time of the function will be stored in the totalTime property.
+   *
+   * @returns The result of the executed function if completed within the timeout.
+   * @throws An error with a message indicating the function was interrupted due to exceeding the specified timeout.
+   */ async exec() {
+        const signal = AbortSignal.timeout(this.timeout);
+        this.timeoutPromise = new Promise((_, reject)=>{
+            signal.addEventListener('abort', ()=>{
+                this.onAbort?.();
+                reject(this.errorFn());
+            }, {
+                once: true
+            });
+        });
+        const start = Date.now();
+        const result = await Promise.race([
+            this.fn(signal),
+            this.timeoutPromise
+        ]);
+        this.totalTime = Date.now() - start;
+        return result;
+    }
+    /**
+   * Returns the interrupt promise associated with the TimeoutTask instance.
+   * The interrupt promise is used internally to reject the task when a timeout occurs.
+   * This method can be helpful when debugging or tracking the state of the task.
+   *
+   * @returns The interrupt promise associated with the task.
+   */ getInterruptPromise() {
+        return this.timeoutPromise;
+    }
+    /**
+   * Get the total time spent on the most recent execution of the wrapped function.
+   * This method provides the duration from the start to the end of the function execution, whether it completed or timed out.
+   *
+   * @returns The total time in milliseconds spent on the most recent function execution.
+   */ getTime() {
+        return this.totalTime;
+    }
+}
+/**
+ * Executes a function with a timeout.
+ * @param fn - The function to execute, accepts AbortSignal and returns a Promise.
+ * @param timeout - The maximum time in milliseconds to allow the function to run.
+ * @param errorOrFnName - Optional function name or a function that returns an Error to throw if the timeout is reached.
+ * @param onAbort - Optional callback to execute when the task is aborted.
+ *
+ * @returns A Promise that resolves with the result of the function fn if it completes within the timeout
+ *
+ * */ export async function executeTimeout(fn, timeout, errorOrFnName, onAbort) {
+    const errorFn = typeof errorOrFnName === 'function' ? errorOrFnName : ()=>new TimeoutError(`Timeout running ${errorOrFnName ?? 'function'} after ${timeout}ms.`);
+    const task = new TimeoutTask(fn, timeout, errorFn, onAbort);
+    return await task.exec();
+}
+function defaultSignalError(signal) {
+    if (signal.reason instanceof Error) {
+        return signal.reason;
+    }
+    return new Error(signal.reason ? String(signal.reason) : 'Operation aborted');
+}
+/** Executes a function until it completes or the given signal aborts. */ export async function execWithSignal(fn, signal, errorFn = defaultSignalError) {
+    if (signal.aborted) {
+        throw errorFn(signal);
+    }
+    const abortPromise = promiseWithResolvers();
+    const abortListener = ()=>abortPromise.reject(errorFn(signal));
+    signal.addEventListener('abort', abortListener, {
+        once: true
+    });
+    try {
+        return await Promise.race([
+            fn(signal),
+            abortPromise.promise
+        ]);
+    } finally{
+        if (abortListener) {
+            signal.removeEventListener('abort', abortListener);
+        }
+    }
+}
+/** Returns a promise that rejects after the given timeout */ export function timeoutPromise(timeoutMs, errorMessage) {
+    const promise = promiseWithResolvers();
+    const timer = setTimeout(()=>{
+        promise.reject(new TimeoutError(errorMessage ?? `Operation timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+    const cleanup = ()=>clearTimeout(timer);
+    return promise.promise.finally(cleanup);
+}

package/dest/timer/timer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Timer class to measure time intervals in milliseconds and seconds.
+ * Upon instantiation, it stores the current timestamp as the starting point.
+ * The 'ms()' method returns the elapsed time in milliseconds,
+ * while the 's()' method returns the elapsed time in seconds.
+ *
+ * @example
+ * const timer = new Timer();
+ * setTimeout(() =\> \{
+ *   console.log(`Elapsed time: ${timer.ms()} ms`);
+ * \}, 1000);
+ */
+export declare class Timer {
+    private start;
+    constructor();
+    /**
+     * Return microseconds.
+     */
+    us(): number;
+    /**
+     * Returns the elapsed time in milliseconds since the Timer instance was created.
+     * Provides a simple and convenient way to measure the time duration between two events
+     * or monitor performance of specific code sections.
+     *
+     * @returns The elapsed time in milliseconds.
+     */
+    ms(): number;
+    /**
+     * Returns the time elapsed since the Timer instance was created, in seconds.
+     * The value is calculated by subtracting the initial start time from the current time
+     * and dividing the result by 1000 to convert milliseconds to seconds.
+     *
+     * @returns The elapsed time in seconds.
+     */
+    s(): number;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGltZXIuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90aW1lci90aW1lci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7R0FXRztBQUNILHFCQUFhLEtBQUs7SUFDaEIsT0FBTyxDQUFDLEtBQUssQ0FBUztJQUV0QixjQUVDO0lBRUQ7O09BRUc7SUFDSSxFQUFFLFdBRVI7SUFFRDs7Ozs7O09BTUc7SUFDSSxFQUFFLFdBRVI7SUFFRDs7Ozs7O09BTUc7SUFDSSxDQUFDLFdBRVA7Q0FDRiJ9

package/dest/timer/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../src/timer/timer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAAS;IAEtB,cAEC;IAED;;OAEG;IACI,EAAE,WAER;IAED;;;;;;OAMG;IACI,EAAE,WAER;IAED;;;;;;OAMG;IACI,CAAC,WAEP;CACF"}