@atomicfinance/types 4.2.8 → 4.3.1

package/.yalc/@node-dlc/messaging/dist/serialize/F64.d.ts

@@ -0,0 +1,146 @@
+/// <reference types="node" />
+import Decimal from 'decimal.js';
+/**
+ * IEEE 754 double-precision floating-point number implementation
+ *
+ * Format: 1 bit sign + 11 bits exponent + 52 bits mantissa
+ *
+ * This class works directly with the binary representation to avoid
+ * precision loss when serializing/deserializing f64 values to/from buffers.
+ */
+export declare class F64 {
+    private _buffer;
+    /**
+     * Create an F64 from raw bytes (IEEE 754 format)
+     */
+    constructor(buffer?: Buffer);
+    /**
+     * Create F64 from JavaScript number
+     */
+    static fromNumber(num: number): F64;
+    /**
+     * Create F64 from Decimal.js value
+     * Uses the most precise conversion possible
+     */
+    static fromDecimal(decimal: Decimal): F64;
+    /**
+     * Create F64 from string representation
+     * Uses Decimal.js to parse the string without precision loss from JavaScript Number
+     */
+    static fromString(str: string): F64;
+    /**
+     * Create F64 from bigint (treating as integer value)
+     */
+    static fromBigInt(bigint: bigint): F64;
+    /**
+     * Create F64 representing zero (static method for API compatibility)
+     */
+    static zero(): F64;
+    /**
+     * Create F64 with specific IEEE 754 components
+     */
+    static fromComponents(sign: boolean, exponent: number, mantissa: bigint): F64;
+    /**
+     * Get the raw buffer containing IEEE 754 representation
+     */
+    getBuffer(): Buffer;
+    /**
+     * Serialize to buffer (big-endian)
+     */
+    serialize(): Buffer;
+    /**
+     * Deserialize from buffer (big-endian)
+     */
+    static deserialize(buffer: Buffer): F64;
+    /**
+     * Convert to JavaScript number
+     * This may lose precision for very large or very precise values
+     */
+    toNumber(): number;
+    /**
+     * Convert to Decimal.js for arbitrary precision
+     */
+    toDecimal(): Decimal;
+    /**
+     * Extract IEEE 754 components
+     */
+    getComponents(): {
+        sign: boolean;
+        exponent: number;
+        mantissa: bigint;
+    };
+    /**
+     * Check if the value is finite
+     */
+    isFinite(): boolean;
+    /**
+     * Check if the value is NaN
+     */
+    isNaN(): boolean;
+    /**
+     * Check if the value is infinite
+     */
+    isInfinite(): boolean;
+    /**
+     * Check if the value is zero
+     */
+    isZero(): boolean;
+    /**
+     * Get string representation
+     */
+    toString(): string;
+    /**
+     * Convert to JSON-safe value: number if within safe range, string if too large
+     * This preserves precision for very large numbers that exceed JavaScript's MAX_SAFE_INTEGER
+     */
+    toJSONValue(): number | string;
+    /**
+     * Create F64 from JSON value (handles both number and string inputs)
+     */
+    static fromJSONValue(value: number | string): F64;
+    /**
+     * Get hex representation of the raw bytes
+     */
+    toHex(): string;
+    /**
+     * Create F64 from hex string
+     */
+    static fromHex(hex: string): F64;
+    /**
+     * Compare with another F64
+     */
+    equals(other: F64): boolean;
+    /**
+     * Equality comparison (alias for equals, for API compatibility)
+     */
+    eq(other: F64 | number): boolean;
+    /**
+     * Greater than comparison
+     */
+    gt(other: F64 | number): boolean;
+    /**
+     * Less than comparison
+     */
+    lt(other: F64 | number): boolean;
+    /**
+     * Greater than or equal comparison
+     */
+    gte(other: F64 | number): boolean;
+    /**
+     * Less than or equal comparison
+     */
+    lte(other: F64 | number): boolean;
+    /**
+     * Create a copy
+     */
+    clone(): F64;
+    /**
+     * Constants
+     */
+    static get ZERO(): F64;
+    static get ONE(): F64;
+    static get NEGATIVE_ONE(): F64;
+    static get INFINITY(): F64;
+    static get NEGATIVE_INFINITY(): F64;
+    static get NaN(): F64;
+}

