bireader 3.1.9 → 3.1.11

package/dist/index.esm.js

@@ -1,6 +1,11 @@
 import fs from 'node:fs';
 import * as buff from 'node:buffer';
 
+const MIN_SAFE = BigInt(Number.MIN_SAFE_INTEGER);
+const MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);
+function isSafeInt64(big) {
+    return big >= MIN_SAFE && big <= MAX_SAFE;
+}
 function isBuffer(obj) {
     return buffcheck(obj);
 }
@@ -975,7 +980,7 @@ function wbit$1(ctx, value, bits, unsigned, endian) {
     if (bits <= 0 || bits > 32) {
         throw new Error('Bit length must be between 1 and 32. Got ' + bits);
     }
-    if (unsigned == true) {
+    if (unsigned == true || bits == 1) {
         if (value < 0 || value > Math.pow(2, bits)) {
             ctx.errorDump ? "[Error], hexdump:\n" + ctx.hexdump() : "";
             throw new Error(`Value is out of range for the specified ${bits}bit length.` + " min: " + 0 + " max: " + Math.pow(2, bits) + " value: " + value);
@@ -989,7 +994,7 @@ function wbit$1(ctx, value, bits, unsigned, endian) {
             throw new Error(`Value is out of range for the specified ${bits}bit length.` + " min: " + minValue + " max: " + maxValue + " value: " + value);
         }
     }
-    if (unsigned == true) {
+    if (unsigned == true || bits == 1) {
         const maxValue = Math.pow(2, bits) - 1;
         value = value & maxValue;
     }
@@ -1353,6 +1358,14 @@ function rint64$1(ctx, unsigned, endian) {
         }
     }
     ctx.bitoffset = 0;
+    if (ctx.enforceBigInt) {
+        return value;
+    }
+    else {
+        if (isSafeInt64(value)) {
+            return Number(value);
+        }
+    }
     return value;
 }
 function wint64$1(ctx, value, unsigned, endian) {
@@ -1439,9 +1452,9 @@ function wdfloat$1(ctx, value, endian) {
 function rdfloat$1(ctx, endian) {
     endian = (endian == undefined ? ctx.endian : endian);
     var uint64Value = ctx.readInt64(true, endian);
-    const sign = (uint64Value & 0x8000000000000000n) >> 63n;
-    const exponent = Number((uint64Value & 0x7ff0000000000000n) >> 52n) - 1023;
-    const fraction = Number(uint64Value & 0x000fffffffffffffn) / Math.pow(2, 52);
+    const sign = (BigInt(uint64Value) & 0x8000000000000000n) >> 63n;
+    const exponent = Number((BigInt(uint64Value) & 0x7ff0000000000000n) >> 52n) - 1023;
+    const fraction = Number(BigInt(uint64Value) & 0x000fffffffffffffn) / Math.pow(2, 52);
     var floatValue;
     if (exponent == -1023) {
         if (fraction == 0) {
@@ -1751,6 +1764,7 @@ class BiBase {
          */
         this.strDefaults = { stringType: "utf-8", terminateValue: 0x0 };
         this.maxFileSize = null;
+        this.enforceBigInt = false;
     }
     /**
      * Settings for when using .str
@@ -3428,9 +3442,11 @@ class BiBase {
     /**
      * Read signed 64 bit integer.
      *
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
      * @param {boolean} unsigned - if value is unsigned or not
      * @param {endian?} endian - ``big`` or ``little``
-     * @returns {bigint}
+     * @returns {BigValue}
      */
     readInt64(unsigned, endian) {
         return rint64$1(this, unsigned, endian);
@@ -3489,7 +3505,9 @@ class BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readUInt64() {
         return this.readInt64(true);
@@ -3497,7 +3515,9 @@ class BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readInt64BE() {
         return this.readInt64(false, "big");
@@ -3505,7 +3525,9 @@ class BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readUInt64BE() {
         return this.readInt64(true, "big");
@@ -3513,7 +3535,9 @@ class BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readInt64LE() {
         return this.readInt64(false, "little");
@@ -3521,7 +3545,9 @@ class BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readUInt64LE() {
         return this.readInt64(true, "little");
@@ -3613,11 +3639,12 @@ class BiBase {
  *
  * @param {Buffer|Uint8Array} data - ``Buffer`` or ``Uint8Array``. Always found in ``BiReader.data``
  * @param {BiOptions?} options - Any options to set at start
- * @param {number?} options.byteOffset - Byte offset to start reader (default ``0``)
- * @param {number?} options.bitOffset - Bit offset 0-7 to start reader (default ``0``)
- * @param {string?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
- * @param {boolean?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``true``)
- * @param {number?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+ * @param {BiOptions["byteOffset"]?} options.byteOffset - Byte offset to start writer (default ``0``)
+ * @param {BiOptions["bitOffset"]?} options.bitOffset - Bit offset 0-7 to start writer (default ``0``)
+ * @param {BiOptions["endianness"]?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
+ * @param {BiOptions["strict"]?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``false``)
+ * @param {BiOptions["extendBufferSize"]?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+ * @param {BiOptions["enforceBigInt"]?} options.enforceBigInt - 64 bit value reads will always stay ``BigInt``.
  *
  * @since 2.0
  */
@@ -3627,11 +3654,12 @@ class BiReader extends BiBase {
      *
      * @param {Buffer|Uint8Array} data - ``Buffer`` or ``Uint8Array``. Always found in ``BiReader.data``
      * @param {BiOptions?} options - Any options to set at start
-     * @param {number?} options.byteOffset - Byte offset to start reader (default ``0``)
-     * @param {number?} options.bitOffset - Bit offset 0-7 to start reader (default ``0``)
-     * @param {string?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
-     * @param {boolean?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``true``)
-     * @param {number?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+     * @param {BiOptions["byteOffset"]?} options.byteOffset - Byte offset to start writer (default ``0``)
+     * @param {BiOptions["bitOffset"]?} options.bitOffset - Bit offset 0-7 to start writer (default ``0``)
+     * @param {BiOptions["endianness"]?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
+     * @param {BiOptions["strict"]?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``false``)
+     * @param {BiOptions["extendBufferSize"]?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+     * @param {BiOptions["enforceBigInt"]?} options.enforceBigInt - 64 bit value reads will always stay ``BigInt``.
      */
     constructor(data, options = {}) {
         super();
@@ -3645,6 +3673,7 @@ class BiReader extends BiBase {
             }
             this.data = data;
         }
+        this.enforceBigInt = options?.enforceBigInt ?? false;
         if (options.extendBufferSize != undefined && options.extendBufferSize != 0) {
             this.extendBufferSize = options.extendBufferSize;
         }
@@ -6145,7 +6174,9 @@ class BiReader extends BiBase {
     /**
      * Read signed 64 bit integer
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get int64() {
         return this.readInt64();
@@ -6153,7 +6184,9 @@ class BiReader extends BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get bigint() {
         return this.readInt64();
@@ -6161,7 +6194,9 @@ class BiReader extends BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get quad() {
         return this.readInt64();
@@ -6169,7 +6204,9 @@ class BiReader extends BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uint64() {
         return this.readInt64(true);
@@ -6177,7 +6214,9 @@ class BiReader extends BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get ubigint() {
         return this.readInt64(true);
@@ -6185,7 +6224,9 @@ class BiReader extends BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uquad() {
         return this.readInt64(true);
@@ -6193,7 +6234,9 @@ class BiReader extends BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get int64be() {
         return this.readInt64(false, "big");
@@ -6201,7 +6244,9 @@ class BiReader extends BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get bigintbe() {
         return this.readInt64(false, "big");
@@ -6209,7 +6254,9 @@ class BiReader extends BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get quadbe() {
         return this.readInt64(false, "big");
@@ -6217,7 +6264,9 @@ class BiReader extends BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uint64be() {
         return this.readInt64(true, "big");
@@ -6225,7 +6274,9 @@ class BiReader extends BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get ubigintbe() {
         return this.readInt64(true, "big");
@@ -6233,7 +6284,9 @@ class BiReader extends BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uquadbe() {
         return this.readInt64(true, "big");
@@ -6241,7 +6294,9 @@ class BiReader extends BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get int64le() {
         return this.readInt64(false, "little");
@@ -6249,7 +6304,9 @@ class BiReader extends BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get bigintle() {
         return this.readInt64(false, "little");
@@ -6257,7 +6314,9 @@ class BiReader extends BiBase {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get quadle() {
         return this.readInt64(false, "little");
@@ -6265,7 +6324,9 @@ class BiReader extends BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uint64le() {
         return this.readInt64(true, "little");
@@ -6273,7 +6334,9 @@ class BiReader extends BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get ubigintle() {
         return this.readInt64(true, "little");
@@ -6281,7 +6344,9 @@ class BiReader extends BiBase {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uquadle() {
         return this.readInt64(true, "little");
@@ -6678,6 +6743,7 @@ class BiReader extends BiBase {
  * @param {BiOptions["endianness"]?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
  * @param {BiOptions["strict"]?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``false``)
  * @param {BiOptions["extendBufferSize"]?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+ * @param {BiOptions["enforceBigInt"]?} options.enforceBigInt - 64 bit value reads will always stay ``BigInt``.
  *
  * @since 2.0
  */
@@ -6692,6 +6758,7 @@ class BiWriter extends BiBase {
      * @param {BiOptions["endianness"]?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
      * @param {BiOptions["strict"]?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``false``)
      * @param {BiOptions["extendBufferSize"]?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+     * @param {BiOptions["enforceBigInt"]?} options.enforceBigInt - 64 bit value reads will always stay ``BigInt``.
      */
     constructor(data, options = {}) {
         super();
@@ -6710,6 +6777,7 @@ class BiWriter extends BiBase {
             }
             this.data = data;
         }
+        this.enforceBigInt = options?.enforceBigInt ?? false;
         if (options.extendBufferSize != undefined && options.extendBufferSize != 0) {
             this.extendBufferSize = options.extendBufferSize;
         }
@@ -10710,7 +10778,7 @@ function wbit(ctx, value, bits, unsigned, endian) {
     if (bits <= 0 || bits > 32) {
         throw new Error('Bit length must be between 1 and 32. Got ' + bits);
     }
-    if (unsigned == true) {
+    if (unsigned == true || bits == 1) {
         if (value < 0 || value > Math.pow(2, bits)) {
             ctx.errorDump ? "[Error], hexdump:\n" + ctx.hexdump() : "";
             throw new Error(`Value is out of range for the specified ${bits}bit length.` + " min: " + 0 + " max: " + Math.pow(2, bits) + " value: " + value);
@@ -10724,7 +10792,7 @@ function wbit(ctx, value, bits, unsigned, endian) {
             throw new Error(`Value is out of range for the specified ${bits}bit length.` + " min: " + minValue + " max: " + maxValue + " value: " + value);
         }
     }
-    if (unsigned == true) {
+    if (unsigned == true || bits == 1) {
         const maxValue = Math.pow(2, bits) - 1;
         value = value & maxValue;
     }
@@ -11114,6 +11182,14 @@ function rint64(ctx, unsigned, endian) {
         }
     }
     ctx.bitoffset = 0;
+    if (ctx.enforceBigInt) {
+        return value;
+    }
+    else {
+        if (isSafeInt64(value)) {
+            return Number(value);
+        }
+    }
     return value;
 }
 function wint64(ctx, value, unsigned, endian) {
@@ -11205,10 +11281,10 @@ function wdfloat(ctx, value, endian) {
 }
 function rdfloat(ctx, endian) {
     endian = (endian == undefined ? ctx.endian : endian);
-    var uint64Value = ctx.readInt64(true, endian);
-    const sign = (uint64Value & 0x8000000000000000n) >> 63n;
-    const exponent = Number((uint64Value & 0x7ff0000000000000n) >> 52n) - 1023;
-    const fraction = Number(uint64Value & 0x000fffffffffffffn) / Math.pow(2, 52);
+    var uint64Value = ctx.readInt64(true /*unsigned*/, endian);
+    const sign = (BigInt(uint64Value) & 0x8000000000000000n) >> 63n;
+    const exponent = Number((BigInt(uint64Value) & 0x7ff0000000000000n) >> 52n) - 1023;
+    const fraction = Number(BigInt(uint64Value) & 0x000fffffffffffffn) / Math.pow(2, 52);
     var floatValue;
     if (exponent == -1023) {
         if (fraction == 0) {
@@ -11526,6 +11602,7 @@ class BiBaseStreamer {
          */
         this.strDefaults = { stringType: "utf-8", terminateValue: 0x0 };
         this.maxFileSize = null;
+        this.enforceBigInt = false;
         this.filePath = filePath;
         if (readwrite) {
             this.fsMode = "w+";
@@ -13375,9 +13452,11 @@ class BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
      * @param {boolean} unsigned - if value is unsigned or not
      * @param {endian?} endian - ``big`` or ``little``
-     * @returns {bigint}
+     * @returns {BigValue}
      */
     readInt64(unsigned, endian) {
         return rint64(this, unsigned, endian);
@@ -13436,7 +13515,9 @@ class BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readUInt64() {
         return this.readInt64(true);
@@ -13444,7 +13525,9 @@ class BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readInt64BE() {
         return this.readInt64(false, "big");
@@ -13452,7 +13535,9 @@ class BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readUInt64BE() {
         return this.readInt64(true, "big");
@@ -13460,7 +13545,9 @@ class BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readInt64LE() {
         return this.readInt64(false, "little");
@@ -13468,7 +13555,9 @@ class BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     readUInt64LE() {
         return this.readInt64(true, "little");
@@ -13560,11 +13649,12 @@ class BiBaseStreamer {
  *
  * @param {string} filePath - Path to file
  * @param {BiOptions?} options - Any options to set at start
- * @param {number?} options.byteOffset - Byte offset to start reader (default ``0``)
- * @param {number?} options.bitOffset - Bit offset 0-7 to start reader (default ``0``)
- * @param {string?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
- * @param {boolean?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``true``)
- * @param {number?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+ * @param {BiOptions["byteOffset"]?} options.byteOffset - Byte offset to start writer (default ``0``)
+ * @param {BiOptions["bitOffset"]?} options.bitOffset - Bit offset 0-7 to start writer (default ``0``)
+ * @param {BiOptions["endianness"]?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
+ * @param {BiOptions["strict"]?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``false``)
+ * @param {BiOptions["extendBufferSize"]?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+ * @param {BiOptions["enforceBigInt"]?} options.enforceBigInt - 64 bit value reads will always stay ``BigInt``.
  *
  * @since 3.1
  */
@@ -13576,11 +13666,12 @@ class BiReaderStream extends BiBaseStreamer {
      *
      * @param {string} filePath - Path to file
      * @param {BiOptions?} options - Any options to set at start
-     * @param {number?} options.byteOffset - Byte offset to start reader (default ``0``)
-     * @param {number?} options.bitOffset - Bit offset 0-7 to start reader (default ``0``)
-     * @param {string?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
-     * @param {boolean?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``true``)
-     * @param {number?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+     * @param {BiOptions["byteOffset"]?} options.byteOffset - Byte offset to start writer (default ``0``)
+     * @param {BiOptions["bitOffset"]?} options.bitOffset - Bit offset 0-7 to start writer (default ``0``)
+     * @param {BiOptions["endianness"]?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
+     * @param {BiOptions["strict"]?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``false``)
+     * @param {BiOptions["extendBufferSize"]?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+     * @param {BiOptions["enforceBigInt"]?} options.enforceBigInt - 64 bit value reads will always stay ``BigInt``.
      */
     constructor(filePath, options = {}) {
         super(filePath, false);
@@ -13594,6 +13685,7 @@ class BiReaderStream extends BiBaseStreamer {
         if (options.endianness != undefined && !(options.endianness == "big" || options.endianness == "little")) {
             throw new Error("Byte order must be big or little");
         }
+        this.enforceBigInt = options?.enforceBigInt ?? false;
         this.endian = options.endianness || "little";
         if (typeof options.strict == "boolean") {
             this.strict = options.strict;
@@ -16061,7 +16153,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read signed 64 bit integer
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get int64() {
         return this.readInt64();
@@ -16069,7 +16163,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get bigint() {
         return this.readInt64();
@@ -16077,7 +16173,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get quad() {
         return this.readInt64();
@@ -16085,7 +16183,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uint64() {
         return this.readInt64(true);
@@ -16093,7 +16193,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get ubigint() {
         return this.readInt64(true);
@@ -16101,7 +16203,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uquad() {
         return this.readInt64(true);
@@ -16109,7 +16213,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get int64be() {
         return this.readInt64(false, "big");
@@ -16117,7 +16223,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get bigintbe() {
         return this.readInt64(false, "big");
@@ -16125,7 +16233,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get quadbe() {
         return this.readInt64(false, "big");
@@ -16133,7 +16243,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uint64be() {
         return this.readInt64(true, "big");
@@ -16141,7 +16253,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get ubigintbe() {
         return this.readInt64(true, "big");
@@ -16149,7 +16263,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uquadbe() {
         return this.readInt64(true, "big");
@@ -16157,7 +16273,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get int64le() {
         return this.readInt64(false, "little");
@@ -16165,7 +16283,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get bigintle() {
         return this.readInt64(false, "little");
@@ -16173,7 +16293,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read signed 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get quadle() {
         return this.readInt64(false, "little");
@@ -16181,7 +16303,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uint64le() {
         return this.readInt64(true, "little");
@@ -16189,7 +16313,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get ubigintle() {
         return this.readInt64(true, "little");
@@ -16197,7 +16323,9 @@ class BiReaderStream extends BiBaseStreamer {
     /**
      * Read unsigned 64 bit integer.
      *
-     * @returns {bigint}
+     * Note: If ``enforceBigInt`` was set to ``true``, this always returns a ``BigInt`` otherwise it will return a ``number`` if integer safe.
+     *
+     * @returns {BigValue}
      */
     get uquadle() {
         return this.readInt64(true, "little");
@@ -16596,6 +16724,7 @@ class BiReaderStream extends BiBaseStreamer {
  * @param {BiOptions["endianness"]?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
  * @param {BiOptions["strict"]?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``false``)
  * @param {BiOptions["extendBufferSize"]?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+ * @param {BiOptions["enforceBigInt"]?} options.enforceBigInt - 64 bit value reads will always stay ``BigInt``.
  *
  * @since 3.1
  */
@@ -16612,6 +16741,7 @@ class BiWriterStream extends BiBaseStreamer {
      * @param {BiOptions["endianness"]?} options.endianness - Endianness ``big`` or ``little`` (default ``little``)
      * @param {BiOptions["strict"]?} options.strict - Strict mode: if ``true`` does not extend supplied array on outside write (default ``false``)
      * @param {BiOptions["extendBufferSize"]?} options.extendBufferSize - Amount of data to add when extending the buffer array when strict mode is false. Note: Changes logic in ``.get`` and ``.return``.
+     * @param {BiOptions["enforceBigInt"]?} options.enforceBigInt - 64 bit value reads will always stay ``BigInt``.
      */
     constructor(filePath, options = {}) {
         super(filePath, true);
@@ -16619,6 +16749,7 @@ class BiWriterStream extends BiBaseStreamer {
         if (options.extendBufferSize != undefined && options.extendBufferSize != 0) {
             this.extendBufferSize = options.extendBufferSize;
         }
+        this.enforceBigInt = options?.enforceBigInt ?? false;
         if (typeof options.strict == "boolean") {
             this.strict = options.strict;
         }