@aztec/foundation 0.0.0-test.1 → 0.0.1-commit.b655e406

package/dest/serialize/buffer_reader.js

@@ -65,15 +65,47 @@
    * Assumes the number is stored in big-endian format.
    *
    * @returns The read 256 bit value as a bigint.
+   */ readUInt64() {
+        this.#rangeCheck(8);
+        const result = this.buffer.readBigUInt64BE(this.index);
+        this.index += 8;
+        return result;
+    }
+    /**
+   * Reads a 128-bit unsigned integer from the buffer at the current index position.
+   * Updates the index position by 16 bytes after reading the number.
+   *
+   * Assumes the number is stored in big-endian format.
+   *
+   * @returns The read 128 bit value as a bigint.
+   */ readUInt128() {
+        this.#rangeCheck(16);
+        let result = BigInt(0);
+        for(let i = 0; i < 2; i++){
+            result = result << BigInt(64) | this.buffer.readBigUInt64BE(this.index + i * 8);
+        }
+        this.index += 16;
+        return result;
+    }
+    /**
+   * Reads a 256-bit unsigned integer from the buffer at the current index position.
+   * Updates the index position by 32 bytes after reading the number.
+   *
+   * Assumes the number is stored in big-endian format.
+   *
+   * @returns The read 256 bit value as a bigint.
    */ readUInt256() {
         this.#rangeCheck(32);
         let result = BigInt(0);
-        for(let i = 0; i < 32; i++){
-            result = result << BigInt(8) | BigInt(this.buffer[this.index + i]);
+        for(let i = 0; i < 4; i++){
+            result = result << BigInt(64) | this.buffer.readBigUInt64BE(this.index + i * 8);
         }
         this.index += 32;
         return result;
     }
+    /** Alias for readUInt256 */ readBigInt() {
+        return this.readUInt256();
+    }
     /**
    * Reads a 16-bit unsigned integer from the buffer at the current index position.
    * Updates the index position by 2 bytes after reading the number.
@@ -133,6 +165,16 @@
         });
     }
     /**
+   * Reads a vector of 256-bit unsigned integers from the buffer and returns it as an array of bigints.
+   * The method utilizes the 'readVector' method, passing a deserializer that reads bigints.
+   *
+   * @returns An array of bigints representing the vector read from the buffer.
+   */ readUint256Vector() {
+        return this.readVector({
+            fromBuffer: (reader)=>reader.readUInt256()
+        });
+    }
+    /**
    * Reads a vector of fixed size from the buffer and deserializes its elements using the provided itemDeserializer object.
    * The 'itemDeserializer' object should have a 'fromBuffer' method that takes a BufferReader instance and returns the deserialized element.
    * The method first reads the size of the vector (a number) from the buffer, then iterates through its elements,

package/dest/serialize/field_reader.d.ts

@@ -11,7 +11,7 @@ import type { Tuple } from './types.js';
 export declare class FieldReader {
     private fields;
     private index;
-    private length;
+    private readonly length;
     constructor(fields: Fr[], offset?: number);
     /**
      * Creates a FieldReader instance from either a field array or an existing FieldReader.
@@ -26,6 +26,7 @@ export declare class FieldReader {
      * @returns The current cursor position.
      */
     get cursor(): number;
+    remainingFields(): number;
     /**
      * Skips the next n fields.
      *
@@ -67,6 +68,14 @@ export declare class FieldReader {
      * @returns The read 32-bit unsigned integer value.
      */
     readU32(): number;
+    /**
+     * Reads a 64-bit unsigned integer from the field array at the current index position.
+     * Updates the index position by 1 after reading the number.
+     * Throw if the value is greater than 2 ** 64.
+     *
+     * @returns The read 64-bit unsigned integer value as a bigint.
+     */
+    readU64(): bigint;
     /**
      * Read an array of a fixed size field array.
      *

package/dest/serialize/field_reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field_reader.d.ts","sourceRoot":"","sources":["../../src/serialize/field_reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,qBAAa,WAAW;IAGV,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;gBACH,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,SAAI;IAQ5C;;;;;OAKG;WACW,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,GAAG,WAAW;IAQ/D;;;;OAIG;IACH,IAAW,MAAM,WAEhB;IAED;;;;OAIG;IACI,IAAI,CAAC,CAAC,EAAE,MAAM;IAOrB;;;;OAIG;IACI,SAAS,IAAI,EAAE;IAOtB;;;;OAIG;IACI,SAAS,IAAI,EAAE;IAOtB;;;;OAIG;IACI,MAAM,IAAI,EAAE;IAInB;;;;;;;OAOG;IACI,WAAW,IAAI,OAAO;IAS7B;;;;;;OAMG;IACI,OAAO,IAAI,MAAM;IASxB;;;;;OAKG;IACI,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAQ9D;;;;;;;;;OASG;IACI,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAClC,IAAI,EAAE,CAAC,EACP,gBAAgB,EAAE;QAChB;;WAEG;QACH,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,CAAC;KACxC,GACA,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAKd;;;;;;OAMG;IACI,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE;QACjC;;WAEG;QACH,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,CAAC;KACxC,GAAG,CAAC;IAIL;;;OAGG;IACI,UAAU,IAAI,OAAO;CAG7B"}
+{"version":3,"file":"field_reader.d.ts","sourceRoot":"","sources":["../../src/serialize/field_reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGtB,MAAM,EAAE,EAAE,EAAE,EACpB,MAAM,SAAI;IASZ;;;;;OAKG;WACW,QAAQ,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,WAAW,GAAG,WAAW;IAQ/D;;;;OAIG;IACH,IAAW,MAAM,WAEhB;IAEM,eAAe,IAAI,MAAM;IAIhC;;;;OAIG;IACI,IAAI,CAAC,CAAC,EAAE,MAAM;IAOrB;;;;OAIG;IACI,SAAS,IAAI,EAAE;IAOtB;;;;OAIG;IACI,SAAS,IAAI,EAAE;IAOtB;;;;OAIG;IACI,MAAM,IAAI,EAAE;IAInB;;;;;;;OAOG;IACI,WAAW,IAAI,OAAO;IAS7B;;;;;;OAMG;IACI,OAAO,IAAI,MAAM;IASxB;;;;;;OAMG;IACI,OAAO,IAAI,MAAM;IASxB;;;;;OAKG;IACI,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAQ9D;;;;;;;;;OASG;IACI,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAClC,IAAI,EAAE,CAAC,EACP,gBAAgB,EAAE;QAChB;;WAEG;QACH,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,CAAC;KACxC,GACA,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAKd;;;;;;OAMG;IACI,UAAU,CAAC,CAAC,EAAE,YAAY,EAAE;QACjC;;WAEG;QACH,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,CAAC,CAAC;KACxC,GAAG,CAAC;IAIL;;;OAGG;IACI,UAAU,IAAI,OAAO;CAG7B"}

package/dest/serialize/field_reader.js

@@ -14,7 +14,7 @@ import { Fq } from '../fields/fields.js';
         this.fields = fields;
         this.index = offset;
         this.length = fields.length;
-        if (offset >= this.length) {
+        if (offset > this.length) {
             throw new Error('Offset out of bounds.');
         }
     }
@@ -36,6 +36,9 @@ import { Fq } from '../fields/fields.js';
    */ get cursor() {
         return this.index;
     }
+    remainingFields() {
+        return this.length - this.index;
+    }
     /**
    * Skips the next n fields.
    *
@@ -103,6 +106,20 @@ import { Fq } from '../fields/fields.js';
         return Number(value);
     }
     /**
+   * Reads a 64-bit unsigned integer from the field array at the current index position.
+   * Updates the index position by 1 after reading the number.
+   * Throw if the value is greater than 2 ** 64.
+   *
+   * @returns The read 64-bit unsigned integer value as a bigint.
+   */ readU64() {
+        const field = this.readField();
+        const value = field.toBigInt();
+        if (value >= 1n << 64n) {
+            throw new Error('Field is not a u64.');
+        }
+        return value;
+    }
+    /**
    * Read an array of a fixed size field array.
    *
    * @param size - The fixed number of fields in the array.

package/dest/serialize/free_funcs.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import { Fr } from '../fields/fields.js';
 import type { Tuple } from './types.js';
 /**
@@ -10,13 +8,13 @@ import type { Tuple } from './types.js';
  * @param b - The boolean value to be converted.
  * @returns A Buffer containing the byte representation of the input boolean value.
  */
-export declare function boolToByte(b: boolean): Buffer;
+export declare function boolToByte(b: boolean): Buffer<ArrayBuffer>;
 /**
  * @param n - The input number to be converted to a big-endian unsigned 16-bit integer Buffer.
  * @param bufferSize - Optional, the size of the output Buffer (default is 2).
  * @returns A Buffer containing the big-endian unsigned 16-bit integer representation of the input number.
  */
-export declare function numToUInt16BE(n: number, bufferSize?: number): Buffer;
+export declare function numToUInt16BE(n: number, bufferSize?: number): Buffer<ArrayBuffer>;
 /**
  * Convert a number into a 4-byte little-endian unsigned integer buffer.
  * The input number is serialized as an unsigned 32-bit integer in little-endian byte order,
@@ -27,7 +25,7 @@ export declare function numToUInt16BE(n: number, bufferSize?: number): Buffer;
  * @param bufferSize - Optional, the size of the output buffer (default value is 4).
  * @returns A Buffer containing the serialized little-endian unsigned integer representation of the input number.
  */
-export declare function numToUInt32LE(n: number, bufferSize?: number): Buffer;
+export declare function numToUInt32LE(n: number, bufferSize?: number): Buffer<ArrayBuffer>;
 /**
  * Convert a number to a big-endian unsigned 32-bit integer Buffer.
  * This function takes a number and an optional buffer size as input and creates a Buffer with the specified size (defaults to 4) containing the big-endian representation of the input number as an unsigned 32-bit integer. Note that the bufferSize should be greater than or equal to 4, otherwise the output Buffer might truncate the serialized value.
@@ -36,7 +34,23 @@ export declare function numToUInt32LE(n: number, bufferSize?: number): Buffer;
  * @param bufferSize - Optional, the size of the output Buffer (default is 4).
  * @returns A Buffer containing the big-endian unsigned 32-bit integer representation of the input number.
  */
-export declare function numToUInt32BE(n: number, bufferSize?: number): Buffer;
+export declare function numToUInt32BE(n: number, bufferSize?: number): Buffer<ArrayBuffer>;
+/**
+ * Convert a bigint to a big-endian unsigned 64-bit integer Buffer.
+ *
+ * @param n - The bigint to be converted to a big-endian unsigned 64-bit integer Buffer.
+ * @param bufferSize - Optional, the size of the output Buffer (default is 8).
+ * @returns A Buffer containing the big-endian unsigned 64-bit integer representation of the input number.
+ */
+export declare function bigintToUInt64BE(n: bigint, bufferSize?: number): Buffer<ArrayBuffer>;
+/**
+ * Convert a bigint to a big-endian unsigned 128-bit integer Buffer.
+ *
+ * @param n - The bigint to be converted to a big-endian unsigned 128-bit integer Buffer.
+ * @param bufferSize - Optional, the size of the output Buffer (default is 16).
+ * @returns A Buffer containing the big-endian unsigned 128-bit integer representation of the input number.
+ */
+export declare function bigintToUInt128BE(n: bigint, bufferSize?: number): Buffer<ArrayBufferLike>;
 /**
  * Serialize a number into a big-endian signed 32-bit integer Buffer with the specified buffer size.
  * This function converts the input number into its binary representation and stores it in a Buffer
@@ -48,7 +62,7 @@ export declare function numToUInt32BE(n: number, bufferSize?: number): Buffer;
  * @param bufferSize - Optional, the size of the output Buffer (default is 4 bytes).
  * @returns A Buffer containing the serialized big-endian signed 32-bit integer.
  */
-export declare function numToInt32BE(n: number, bufferSize?: number): Buffer;
+export declare function numToInt32BE(n: number, bufferSize?: number): Buffer<ArrayBuffer>;
 /**
  * Convert a number to an 8-bit unsigned integer and return it as a Buffer of length 1.
  * The input number is written as an 8-bit unsigned integer into the buffer. This function
@@ -58,13 +72,13 @@ export declare function numToInt32BE(n: number, bufferSize?: number): Buffer;
  * @param n - The number to be converted to an 8-bit unsigned integer.
  * @returns A Buffer containing the 8-bit unsigned integer representation of the input number.
  */
-export declare function numToUInt8(n: number): Buffer;
+export declare function numToUInt8(n: number): Buffer<ArrayBuffer>;
 /**
  * Adds a 4-byte byte-length prefix to a buffer.
  * @param buf - The input Buffer to be prefixed
  * @returns A Buffer with 4-byte byte-length prefix.
  */
-export declare function prefixBufferWithLength(buf: Buffer): Buffer;
+export declare function prefixBufferWithLength(buf: Buffer): Buffer<ArrayBuffer>;
 /**
  * Parse a buffer as a big integer.
  */
@@ -88,18 +102,6 @@ export declare function from2Fields(field1: Fr, field2: Fr): Buffer;
  * @returns 31 bytes of data padded to 32
  */
 export declare function truncateAndPad(buf: Buffer): Buffer;
-/**
- * Stores 248 bits of information in 1 field.
- * @param buf - 32 or 31 bytes of data
- * @returns 1 field element
- */
-export declare function toTruncField(buf: Buffer): Fr;
-/**
- * Reconstructs the original 31 bytes of data from 1 truncated field element.
- * @param field - field element
- * @returns 31 bytes of data as a Buffer
- */
-export declare function fromTruncField(field: Fr): Buffer;
 export declare function fromFieldsTuple(fields: Tuple<Fr, 2>): Buffer;
 export declare function toHumanReadable(buf: Buffer, maxLen?: number): string;
 //# sourceMappingURL=free_funcs.d.ts.map

package/dest/serialize/free_funcs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"free_funcs.d.ts","sourceRoot":"","sources":["../../src/serialize/free_funcs.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,UAIpC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAI,UAItD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAI,UAItD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAI,UAItD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAI,UAIrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,UAKnC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,UAIjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAU/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAW1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,CAW5C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,CAMhD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpE"}
+{"version":3,"file":"free_funcs.d.ts","sourceRoot":"","sources":["../../src/serialize/free_funcs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,uBAIpC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAI,uBAItD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAI,uBAItD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAI,uBAItD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAI,uBAIzD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAK,2BAE3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,SAAI,uBAIrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,uBAKnC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,uBAIjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAU/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAW1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpE"}

package/dest/serialize/free_funcs.js

@@ -1,3 +1,4 @@
+import { toBufferBE } from '../bigint-buffer/index.js';
 import { Fr } from '../fields/fields.js';
 /**
  * Convert a boolean value to its corresponding byte representation in a Buffer of size 1.
@@ -46,6 +47,26 @@ import { Fr } from '../fields/fields.js';
     buf.writeUInt32BE(n, bufferSize - 4);
     return buf;
 }
+/**
+ * Convert a bigint to a big-endian unsigned 64-bit integer Buffer.
+ *
+ * @param n - The bigint to be converted to a big-endian unsigned 64-bit integer Buffer.
+ * @param bufferSize - Optional, the size of the output Buffer (default is 8).
+ * @returns A Buffer containing the big-endian unsigned 64-bit integer representation of the input number.
+ */ export function bigintToUInt64BE(n, bufferSize = 8) {
+    const buf = Buffer.alloc(bufferSize);
+    buf.writeBigUInt64BE(n, bufferSize - 8);
+    return buf;
+}
+/**
+ * Convert a bigint to a big-endian unsigned 128-bit integer Buffer.
+ *
+ * @param n - The bigint to be converted to a big-endian unsigned 128-bit integer Buffer.
+ * @param bufferSize - Optional, the size of the output Buffer (default is 16).
+ * @returns A Buffer containing the big-endian unsigned 128-bit integer representation of the input number.
+ */ export function bigintToUInt128BE(n, bufferSize = 16) {
+    return toBufferBE(n, bufferSize);
+}
 /**
  * Serialize a number into a big-endian signed 32-bit integer Buffer with the specified buffer size.
  * This function converts the input number into its binary representation and stores it in a Buffer
@@ -150,33 +171,6 @@ import { Fr } from '../fields/fields.js';
         buf.subarray(0, 31)
     ]);
 }
-/**
- * Stores 248 bits of information in 1 field.
- * @param buf - 32 or 31 bytes of data
- * @returns 1 field element
- */ export function toTruncField(buf) {
-    if (buf.length !== 32 && buf.length !== 31) {
-        throw new Error('Buffer must be 31 or 32 bytes');
-    }
-    if (buf.length == 32 && buf[0] == 0 || buf.length == 31) {
-        return Fr.fromBuffer(buf);
-    } else {
-        // Note: safer to NOT truncate here, all inputs are expected to be truncated
-        // from Noir or L1 Contracts or Class.hash() methods
-        throw new Error(`Number ${toBigInt(buf)} does not fit in 31 byte truncated buffer`);
-    }
-}
-/**
- * Reconstructs the original 31 bytes of data from 1 truncated field element.
- * @param field - field element
- * @returns 31 bytes of data as a Buffer
- */ export function fromTruncField(field) {
-    const buffer = field.toBuffer();
-    if (buffer[0] != 0) {
-        throw new Error(`Number ${field} does not fit in 31 byte truncated buffer`);
-    }
-    return buffer;
-}
 export function fromFieldsTuple(fields) {
     return from2Fields(fields[0], fields[1]);
 }

package/dest/serialize/serialize.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 import { Fr } from '../fields/fields.js';
 /**
  * For serializing an array of fixed length buffers.
@@ -57,7 +55,7 @@ export declare function boolToBuffer(value: boolean, bufferSize?: number): Buffe
  * @returns The deserialized 256-bit field.
  */
 export declare function deserializeField(buf: Buffer, offset?: number): {
-    elem: Buffer;
+    elem: Buffer<ArrayBuffer>;
     adv: number;
 };
 /** A type that can be written to a buffer. */
@@ -81,6 +79,7 @@ export type Fieldable = Fr | boolean | number | bigint | Buffer | {
     /** Serialize to an array of fields. */
     toFields: () => Fr[];
 } | Fieldable[];
+export type Serializable = Bufferable & Fieldable;
 /**
  * Serializes a list of objects contiguously.
  * @param objs - Objects to serialize.
@@ -115,7 +114,7 @@ export declare function toFriendlyJSON(obj: object): string;
  * @param width - The width (in bytes) of the output Buffer, optional with default value 32.
  * @returns A Buffer containing the serialized BigInt value in big-endian format.
  */
-export declare function serializeBigInt(n: bigint, width?: number): Buffer;
+export declare function serializeBigInt(n: bigint, width?: number): Buffer<ArrayBufferLike>;
 /**
  * Deserialize a big integer from a buffer, given an offset and width.
  * Reads the specified number of bytes from the buffer starting at the offset, converts it to a big integer, and returns the deserialized result along with the number of bytes read (advanced).
@@ -137,7 +136,7 @@ export declare function deserializeBigInt(buf: Buffer, offset?: number, width?:
  * @param date - The Date object to be serialized.
  * @returns A Buffer containing the serialized timestamp of the input Date object.
  */
-export declare function serializeDate(date: Date): Buffer;
+export declare function serializeDate(date: Date): Buffer<ArrayBufferLike>;
 /**
  * Deserialize a boolean value from a given buffer at the specified offset.
  * Reads a single byte at the provided offset in the buffer and returns

package/dest/serialize/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/serialize/serialize.ts"],"names":[],"mappings":";;AACA,OAAO,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAGzC;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,YAAY,SAAI,GAAG,MAAM,CAa/F;AAED;;GAEG;AACH,KAAK,aAAa,CAAC,CAAC,IAAI,CACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,KACX;IACH;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IACR;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,SAAI,GACT;IACD;;OAEG;IACH,IAAI,EAAE,CAAC,EAAE,CAAC;IACV;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAWA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,SAAI,GAAG,MAAM,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI;;;EAGvD;AAED,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,GACN;IACE;;OAEG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB,GACD,UAAU,EAAE,CAAC;AAEjB,gEAAgE;AAChE,MAAM,MAAM,SAAS,GACjB,EAAE,GACF,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN;IACE;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GACD;IACE,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GACD;IACE,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;CACtB,GACD,SAAS,EAAE,CAAC;AAEhB;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CA4BtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAsB5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4BlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,UAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAK;;;EAEpE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,UAEvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI;;;EAGtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI;;;EAGxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI;;;EAGvD"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/serialize/serialize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAGzC;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,YAAY,SAAI,GAAG,MAAM,CAa/F;AAED;;GAEG;AACH,KAAK,aAAa,CAAC,CAAC,IAAI,CACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,KACX;IACH;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IACR;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,SAAI,GACT;IACD;;OAEG;IACH,IAAI,EAAE,CAAC,EAAE,CAAC;IACV;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAWA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,SAAI,GAAG,MAAM,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI;;;EAGvD;AAED,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,GACN;IACE;;OAEG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB,GACD,UAAU,EAAE,CAAC;AAEjB,gEAAgE;AAChE,MAAM,MAAM,SAAS,GACjB,EAAE,GACF,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN;IACE;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GACD;IACE,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GACD;IACE,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;CACtB,GACD,SAAS,EAAE,CAAC;AAEhB,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CA4BtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAsB5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4BlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,2BAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAK;;;EAEpE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,2BAEvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI;;;EAGtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI;;;EAGxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAI;;;EAGvD"}

package/dest/string/index.d.ts

@@ -1,11 +1,16 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
+/** Parameterized hex string type for specific byte lengths */
+export type Hex<TByteLength extends number> = `0x${string}` & {
+    readonly _length: TByteLength;
+};
 export declare function hasHexPrefix(str: string): str is `0x${string}`;
 export declare function withoutHexPrefix(str: string): string;
+export declare function withHexPrefix(str: string): `0x${string}`;
 export declare function isHex(str: string): boolean;
 export declare function hexToBuffer(str: string): Buffer;
 export declare function bufferToHex(buffer: Buffer): `0x${string}`;
 export declare function pluralize(str: string, count: number | bigint, plural?: string): string;
 export declare function count(count: number | bigint, str: string, plural?: string): string;
 export declare function truncate(str: string, length?: number): string;
+export declare function isoDate(date?: Date): string;
+export declare function urlJoin(...args: string[]): string;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":";;AAAA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,KAAK,MAAM,EAAE,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAEzD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,CAEjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,MAAM,GAAG,CAAC,WAAW,SAAS,MAAM,IAAI,KAAK,MAAM,EAAE,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAEhG,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,KAAK,MAAM,EAAE,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAExD;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAEzD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,CAEjE;AAED,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,UAElC;AAED,wBAAgB,OAAO,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAsBjD"}

package/dest/string/index.js

@@ -1,9 +1,12 @@
-export function hasHexPrefix(str) {
+/** Parameterized hex string type for specific byte lengths */ export function hasHexPrefix(str) {
     return str.startsWith('0x');
 }
 export function withoutHexPrefix(str) {
     return hasHexPrefix(str) ? str.slice(2) : str;
 }
+export function withHexPrefix(str) {
+    return hasHexPrefix(str) ? str : `0x${str}`;
+}
 export function isHex(str) {
     return /^(0x)?[0-9a-fA-F]*$/.test(str);
 }
@@ -22,3 +25,26 @@ export function count(count, str, plural) {
 export function truncate(str, length = 64) {
     return str.length > length ? str.slice(0, length) + '...' : str;
 }
+export function isoDate(date) {
+    return (date ?? new Date()).toISOString().replace(/[-:T]/g, '').replace(/\..+$/, '');
+}
+export function urlJoin(...args) {
+    const processed = [];
+    for (const arg of args){
+        if (arg.length === 0) {
+            continue;
+        }
+        let start = 0;
+        let end = arg.length - 1;
+        while(start <= end && arg[start] === '/'){
+            start++;
+        }
+        while(end >= start && arg[end] === '/'){
+            end--;
+        }
+        if (start < end) {
+            processed.push(arg.slice(start, end + 1));
+        }
+    }
+    return processed.join('/');
+}

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

@@ -1,5 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
 /** Writes the contents specified to the target file if test data generation is enabled. */
 export declare function writeTestData(targetFileFromRepoRoot: string, contents: string | Buffer, raw?: boolean): void;
 export declare function readTestData(repoPath: string): Buffer;

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

@@ -1 +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,QAenG;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAMnF"}
+{"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;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAMnF"}

package/dest/testing/files/index.js

@@ -29,11 +29,11 @@ export function readTestData(repoPath) {
     const logger = createConsoleLogger('aztec:testing:test_data');
     const targetFile = getPathToFile(targetFileFromRepoRoot);
     const contents = readFileSync(targetFile, 'utf8').toString();
-    const regex = new RegExp(`let ${itemName} =[\\s\\S]*?;`, 'g');
+    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.replaceAll(regex, `let ${itemName} = ${value};`);
+    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}`);
 }

package/dest/testing/formatting.d.ts

@@ -0,0 +1,4 @@
+export declare function toInlineStrArray(arr: {
+    toString: () => string;
+}[]): string;
+//# sourceMappingURL=formatting.d.ts.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}
+{"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

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

package/dest/timer/date.d.ts

@@ -1,9 +1,10 @@
 /** Returns current datetime. */
 export declare class DateProvider {
     now(): number;
+    nowInSeconds(): number;
 }
 /** Returns current datetime and allows to override it. */
-export declare class TestDateProvider implements DateProvider {
+export declare class TestDateProvider extends DateProvider {
     private readonly logger;
     private offset;
     constructor(logger?: import("../log/pino-logger.js").Logger);

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

@@ -1 +1 @@
-{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/timer/date.ts"],"names":[],"mappings":"AAEA,gCAAgC;AAChC,qBAAa,YAAY;IAChB,GAAG,IAAI,MAAM;CAGrB;AAED,0DAA0D;AAC1D,qBAAa,gBAAiB,YAAW,YAAY;IAGvC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,MAAM,CAAK;gBAEU,MAAM,yCAAgD;IAE5E,GAAG,IAAI,MAAM;IAIb,OAAO,CAAC,MAAM,EAAE,MAAM;CAI9B"}
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/timer/date.ts"],"names":[],"mappings":"AAEA,gCAAgC;AAChC,qBAAa,YAAY;IAChB,GAAG,IAAI,MAAM;IAIb,YAAY,IAAI,MAAM;CAG9B;AAED,0DAA0D;AAC1D,qBAAa,gBAAiB,SAAQ,YAAY;IAGpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,MAAM,CAAK;gBAEU,MAAM,yCAAgD;IAInE,GAAG,IAAI,MAAM;IAItB,OAAO,CAAC,MAAM,EAAE,MAAM;CAI9B"}

package/dest/timer/date.js

@@ -3,13 +3,15 @@ import { createLogger } from '../log/pino-logger.js';
     now() {
         return Date.now();
     }
+    nowInSeconds() {
+        return Math.floor(this.now() / 1000);
+    }
 }
-/** Returns current datetime and allows to override it. */ export class TestDateProvider {
+/** Returns current datetime and allows to override it. */ export class TestDateProvider extends DateProvider {
     logger;
     offset;
     constructor(logger = createLogger('foundation:test-date-provider')){
-        this.logger = logger;
-        this.offset = 0;
+        super(), this.logger = logger, this.offset = 0;
     }
     now() {
         return Date.now() + this.offset;

package/dest/timer/index.d.ts

@@ -1,5 +1,5 @@
 export * from './date.js';
 export { elapsed, elapsedSync } from './elapsed.js';
-export { TimeoutTask, executeTimeout } from './timeout.js';
+export { TimeoutTask, executeTimeout, timeoutPromise } from './timeout.js';
 export { Timer } from './timer.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"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,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dest/timer/index.js

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

package/dest/timer/timeout.d.ts

@@ -8,10 +8,11 @@
 export declare class TimeoutTask<T> {
     private fn;
     private timeout;
-    private interruptPromise;
-    private interrupt;
+    private errorFn;
+    private onAbort?;
     private totalTime;
-    constructor(fn: () => Promise<T>, timeout: number, errorFn: () => any);
+    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.
@@ -28,7 +29,7 @@ export declare class TimeoutTask<T> {
      *
      * @returns The interrupt promise associated with the task.
      */
-    getInterruptPromise(): Promise<any>;
+    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.
@@ -37,5 +38,17 @@ export declare class TimeoutTask<T> {
      */
     getTime(): number;
 }
-export declare function executeTimeout<T>(fn: () => Promise<T>, timeout: number, errorOrFnName?: string | (() => any)): Promise<T>;
+/**
+ * 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>;
+/** Returns a promise that rejects after the given timeout */
+export declare function timeoutPromise(timeoutMs: number, errorMessage?: string): Promise<never>;
 //# sourceMappingURL=timeout.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/timer/timeout.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,qBAAa,WAAW,CAAC,CAAC;IAKZ,OAAO,CAAC,EAAE;IAAoB,OAAO,CAAC,OAAO;IAJzD,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAK;gBAEF,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAU,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAMrF;;;;;;;OAOG;IACU,IAAI;IAYjB;;;;;;OAMG;IACI,mBAAmB;IAI1B;;;;;OAKG;IACI,OAAO;CAGf;AAED,wBAAsB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,cAOlH"}
+{"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;gBAGzC,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,KAAK,EACpB,OAAO,CAAC,GAAE,MAAM,IAAI,aAAA;IAG9B;;;;;;;OAOG;IACU,IAAI;IAmBjB;;;;;;OAMG;IACI,mBAAmB;IAI1B;;;;;OAKG;IACI,OAAO;CAGf;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;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,kBAStE"}