package/.yalc/@node-dlc/messaging/dist/serialize/F64.js

@@ -0,0 +1,294 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.F64 = void 0;
+const decimal_js_1 = __importDefault(require("decimal.js"));
+/**
+ * IEEE 754 double-precision floating-point number implementation
+ *
+ * Format: 1 bit sign + 11 bits exponent + 52 bits mantissa
+ *
+ * This class works directly with the binary representation to avoid
+ * precision loss when serializing/deserializing f64 values to/from buffers.
+ */
+class F64 {
+    /**
+     * Create an F64 from raw bytes (IEEE 754 format)
+     */
+    constructor(buffer) {
+        if (buffer) {
+            if (buffer.length !== 8) {
+                throw new Error('F64 buffer must be exactly 8 bytes');
+            }
+            this._buffer = Buffer.from(buffer);
+        }
+        else {
+            this._buffer = Buffer.alloc(8);
+        }
+    }
+    /**
+     * Create F64 from JavaScript number
+     */
+    static fromNumber(num) {
+        const buffer = Buffer.alloc(8);
+        buffer.writeDoubleBE(num, 0);
+        return new F64(buffer);
+    }
+    /**
+     * Create F64 from Decimal.js value
+     * Uses the most precise conversion possible
+     */
+    static fromDecimal(decimal) {
+        // Convert to number and let IEEE 754 handle the precision
+        const num = decimal.toNumber();
+        return F64.fromNumber(num);
+    }
+    /**
+     * Create F64 from string representation
+     * Uses Decimal.js to parse the string without precision loss from JavaScript Number
+     */
+    static fromString(str) {
+        // Parse string using Decimal.js to avoid JavaScript Number precision loss
+        const decimal = new decimal_js_1.default(str);
+        return F64.fromDecimal(decimal);
+    }
+    /**
+     * Create F64 from bigint (treating as integer value)
+     */
+    static fromBigInt(bigint) {
+        const num = Number(bigint);
+        return F64.fromNumber(num);
+    }
+    /**
+     * Create F64 representing zero (static method for API compatibility)
+     */
+    static zero() {
+        return F64.fromNumber(0);
+    }
+    /**
+     * Create F64 with specific IEEE 754 components
+     */
+    static fromComponents(sign, exponent, mantissa) {
+        if (exponent < 0 || exponent > 2047) {
+            throw new Error('Exponent must be between 0 and 2047');
+        }
+        if (mantissa < BigInt(0) || mantissa >= BigInt(1) << BigInt(52)) {
+            throw new Error('Mantissa must be between 0 and 2^52-1');
+        }
+        const buffer = Buffer.alloc(8);
+        // Pack into 64-bit big-endian format
+        // Bit layout: SEEEEEEE EEEEMMMM MMMMMMMM MMMMMMMM MMMMMMMM MMMMMMMM MMMMMMMM MMMMMMMM
+        const signBit = sign ? BigInt(1) : BigInt(0);
+        const expBits = BigInt(exponent);
+        const mantissaBits = mantissa;
+        const ieee754Bits = (signBit << BigInt(63)) | (expBits << BigInt(52)) | mantissaBits;
+        // Write as big-endian bytes
+        for (let i = 0; i < 8; i++) {
+            const byteValue = Number((ieee754Bits >> BigInt(56 - i * 8)) & BigInt(0xff));
+            buffer.writeUInt8(byteValue, i);
+        }
+        return new F64(buffer);
+    }
+    /**
+     * Get the raw buffer containing IEEE 754 representation
+     */
+    getBuffer() {
+        return Buffer.from(this._buffer);
+    }
+    /**
+     * Serialize to buffer (big-endian)
+     */
+    serialize() {
+        return this.getBuffer();
+    }
+    /**
+     * Deserialize from buffer (big-endian)
+     */
+    static deserialize(buffer) {
+        return new F64(buffer);
+    }
+    /**
+     * Convert to JavaScript number
+     * This may lose precision for very large or very precise values
+     */
+    toNumber() {
+        return this._buffer.readDoubleBE(0);
+    }
+    /**
+     * Convert to Decimal.js for arbitrary precision
+     */
+    toDecimal() {
+        return new decimal_js_1.default(this.toNumber());
+    }
+    /**
+     * Extract IEEE 754 components
+     */
+    getComponents() {
+        // Read as big-endian 64-bit integer
+        let ieee754Bits = BigInt(0);
+        for (let i = 0; i < 8; i++) {
+            ieee754Bits =
+                (ieee754Bits << BigInt(8)) | BigInt(this._buffer.readUInt8(i));
+        }
+        const sign = (ieee754Bits & (BigInt(1) << BigInt(63))) !== BigInt(0);
+        const exponent = Number((ieee754Bits >> BigInt(52)) & BigInt(0x7ff));
+        const mantissa = ieee754Bits & ((BigInt(1) << BigInt(52)) - BigInt(1));
+        return { sign, exponent, mantissa };
+    }
+    /**
+     * Check if the value is finite
+     */
+    isFinite() {
+        const { exponent } = this.getComponents();
+        return exponent !== 2047; // NaN and Infinity have exponent = 2047
+    }
+    /**
+     * Check if the value is NaN
+     */
+    isNaN() {
+        const { exponent, mantissa } = this.getComponents();
+        return exponent === 2047 && mantissa !== BigInt(0);
+    }
+    /**
+     * Check if the value is infinite
+     */
+    isInfinite() {
+        const { exponent, mantissa } = this.getComponents();
+        return exponent === 2047 && mantissa === BigInt(0);
+    }
+    /**
+     * Check if the value is zero
+     */
+    isZero() {
+        const { exponent, mantissa } = this.getComponents();
+        return exponent === 0 && mantissa === BigInt(0);
+    }
+    /**
+     * Get string representation
+     */
+    toString() {
+        return this.toNumber().toString();
+    }
+    /**
+     * Convert to JSON-safe value: number if within safe range, string if too large
+     * This preserves precision for very large numbers that exceed JavaScript's MAX_SAFE_INTEGER
+     */
+    toJSONValue() {
+        const num = this.toNumber();
+        // Check if the number is within JavaScript's safe integer range
+        if (num <= Number.MAX_SAFE_INTEGER && num >= Number.MIN_SAFE_INTEGER) {
+            return num;
+        }
+        // For very large numbers, return as string to preserve precision
+        return num.toString();
+    }
+    /**
+     * Create F64 from JSON value (handles both number and string inputs)
+     */
+    static fromJSONValue(value) {
+        if (typeof value === 'string') {
+            return F64.fromString(value);
+        }
+        else {
+            return F64.fromNumber(value);
+        }
+    }
+    /**
+     * Get hex representation of the raw bytes
+     */
+    toHex() {
+        return this._buffer.toString('hex');
+    }
+    /**
+     * Create F64 from hex string
+     */
+    static fromHex(hex) {
+        const buffer = Buffer.from(hex, 'hex');
+        if (buffer.length !== 8) {
+            throw new Error('Hex string must represent exactly 8 bytes');
+        }
+        return new F64(buffer);
+    }
+    /**
+     * Compare with another F64
+     */
+    equals(other) {
+        return this._buffer.equals(other._buffer);
+    }
+    /**
+     * Equality comparison (alias for equals, for API compatibility)
+     */
+    eq(other) {
+        if (typeof other === 'number') {
+            return this.toNumber() === other;
+        }
+        return this.equals(other);
+    }
+    /**
+     * Greater than comparison
+     */
+    gt(other) {
+        if (typeof other === 'number') {
+            return this.toNumber() > other;
+        }
+        return this.toNumber() > other.toNumber();
+    }
+    /**
+     * Less than comparison
+     */
+    lt(other) {
+        if (typeof other === 'number') {
+            return this.toNumber() < other;
+        }
+        return this.toNumber() < other.toNumber();
+    }
+    /**
+     * Greater than or equal comparison
+     */
+    gte(other) {
+        if (typeof other === 'number') {
+            return this.toNumber() >= other;
+        }
+        return this.toNumber() >= other.toNumber();
+    }
+    /**
+     * Less than or equal comparison
+     */
+    lte(other) {
+        if (typeof other === 'number') {
+            return this.toNumber() <= other;
+        }
+        return this.toNumber() <= other.toNumber();
+    }
+    /**
+     * Create a copy
+     */
+    clone() {
+        return new F64(this._buffer);
+    }
+    /**
+     * Constants
+     */
+    static get ZERO() {
+        return F64.fromNumber(0);
+    }
+    static get ONE() {
+        return F64.fromNumber(1);
+    }
+    static get NEGATIVE_ONE() {
+        return F64.fromNumber(-1);
+    }
+    static get INFINITY() {
+        return F64.fromNumber(Number.POSITIVE_INFINITY);
+    }
+    static get NEGATIVE_INFINITY() {
+        return F64.fromNumber(Number.NEGATIVE_INFINITY);
+    }
+    static get NaN() {
+        return F64.fromNumber(Number.NaN);
+    }
+}
+exports.F64 = F64;
+//# sourceMappingURL=F64.js.map

