binary-packet 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -73,6 +73,17 @@ declare function FieldArray<T extends Field | BinaryPacket<Definition> | ''>(ite
  * NOTE: If an array will not always have the same length, use the `FieldArray` type.
  */
 declare function FieldFixedArray<T extends Field | BinaryPacket<Definition> | '', Length extends number>(item: T, length: Length): [itemType: T, length: Length];
+/**
+ * Utility class that allows serializing arrays through any kind of iterable, as long as the number of elements is known beforehand. \
+ * Needed to skip the overhead of duplicating the data into an actual array just for it to be serialized straight away and trashed.
+ */
+declare class SequentialSerializer<T> implements Iterable<T> {
+    private readonly iterable;
+    readonly length: number;
+    constructor(iterable: Iterable<T>, length: number);
+    [Symbol.iterator](): Iterator<T, any, any>;
+}
+type SequentiallySerializable<T, IsRead extends boolean> = IsRead extends true ? T[] : T[] | SequentialSerializer<T>;
 type BitFlags = (string[] | ReadonlyArray<string>) & {
     length: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
 };
@@ -168,7 +179,7 @@ declare class BinaryPacket<T extends Definition> {
      */
     readNodeBuffer(dataIn: Buffer, offsetPointer?: {
         offset: number;
-    }, byteLength?: number): ToJson<T>;
+    }, byteLength?: number): ToJson<T, true>;
     /**
      * Reads/deserializes from the given DataView.
      *
@@ -177,7 +188,7 @@ declare class BinaryPacket<T extends Definition> {
      */
     readDataView(dataIn: DataView, offsetPointer?: {
         offset: number;
-    }, byteLength?: number): ToJson<T>;
+    }, byteLength?: number): ToJson<T, true>;
     /**
      * Reads/deserializes from the given ArrayBuffer. \
      * WARNING: this method is practically a HACK.
@@ -189,7 +200,7 @@ declare class BinaryPacket<T extends Definition> {
      * NOTE: if you have a node Buffer do not bother wrapping it into an ArrayBuffer yourself. \
      * NOTE: if you have a node Buffer use the appropriate `readNodeBuffer` as it is much faster and less error prone.
      */
-    readArrayBuffer(dataIn: TrueArrayBuffer, byteOffset: number, byteLength: number): ToJson<T>;
+    readArrayBuffer(dataIn: TrueArrayBuffer, byteOffset: number, byteLength: number): ToJson<T, true>;
     /**
      * Writes/serializes the given object into a Buffer. \
      * Method available ONLY on NodeJS and Bun.
@@ -224,6 +235,7 @@ declare class BinaryPacket<T extends Definition> {
      * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.
      */
     visitor(onVisit: (packet: ToJson<T>) => void): Visitor;
+    sequentialSerializer(numElements: number, dataOut: Iterable<ToJson<T>>): void;
     private readonly entries;
     readonly stringPositions: StringPositions;
     readonly minimumByteLength: number;
@@ -290,18 +302,18 @@ type BitFlagsToJson<FlagsArray extends BitFlags> = {
 /**
  * Meta-type that converts a `Definition` schema to the type of the actual JavaScript object that will be written into a packet or read from. \
  */
-type ToJson<T extends Definition> = {
-    [K in keyof T]: T[K] extends [infer Item] ? Item extends BinaryPacket<infer BPDef> ? ToJson<BPDef>[] : Item extends '' ? string[] : number[] : T[K] extends [infer Item, infer Length] ? Item extends BinaryPacket<infer BPDef> ? ToJson<BPDef>[] & {
+type ToJson<T extends Definition, IsRead extends boolean = false> = {
+    [K in keyof T]: T[K] extends [infer Item] ? Item extends BinaryPacket<infer BPDef> ? SequentiallySerializable<ToJson<BPDef, IsRead>, IsRead> : Item extends '' ? SequentiallySerializable<string, IsRead> : SequentiallySerializable<number, IsRead> : T[K] extends [infer Item, infer Length] ? Item extends BinaryPacket<infer BPDef> ? SequentiallySerializable<ToJson<BPDef, IsRead>, IsRead> & {
         length: Length;
     } : Item extends '' ? string[] & {
         length: Length;
     } : number[] & {
         length: Length;
-    } : T[K] extends BinaryPacket<infer BPDef> ? ToJson<BPDef> : T[K] extends {
+    } : T[K] extends BinaryPacket<infer BPDef> ? ToJson<BPDef, IsRead> : T[K] extends {
         flags: infer FlagsArray extends BitFlags;
     } ? BitFlagsToJson<FlagsArray> : T[K] extends {
         optional: BinaryPacket<infer BPDef extends Definition>;
-    } ? ToJson<BPDef> | undefined : T[K] extends '' ? string : number;
+    } ? ToJson<BPDef, IsRead> | undefined : T[K] extends '' ? string : number;
 };
 type StringPositions = [
     string[],
@@ -311,4 +323,4 @@ type StringPositions = [
     }
 ];
 
-export { BinaryPacket, type Definition, Field, FieldArray, FieldBitFlags, FieldFixedArray, FieldOptional, FieldString, type ToJson };
+export { BinaryPacket, type Definition, Field, FieldArray, FieldBitFlags, FieldFixedArray, FieldOptional, FieldString, SequentialSerializer, type ToJson };

package/dist/index.d.ts

@@ -73,6 +73,17 @@ declare function FieldArray<T extends Field | BinaryPacket<Definition> | ''>(ite
  * NOTE: If an array will not always have the same length, use the `FieldArray` type.
  */
 declare function FieldFixedArray<T extends Field | BinaryPacket<Definition> | '', Length extends number>(item: T, length: Length): [itemType: T, length: Length];
+/**
+ * Utility class that allows serializing arrays through any kind of iterable, as long as the number of elements is known beforehand. \
+ * Needed to skip the overhead of duplicating the data into an actual array just for it to be serialized straight away and trashed.
+ */
+declare class SequentialSerializer<T> implements Iterable<T> {
+    private readonly iterable;
+    readonly length: number;
+    constructor(iterable: Iterable<T>, length: number);
+    [Symbol.iterator](): Iterator<T, any, any>;
+}
+type SequentiallySerializable<T, IsRead extends boolean> = IsRead extends true ? T[] : T[] | SequentialSerializer<T>;
 type BitFlags = (string[] | ReadonlyArray<string>) & {
     length: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
 };
@@ -168,7 +179,7 @@ declare class BinaryPacket<T extends Definition> {
      */
     readNodeBuffer(dataIn: Buffer, offsetPointer?: {
         offset: number;
-    }, byteLength?: number): ToJson<T>;
+    }, byteLength?: number): ToJson<T, true>;
     /**
      * Reads/deserializes from the given DataView.
      *
@@ -177,7 +188,7 @@ declare class BinaryPacket<T extends Definition> {
      */
     readDataView(dataIn: DataView, offsetPointer?: {
         offset: number;
-    }, byteLength?: number): ToJson<T>;
+    }, byteLength?: number): ToJson<T, true>;
     /**
      * Reads/deserializes from the given ArrayBuffer. \
      * WARNING: this method is practically a HACK.
@@ -189,7 +200,7 @@ declare class BinaryPacket<T extends Definition> {
      * NOTE: if you have a node Buffer do not bother wrapping it into an ArrayBuffer yourself. \
      * NOTE: if you have a node Buffer use the appropriate `readNodeBuffer` as it is much faster and less error prone.
      */
-    readArrayBuffer(dataIn: TrueArrayBuffer, byteOffset: number, byteLength: number): ToJson<T>;
+    readArrayBuffer(dataIn: TrueArrayBuffer, byteOffset: number, byteLength: number): ToJson<T, true>;
     /**
      * Writes/serializes the given object into a Buffer. \
      * Method available ONLY on NodeJS and Bun.
@@ -224,6 +235,7 @@ declare class BinaryPacket<T extends Definition> {
      * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.
      */
     visitor(onVisit: (packet: ToJson<T>) => void): Visitor;
+    sequentialSerializer(numElements: number, dataOut: Iterable<ToJson<T>>): void;
     private readonly entries;
     readonly stringPositions: StringPositions;
     readonly minimumByteLength: number;
