bireader 3.1.9 → 3.1.10

package/dist/index.cjs.js

@@ -22,6 +22,11 @@ function _interopNamespaceDefault(e) {
 
 var buff__namespace = /*#__PURE__*/_interopNamespaceDefault(buff);
 
+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);
 }
@@ -1374,6 +1379,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) {
@@ -1460,9 +1473,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) {
@@ -1772,6 +1785,7 @@ class BiBase {
          */
         this.strDefaults = { stringType: "utf-8", terminateValue: 0x0 };
         this.maxFileSize = null;
+        this.enforceBigInt = false;
     }
     /**
      * Settings for when using .str
@@ -3449,9 +3463,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);
@@ -3510,7 +3526,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);
@@ -3518,7 +3536,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");
@@ -3526,7 +3546,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");
@@ -3534,7 +3556,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");
@@ -3542,7 +3566,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");
@@ -3634,11 +3660,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
  */
@@ -3648,11 +3675,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();
@@ -3666,6 +3694,7 @@ class BiReader extends BiBase {
             }
             this.data = data;
         }
+        this.enforceBigInt = options?.enforceBigInt ?? false;
         if (options.extendBufferSize != undefined && options.extendBufferSize != 0) {
             this.extendBufferSize = options.extendBufferSize;
         }
@@ -6166,7 +6195,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();
@@ -6174,7 +6205,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();
@@ -6182,7 +6215,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();
@@ -6190,7 +6225,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);
@@ -6198,7 +6235,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);
@@ -6206,7 +6245,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);
@@ -6214,7 +6255,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");
@@ -6222,7 +6265,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");
@@ -6230,7 +6275,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");
@@ -6238,7 +6285,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");
@@ -6246,7 +6295,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");
@@ -6254,7 +6305,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");
@@ -6262,7 +6315,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");
@@ -6270,7 +6325,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");
@@ -6278,7 +6335,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");
@@ -6286,7 +6345,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");
@@ -6294,7 +6355,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");
@@ -6302,7 +6365,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");
@@ -6699,6 +6764,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
  */
@@ -6713,6 +6779,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();
@@ -6731,6 +6798,7 @@ class BiWriter extends BiBase {
             }
             this.data = data;
         }
+        this.enforceBigInt = options?.enforceBigInt ?? false;
         if (options.extendBufferSize != undefined && options.extendBufferSize != 0) {
             this.extendBufferSize = options.extendBufferSize;
         }
@@ -11135,6 +11203,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) {
@@ -11226,10 +11302,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) {
@@ -11547,6 +11623,7 @@ class BiBaseStreamer {
          */
         this.strDefaults = { stringType: "utf-8", terminateValue: 0x0 };
         this.maxFileSize = null;
+        this.enforceBigInt = false;
         this.filePath = filePath;
         if (readwrite) {
             this.fsMode = "w+";
@@ -13396,9 +13473,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);
@@ -13457,7 +13536,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);
@@ -13465,7 +13546,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");
@@ -13473,7 +13556,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");
@@ -13481,7 +13566,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");
@@ -13489,7 +13576,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");
@@ -13581,11 +13670,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
  */
@@ -13597,11 +13687,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);
@@ -13615,6 +13706,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;
@@ -16082,7 +16174,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();
@@ -16090,7 +16184,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();
@@ -16098,7 +16194,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();
@@ -16106,7 +16204,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);
@@ -16114,7 +16214,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);
@@ -16122,7 +16224,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);
@@ -16130,7 +16234,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");
@@ -16138,7 +16244,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");
@@ -16146,7 +16254,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");
@@ -16154,7 +16264,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");
@@ -16162,7 +16274,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");
@@ -16170,7 +16284,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");
@@ -16178,7 +16294,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");
@@ -16186,7 +16304,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");
@@ -16194,7 +16314,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");
@@ -16202,7 +16324,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");
@@ -16210,7 +16334,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");
@@ -16218,7 +16344,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");
@@ -16617,6 +16745,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
  */
@@ -16633,6 +16762,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);
@@ -16640,6 +16770,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;
         }