package/.yalc/@node-dlc/messaging/dist/serialize/F64.js.map

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

package/.yalc/@node-dlc/messaging/dist/serialize/deserializeTlv.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="node" />
+import { BufferReader } from '@node-dlc/bufio';
+export declare function deserializeTlv(reader: BufferReader): ITlv;
+interface ITlv {
+    type: bigint;
+    length: bigint;
+    body: Buffer;
+}
+export {};

package/.yalc/@node-dlc/messaging/dist/serialize/deserializeTlv.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deserializeTlv = void 0;
+function deserializeTlv(reader) {
+    const type = reader.readBigSize();
+    const length = reader.readBigSize();
+    const body = reader.readBytes(Number(length));
+    return { type, length, body };
+}
+exports.deserializeTlv = deserializeTlv;
+//# sourceMappingURL=deserializeTlv.js.map

package/.yalc/@node-dlc/messaging/dist/serialize/deserializeTlv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializeTlv.js","sourceRoot":"","sources":["../../lib/serialize/deserializeTlv.ts"],"names":[],"mappings":";;;AAEA,SAAgB,cAAc,CAAC,MAAoB;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAND,wCAMC"}

package/.yalc/@node-dlc/messaging/dist/serialize/getTlv.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="node" />
+import { BufferReader } from '@node-dlc/bufio';
+export declare function getTlv(reader: BufferReader): Buffer;
+export declare function skipTlv(reader: BufferReader): void;