@@ -290,18 +302,18 @@ type BitFlagsToJson<FlagsArray extends BitFlags> = {
 /**
  * Meta-type that converts a `Definition` schema to the type of the actual JavaScript object that will be written into a packet or read from. \
  */
-type ToJson<T extends Definition> = {
-    [K in keyof T]: T[K] extends [infer Item] ? Item extends BinaryPacket<infer BPDef> ? ToJson<BPDef>[] : Item extends '' ? string[] : number[] : T[K] extends [infer Item, infer Length] ? Item extends BinaryPacket<infer BPDef> ? ToJson<BPDef>[] & {
+type ToJson<T extends Definition, IsRead extends boolean = false> = {
+    [K in keyof T]: T[K] extends [infer Item] ? Item extends BinaryPacket<infer BPDef> ? SequentiallySerializable<ToJson<BPDef, IsRead>, IsRead> : Item extends '' ? SequentiallySerializable<string, IsRead> : SequentiallySerializable<number, IsRead> : T[K] extends [infer Item, infer Length] ? Item extends BinaryPacket<infer BPDef> ? SequentiallySerializable<ToJson<BPDef, IsRead>, IsRead> & {
         length: Length;
     } : Item extends '' ? string[] & {
         length: Length;
     } : number[] & {
         length: Length;
-    } : T[K] extends BinaryPacket<infer BPDef> ? ToJson<BPDef> : T[K] extends {
+    } : T[K] extends BinaryPacket<infer BPDef> ? ToJson<BPDef, IsRead> : T[K] extends {
         flags: infer FlagsArray extends BitFlags;
     } ? BitFlagsToJson<FlagsArray> : T[K] extends {
         optional: BinaryPacket<infer BPDef extends Definition>;
-    } ? ToJson<BPDef> | undefined : T[K] extends '' ? string : number;
+    } ? ToJson<BPDef, IsRead> | undefined : T[K] extends '' ? string : number;
 };
 type StringPositions = [
     string[],
@@ -311,4 +323,4 @@ type StringPositions = [
     }
 ];
 
-export { BinaryPacket, type Definition, Field, FieldArray, FieldBitFlags, FieldFixedArray, FieldOptional, FieldString, type ToJson };
+export { BinaryPacket, type Definition, Field, FieldArray, FieldBitFlags, FieldFixedArray, FieldOptional, FieldString, SequentialSerializer, type ToJson };

package/dist/index.js

@@ -1,2 +1,2 @@
-"use strict";var U=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var L=Object.prototype.hasOwnProperty;var O=(n,e)=>{for(var t in e)U(n,t,{get:e[t],enumerable:!0})},J=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of v(e))!L.call(n,r)&&r!==t&&U(n,r,{get:()=>e[r],enumerable:!(i=k(e,r))||i.enumerable});return n};var C=n=>J(U({},"__esModule",{value:!0}),n);var q={};O(q,{BinaryPacket:()=>F,Field:()=>V,FieldArray:()=>R,FieldBitFlags:()=>W,FieldFixedArray:()=>M,FieldOptional:()=>z,FieldString:()=>$});module.exports=C(q);var p=typeof Buffer=="function";function b(n,e){let t=new ArrayBuffer(e),i=Math.min(n.byteLength,t.byteLength),r=Math.trunc(i/8);new Float64Array(t,0,r).set(new Float64Array(n.buffer,0,r));let a=r*8;return r=i-a,new Uint8Array(t,a,r).set(new Uint8Array(n.buffer,a,r)),new DataView(t)}function A(n,e){let t=Buffer.allocUnsafe(e);return n.copy(t),t}var j=new TextEncoder,K=new TextDecoder;function S(n,e,t){let i=t.length,r=new Uint8Array(n.buffer,n.byteOffset+e,i);i<=64?x(r,0,t,i):j.encodeInto(t,r)}function G(n,e,t){let i=t.length;i<=64?x(n,e,t,i):n.utf8Write(t,e,i)}function x(n,e,t,i){for(let r=0;r<i;++r)n[e+r]=t.charCodeAt(r)&255}function E(n,e,t){return n.subarray(e,e+t).toString("utf8")}function h(n,e,t){return K.decode(new DataView(n.buffer,n.byteOffset+e,t))}var V=(s=>(s[s.UNSIGNED_INT_8=0]="UNSIGNED_INT_8",s[s.UNSIGNED_INT_16=1]="UNSIGNED_INT_16",s[s.UNSIGNED_INT_32=2]="UNSIGNED_INT_32",s[s.INT_8=3]="INT_8",s[s.INT_16=4]="INT_16",s[s.INT_32=5]="INT_32",s[s.FLOAT_32=6]="FLOAT_32",s[s.FLOAT_64=7]="FLOAT_64",s))(V||{});function R(n){return[n]}function M(n,e){if(e<0||!Number.isFinite(e))throw new RangeError("Length of a FixedArray must be a positive integer.");return[n,e]}function W(n){if(n.length>8)throw new Error(`Invalid BinaryPacket definition: a BitFlags field can have only up to 8 flags, given: ${n.join(", ")}`);return{flags:n}}function $(){return""}function z(n){return{optional:n}}var F=class n{constructor(e,t){this.packetId=e;this.entries=t?Y(t):[];let i=Z(this.entries);this.minimumByteLength=i.minimumByteLength,this.stringPositions=i.stringPositions}static define(e,t){if(e<0||!Number.isFinite(e))throw new RangeError("Packet IDs must be positive integers.");if(e>255)throw new RangeError("Packet IDs greater than 255 are not supported. Do you REALLY need more than 255 different kinds of packets?");return new n(e,t)}static readPacketIdNodeBuffer(e,t=0){return e.readUint8(t)}static readPacketIdDataView(e,t=0){return e.getUint8(t)}static readPacketIdArrayBuffer(e,t){return new Uint8Array(e,t,1)[0]}static visitNodeBuffer(e,...t){return n.visit(e,I,E,t)}static visitDataView(e,...t){return n.visit(e,g,h,t)}static visitArrayBuffer(e,t,i,...r){return n.visit(new DataView(e,t,i),g,h,r)}readNodeBuffer(e,t={offset:0},i=e.byteLength){return this.read(e,t,i,I,E)}readDataView(e,t={offset:0},i=e.byteLength){return this.read(e,t,i,g,h)}readArrayBuffer(e,t,i){return this.read(p?Buffer.from(e,t,i):new DataView(e,t,i),{offset:0},i,p?I:g,p?E:h)}writeNodeBuffer(e){let t=this.precalculateBufferLengthWithStrings(e),i=Buffer.allocUnsafe(t);return this.write(i,e,{offset:0},t,t,c,A,G)}writeDataView(e){let t=this.precalculateBufferLengthWithStrings(e),i=new DataView(new ArrayBuffer(t));return this.write(i,e,{offset:0},t,t,_,b,S)}writeArrayBuffer(e){let t=p?this.writeNodeBuffer(e):this.writeDataView(e);return{buffer:t.buffer,byteLength:t.byteLength,byteOffset:t.byteOffset}}visitor(e){return[this,e]}entries;stringPositions;minimumByteLength;static visit(e,t,i,r){for(let[a,o]of r)if(a.packetId===t[0](e,0))return o(a.read(e,{offset:0},e.byteLength,t,i))}read(e,t,i,r,a){if(i+t.offset<this.minimumByteLength)throw new Error(`There is no space available to fit a packet of type ${this.packetId} at offset ${t.offset}`);if(r[0](e,t.offset)!==this.packetId)throw new Error(`Data at offset ${t.offset} is not a packet of type ${this.packetId}`);t.offset+=1;let o={};for(let[u,s]of this.entries)if(Array.isArray(s)){let d=s[1]??r[0](e,t.offset++),f=Array(d),T=s[0];if(typeof T=="object")for(let l=0;l<d;++l)f[l]=T.read(e,t,i,r,a);else if(T==="")for(let l=0;l<d;++l){let N=r[1](e,t.offset);t.offset+=2,f[l]=a(e,t.offset,N),t.offset+=N}else{let l=y[T];for(let N=0;N<d;++N)f[N]=r[T](e,t.offset),t.offset+=l}o[u]=f}else if(typeof s=="number")o[u]=r[s](e,t.offset),t.offset+=y[s];else if(s===""){let d=r[1](e,t.offset);t.offset+=2,o[u]=a(e,t.offset,d),t.offset+=d}else if("flags"in s){let d=r[0](e,t.offset);t.offset+=1,o[u]={};for(let f=0;f<s.flags.length;++f)o[u][s.flags[f]]=!!(d&1<<f)}else if("optional"in s){let d=r[0](e,t.offset)!==0;t.offset+=1,d&&(o[u]=s.optional.read(e,t,i,r,a))}else o[u]=s.read(e,t,i,r,a);return o}write(e,t,i,r,a,o,u,s){o[0](e,this.packetId,i.offset),i.offset+=1;for(let[d,f]of this.entries){let T=t[d];if(Array.isArray(f)){let l=T.length,N=f[1]===void 0;if(N&&(o[0](e,l,i.offset),i.offset+=1),l>0){let D=f[0];if(typeof D=="object"){if(N){let m=l*D.minimumByteLength;r+=m,a+=m,e.byteLength<a&&(e=u(e,a))}for(let m of T)e=D.write(e,m,i,r,a,o,u,s),r=i.offset,a=e.byteLength}else if(D==="")for(let m=0;m<l;++m){let B=T[m],w=B.length;o[1](e,w,i.offset),i.offset+=2,s(e,i.offset,B),i.offset+=w}else{let m=y[D];if(N){let B=l*m;r+=B,a+=B,e.byteLength<a&&(e=u(e,a))}for(let B of T)o[D](e,B,i.offset),i.offset+=m}}}else if(typeof f=="number")o[f](e,T,i.offset),i.offset+=y[f];else if(f===""){let l=T.length;o[1](e,l,i.offset),i.offset+=2,s(e,i.offset,T),i.offset+=l}else if("flags"in f){let l=0;for(let N=0;N<f.flags.length;++N)T[f.flags[N]]&&(l|=1<<N);o[0](e,l,i.offset),i.offset+=1}else"optional"in f?T?(o[0](e,1,i.offset),i.offset+=1,r+=f.optional.minimumByteLength,a+=f.optional.minimumByteLength,e.byteLength<a&&(e=u(e,a)),e=f.optional.write(e,T,i,r,a,o,u,s),r=i.offset,a=e.byteLength):(o[0](e,0,i.offset),i.offset+=1):(e=f.write(e,T,i,r,a,o,u,s),r=i.offset,a=e.byteLength)}return e}precalculateBufferLengthWithStrings(e){let t=this.minimumByteLength;for(let i of this.stringPositions[0])t+=e[i].length;for(let i of this.stringPositions[1])for(let r of e[i])t+=2+r.length;for(let i in this.stringPositions[2])t+=this.stringPositions[2][i].precalculateBufferLengthWithStrings(e[i]);return t}};function Y(n){return Object.entries(n).sort(([e],[t])=>e.localeCompare(t))}function Z(n){let e=1,t=[[],[],{}];for(let[i,r]of n)if(Array.isArray(r))if(r.length===2){let a=r[0]==="",o=typeof r[0]=="object"?r[0].minimumByteLength:a?2:y[r[0]];e+=r[1]*o,a&&t[1].push(i)}else e+=1,r[0]===""&&t[1].push(i);else r instanceof F?(e+=r.minimumByteLength,t[2][i]=r):typeof r=="object"?e+=1:r===""?(e+=2,t[0].push(i)):e+=y[r];return{minimumByteLength:e,stringPositions:t}}var y=Array(8);y[0]=1;y[3]=1;y[1]=2;y[4]=2;y[2]=4;y[5]=4;y[6]=4;y[7]=8;var g=Array(8);g[0]=(n,e)=>n.getUint8(e);g[3]=(n,e)=>n.getInt8(e);g[1]=(n,e)=>n.getUint16(e);g[4]=(n,e)=>n.getInt16(e);g[2]=(n,e)=>n.getUint32(e);g[5]=(n,e)=>n.getInt32(e);g[6]=(n,e)=>n.getFloat32(e);g[7]=(n,e)=>n.getFloat64(e);var _=Array(8);_[0]=(n,e,t)=>n.setUint8(t,e);_[3]=(n,e,t)=>n.setInt8(t,e);_[1]=(n,e,t)=>n.setUint16(t,e);_[4]=(n,e,t)=>n.setInt16(t,e);_[2]=(n,e,t)=>n.setUint32(t,e);_[5]=(n,e,t)=>n.setInt32(t,e);_[6]=(n,e,t)=>n.setFloat32(t,e);_[7]=(n,e,t)=>n.setFloat64(t,e);var c=Array(8);p&&(c[0]=(n,e,t)=>n.writeUint8(e,t),c[3]=(n,e,t)=>n.writeInt8(e,t),c[1]=(n,e,t)=>n.writeUint16BE(e,t),c[4]=(n,e,t)=>n.writeInt16BE(e,t),c[2]=(n,e,t)=>n.writeUint32BE(e,t),c[5]=(n,e,t)=>n.writeInt32BE(e,t),c[6]=(n,e,t)=>n.writeFloatBE(e,t),c[7]=(n,e,t)=>n.writeDoubleBE(e,t));var I=Array(8);p&&(I[0]=(n,e)=>n.readUint8(e),I[3]=(n,e)=>n.readInt8(e),I[1]=(n,e)=>n.readUint16BE(e),I[4]=(n,e)=>n.readInt16BE(e),I[2]=(n,e)=>n.readUint32BE(e),I[5]=(n,e)=>n.readInt32BE(e),I[6]=(n,e)=>n.readFloatBE(e),I[7]=(n,e)=>n.readDoubleBE(e));0&&(module.exports={BinaryPacket,Field,FieldArray,FieldBitFlags,FieldFixedArray,FieldOptional,FieldString});
+"use strict";var F=Object.defineProperty;var L=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var O=Object.prototype.hasOwnProperty;var J=(i,e)=>{for(var t in e)F(i,t,{get:e[t],enumerable:!0})},R=(i,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of v(e))!O.call(i,r)&&r!==t&&F(i,r,{get:()=>e[r],enumerable:!(n=L(e,r))||n.enumerable});return i};var C=i=>R(F({},"__esModule",{value:!0}),i);var H={};J(H,{BinaryPacket:()=>E,Field:()=>k,FieldArray:()=>j,FieldBitFlags:()=>M,FieldFixedArray:()=>K,FieldOptional:()=>$,FieldString:()=>W,SequentialSerializer:()=>w});module.exports=C(H);var p=typeof Buffer=="function";function x(i,e){let t=new ArrayBuffer(e),n=Math.min(i.byteLength,t.byteLength),r=Math.trunc(n/8);new Float64Array(t,0,r).set(new Float64Array(i.buffer,0,r));let a=r*8;return r=n-a,new Uint8Array(t,a,r).set(new Uint8Array(i.buffer,a,r)),new DataView(t)}function S(i,e){let t=Buffer.allocUnsafe(e);return i.copy(t),t}var z=new TextEncoder,q=new TextDecoder;function G(i,e,t){let n=t.length,r=new Uint8Array(i.buffer,i.byteOffset+e,n);n<=64?V(r,0,t,n):z.encodeInto(t,r)}function U(i,e,t){let n=t.length;n<=64?V(i,e,t,n):i.utf8Write(t,e,n)}function V(i,e,t,n){for(let r=0;r<n;++r)i[e+r]=t.charCodeAt(r)&255}function h(i,e,t){return i.subarray(e,e+t).toString("utf8")}function b(i,e,t){return q.decode(new DataView(i.buffer,i.byteOffset+e,t))}var k=(s=>(s[s.UNSIGNED_INT_8=0]="UNSIGNED_INT_8",s[s.UNSIGNED_INT_16=1]="UNSIGNED_INT_16",s[s.UNSIGNED_INT_32=2]="UNSIGNED_INT_32",s[s.INT_8=3]="INT_8",s[s.INT_16=4]="INT_16",s[s.INT_32=5]="INT_32",s[s.FLOAT_32=6]="FLOAT_32",s[s.FLOAT_64=7]="FLOAT_64",s))(k||{});function j(i){return[i]}function K(i,e){if(e<0||!Number.isFinite(e))throw new RangeError("Length of a FixedArray must be a positive integer.");return[i,e]}var w=class{constructor(e,t){this.iterable=e;this.length=t}[Symbol.iterator](){return this.iterable[Symbol.iterator]()}};function M(i){if(i.length>8)throw new Error(`Invalid BinaryPacket definition: a BitFlags field can have only up to 8 flags, given: ${i.join(", ")}`);return{flags:i}}function W(){return""}function $(i){return{optional:i}}var E=class i{constructor(e,t){this.packetId=e;this.entries=t?Y(t):[];let n=Z(this.entries);this.minimumByteLength=n.minimumByteLength,this.stringPositions=n.stringPositions}static define(e,t){if(e<0||!Number.isFinite(e))throw new RangeError("Packet IDs must be positive integers.");if(e>255)throw new RangeError("Packet IDs greater than 255 are not supported. Do you REALLY need more than 255 different kinds of packets?");return new i(e,t)}static readPacketIdNodeBuffer(e,t=0){return e.readUint8(t)}static readPacketIdDataView(e,t=0){return e.getUint8(t)}static readPacketIdArrayBuffer(e,t){return new Uint8Array(e,t,1)[0]}static visitNodeBuffer(e,...t){return i.visit(e,c,h,t)}static visitDataView(e,...t){return i.visit(e,I,b,t)}static visitArrayBuffer(e,t,n,...r){return i.visit(new DataView(e,t,n),I,b,r)}readNodeBuffer(e,t={offset:0},n=e.byteLength){return this.read(e,t,n,c,h)}readDataView(e,t={offset:0},n=e.byteLength){return this.read(e,t,n,I,b)}readArrayBuffer(e,t,n){return this.read(p?Buffer.from(e,t,n):new DataView(e,t,n),{offset:0},n,p?c:I,p?h:b)}writeNodeBuffer(e){let t=this.precalculateBufferLengthWithStrings(e),n=Buffer.allocUnsafe(t);return this.write(n,e,{offset:0},t,t,g,S,U)}writeDataView(e){let t=this.precalculateBufferLengthWithStrings(e),n=new DataView(new ArrayBuffer(t));return this.write(n,e,{offset:0},t,t,_,x,G)}writeArrayBuffer(e){let t=p?this.writeNodeBuffer(e):this.writeDataView(e);return{buffer:t.buffer,byteLength:t.byteLength,byteOffset:t.byteOffset}}visitor(e){return[this,e]}sequentialSerializer(e,t){let n=this.minimumByteLength*e,r=Buffer.allocUnsafe(n),a={offset:0};for(let o of t)this.write(r,o,a,n,n,g,S,U)}entries;stringPositions;minimumByteLength;static visit(e,t,n,r){for(let[a,o]of r)if(a.packetId===t[0](e,0))return o(a.read(e,{offset:0},e.byteLength,t,n))}read(e,t,n,r,a){if(n+t.offset<this.minimumByteLength)throw new Error(`There is no space available to fit a packet of type ${this.packetId} at offset ${t.offset}`);if(r[0](e,t.offset)!==this.packetId)throw new Error(`Data at offset ${t.offset} is not a packet of type ${this.packetId}`);t.offset+=1;let o={};for(let[y,s]of this.entries)if(Array.isArray(s)){let d=s[1]??r[0](e,t.offset++),f=Array(d),u=s[0];if(typeof u=="object")for(let l=0;l<d;++l)f[l]=u.read(e,t,n,r,a);else if(u==="")for(let l=0;l<d;++l){let T=r[1](e,t.offset);t.offset+=2,f[l]=a(e,t.offset,T),t.offset+=T}else{let l=N[u];for(let T=0;T<d;++T)f[T]=r[u](e,t.offset),t.offset+=l}o[y]=f}else if(typeof s=="number")o[y]=r[s](e,t.offset),t.offset+=N[s];else if(s===""){let d=r[1](e,t.offset);t.offset+=2,o[y]=a(e,t.offset,d),t.offset+=d}else if("flags"in s){let d=r[0](e,t.offset);t.offset+=1,o[y]={};for(let f=0;f<s.flags.length;++f)o[y][s.flags[f]]=!!(d&1<<f)}else if("optional"in s){let d=r[0](e,t.offset)!==0;t.offset+=1,d&&(o[y]=s.optional.read(e,t,n,r,a))}else o[y]=s.read(e,t,n,r,a);return o}write(e,t,n,r,a,o,y,s){o[0](e,this.packetId,n.offset),n.offset+=1;for(let[d,f]of this.entries){let u=t[d];if(Array.isArray(f)){let l=u.length,T=f[1]===void 0;if(T&&(o[0](e,l,n.offset),n.offset+=1),l>0){let D=f[0];if(typeof D=="object"){if(T){let m=l*D.minimumByteLength;r+=m,a+=m,e.byteLength<a&&(e=y(e,a))}for(let m of u)e=D.write(e,m,n,r,a,o,y,s),r=n.offset,a=e.byteLength}else if(D==="")for(let m=0;m<l;++m){let B=u[m],A=B.length;o[1](e,A,n.offset),n.offset+=2,s(e,n.offset,B),n.offset+=A}else{let m=N[D];if(T){let B=l*m;r+=B,a+=B,e.byteLength<a&&(e=y(e,a))}for(let B of u)o[D](e,B,n.offset),n.offset+=m}}}else if(typeof f=="number")o[f](e,u,n.offset),n.offset+=N[f];else if(f===""){let l=u.length;o[1](e,l,n.offset),n.offset+=2,s(e,n.offset,u),n.offset+=l}else if("flags"in f){let l=0;for(let T=0;T<f.flags.length;++T)u[f.flags[T]]&&(l|=1<<T);o[0](e,l,n.offset),n.offset+=1}else"optional"in f?u?(o[0](e,1,n.offset),n.offset+=1,r+=f.optional.minimumByteLength,a+=f.optional.minimumByteLength,e.byteLength<a&&(e=y(e,a)),e=f.optional.write(e,u,n,r,a,o,y,s),r=n.offset,a=e.byteLength):(o[0](e,0,n.offset),n.offset+=1):(e=f.write(e,u,n,r,a,o,y,s),r=n.offset,a=e.byteLength)}return e}precalculateBufferLengthWithStrings(e){let t=this.minimumByteLength;for(let n of this.stringPositions[0])t+=e[n].length;for(let n of this.stringPositions[1])for(let r of e[n])t+=2+r.length;for(let n in this.stringPositions[2])t+=this.stringPositions[2][n].precalculateBufferLengthWithStrings(e[n]);return t}};function Y(i){return Object.entries(i).sort(([e],[t])=>e.localeCompare(t))}function Z(i){let e=1,t=[[],[],{}];for(let[n,r]of i)if(Array.isArray(r))if(r.length===2){let a=r[0]==="",o=typeof r[0]=="object"?r[0].minimumByteLength:a?2:N[r[0]];e+=r[1]*o,a&&t[1].push(n)}else e+=1,r[0]===""&&t[1].push(n);else r instanceof E?(e+=r.minimumByteLength,t[2][n]=r):typeof r=="object"?e+=1:r===""?(e+=2,t[0].push(n)):e+=N[r];return{minimumByteLength:e,stringPositions:t}}var N=Array(8);N[0]=1;N[3]=1;N[1]=2;N[4]=2;N[2]=4;N[5]=4;N[6]=4;N[7]=8;var I=Array(8);I[0]=(i,e)=>i.getUint8(e);I[3]=(i,e)=>i.getInt8(e);I[1]=(i,e)=>i.getUint16(e);I[4]=(i,e)=>i.getInt16(e);I[2]=(i,e)=>i.getUint32(e);I[5]=(i,e)=>i.getInt32(e);I[6]=(i,e)=>i.getFloat32(e);I[7]=(i,e)=>i.getFloat64(e);var _=Array(8);_[0]=(i,e,t)=>i.setUint8(t,e);_[3]=(i,e,t)=>i.setInt8(t,e);_[1]=(i,e,t)=>i.setUint16(t,e);_[4]=(i,e,t)=>i.setInt16(t,e);_[2]=(i,e,t)=>i.setUint32(t,e);_[5]=(i,e,t)=>i.setInt32(t,e);_[6]=(i,e,t)=>i.setFloat32(t,e);_[7]=(i,e,t)=>i.setFloat64(t,e);var g=Array(8);p&&(g[0]=(i,e,t)=>i.writeUint8(e,t),g[3]=(i,e,t)=>i.writeInt8(e,t),g[1]=(i,e,t)=>i.writeUint16BE(e,t),g[4]=(i,e,t)=>i.writeInt16BE(e,t),g[2]=(i,e,t)=>i.writeUint32BE(e,t),g[5]=(i,e,t)=>i.writeInt32BE(e,t),g[6]=(i,e,t)=>i.writeFloatBE(e,t),g[7]=(i,e,t)=>i.writeDoubleBE(e,t));var c=Array(8);p&&(c[0]=(i,e)=>i.readUint8(e),c[3]=(i,e)=>i.readInt8(e),c[1]=(i,e)=>i.readUint16BE(e),c[4]=(i,e)=>i.readInt16BE(e),c[2]=(i,e)=>i.readUint32BE(e),c[5]=(i,e)=>i.readInt32BE(e),c[6]=(i,e)=>i.readFloatBE(e),c[7]=(i,e)=>i.readDoubleBE(e));0&&(module.exports={BinaryPacket,Field,FieldArray,FieldBitFlags,FieldFixedArray,FieldOptional,FieldString,SequentialSerializer});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/buffers.ts"],"sourcesContent":["import {\r\n  decodeStringFromDataView,\r\n  decodeStringFromNodeBuffer,\r\n  encodeStringIntoDataView,\r\n  encodeStringIntoNodeBuffer,\r\n  growDataView,\r\n  growNodeBuffer,\r\n  hasNodeBuffers,\r\n  type TrueArrayBuffer\r\n} from './buffers'\r\n\r\nexport const enum Field {\r\n  /**\r\n   * Defines a 1 byte (8 bits) unsigned integer field. \\\r\n   * (Range: 0 - 255)\r\n   */\r\n  UNSIGNED_INT_8 = 0,\r\n\r\n  /**\r\n   * Defines a 2 bytes (16 bits) unsigned integer field. \\\r\n   * (Range: 0 - 65535)\r\n   */\r\n  UNSIGNED_INT_16,\r\n\r\n  /**\r\n   * Defines a 4 bytes (32 bits) unsigned integer field. \\\r\n   * (Range: 0 - 4294967295)\r\n   */\r\n  UNSIGNED_INT_32,\r\n\r\n  /**\r\n   * Defines a 1 byte (8 bits) signed integer field. \\\r\n   * (Range: -128 - 127)\r\n   */\r\n  INT_8,\r\n\r\n  /**\r\n   * Defines a 2 bytes (16 bits) signed integer field. \\\r\n   * (Range: -32768 - 32767)\r\n   */\r\n  INT_16,\r\n\r\n  /**\r\n   * Defines a 4 bytes (32 bits) signed integer field. \\\r\n   * (Range: -2147483648 - 2147483647)\r\n   */\r\n  INT_32,\r\n\r\n  /**\r\n   * Defines a 4 bytes (32 bits) floating-point field. \\\r\n   */\r\n  FLOAT_32,\r\n\r\n  /**\r\n   * Defines a 8 bytes (64 bits) floating-point field. \\\r\n   */\r\n  FLOAT_64\r\n}\r\n\r\n/**\r\n * Defines a dynamically-sized array with elements of a certain type. \\\r\n * Dynamically-sized arrays are useful when a packet's field is an array of a non pre-defined length. \\\r\n * Although, this makes dynamically-sized arrays more memory expensive as the internal buffer needs to be grown accordingly.\r\n *\r\n * NOTE: If an array will ALWAYS have the same length, prefer using the `FieldFixedArray` type, for both better performance and memory efficiency. \\\r\n * NOTE: As of now, dynamic arrays can have at most 256 elements.\r\n */\r\nexport function FieldArray<T extends Field | BinaryPacket<Definition> | ''>(\r\n  item: T\r\n): [itemType: T] {\r\n  return [item]\r\n}\r\n\r\n/**\r\n * Defines a statically-sized array with elements of a certain type. \\\r\n * Fixed arrays are useful when a packet's field is an array of a pre-defined length. \\\r\n * Fixed arrays much more memory efficient and performant than non-fixed ones.\r\n *\r\n * NOTE: If an array will not always have the same length, use the `FieldArray` type.\r\n */\r\nexport function FieldFixedArray<\r\n  T extends Field | BinaryPacket<Definition> | '',\r\n  Length extends number\r\n>(item: T, length: Length): [itemType: T, length: Length] {\r\n  if (length < 0 || !Number.isFinite(length)) {\r\n    throw new RangeError('Length of a FixedArray must be a positive integer.')\r\n  }\r\n\r\n  return [item, length]\r\n}\r\n\r\ntype BitFlags = (string[] | ReadonlyArray<string>) & {\r\n  length: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8\r\n}\r\n\r\n/**\r\n * Defines a sequence of up to 8 \"flags\" (basically single bits/booleans) that can be packed together into a single 8 bits value. \\\r\n * This is useful for minimizing bytes usage when there are lots of boolean fields/flags, instead of saving each flag separately as its own 8 bits value.\r\n *\r\n * The input should be an array of strings (with at most 8 elements) where each string defines the name of a flag. \\\r\n * This is just for definition purposes, then when actually writing or reading packets it'll just be a record-object with those names as keys and boolean values.\r\n */\r\nexport function FieldBitFlags<const FlagsArray extends BitFlags>(flags: FlagsArray) {\r\n  if (flags.length > 8) {\r\n    throw new Error(\r\n      `Invalid BinaryPacket definition: a BitFlags field can have only up to 8 flags, given: ${flags.join(', ')}`\r\n    )\r\n  }\r\n\r\n  return { flags }\r\n}\r\n\r\n/**\r\n * Defines a string field. \\\r\n * Strings cannot be more than 65536 characters long.\r\n *\r\n * NOTE: Only strings containing just ASCII and/or single-octet UTF-8 characters are supported.\r\n */\r\nexport function FieldString() {\r\n  return '' as const\r\n}\r\n\r\n/**\r\n * Defines an optional BinaryPacket \"subpacket\" field. \\\r\n * When writing and reading packets it'll be possible to provide and receive `undefined` instead of a valid object.\r\n */\r\nexport function FieldOptional<T extends BinaryPacket<Definition>>(packet: T) {\r\n  return { optional: packet }\r\n}\r\n\r\n/**\r\n * Do not manually construct this type: an object of this kind is returned by a BinaryPacket `createVisitor` method. \\\r\n * Used in the `BinaryPacket::visit` static method to perform a sort of \"pattern matching\" on an incoming packet (of yet unknown type) buffer.\r\n */\r\ntype Visitor = [BinaryPacket<Definition>, (packet: any) => void]\r\n\r\nexport class BinaryPacket<T extends Definition> {\r\n  /**\r\n   * Defines a new binary packet. \\\r\n   * Make sure that every `packetId` is unique.\r\n   * @throws RangeError If packetId is negative, floating-point, or greater than 255.\r\n   */\r\n  static define<T extends Definition>(packetId: number, definition?: T) {\r\n    if (packetId < 0 || !Number.isFinite(packetId)) {\r\n      throw new RangeError('Packet IDs must be positive integers.')\r\n    }\r\n\r\n    if (packetId > 255) {\r\n      throw new RangeError(\r\n        'Packet IDs greater than 255 are not supported. Do you REALLY need more than 255 different kinds of packets?'\r\n      )\r\n    }\r\n\r\n    return new BinaryPacket(packetId, definition)\r\n  }\r\n\r\n  /**\r\n   * Reads just the packetId from the given Buffer. \\\r\n   * This method practically just reads the uint8 at offset `byteOffset` (default: 0). \\\r\n   * Useful if the receiving side receives multiple types of packets.\r\n   */\r\n  static readPacketIdNodeBuffer(buffer: Buffer, byteOffset = 0) {\r\n    return buffer.readUint8(byteOffset)\r\n  }\r\n\r\n  /**\r\n   * Reads just the packetId from the given DataView. \\\r\n   * This method practically just reads the uint8 at offset `byteOffset` (default: 0). \\\r\n   * Useful if the receiving side receives multiple types of packets.\r\n   */\r\n  static readPacketIdDataView(dataview: DataView, byteOffset = 0) {\r\n    return dataview.getUint8(byteOffset)\r\n  }\r\n\r\n  /**\r\n   * Reads just the packetId from the given ArrayBuffer. \\\r\n   * This method practically just reads the uint8 at offset `byteOffset`. \\\r\n   * Useful if the receiving side receives multiple types of packets.\r\n   *\r\n   * NOTE: Due to security issues, the `byteOffset` argument cannot be defaulted and must be provided by the user. \\\r\n   * NOTE: For more information read the `readArrayBuffer` method documentation.\r\n   */\r\n  static readPacketIdArrayBuffer(arraybuffer: TrueArrayBuffer, byteOffset: number) {\r\n    return new Uint8Array(arraybuffer, byteOffset, 1)[0]\r\n  }\r\n\r\n  /**\r\n   * Visits and \"pattern matches\" the given Buffer through the given visitors. \\\r\n   * The Buffer is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\r\n   *\r\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\r\n   */\r\n  static visitNodeBuffer(buffer: Buffer, ...visitors: Visitor[]) {\r\n    return BinaryPacket.visit(buffer, GET_FUNCTION_BUF, decodeStringFromNodeBuffer, visitors)\r\n  }\r\n\r\n  /**\r\n   * Visits and \"pattern matches\" the given DataView through the given visitors. \\\r\n   * The DataView is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\r\n   *\r\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\r\n   */\r\n  static visitDataView(dataview: DataView, ...visitors: Visitor[]) {\r\n    return BinaryPacket.visit(dataview, GET_FUNCTION, decodeStringFromDataView, visitors)\r\n  }\r\n\r\n  /**\r\n   * Visits and \"pattern matches\" the given ArrayBuffer through the given visitors. \\\r\n   * The ArrayBuffer is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\r\n   *\r\n   * NOTE: Due to security issues, the `byteOffset` and `byteLength` arguments must be provided by the user. \\\r\n   * NOTE: For more information read the `readArrayBuffer` method documentation. \\\r\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\r\n   */\r\n  static visitArrayBuffer(\r\n    arraybuffer: TrueArrayBuffer,\r\n    byteOffset: number,\r\n    byteLength: number,\r\n    ...visitors: Visitor[]\r\n  ) {\r\n    return BinaryPacket.visit(\r\n      new DataView(arraybuffer, byteOffset, byteLength),\r\n      GET_FUNCTION,\r\n      decodeStringFromDataView,\r\n      visitors\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Reads/deserializes from the given Buffer. \\\r\n   * Method available ONLY on NodeJS and Bun.\r\n   *\r\n   * If possible, always prefer reading using this method, as it is much faster than the other ones.\r\n   *\r\n   * NOTE: if you have an ArrayBuffer do not bother wrapping it into a node Buffer yourself. \\\r\n   * NOTE: if you have an ArrayBuffer use the appropriate `readArrayBuffer`.\r\n   */\r\n  readNodeBuffer(\r\n    dataIn: Buffer,\r\n    offsetPointer = { offset: 0 },\r\n    byteLength = dataIn.byteLength\r\n  ): ToJson<T> {\r\n    return this.read(\r\n      dataIn,\r\n      offsetPointer,\r\n      byteLength,\r\n      GET_FUNCTION_BUF,\r\n      decodeStringFromNodeBuffer\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Reads/deserializes from the given DataView.\r\n   *\r\n   * NOTE: if you have an ArrayBuffer do not bother wrapping it into a DataView yourself. \\\r\n   * NOTE: if you have an ArrayBuffer use the appropriate `readArrayBuffer`.\r\n   */\r\n  readDataView(\r\n    dataIn: DataView,\r\n    offsetPointer = { offset: 0 },\r\n    byteLength = dataIn.byteLength\r\n  ): ToJson<T> {\r\n    return this.read(dataIn, offsetPointer, byteLength, GET_FUNCTION, decodeStringFromDataView)\r\n  }\r\n\r\n  /**\r\n   * Reads/deserializes from the given ArrayBuffer. \\\r\n   * WARNING: this method is practically a HACK.\r\n   *\r\n   * When using this method both the `byteOffset` and `byteLength` are REQUIRED and cannot be defaulted. \\\r\n   * This is to prevent serious bugs and security issues. \\\r\n   * That is because often raw ArrayBuffers come from a pre-allocated buffer pool and do not start at byteOffset 0.\r\n   *\r\n   * NOTE: if you have a node Buffer do not bother wrapping it into an ArrayBuffer yourself. \\\r\n   * NOTE: if you have a node Buffer use the appropriate `readNodeBuffer` as it is much faster and less error prone.\r\n   */\r\n  readArrayBuffer(dataIn: TrueArrayBuffer, byteOffset: number, byteLength: number) {\r\n    return this.read(\r\n      hasNodeBuffers\r\n        ? Buffer.from(dataIn, byteOffset, byteLength)\r\n        : (new DataView(dataIn, byteOffset, byteLength) as any),\r\n      { offset: 0 }, // The underlying buffer has already been offsetted\r\n      byteLength,\r\n      hasNodeBuffers ? GET_FUNCTION_BUF : GET_FUNCTION,\r\n      hasNodeBuffers ? decodeStringFromNodeBuffer : (decodeStringFromDataView as any)\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Writes/serializes the given object into a Buffer. \\\r\n   * Method available ONLY on NodeJS and Bun.\r\n   *\r\n   * If possible, always prefer writing using this method, as it is much faster than the other ones.\r\n   */\r\n  writeNodeBuffer(dataOut: ToJson<T>) {\r\n    const byteLength = this.precalculateBufferLengthWithStrings(dataOut)\r\n    const buffer = Buffer.allocUnsafe(byteLength)\r\n\r\n    return this.write(\r\n      buffer,\r\n      dataOut,\r\n      { offset: 0 },\r\n      byteLength,\r\n      byteLength,\r\n      SET_FUNCTION_BUF,\r\n      growNodeBuffer,\r\n      encodeStringIntoNodeBuffer\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Writes/serializes the given object into a DataView. \\\r\n   */\r\n  writeDataView(dataOut: ToJson<T>) {\r\n    const byteLength = this.precalculateBufferLengthWithStrings(dataOut)\r\n    const dataview = new DataView(new ArrayBuffer(byteLength))\r\n\r\n    return this.write(\r\n      dataview,\r\n      dataOut,\r\n      { offset: 0 },\r\n      byteLength,\r\n      byteLength,\r\n      SET_FUNCTION,\r\n      growDataView,\r\n      encodeStringIntoDataView\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Writes/serializes the given object into an ArrayBuffer. \\\r\n   * This method is just a wrapper around either  `writeNodeBuffer` or `writeDataView`. \\\r\n   *\r\n   * This method works with JavaScript standard raw ArrayBuffer(s) and, as such, is very error prone: \\\r\n   * Make sure you're using the returned byteLength and byteOffset fields in the read counterpart. \\\r\n   *\r\n   * Always consider whether is possible to use directly `writeNodeBuffer` or `writeDataView` instead of `writeArrayBuffer`. \\\r\n   * For more information read the `readArrayBuffer` documentation.\r\n   */\r\n  writeArrayBuffer(dataOut: ToJson<T>) {\r\n    const buf = hasNodeBuffers ? this.writeNodeBuffer(dataOut) : this.writeDataView(dataOut)\r\n    return { buffer: buf.buffer, byteLength: buf.byteLength, byteOffset: buf.byteOffset }\r\n  }\r\n\r\n  /**\r\n   * Creates a \"visitor\" object for this BinaryPacket definition. \\\r\n   * Used when visiting and \"pattern matching\" buffers with the `BinaryPacket::visit` static utility methods. \\\r\n   *\r\n   * For more information read the `BinaryPacket::visitNodeBuffer` documentation. \\\r\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\r\n   */\r\n  visitor(onVisit: (packet: ToJson<T>) => void): Visitor {\r\n    return [this, onVisit]\r\n  }\r\n\r\n  /// PRIVATE\r\n\r\n  private readonly entries: Entries\r\n  readonly stringPositions: StringPositions\r\n  readonly minimumByteLength: number\r\n\r\n  private constructor(\r\n    private readonly packetId: number,\r\n    definition?: T\r\n  ) {\r\n    this.entries = definition ? sortEntries(definition) : []\r\n    const inspection = inspectEntries(this.entries)\r\n    this.minimumByteLength = inspection.minimumByteLength\r\n    this.stringPositions = inspection.stringPositions\r\n  }\r\n\r\n  private static visit<Buf extends DataView | Buffer>(\r\n    dataIn: Buf,\r\n    readFunctions: typeof GET_FUNCTION | typeof GET_FUNCTION_BUF,\r\n    decodeStringFunction: (dataIn: Buf, byteOffset: number, strlen: number) => string,\r\n    visitors: Visitor[]\r\n  ) {\r\n    for (const [Packet, onVisit] of visitors) {\r\n      if (Packet.packetId === readFunctions[Field.UNSIGNED_INT_8](dataIn as any, 0)) {\r\n        return onVisit(\r\n          Packet.read(dataIn, { offset: 0 }, dataIn.byteLength, readFunctions, decodeStringFunction)\r\n        )\r\n      }\r\n    }\r\n  }\r\n\r\n  private read<Buf extends DataView | Buffer>(\r\n    dataIn: Buf,\r\n    offsetPointer: { offset: number },\r\n    byteLength: number,\r\n    readFunctions: typeof GET_FUNCTION | typeof GET_FUNCTION_BUF,\r\n    decodeStringFunction: (dataIn: Buf, byteOffset: number, strlen: number) => string\r\n  ): ToJson<T> {\r\n    if (byteLength + offsetPointer.offset < this.minimumByteLength) {\r\n      throw new Error(\r\n        `There is no space available to fit a packet of type ${this.packetId} at offset ${offsetPointer.offset}`\r\n      )\r\n    }\r\n\r\n    if (\r\n      readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset) !== this.packetId\r\n    ) {\r\n      throw new Error(\r\n        `Data at offset ${offsetPointer.offset} is not a packet of type ${this.packetId}`\r\n      )\r\n    }\r\n\r\n    offsetPointer.offset += 1\r\n    const result: any = {}\r\n\r\n    for (const [name, def] of this.entries) {\r\n      if (Array.isArray(def)) {\r\n        const length =\r\n          // def[1] is the length of a statically-sized array, if undefined: must read the length from the buffer as it means it's a dynamically-sized array\r\n          def[1] ?? readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset++)\r\n\r\n        const array = Array(length)\r\n\r\n        const itemType = def[0]\r\n\r\n        if (typeof itemType === 'object') {\r\n          // Array of \"subpackets\"\r\n          for (let i = 0; i < length; ++i) {\r\n            array[i] = itemType.read(\r\n              dataIn,\r\n              offsetPointer,\r\n              byteLength,\r\n              readFunctions,\r\n              decodeStringFunction\r\n            )\r\n          }\r\n        } else if (itemType === '') {\r\n          // Array of strings\r\n          for (let i = 0; i < length; ++i) {\r\n            const strlen = readFunctions[Field.UNSIGNED_INT_16](dataIn as any, offsetPointer.offset)\r\n            offsetPointer.offset += 2\r\n\r\n            array[i] = decodeStringFunction(dataIn, offsetPointer.offset, strlen)\r\n            offsetPointer.offset += strlen\r\n          }\r\n        } else {\r\n          // Array of primitives (numbers)\r\n          const itemSize = BYTE_SIZE[itemType]\r\n\r\n          // It seems like looping over each element is actually much faster than using TypedArrays bulk copy.\r\n          // TODO: properly benchmark with various array sizes to see if it's actually the case.\r\n          for (let i = 0; i < length; ++i) {\r\n            array[i] = readFunctions[itemType](dataIn as any, offsetPointer.offset)\r\n            offsetPointer.offset += itemSize\r\n          }\r\n        }\r\n\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = array\r\n      } else if (typeof def === 'number') {\r\n        // Single primitive (number)\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = readFunctions[def](dataIn as any, offsetPointer.offset)\r\n        offsetPointer.offset += BYTE_SIZE[def]\r\n      } else if (def === '') {\r\n        const strlen = readFunctions[Field.UNSIGNED_INT_16](dataIn as any, offsetPointer.offset)\r\n        offsetPointer.offset += 2\r\n\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = decodeStringFunction(dataIn, offsetPointer.offset, strlen)\r\n        offsetPointer.offset += strlen\r\n      } else if ('flags' in def) {\r\n        // BitFlags\r\n        const flags = readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset)\r\n        offsetPointer.offset += 1\r\n\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = {}\r\n\r\n        for (let bit = 0; bit < def.flags.length; ++bit) {\r\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n          result[name][def.flags[bit]] = !!(flags & (1 << bit))\r\n        }\r\n      } else if ('optional' in def) {\r\n        // Single optional \"subpacket\"\r\n        const hasSubPacket =\r\n          readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset) !== 0\r\n\r\n        offsetPointer.offset += 1\r\n\r\n        if (hasSubPacket) {\r\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n          result[name] = def.optional.read(\r\n            dataIn,\r\n            offsetPointer,\r\n            byteLength,\r\n            readFunctions,\r\n            decodeStringFunction\r\n          )\r\n        }\r\n      } else {\r\n        // Single \"subpacket\"\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = def.read(\r\n          dataIn,\r\n          offsetPointer,\r\n          byteLength,\r\n          readFunctions,\r\n          decodeStringFunction\r\n        )\r\n      }\r\n    }\r\n\r\n    return result as ToJson<T>\r\n  }\r\n\r\n  private write<Buf extends DataView | Buffer>(\r\n    buffer: Buf,\r\n    dataOut: ToJson<T>,\r\n    offsetPointer: { offset: number },\r\n    byteLength: number,\r\n    maxByteLength: number,\r\n    writeFunctions: typeof SET_FUNCTION | typeof SET_FUNCTION_BUF,\r\n    growBufferFunction: (buffer: Buf, newByteLength: number) => Buf,\r\n    encodeStringFunction: (buffer: Buf, byteOffset: number, string: string) => void\r\n  ): Buf {\r\n    writeFunctions[Field.UNSIGNED_INT_8](buffer as any, this.packetId, offsetPointer.offset)\r\n    offsetPointer.offset += 1\r\n\r\n    for (const [name, def] of this.entries) {\r\n      const data = dataOut[name]\r\n\r\n      if (Array.isArray(def)) {\r\n        // Could be both an array of just numbers or \"subpackets\"\r\n\r\n        const length = (data as any[]).length\r\n\r\n        // Check if it is a dynamically-sized array, if it is, the length of the array must be serialized in the buffer before its elements\r\n        // Explicitly check for undefined and not falsy values because it could be a statically-sized array of 0 elements.\r\n        const isDynamicArray = def[1] === undefined\r\n\r\n        if (isDynamicArray) {\r\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, length, offsetPointer.offset)\r\n          offsetPointer.offset += 1\r\n        }\r\n\r\n        if (length > 0) {\r\n          const itemType = def[0]\r\n\r\n          if (typeof itemType === 'object') {\r\n            // Array of \"subpackets\"\r\n\r\n            if (isDynamicArray) {\r\n              const neededBytesForElements = length * itemType.minimumByteLength\r\n\r\n              byteLength += neededBytesForElements\r\n              maxByteLength += neededBytesForElements\r\n\r\n              if (buffer.byteLength < maxByteLength) {\r\n                buffer = growBufferFunction(buffer, maxByteLength)\r\n              }\r\n            }\r\n\r\n            for (const object of data as unknown as ToJson<Definition>[]) {\r\n              // Array of \"subpackets\"\r\n              buffer = itemType.write(\r\n                buffer,\r\n                object,\r\n                offsetPointer,\r\n                byteLength,\r\n                maxByteLength,\r\n                writeFunctions,\r\n                growBufferFunction,\r\n                encodeStringFunction\r\n              )\r\n\r\n              byteLength = offsetPointer.offset\r\n              maxByteLength = buffer.byteLength\r\n            }\r\n          } else if (itemType === '') {\r\n            // Array of strings\r\n            for (let i = 0; i < length; ++i) {\r\n              const str = (data as unknown as string[])[i]\r\n              const strlen = str.length\r\n\r\n              writeFunctions[Field.UNSIGNED_INT_16](buffer as any, strlen, offsetPointer.offset)\r\n              offsetPointer.offset += 2\r\n\r\n              encodeStringFunction(buffer, offsetPointer.offset, str)\r\n              offsetPointer.offset += strlen\r\n            }\r\n          } else {\r\n            // Array of primitives (numbers)\r\n            const itemSize = BYTE_SIZE[itemType]\r\n\r\n            if (isDynamicArray) {\r\n              const neededBytesForElements = length * itemSize\r\n\r\n              byteLength += neededBytesForElements\r\n              maxByteLength += neededBytesForElements\r\n\r\n              if (buffer.byteLength < maxByteLength) {\r\n                buffer = growBufferFunction(buffer, maxByteLength)\r\n              }\r\n            }\r\n\r\n            // It seems like looping over each element is actually much faster than using TypedArrays bulk copy.\r\n            // TODO: properly benchmark with various array sizes to see if it's actually the case.\r\n            for (const number of data as number[]) {\r\n              writeFunctions[itemType](buffer as any, number, offsetPointer.offset)\r\n              offsetPointer.offset += itemSize\r\n            }\r\n          }\r\n        }\r\n      } else if (typeof def === 'number') {\r\n        // Single primitive (number)\r\n        writeFunctions[def](buffer as any, data as number, offsetPointer.offset)\r\n        offsetPointer.offset += BYTE_SIZE[def]\r\n      } else if (def === '') {\r\n        // String\r\n        const strlen = (data as string).length\r\n\r\n        writeFunctions[Field.UNSIGNED_INT_16](buffer as any, strlen, offsetPointer.offset)\r\n        offsetPointer.offset += 2\r\n\r\n        encodeStringFunction(buffer, offsetPointer.offset, data as string)\r\n        offsetPointer.offset += strlen\r\n      } else if ('flags' in def) {\r\n        // BitFlags\r\n        let flags = 0\r\n\r\n        for (let bit = 0; bit < def.flags.length; ++bit) {\r\n          if ((data as Record<string, boolean>)[def.flags[bit]]) {\r\n            flags |= 1 << bit\r\n          }\r\n        }\r\n\r\n        writeFunctions[Field.UNSIGNED_INT_8](buffer as any, flags, offsetPointer.offset)\r\n        offsetPointer.offset += 1\r\n      } else if ('optional' in def) {\r\n        if (data) {\r\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, 1, offsetPointer.offset)\r\n          offsetPointer.offset += 1\r\n\r\n          byteLength += def.optional.minimumByteLength\r\n          maxByteLength += def.optional.minimumByteLength\r\n\r\n          if (buffer.byteLength < maxByteLength) {\r\n            buffer = growBufferFunction(buffer, maxByteLength)\r\n          }\r\n\r\n          buffer = def.optional.write(\r\n            buffer,\r\n            data as ToJson<Definition>,\r\n            offsetPointer,\r\n            byteLength,\r\n            maxByteLength,\r\n            writeFunctions,\r\n            growBufferFunction,\r\n            encodeStringFunction\r\n          )\r\n\r\n          byteLength = offsetPointer.offset\r\n          maxByteLength = buffer.byteLength\r\n        } else {\r\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, 0, offsetPointer.offset)\r\n          offsetPointer.offset += 1\r\n        }\r\n      } else {\r\n        // Single \"subpacket\"\r\n        buffer = def.write(\r\n          buffer,\r\n          data as ToJson<Definition>,\r\n          offsetPointer,\r\n          byteLength,\r\n          maxByteLength,\r\n          writeFunctions,\r\n          growBufferFunction,\r\n          encodeStringFunction\r\n        )\r\n\r\n        byteLength = offsetPointer.offset\r\n        maxByteLength = buffer.byteLength\r\n      }\r\n    }\r\n\r\n    return buffer\r\n  }\r\n\r\n  private precalculateBufferLengthWithStrings(dataOut: ToJson<T>) {\r\n    let len = this.minimumByteLength\r\n\r\n    for (const field of this.stringPositions[0]) {\r\n      // String field\r\n      len += (dataOut[field] as string).length\r\n    }\r\n\r\n    for (const field of this.stringPositions[1]) {\r\n      // Array of strings field\r\n      for (const string of dataOut[field] as unknown as string[]) {\r\n        len += 2 + string.length\r\n      }\r\n    }\r\n\r\n    for (const field in this.stringPositions[2]) {\r\n      // Subpacket that has some string fields\r\n      len += this.stringPositions[2][field].precalculateBufferLengthWithStrings(\r\n        dataOut[field] as any\r\n      )\r\n    }\r\n\r\n    return len\r\n  }\r\n}\r\n\r\n/**\r\n * BinaryPacket definition: \\\r\n * Any packet can be defined through a \"schema\" object explaining its fields names and types.\r\n *\r\n * @example\r\n * // Imagine we have a game board where each cell is a square and is one unit big.\r\n * // A cell can be then defined by its X and Y coordinates.\r\n * // For simplicity, let's say there cannot be more than 256 cells, so we can use 8 bits for each coordinate.\r\n * const Cell = {\r\n *  x: Field.UNSIGNED_INT_8,\r\n *  y: Field.UNSIGNED_INT_8\r\n * }\r\n *\r\n * // When done with the cell definition we can create its BinaryPacket writer/reader.\r\n * // NOTE: each BinaryPacket needs an unique ID, for identification purposes and error checking.\r\n * const CellPacket = BinaryPacket.define(0, Cell)\r\n *\r\n * // Let's now make the definition of the whole game board.\r\n * // You can also specify arrays of both \"primitive\" fields and other BinaryPackets.\r\n * const Board = {\r\n *  numPlayers: Field.UNSIGNED_INT_8,\r\n *  cells: FieldArray(CellPacket)\r\n * }\r\n *\r\n * // When done with the board definition we can create its BinaryPacket writer/reader.\r\n * // NOTE: each BinaryPacket needs an unique ID, for identification purposes and error checking.\r\n * const BoardPacket = BinaryPacket.define(1, Board)\r\n *\r\n * // And use it.\r\n * const buffer = BoardPacket.writeNodeBuffer({\r\n *  numPlayers: 1,\r\n *  cells: [\r\n *    { x: 0, y: 0 },\r\n *    { x: 1, y: 1 }\r\n *  ]\r\n * })\r\n *\r\n * // sendTheBufferOver(buffer)\r\n * // ...\r\n * // const buffer = receiveTheBuffer()\r\n * const board = BoardPacket.readNodeBuffer(buffer)\r\n * // ...\r\n */\r\nexport type Definition = {\r\n  [fieldName: string]:\r\n    | MaybeArray<Field>\r\n    | MaybeArray<BinaryPacket<Definition>>\r\n    | MaybeArray<''>\r\n    | { flags: BitFlags }\r\n    | { optional: BinaryPacket<Definition> }\r\n}\r\n\r\ntype MaybeArray<T> = T | [itemType: T] | [itemType: T, length: number]\r\n\r\ntype BitFlagsToJson<FlagsArray extends BitFlags> = {\r\n  [key in FlagsArray[number]]: boolean\r\n}\r\n\r\n/**\r\n * Meta-type that converts a `Definition` schema to the type of the actual JavaScript object that will be written into a packet or read from. \\\r\n */\r\nexport type ToJson<T extends Definition> = {\r\n  [K in keyof T]: T[K] extends [infer Item]\r\n    ? Item extends BinaryPacket<infer BPDef>\r\n      ? ToJson<BPDef>[]\r\n      : Item extends ''\r\n        ? string[]\r\n        : number[]\r\n    : T[K] extends [infer Item, infer Length]\r\n      ? Item extends BinaryPacket<infer BPDef>\r\n        ? ToJson<BPDef>[] & { length: Length }\r\n        : Item extends ''\r\n          ? string[] & { length: Length }\r\n          : number[] & { length: Length }\r\n      : T[K] extends BinaryPacket<infer BPDef>\r\n        ? ToJson<BPDef>\r\n        : T[K] extends { flags: infer FlagsArray extends BitFlags }\r\n          ? BitFlagsToJson<FlagsArray>\r\n          : T[K] extends { optional: BinaryPacket<infer BPDef extends Definition> }\r\n            ? ToJson<BPDef> | undefined\r\n            : T[K] extends ''\r\n              ? string\r\n              : number\r\n}\r\n\r\n/**\r\n * In a JavaScript object, the order of its keys is not strictly defined: sort them by field name. \\\r\n * Thus, we cannot trust iterating over an object keys: we MUST iterate over its entries array. \\\r\n * This is important to make sure that whoever shares BinaryPacket definitions can correctly write/read packets independently of their JS engines.\r\n */\r\nfunction sortEntries(definition: Definition) {\r\n  return Object.entries(definition).sort(([fieldName1], [fieldName2]) =>\r\n    fieldName1.localeCompare(fieldName2)\r\n  )\r\n}\r\n\r\ntype Entries = ReturnType<typeof sortEntries>\r\n\r\ntype StringPositions = [\r\n  string[],\r\n  string[],\r\n  {\r\n    [field: string]: BinaryPacket<Definition>\r\n  }\r\n]\r\n\r\n/**\r\n * Helper function that \"inspects\" the entries of a BinaryPacket definition\r\n * and returns useful \"stats\" needed for writing and reading buffers.\r\n *\r\n * This function is ever called only once per BinaryPacket definition.\r\n */\r\nfunction inspectEntries(entries: Entries) {\r\n  // The PacketID is already 1 byte, that's why we aren't starting from 0.\r\n  let minimumByteLength = 1\r\n\r\n  const stringPositions: StringPositions = [[], [], {}]\r\n\r\n  for (const [name, type] of entries) {\r\n    if (Array.isArray(type)) {\r\n      if (type.length === 2) {\r\n        // Statically-sized array\r\n        const isString = type[0] === ''\r\n\r\n        const itemSize =\r\n          typeof type[0] === 'object'\r\n            ? type[0].minimumByteLength\r\n            : isString\r\n              ? 2\r\n              : BYTE_SIZE[type[0]]\r\n\r\n        minimumByteLength += type[1] * itemSize\r\n\r\n        if (isString) {\r\n          stringPositions[1].push(name)\r\n        }\r\n      } else {\r\n        // Dynamically-sized array\r\n        // Adding 1 byte to serialize the array length\r\n        minimumByteLength += 1\r\n\r\n        if (type[0] === '') {\r\n          stringPositions[1].push(name)\r\n        }\r\n      }\r\n    } else if (type instanceof BinaryPacket) {\r\n      minimumByteLength += type.minimumByteLength\r\n      stringPositions[2][name] = type\r\n    } else if (typeof type === 'object') {\r\n      // BitFlags & Optionals\r\n      // BitFlags are always 1 byte long, because they can hold up to 8 booleans\r\n      // Optionals minimum is 1 byte long, because it holds whether the subpacket is present or not\r\n      minimumByteLength += 1\r\n    } else if (type === '') {\r\n      // String\r\n      // Adding 2 to serialize the string length\r\n      minimumByteLength += 2\r\n      stringPositions[0].push(name)\r\n    } else {\r\n      minimumByteLength += BYTE_SIZE[type]\r\n    }\r\n  }\r\n\r\n  return { minimumByteLength, stringPositions }\r\n}\r\n\r\n//////////////////////////////////////////////\r\n// The logic here is practically over       //\r\n// Here below there are needed constants    //\r\n// that map a field-type to a functionality //\r\n//////////////////////////////////////////////\r\n\r\nconst BYTE_SIZE = Array(8) as number[]\r\n\r\nBYTE_SIZE[Field.UNSIGNED_INT_8] = 1\r\nBYTE_SIZE[Field.INT_8] = 1\r\n\r\nBYTE_SIZE[Field.UNSIGNED_INT_16] = 2\r\nBYTE_SIZE[Field.INT_16] = 2\r\n\r\nBYTE_SIZE[Field.UNSIGNED_INT_32] = 4\r\nBYTE_SIZE[Field.INT_32] = 4\r\nBYTE_SIZE[Field.FLOAT_32] = 4\r\n\r\nBYTE_SIZE[Field.FLOAT_64] = 8\r\n\r\nconst GET_FUNCTION = Array(8) as ((view: DataView, offset: number) => number)[]\r\n\r\nGET_FUNCTION[Field.UNSIGNED_INT_8] = (view, offset) => view.getUint8(offset)\r\nGET_FUNCTION[Field.INT_8] = (view, offset) => view.getInt8(offset)\r\nGET_FUNCTION[Field.UNSIGNED_INT_16] = (view, offset) => view.getUint16(offset)\r\nGET_FUNCTION[Field.INT_16] = (view, offset) => view.getInt16(offset)\r\nGET_FUNCTION[Field.UNSIGNED_INT_32] = (view, offset) => view.getUint32(offset)\r\nGET_FUNCTION[Field.INT_32] = (view, offset) => view.getInt32(offset)\r\nGET_FUNCTION[Field.FLOAT_32] = (view, offset) => view.getFloat32(offset)\r\nGET_FUNCTION[Field.FLOAT_64] = (view, offset) => view.getFloat64(offset)\r\n\r\nconst SET_FUNCTION = Array(8) as ((view: DataView, value: number, offset: number) => void)[]\r\n\r\nSET_FUNCTION[Field.UNSIGNED_INT_8] = (view, value, offset) => view.setUint8(offset, value)\r\nSET_FUNCTION[Field.INT_8] = (view, value, offset) => view.setInt8(offset, value)\r\nSET_FUNCTION[Field.UNSIGNED_INT_16] = (view, value, offset) => view.setUint16(offset, value)\r\nSET_FUNCTION[Field.INT_16] = (view, value, offset) => view.setInt16(offset, value)\r\nSET_FUNCTION[Field.UNSIGNED_INT_32] = (view, value, offset) => view.setUint32(offset, value)\r\nSET_FUNCTION[Field.INT_32] = (view, value, offset) => view.setInt32(offset, value)\r\nSET_FUNCTION[Field.FLOAT_32] = (view, value, offset) => view.setFloat32(offset, value)\r\nSET_FUNCTION[Field.FLOAT_64] = (view, value, offset) => view.setFloat64(offset, value)\r\n\r\nconst SET_FUNCTION_BUF = Array(8) as ((nodeBuffer: Buffer, value: number, offset: number) => void)[]\r\n\r\nif (hasNodeBuffers) {\r\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_8] = (view, value, offset) => view.writeUint8(value, offset)\r\n  SET_FUNCTION_BUF[Field.INT_8] = (view, value, offset) => view.writeInt8(value, offset)\r\n\r\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_16] = (view, value, offset) =>\r\n    view.writeUint16BE(value, offset)\r\n  SET_FUNCTION_BUF[Field.INT_16] = (view, value, offset) => view.writeInt16BE(value, offset)\r\n\r\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_32] = (view, value, offset) =>\r\n    view.writeUint32BE(value, offset)\r\n  SET_FUNCTION_BUF[Field.INT_32] = (view, value, offset) => view.writeInt32BE(value, offset)\r\n  SET_FUNCTION_BUF[Field.FLOAT_32] = (view, value, offset) => view.writeFloatBE(value, offset)\r\n\r\n  SET_FUNCTION_BUF[Field.FLOAT_64] = (view, value, offset) => view.writeDoubleBE(value, offset)\r\n}\r\n\r\nconst GET_FUNCTION_BUF = Array(8) as ((nodeBuffer: Buffer, offset: number) => number)[]\r\n\r\nif (hasNodeBuffers) {\r\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_8] = (view, offset) => view.readUint8(offset)\r\n  GET_FUNCTION_BUF[Field.INT_8] = (view, offset) => view.readInt8(offset)\r\n\r\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_16] = (view, offset) => view.readUint16BE(offset)\r\n  GET_FUNCTION_BUF[Field.INT_16] = (view, offset) => view.readInt16BE(offset)\r\n\r\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_32] = (view, offset) => view.readUint32BE(offset)\r\n  GET_FUNCTION_BUF[Field.INT_32] = (view, offset) => view.readInt32BE(offset)\r\n  GET_FUNCTION_BUF[Field.FLOAT_32] = (view, offset) => view.readFloatBE(offset)\r\n\r\n  GET_FUNCTION_BUF[Field.FLOAT_64] = (view, offset) => view.readDoubleBE(offset)\r\n}\r\n","/**\r\n * Exclusively matches objects of type `ArrayBuffer` and no other types that inherit from it. \\\r\n * This is needed because the `DataView` constructor explicitly requires a \"true\" ArrayBuffer, or else it throws.\r\n */\r\nexport type TrueArrayBuffer = ArrayBuffer & { buffer?: undefined }\r\n\r\nexport const hasNodeBuffers = typeof Buffer === 'function'\r\n\r\nexport function growDataView(dataview: DataView, newByteLength: number) {\r\n  const resizedBuffer = new ArrayBuffer(newByteLength)\r\n  const amountToCopy = Math.min(dataview.byteLength, resizedBuffer.byteLength)\r\n\r\n  // Treat the buffer as if it was a Float64Array so we can copy 8 bytes at a time, to finish faster\r\n  let length = Math.trunc(amountToCopy / 8)\r\n  new Float64Array(resizedBuffer, 0, length).set(new Float64Array(dataview.buffer, 0, length))\r\n\r\n  // Copy the remaining up to 7 bytes\r\n  const offset = length * 8\r\n  length = amountToCopy - offset\r\n  new Uint8Array(resizedBuffer, offset, length).set(new Uint8Array(dataview.buffer, offset, length))\r\n\r\n  return new DataView(resizedBuffer)\r\n}\r\n\r\nexport function growNodeBuffer(buffer: Buffer, newByteLength: number) {\r\n  const newBuffer = Buffer.allocUnsafe(newByteLength)\r\n  buffer.copy(newBuffer)\r\n  return newBuffer\r\n}\r\n\r\nconst textEncoder = new TextEncoder()\r\nconst textDecoder = new TextDecoder()\r\n\r\nexport function encodeStringIntoDataView(dataview: DataView, byteOffset: number, string: string) {\r\n  const strlen = string.length\r\n  const u8Buffer = new Uint8Array(dataview.buffer, dataview.byteOffset + byteOffset, strlen)\r\n\r\n  if (strlen <= 64) {\r\n    encodeSmallString(u8Buffer, 0, string, strlen)\r\n  } else {\r\n    textEncoder.encodeInto(string, u8Buffer)\r\n  }\r\n}\r\n\r\nexport function encodeStringIntoNodeBuffer(buffer: Buffer, byteOffset: number, string: string) {\r\n  const strlen = string.length\r\n\r\n  if (strlen <= 64) {\r\n    encodeSmallString(buffer, byteOffset, string, strlen)\r\n  } else {\r\n    buffer.utf8Write(string, byteOffset, strlen)\r\n  }\r\n}\r\n\r\nfunction encodeSmallString(buffer: Uint8Array, byteOffset: number, string: string, strlen: number) {\r\n  for (let i = 0; i < strlen; ++i) {\r\n    buffer[byteOffset + i] = string.charCodeAt(i) & 0xff\r\n  }\r\n}\r\n\r\nexport function decodeStringFromNodeBuffer(buffer: Buffer, byteOffset: number, strlen: number) {\r\n  return buffer.subarray(byteOffset, byteOffset + strlen).toString('utf8')\r\n}\r\n\r\nexport function decodeStringFromDataView(dataview: DataView, byteOffset: number, strlen: number) {\r\n  return textDecoder.decode(new DataView(dataview.buffer, dataview.byteOffset + byteOffset, strlen))\r\n}\r\n\r\ndeclare global {\r\n  interface Buffer {\r\n    /**\r\n     * Node buffer's internals function. \\\r\n     * For some reason it is not exposed through TypeScript. \\\r\n     * Fastest way to write utf8 strings into buffers.\r\n     */\r\n    utf8Write(string: string, byteOffset?: number, byteLength?: number): number\r\n  }\r\n}\r\n"],"mappings":"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","names":["src_exports","__export","BinaryPacket","Field","FieldArray","FieldBitFlags","FieldFixedArray","FieldOptional","FieldString","__toCommonJS","hasNodeBuffers","growDataView","dataview","newByteLength","resizedBuffer","amountToCopy","length","offset","growNodeBuffer","buffer","newBuffer","textEncoder","textDecoder","encodeStringIntoDataView","byteOffset","string","strlen","u8Buffer","encodeSmallString","encodeStringIntoNodeBuffer","i","decodeStringFromNodeBuffer","decodeStringFromDataView","Field","FieldArray","item","FieldFixedArray","length","FieldBitFlags","flags","FieldString","FieldOptional","packet","BinaryPacket","_BinaryPacket","packetId","definition","sortEntries","inspection","inspectEntries","buffer","byteOffset","dataview","arraybuffer","visitors","GET_FUNCTION_BUF","decodeStringFromNodeBuffer","GET_FUNCTION","decodeStringFromDataView","byteLength","dataIn","offsetPointer","hasNodeBuffers","dataOut","SET_FUNCTION_BUF","growNodeBuffer","encodeStringIntoNodeBuffer","SET_FUNCTION","growDataView","encodeStringIntoDataView","buf","onVisit","readFunctions","decodeStringFunction","Packet","result","name","def","array","itemType","i","strlen","itemSize","BYTE_SIZE","bit","hasSubPacket","maxByteLength","writeFunctions","growBufferFunction","encodeStringFunction","data","isDynamicArray","neededBytesForElements","object","str","number","len","field","string","fieldName1","fieldName2","entries","minimumByteLength","stringPositions","type","isString","view","offset","value"]}
+{"version":3,"sources":["../src/index.ts","../src/buffers.ts"],"sourcesContent":["import {\n  decodeStringFromDataView,\n  decodeStringFromNodeBuffer,\n  encodeStringIntoDataView,\n  encodeStringIntoNodeBuffer,\n  growDataView,\n  growNodeBuffer,\n  hasNodeBuffers,\n  type TrueArrayBuffer\n} from './buffers'\n\nexport const enum Field {\n  /**\n   * Defines a 1 byte (8 bits) unsigned integer field. \\\n   * (Range: 0 - 255)\n   */\n  UNSIGNED_INT_8 = 0,\n\n  /**\n   * Defines a 2 bytes (16 bits) unsigned integer field. \\\n   * (Range: 0 - 65535)\n   */\n  UNSIGNED_INT_16,\n\n  /**\n   * Defines a 4 bytes (32 bits) unsigned integer field. \\\n   * (Range: 0 - 4294967295)\n   */\n  UNSIGNED_INT_32,\n\n  /**\n   * Defines a 1 byte (8 bits) signed integer field. \\\n   * (Range: -128 - 127)\n   */\n  INT_8,\n\n  /**\n   * Defines a 2 bytes (16 bits) signed integer field. \\\n   * (Range: -32768 - 32767)\n   */\n  INT_16,\n\n  /**\n   * Defines a 4 bytes (32 bits) signed integer field. \\\n   * (Range: -2147483648 - 2147483647)\n   */\n  INT_32,\n\n  /**\n   * Defines a 4 bytes (32 bits) floating-point field. \\\n   */\n  FLOAT_32,\n\n  /**\n   * Defines a 8 bytes (64 bits) floating-point field. \\\n   */\n  FLOAT_64\n}\n\n/**\n * Defines a dynamically-sized array with elements of a certain type. \\\n * Dynamically-sized arrays are useful when a packet's field is an array of a non pre-defined length. \\\n * Although, this makes dynamically-sized arrays more memory expensive as the internal buffer needs to be grown accordingly.\n *\n * NOTE: If an array will ALWAYS have the same length, prefer using the `FieldFixedArray` type, for both better performance and memory efficiency. \\\n * NOTE: As of now, dynamic arrays can have at most 256 elements.\n */\nexport function FieldArray<T extends Field | BinaryPacket<Definition> | ''>(\n  item: T\n): [itemType: T] {\n  return [item]\n}\n\n/**\n * Defines a statically-sized array with elements of a certain type. \\\n * Fixed arrays are useful when a packet's field is an array of a pre-defined length. \\\n * Fixed arrays much more memory efficient and performant than non-fixed ones.\n *\n * NOTE: If an array will not always have the same length, use the `FieldArray` type.\n */\nexport function FieldFixedArray<\n  T extends Field | BinaryPacket<Definition> | '',\n  Length extends number\n>(item: T, length: Length): [itemType: T, length: Length] {\n  if (length < 0 || !Number.isFinite(length)) {\n    throw new RangeError('Length of a FixedArray must be a positive integer.')\n  }\n\n  return [item, length]\n}\n\n/**\n * Utility class that allows serializing arrays through any kind of iterable, as long as the number of elements is known beforehand. \\\n * Needed to skip the overhead of duplicating the data into an actual array just for it to be serialized straight away and trashed.\n */\nexport class SequentialSerializer<T> implements Iterable<T> {\n  constructor(\n    private readonly iterable: Iterable<T>,\n    public readonly length: number\n  ) {}\n\n  [Symbol.iterator]() {\n    return this.iterable[Symbol.iterator]()\n  }\n}\n\ntype SequentiallySerializable<T, IsRead extends boolean> = IsRead extends true\n  ? T[]\n  : T[] | SequentialSerializer<T>\n\ntype BitFlags = (string[] | ReadonlyArray<string>) & {\n  length: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8\n}\n\n/**\n * Defines a sequence of up to 8 \"flags\" (basically single bits/booleans) that can be packed together into a single 8 bits value. \\\n * This is useful for minimizing bytes usage when there are lots of boolean fields/flags, instead of saving each flag separately as its own 8 bits value.\n *\n * The input should be an array of strings (with at most 8 elements) where each string defines the name of a flag. \\\n * This is just for definition purposes, then when actually writing or reading packets it'll just be a record-object with those names as keys and boolean values.\n */\nexport function FieldBitFlags<const FlagsArray extends BitFlags>(flags: FlagsArray) {\n  if (flags.length > 8) {\n    throw new Error(\n      `Invalid BinaryPacket definition: a BitFlags field can have only up to 8 flags, given: ${flags.join(', ')}`\n    )\n  }\n\n  return { flags }\n}\n\n/**\n * Defines a string field. \\\n * Strings cannot be more than 65536 characters long.\n *\n * NOTE: Only strings containing just ASCII and/or single-octet UTF-8 characters are supported.\n */\nexport function FieldString() {\n  return '' as const\n}\n\n/**\n * Defines an optional BinaryPacket \"subpacket\" field. \\\n * When writing and reading packets it'll be possible to provide and receive `undefined` instead of a valid object.\n */\nexport function FieldOptional<T extends BinaryPacket<Definition>>(packet: T) {\n  return { optional: packet }\n}\n\n/**\n * Do not manually construct this type: an object of this kind is returned by a BinaryPacket `createVisitor` method. \\\n * Used in the `BinaryPacket::visit` static method to perform a sort of \"pattern matching\" on an incoming packet (of yet unknown type) buffer.\n */\ntype Visitor = [BinaryPacket<Definition>, (packet: any) => void]\n\nexport class BinaryPacket<T extends Definition> {\n  /**\n   * Defines a new binary packet. \\\n   * Make sure that every `packetId` is unique.\n   * @throws RangeError If packetId is negative, floating-point, or greater than 255.\n   */\n  static define<T extends Definition>(packetId: number, definition?: T) {\n    if (packetId < 0 || !Number.isFinite(packetId)) {\n      throw new RangeError('Packet IDs must be positive integers.')\n    }\n\n    if (packetId > 255) {\n      throw new RangeError(\n        'Packet IDs greater than 255 are not supported. Do you REALLY need more than 255 different kinds of packets?'\n      )\n    }\n\n    return new BinaryPacket(packetId, definition)\n  }\n\n  /**\n   * Reads just the packetId from the given Buffer. \\\n   * This method practically just reads the uint8 at offset `byteOffset` (default: 0). \\\n   * Useful if the receiving side receives multiple types of packets.\n   */\n  static readPacketIdNodeBuffer(buffer: Buffer, byteOffset = 0) {\n    return buffer.readUint8(byteOffset)\n  }\n\n  /**\n   * Reads just the packetId from the given DataView. \\\n   * This method practically just reads the uint8 at offset `byteOffset` (default: 0). \\\n   * Useful if the receiving side receives multiple types of packets.\n   */\n  static readPacketIdDataView(dataview: DataView, byteOffset = 0) {\n    return dataview.getUint8(byteOffset)\n  }\n\n  /**\n   * Reads just the packetId from the given ArrayBuffer. \\\n   * This method practically just reads the uint8 at offset `byteOffset`. \\\n   * Useful if the receiving side receives multiple types of packets.\n   *\n   * NOTE: Due to security issues, the `byteOffset` argument cannot be defaulted and must be provided by the user. \\\n   * NOTE: For more information read the `readArrayBuffer` method documentation.\n   */\n  static readPacketIdArrayBuffer(arraybuffer: TrueArrayBuffer, byteOffset: number) {\n    return new Uint8Array(arraybuffer, byteOffset, 1)[0]\n  }\n\n  /**\n   * Visits and \"pattern matches\" the given Buffer through the given visitors. \\\n   * The Buffer is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\n   *\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\n   */\n  static visitNodeBuffer(buffer: Buffer, ...visitors: Visitor[]) {\n    return BinaryPacket.visit(buffer, GET_FUNCTION_BUF, decodeStringFromNodeBuffer, visitors)\n  }\n\n  /**\n   * Visits and \"pattern matches\" the given DataView through the given visitors. \\\n   * The DataView is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\n   *\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\n   */\n  static visitDataView(dataview: DataView, ...visitors: Visitor[]) {\n    return BinaryPacket.visit(dataview, GET_FUNCTION, decodeStringFromDataView, visitors)\n  }\n\n  /**\n   * Visits and \"pattern matches\" the given ArrayBuffer through the given visitors. \\\n   * The ArrayBuffer is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\n   *\n   * NOTE: Due to security issues, the `byteOffset` and `byteLength` arguments must be provided by the user. \\\n   * NOTE: For more information read the `readArrayBuffer` method documentation. \\\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\n   */\n  static visitArrayBuffer(\n    arraybuffer: TrueArrayBuffer,\n    byteOffset: number,\n    byteLength: number,\n    ...visitors: Visitor[]\n  ) {\n    return BinaryPacket.visit(\n      new DataView(arraybuffer, byteOffset, byteLength),\n      GET_FUNCTION,\n      decodeStringFromDataView,\n      visitors\n    )\n  }\n\n  /**\n   * Reads/deserializes from the given Buffer. \\\n   * Method available ONLY on NodeJS and Bun.\n   *\n   * If possible, always prefer reading using this method, as it is much faster than the other ones.\n   *\n   * NOTE: if you have an ArrayBuffer do not bother wrapping it into a node Buffer yourself. \\\n   * NOTE: if you have an ArrayBuffer use the appropriate `readArrayBuffer`.\n   */\n  readNodeBuffer(\n    dataIn: Buffer,\n    offsetPointer = { offset: 0 },\n    byteLength = dataIn.byteLength\n  ): ToJson<T, true> {\n    return this.read(\n      dataIn,\n      offsetPointer,\n      byteLength,\n      GET_FUNCTION_BUF,\n      decodeStringFromNodeBuffer\n    )\n  }\n\n  /**\n   * Reads/deserializes from the given DataView.\n   *\n   * NOTE: if you have an ArrayBuffer do not bother wrapping it into a DataView yourself. \\\n   * NOTE: if you have an ArrayBuffer use the appropriate `readArrayBuffer`.\n   */\n  readDataView(\n    dataIn: DataView,\n    offsetPointer = { offset: 0 },\n    byteLength = dataIn.byteLength\n  ): ToJson<T, true> {\n    return this.read(dataIn, offsetPointer, byteLength, GET_FUNCTION, decodeStringFromDataView)\n  }\n\n  /**\n   * Reads/deserializes from the given ArrayBuffer. \\\n   * WARNING: this method is practically a HACK.\n   *\n   * When using this method both the `byteOffset` and `byteLength` are REQUIRED and cannot be defaulted. \\\n   * This is to prevent serious bugs and security issues. \\\n   * That is because often raw ArrayBuffers come from a pre-allocated buffer pool and do not start at byteOffset 0.\n   *\n   * NOTE: if you have a node Buffer do not bother wrapping it into an ArrayBuffer yourself. \\\n   * NOTE: if you have a node Buffer use the appropriate `readNodeBuffer` as it is much faster and less error prone.\n   */\n  readArrayBuffer(dataIn: TrueArrayBuffer, byteOffset: number, byteLength: number) {\n    return this.read(\n      hasNodeBuffers\n        ? Buffer.from(dataIn, byteOffset, byteLength)\n        : (new DataView(dataIn, byteOffset, byteLength) as any),\n      { offset: 0 }, // The underlying buffer has already been offsetted\n      byteLength,\n      hasNodeBuffers ? GET_FUNCTION_BUF : GET_FUNCTION,\n      hasNodeBuffers ? decodeStringFromNodeBuffer : (decodeStringFromDataView as any)\n    )\n  }\n\n  /**\n   * Writes/serializes the given object into a Buffer. \\\n   * Method available ONLY on NodeJS and Bun.\n   *\n   * If possible, always prefer writing using this method, as it is much faster than the other ones.\n   */\n  writeNodeBuffer(dataOut: ToJson<T>) {\n    const byteLength = this.precalculateBufferLengthWithStrings(dataOut)\n    const buffer = Buffer.allocUnsafe(byteLength)\n\n    return this.write(\n      buffer,\n      dataOut,\n      { offset: 0 },\n      byteLength,\n      byteLength,\n      SET_FUNCTION_BUF,\n      growNodeBuffer,\n      encodeStringIntoNodeBuffer\n    )\n  }\n\n  /**\n   * Writes/serializes the given object into a DataView. \\\n   */\n  writeDataView(dataOut: ToJson<T>) {\n    const byteLength = this.precalculateBufferLengthWithStrings(dataOut)\n    const dataview = new DataView(new ArrayBuffer(byteLength))\n\n    return this.write(\n      dataview,\n      dataOut,\n      { offset: 0 },\n      byteLength,\n      byteLength,\n      SET_FUNCTION,\n      growDataView,\n      encodeStringIntoDataView\n    )\n  }\n\n  /**\n   * Writes/serializes the given object into an ArrayBuffer. \\\n   * This method is just a wrapper around either  `writeNodeBuffer` or `writeDataView`. \\\n   *\n   * This method works with JavaScript standard raw ArrayBuffer(s) and, as such, is very error prone: \\\n   * Make sure you're using the returned byteLength and byteOffset fields in the read counterpart. \\\n   *\n   * Always consider whether is possible to use directly `writeNodeBuffer` or `writeDataView` instead of `writeArrayBuffer`. \\\n   * For more information read the `readArrayBuffer` documentation.\n   */\n  writeArrayBuffer(dataOut: ToJson<T>) {\n    const buf = hasNodeBuffers ? this.writeNodeBuffer(dataOut) : this.writeDataView(dataOut)\n    return { buffer: buf.buffer, byteLength: buf.byteLength, byteOffset: buf.byteOffset }\n  }\n\n  /**\n   * Creates a \"visitor\" object for this BinaryPacket definition. \\\n   * Used when visiting and \"pattern matching\" buffers with the `BinaryPacket::visit` static utility methods. \\\n   *\n   * For more information read the `BinaryPacket::visitNodeBuffer` documentation. \\\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\n   */\n  visitor(onVisit: (packet: ToJson<T>) => void): Visitor {\n    return [this, onVisit]\n  }\n\n  sequentialSerializer(numElements: number, dataOut: Iterable<ToJson<T>>) {\n    const byteLength = this.minimumByteLength * numElements\n    const buffer = Buffer.allocUnsafe(byteLength)\n    const offsetPointer = { offset: 0 }\n\n    for (const element of dataOut) {\n      this.write(\n        buffer,\n        element,\n        offsetPointer,\n        byteLength,\n        byteLength,\n        SET_FUNCTION_BUF,\n        growNodeBuffer,\n        encodeStringIntoNodeBuffer\n      )\n    }\n  }\n\n  /// PRIVATE\n\n  private readonly entries: Entries\n  readonly stringPositions: StringPositions\n  readonly minimumByteLength: number\n\n  private constructor(\n    private readonly packetId: number,\n    definition?: T\n  ) {\n    this.entries = definition ? sortEntries(definition) : []\n    const inspection = inspectEntries(this.entries)\n    this.minimumByteLength = inspection.minimumByteLength\n    this.stringPositions = inspection.stringPositions\n  }\n\n  private static visit<Buf extends DataView | Buffer>(\n    dataIn: Buf,\n    readFunctions: typeof GET_FUNCTION | typeof GET_FUNCTION_BUF,\n    decodeStringFunction: (dataIn: Buf, byteOffset: number, strlen: number) => string,\n    visitors: Visitor[]\n  ) {\n    for (const [Packet, onVisit] of visitors) {\n      if (Packet.packetId === readFunctions[Field.UNSIGNED_INT_8](dataIn as any, 0)) {\n        return onVisit(\n          Packet.read(dataIn, { offset: 0 }, dataIn.byteLength, readFunctions, decodeStringFunction)\n        )\n      }\n    }\n  }\n\n  private read<Buf extends DataView | Buffer>(\n    dataIn: Buf,\n    offsetPointer: { offset: number },\n    byteLength: number,\n    readFunctions: typeof GET_FUNCTION | typeof GET_FUNCTION_BUF,\n    decodeStringFunction: (dataIn: Buf, byteOffset: number, strlen: number) => string\n  ): ToJson<T, true> {\n    if (byteLength + offsetPointer.offset < this.minimumByteLength) {\n      throw new Error(\n        `There is no space available to fit a packet of type ${this.packetId} at offset ${offsetPointer.offset}`\n      )\n    }\n\n    if (\n      readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset) !== this.packetId\n    ) {\n      throw new Error(\n        `Data at offset ${offsetPointer.offset} is not a packet of type ${this.packetId}`\n      )\n    }\n\n    offsetPointer.offset += 1\n    const result: any = {}\n\n    for (const [name, def] of this.entries) {\n      if (Array.isArray(def)) {\n        const length =\n          // def[1] is the length of a statically-sized array, if undefined: must read the length from the buffer as it means it's a dynamically-sized array\n          def[1] ?? readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset++)\n\n        const array = Array(length)\n\n        const itemType = def[0]\n\n        if (typeof itemType === 'object') {\n          // Array of \"subpackets\"\n          for (let i = 0; i < length; ++i) {\n            array[i] = itemType.read(\n              dataIn,\n              offsetPointer,\n              byteLength,\n              readFunctions,\n              decodeStringFunction\n            )\n          }\n        } else if (itemType === '') {\n          // Array of strings\n          for (let i = 0; i < length; ++i) {\n            const strlen = readFunctions[Field.UNSIGNED_INT_16](dataIn as any, offsetPointer.offset)\n            offsetPointer.offset += 2\n\n            array[i] = decodeStringFunction(dataIn, offsetPointer.offset, strlen)\n            offsetPointer.offset += strlen\n          }\n        } else {\n          // Array of primitives (numbers)\n          const itemSize = BYTE_SIZE[itemType]\n\n          // It seems like looping over each element is actually much faster than using TypedArrays bulk copy.\n          // TODO: properly benchmark with various array sizes to see if it's actually the case.\n          for (let i = 0; i < length; ++i) {\n            array[i] = readFunctions[itemType](dataIn as any, offsetPointer.offset)\n            offsetPointer.offset += itemSize\n          }\n        }\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = array\n      } else if (typeof def === 'number') {\n        // Single primitive (number)\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = readFunctions[def](dataIn as any, offsetPointer.offset)\n        offsetPointer.offset += BYTE_SIZE[def]\n      } else if (def === '') {\n        const strlen = readFunctions[Field.UNSIGNED_INT_16](dataIn as any, offsetPointer.offset)\n        offsetPointer.offset += 2\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = decodeStringFunction(dataIn, offsetPointer.offset, strlen)\n        offsetPointer.offset += strlen\n      } else if ('flags' in def) {\n        // BitFlags\n        const flags = readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset)\n        offsetPointer.offset += 1\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = {}\n\n        for (let bit = 0; bit < def.flags.length; ++bit) {\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n          result[name][def.flags[bit]] = !!(flags & (1 << bit))\n        }\n      } else if ('optional' in def) {\n        // Single optional \"subpacket\"\n        const hasSubPacket =\n          readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset) !== 0\n\n        offsetPointer.offset += 1\n\n        if (hasSubPacket) {\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n          result[name] = def.optional.read(\n            dataIn,\n            offsetPointer,\n            byteLength,\n            readFunctions,\n            decodeStringFunction\n          )\n        }\n      } else {\n        // Single \"subpacket\"\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = def.read(\n          dataIn,\n          offsetPointer,\n          byteLength,\n          readFunctions,\n          decodeStringFunction\n        )\n      }\n    }\n\n    return result as ToJson<T, true>\n  }\n\n  private write<Buf extends DataView | Buffer>(\n    buffer: Buf,\n    dataOut: ToJson<T>,\n    offsetPointer: { offset: number },\n    byteLength: number,\n    maxByteLength: number,\n    writeFunctions: typeof SET_FUNCTION | typeof SET_FUNCTION_BUF,\n    growBufferFunction: (buffer: Buf, newByteLength: number) => Buf,\n    encodeStringFunction: (buffer: Buf, byteOffset: number, string: string) => void\n  ): Buf {\n    writeFunctions[Field.UNSIGNED_INT_8](buffer as any, this.packetId, offsetPointer.offset)\n    offsetPointer.offset += 1\n\n    for (const [name, def] of this.entries) {\n      const data = dataOut[name]\n\n      if (Array.isArray(def)) {\n        // Could be both an array of just numbers or \"subpackets\"\n\n        const length = (data as SequentiallySerializable<any, false>).length\n\n        // Check if it is a dynamically-sized array, if it is, the length of the array must be serialized in the buffer before its elements\n        // Explicitly check for undefined and not falsy values because it could be a statically-sized array of 0 elements.\n        const isDynamicArray = def[1] === undefined\n\n        if (isDynamicArray) {\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, length, offsetPointer.offset)\n          offsetPointer.offset += 1\n        }\n\n        if (length > 0) {\n          const itemType = def[0]\n\n          if (typeof itemType === 'object') {\n            // Array of \"subpackets\"\n\n            if (isDynamicArray) {\n              const neededBytesForElements = length * itemType.minimumByteLength\n\n              byteLength += neededBytesForElements\n              maxByteLength += neededBytesForElements\n\n              if (buffer.byteLength < maxByteLength) {\n                buffer = growBufferFunction(buffer, maxByteLength)\n              }\n            }\n\n            for (const object of data as unknown as ToJson<Definition>[]) {\n              // Array of \"subpackets\"\n              buffer = itemType.write(\n                buffer,\n                object,\n                offsetPointer,\n                byteLength,\n                maxByteLength,\n                writeFunctions,\n                growBufferFunction,\n                encodeStringFunction\n              )\n\n              byteLength = offsetPointer.offset\n              maxByteLength = buffer.byteLength\n            }\n          } else if (itemType === '') {\n            // Array of strings\n            for (let i = 0; i < length; ++i) {\n              const str = (data as unknown as string[])[i]\n              const strlen = str.length\n\n              writeFunctions[Field.UNSIGNED_INT_16](buffer as any, strlen, offsetPointer.offset)\n              offsetPointer.offset += 2\n\n              encodeStringFunction(buffer, offsetPointer.offset, str)\n              offsetPointer.offset += strlen\n            }\n          } else {\n            // Array of primitives (numbers)\n            const itemSize = BYTE_SIZE[itemType]\n\n            if (isDynamicArray) {\n              const neededBytesForElements = length * itemSize\n\n              byteLength += neededBytesForElements\n              maxByteLength += neededBytesForElements\n\n              if (buffer.byteLength < maxByteLength) {\n                buffer = growBufferFunction(buffer, maxByteLength)\n              }\n            }\n\n            // It seems like looping over each element is actually much faster than using TypedArrays bulk copy.\n            // TODO: properly benchmark with various array sizes to see if it's actually the case.\n            for (const number of data as SequentiallySerializable<number, false>) {\n              writeFunctions[itemType](buffer as any, number, offsetPointer.offset)\n              offsetPointer.offset += itemSize\n            }\n          }\n        }\n      } else if (typeof def === 'number') {\n        // Single primitive (number)\n        writeFunctions[def](buffer as any, data as number, offsetPointer.offset)\n        offsetPointer.offset += BYTE_SIZE[def]\n      } else if (def === '') {\n        // String\n        const strlen = (data as string).length\n\n        writeFunctions[Field.UNSIGNED_INT_16](buffer as any, strlen, offsetPointer.offset)\n        offsetPointer.offset += 2\n\n        encodeStringFunction(buffer, offsetPointer.offset, data as string)\n        offsetPointer.offset += strlen\n      } else if ('flags' in def) {\n        // BitFlags\n        let flags = 0\n\n        for (let bit = 0; bit < def.flags.length; ++bit) {\n          if ((data as Record<string, boolean>)[def.flags[bit]]) {\n            flags |= 1 << bit\n          }\n        }\n\n        writeFunctions[Field.UNSIGNED_INT_8](buffer as any, flags, offsetPointer.offset)\n        offsetPointer.offset += 1\n      } else if ('optional' in def) {\n        if (data) {\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, 1, offsetPointer.offset)\n          offsetPointer.offset += 1\n\n          byteLength += def.optional.minimumByteLength\n          maxByteLength += def.optional.minimumByteLength\n\n          if (buffer.byteLength < maxByteLength) {\n            buffer = growBufferFunction(buffer, maxByteLength)\n          }\n\n          buffer = def.optional.write(\n            buffer,\n            data as ToJson<Definition>,\n            offsetPointer,\n            byteLength,\n            maxByteLength,\n            writeFunctions,\n            growBufferFunction,\n            encodeStringFunction\n          )\n\n          byteLength = offsetPointer.offset\n          maxByteLength = buffer.byteLength\n        } else {\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, 0, offsetPointer.offset)\n          offsetPointer.offset += 1\n        }\n      } else {\n        // Single \"subpacket\"\n        buffer = def.write(\n          buffer,\n          data as ToJson<Definition>,\n          offsetPointer,\n          byteLength,\n          maxByteLength,\n          writeFunctions,\n          growBufferFunction,\n          encodeStringFunction\n        )\n\n        byteLength = offsetPointer.offset\n        maxByteLength = buffer.byteLength\n      }\n    }\n\n    return buffer\n  }\n\n  private precalculateBufferLengthWithStrings(dataOut: ToJson<T>) {\n    let len = this.minimumByteLength\n\n    for (const field of this.stringPositions[0]) {\n      // String field\n      len += (dataOut[field] as string).length\n    }\n\n    for (const field of this.stringPositions[1]) {\n      // Array of strings field\n      for (const string of dataOut[field] as unknown as string[]) {\n        len += 2 + string.length\n      }\n    }\n\n    for (const field in this.stringPositions[2]) {\n      // Subpacket that has some string fields\n      len += this.stringPositions[2][field].precalculateBufferLengthWithStrings(\n        dataOut[field] as any\n      )\n    }\n\n    return len\n  }\n}\n\n/**\n * BinaryPacket definition: \\\n * Any packet can be defined through a \"schema\" object explaining its fields names and types.\n *\n * @example\n * // Imagine we have a game board where each cell is a square and is one unit big.\n * // A cell can be then defined by its X and Y coordinates.\n * // For simplicity, let's say there cannot be more than 256 cells, so we can use 8 bits for each coordinate.\n * const Cell = {\n *  x: Field.UNSIGNED_INT_8,\n *  y: Field.UNSIGNED_INT_8\n * }\n *\n * // When done with the cell definition we can create its BinaryPacket writer/reader.\n * // NOTE: each BinaryPacket needs an unique ID, for identification purposes and error checking.\n * const CellPacket = BinaryPacket.define(0, Cell)\n *\n * // Let's now make the definition of the whole game board.\n * // You can also specify arrays of both \"primitive\" fields and other BinaryPackets.\n * const Board = {\n *  numPlayers: Field.UNSIGNED_INT_8,\n *  cells: FieldArray(CellPacket)\n * }\n *\n * // When done with the board definition we can create its BinaryPacket writer/reader.\n * // NOTE: each BinaryPacket needs an unique ID, for identification purposes and error checking.\n * const BoardPacket = BinaryPacket.define(1, Board)\n *\n * // And use it.\n * const buffer = BoardPacket.writeNodeBuffer({\n *  numPlayers: 1,\n *  cells: [\n *    { x: 0, y: 0 },\n *    { x: 1, y: 1 }\n *  ]\n * })\n *\n * // sendTheBufferOver(buffer)\n * // ...\n * // const buffer = receiveTheBuffer()\n * const board = BoardPacket.readNodeBuffer(buffer)\n * // ...\n */\nexport type Definition = {\n  [fieldName: string]:\n    | MaybeArray<Field>\n    | MaybeArray<BinaryPacket<Definition>>\n    | MaybeArray<''>\n    | { flags: BitFlags }\n    | { optional: BinaryPacket<Definition> }\n}\n\ntype MaybeArray<T> = T | [itemType: T] | [itemType: T, length: number]\n\ntype BitFlagsToJson<FlagsArray extends BitFlags> = {\n  [key in FlagsArray[number]]: boolean\n}\n\n/**\n * Meta-type that converts a `Definition` schema to the type of the actual JavaScript object that will be written into a packet or read from. \\\n */\nexport type ToJson<T extends Definition, IsRead extends boolean = false> = {\n  [K in keyof T]: T[K] extends [infer Item]\n    ? Item extends BinaryPacket<infer BPDef>\n      ? SequentiallySerializable<ToJson<BPDef, IsRead>, IsRead>\n      : Item extends ''\n        ? SequentiallySerializable<string, IsRead>\n        : SequentiallySerializable<number, IsRead>\n    : T[K] extends [infer Item, infer Length]\n      ? Item extends BinaryPacket<infer BPDef>\n        ? SequentiallySerializable<ToJson<BPDef, IsRead>, IsRead> & { length: Length }\n        : Item extends ''\n          ? string[] & { length: Length }\n          : number[] & { length: Length }\n      : T[K] extends BinaryPacket<infer BPDef>\n        ? ToJson<BPDef, IsRead>\n        : T[K] extends { flags: infer FlagsArray extends BitFlags }\n          ? BitFlagsToJson<FlagsArray>\n          : T[K] extends { optional: BinaryPacket<infer BPDef extends Definition> }\n            ? ToJson<BPDef, IsRead> | undefined\n            : T[K] extends ''\n              ? string\n              : number\n}\n\n/**\n * In a JavaScript object, the order of its keys is not strictly defined: sort them by field name. \\\n * Thus, we cannot trust iterating over an object keys: we MUST iterate over its entries array. \\\n * This is important to make sure that whoever shares BinaryPacket definitions can correctly write/read packets independently of their JS engines.\n */\nfunction sortEntries(definition: Definition) {\n  return Object.entries(definition).sort(([fieldName1], [fieldName2]) =>\n    fieldName1.localeCompare(fieldName2)\n  )\n}\n\ntype Entries = ReturnType<typeof sortEntries>\n\ntype StringPositions = [\n  string[],\n  string[],\n  {\n    [field: string]: BinaryPacket<Definition>\n  }\n]\n\n/**\n * Helper function that \"inspects\" the entries of a BinaryPacket definition\n * and returns useful \"stats\" needed for writing and reading buffers.\n *\n * This function is ever called only once per BinaryPacket definition.\n */\nfunction inspectEntries(entries: Entries) {\n  // The PacketID is already 1 byte, that's why we aren't starting from 0.\n  let minimumByteLength = 1\n\n  const stringPositions: StringPositions = [[], [], {}]\n\n  for (const [name, type] of entries) {\n    if (Array.isArray(type)) {\n      if (type.length === 2) {\n        // Statically-sized array\n        const isString = type[0] === ''\n\n        const itemSize =\n          typeof type[0] === 'object'\n            ? type[0].minimumByteLength\n            : isString\n              ? 2\n              : BYTE_SIZE[type[0]]\n\n        minimumByteLength += type[1] * itemSize\n\n        if (isString) {\n          stringPositions[1].push(name)\n        }\n      } else {\n        // Dynamically-sized array\n        // Adding 1 byte to serialize the array length\n        minimumByteLength += 1\n\n        if (type[0] === '') {\n          stringPositions[1].push(name)\n        }\n      }\n    } else if (type instanceof BinaryPacket) {\n      minimumByteLength += type.minimumByteLength\n      stringPositions[2][name] = type\n    } else if (typeof type === 'object') {\n      // BitFlags & Optionals\n      // BitFlags are always 1 byte long, because they can hold up to 8 booleans\n      // Optionals minimum is 1 byte long, because it holds whether the subpacket is present or not\n      minimumByteLength += 1\n    } else if (type === '') {\n      // String\n      // Adding 2 to serialize the string length\n      minimumByteLength += 2\n      stringPositions[0].push(name)\n    } else {\n      minimumByteLength += BYTE_SIZE[type]\n    }\n  }\n\n  return { minimumByteLength, stringPositions }\n}\n\n//////////////////////////////////////////////\n// The logic here is practically over       //\n// Here below there are needed constants    //\n// that map a field-type to a functionality //\n//////////////////////////////////////////////\n\nconst BYTE_SIZE = Array(8) as number[]\n\nBYTE_SIZE[Field.UNSIGNED_INT_8] = 1\nBYTE_SIZE[Field.INT_8] = 1\n\nBYTE_SIZE[Field.UNSIGNED_INT_16] = 2\nBYTE_SIZE[Field.INT_16] = 2\n\nBYTE_SIZE[Field.UNSIGNED_INT_32] = 4\nBYTE_SIZE[Field.INT_32] = 4\nBYTE_SIZE[Field.FLOAT_32] = 4\n\nBYTE_SIZE[Field.FLOAT_64] = 8\n\nconst GET_FUNCTION = Array(8) as ((view: DataView, offset: number) => number)[]\n\nGET_FUNCTION[Field.UNSIGNED_INT_8] = (view, offset) => view.getUint8(offset)\nGET_FUNCTION[Field.INT_8] = (view, offset) => view.getInt8(offset)\n\nGET_FUNCTION[Field.UNSIGNED_INT_16] = (view, offset) => view.getUint16(offset)\nGET_FUNCTION[Field.INT_16] = (view, offset) => view.getInt16(offset)\n\nGET_FUNCTION[Field.UNSIGNED_INT_32] = (view, offset) => view.getUint32(offset)\nGET_FUNCTION[Field.INT_32] = (view, offset) => view.getInt32(offset)\nGET_FUNCTION[Field.FLOAT_32] = (view, offset) => view.getFloat32(offset)\n\nGET_FUNCTION[Field.FLOAT_64] = (view, offset) => view.getFloat64(offset)\n\nconst SET_FUNCTION = Array(8) as ((view: DataView, value: number, offset: number) => void)[]\n\nSET_FUNCTION[Field.UNSIGNED_INT_8] = (view, value, offset) => view.setUint8(offset, value)\nSET_FUNCTION[Field.INT_8] = (view, value, offset) => view.setInt8(offset, value)\n\nSET_FUNCTION[Field.UNSIGNED_INT_16] = (view, value, offset) => view.setUint16(offset, value)\nSET_FUNCTION[Field.INT_16] = (view, value, offset) => view.setInt16(offset, value)\n\nSET_FUNCTION[Field.UNSIGNED_INT_32] = (view, value, offset) => view.setUint32(offset, value)\nSET_FUNCTION[Field.INT_32] = (view, value, offset) => view.setInt32(offset, value)\nSET_FUNCTION[Field.FLOAT_32] = (view, value, offset) => view.setFloat32(offset, value)\n\nSET_FUNCTION[Field.FLOAT_64] = (view, value, offset) => view.setFloat64(offset, value)\n\nconst SET_FUNCTION_BUF = Array(8) as ((nodeBuffer: Buffer, value: number, offset: number) => void)[]\n\nif (hasNodeBuffers) {\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_8] = (view, value, offset) => view.writeUint8(value, offset)\n  SET_FUNCTION_BUF[Field.INT_8] = (view, value, offset) => view.writeInt8(value, offset)\n\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_16] = (view, value, offset) =>\n    view.writeUint16BE(value, offset)\n  SET_FUNCTION_BUF[Field.INT_16] = (view, value, offset) => view.writeInt16BE(value, offset)\n\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_32] = (view, value, offset) =>\n    view.writeUint32BE(value, offset)\n  SET_FUNCTION_BUF[Field.INT_32] = (view, value, offset) => view.writeInt32BE(value, offset)\n  SET_FUNCTION_BUF[Field.FLOAT_32] = (view, value, offset) => view.writeFloatBE(value, offset)\n\n  SET_FUNCTION_BUF[Field.FLOAT_64] = (view, value, offset) => view.writeDoubleBE(value, offset)\n}\n\nconst GET_FUNCTION_BUF = Array(8) as ((nodeBuffer: Buffer, offset: number) => number)[]\n\nif (hasNodeBuffers) {\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_8] = (view, offset) => view.readUint8(offset)\n  GET_FUNCTION_BUF[Field.INT_8] = (view, offset) => view.readInt8(offset)\n\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_16] = (view, offset) => view.readUint16BE(offset)\n\n  GET_FUNCTION_BUF[Field.INT_16] = (view, offset) => view.readInt16BE(offset)\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_32] = (view, offset) => view.readUint32BE(offset)\n\n  GET_FUNCTION_BUF[Field.INT_32] = (view, offset) => view.readInt32BE(offset)\n  GET_FUNCTION_BUF[Field.FLOAT_32] = (view, offset) => view.readFloatBE(offset)\n  GET_FUNCTION_BUF[Field.FLOAT_64] = (view, offset) => view.readDoubleBE(offset)\n}\n","/**\r\n * Exclusively matches objects of type `ArrayBuffer` and no other types that inherit from it. \\\r\n * This is needed because the `DataView` constructor explicitly requires a \"true\" ArrayBuffer, or else it throws.\r\n */\r\nexport type TrueArrayBuffer = ArrayBuffer & { buffer?: undefined }\r\n\r\nexport const hasNodeBuffers = typeof Buffer === 'function'\r\n\r\nexport function growDataView(dataview: DataView, newByteLength: number) {\r\n  const resizedBuffer = new ArrayBuffer(newByteLength)\r\n  const amountToCopy = Math.min(dataview.byteLength, resizedBuffer.byteLength)\r\n\r\n  // Treat the buffer as if it was a Float64Array so we can copy 8 bytes at a time, to finish faster\r\n  let length = Math.trunc(amountToCopy / 8)\r\n  new Float64Array(resizedBuffer, 0, length).set(new Float64Array(dataview.buffer, 0, length))\r\n\r\n  // Copy the remaining up to 7 bytes\r\n  const offset = length * 8\r\n  length = amountToCopy - offset\r\n  new Uint8Array(resizedBuffer, offset, length).set(new Uint8Array(dataview.buffer, offset, length))\r\n\r\n  return new DataView(resizedBuffer)\r\n}\r\n\r\nexport function growNodeBuffer(buffer: Buffer, newByteLength: number) {\r\n  const newBuffer = Buffer.allocUnsafe(newByteLength)\r\n  buffer.copy(newBuffer)\r\n  return newBuffer\r\n}\r\n\r\nconst textEncoder = new TextEncoder()\r\nconst textDecoder = new TextDecoder()\r\n\r\nexport function encodeStringIntoDataView(dataview: DataView, byteOffset: number, string: string) {\r\n  const strlen = string.length\r\n  const u8Buffer = new Uint8Array(dataview.buffer, dataview.byteOffset + byteOffset, strlen)\r\n\r\n  if (strlen <= 64) {\r\n    encodeSmallString(u8Buffer, 0, string, strlen)\r\n  } else {\r\n    textEncoder.encodeInto(string, u8Buffer)\r\n  }\r\n}\r\n\r\nexport function encodeStringIntoNodeBuffer(buffer: Buffer, byteOffset: number, string: string) {\r\n  const strlen = string.length\r\n\r\n  if (strlen <= 64) {\r\n    encodeSmallString(buffer, byteOffset, string, strlen)\r\n  } else {\r\n    buffer.utf8Write(string, byteOffset, strlen)\r\n  }\r\n}\r\n\r\nfunction encodeSmallString(buffer: Uint8Array, byteOffset: number, string: string, strlen: number) {\r\n  for (let i = 0; i < strlen; ++i) {\r\n    buffer[byteOffset + i] = string.charCodeAt(i) & 0xff\r\n  }\r\n}\r\n\r\nexport function decodeStringFromNodeBuffer(buffer: Buffer, byteOffset: number, strlen: number) {\r\n  return buffer.subarray(byteOffset, byteOffset + strlen).toString('utf8')\r\n}\r\n\r\nexport function decodeStringFromDataView(dataview: DataView, byteOffset: number, strlen: number) {\r\n  return textDecoder.decode(new DataView(dataview.buffer, dataview.byteOffset + byteOffset, strlen))\r\n}\r\n\r\ndeclare global {\r\n  interface Buffer {\r\n    /**\r\n     * Node buffer's internals function. \\\r\n     * For some reason it is not exposed through TypeScript. \\\r\n     * Fastest way to write utf8 strings into buffers.\r\n     */\r\n    utf8Write(string: string, byteOffset?: number, byteLength?: number): number\r\n  }\r\n}\r\n"],"mappings":"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","names":["src_exports","__export","BinaryPacket","Field","FieldArray","FieldBitFlags","FieldFixedArray","FieldOptional","FieldString","SequentialSerializer","__toCommonJS","hasNodeBuffers","growDataView","dataview","newByteLength","resizedBuffer","amountToCopy","length","offset","growNodeBuffer","buffer","newBuffer","textEncoder","textDecoder","encodeStringIntoDataView","byteOffset","string","strlen","u8Buffer","encodeSmallString","encodeStringIntoNodeBuffer","i","decodeStringFromNodeBuffer","decodeStringFromDataView","Field","FieldArray","item","FieldFixedArray","length","SequentialSerializer","iterable","FieldBitFlags","flags","FieldString","FieldOptional","packet","BinaryPacket","_BinaryPacket","packetId","definition","sortEntries","inspection","inspectEntries","buffer","byteOffset","dataview","arraybuffer","visitors","GET_FUNCTION_BUF","decodeStringFromNodeBuffer","GET_FUNCTION","decodeStringFromDataView","byteLength","dataIn","offsetPointer","hasNodeBuffers","dataOut","SET_FUNCTION_BUF","growNodeBuffer","encodeStringIntoNodeBuffer","SET_FUNCTION","growDataView","encodeStringIntoDataView","buf","onVisit","numElements","element","readFunctions","decodeStringFunction","Packet","result","name","def","array","itemType","i","strlen","itemSize","BYTE_SIZE","bit","hasSubPacket","maxByteLength","writeFunctions","growBufferFunction","encodeStringFunction","data","isDynamicArray","neededBytesForElements","object","str","number","len","field","string","fieldName1","fieldName2","entries","minimumByteLength","stringPositions","type","isString","view","offset","value"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-var p=typeof Buffer=="function";function w(n,e){let t=new ArrayBuffer(e),i=Math.min(n.byteLength,t.byteLength),r=Math.trunc(i/8);new Float64Array(t,0,r).set(new Float64Array(n.buffer,0,r));let a=r*8;return r=i-a,new Uint8Array(t,a,r).set(new Uint8Array(n.buffer,a,r)),new DataView(t)}function b(n,e){let t=Buffer.allocUnsafe(e);return n.copy(t),t}var x=new TextEncoder,V=new TextDecoder;function A(n,e,t){let i=t.length,r=new Uint8Array(n.buffer,n.byteOffset+e,i);i<=64?G(r,0,t,i):x.encodeInto(t,r)}function S(n,e,t){let i=t.length;i<=64?G(n,e,t,i):n.utf8Write(t,e,i)}function G(n,e,t,i){for(let r=0;r<i;++r)n[e+r]=t.charCodeAt(r)&255}function E(n,e,t){return n.subarray(e,e+t).toString("utf8")}function h(n,e,t){return V.decode(new DataView(n.buffer,n.byteOffset+e,t))}var k=(s=>(s[s.UNSIGNED_INT_8=0]="UNSIGNED_INT_8",s[s.UNSIGNED_INT_16=1]="UNSIGNED_INT_16",s[s.UNSIGNED_INT_32=2]="UNSIGNED_INT_32",s[s.INT_8=3]="INT_8",s[s.INT_16=4]="INT_16",s[s.INT_32=5]="INT_32",s[s.FLOAT_32=6]="FLOAT_32",s[s.FLOAT_64=7]="FLOAT_64",s))(k||{});function C(n){return[n]}function j(n,e){if(e<0||!Number.isFinite(e))throw new RangeError("Length of a FixedArray must be a positive integer.");return[n,e]}function K(n){if(n.length>8)throw new Error(`Invalid BinaryPacket definition: a BitFlags field can have only up to 8 flags, given: ${n.join(", ")}`);return{flags:n}}function R(){return""}function M(n){return{optional:n}}var F=class n{constructor(e,t){this.packetId=e;this.entries=t?v(t):[];let i=L(this.entries);this.minimumByteLength=i.minimumByteLength,this.stringPositions=i.stringPositions}static define(e,t){if(e<0||!Number.isFinite(e))throw new RangeError("Packet IDs must be positive integers.");if(e>255)throw new RangeError("Packet IDs greater than 255 are not supported. Do you REALLY need more than 255 different kinds of packets?");return new n(e,t)}static readPacketIdNodeBuffer(e,t=0){return e.readUint8(t)}static readPacketIdDataView(e,t=0){return e.getUint8(t)}static readPacketIdArrayBuffer(e,t){return new Uint8Array(e,t,1)[0]}static visitNodeBuffer(e,...t){return n.visit(e,I,E,t)}static visitDataView(e,...t){return n.visit(e,g,h,t)}static visitArrayBuffer(e,t,i,...r){return n.visit(new DataView(e,t,i),g,h,r)}readNodeBuffer(e,t={offset:0},i=e.byteLength){return this.read(e,t,i,I,E)}readDataView(e,t={offset:0},i=e.byteLength){return this.read(e,t,i,g,h)}readArrayBuffer(e,t,i){return this.read(p?Buffer.from(e,t,i):new DataView(e,t,i),{offset:0},i,p?I:g,p?E:h)}writeNodeBuffer(e){let t=this.precalculateBufferLengthWithStrings(e),i=Buffer.allocUnsafe(t);return this.write(i,e,{offset:0},t,t,c,b,S)}writeDataView(e){let t=this.precalculateBufferLengthWithStrings(e),i=new DataView(new ArrayBuffer(t));return this.write(i,e,{offset:0},t,t,_,w,A)}writeArrayBuffer(e){let t=p?this.writeNodeBuffer(e):this.writeDataView(e);return{buffer:t.buffer,byteLength:t.byteLength,byteOffset:t.byteOffset}}visitor(e){return[this,e]}entries;stringPositions;minimumByteLength;static visit(e,t,i,r){for(let[a,o]of r)if(a.packetId===t[0](e,0))return o(a.read(e,{offset:0},e.byteLength,t,i))}read(e,t,i,r,a){if(i+t.offset<this.minimumByteLength)throw new Error(`There is no space available to fit a packet of type ${this.packetId} at offset ${t.offset}`);if(r[0](e,t.offset)!==this.packetId)throw new Error(`Data at offset ${t.offset} is not a packet of type ${this.packetId}`);t.offset+=1;let o={};for(let[u,s]of this.entries)if(Array.isArray(s)){let d=s[1]??r[0](e,t.offset++),f=Array(d),T=s[0];if(typeof T=="object")for(let l=0;l<d;++l)f[l]=T.read(e,t,i,r,a);else if(T==="")for(let l=0;l<d;++l){let N=r[1](e,t.offset);t.offset+=2,f[l]=a(e,t.offset,N),t.offset+=N}else{let l=y[T];for(let N=0;N<d;++N)f[N]=r[T](e,t.offset),t.offset+=l}o[u]=f}else if(typeof s=="number")o[u]=r[s](e,t.offset),t.offset+=y[s];else if(s===""){let d=r[1](e,t.offset);t.offset+=2,o[u]=a(e,t.offset,d),t.offset+=d}else if("flags"in s){let d=r[0](e,t.offset);t.offset+=1,o[u]={};for(let f=0;f<s.flags.length;++f)o[u][s.flags[f]]=!!(d&1<<f)}else if("optional"in s){let d=r[0](e,t.offset)!==0;t.offset+=1,d&&(o[u]=s.optional.read(e,t,i,r,a))}else o[u]=s.read(e,t,i,r,a);return o}write(e,t,i,r,a,o,u,s){o[0](e,this.packetId,i.offset),i.offset+=1;for(let[d,f]of this.entries){let T=t[d];if(Array.isArray(f)){let l=T.length,N=f[1]===void 0;if(N&&(o[0](e,l,i.offset),i.offset+=1),l>0){let D=f[0];if(typeof D=="object"){if(N){let m=l*D.minimumByteLength;r+=m,a+=m,e.byteLength<a&&(e=u(e,a))}for(let m of T)e=D.write(e,m,i,r,a,o,u,s),r=i.offset,a=e.byteLength}else if(D==="")for(let m=0;m<l;++m){let B=T[m],U=B.length;o[1](e,U,i.offset),i.offset+=2,s(e,i.offset,B),i.offset+=U}else{let m=y[D];if(N){let B=l*m;r+=B,a+=B,e.byteLength<a&&(e=u(e,a))}for(let B of T)o[D](e,B,i.offset),i.offset+=m}}}else if(typeof f=="number")o[f](e,T,i.offset),i.offset+=y[f];else if(f===""){let l=T.length;o[1](e,l,i.offset),i.offset+=2,s(e,i.offset,T),i.offset+=l}else if("flags"in f){let l=0;for(let N=0;N<f.flags.length;++N)T[f.flags[N]]&&(l|=1<<N);o[0](e,l,i.offset),i.offset+=1}else"optional"in f?T?(o[0](e,1,i.offset),i.offset+=1,r+=f.optional.minimumByteLength,a+=f.optional.minimumByteLength,e.byteLength<a&&(e=u(e,a)),e=f.optional.write(e,T,i,r,a,o,u,s),r=i.offset,a=e.byteLength):(o[0](e,0,i.offset),i.offset+=1):(e=f.write(e,T,i,r,a,o,u,s),r=i.offset,a=e.byteLength)}return e}precalculateBufferLengthWithStrings(e){let t=this.minimumByteLength;for(let i of this.stringPositions[0])t+=e[i].length;for(let i of this.stringPositions[1])for(let r of e[i])t+=2+r.length;for(let i in this.stringPositions[2])t+=this.stringPositions[2][i].precalculateBufferLengthWithStrings(e[i]);return t}};function v(n){return Object.entries(n).sort(([e],[t])=>e.localeCompare(t))}function L(n){let e=1,t=[[],[],{}];for(let[i,r]of n)if(Array.isArray(r))if(r.length===2){let a=r[0]==="",o=typeof r[0]=="object"?r[0].minimumByteLength:a?2:y[r[0]];e+=r[1]*o,a&&t[1].push(i)}else e+=1,r[0]===""&&t[1].push(i);else r instanceof F?(e+=r.minimumByteLength,t[2][i]=r):typeof r=="object"?e+=1:r===""?(e+=2,t[0].push(i)):e+=y[r];return{minimumByteLength:e,stringPositions:t}}var y=Array(8);y[0]=1;y[3]=1;y[1]=2;y[4]=2;y[2]=4;y[5]=4;y[6]=4;y[7]=8;var g=Array(8);g[0]=(n,e)=>n.getUint8(e);g[3]=(n,e)=>n.getInt8(e);g[1]=(n,e)=>n.getUint16(e);g[4]=(n,e)=>n.getInt16(e);g[2]=(n,e)=>n.getUint32(e);g[5]=(n,e)=>n.getInt32(e);g[6]=(n,e)=>n.getFloat32(e);g[7]=(n,e)=>n.getFloat64(e);var _=Array(8);_[0]=(n,e,t)=>n.setUint8(t,e);_[3]=(n,e,t)=>n.setInt8(t,e);_[1]=(n,e,t)=>n.setUint16(t,e);_[4]=(n,e,t)=>n.setInt16(t,e);_[2]=(n,e,t)=>n.setUint32(t,e);_[5]=(n,e,t)=>n.setInt32(t,e);_[6]=(n,e,t)=>n.setFloat32(t,e);_[7]=(n,e,t)=>n.setFloat64(t,e);var c=Array(8);p&&(c[0]=(n,e,t)=>n.writeUint8(e,t),c[3]=(n,e,t)=>n.writeInt8(e,t),c[1]=(n,e,t)=>n.writeUint16BE(e,t),c[4]=(n,e,t)=>n.writeInt16BE(e,t),c[2]=(n,e,t)=>n.writeUint32BE(e,t),c[5]=(n,e,t)=>n.writeInt32BE(e,t),c[6]=(n,e,t)=>n.writeFloatBE(e,t),c[7]=(n,e,t)=>n.writeDoubleBE(e,t));var I=Array(8);p&&(I[0]=(n,e)=>n.readUint8(e),I[3]=(n,e)=>n.readInt8(e),I[1]=(n,e)=>n.readUint16BE(e),I[4]=(n,e)=>n.readInt16BE(e),I[2]=(n,e)=>n.readUint32BE(e),I[5]=(n,e)=>n.readInt32BE(e),I[6]=(n,e)=>n.readFloatBE(e),I[7]=(n,e)=>n.readDoubleBE(e));export{F as BinaryPacket,k as Field,C as FieldArray,K as FieldBitFlags,j as FieldFixedArray,M as FieldOptional,R as FieldString};
+var p=typeof Buffer=="function";function w(i,e){let t=new ArrayBuffer(e),n=Math.min(i.byteLength,t.byteLength),r=Math.trunc(n/8);new Float64Array(t,0,r).set(new Float64Array(i.buffer,0,r));let a=r*8;return r=n-a,new Uint8Array(t,a,r).set(new Uint8Array(i.buffer,a,r)),new DataView(t)}function E(i,e){let t=Buffer.allocUnsafe(e);return i.copy(t),t}var V=new TextEncoder,k=new TextDecoder;function A(i,e,t){let n=t.length,r=new Uint8Array(i.buffer,i.byteOffset+e,n);n<=64?x(r,0,t,n):V.encodeInto(t,r)}function F(i,e,t){let n=t.length;n<=64?x(i,e,t,n):i.utf8Write(t,e,n)}function x(i,e,t,n){for(let r=0;r<n;++r)i[e+r]=t.charCodeAt(r)&255}function h(i,e,t){return i.subarray(e,e+t).toString("utf8")}function b(i,e,t){return k.decode(new DataView(i.buffer,i.byteOffset+e,t))}var L=(s=>(s[s.UNSIGNED_INT_8=0]="UNSIGNED_INT_8",s[s.UNSIGNED_INT_16=1]="UNSIGNED_INT_16",s[s.UNSIGNED_INT_32=2]="UNSIGNED_INT_32",s[s.INT_8=3]="INT_8",s[s.INT_16=4]="INT_16",s[s.INT_32=5]="INT_32",s[s.FLOAT_32=6]="FLOAT_32",s[s.FLOAT_64=7]="FLOAT_64",s))(L||{});function C(i){return[i]}function z(i,e){if(e<0||!Number.isFinite(e))throw new RangeError("Length of a FixedArray must be a positive integer.");return[i,e]}var G=class{constructor(e,t){this.iterable=e;this.length=t}[Symbol.iterator](){return this.iterable[Symbol.iterator]()}};function q(i){if(i.length>8)throw new Error(`Invalid BinaryPacket definition: a BitFlags field can have only up to 8 flags, given: ${i.join(", ")}`);return{flags:i}}function j(){return""}function K(i){return{optional:i}}var S=class i{constructor(e,t){this.packetId=e;this.entries=t?v(t):[];let n=O(this.entries);this.minimumByteLength=n.minimumByteLength,this.stringPositions=n.stringPositions}static define(e,t){if(e<0||!Number.isFinite(e))throw new RangeError("Packet IDs must be positive integers.");if(e>255)throw new RangeError("Packet IDs greater than 255 are not supported. Do you REALLY need more than 255 different kinds of packets?");return new i(e,t)}static readPacketIdNodeBuffer(e,t=0){return e.readUint8(t)}static readPacketIdDataView(e,t=0){return e.getUint8(t)}static readPacketIdArrayBuffer(e,t){return new Uint8Array(e,t,1)[0]}static visitNodeBuffer(e,...t){return i.visit(e,c,h,t)}static visitDataView(e,...t){return i.visit(e,I,b,t)}static visitArrayBuffer(e,t,n,...r){return i.visit(new DataView(e,t,n),I,b,r)}readNodeBuffer(e,t={offset:0},n=e.byteLength){return this.read(e,t,n,c,h)}readDataView(e,t={offset:0},n=e.byteLength){return this.read(e,t,n,I,b)}readArrayBuffer(e,t,n){return this.read(p?Buffer.from(e,t,n):new DataView(e,t,n),{offset:0},n,p?c:I,p?h:b)}writeNodeBuffer(e){let t=this.precalculateBufferLengthWithStrings(e),n=Buffer.allocUnsafe(t);return this.write(n,e,{offset:0},t,t,g,E,F)}writeDataView(e){let t=this.precalculateBufferLengthWithStrings(e),n=new DataView(new ArrayBuffer(t));return this.write(n,e,{offset:0},t,t,_,w,A)}writeArrayBuffer(e){let t=p?this.writeNodeBuffer(e):this.writeDataView(e);return{buffer:t.buffer,byteLength:t.byteLength,byteOffset:t.byteOffset}}visitor(e){return[this,e]}sequentialSerializer(e,t){let n=this.minimumByteLength*e,r=Buffer.allocUnsafe(n),a={offset:0};for(let o of t)this.write(r,o,a,n,n,g,E,F)}entries;stringPositions;minimumByteLength;static visit(e,t,n,r){for(let[a,o]of r)if(a.packetId===t[0](e,0))return o(a.read(e,{offset:0},e.byteLength,t,n))}read(e,t,n,r,a){if(n+t.offset<this.minimumByteLength)throw new Error(`There is no space available to fit a packet of type ${this.packetId} at offset ${t.offset}`);if(r[0](e,t.offset)!==this.packetId)throw new Error(`Data at offset ${t.offset} is not a packet of type ${this.packetId}`);t.offset+=1;let o={};for(let[y,s]of this.entries)if(Array.isArray(s)){let d=s[1]??r[0](e,t.offset++),f=Array(d),u=s[0];if(typeof u=="object")for(let l=0;l<d;++l)f[l]=u.read(e,t,n,r,a);else if(u==="")for(let l=0;l<d;++l){let T=r[1](e,t.offset);t.offset+=2,f[l]=a(e,t.offset,T),t.offset+=T}else{let l=N[u];for(let T=0;T<d;++T)f[T]=r[u](e,t.offset),t.offset+=l}o[y]=f}else if(typeof s=="number")o[y]=r[s](e,t.offset),t.offset+=N[s];else if(s===""){let d=r[1](e,t.offset);t.offset+=2,o[y]=a(e,t.offset,d),t.offset+=d}else if("flags"in s){let d=r[0](e,t.offset);t.offset+=1,o[y]={};for(let f=0;f<s.flags.length;++f)o[y][s.flags[f]]=!!(d&1<<f)}else if("optional"in s){let d=r[0](e,t.offset)!==0;t.offset+=1,d&&(o[y]=s.optional.read(e,t,n,r,a))}else o[y]=s.read(e,t,n,r,a);return o}write(e,t,n,r,a,o,y,s){o[0](e,this.packetId,n.offset),n.offset+=1;for(let[d,f]of this.entries){let u=t[d];if(Array.isArray(f)){let l=u.length,T=f[1]===void 0;if(T&&(o[0](e,l,n.offset),n.offset+=1),l>0){let D=f[0];if(typeof D=="object"){if(T){let m=l*D.minimumByteLength;r+=m,a+=m,e.byteLength<a&&(e=y(e,a))}for(let m of u)e=D.write(e,m,n,r,a,o,y,s),r=n.offset,a=e.byteLength}else if(D==="")for(let m=0;m<l;++m){let B=u[m],U=B.length;o[1](e,U,n.offset),n.offset+=2,s(e,n.offset,B),n.offset+=U}else{let m=N[D];if(T){let B=l*m;r+=B,a+=B,e.byteLength<a&&(e=y(e,a))}for(let B of u)o[D](e,B,n.offset),n.offset+=m}}}else if(typeof f=="number")o[f](e,u,n.offset),n.offset+=N[f];else if(f===""){let l=u.length;o[1](e,l,n.offset),n.offset+=2,s(e,n.offset,u),n.offset+=l}else if("flags"in f){let l=0;for(let T=0;T<f.flags.length;++T)u[f.flags[T]]&&(l|=1<<T);o[0](e,l,n.offset),n.offset+=1}else"optional"in f?u?(o[0](e,1,n.offset),n.offset+=1,r+=f.optional.minimumByteLength,a+=f.optional.minimumByteLength,e.byteLength<a&&(e=y(e,a)),e=f.optional.write(e,u,n,r,a,o,y,s),r=n.offset,a=e.byteLength):(o[0](e,0,n.offset),n.offset+=1):(e=f.write(e,u,n,r,a,o,y,s),r=n.offset,a=e.byteLength)}return e}precalculateBufferLengthWithStrings(e){let t=this.minimumByteLength;for(let n of this.stringPositions[0])t+=e[n].length;for(let n of this.stringPositions[1])for(let r of e[n])t+=2+r.length;for(let n in this.stringPositions[2])t+=this.stringPositions[2][n].precalculateBufferLengthWithStrings(e[n]);return t}};function v(i){return Object.entries(i).sort(([e],[t])=>e.localeCompare(t))}function O(i){let e=1,t=[[],[],{}];for(let[n,r]of i)if(Array.isArray(r))if(r.length===2){let a=r[0]==="",o=typeof r[0]=="object"?r[0].minimumByteLength:a?2:N[r[0]];e+=r[1]*o,a&&t[1].push(n)}else e+=1,r[0]===""&&t[1].push(n);else r instanceof S?(e+=r.minimumByteLength,t[2][n]=r):typeof r=="object"?e+=1:r===""?(e+=2,t[0].push(n)):e+=N[r];return{minimumByteLength:e,stringPositions:t}}var N=Array(8);N[0]=1;N[3]=1;N[1]=2;N[4]=2;N[2]=4;N[5]=4;N[6]=4;N[7]=8;var I=Array(8);I[0]=(i,e)=>i.getUint8(e);I[3]=(i,e)=>i.getInt8(e);I[1]=(i,e)=>i.getUint16(e);I[4]=(i,e)=>i.getInt16(e);I[2]=(i,e)=>i.getUint32(e);I[5]=(i,e)=>i.getInt32(e);I[6]=(i,e)=>i.getFloat32(e);I[7]=(i,e)=>i.getFloat64(e);var _=Array(8);_[0]=(i,e,t)=>i.setUint8(t,e);_[3]=(i,e,t)=>i.setInt8(t,e);_[1]=(i,e,t)=>i.setUint16(t,e);_[4]=(i,e,t)=>i.setInt16(t,e);_[2]=(i,e,t)=>i.setUint32(t,e);_[5]=(i,e,t)=>i.setInt32(t,e);_[6]=(i,e,t)=>i.setFloat32(t,e);_[7]=(i,e,t)=>i.setFloat64(t,e);var g=Array(8);p&&(g[0]=(i,e,t)=>i.writeUint8(e,t),g[3]=(i,e,t)=>i.writeInt8(e,t),g[1]=(i,e,t)=>i.writeUint16BE(e,t),g[4]=(i,e,t)=>i.writeInt16BE(e,t),g[2]=(i,e,t)=>i.writeUint32BE(e,t),g[5]=(i,e,t)=>i.writeInt32BE(e,t),g[6]=(i,e,t)=>i.writeFloatBE(e,t),g[7]=(i,e,t)=>i.writeDoubleBE(e,t));var c=Array(8);p&&(c[0]=(i,e)=>i.readUint8(e),c[3]=(i,e)=>i.readInt8(e),c[1]=(i,e)=>i.readUint16BE(e),c[4]=(i,e)=>i.readInt16BE(e),c[2]=(i,e)=>i.readUint32BE(e),c[5]=(i,e)=>i.readInt32BE(e),c[6]=(i,e)=>i.readFloatBE(e),c[7]=(i,e)=>i.readDoubleBE(e));export{S as BinaryPacket,L as Field,C as FieldArray,q as FieldBitFlags,z as FieldFixedArray,K as FieldOptional,j as FieldString,G as SequentialSerializer};
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/buffers.ts","../src/index.ts"],"sourcesContent":["/**\r\n * Exclusively matches objects of type `ArrayBuffer` and no other types that inherit from it. \\\r\n * This is needed because the `DataView` constructor explicitly requires a \"true\" ArrayBuffer, or else it throws.\r\n */\r\nexport type TrueArrayBuffer = ArrayBuffer & { buffer?: undefined }\r\n\r\nexport const hasNodeBuffers = typeof Buffer === 'function'\r\n\r\nexport function growDataView(dataview: DataView, newByteLength: number) {\r\n  const resizedBuffer = new ArrayBuffer(newByteLength)\r\n  const amountToCopy = Math.min(dataview.byteLength, resizedBuffer.byteLength)\r\n\r\n  // Treat the buffer as if it was a Float64Array so we can copy 8 bytes at a time, to finish faster\r\n  let length = Math.trunc(amountToCopy / 8)\r\n  new Float64Array(resizedBuffer, 0, length).set(new Float64Array(dataview.buffer, 0, length))\r\n\r\n  // Copy the remaining up to 7 bytes\r\n  const offset = length * 8\r\n  length = amountToCopy - offset\r\n  new Uint8Array(resizedBuffer, offset, length).set(new Uint8Array(dataview.buffer, offset, length))\r\n\r\n  return new DataView(resizedBuffer)\r\n}\r\n\r\nexport function growNodeBuffer(buffer: Buffer, newByteLength: number) {\r\n  const newBuffer = Buffer.allocUnsafe(newByteLength)\r\n  buffer.copy(newBuffer)\r\n  return newBuffer\r\n}\r\n\r\nconst textEncoder = new TextEncoder()\r\nconst textDecoder = new TextDecoder()\r\n\r\nexport function encodeStringIntoDataView(dataview: DataView, byteOffset: number, string: string) {\r\n  const strlen = string.length\r\n  const u8Buffer = new Uint8Array(dataview.buffer, dataview.byteOffset + byteOffset, strlen)\r\n\r\n  if (strlen <= 64) {\r\n    encodeSmallString(u8Buffer, 0, string, strlen)\r\n  } else {\r\n    textEncoder.encodeInto(string, u8Buffer)\r\n  }\r\n}\r\n\r\nexport function encodeStringIntoNodeBuffer(buffer: Buffer, byteOffset: number, string: string) {\r\n  const strlen = string.length\r\n\r\n  if (strlen <= 64) {\r\n    encodeSmallString(buffer, byteOffset, string, strlen)\r\n  } else {\r\n    buffer.utf8Write(string, byteOffset, strlen)\r\n  }\r\n}\r\n\r\nfunction encodeSmallString(buffer: Uint8Array, byteOffset: number, string: string, strlen: number) {\r\n  for (let i = 0; i < strlen; ++i) {\r\n    buffer[byteOffset + i] = string.charCodeAt(i) & 0xff\r\n  }\r\n}\r\n\r\nexport function decodeStringFromNodeBuffer(buffer: Buffer, byteOffset: number, strlen: number) {\r\n  return buffer.subarray(byteOffset, byteOffset + strlen).toString('utf8')\r\n}\r\n\r\nexport function decodeStringFromDataView(dataview: DataView, byteOffset: number, strlen: number) {\r\n  return textDecoder.decode(new DataView(dataview.buffer, dataview.byteOffset + byteOffset, strlen))\r\n}\r\n\r\ndeclare global {\r\n  interface Buffer {\r\n    /**\r\n     * Node buffer's internals function. \\\r\n     * For some reason it is not exposed through TypeScript. \\\r\n     * Fastest way to write utf8 strings into buffers.\r\n     */\r\n    utf8Write(string: string, byteOffset?: number, byteLength?: number): number\r\n  }\r\n}\r\n","import {\r\n  decodeStringFromDataView,\r\n  decodeStringFromNodeBuffer,\r\n  encodeStringIntoDataView,\r\n  encodeStringIntoNodeBuffer,\r\n  growDataView,\r\n  growNodeBuffer,\r\n  hasNodeBuffers,\r\n  type TrueArrayBuffer\r\n} from './buffers'\r\n\r\nexport const enum Field {\r\n  /**\r\n   * Defines a 1 byte (8 bits) unsigned integer field. \\\r\n   * (Range: 0 - 255)\r\n   */\r\n  UNSIGNED_INT_8 = 0,\r\n\r\n  /**\r\n   * Defines a 2 bytes (16 bits) unsigned integer field. \\\r\n   * (Range: 0 - 65535)\r\n   */\r\n  UNSIGNED_INT_16,\r\n\r\n  /**\r\n   * Defines a 4 bytes (32 bits) unsigned integer field. \\\r\n   * (Range: 0 - 4294967295)\r\n   */\r\n  UNSIGNED_INT_32,\r\n\r\n  /**\r\n   * Defines a 1 byte (8 bits) signed integer field. \\\r\n   * (Range: -128 - 127)\r\n   */\r\n  INT_8,\r\n\r\n  /**\r\n   * Defines a 2 bytes (16 bits) signed integer field. \\\r\n   * (Range: -32768 - 32767)\r\n   */\r\n  INT_16,\r\n\r\n  /**\r\n   * Defines a 4 bytes (32 bits) signed integer field. \\\r\n   * (Range: -2147483648 - 2147483647)\r\n   */\r\n  INT_32,\r\n\r\n  /**\r\n   * Defines a 4 bytes (32 bits) floating-point field. \\\r\n   */\r\n  FLOAT_32,\r\n\r\n  /**\r\n   * Defines a 8 bytes (64 bits) floating-point field. \\\r\n   */\r\n  FLOAT_64\r\n}\r\n\r\n/**\r\n * Defines a dynamically-sized array with elements of a certain type. \\\r\n * Dynamically-sized arrays are useful when a packet's field is an array of a non pre-defined length. \\\r\n * Although, this makes dynamically-sized arrays more memory expensive as the internal buffer needs to be grown accordingly.\r\n *\r\n * NOTE: If an array will ALWAYS have the same length, prefer using the `FieldFixedArray` type, for both better performance and memory efficiency. \\\r\n * NOTE: As of now, dynamic arrays can have at most 256 elements.\r\n */\r\nexport function FieldArray<T extends Field | BinaryPacket<Definition> | ''>(\r\n  item: T\r\n): [itemType: T] {\r\n  return [item]\r\n}\r\n\r\n/**\r\n * Defines a statically-sized array with elements of a certain type. \\\r\n * Fixed arrays are useful when a packet's field is an array of a pre-defined length. \\\r\n * Fixed arrays much more memory efficient and performant than non-fixed ones.\r\n *\r\n * NOTE: If an array will not always have the same length, use the `FieldArray` type.\r\n */\r\nexport function FieldFixedArray<\r\n  T extends Field | BinaryPacket<Definition> | '',\r\n  Length extends number\r\n>(item: T, length: Length): [itemType: T, length: Length] {\r\n  if (length < 0 || !Number.isFinite(length)) {\r\n    throw new RangeError('Length of a FixedArray must be a positive integer.')\r\n  }\r\n\r\n  return [item, length]\r\n}\r\n\r\ntype BitFlags = (string[] | ReadonlyArray<string>) & {\r\n  length: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8\r\n}\r\n\r\n/**\r\n * Defines a sequence of up to 8 \"flags\" (basically single bits/booleans) that can be packed together into a single 8 bits value. \\\r\n * This is useful for minimizing bytes usage when there are lots of boolean fields/flags, instead of saving each flag separately as its own 8 bits value.\r\n *\r\n * The input should be an array of strings (with at most 8 elements) where each string defines the name of a flag. \\\r\n * This is just for definition purposes, then when actually writing or reading packets it'll just be a record-object with those names as keys and boolean values.\r\n */\r\nexport function FieldBitFlags<const FlagsArray extends BitFlags>(flags: FlagsArray) {\r\n  if (flags.length > 8) {\r\n    throw new Error(\r\n      `Invalid BinaryPacket definition: a BitFlags field can have only up to 8 flags, given: ${flags.join(', ')}`\r\n    )\r\n  }\r\n\r\n  return { flags }\r\n}\r\n\r\n/**\r\n * Defines a string field. \\\r\n * Strings cannot be more than 65536 characters long.\r\n *\r\n * NOTE: Only strings containing just ASCII and/or single-octet UTF-8 characters are supported.\r\n */\r\nexport function FieldString() {\r\n  return '' as const\r\n}\r\n\r\n/**\r\n * Defines an optional BinaryPacket \"subpacket\" field. \\\r\n * When writing and reading packets it'll be possible to provide and receive `undefined` instead of a valid object.\r\n */\r\nexport function FieldOptional<T extends BinaryPacket<Definition>>(packet: T) {\r\n  return { optional: packet }\r\n}\r\n\r\n/**\r\n * Do not manually construct this type: an object of this kind is returned by a BinaryPacket `createVisitor` method. \\\r\n * Used in the `BinaryPacket::visit` static method to perform a sort of \"pattern matching\" on an incoming packet (of yet unknown type) buffer.\r\n */\r\ntype Visitor = [BinaryPacket<Definition>, (packet: any) => void]\r\n\r\nexport class BinaryPacket<T extends Definition> {\r\n  /**\r\n   * Defines a new binary packet. \\\r\n   * Make sure that every `packetId` is unique.\r\n   * @throws RangeError If packetId is negative, floating-point, or greater than 255.\r\n   */\r\n  static define<T extends Definition>(packetId: number, definition?: T) {\r\n    if (packetId < 0 || !Number.isFinite(packetId)) {\r\n      throw new RangeError('Packet IDs must be positive integers.')\r\n    }\r\n\r\n    if (packetId > 255) {\r\n      throw new RangeError(\r\n        'Packet IDs greater than 255 are not supported. Do you REALLY need more than 255 different kinds of packets?'\r\n      )\r\n    }\r\n\r\n    return new BinaryPacket(packetId, definition)\r\n  }\r\n\r\n  /**\r\n   * Reads just the packetId from the given Buffer. \\\r\n   * This method practically just reads the uint8 at offset `byteOffset` (default: 0). \\\r\n   * Useful if the receiving side receives multiple types of packets.\r\n   */\r\n  static readPacketIdNodeBuffer(buffer: Buffer, byteOffset = 0) {\r\n    return buffer.readUint8(byteOffset)\r\n  }\r\n\r\n  /**\r\n   * Reads just the packetId from the given DataView. \\\r\n   * This method practically just reads the uint8 at offset `byteOffset` (default: 0). \\\r\n   * Useful if the receiving side receives multiple types of packets.\r\n   */\r\n  static readPacketIdDataView(dataview: DataView, byteOffset = 0) {\r\n    return dataview.getUint8(byteOffset)\r\n  }\r\n\r\n  /**\r\n   * Reads just the packetId from the given ArrayBuffer. \\\r\n   * This method practically just reads the uint8 at offset `byteOffset`. \\\r\n   * Useful if the receiving side receives multiple types of packets.\r\n   *\r\n   * NOTE: Due to security issues, the `byteOffset` argument cannot be defaulted and must be provided by the user. \\\r\n   * NOTE: For more information read the `readArrayBuffer` method documentation.\r\n   */\r\n  static readPacketIdArrayBuffer(arraybuffer: TrueArrayBuffer, byteOffset: number) {\r\n    return new Uint8Array(arraybuffer, byteOffset, 1)[0]\r\n  }\r\n\r\n  /**\r\n   * Visits and \"pattern matches\" the given Buffer through the given visitors. \\\r\n   * The Buffer is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\r\n   *\r\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\r\n   */\r\n  static visitNodeBuffer(buffer: Buffer, ...visitors: Visitor[]) {\r\n    return BinaryPacket.visit(buffer, GET_FUNCTION_BUF, decodeStringFromNodeBuffer, visitors)\r\n  }\r\n\r\n  /**\r\n   * Visits and \"pattern matches\" the given DataView through the given visitors. \\\r\n   * The DataView is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\r\n   *\r\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\r\n   */\r\n  static visitDataView(dataview: DataView, ...visitors: Visitor[]) {\r\n    return BinaryPacket.visit(dataview, GET_FUNCTION, decodeStringFromDataView, visitors)\r\n  }\r\n\r\n  /**\r\n   * Visits and \"pattern matches\" the given ArrayBuffer through the given visitors. \\\r\n   * The ArrayBuffer is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\r\n   *\r\n   * NOTE: Due to security issues, the `byteOffset` and `byteLength` arguments must be provided by the user. \\\r\n   * NOTE: For more information read the `readArrayBuffer` method documentation. \\\r\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\r\n   */\r\n  static visitArrayBuffer(\r\n    arraybuffer: TrueArrayBuffer,\r\n    byteOffset: number,\r\n    byteLength: number,\r\n    ...visitors: Visitor[]\r\n  ) {\r\n    return BinaryPacket.visit(\r\n      new DataView(arraybuffer, byteOffset, byteLength),\r\n      GET_FUNCTION,\r\n      decodeStringFromDataView,\r\n      visitors\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Reads/deserializes from the given Buffer. \\\r\n   * Method available ONLY on NodeJS and Bun.\r\n   *\r\n   * If possible, always prefer reading using this method, as it is much faster than the other ones.\r\n   *\r\n   * NOTE: if you have an ArrayBuffer do not bother wrapping it into a node Buffer yourself. \\\r\n   * NOTE: if you have an ArrayBuffer use the appropriate `readArrayBuffer`.\r\n   */\r\n  readNodeBuffer(\r\n    dataIn: Buffer,\r\n    offsetPointer = { offset: 0 },\r\n    byteLength = dataIn.byteLength\r\n  ): ToJson<T> {\r\n    return this.read(\r\n      dataIn,\r\n      offsetPointer,\r\n      byteLength,\r\n      GET_FUNCTION_BUF,\r\n      decodeStringFromNodeBuffer\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Reads/deserializes from the given DataView.\r\n   *\r\n   * NOTE: if you have an ArrayBuffer do not bother wrapping it into a DataView yourself. \\\r\n   * NOTE: if you have an ArrayBuffer use the appropriate `readArrayBuffer`.\r\n   */\r\n  readDataView(\r\n    dataIn: DataView,\r\n    offsetPointer = { offset: 0 },\r\n    byteLength = dataIn.byteLength\r\n  ): ToJson<T> {\r\n    return this.read(dataIn, offsetPointer, byteLength, GET_FUNCTION, decodeStringFromDataView)\r\n  }\r\n\r\n  /**\r\n   * Reads/deserializes from the given ArrayBuffer. \\\r\n   * WARNING: this method is practically a HACK.\r\n   *\r\n   * When using this method both the `byteOffset` and `byteLength` are REQUIRED and cannot be defaulted. \\\r\n   * This is to prevent serious bugs and security issues. \\\r\n   * That is because often raw ArrayBuffers come from a pre-allocated buffer pool and do not start at byteOffset 0.\r\n   *\r\n   * NOTE: if you have a node Buffer do not bother wrapping it into an ArrayBuffer yourself. \\\r\n   * NOTE: if you have a node Buffer use the appropriate `readNodeBuffer` as it is much faster and less error prone.\r\n   */\r\n  readArrayBuffer(dataIn: TrueArrayBuffer, byteOffset: number, byteLength: number) {\r\n    return this.read(\r\n      hasNodeBuffers\r\n        ? Buffer.from(dataIn, byteOffset, byteLength)\r\n        : (new DataView(dataIn, byteOffset, byteLength) as any),\r\n      { offset: 0 }, // The underlying buffer has already been offsetted\r\n      byteLength,\r\n      hasNodeBuffers ? GET_FUNCTION_BUF : GET_FUNCTION,\r\n      hasNodeBuffers ? decodeStringFromNodeBuffer : (decodeStringFromDataView as any)\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Writes/serializes the given object into a Buffer. \\\r\n   * Method available ONLY on NodeJS and Bun.\r\n   *\r\n   * If possible, always prefer writing using this method, as it is much faster than the other ones.\r\n   */\r\n  writeNodeBuffer(dataOut: ToJson<T>) {\r\n    const byteLength = this.precalculateBufferLengthWithStrings(dataOut)\r\n    const buffer = Buffer.allocUnsafe(byteLength)\r\n\r\n    return this.write(\r\n      buffer,\r\n      dataOut,\r\n      { offset: 0 },\r\n      byteLength,\r\n      byteLength,\r\n      SET_FUNCTION_BUF,\r\n      growNodeBuffer,\r\n      encodeStringIntoNodeBuffer\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Writes/serializes the given object into a DataView. \\\r\n   */\r\n  writeDataView(dataOut: ToJson<T>) {\r\n    const byteLength = this.precalculateBufferLengthWithStrings(dataOut)\r\n    const dataview = new DataView(new ArrayBuffer(byteLength))\r\n\r\n    return this.write(\r\n      dataview,\r\n      dataOut,\r\n      { offset: 0 },\r\n      byteLength,\r\n      byteLength,\r\n      SET_FUNCTION,\r\n      growDataView,\r\n      encodeStringIntoDataView\r\n    )\r\n  }\r\n\r\n  /**\r\n   * Writes/serializes the given object into an ArrayBuffer. \\\r\n   * This method is just a wrapper around either  `writeNodeBuffer` or `writeDataView`. \\\r\n   *\r\n   * This method works with JavaScript standard raw ArrayBuffer(s) and, as such, is very error prone: \\\r\n   * Make sure you're using the returned byteLength and byteOffset fields in the read counterpart. \\\r\n   *\r\n   * Always consider whether is possible to use directly `writeNodeBuffer` or `writeDataView` instead of `writeArrayBuffer`. \\\r\n   * For more information read the `readArrayBuffer` documentation.\r\n   */\r\n  writeArrayBuffer(dataOut: ToJson<T>) {\r\n    const buf = hasNodeBuffers ? this.writeNodeBuffer(dataOut) : this.writeDataView(dataOut)\r\n    return { buffer: buf.buffer, byteLength: buf.byteLength, byteOffset: buf.byteOffset }\r\n  }\r\n\r\n  /**\r\n   * Creates a \"visitor\" object for this BinaryPacket definition. \\\r\n   * Used when visiting and \"pattern matching\" buffers with the `BinaryPacket::visit` static utility methods. \\\r\n   *\r\n   * For more information read the `BinaryPacket::visitNodeBuffer` documentation. \\\r\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\r\n   */\r\n  visitor(onVisit: (packet: ToJson<T>) => void): Visitor {\r\n    return [this, onVisit]\r\n  }\r\n\r\n  /// PRIVATE\r\n\r\n  private readonly entries: Entries\r\n  readonly stringPositions: StringPositions\r\n  readonly minimumByteLength: number\r\n\r\n  private constructor(\r\n    private readonly packetId: number,\r\n    definition?: T\r\n  ) {\r\n    this.entries = definition ? sortEntries(definition) : []\r\n    const inspection = inspectEntries(this.entries)\r\n    this.minimumByteLength = inspection.minimumByteLength\r\n    this.stringPositions = inspection.stringPositions\r\n  }\r\n\r\n  private static visit<Buf extends DataView | Buffer>(\r\n    dataIn: Buf,\r\n    readFunctions: typeof GET_FUNCTION | typeof GET_FUNCTION_BUF,\r\n    decodeStringFunction: (dataIn: Buf, byteOffset: number, strlen: number) => string,\r\n    visitors: Visitor[]\r\n  ) {\r\n    for (const [Packet, onVisit] of visitors) {\r\n      if (Packet.packetId === readFunctions[Field.UNSIGNED_INT_8](dataIn as any, 0)) {\r\n        return onVisit(\r\n          Packet.read(dataIn, { offset: 0 }, dataIn.byteLength, readFunctions, decodeStringFunction)\r\n        )\r\n      }\r\n    }\r\n  }\r\n\r\n  private read<Buf extends DataView | Buffer>(\r\n    dataIn: Buf,\r\n    offsetPointer: { offset: number },\r\n    byteLength: number,\r\n    readFunctions: typeof GET_FUNCTION | typeof GET_FUNCTION_BUF,\r\n    decodeStringFunction: (dataIn: Buf, byteOffset: number, strlen: number) => string\r\n  ): ToJson<T> {\r\n    if (byteLength + offsetPointer.offset < this.minimumByteLength) {\r\n      throw new Error(\r\n        `There is no space available to fit a packet of type ${this.packetId} at offset ${offsetPointer.offset}`\r\n      )\r\n    }\r\n\r\n    if (\r\n      readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset) !== this.packetId\r\n    ) {\r\n      throw new Error(\r\n        `Data at offset ${offsetPointer.offset} is not a packet of type ${this.packetId}`\r\n      )\r\n    }\r\n\r\n    offsetPointer.offset += 1\r\n    const result: any = {}\r\n\r\n    for (const [name, def] of this.entries) {\r\n      if (Array.isArray(def)) {\r\n        const length =\r\n          // def[1] is the length of a statically-sized array, if undefined: must read the length from the buffer as it means it's a dynamically-sized array\r\n          def[1] ?? readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset++)\r\n\r\n        const array = Array(length)\r\n\r\n        const itemType = def[0]\r\n\r\n        if (typeof itemType === 'object') {\r\n          // Array of \"subpackets\"\r\n          for (let i = 0; i < length; ++i) {\r\n            array[i] = itemType.read(\r\n              dataIn,\r\n              offsetPointer,\r\n              byteLength,\r\n              readFunctions,\r\n              decodeStringFunction\r\n            )\r\n          }\r\n        } else if (itemType === '') {\r\n          // Array of strings\r\n          for (let i = 0; i < length; ++i) {\r\n            const strlen = readFunctions[Field.UNSIGNED_INT_16](dataIn as any, offsetPointer.offset)\r\n            offsetPointer.offset += 2\r\n\r\n            array[i] = decodeStringFunction(dataIn, offsetPointer.offset, strlen)\r\n            offsetPointer.offset += strlen\r\n          }\r\n        } else {\r\n          // Array of primitives (numbers)\r\n          const itemSize = BYTE_SIZE[itemType]\r\n\r\n          // It seems like looping over each element is actually much faster than using TypedArrays bulk copy.\r\n          // TODO: properly benchmark with various array sizes to see if it's actually the case.\r\n          for (let i = 0; i < length; ++i) {\r\n            array[i] = readFunctions[itemType](dataIn as any, offsetPointer.offset)\r\n            offsetPointer.offset += itemSize\r\n          }\r\n        }\r\n\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = array\r\n      } else if (typeof def === 'number') {\r\n        // Single primitive (number)\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = readFunctions[def](dataIn as any, offsetPointer.offset)\r\n        offsetPointer.offset += BYTE_SIZE[def]\r\n      } else if (def === '') {\r\n        const strlen = readFunctions[Field.UNSIGNED_INT_16](dataIn as any, offsetPointer.offset)\r\n        offsetPointer.offset += 2\r\n\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = decodeStringFunction(dataIn, offsetPointer.offset, strlen)\r\n        offsetPointer.offset += strlen\r\n      } else if ('flags' in def) {\r\n        // BitFlags\r\n        const flags = readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset)\r\n        offsetPointer.offset += 1\r\n\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = {}\r\n\r\n        for (let bit = 0; bit < def.flags.length; ++bit) {\r\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n          result[name][def.flags[bit]] = !!(flags & (1 << bit))\r\n        }\r\n      } else if ('optional' in def) {\r\n        // Single optional \"subpacket\"\r\n        const hasSubPacket =\r\n          readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset) !== 0\r\n\r\n        offsetPointer.offset += 1\r\n\r\n        if (hasSubPacket) {\r\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n          result[name] = def.optional.read(\r\n            dataIn,\r\n            offsetPointer,\r\n            byteLength,\r\n            readFunctions,\r\n            decodeStringFunction\r\n          )\r\n        }\r\n      } else {\r\n        // Single \"subpacket\"\r\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\r\n        result[name] = def.read(\r\n          dataIn,\r\n          offsetPointer,\r\n          byteLength,\r\n          readFunctions,\r\n          decodeStringFunction\r\n        )\r\n      }\r\n    }\r\n\r\n    return result as ToJson<T>\r\n  }\r\n\r\n  private write<Buf extends DataView | Buffer>(\r\n    buffer: Buf,\r\n    dataOut: ToJson<T>,\r\n    offsetPointer: { offset: number },\r\n    byteLength: number,\r\n    maxByteLength: number,\r\n    writeFunctions: typeof SET_FUNCTION | typeof SET_FUNCTION_BUF,\r\n    growBufferFunction: (buffer: Buf, newByteLength: number) => Buf,\r\n    encodeStringFunction: (buffer: Buf, byteOffset: number, string: string) => void\r\n  ): Buf {\r\n    writeFunctions[Field.UNSIGNED_INT_8](buffer as any, this.packetId, offsetPointer.offset)\r\n    offsetPointer.offset += 1\r\n\r\n    for (const [name, def] of this.entries) {\r\n      const data = dataOut[name]\r\n\r\n      if (Array.isArray(def)) {\r\n        // Could be both an array of just numbers or \"subpackets\"\r\n\r\n        const length = (data as any[]).length\r\n\r\n        // Check if it is a dynamically-sized array, if it is, the length of the array must be serialized in the buffer before its elements\r\n        // Explicitly check for undefined and not falsy values because it could be a statically-sized array of 0 elements.\r\n        const isDynamicArray = def[1] === undefined\r\n\r\n        if (isDynamicArray) {\r\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, length, offsetPointer.offset)\r\n          offsetPointer.offset += 1\r\n        }\r\n\r\n        if (length > 0) {\r\n          const itemType = def[0]\r\n\r\n          if (typeof itemType === 'object') {\r\n            // Array of \"subpackets\"\r\n\r\n            if (isDynamicArray) {\r\n              const neededBytesForElements = length * itemType.minimumByteLength\r\n\r\n              byteLength += neededBytesForElements\r\n              maxByteLength += neededBytesForElements\r\n\r\n              if (buffer.byteLength < maxByteLength) {\r\n                buffer = growBufferFunction(buffer, maxByteLength)\r\n              }\r\n            }\r\n\r\n            for (const object of data as unknown as ToJson<Definition>[]) {\r\n              // Array of \"subpackets\"\r\n              buffer = itemType.write(\r\n                buffer,\r\n                object,\r\n                offsetPointer,\r\n                byteLength,\r\n                maxByteLength,\r\n                writeFunctions,\r\n                growBufferFunction,\r\n                encodeStringFunction\r\n              )\r\n\r\n              byteLength = offsetPointer.offset\r\n              maxByteLength = buffer.byteLength\r\n            }\r\n          } else if (itemType === '') {\r\n            // Array of strings\r\n            for (let i = 0; i < length; ++i) {\r\n              const str = (data as unknown as string[])[i]\r\n              const strlen = str.length\r\n\r\n              writeFunctions[Field.UNSIGNED_INT_16](buffer as any, strlen, offsetPointer.offset)\r\n              offsetPointer.offset += 2\r\n\r\n              encodeStringFunction(buffer, offsetPointer.offset, str)\r\n              offsetPointer.offset += strlen\r\n            }\r\n          } else {\r\n            // Array of primitives (numbers)\r\n            const itemSize = BYTE_SIZE[itemType]\r\n\r\n            if (isDynamicArray) {\r\n              const neededBytesForElements = length * itemSize\r\n\r\n              byteLength += neededBytesForElements\r\n              maxByteLength += neededBytesForElements\r\n\r\n              if (buffer.byteLength < maxByteLength) {\r\n                buffer = growBufferFunction(buffer, maxByteLength)\r\n              }\r\n            }\r\n\r\n            // It seems like looping over each element is actually much faster than using TypedArrays bulk copy.\r\n            // TODO: properly benchmark with various array sizes to see if it's actually the case.\r\n            for (const number of data as number[]) {\r\n              writeFunctions[itemType](buffer as any, number, offsetPointer.offset)\r\n              offsetPointer.offset += itemSize\r\n            }\r\n          }\r\n        }\r\n      } else if (typeof def === 'number') {\r\n        // Single primitive (number)\r\n        writeFunctions[def](buffer as any, data as number, offsetPointer.offset)\r\n        offsetPointer.offset += BYTE_SIZE[def]\r\n      } else if (def === '') {\r\n        // String\r\n        const strlen = (data as string).length\r\n\r\n        writeFunctions[Field.UNSIGNED_INT_16](buffer as any, strlen, offsetPointer.offset)\r\n        offsetPointer.offset += 2\r\n\r\n        encodeStringFunction(buffer, offsetPointer.offset, data as string)\r\n        offsetPointer.offset += strlen\r\n      } else if ('flags' in def) {\r\n        // BitFlags\r\n        let flags = 0\r\n\r\n        for (let bit = 0; bit < def.flags.length; ++bit) {\r\n          if ((data as Record<string, boolean>)[def.flags[bit]]) {\r\n            flags |= 1 << bit\r\n          }\r\n        }\r\n\r\n        writeFunctions[Field.UNSIGNED_INT_8](buffer as any, flags, offsetPointer.offset)\r\n        offsetPointer.offset += 1\r\n      } else if ('optional' in def) {\r\n        if (data) {\r\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, 1, offsetPointer.offset)\r\n          offsetPointer.offset += 1\r\n\r\n          byteLength += def.optional.minimumByteLength\r\n          maxByteLength += def.optional.minimumByteLength\r\n\r\n          if (buffer.byteLength < maxByteLength) {\r\n            buffer = growBufferFunction(buffer, maxByteLength)\r\n          }\r\n\r\n          buffer = def.optional.write(\r\n            buffer,\r\n            data as ToJson<Definition>,\r\n            offsetPointer,\r\n            byteLength,\r\n            maxByteLength,\r\n            writeFunctions,\r\n            growBufferFunction,\r\n            encodeStringFunction\r\n          )\r\n\r\n          byteLength = offsetPointer.offset\r\n          maxByteLength = buffer.byteLength\r\n        } else {\r\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, 0, offsetPointer.offset)\r\n          offsetPointer.offset += 1\r\n        }\r\n      } else {\r\n        // Single \"subpacket\"\r\n        buffer = def.write(\r\n          buffer,\r\n          data as ToJson<Definition>,\r\n          offsetPointer,\r\n          byteLength,\r\n          maxByteLength,\r\n          writeFunctions,\r\n          growBufferFunction,\r\n          encodeStringFunction\r\n        )\r\n\r\n        byteLength = offsetPointer.offset\r\n        maxByteLength = buffer.byteLength\r\n      }\r\n    }\r\n\r\n    return buffer\r\n  }\r\n\r\n  private precalculateBufferLengthWithStrings(dataOut: ToJson<T>) {\r\n    let len = this.minimumByteLength\r\n\r\n    for (const field of this.stringPositions[0]) {\r\n      // String field\r\n      len += (dataOut[field] as string).length\r\n    }\r\n\r\n    for (const field of this.stringPositions[1]) {\r\n      // Array of strings field\r\n      for (const string of dataOut[field] as unknown as string[]) {\r\n        len += 2 + string.length\r\n      }\r\n    }\r\n\r\n    for (const field in this.stringPositions[2]) {\r\n      // Subpacket that has some string fields\r\n      len += this.stringPositions[2][field].precalculateBufferLengthWithStrings(\r\n        dataOut[field] as any\r\n      )\r\n    }\r\n\r\n    return len\r\n  }\r\n}\r\n\r\n/**\r\n * BinaryPacket definition: \\\r\n * Any packet can be defined through a \"schema\" object explaining its fields names and types.\r\n *\r\n * @example\r\n * // Imagine we have a game board where each cell is a square and is one unit big.\r\n * // A cell can be then defined by its X and Y coordinates.\r\n * // For simplicity, let's say there cannot be more than 256 cells, so we can use 8 bits for each coordinate.\r\n * const Cell = {\r\n *  x: Field.UNSIGNED_INT_8,\r\n *  y: Field.UNSIGNED_INT_8\r\n * }\r\n *\r\n * // When done with the cell definition we can create its BinaryPacket writer/reader.\r\n * // NOTE: each BinaryPacket needs an unique ID, for identification purposes and error checking.\r\n * const CellPacket = BinaryPacket.define(0, Cell)\r\n *\r\n * // Let's now make the definition of the whole game board.\r\n * // You can also specify arrays of both \"primitive\" fields and other BinaryPackets.\r\n * const Board = {\r\n *  numPlayers: Field.UNSIGNED_INT_8,\r\n *  cells: FieldArray(CellPacket)\r\n * }\r\n *\r\n * // When done with the board definition we can create its BinaryPacket writer/reader.\r\n * // NOTE: each BinaryPacket needs an unique ID, for identification purposes and error checking.\r\n * const BoardPacket = BinaryPacket.define(1, Board)\r\n *\r\n * // And use it.\r\n * const buffer = BoardPacket.writeNodeBuffer({\r\n *  numPlayers: 1,\r\n *  cells: [\r\n *    { x: 0, y: 0 },\r\n *    { x: 1, y: 1 }\r\n *  ]\r\n * })\r\n *\r\n * // sendTheBufferOver(buffer)\r\n * // ...\r\n * // const buffer = receiveTheBuffer()\r\n * const board = BoardPacket.readNodeBuffer(buffer)\r\n * // ...\r\n */\r\nexport type Definition = {\r\n  [fieldName: string]:\r\n    | MaybeArray<Field>\r\n    | MaybeArray<BinaryPacket<Definition>>\r\n    | MaybeArray<''>\r\n    | { flags: BitFlags }\r\n    | { optional: BinaryPacket<Definition> }\r\n}\r\n\r\ntype MaybeArray<T> = T | [itemType: T] | [itemType: T, length: number]\r\n\r\ntype BitFlagsToJson<FlagsArray extends BitFlags> = {\r\n  [key in FlagsArray[number]]: boolean\r\n}\r\n\r\n/**\r\n * Meta-type that converts a `Definition` schema to the type of the actual JavaScript object that will be written into a packet or read from. \\\r\n */\r\nexport type ToJson<T extends Definition> = {\r\n  [K in keyof T]: T[K] extends [infer Item]\r\n    ? Item extends BinaryPacket<infer BPDef>\r\n      ? ToJson<BPDef>[]\r\n      : Item extends ''\r\n        ? string[]\r\n        : number[]\r\n    : T[K] extends [infer Item, infer Length]\r\n      ? Item extends BinaryPacket<infer BPDef>\r\n        ? ToJson<BPDef>[] & { length: Length }\r\n        : Item extends ''\r\n          ? string[] & { length: Length }\r\n          : number[] & { length: Length }\r\n      : T[K] extends BinaryPacket<infer BPDef>\r\n        ? ToJson<BPDef>\r\n        : T[K] extends { flags: infer FlagsArray extends BitFlags }\r\n          ? BitFlagsToJson<FlagsArray>\r\n          : T[K] extends { optional: BinaryPacket<infer BPDef extends Definition> }\r\n            ? ToJson<BPDef> | undefined\r\n            : T[K] extends ''\r\n              ? string\r\n              : number\r\n}\r\n\r\n/**\r\n * In a JavaScript object, the order of its keys is not strictly defined: sort them by field name. \\\r\n * Thus, we cannot trust iterating over an object keys: we MUST iterate over its entries array. \\\r\n * This is important to make sure that whoever shares BinaryPacket definitions can correctly write/read packets independently of their JS engines.\r\n */\r\nfunction sortEntries(definition: Definition) {\r\n  return Object.entries(definition).sort(([fieldName1], [fieldName2]) =>\r\n    fieldName1.localeCompare(fieldName2)\r\n  )\r\n}\r\n\r\ntype Entries = ReturnType<typeof sortEntries>\r\n\r\ntype StringPositions = [\r\n  string[],\r\n  string[],\r\n  {\r\n    [field: string]: BinaryPacket<Definition>\r\n  }\r\n]\r\n\r\n/**\r\n * Helper function that \"inspects\" the entries of a BinaryPacket definition\r\n * and returns useful \"stats\" needed for writing and reading buffers.\r\n *\r\n * This function is ever called only once per BinaryPacket definition.\r\n */\r\nfunction inspectEntries(entries: Entries) {\r\n  // The PacketID is already 1 byte, that's why we aren't starting from 0.\r\n  let minimumByteLength = 1\r\n\r\n  const stringPositions: StringPositions = [[], [], {}]\r\n\r\n  for (const [name, type] of entries) {\r\n    if (Array.isArray(type)) {\r\n      if (type.length === 2) {\r\n        // Statically-sized array\r\n        const isString = type[0] === ''\r\n\r\n        const itemSize =\r\n          typeof type[0] === 'object'\r\n            ? type[0].minimumByteLength\r\n            : isString\r\n              ? 2\r\n              : BYTE_SIZE[type[0]]\r\n\r\n        minimumByteLength += type[1] * itemSize\r\n\r\n        if (isString) {\r\n          stringPositions[1].push(name)\r\n        }\r\n      } else {\r\n        // Dynamically-sized array\r\n        // Adding 1 byte to serialize the array length\r\n        minimumByteLength += 1\r\n\r\n        if (type[0] === '') {\r\n          stringPositions[1].push(name)\r\n        }\r\n      }\r\n    } else if (type instanceof BinaryPacket) {\r\n      minimumByteLength += type.minimumByteLength\r\n      stringPositions[2][name] = type\r\n    } else if (typeof type === 'object') {\r\n      // BitFlags & Optionals\r\n      // BitFlags are always 1 byte long, because they can hold up to 8 booleans\r\n      // Optionals minimum is 1 byte long, because it holds whether the subpacket is present or not\r\n      minimumByteLength += 1\r\n    } else if (type === '') {\r\n      // String\r\n      // Adding 2 to serialize the string length\r\n      minimumByteLength += 2\r\n      stringPositions[0].push(name)\r\n    } else {\r\n      minimumByteLength += BYTE_SIZE[type]\r\n    }\r\n  }\r\n\r\n  return { minimumByteLength, stringPositions }\r\n}\r\n\r\n//////////////////////////////////////////////\r\n// The logic here is practically over       //\r\n// Here below there are needed constants    //\r\n// that map a field-type to a functionality //\r\n//////////////////////////////////////////////\r\n\r\nconst BYTE_SIZE = Array(8) as number[]\r\n\r\nBYTE_SIZE[Field.UNSIGNED_INT_8] = 1\r\nBYTE_SIZE[Field.INT_8] = 1\r\n\r\nBYTE_SIZE[Field.UNSIGNED_INT_16] = 2\r\nBYTE_SIZE[Field.INT_16] = 2\r\n\r\nBYTE_SIZE[Field.UNSIGNED_INT_32] = 4\r\nBYTE_SIZE[Field.INT_32] = 4\r\nBYTE_SIZE[Field.FLOAT_32] = 4\r\n\r\nBYTE_SIZE[Field.FLOAT_64] = 8\r\n\r\nconst GET_FUNCTION = Array(8) as ((view: DataView, offset: number) => number)[]\r\n\r\nGET_FUNCTION[Field.UNSIGNED_INT_8] = (view, offset) => view.getUint8(offset)\r\nGET_FUNCTION[Field.INT_8] = (view, offset) => view.getInt8(offset)\r\nGET_FUNCTION[Field.UNSIGNED_INT_16] = (view, offset) => view.getUint16(offset)\r\nGET_FUNCTION[Field.INT_16] = (view, offset) => view.getInt16(offset)\r\nGET_FUNCTION[Field.UNSIGNED_INT_32] = (view, offset) => view.getUint32(offset)\r\nGET_FUNCTION[Field.INT_32] = (view, offset) => view.getInt32(offset)\r\nGET_FUNCTION[Field.FLOAT_32] = (view, offset) => view.getFloat32(offset)\r\nGET_FUNCTION[Field.FLOAT_64] = (view, offset) => view.getFloat64(offset)\r\n\r\nconst SET_FUNCTION = Array(8) as ((view: DataView, value: number, offset: number) => void)[]\r\n\r\nSET_FUNCTION[Field.UNSIGNED_INT_8] = (view, value, offset) => view.setUint8(offset, value)\r\nSET_FUNCTION[Field.INT_8] = (view, value, offset) => view.setInt8(offset, value)\r\nSET_FUNCTION[Field.UNSIGNED_INT_16] = (view, value, offset) => view.setUint16(offset, value)\r\nSET_FUNCTION[Field.INT_16] = (view, value, offset) => view.setInt16(offset, value)\r\nSET_FUNCTION[Field.UNSIGNED_INT_32] = (view, value, offset) => view.setUint32(offset, value)\r\nSET_FUNCTION[Field.INT_32] = (view, value, offset) => view.setInt32(offset, value)\r\nSET_FUNCTION[Field.FLOAT_32] = (view, value, offset) => view.setFloat32(offset, value)\r\nSET_FUNCTION[Field.FLOAT_64] = (view, value, offset) => view.setFloat64(offset, value)\r\n\r\nconst SET_FUNCTION_BUF = Array(8) as ((nodeBuffer: Buffer, value: number, offset: number) => void)[]\r\n\r\nif (hasNodeBuffers) {\r\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_8] = (view, value, offset) => view.writeUint8(value, offset)\r\n  SET_FUNCTION_BUF[Field.INT_8] = (view, value, offset) => view.writeInt8(value, offset)\r\n\r\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_16] = (view, value, offset) =>\r\n    view.writeUint16BE(value, offset)\r\n  SET_FUNCTION_BUF[Field.INT_16] = (view, value, offset) => view.writeInt16BE(value, offset)\r\n\r\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_32] = (view, value, offset) =>\r\n    view.writeUint32BE(value, offset)\r\n  SET_FUNCTION_BUF[Field.INT_32] = (view, value, offset) => view.writeInt32BE(value, offset)\r\n  SET_FUNCTION_BUF[Field.FLOAT_32] = (view, value, offset) => view.writeFloatBE(value, offset)\r\n\r\n  SET_FUNCTION_BUF[Field.FLOAT_64] = (view, value, offset) => view.writeDoubleBE(value, offset)\r\n}\r\n\r\nconst GET_FUNCTION_BUF = Array(8) as ((nodeBuffer: Buffer, offset: number) => number)[]\r\n\r\nif (hasNodeBuffers) {\r\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_8] = (view, offset) => view.readUint8(offset)\r\n  GET_FUNCTION_BUF[Field.INT_8] = (view, offset) => view.readInt8(offset)\r\n\r\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_16] = (view, offset) => view.readUint16BE(offset)\r\n  GET_FUNCTION_BUF[Field.INT_16] = (view, offset) => view.readInt16BE(offset)\r\n\r\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_32] = (view, offset) => view.readUint32BE(offset)\r\n  GET_FUNCTION_BUF[Field.INT_32] = (view, offset) => view.readInt32BE(offset)\r\n  GET_FUNCTION_BUF[Field.FLOAT_32] = (view, offset) => view.readFloatBE(offset)\r\n\r\n  GET_FUNCTION_BUF[Field.FLOAT_64] = (view, offset) => view.readDoubleBE(offset)\r\n}\r\n"],"mappings":"AAMO,IAAMA,EAAiB,OAAO,QAAW,WAEzC,SAASC,EAAaC,EAAoBC,EAAuB,CACtE,IAAMC,EAAgB,IAAI,YAAYD,CAAa,EAC7CE,EAAe,KAAK,IAAIH,EAAS,WAAYE,EAAc,UAAU,EAGvEE,EAAS,KAAK,MAAMD,EAAe,CAAC,EACxC,IAAI,aAAaD,EAAe,EAAGE,CAAM,EAAE,IAAI,IAAI,aAAaJ,EAAS,OAAQ,EAAGI,CAAM,CAAC,EAG3F,IAAMC,EAASD,EAAS,EACxB,OAAAA,EAASD,EAAeE,EACxB,IAAI,WAAWH,EAAeG,EAAQD,CAAM,EAAE,IAAI,IAAI,WAAWJ,EAAS,OAAQK,EAAQD,CAAM,CAAC,EAE1F,IAAI,SAASF,CAAa,CACnC,CAEO,SAASI,EAAeC,EAAgBN,EAAuB,CACpE,IAAMO,EAAY,OAAO,YAAYP,CAAa,EAClD,OAAAM,EAAO,KAAKC,CAAS,EACdA,CACT,CAEA,IAAMC,EAAc,IAAI,YAClBC,EAAc,IAAI,YAEjB,SAASC,EAAyBX,EAAoBY,EAAoBC,EAAgB,CAC/F,IAAMC,EAASD,EAAO,OAChBE,EAAW,IAAI,WAAWf,EAAS,OAAQA,EAAS,WAAaY,EAAYE,CAAM,EAErFA,GAAU,GACZE,EAAkBD,EAAU,EAAGF,EAAQC,CAAM,EAE7CL,EAAY,WAAWI,EAAQE,CAAQ,CAE3C,CAEO,SAASE,EAA2BV,EAAgBK,EAAoBC,EAAgB,CAC7F,IAAMC,EAASD,EAAO,OAElBC,GAAU,GACZE,EAAkBT,EAAQK,EAAYC,EAAQC,CAAM,EAEpDP,EAAO,UAAUM,EAAQD,EAAYE,CAAM,CAE/C,CAEA,SAASE,EAAkBT,EAAoBK,EAAoBC,EAAgBC,EAAgB,CACjG,QAASI,EAAI,EAAGA,EAAIJ,EAAQ,EAAEI,EAC5BX,EAAOK,EAAaM,CAAC,EAAIL,EAAO,WAAWK,CAAC,EAAI,GAEpD,CAEO,SAASC,EAA2BZ,EAAgBK,EAAoBE,EAAgB,CAC7F,OAAOP,EAAO,SAASK,EAAYA,EAAaE,CAAM,EAAE,SAAS,MAAM,CACzE,CAEO,SAASM,EAAyBpB,EAAoBY,EAAoBE,EAAgB,CAC/F,OAAOJ,EAAY,OAAO,IAAI,SAASV,EAAS,OAAQA,EAAS,WAAaY,EAAYE,CAAM,CAAC,CACnG,CCvDO,IAAWO,OAKhBA,IAAA,eAAiB,GAAjB,iBAMAA,IAAA,qCAMAA,IAAA,qCAMAA,IAAA,iBAMAA,IAAA,mBAMAA,IAAA,mBAKAA,IAAA,uBAKAA,IAAA,uBA7CgBA,OAAA,IAwDX,SAASC,EACdC,EACe,CACf,MAAO,CAACA,CAAI,CACd,CASO,SAASC,EAGdD,EAASE,EAA+C,CACxD,GAAIA,EAAS,GAAK,CAAC,OAAO,SAASA,CAAM,EACvC,MAAM,IAAI,WAAW,oDAAoD,EAG3E,MAAO,CAACF,EAAME,CAAM,CACtB,CAaO,SAASC,EAAiDC,EAAmB,CAClF,GAAIA,EAAM,OAAS,EACjB,MAAM,IAAI,MACR,yFAAyFA,EAAM,KAAK,IAAI,CAAC,EAC3G,EAGF,MAAO,CAAE,MAAAA,CAAM,CACjB,CAQO,SAASC,GAAc,CAC5B,MAAO,EACT,CAMO,SAASC,EAAkDC,EAAW,CAC3E,MAAO,CAAE,SAAUA,CAAO,CAC5B,CAQO,IAAMC,EAAN,MAAMC,CAAmC,CAiOtC,YACWC,EACjBC,EACA,CAFiB,cAAAD,EAGjB,KAAK,QAAUC,EAAaC,EAAYD,CAAU,EAAI,CAAC,EACvD,IAAME,EAAaC,EAAe,KAAK,OAAO,EAC9C,KAAK,kBAAoBD,EAAW,kBACpC,KAAK,gBAAkBA,EAAW,eACpC,CAnOA,OAAO,OAA6BH,EAAkBC,EAAgB,CACpE,GAAID,EAAW,GAAK,CAAC,OAAO,SAASA,CAAQ,EAC3C,MAAM,IAAI,WAAW,uCAAuC,EAG9D,GAAIA,EAAW,IACb,MAAM,IAAI,WACR,6GACF,EAGF,OAAO,IAAID,EAAaC,EAAUC,CAAU,CAC9C,CAOA,OAAO,uBAAuBI,EAAgBC,EAAa,EAAG,CAC5D,OAAOD,EAAO,UAAUC,CAAU,CACpC,CAOA,OAAO,qBAAqBC,EAAoBD,EAAa,EAAG,CAC9D,OAAOC,EAAS,SAASD,CAAU,CACrC,CAUA,OAAO,wBAAwBE,EAA8BF,EAAoB,CAC/E,OAAO,IAAI,WAAWE,EAAaF,EAAY,CAAC,EAAE,CAAC,CACrD,CAQA,OAAO,gBAAgBD,KAAmBI,EAAqB,CAC7D,OAAOV,EAAa,MAAMM,EAAQK,EAAkBC,EAA4BF,CAAQ,CAC1F,CAQA,OAAO,cAAcF,KAAuBE,EAAqB,CAC/D,OAAOV,EAAa,MAAMQ,EAAUK,EAAcC,EAA0BJ,CAAQ,CACtF,CAUA,OAAO,iBACLD,EACAF,EACAQ,KACGL,EACH,CACA,OAAOV,EAAa,MAClB,IAAI,SAASS,EAAaF,EAAYQ,CAAU,EAChDF,EACAC,EACAJ,CACF,CACF,CAWA,eACEM,EACAC,EAAgB,CAAE,OAAQ,CAAE,EAC5BF,EAAaC,EAAO,WACT,CACX,OAAO,KAAK,KACVA,EACAC,EACAF,EACAJ,EACAC,CACF,CACF,CAQA,aACEI,EACAC,EAAgB,CAAE,OAAQ,CAAE,EAC5BF,EAAaC,EAAO,WACT,CACX,OAAO,KAAK,KAAKA,EAAQC,EAAeF,EAAYF,EAAcC,CAAwB,CAC5F,CAaA,gBAAgBE,EAAyBT,EAAoBQ,EAAoB,CAC/E,OAAO,KAAK,KACVG,EACI,OAAO,KAAKF,EAAQT,EAAYQ,CAAU,EACzC,IAAI,SAASC,EAAQT,EAAYQ,CAAU,EAChD,CAAE,OAAQ,CAAE,EACZA,EACAG,EAAiBP,EAAmBE,EACpCK,EAAiBN,EAA8BE,CACjD,CACF,CAQA,gBAAgBK,EAAoB,CAClC,IAAMJ,EAAa,KAAK,oCAAoCI,CAAO,EAC7Db,EAAS,OAAO,YAAYS,CAAU,EAE5C,OAAO,KAAK,MACVT,EACAa,EACA,CAAE,OAAQ,CAAE,EACZJ,EACAA,EACAK,EACAC,EACAC,CACF,CACF,CAKA,cAAcH,EAAoB,CAChC,IAAMJ,EAAa,KAAK,oCAAoCI,CAAO,EAC7DX,EAAW,IAAI,SAAS,IAAI,YAAYO,CAAU,CAAC,EAEzD,OAAO,KAAK,MACVP,EACAW,EACA,CAAE,OAAQ,CAAE,EACZJ,EACAA,EACAQ,EACAC,EACAC,CACF,CACF,CAYA,iBAAiBN,EAAoB,CACnC,IAAMO,EAAMR,EAAiB,KAAK,gBAAgBC,CAAO,EAAI,KAAK,cAAcA,CAAO,EACvF,MAAO,CAAE,OAAQO,EAAI,OAAQ,WAAYA,EAAI,WAAY,WAAYA,EAAI,UAAW,CACtF,CASA,QAAQC,EAA+C,CACrD,MAAO,CAAC,KAAMA,CAAO,CACvB,CAIiB,QACR,gBACA,kBAYT,OAAe,MACbX,EACAY,EACAC,EACAnB,EACA,CACA,OAAW,CAACoB,EAAQH,CAAO,IAAKjB,EAC9B,GAAIoB,EAAO,WAAaF,EAAc,CAAoB,EAAEZ,EAAe,CAAC,EAC1E,OAAOW,EACLG,EAAO,KAAKd,EAAQ,CAAE,OAAQ,CAAE,EAAGA,EAAO,WAAYY,EAAeC,CAAoB,CAC3F,CAGN,CAEQ,KACNb,EACAC,EACAF,EACAa,EACAC,EACW,CACX,GAAId,EAAaE,EAAc,OAAS,KAAK,kBAC3C,MAAM,IAAI,MACR,uDAAuD,KAAK,QAAQ,cAAcA,EAAc,MAAM,EACxG,EAGF,GACEW,EAAc,CAAoB,EAAEZ,EAAeC,EAAc,MAAM,IAAM,KAAK,SAElF,MAAM,IAAI,MACR,kBAAkBA,EAAc,MAAM,4BAA4B,KAAK,QAAQ,EACjF,EAGFA,EAAc,QAAU,EACxB,IAAMc,EAAc,CAAC,EAErB,OAAW,CAACC,EAAMC,CAAG,IAAK,KAAK,QAC7B,GAAI,MAAM,QAAQA,CAAG,EAAG,CACtB,IAAMxC,EAEJwC,EAAI,CAAC,GAAKL,EAAc,CAAoB,EAAEZ,EAAeC,EAAc,QAAQ,EAE/EiB,EAAQ,MAAMzC,CAAM,EAEpB0C,EAAWF,EAAI,CAAC,EAEtB,GAAI,OAAOE,GAAa,SAEtB,QAASC,EAAI,EAAGA,EAAI3C,EAAQ,EAAE2C,EAC5BF,EAAME,CAAC,EAAID,EAAS,KAClBnB,EACAC,EACAF,EACAa,EACAC,CACF,UAEOM,IAAa,GAEtB,QAASC,EAAI,EAAGA,EAAI3C,EAAQ,EAAE2C,EAAG,CAC/B,IAAMC,EAAST,EAAc,CAAqB,EAAEZ,EAAeC,EAAc,MAAM,EACvFA,EAAc,QAAU,EAExBiB,EAAME,CAAC,EAAIP,EAAqBb,EAAQC,EAAc,OAAQoB,CAAM,EACpEpB,EAAc,QAAUoB,CAC1B,KACK,CAEL,IAAMC,EAAWC,EAAUJ,CAAQ,EAInC,QAASC,EAAI,EAAGA,EAAI3C,EAAQ,EAAE2C,EAC5BF,EAAME,CAAC,EAAIR,EAAcO,CAAQ,EAAEnB,EAAeC,EAAc,MAAM,EACtEA,EAAc,QAAUqB,CAE5B,CAGAP,EAAOC,CAAI,EAAIE,CACjB,SAAW,OAAOD,GAAQ,SAGxBF,EAAOC,CAAI,EAAIJ,EAAcK,CAAG,EAAEjB,EAAeC,EAAc,MAAM,EACrEA,EAAc,QAAUsB,EAAUN,CAAG,UAC5BA,IAAQ,GAAI,CACrB,IAAMI,EAAST,EAAc,CAAqB,EAAEZ,EAAeC,EAAc,MAAM,EACvFA,EAAc,QAAU,EAGxBc,EAAOC,CAAI,EAAIH,EAAqBb,EAAQC,EAAc,OAAQoB,CAAM,EACxEpB,EAAc,QAAUoB,CAC1B,SAAW,UAAWJ,EAAK,CAEzB,IAAMtC,EAAQiC,EAAc,CAAoB,EAAEZ,EAAeC,EAAc,MAAM,EACrFA,EAAc,QAAU,EAGxBc,EAAOC,CAAI,EAAI,CAAC,EAEhB,QAASQ,EAAM,EAAGA,EAAMP,EAAI,MAAM,OAAQ,EAAEO,EAE1CT,EAAOC,CAAI,EAAEC,EAAI,MAAMO,CAAG,CAAC,EAAI,CAAC,EAAE7C,EAAS,GAAK6C,EAEpD,SAAW,aAAcP,EAAK,CAE5B,IAAMQ,EACJb,EAAc,CAAoB,EAAEZ,EAAeC,EAAc,MAAM,IAAM,EAE/EA,EAAc,QAAU,EAEpBwB,IAEFV,EAAOC,CAAI,EAAIC,EAAI,SAAS,KAC1BjB,EACAC,EACAF,EACAa,EACAC,CACF,EAEJ,MAGEE,EAAOC,CAAI,EAAIC,EAAI,KACjBjB,EACAC,EACAF,EACAa,EACAC,CACF,EAIJ,OAAOE,CACT,CAEQ,MACNzB,EACAa,EACAF,EACAF,EACA2B,EACAC,EACAC,EACAC,EACK,CACLF,EAAe,CAAoB,EAAErC,EAAe,KAAK,SAAUW,EAAc,MAAM,EACvFA,EAAc,QAAU,EAExB,OAAW,CAACe,EAAMC,CAAG,IAAK,KAAK,QAAS,CACtC,IAAMa,EAAO3B,EAAQa,CAAI,EAEzB,GAAI,MAAM,QAAQC,CAAG,EAAG,CAGtB,IAAMxC,EAAUqD,EAAe,OAIzBC,EAAiBd,EAAI,CAAC,IAAM,OAOlC,GALIc,IACFJ,EAAe,CAAoB,EAAErC,EAAeb,EAAQwB,EAAc,MAAM,EAChFA,EAAc,QAAU,GAGtBxB,EAAS,EAAG,CACd,IAAM0C,EAAWF,EAAI,CAAC,EAEtB,GAAI,OAAOE,GAAa,SAAU,CAGhC,GAAIY,EAAgB,CAClB,IAAMC,EAAyBvD,EAAS0C,EAAS,kBAEjDpB,GAAciC,EACdN,GAAiBM,EAEb1C,EAAO,WAAaoC,IACtBpC,EAASsC,EAAmBtC,EAAQoC,CAAa,EAErD,CAEA,QAAWO,KAAUH,EAEnBxC,EAAS6B,EAAS,MAChB7B,EACA2C,EACAhC,EACAF,EACA2B,EACAC,EACAC,EACAC,CACF,EAEA9B,EAAaE,EAAc,OAC3ByB,EAAgBpC,EAAO,UAE3B,SAAW6B,IAAa,GAEtB,QAASC,EAAI,EAAGA,EAAI3C,EAAQ,EAAE2C,EAAG,CAC/B,IAAMc,EAAOJ,EAA6BV,CAAC,EACrCC,EAASa,EAAI,OAEnBP,EAAe,CAAqB,EAAErC,EAAe+B,EAAQpB,EAAc,MAAM,EACjFA,EAAc,QAAU,EAExB4B,EAAqBvC,EAAQW,EAAc,OAAQiC,CAAG,EACtDjC,EAAc,QAAUoB,CAC1B,KACK,CAEL,IAAMC,EAAWC,EAAUJ,CAAQ,EAEnC,GAAIY,EAAgB,CAClB,IAAMC,EAAyBvD,EAAS6C,EAExCvB,GAAciC,EACdN,GAAiBM,EAEb1C,EAAO,WAAaoC,IACtBpC,EAASsC,EAAmBtC,EAAQoC,CAAa,EAErD,CAIA,QAAWS,KAAUL,EACnBH,EAAeR,CAAQ,EAAE7B,EAAe6C,EAAQlC,EAAc,MAAM,EACpEA,EAAc,QAAUqB,CAE5B,CACF,CACF,SAAW,OAAOL,GAAQ,SAExBU,EAAeV,CAAG,EAAE3B,EAAewC,EAAgB7B,EAAc,MAAM,EACvEA,EAAc,QAAUsB,EAAUN,CAAG,UAC5BA,IAAQ,GAAI,CAErB,IAAMI,EAAUS,EAAgB,OAEhCH,EAAe,CAAqB,EAAErC,EAAe+B,EAAQpB,EAAc,MAAM,EACjFA,EAAc,QAAU,EAExB4B,EAAqBvC,EAAQW,EAAc,OAAQ6B,CAAc,EACjE7B,EAAc,QAAUoB,CAC1B,SAAW,UAAWJ,EAAK,CAEzB,IAAItC,EAAQ,EAEZ,QAAS6C,EAAM,EAAGA,EAAMP,EAAI,MAAM,OAAQ,EAAEO,EACrCM,EAAiCb,EAAI,MAAMO,CAAG,CAAC,IAClD7C,GAAS,GAAK6C,GAIlBG,EAAe,CAAoB,EAAErC,EAAeX,EAAOsB,EAAc,MAAM,EAC/EA,EAAc,QAAU,CAC1B,KAAW,aAAcgB,EACnBa,GACFH,EAAe,CAAoB,EAAErC,EAAe,EAAGW,EAAc,MAAM,EAC3EA,EAAc,QAAU,EAExBF,GAAckB,EAAI,SAAS,kBAC3BS,GAAiBT,EAAI,SAAS,kBAE1B3B,EAAO,WAAaoC,IACtBpC,EAASsC,EAAmBtC,EAAQoC,CAAa,GAGnDpC,EAAS2B,EAAI,SAAS,MACpB3B,EACAwC,EACA7B,EACAF,EACA2B,EACAC,EACAC,EACAC,CACF,EAEA9B,EAAaE,EAAc,OAC3ByB,EAAgBpC,EAAO,aAEvBqC,EAAe,CAAoB,EAAErC,EAAe,EAAGW,EAAc,MAAM,EAC3EA,EAAc,QAAU,IAI1BX,EAAS2B,EAAI,MACX3B,EACAwC,EACA7B,EACAF,EACA2B,EACAC,EACAC,EACAC,CACF,EAEA9B,EAAaE,EAAc,OAC3ByB,EAAgBpC,EAAO,WAE3B,CAEA,OAAOA,CACT,CAEQ,oCAAoCa,EAAoB,CAC9D,IAAIiC,EAAM,KAAK,kBAEf,QAAWC,KAAS,KAAK,gBAAgB,CAAC,EAExCD,GAAQjC,EAAQkC,CAAK,EAAa,OAGpC,QAAWA,KAAS,KAAK,gBAAgB,CAAC,EAExC,QAAWC,KAAUnC,EAAQkC,CAAK,EAChCD,GAAO,EAAIE,EAAO,OAItB,QAAWD,KAAS,KAAK,gBAAgB,CAAC,EAExCD,GAAO,KAAK,gBAAgB,CAAC,EAAEC,CAAK,EAAE,oCACpClC,EAAQkC,CAAK,CACf,EAGF,OAAOD,CACT,CACF,EA4FA,SAASjD,EAAYD,EAAwB,CAC3C,OAAO,OAAO,QAAQA,CAAU,EAAE,KAAK,CAAC,CAACqD,CAAU,EAAG,CAACC,CAAU,IAC/DD,EAAW,cAAcC,CAAU,CACrC,CACF,CAkBA,SAASnD,EAAeoD,EAAkB,CAExC,IAAIC,EAAoB,EAElBC,EAAmC,CAAC,CAAC,EAAG,CAAC,EAAG,CAAC,CAAC,EAEpD,OAAW,CAAC3B,EAAM4B,CAAI,IAAKH,EACzB,GAAI,MAAM,QAAQG,CAAI,EACpB,GAAIA,EAAK,SAAW,EAAG,CAErB,IAAMC,EAAWD,EAAK,CAAC,IAAM,GAEvBtB,EACJ,OAAOsB,EAAK,CAAC,GAAM,SACfA,EAAK,CAAC,EAAE,kBACRC,EACE,EACAtB,EAAUqB,EAAK,CAAC,CAAC,EAEzBF,GAAqBE,EAAK,CAAC,EAAItB,EAE3BuB,GACFF,EAAgB,CAAC,EAAE,KAAK3B,CAAI,CAEhC,MAGE0B,GAAqB,EAEjBE,EAAK,CAAC,IAAM,IACdD,EAAgB,CAAC,EAAE,KAAK3B,CAAI,OAGvB4B,aAAgB7D,GACzB2D,GAAqBE,EAAK,kBAC1BD,EAAgB,CAAC,EAAE3B,CAAI,EAAI4B,GAClB,OAAOA,GAAS,SAIzBF,GAAqB,EACZE,IAAS,IAGlBF,GAAqB,EACrBC,EAAgB,CAAC,EAAE,KAAK3B,CAAI,GAE5B0B,GAAqBnB,EAAUqB,CAAI,EAIvC,MAAO,CAAE,kBAAAF,EAAmB,gBAAAC,CAAgB,CAC9C,CAQA,IAAMpB,EAAY,MAAM,CAAC,EAEzBA,EAAU,CAAoB,EAAI,EAClCA,EAAU,CAAW,EAAI,EAEzBA,EAAU,CAAqB,EAAI,EACnCA,EAAU,CAAY,EAAI,EAE1BA,EAAU,CAAqB,EAAI,EACnCA,EAAU,CAAY,EAAI,EAC1BA,EAAU,CAAc,EAAI,EAE5BA,EAAU,CAAc,EAAI,EAE5B,IAAM1B,EAAe,MAAM,CAAC,EAE5BA,EAAa,CAAoB,EAAI,CAACiD,EAAMC,IAAWD,EAAK,SAASC,CAAM,EAC3ElD,EAAa,CAAW,EAAI,CAACiD,EAAMC,IAAWD,EAAK,QAAQC,CAAM,EACjElD,EAAa,CAAqB,EAAI,CAACiD,EAAMC,IAAWD,EAAK,UAAUC,CAAM,EAC7ElD,EAAa,CAAY,EAAI,CAACiD,EAAMC,IAAWD,EAAK,SAASC,CAAM,EACnElD,EAAa,CAAqB,EAAI,CAACiD,EAAMC,IAAWD,EAAK,UAAUC,CAAM,EAC7ElD,EAAa,CAAY,EAAI,CAACiD,EAAMC,IAAWD,EAAK,SAASC,CAAM,EACnElD,EAAa,CAAc,EAAI,CAACiD,EAAMC,IAAWD,EAAK,WAAWC,CAAM,EACvElD,EAAa,CAAc,EAAI,CAACiD,EAAMC,IAAWD,EAAK,WAAWC,CAAM,EAEvE,IAAMxC,EAAe,MAAM,CAAC,EAE5BA,EAAa,CAAoB,EAAI,CAACuC,EAAME,EAAOD,IAAWD,EAAK,SAASC,EAAQC,CAAK,EACzFzC,EAAa,CAAW,EAAI,CAACuC,EAAME,EAAOD,IAAWD,EAAK,QAAQC,EAAQC,CAAK,EAC/EzC,EAAa,CAAqB,EAAI,CAACuC,EAAME,EAAOD,IAAWD,EAAK,UAAUC,EAAQC,CAAK,EAC3FzC,EAAa,CAAY,EAAI,CAACuC,EAAME,EAAOD,IAAWD,EAAK,SAASC,EAAQC,CAAK,EACjFzC,EAAa,CAAqB,EAAI,CAACuC,EAAME,EAAOD,IAAWD,EAAK,UAAUC,EAAQC,CAAK,EAC3FzC,EAAa,CAAY,EAAI,CAACuC,EAAME,EAAOD,IAAWD,EAAK,SAASC,EAAQC,CAAK,EACjFzC,EAAa,CAAc,EAAI,CAACuC,EAAME,EAAOD,IAAWD,EAAK,WAAWC,EAAQC,CAAK,EACrFzC,EAAa,CAAc,EAAI,CAACuC,EAAME,EAAOD,IAAWD,EAAK,WAAWC,EAAQC,CAAK,EAErF,IAAM5C,EAAmB,MAAM,CAAC,EAE5BF,IACFE,EAAiB,CAAoB,EAAI,CAAC0C,EAAME,EAAOD,IAAWD,EAAK,WAAWE,EAAOD,CAAM,EAC/F3C,EAAiB,CAAW,EAAI,CAAC0C,EAAME,EAAOD,IAAWD,EAAK,UAAUE,EAAOD,CAAM,EAErF3C,EAAiB,CAAqB,EAAI,CAAC0C,EAAME,EAAOD,IACtDD,EAAK,cAAcE,EAAOD,CAAM,EAClC3C,EAAiB,CAAY,EAAI,CAAC0C,EAAME,EAAOD,IAAWD,EAAK,aAAaE,EAAOD,CAAM,EAEzF3C,EAAiB,CAAqB,EAAI,CAAC0C,EAAME,EAAOD,IACtDD,EAAK,cAAcE,EAAOD,CAAM,EAClC3C,EAAiB,CAAY,EAAI,CAAC0C,EAAME,EAAOD,IAAWD,EAAK,aAAaE,EAAOD,CAAM,EACzF3C,EAAiB,CAAc,EAAI,CAAC0C,EAAME,EAAOD,IAAWD,EAAK,aAAaE,EAAOD,CAAM,EAE3F3C,EAAiB,CAAc,EAAI,CAAC0C,EAAME,EAAOD,IAAWD,EAAK,cAAcE,EAAOD,CAAM,GAG9F,IAAMpD,EAAmB,MAAM,CAAC,EAE5BO,IACFP,EAAiB,CAAoB,EAAI,CAACmD,EAAMC,IAAWD,EAAK,UAAUC,CAAM,EAChFpD,EAAiB,CAAW,EAAI,CAACmD,EAAMC,IAAWD,EAAK,SAASC,CAAM,EAEtEpD,EAAiB,CAAqB,EAAI,CAACmD,EAAMC,IAAWD,EAAK,aAAaC,CAAM,EACpFpD,EAAiB,CAAY,EAAI,CAACmD,EAAMC,IAAWD,EAAK,YAAYC,CAAM,EAE1EpD,EAAiB,CAAqB,EAAI,CAACmD,EAAMC,IAAWD,EAAK,aAAaC,CAAM,EACpFpD,EAAiB,CAAY,EAAI,CAACmD,EAAMC,IAAWD,EAAK,YAAYC,CAAM,EAC1EpD,EAAiB,CAAc,EAAI,CAACmD,EAAMC,IAAWD,EAAK,YAAYC,CAAM,EAE5EpD,EAAiB,CAAc,EAAI,CAACmD,EAAMC,IAAWD,EAAK,aAAaC,CAAM","names":["hasNodeBuffers","growDataView","dataview","newByteLength","resizedBuffer","amountToCopy","length","offset","growNodeBuffer","buffer","newBuffer","textEncoder","textDecoder","encodeStringIntoDataView","byteOffset","string","strlen","u8Buffer","encodeSmallString","encodeStringIntoNodeBuffer","i","decodeStringFromNodeBuffer","decodeStringFromDataView","Field","FieldArray","item","FieldFixedArray","length","FieldBitFlags","flags","FieldString","FieldOptional","packet","BinaryPacket","_BinaryPacket","packetId","definition","sortEntries","inspection","inspectEntries","buffer","byteOffset","dataview","arraybuffer","visitors","GET_FUNCTION_BUF","decodeStringFromNodeBuffer","GET_FUNCTION","decodeStringFromDataView","byteLength","dataIn","offsetPointer","hasNodeBuffers","dataOut","SET_FUNCTION_BUF","growNodeBuffer","encodeStringIntoNodeBuffer","SET_FUNCTION","growDataView","encodeStringIntoDataView","buf","onVisit","readFunctions","decodeStringFunction","Packet","result","name","def","array","itemType","i","strlen","itemSize","BYTE_SIZE","bit","hasSubPacket","maxByteLength","writeFunctions","growBufferFunction","encodeStringFunction","data","isDynamicArray","neededBytesForElements","object","str","number","len","field","string","fieldName1","fieldName2","entries","minimumByteLength","stringPositions","type","isString","view","offset","value"]}
+{"version":3,"sources":["../src/buffers.ts","../src/index.ts"],"sourcesContent":["/**\r\n * Exclusively matches objects of type `ArrayBuffer` and no other types that inherit from it. \\\r\n * This is needed because the `DataView` constructor explicitly requires a \"true\" ArrayBuffer, or else it throws.\r\n */\r\nexport type TrueArrayBuffer = ArrayBuffer & { buffer?: undefined }\r\n\r\nexport const hasNodeBuffers = typeof Buffer === 'function'\r\n\r\nexport function growDataView(dataview: DataView, newByteLength: number) {\r\n  const resizedBuffer = new ArrayBuffer(newByteLength)\r\n  const amountToCopy = Math.min(dataview.byteLength, resizedBuffer.byteLength)\r\n\r\n  // Treat the buffer as if it was a Float64Array so we can copy 8 bytes at a time, to finish faster\r\n  let length = Math.trunc(amountToCopy / 8)\r\n  new Float64Array(resizedBuffer, 0, length).set(new Float64Array(dataview.buffer, 0, length))\r\n\r\n  // Copy the remaining up to 7 bytes\r\n  const offset = length * 8\r\n  length = amountToCopy - offset\r\n  new Uint8Array(resizedBuffer, offset, length).set(new Uint8Array(dataview.buffer, offset, length))\r\n\r\n  return new DataView(resizedBuffer)\r\n}\r\n\r\nexport function growNodeBuffer(buffer: Buffer, newByteLength: number) {\r\n  const newBuffer = Buffer.allocUnsafe(newByteLength)\r\n  buffer.copy(newBuffer)\r\n  return newBuffer\r\n}\r\n\r\nconst textEncoder = new TextEncoder()\r\nconst textDecoder = new TextDecoder()\r\n\r\nexport function encodeStringIntoDataView(dataview: DataView, byteOffset: number, string: string) {\r\n  const strlen = string.length\r\n  const u8Buffer = new Uint8Array(dataview.buffer, dataview.byteOffset + byteOffset, strlen)\r\n\r\n  if (strlen <= 64) {\r\n    encodeSmallString(u8Buffer, 0, string, strlen)\r\n  } else {\r\n    textEncoder.encodeInto(string, u8Buffer)\r\n  }\r\n}\r\n\r\nexport function encodeStringIntoNodeBuffer(buffer: Buffer, byteOffset: number, string: string) {\r\n  const strlen = string.length\r\n\r\n  if (strlen <= 64) {\r\n    encodeSmallString(buffer, byteOffset, string, strlen)\r\n  } else {\r\n    buffer.utf8Write(string, byteOffset, strlen)\r\n  }\r\n}\r\n\r\nfunction encodeSmallString(buffer: Uint8Array, byteOffset: number, string: string, strlen: number) {\r\n  for (let i = 0; i < strlen; ++i) {\r\n    buffer[byteOffset + i] = string.charCodeAt(i) & 0xff\r\n  }\r\n}\r\n\r\nexport function decodeStringFromNodeBuffer(buffer: Buffer, byteOffset: number, strlen: number) {\r\n  return buffer.subarray(byteOffset, byteOffset + strlen).toString('utf8')\r\n}\r\n\r\nexport function decodeStringFromDataView(dataview: DataView, byteOffset: number, strlen: number) {\r\n  return textDecoder.decode(new DataView(dataview.buffer, dataview.byteOffset + byteOffset, strlen))\r\n}\r\n\r\ndeclare global {\r\n  interface Buffer {\r\n    /**\r\n     * Node buffer's internals function. \\\r\n     * For some reason it is not exposed through TypeScript. \\\r\n     * Fastest way to write utf8 strings into buffers.\r\n     */\r\n    utf8Write(string: string, byteOffset?: number, byteLength?: number): number\r\n  }\r\n}\r\n","import {\n  decodeStringFromDataView,\n  decodeStringFromNodeBuffer,\n  encodeStringIntoDataView,\n  encodeStringIntoNodeBuffer,\n  growDataView,\n  growNodeBuffer,\n  hasNodeBuffers,\n  type TrueArrayBuffer\n} from './buffers'\n\nexport const enum Field {\n  /**\n   * Defines a 1 byte (8 bits) unsigned integer field. \\\n   * (Range: 0 - 255)\n   */\n  UNSIGNED_INT_8 = 0,\n\n  /**\n   * Defines a 2 bytes (16 bits) unsigned integer field. \\\n   * (Range: 0 - 65535)\n   */\n  UNSIGNED_INT_16,\n\n  /**\n   * Defines a 4 bytes (32 bits) unsigned integer field. \\\n   * (Range: 0 - 4294967295)\n   */\n  UNSIGNED_INT_32,\n\n  /**\n   * Defines a 1 byte (8 bits) signed integer field. \\\n   * (Range: -128 - 127)\n   */\n  INT_8,\n\n  /**\n   * Defines a 2 bytes (16 bits) signed integer field. \\\n   * (Range: -32768 - 32767)\n   */\n  INT_16,\n\n  /**\n   * Defines a 4 bytes (32 bits) signed integer field. \\\n   * (Range: -2147483648 - 2147483647)\n   */\n  INT_32,\n\n  /**\n   * Defines a 4 bytes (32 bits) floating-point field. \\\n   */\n  FLOAT_32,\n\n  /**\n   * Defines a 8 bytes (64 bits) floating-point field. \\\n   */\n  FLOAT_64\n}\n\n/**\n * Defines a dynamically-sized array with elements of a certain type. \\\n * Dynamically-sized arrays are useful when a packet's field is an array of a non pre-defined length. \\\n * Although, this makes dynamically-sized arrays more memory expensive as the internal buffer needs to be grown accordingly.\n *\n * NOTE: If an array will ALWAYS have the same length, prefer using the `FieldFixedArray` type, for both better performance and memory efficiency. \\\n * NOTE: As of now, dynamic arrays can have at most 256 elements.\n */\nexport function FieldArray<T extends Field | BinaryPacket<Definition> | ''>(\n  item: T\n): [itemType: T] {\n  return [item]\n}\n\n/**\n * Defines a statically-sized array with elements of a certain type. \\\n * Fixed arrays are useful when a packet's field is an array of a pre-defined length. \\\n * Fixed arrays much more memory efficient and performant than non-fixed ones.\n *\n * NOTE: If an array will not always have the same length, use the `FieldArray` type.\n */\nexport function FieldFixedArray<\n  T extends Field | BinaryPacket<Definition> | '',\n  Length extends number\n>(item: T, length: Length): [itemType: T, length: Length] {\n  if (length < 0 || !Number.isFinite(length)) {\n    throw new RangeError('Length of a FixedArray must be a positive integer.')\n  }\n\n  return [item, length]\n}\n\n/**\n * Utility class that allows serializing arrays through any kind of iterable, as long as the number of elements is known beforehand. \\\n * Needed to skip the overhead of duplicating the data into an actual array just for it to be serialized straight away and trashed.\n */\nexport class SequentialSerializer<T> implements Iterable<T> {\n  constructor(\n    private readonly iterable: Iterable<T>,\n    public readonly length: number\n  ) {}\n\n  [Symbol.iterator]() {\n    return this.iterable[Symbol.iterator]()\n  }\n}\n\ntype SequentiallySerializable<T, IsRead extends boolean> = IsRead extends true\n  ? T[]\n  : T[] | SequentialSerializer<T>\n\ntype BitFlags = (string[] | ReadonlyArray<string>) & {\n  length: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8\n}\n\n/**\n * Defines a sequence of up to 8 \"flags\" (basically single bits/booleans) that can be packed together into a single 8 bits value. \\\n * This is useful for minimizing bytes usage when there are lots of boolean fields/flags, instead of saving each flag separately as its own 8 bits value.\n *\n * The input should be an array of strings (with at most 8 elements) where each string defines the name of a flag. \\\n * This is just for definition purposes, then when actually writing or reading packets it'll just be a record-object with those names as keys and boolean values.\n */\nexport function FieldBitFlags<const FlagsArray extends BitFlags>(flags: FlagsArray) {\n  if (flags.length > 8) {\n    throw new Error(\n      `Invalid BinaryPacket definition: a BitFlags field can have only up to 8 flags, given: ${flags.join(', ')}`\n    )\n  }\n\n  return { flags }\n}\n\n/**\n * Defines a string field. \\\n * Strings cannot be more than 65536 characters long.\n *\n * NOTE: Only strings containing just ASCII and/or single-octet UTF-8 characters are supported.\n */\nexport function FieldString() {\n  return '' as const\n}\n\n/**\n * Defines an optional BinaryPacket \"subpacket\" field. \\\n * When writing and reading packets it'll be possible to provide and receive `undefined` instead of a valid object.\n */\nexport function FieldOptional<T extends BinaryPacket<Definition>>(packet: T) {\n  return { optional: packet }\n}\n\n/**\n * Do not manually construct this type: an object of this kind is returned by a BinaryPacket `createVisitor` method. \\\n * Used in the `BinaryPacket::visit` static method to perform a sort of \"pattern matching\" on an incoming packet (of yet unknown type) buffer.\n */\ntype Visitor = [BinaryPacket<Definition>, (packet: any) => void]\n\nexport class BinaryPacket<T extends Definition> {\n  /**\n   * Defines a new binary packet. \\\n   * Make sure that every `packetId` is unique.\n   * @throws RangeError If packetId is negative, floating-point, or greater than 255.\n   */\n  static define<T extends Definition>(packetId: number, definition?: T) {\n    if (packetId < 0 || !Number.isFinite(packetId)) {\n      throw new RangeError('Packet IDs must be positive integers.')\n    }\n\n    if (packetId > 255) {\n      throw new RangeError(\n        'Packet IDs greater than 255 are not supported. Do you REALLY need more than 255 different kinds of packets?'\n      )\n    }\n\n    return new BinaryPacket(packetId, definition)\n  }\n\n  /**\n   * Reads just the packetId from the given Buffer. \\\n   * This method practically just reads the uint8 at offset `byteOffset` (default: 0). \\\n   * Useful if the receiving side receives multiple types of packets.\n   */\n  static readPacketIdNodeBuffer(buffer: Buffer, byteOffset = 0) {\n    return buffer.readUint8(byteOffset)\n  }\n\n  /**\n   * Reads just the packetId from the given DataView. \\\n   * This method practically just reads the uint8 at offset `byteOffset` (default: 0). \\\n   * Useful if the receiving side receives multiple types of packets.\n   */\n  static readPacketIdDataView(dataview: DataView, byteOffset = 0) {\n    return dataview.getUint8(byteOffset)\n  }\n\n  /**\n   * Reads just the packetId from the given ArrayBuffer. \\\n   * This method practically just reads the uint8 at offset `byteOffset`. \\\n   * Useful if the receiving side receives multiple types of packets.\n   *\n   * NOTE: Due to security issues, the `byteOffset` argument cannot be defaulted and must be provided by the user. \\\n   * NOTE: For more information read the `readArrayBuffer` method documentation.\n   */\n  static readPacketIdArrayBuffer(arraybuffer: TrueArrayBuffer, byteOffset: number) {\n    return new Uint8Array(arraybuffer, byteOffset, 1)[0]\n  }\n\n  /**\n   * Visits and \"pattern matches\" the given Buffer through the given visitors. \\\n   * The Buffer is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\n   *\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\n   */\n  static visitNodeBuffer(buffer: Buffer, ...visitors: Visitor[]) {\n    return BinaryPacket.visit(buffer, GET_FUNCTION_BUF, decodeStringFromNodeBuffer, visitors)\n  }\n\n  /**\n   * Visits and \"pattern matches\" the given DataView through the given visitors. \\\n   * The DataView is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\n   *\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\n   */\n  static visitDataView(dataview: DataView, ...visitors: Visitor[]) {\n    return BinaryPacket.visit(dataview, GET_FUNCTION, decodeStringFromDataView, visitors)\n  }\n\n  /**\n   * Visits and \"pattern matches\" the given ArrayBuffer through the given visitors. \\\n   * The ArrayBuffer is compared to the series of visitors through its Packet ID, and, if an appropriate visitor is found: its callback is called.\n   *\n   * NOTE: Due to security issues, the `byteOffset` and `byteLength` arguments must be provided by the user. \\\n   * NOTE: For more information read the `readArrayBuffer` method documentation. \\\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\n   */\n  static visitArrayBuffer(\n    arraybuffer: TrueArrayBuffer,\n    byteOffset: number,\n    byteLength: number,\n    ...visitors: Visitor[]\n  ) {\n    return BinaryPacket.visit(\n      new DataView(arraybuffer, byteOffset, byteLength),\n      GET_FUNCTION,\n      decodeStringFromDataView,\n      visitors\n    )\n  }\n\n  /**\n   * Reads/deserializes from the given Buffer. \\\n   * Method available ONLY on NodeJS and Bun.\n   *\n   * If possible, always prefer reading using this method, as it is much faster than the other ones.\n   *\n   * NOTE: if you have an ArrayBuffer do not bother wrapping it into a node Buffer yourself. \\\n   * NOTE: if you have an ArrayBuffer use the appropriate `readArrayBuffer`.\n   */\n  readNodeBuffer(\n    dataIn: Buffer,\n    offsetPointer = { offset: 0 },\n    byteLength = dataIn.byteLength\n  ): ToJson<T, true> {\n    return this.read(\n      dataIn,\n      offsetPointer,\n      byteLength,\n      GET_FUNCTION_BUF,\n      decodeStringFromNodeBuffer\n    )\n  }\n\n  /**\n   * Reads/deserializes from the given DataView.\n   *\n   * NOTE: if you have an ArrayBuffer do not bother wrapping it into a DataView yourself. \\\n   * NOTE: if you have an ArrayBuffer use the appropriate `readArrayBuffer`.\n   */\n  readDataView(\n    dataIn: DataView,\n    offsetPointer = { offset: 0 },\n    byteLength = dataIn.byteLength\n  ): ToJson<T, true> {\n    return this.read(dataIn, offsetPointer, byteLength, GET_FUNCTION, decodeStringFromDataView)\n  }\n\n  /**\n   * Reads/deserializes from the given ArrayBuffer. \\\n   * WARNING: this method is practically a HACK.\n   *\n   * When using this method both the `byteOffset` and `byteLength` are REQUIRED and cannot be defaulted. \\\n   * This is to prevent serious bugs and security issues. \\\n   * That is because often raw ArrayBuffers come from a pre-allocated buffer pool and do not start at byteOffset 0.\n   *\n   * NOTE: if you have a node Buffer do not bother wrapping it into an ArrayBuffer yourself. \\\n   * NOTE: if you have a node Buffer use the appropriate `readNodeBuffer` as it is much faster and less error prone.\n   */\n  readArrayBuffer(dataIn: TrueArrayBuffer, byteOffset: number, byteLength: number) {\n    return this.read(\n      hasNodeBuffers\n        ? Buffer.from(dataIn, byteOffset, byteLength)\n        : (new DataView(dataIn, byteOffset, byteLength) as any),\n      { offset: 0 }, // The underlying buffer has already been offsetted\n      byteLength,\n      hasNodeBuffers ? GET_FUNCTION_BUF : GET_FUNCTION,\n      hasNodeBuffers ? decodeStringFromNodeBuffer : (decodeStringFromDataView as any)\n    )\n  }\n\n  /**\n   * Writes/serializes the given object into a Buffer. \\\n   * Method available ONLY on NodeJS and Bun.\n   *\n   * If possible, always prefer writing using this method, as it is much faster than the other ones.\n   */\n  writeNodeBuffer(dataOut: ToJson<T>) {\n    const byteLength = this.precalculateBufferLengthWithStrings(dataOut)\n    const buffer = Buffer.allocUnsafe(byteLength)\n\n    return this.write(\n      buffer,\n      dataOut,\n      { offset: 0 },\n      byteLength,\n      byteLength,\n      SET_FUNCTION_BUF,\n      growNodeBuffer,\n      encodeStringIntoNodeBuffer\n    )\n  }\n\n  /**\n   * Writes/serializes the given object into a DataView. \\\n   */\n  writeDataView(dataOut: ToJson<T>) {\n    const byteLength = this.precalculateBufferLengthWithStrings(dataOut)\n    const dataview = new DataView(new ArrayBuffer(byteLength))\n\n    return this.write(\n      dataview,\n      dataOut,\n      { offset: 0 },\n      byteLength,\n      byteLength,\n      SET_FUNCTION,\n      growDataView,\n      encodeStringIntoDataView\n    )\n  }\n\n  /**\n   * Writes/serializes the given object into an ArrayBuffer. \\\n   * This method is just a wrapper around either  `writeNodeBuffer` or `writeDataView`. \\\n   *\n   * This method works with JavaScript standard raw ArrayBuffer(s) and, as such, is very error prone: \\\n   * Make sure you're using the returned byteLength and byteOffset fields in the read counterpart. \\\n   *\n   * Always consider whether is possible to use directly `writeNodeBuffer` or `writeDataView` instead of `writeArrayBuffer`. \\\n   * For more information read the `readArrayBuffer` documentation.\n   */\n  writeArrayBuffer(dataOut: ToJson<T>) {\n    const buf = hasNodeBuffers ? this.writeNodeBuffer(dataOut) : this.writeDataView(dataOut)\n    return { buffer: buf.buffer, byteLength: buf.byteLength, byteOffset: buf.byteOffset }\n  }\n\n  /**\n   * Creates a \"visitor\" object for this BinaryPacket definition. \\\n   * Used when visiting and \"pattern matching\" buffers with the `BinaryPacket::visit` static utility methods. \\\n   *\n   * For more information read the `BinaryPacket::visitNodeBuffer` documentation. \\\n   * NOTE: If visiting packets in a loop, for both performance and memory efficiency reasons, it is much better to create each visitor only once before the loop starts and not every iteration.\n   */\n  visitor(onVisit: (packet: ToJson<T>) => void): Visitor {\n    return [this, onVisit]\n  }\n\n  sequentialSerializer(numElements: number, dataOut: Iterable<ToJson<T>>) {\n    const byteLength = this.minimumByteLength * numElements\n    const buffer = Buffer.allocUnsafe(byteLength)\n    const offsetPointer = { offset: 0 }\n\n    for (const element of dataOut) {\n      this.write(\n        buffer,\n        element,\n        offsetPointer,\n        byteLength,\n        byteLength,\n        SET_FUNCTION_BUF,\n        growNodeBuffer,\n        encodeStringIntoNodeBuffer\n      )\n    }\n  }\n\n  /// PRIVATE\n\n  private readonly entries: Entries\n  readonly stringPositions: StringPositions\n  readonly minimumByteLength: number\n\n  private constructor(\n    private readonly packetId: number,\n    definition?: T\n  ) {\n    this.entries = definition ? sortEntries(definition) : []\n    const inspection = inspectEntries(this.entries)\n    this.minimumByteLength = inspection.minimumByteLength\n    this.stringPositions = inspection.stringPositions\n  }\n\n  private static visit<Buf extends DataView | Buffer>(\n    dataIn: Buf,\n    readFunctions: typeof GET_FUNCTION | typeof GET_FUNCTION_BUF,\n    decodeStringFunction: (dataIn: Buf, byteOffset: number, strlen: number) => string,\n    visitors: Visitor[]\n  ) {\n    for (const [Packet, onVisit] of visitors) {\n      if (Packet.packetId === readFunctions[Field.UNSIGNED_INT_8](dataIn as any, 0)) {\n        return onVisit(\n          Packet.read(dataIn, { offset: 0 }, dataIn.byteLength, readFunctions, decodeStringFunction)\n        )\n      }\n    }\n  }\n\n  private read<Buf extends DataView | Buffer>(\n    dataIn: Buf,\n    offsetPointer: { offset: number },\n    byteLength: number,\n    readFunctions: typeof GET_FUNCTION | typeof GET_FUNCTION_BUF,\n    decodeStringFunction: (dataIn: Buf, byteOffset: number, strlen: number) => string\n  ): ToJson<T, true> {\n    if (byteLength + offsetPointer.offset < this.minimumByteLength) {\n      throw new Error(\n        `There is no space available to fit a packet of type ${this.packetId} at offset ${offsetPointer.offset}`\n      )\n    }\n\n    if (\n      readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset) !== this.packetId\n    ) {\n      throw new Error(\n        `Data at offset ${offsetPointer.offset} is not a packet of type ${this.packetId}`\n      )\n    }\n\n    offsetPointer.offset += 1\n    const result: any = {}\n\n    for (const [name, def] of this.entries) {\n      if (Array.isArray(def)) {\n        const length =\n          // def[1] is the length of a statically-sized array, if undefined: must read the length from the buffer as it means it's a dynamically-sized array\n          def[1] ?? readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset++)\n\n        const array = Array(length)\n\n        const itemType = def[0]\n\n        if (typeof itemType === 'object') {\n          // Array of \"subpackets\"\n          for (let i = 0; i < length; ++i) {\n            array[i] = itemType.read(\n              dataIn,\n              offsetPointer,\n              byteLength,\n              readFunctions,\n              decodeStringFunction\n            )\n          }\n        } else if (itemType === '') {\n          // Array of strings\n          for (let i = 0; i < length; ++i) {\n            const strlen = readFunctions[Field.UNSIGNED_INT_16](dataIn as any, offsetPointer.offset)\n            offsetPointer.offset += 2\n\n            array[i] = decodeStringFunction(dataIn, offsetPointer.offset, strlen)\n            offsetPointer.offset += strlen\n          }\n        } else {\n          // Array of primitives (numbers)\n          const itemSize = BYTE_SIZE[itemType]\n\n          // It seems like looping over each element is actually much faster than using TypedArrays bulk copy.\n          // TODO: properly benchmark with various array sizes to see if it's actually the case.\n          for (let i = 0; i < length; ++i) {\n            array[i] = readFunctions[itemType](dataIn as any, offsetPointer.offset)\n            offsetPointer.offset += itemSize\n          }\n        }\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = array\n      } else if (typeof def === 'number') {\n        // Single primitive (number)\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = readFunctions[def](dataIn as any, offsetPointer.offset)\n        offsetPointer.offset += BYTE_SIZE[def]\n      } else if (def === '') {\n        const strlen = readFunctions[Field.UNSIGNED_INT_16](dataIn as any, offsetPointer.offset)\n        offsetPointer.offset += 2\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = decodeStringFunction(dataIn, offsetPointer.offset, strlen)\n        offsetPointer.offset += strlen\n      } else if ('flags' in def) {\n        // BitFlags\n        const flags = readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset)\n        offsetPointer.offset += 1\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = {}\n\n        for (let bit = 0; bit < def.flags.length; ++bit) {\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n          result[name][def.flags[bit]] = !!(flags & (1 << bit))\n        }\n      } else if ('optional' in def) {\n        // Single optional \"subpacket\"\n        const hasSubPacket =\n          readFunctions[Field.UNSIGNED_INT_8](dataIn as any, offsetPointer.offset) !== 0\n\n        offsetPointer.offset += 1\n\n        if (hasSubPacket) {\n          // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n          result[name] = def.optional.read(\n            dataIn,\n            offsetPointer,\n            byteLength,\n            readFunctions,\n            decodeStringFunction\n          )\n        }\n      } else {\n        // Single \"subpacket\"\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n        result[name] = def.read(\n          dataIn,\n          offsetPointer,\n          byteLength,\n          readFunctions,\n          decodeStringFunction\n        )\n      }\n    }\n\n    return result as ToJson<T, true>\n  }\n\n  private write<Buf extends DataView | Buffer>(\n    buffer: Buf,\n    dataOut: ToJson<T>,\n    offsetPointer: { offset: number },\n    byteLength: number,\n    maxByteLength: number,\n    writeFunctions: typeof SET_FUNCTION | typeof SET_FUNCTION_BUF,\n    growBufferFunction: (buffer: Buf, newByteLength: number) => Buf,\n    encodeStringFunction: (buffer: Buf, byteOffset: number, string: string) => void\n  ): Buf {\n    writeFunctions[Field.UNSIGNED_INT_8](buffer as any, this.packetId, offsetPointer.offset)\n    offsetPointer.offset += 1\n\n    for (const [name, def] of this.entries) {\n      const data = dataOut[name]\n\n      if (Array.isArray(def)) {\n        // Could be both an array of just numbers or \"subpackets\"\n\n        const length = (data as SequentiallySerializable<any, false>).length\n\n        // Check if it is a dynamically-sized array, if it is, the length of the array must be serialized in the buffer before its elements\n        // Explicitly check for undefined and not falsy values because it could be a statically-sized array of 0 elements.\n        const isDynamicArray = def[1] === undefined\n\n        if (isDynamicArray) {\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, length, offsetPointer.offset)\n          offsetPointer.offset += 1\n        }\n\n        if (length > 0) {\n          const itemType = def[0]\n\n          if (typeof itemType === 'object') {\n            // Array of \"subpackets\"\n\n            if (isDynamicArray) {\n              const neededBytesForElements = length * itemType.minimumByteLength\n\n              byteLength += neededBytesForElements\n              maxByteLength += neededBytesForElements\n\n              if (buffer.byteLength < maxByteLength) {\n                buffer = growBufferFunction(buffer, maxByteLength)\n              }\n            }\n\n            for (const object of data as unknown as ToJson<Definition>[]) {\n              // Array of \"subpackets\"\n              buffer = itemType.write(\n                buffer,\n                object,\n                offsetPointer,\n                byteLength,\n                maxByteLength,\n                writeFunctions,\n                growBufferFunction,\n                encodeStringFunction\n              )\n\n              byteLength = offsetPointer.offset\n              maxByteLength = buffer.byteLength\n            }\n          } else if (itemType === '') {\n            // Array of strings\n            for (let i = 0; i < length; ++i) {\n              const str = (data as unknown as string[])[i]\n              const strlen = str.length\n\n              writeFunctions[Field.UNSIGNED_INT_16](buffer as any, strlen, offsetPointer.offset)\n              offsetPointer.offset += 2\n\n              encodeStringFunction(buffer, offsetPointer.offset, str)\n              offsetPointer.offset += strlen\n            }\n          } else {\n            // Array of primitives (numbers)\n            const itemSize = BYTE_SIZE[itemType]\n\n            if (isDynamicArray) {\n              const neededBytesForElements = length * itemSize\n\n              byteLength += neededBytesForElements\n              maxByteLength += neededBytesForElements\n\n              if (buffer.byteLength < maxByteLength) {\n                buffer = growBufferFunction(buffer, maxByteLength)\n              }\n            }\n\n            // It seems like looping over each element is actually much faster than using TypedArrays bulk copy.\n            // TODO: properly benchmark with various array sizes to see if it's actually the case.\n            for (const number of data as SequentiallySerializable<number, false>) {\n              writeFunctions[itemType](buffer as any, number, offsetPointer.offset)\n              offsetPointer.offset += itemSize\n            }\n          }\n        }\n      } else if (typeof def === 'number') {\n        // Single primitive (number)\n        writeFunctions[def](buffer as any, data as number, offsetPointer.offset)\n        offsetPointer.offset += BYTE_SIZE[def]\n      } else if (def === '') {\n        // String\n        const strlen = (data as string).length\n\n        writeFunctions[Field.UNSIGNED_INT_16](buffer as any, strlen, offsetPointer.offset)\n        offsetPointer.offset += 2\n\n        encodeStringFunction(buffer, offsetPointer.offset, data as string)\n        offsetPointer.offset += strlen\n      } else if ('flags' in def) {\n        // BitFlags\n        let flags = 0\n\n        for (let bit = 0; bit < def.flags.length; ++bit) {\n          if ((data as Record<string, boolean>)[def.flags[bit]]) {\n            flags |= 1 << bit\n          }\n        }\n\n        writeFunctions[Field.UNSIGNED_INT_8](buffer as any, flags, offsetPointer.offset)\n        offsetPointer.offset += 1\n      } else if ('optional' in def) {\n        if (data) {\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, 1, offsetPointer.offset)\n          offsetPointer.offset += 1\n\n          byteLength += def.optional.minimumByteLength\n          maxByteLength += def.optional.minimumByteLength\n\n          if (buffer.byteLength < maxByteLength) {\n            buffer = growBufferFunction(buffer, maxByteLength)\n          }\n\n          buffer = def.optional.write(\n            buffer,\n            data as ToJson<Definition>,\n            offsetPointer,\n            byteLength,\n            maxByteLength,\n            writeFunctions,\n            growBufferFunction,\n            encodeStringFunction\n          )\n\n          byteLength = offsetPointer.offset\n          maxByteLength = buffer.byteLength\n        } else {\n          writeFunctions[Field.UNSIGNED_INT_8](buffer as any, 0, offsetPointer.offset)\n          offsetPointer.offset += 1\n        }\n      } else {\n        // Single \"subpacket\"\n        buffer = def.write(\n          buffer,\n          data as ToJson<Definition>,\n          offsetPointer,\n          byteLength,\n          maxByteLength,\n          writeFunctions,\n          growBufferFunction,\n          encodeStringFunction\n        )\n\n        byteLength = offsetPointer.offset\n        maxByteLength = buffer.byteLength\n      }\n    }\n\n    return buffer\n  }\n\n  private precalculateBufferLengthWithStrings(dataOut: ToJson<T>) {\n    let len = this.minimumByteLength\n\n    for (const field of this.stringPositions[0]) {\n      // String field\n      len += (dataOut[field] as string).length\n    }\n\n    for (const field of this.stringPositions[1]) {\n      // Array of strings field\n      for (const string of dataOut[field] as unknown as string[]) {\n        len += 2 + string.length\n      }\n    }\n\n    for (const field in this.stringPositions[2]) {\n      // Subpacket that has some string fields\n      len += this.stringPositions[2][field].precalculateBufferLengthWithStrings(\n        dataOut[field] as any\n      )\n    }\n\n    return len\n  }\n}\n\n/**\n * BinaryPacket definition: \\\n * Any packet can be defined through a \"schema\" object explaining its fields names and types.\n *\n * @example\n * // Imagine we have a game board where each cell is a square and is one unit big.\n * // A cell can be then defined by its X and Y coordinates.\n * // For simplicity, let's say there cannot be more than 256 cells, so we can use 8 bits for each coordinate.\n * const Cell = {\n *  x: Field.UNSIGNED_INT_8,\n *  y: Field.UNSIGNED_INT_8\n * }\n *\n * // When done with the cell definition we can create its BinaryPacket writer/reader.\n * // NOTE: each BinaryPacket needs an unique ID, for identification purposes and error checking.\n * const CellPacket = BinaryPacket.define(0, Cell)\n *\n * // Let's now make the definition of the whole game board.\n * // You can also specify arrays of both \"primitive\" fields and other BinaryPackets.\n * const Board = {\n *  numPlayers: Field.UNSIGNED_INT_8,\n *  cells: FieldArray(CellPacket)\n * }\n *\n * // When done with the board definition we can create its BinaryPacket writer/reader.\n * // NOTE: each BinaryPacket needs an unique ID, for identification purposes and error checking.\n * const BoardPacket = BinaryPacket.define(1, Board)\n *\n * // And use it.\n * const buffer = BoardPacket.writeNodeBuffer({\n *  numPlayers: 1,\n *  cells: [\n *    { x: 0, y: 0 },\n *    { x: 1, y: 1 }\n *  ]\n * })\n *\n * // sendTheBufferOver(buffer)\n * // ...\n * // const buffer = receiveTheBuffer()\n * const board = BoardPacket.readNodeBuffer(buffer)\n * // ...\n */\nexport type Definition = {\n  [fieldName: string]:\n    | MaybeArray<Field>\n    | MaybeArray<BinaryPacket<Definition>>\n    | MaybeArray<''>\n    | { flags: BitFlags }\n    | { optional: BinaryPacket<Definition> }\n}\n\ntype MaybeArray<T> = T | [itemType: T] | [itemType: T, length: number]\n\ntype BitFlagsToJson<FlagsArray extends BitFlags> = {\n  [key in FlagsArray[number]]: boolean\n}\n\n/**\n * Meta-type that converts a `Definition` schema to the type of the actual JavaScript object that will be written into a packet or read from. \\\n */\nexport type ToJson<T extends Definition, IsRead extends boolean = false> = {\n  [K in keyof T]: T[K] extends [infer Item]\n    ? Item extends BinaryPacket<infer BPDef>\n      ? SequentiallySerializable<ToJson<BPDef, IsRead>, IsRead>\n      : Item extends ''\n        ? SequentiallySerializable<string, IsRead>\n        : SequentiallySerializable<number, IsRead>\n    : T[K] extends [infer Item, infer Length]\n      ? Item extends BinaryPacket<infer BPDef>\n        ? SequentiallySerializable<ToJson<BPDef, IsRead>, IsRead> & { length: Length }\n        : Item extends ''\n          ? string[] & { length: Length }\n          : number[] & { length: Length }\n      : T[K] extends BinaryPacket<infer BPDef>\n        ? ToJson<BPDef, IsRead>\n        : T[K] extends { flags: infer FlagsArray extends BitFlags }\n          ? BitFlagsToJson<FlagsArray>\n          : T[K] extends { optional: BinaryPacket<infer BPDef extends Definition> }\n            ? ToJson<BPDef, IsRead> | undefined\n            : T[K] extends ''\n              ? string\n              : number\n}\n\n/**\n * In a JavaScript object, the order of its keys is not strictly defined: sort them by field name. \\\n * Thus, we cannot trust iterating over an object keys: we MUST iterate over its entries array. \\\n * This is important to make sure that whoever shares BinaryPacket definitions can correctly write/read packets independently of their JS engines.\n */\nfunction sortEntries(definition: Definition) {\n  return Object.entries(definition).sort(([fieldName1], [fieldName2]) =>\n    fieldName1.localeCompare(fieldName2)\n  )\n}\n\ntype Entries = ReturnType<typeof sortEntries>\n\ntype StringPositions = [\n  string[],\n  string[],\n  {\n    [field: string]: BinaryPacket<Definition>\n  }\n]\n\n/**\n * Helper function that \"inspects\" the entries of a BinaryPacket definition\n * and returns useful \"stats\" needed for writing and reading buffers.\n *\n * This function is ever called only once per BinaryPacket definition.\n */\nfunction inspectEntries(entries: Entries) {\n  // The PacketID is already 1 byte, that's why we aren't starting from 0.\n  let minimumByteLength = 1\n\n  const stringPositions: StringPositions = [[], [], {}]\n\n  for (const [name, type] of entries) {\n    if (Array.isArray(type)) {\n      if (type.length === 2) {\n        // Statically-sized array\n        const isString = type[0] === ''\n\n        const itemSize =\n          typeof type[0] === 'object'\n            ? type[0].minimumByteLength\n            : isString\n              ? 2\n              : BYTE_SIZE[type[0]]\n\n        minimumByteLength += type[1] * itemSize\n\n        if (isString) {\n          stringPositions[1].push(name)\n        }\n      } else {\n        // Dynamically-sized array\n        // Adding 1 byte to serialize the array length\n        minimumByteLength += 1\n\n        if (type[0] === '') {\n          stringPositions[1].push(name)\n        }\n      }\n    } else if (type instanceof BinaryPacket) {\n      minimumByteLength += type.minimumByteLength\n      stringPositions[2][name] = type\n    } else if (typeof type === 'object') {\n      // BitFlags & Optionals\n      // BitFlags are always 1 byte long, because they can hold up to 8 booleans\n      // Optionals minimum is 1 byte long, because it holds whether the subpacket is present or not\n      minimumByteLength += 1\n    } else if (type === '') {\n      // String\n      // Adding 2 to serialize the string length\n      minimumByteLength += 2\n      stringPositions[0].push(name)\n    } else {\n      minimumByteLength += BYTE_SIZE[type]\n    }\n  }\n\n  return { minimumByteLength, stringPositions }\n}\n\n//////////////////////////////////////////////\n// The logic here is practically over       //\n// Here below there are needed constants    //\n// that map a field-type to a functionality //\n//////////////////////////////////////////////\n\nconst BYTE_SIZE = Array(8) as number[]\n\nBYTE_SIZE[Field.UNSIGNED_INT_8] = 1\nBYTE_SIZE[Field.INT_8] = 1\n\nBYTE_SIZE[Field.UNSIGNED_INT_16] = 2\nBYTE_SIZE[Field.INT_16] = 2\n\nBYTE_SIZE[Field.UNSIGNED_INT_32] = 4\nBYTE_SIZE[Field.INT_32] = 4\nBYTE_SIZE[Field.FLOAT_32] = 4\n\nBYTE_SIZE[Field.FLOAT_64] = 8\n\nconst GET_FUNCTION = Array(8) as ((view: DataView, offset: number) => number)[]\n\nGET_FUNCTION[Field.UNSIGNED_INT_8] = (view, offset) => view.getUint8(offset)\nGET_FUNCTION[Field.INT_8] = (view, offset) => view.getInt8(offset)\n\nGET_FUNCTION[Field.UNSIGNED_INT_16] = (view, offset) => view.getUint16(offset)\nGET_FUNCTION[Field.INT_16] = (view, offset) => view.getInt16(offset)\n\nGET_FUNCTION[Field.UNSIGNED_INT_32] = (view, offset) => view.getUint32(offset)\nGET_FUNCTION[Field.INT_32] = (view, offset) => view.getInt32(offset)\nGET_FUNCTION[Field.FLOAT_32] = (view, offset) => view.getFloat32(offset)\n\nGET_FUNCTION[Field.FLOAT_64] = (view, offset) => view.getFloat64(offset)\n\nconst SET_FUNCTION = Array(8) as ((view: DataView, value: number, offset: number) => void)[]\n\nSET_FUNCTION[Field.UNSIGNED_INT_8] = (view, value, offset) => view.setUint8(offset, value)\nSET_FUNCTION[Field.INT_8] = (view, value, offset) => view.setInt8(offset, value)\n\nSET_FUNCTION[Field.UNSIGNED_INT_16] = (view, value, offset) => view.setUint16(offset, value)\nSET_FUNCTION[Field.INT_16] = (view, value, offset) => view.setInt16(offset, value)\n\nSET_FUNCTION[Field.UNSIGNED_INT_32] = (view, value, offset) => view.setUint32(offset, value)\nSET_FUNCTION[Field.INT_32] = (view, value, offset) => view.setInt32(offset, value)\nSET_FUNCTION[Field.FLOAT_32] = (view, value, offset) => view.setFloat32(offset, value)\n\nSET_FUNCTION[Field.FLOAT_64] = (view, value, offset) => view.setFloat64(offset, value)\n\nconst SET_FUNCTION_BUF = Array(8) as ((nodeBuffer: Buffer, value: number, offset: number) => void)[]\n\nif (hasNodeBuffers) {\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_8] = (view, value, offset) => view.writeUint8(value, offset)\n  SET_FUNCTION_BUF[Field.INT_8] = (view, value, offset) => view.writeInt8(value, offset)\n\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_16] = (view, value, offset) =>\n    view.writeUint16BE(value, offset)\n  SET_FUNCTION_BUF[Field.INT_16] = (view, value, offset) => view.writeInt16BE(value, offset)\n\n  SET_FUNCTION_BUF[Field.UNSIGNED_INT_32] = (view, value, offset) =>\n    view.writeUint32BE(value, offset)\n  SET_FUNCTION_BUF[Field.INT_32] = (view, value, offset) => view.writeInt32BE(value, offset)\n  SET_FUNCTION_BUF[Field.FLOAT_32] = (view, value, offset) => view.writeFloatBE(value, offset)\n\n  SET_FUNCTION_BUF[Field.FLOAT_64] = (view, value, offset) => view.writeDoubleBE(value, offset)\n}\n\nconst GET_FUNCTION_BUF = Array(8) as ((nodeBuffer: Buffer, offset: number) => number)[]\n\nif (hasNodeBuffers) {\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_8] = (view, offset) => view.readUint8(offset)\n  GET_FUNCTION_BUF[Field.INT_8] = (view, offset) => view.readInt8(offset)\n\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_16] = (view, offset) => view.readUint16BE(offset)\n\n  GET_FUNCTION_BUF[Field.INT_16] = (view, offset) => view.readInt16BE(offset)\n  GET_FUNCTION_BUF[Field.UNSIGNED_INT_32] = (view, offset) => view.readUint32BE(offset)\n\n  GET_FUNCTION_BUF[Field.INT_32] = (view, offset) => view.readInt32BE(offset)\n  GET_FUNCTION_BUF[Field.FLOAT_32] = (view, offset) => view.readFloatBE(offset)\n  GET_FUNCTION_BUF[Field.FLOAT_64] = (view, offset) => view.readDoubleBE(offset)\n}\n"],"mappings":"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","names":["hasNodeBuffers","growDataView","dataview","newByteLength","resizedBuffer","amountToCopy","length","offset","growNodeBuffer","buffer","newBuffer","textEncoder","textDecoder","encodeStringIntoDataView","byteOffset","string","strlen","u8Buffer","encodeSmallString","encodeStringIntoNodeBuffer","i","decodeStringFromNodeBuffer","decodeStringFromDataView","Field","FieldArray","item","FieldFixedArray","length","SequentialSerializer","iterable","FieldBitFlags","flags","FieldString","FieldOptional","packet","BinaryPacket","_BinaryPacket","packetId","definition","sortEntries","inspection","inspectEntries","buffer","byteOffset","dataview","arraybuffer","visitors","GET_FUNCTION_BUF","decodeStringFromNodeBuffer","GET_FUNCTION","decodeStringFromDataView","byteLength","dataIn","offsetPointer","hasNodeBuffers","dataOut","SET_FUNCTION_BUF","growNodeBuffer","encodeStringIntoNodeBuffer","SET_FUNCTION","growDataView","encodeStringIntoDataView","buf","onVisit","numElements","element","readFunctions","decodeStringFunction","Packet","result","name","def","array","itemType","i","strlen","itemSize","BYTE_SIZE","bit","hasSubPacket","maxByteLength","writeFunctions","growBufferFunction","encodeStringFunction","data","isDynamicArray","neededBytesForElements","object","str","number","len","field","string","fieldName1","fieldName2","entries","minimumByteLength","stringPositions","type","isString","view","offset","value"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "binary-packet",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Lightweight and hyper-fast, zero-dependencies, TypeScript-first, schema-based binary packets serialization and deserialization library",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",