package/.yalc/@node-dlc/messaging/dist/serialize/getTlv.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skipTlv = exports.getTlv = void 0;
+const bufio_1 = require("@node-dlc/bufio");
+// TODO: add unit tests
+function getTlv(reader) {
+    const type = reader.readBigSize();
+    const length = reader.readBigSize();
+    const body = reader.readBytes(Number(length));
+    const writer = new bufio_1.BufferWriter();
+    writer.writeBigSize(type);
+    writer.writeBigSize(length);
+    writer.writeBytes(body);
+    return writer.toBuffer();
+}
+exports.getTlv = getTlv;
+function skipTlv(reader) {
+    reader.readBigSize();
+    const length = reader.readBigSize();
+    reader.readBytes(Number(length));
+}
+exports.skipTlv = skipTlv;
+//# sourceMappingURL=getTlv.js.map

package/.yalc/@node-dlc/messaging/dist/serialize/getTlv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTlv.js","sourceRoot":"","sources":["../../lib/serialize/getTlv.ts"],"names":[],"mappings":";;;AAAA,2CAA6D;AAE7D,uBAAuB;AACvB,SAAgB,MAAM,CAAC,MAAoB;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,IAAI,oBAAY,EAAE,CAAC;IAClC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAXD,wBAWC;AAED,SAAgB,OAAO,CAAC,MAAoB;IAC1C,MAAM,CAAC,WAAW,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACnC,CAAC;AAJD,0BAIC"}

package/.yalc/@node-dlc/messaging/dist/serialize/readTlvs.d.ts

@@ -0,0 +1,8 @@
+import { BufferReader } from '@node-dlc/bufio';
+/**
+ * Reads TLVs from a reader until the entire stream is processed. The handler is
+ * responsible for doing something with the data bytes.
+ * @param reader
+ * @param handler
+ */
+export declare function readTlvs(reader: BufferReader, handler: (type: bigint, value: BufferReader) => boolean): void;

package/.yalc/@node-dlc/messaging/dist/serialize/readTlvs.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTlvs = void 0;
+const bufio_1 = require("@node-dlc/bufio");
+/**
+ * Reads TLVs from a reader until the entire stream is processed. The handler is
+ * responsible for doing something with the data bytes.
+ * @param reader
+ * @param handler
+ */
+function readTlvs(reader, handler) {
+    let lastType;
+    while (!reader.eof) {
+        const type = reader.readBigSize();
+        const len = reader.readBigSize();
+        const value = reader.readBytes(Number(len));
+        const valueReader = new bufio_1.BufferReader(value);
+        if (type <= lastType) {
+            throw new Error('Invalid TLV stream');
+        }
+        const isEven = type % BigInt(2) === BigInt(0);
+        const wasHandled = handler(type, valueReader);
+        if (!wasHandled && isEven) {
+            throw new Error('Unknown even type');
+        }
+        if (wasHandled && !valueReader.eof) {
+            throw new Error('Non-canonical length');
+        }
+        lastType = type;
+    }
+}
+exports.readTlvs = readTlvs;
+//# sourceMappingURL=readTlvs.js.map

package/.yalc/@node-dlc/messaging/dist/serialize/readTlvs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readTlvs.js","sourceRoot":"","sources":["../../lib/serialize/readTlvs.ts"],"names":[],"mappings":";;;AAAA,2CAA+C;AAE/C;;;;;GAKG;AACH,SAAgB,QAAQ,CACtB,MAAoB,EACpB,OAAuD;IAEvD,IAAI,QAAgB,CAAC;IACrB,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE;QAClB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,oBAAY,CAAC,KAAK,CAAC,CAAC;QAE5C,IAAI,IAAI,IAAI,QAAQ,EAAE;YACpB,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;SACvC;QAED,MAAM,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAE9C,IAAI,CAAC,UAAU,IAAI,MAAM,EAAE;YACzB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;SACtC;QAED,IAAI,UAAU,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;SACzC;QAED,QAAQ,GAAG,IAAI,CAAC;KACjB;AACH,CAAC;AA5BD,4BA4BC"}

package/.yalc/@node-dlc/messaging/dist/util.d.ts

@@ -0,0 +1,13 @@
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Safely converts various input types to BigInt
+ * @param value Value to convert to BigInt
+ * @returns BigInt representation of the value, or BigInt(0) for null/undefined
+ */
+export declare function toBigInt(value: string | number | bigint | null | undefined): bigint;
+/**
+ * Safely converts BigInt to number, preserving precision for safe integers
+ * @param value BigInt value to convert
+ * @returns Number if within safe range, otherwise returns the BigInt as-is for JSON serialization
+ */
+export declare function bigIntToNumber(value: bigint): number | any;

package/.yalc/@node-dlc/messaging/dist/util.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bigIntToNumber = exports.toBigInt = exports.sleep = void 0;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+exports.sleep = sleep;
+/**
+ * Safely converts various input types to BigInt
+ * @param value Value to convert to BigInt
+ * @returns BigInt representation of the value, or BigInt(0) for null/undefined
+ */
+function toBigInt(value) {
+    if (value === null || value === undefined)
+        return BigInt(0);
+    if (typeof value === 'bigint')
+        return value;
+    if (typeof value === 'string')
+        return BigInt(value);
+    if (typeof value === 'number')
+        return BigInt(value);
+    return BigInt(0);
+}
+exports.toBigInt = toBigInt;
+/**
+ * Safely converts BigInt to number, preserving precision for safe integers
+ * @param value BigInt value to convert
+ * @returns Number if within safe range, otherwise returns the BigInt as-is for JSON serialization
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function bigIntToNumber(value) {
+    // For values within safe integer range, convert to number
+    if (value <= BigInt(Number.MAX_SAFE_INTEGER) &&
+        value >= BigInt(Number.MIN_SAFE_INTEGER)) {
+        return Number(value);
+    }
+    // For larger values, preserve as BigInt (json-bigint will handle serialization)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return value;
+}
+exports.bigIntToNumber = bigIntToNumber;
+//# sourceMappingURL=util.js.map

package/.yalc/@node-dlc/messaging/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../lib/util.ts"],"names":[],"mappings":";;;AAAA,SAAgB,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAFD,sBAEC;AAED;;;;GAIG;AACH,SAAgB,QAAQ,CACtB,KAAkD;IAElD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AARD,4BAQC;AAED;;;;GAIG;AACH,8DAA8D;AAC9D,SAAgB,cAAc,CAAC,KAAa;IAC1C,0DAA0D;IAC1D,IACE,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACxC,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EACxC;QACA,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;KACtB;IACD,gFAAgF;IAChF,8DAA8D;IAC9D,OAAO,KAAY,CAAC;AACtB,CAAC;AAXD,wCAWC"}

package/.yalc/@node-dlc/messaging/dist/validation/validate.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="node" />
+export declare const validateBuffer: (value: Buffer, key: string, className: string, expectedLength?: number) => void;
+export declare const validateBigInt: (value: bigint, key: string, className: string) => void;
+export declare const validateNumber: (value: number, key: string, className: string) => void;

package/.yalc/@node-dlc/messaging/dist/validation/validate.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNumber = exports.validateBigInt = exports.validateBuffer = void 0;
+const validateBuffer = (value, key, className, expectedLength) => {
+    if (value === undefined)
+        throw Error(`${className} ${key} is undefined`);
+    if (value.length === 0)
+        throw Error(`${className} ${key} length cannot be 0`);
+    if (expectedLength && value.length !== expectedLength)
+        throw Error(`${className} ${key} length expected to be ${expectedLength}`);
+};
+exports.validateBuffer = validateBuffer;
+const validateBigInt = (value, key, className) => {
+    if (value === undefined)
+        throw Error(`${className} ${key} is undefined`);
+    if (typeof value !== 'bigint')
+        throw Error(`${className} ${key} must be type bigint`);
+    if (value === BigInt(0))
+        throw Error(`${className} ${key} must be greater than 0`);
+};
+exports.validateBigInt = validateBigInt;
+const validateNumber = (value, key, className) => {
+    if (value === undefined)
+        throw Error(`${className} ${key} is undefined`);
+    if (typeof value !== 'number')
+        throw Error(`${className} ${key} must be type number`);
+    if (value === 0)
+        throw Error(`${className} ${key} must be greater than 0`);
+};
+exports.validateNumber = validateNumber;
+//# sourceMappingURL=validate.js.map

package/.yalc/@node-dlc/messaging/dist/validation/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../lib/validation/validate.ts"],"names":[],"mappings":";;;AAAO,MAAM,cAAc,GAAG,CAC5B,KAAa,EACb,GAAW,EACX,SAAiB,EACjB,cAAuB,EACjB,EAAE;IACR,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,GAAG,SAAS,IAAI,GAAG,eAAe,CAAC,CAAC;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,KAAK,CAAC,GAAG,SAAS,IAAI,GAAG,qBAAqB,CAAC,CAAC;IAC9E,IAAI,cAAc,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc;QACnD,MAAM,KAAK,CAAC,GAAG,SAAS,IAAI,GAAG,0BAA0B,cAAc,EAAE,CAAC,CAAC;AAC/E,CAAC,CAAC;AAVW,QAAA,cAAc,kBAUzB;AAEK,MAAM,cAAc,GAAG,CAC5B,KAAa,EACb,GAAW,EACX,SAAiB,EACX,EAAE;IACR,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,GAAG,SAAS,IAAI,GAAG,eAAe,CAAC,CAAC;IACzE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC3B,MAAM,KAAK,CAAC,GAAG,SAAS,IAAI,GAAG,sBAAsB,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC;QACrB,MAAM,KAAK,CAAC,GAAG,SAAS,IAAI,GAAG,yBAAyB,CAAC,CAAC;AAC9D,CAAC,CAAC;AAVW,QAAA,cAAc,kBAUzB;AAEK,MAAM,cAAc,GAAG,CAC5B,KAAa,EACb,GAAW,EACX,SAAiB,EACX,EAAE;IACR,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,KAAK,CAAC,GAAG,SAAS,IAAI,GAAG,eAAe,CAAC,CAAC;IACzE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC3B,MAAM,KAAK,CAAC,GAAG,SAAS,IAAI,GAAG,sBAAsB,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,CAAC;QAAE,MAAM,KAAK,CAAC,GAAG,SAAS,IAAI,GAAG,yBAAyB,CAAC,CAAC;AAC7E,CAAC,CAAC;AATW,QAAA,cAAc,kBASzB"}