@zzzeros0/nbsp 0.1.0

package/LICENSE

@@ -0,0 +1,3 @@
+MIT License
+
+Copyright (c) 2026 Tu Nombre

package/README.md

@@ -0,0 +1,344 @@
+# NBSP
+
+## NodeJS Binary Structure Payloads
+
+This package facilitates the creation and management of fixed binary payloads in NodeJS.
+
+## Why NBSP?
+
+NBSP is designed for:
+
+- Binary network protocols (MQTT, CAN, custom TCP/UDP protocols)
+- Fixed-size payloads
+- Embedded / low-level communication
+- Interoperability with C/C++ structures
+
+It avoids:
+
+- JSON serialization overhead
+- Dynamic allocations
+- Hidden copies
+
+### Example
+
+```ts
+interface AckPacket {
+  id: string;
+} // domain AckPacket
+
+interface Packet {
+  header: number;
+  id: string;
+  method: string;
+  content: string;
+} // domain Packet
+
+const AckPacketStructure = structure<AckPacket>(
+  {
+    id: charDataType(6),
+  },
+  {
+    packed: true,
+  },
+);
+
+const PacketStructure = structure<Packet>(
+  {
+    header: DataType.UINT32LE,
+    id: charDataType(6),
+    method: charDataType(4),
+    content: charDataType(64),
+  },
+  {
+    packed: true,
+  },
+);
+
+console.log(AckPacketStructure.size); // 6 (Unpacked: 10)
+console.log(PacketStructure.size); // 78 (Unpacked: 128)
+
+mqttClient.on("message", (topic, msg) => {
+  const packet = PacketStructure.from(msg);
+
+  processMessage(
+    topic,
+    toString(packet.id),
+    toString(packet.method),
+    toString(packet.content),
+  ).then(() => {
+    const ackMessage = new AckPacketStructure({
+      id: packet.id,
+    });
+
+    mqttClient.publish("ack", ackMessage.data());
+  });
+});
+```
+
+## Usage
+
+1. Create a domain interface.
+
+- This will represent your data.
+
+```ts
+interface Person {
+  age: number;
+  name: string;
+} // domain Person
+```
+
+2. Create a Structure for your domain interface. Calling `structure` will return a new class; it is not intended to be extended.
+
+```ts
+const PersonStructure = structure<Person>({
+  age: DataType.UINT8,
+  name: charDataType(4), // strings are arrays of UINT8. charDataType(n) is equivalent to [DataType.UINT8, n]
+});
+```
+
+3. Now, you can instantiate the structure by using `new` or the `StructureConstructor`'s static method `from`. Instance exposes getters and setters to update and retrieve data directly from the fields of the structure in the buffer as well as some other methods to manage it:
+
+```ts
+const person1 = new PersonStructure({
+  age: 24,
+  name: toUint8Array("Dave"), // Transform the string to UTF-8 UINT8 array
+});
+console.log("Name: %s, age: %d", toString(person1.name), person1.age); // Name: Dave, age: 24
+
+const person2 = PersonStructure.from(Buffer.from("526f73655a000000", "hex"));
+
+console.log("Name: %s, age: %d", toString(person2.name), person2.age); // Name: Rose, age: 90
+
+console.log(person2.data()); //  <Buffer 52 6f 73 65 5a 00 00 00>
+```
+
+4. You can create a plain object using `toJson` instance or static methods:
+
+```ts
+console.log(person2.toJson()); // { name: [ 82, 111, 115, 101 ], age: 90 }
+
+const person3 = PersonStructure.toJson(Buffer.from("4a616b655a000000", "hex"));
+
+console.log("Name: %s, age: %d", toString(person3.name), person3.age); // Name: Jake, age: 90
+```
+
+### Packing
+
+When creating a `Structure`, you can provide the argument `packed` (default is `false`):
+
+```ts
+const PacketStructure = structure<Packet>(
+  {
+    header: DataType.UINT32LE,
+    id: charDataType(6),
+    content: charDataType(64),
+  },
+  {
+    packed: true,
+  },
+);
+```
+
+When `packed` is `true`, no padding or alignment will be applied to the fields. This is really important especially for binary communications, improving performance and usage.
+
+```ts
+console.log(PersonStructure.size); // Unpacked: 8 bytes
+console.log(PersonStructure.size); // Packed: 5 bytes
+```
+
+### Strings
+
+NBSP does not store strings dynamically.
+Strings are represented as fixed-length arrays of `UINT8`. You can use `charDataType` as a shorthand:
+
+```ts
+charDataType(6); // returns [DataType.UINT8, 6]
+```
+
+This is intentional and ensures:
+
+- Deterministic payload size
+- Protocol compatibility
+- Zero dynamic allocation
+
+### Working with hex
+
+You can serialize/retrieve hex data:
+
+```ts
+interface User {
+  id: string;
+  role: number;
+} // domain Person
+
+const UserStructure = structure<User>({
+  id: charDataType(4),
+  role: DataType.UINT8,
+});
+
+const instance = new UserStructure({
+  id: toUint8Array("1a2b4c6d", true), // Transform to hex array
+  role: 2,
+});
+// HEX string length 8 -> HEX array length 4
+
+console.log(instance.name); // Prints [ 26, 43, 76, 109 ]
+console.log(toString(instance.name, true)); // "1a2b4c6d"
+```
+
+### Arrays
+
+`Arrays` are defined with a `type` and a fixed `length` of items:
+
+```ts
+interface Person {
+  name: string;
+} // domain Person
+
+const PersonStructure = structure<Person>({
+  name: charDataType(4), // [ DataType.UINT8, 4 ]
+});
+
+const person = new PersonStructure({
+  name: toUint8Array("Jake"),
+});
+```
+
+This specifies that there will be `4` items in this field, each of them of type `DataType.UINT8` (strings will always be stored as arrays of `DataType.UINT8`).
+
+### Nested Structures
+
+You can nest `Structures`:
+
+```ts
+interface DeviceConfig {
+  mode: number;
+  factor: number;
+} // domain DeviceConfig
+
+interface Device {
+  id: string;
+  config: DeviceConfig; // Provide the domain type
+} // domain Device
+
+const DeviceConfigStructure = structure<DeviceConfig>({
+  mode: DataType.UINT8,
+  factor: DataType.UINT8,
+});
+
+const DeviceStructure = structure<Device>({
+  id: charDataType(6),
+  config: DeviceConfigStructure, // Provide the structure as type
+});
+
+const instance = new DeviceStructure({
+  id: Array.from(randomBytes(6)),
+  config: {
+    // Create a plain object
+    // DO NOT use DeviceConfigStructure constructor
+    // it will cause unnecessary allocations
+    mode: 4,
+    factor: 8,
+  },
+});
+
+console.log(instance.config.factor); // Prints '8'
+```
+
+You can also store `Structures` or `Arrays` inside of `Arrays`:
+
+```ts
+interface Group {
+  people: Person[];
+} // domain Group
+
+const GroupStructure = structure<Group>({
+  people: [PersonStructure, 100],
+});
+
+const groupInstance = new GroupStructure({
+  people: [
+    // Create a plain object
+    // DO NOT use PersonStructure constructor
+    // it will cause unnecessary allocations
+    {
+      name: toUint8Array("Jack"),
+    },
+    {
+      name: toUint8Array("Rose"),
+    },
+    {
+      name: toUint8Array("Dave"),
+    },
+    ...
+  ],
+});
+
+console.log(groupInstance.people); // Array<100> [ { name: [Getter/Setter] }, ... ]
+```
+
+> **Important**
+>
+> Structures must be instantiated with plain objects when are nested, `do not` use the `Structure's constructor`; doing so will make unnecessary allocations.
+
+### Buffer and copying
+
+You can access the `buffer` of the `instance` with `data` method:
+
+```ts
+instance.data(); // Returns the internal Buffer (no copy)
+```
+
+You can reset the `buffer` of the `instance` with `reset` method:
+
+```ts
+instance.reset(); // Resets the internal Buffer (0)
+```
+
+You can `copy` the data from other `instance` or `buffer`:
+
+```ts
+instance.copy(instanceOrBuffer);
+```
+
+You can create a `new instance` of the `Structure`, copying the data `from` other `buffer` or `instance`:
+
+```ts
+const copiedInstance = PersonStructure.from(instanceOrBuffer);
+```
+
+> **Important**
+>
+> Buffers must be the same size when copying.
+>
+> Each instance has its own buffer.
+
+### JSON
+
+Instances can be converted to plain JavaScript object with all the resolved properties and nested attributes of your structure using `toJson` method:
+
+```ts
+personInstance.toJson(); // { name: [ 68, 97, 118, 101 ], age: 24 }
+```
+
+You can serialize directly to a plain JavaScript object from a buffer by using the static method `toJson`:
+
+```ts
+PersonStructure.toJson(Buffer.from("4a616b655a000000", "hex")); // { name: [ 68, 97, 118, 101 ], age: 24 }
+```
+
+> **Important**
+>
+> Strings are still represented as numeric arrays in JSON output.
+
+### Endianness
+
+`DataType` difference between `LE` and `BE` types:
+
+```ts
+structure({
+  property1: DataType.UINT32BE,
+  property2: DataType.INT64LE,
+});
+```

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { toString, toUint8Array } from "./memory.js";
+export { structure } from "./structure.js";
+export { charDataType, DataType } from "./type.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { toString, toUint8Array } from "./memory.js";
+export { structure } from "./structure.js";
+export { charDataType, DataType } from "./type.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,7 @@
+import { type AlignedData } from "./type.js";
+export declare function alloc(s: number): Buffer<ArrayBuffer>;
+export declare function read(data: AlignedData, buffer: Buffer, offset: number): number | bigint;
+export declare function write(data: AlignedData, buffer: Buffer, value: number, offset: number): void;
+export declare function toUint8Array(s: string, hex?: boolean): number[];
+export declare function toString(n: number[], hex?: boolean): string;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AA4BvD,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,uBAG9B;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,mBA2CrE;AAED,wBAAgB,KAAK,CACnB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,QA0Ff;AAyBD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,OAAe,GAAG,MAAM,EAAE,CAMtE;AACD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,OAAe,GAAG,MAAM,CAKlE"}

package/dist/memory.js

@@ -0,0 +1,195 @@
+import { DataType } from "./type.js";
+function assertInteger(value, min, max, type) {
+    if (!Number.isInteger(value)) {
+        throw new Error(`${type}: value is not an integer`);
+    }
+    if (value < min || value > max) {
+        throw new Error(`${type}: value ${value} out of range [${min}, ${max}]`);
+    }
+}
+function assertFinite(value, type) {
+    if (!Number.isFinite(value)) {
+        throw new Error(`${type}: value is not finite`);
+    }
+}
+function assertBigIntRange(value, min, max, type) {
+    if (value < min || value > max) {
+        throw new Error(`${type}: value ${value} out of range [${min}, ${max}]`);
+    }
+}
+export function alloc(s) {
+    // console.log("Alloc", s);
+    return Buffer.alloc(s);
+}
+export function read(data, buffer, offset) {
+    // console.log("read", data, offset + data.offset);
+    // if (typeof data.type === "number") {
+    switch (data.type) {
+        case DataType.INT8:
+            return buffer.readInt8(offset + data.offset);
+        case DataType.UINT8:
+            return buffer.readUInt8(offset + data.offset);
+        case DataType.INT16LE:
+            return buffer.readInt16LE(offset + data.offset);
+        case DataType.INT16BE:
+            return buffer.readInt16BE(offset + data.offset);
+        case DataType.UINT16LE:
+            return buffer.readUInt16LE(offset + data.offset);
+        case DataType.UINT16BE:
+            return buffer.readUInt16BE(offset + data.offset);
+        case DataType.INT32LE:
+            return buffer.readInt32LE(offset + data.offset);
+        case DataType.INT32BE:
+            return buffer.readInt32BE(offset + data.offset);
+        case DataType.UINT32LE:
+            return buffer.readUInt32LE(offset + data.offset);
+        case DataType.UINT32BE:
+            return buffer.readUInt32BE(offset + data.offset);
+        case DataType.INT64LE:
+            return buffer.readBigInt64LE(offset + data.offset);
+        case DataType.INT64BE:
+            return buffer.readBigInt64BE(offset + data.offset);
+        case DataType.UINT64LE:
+            return buffer.readBigUInt64LE(offset + data.offset);
+        case DataType.UINT64BE:
+            return buffer.readBigUInt64BE(offset + data.offset);
+        case DataType.FLOAT32LE:
+            return buffer.readFloatLE(offset + data.offset);
+        case DataType.FLOAT32BE:
+            return buffer.readFloatBE(offset + data.offset);
+        case DataType.FLOAT64LE:
+            return buffer.readDoubleLE(offset + data.offset);
+        case DataType.FLOAT64BE:
+            return buffer.readDoubleBE(offset + data.offset);
+        default:
+            throw new Error("Invalid type");
+    }
+}
+export function write(data, buffer, value, offset) {
+    // console.log("Write", data.offset + offset, value);
+    // if (typeof data.type === "number") {
+    //   if (Array.isArray(value) || typeof value !== "number")
+    //     throw new Error("Invalid value");
+    switch (data.type) {
+        case DataType.INT8:
+            assertInteger(value, -128, 127, "INT8");
+            buffer.writeInt8(value, offset + data.offset);
+            break;
+        case DataType.UINT8:
+            assertInteger(value, 0, 0xff, "UINT8");
+            buffer.writeUInt8(value, offset + data.offset);
+            break;
+        case DataType.INT16LE:
+            assertInteger(value, -0x8000, 0x7fff, "INT16");
+            buffer.writeInt16LE(value, offset + data.offset);
+            break;
+        case DataType.INT16BE:
+            assertInteger(value, -0x8000, 0x7fff, "INT16");
+            buffer.writeInt16BE(value, offset + data.offset);
+            break;
+        case DataType.UINT16LE:
+            assertInteger(value, 0, 0xffff, "UINT16");
+            buffer.writeUInt16LE(value, offset + data.offset);
+            break;
+        case DataType.UINT16BE:
+            assertInteger(value, 0, 0xffff, "UINT16");
+            buffer.writeUInt16BE(value, offset + data.offset);
+            break;
+        case DataType.INT32LE:
+            assertInteger(value, -0x80000000, 0x7fffffff, "INT32");
+            buffer.writeInt32LE(value, offset + data.offset);
+            break;
+        case DataType.INT32BE:
+            assertInteger(value, -0x80000000, 0x7fffffff, "INT32");
+            buffer.writeInt32BE(value, offset + data.offset);
+            break;
+        case DataType.UINT32LE:
+            assertInteger(value, 0, 0xffffffff, "UINT32");
+            buffer.writeUInt32LE(value, offset + data.offset);
+            break;
+        case DataType.UINT32BE:
+            assertInteger(value, 0, 0xffffffff, "UINT32");
+            buffer.writeUInt32BE(value, offset + data.offset);
+            break;
+        case DataType.INT64LE: {
+            const bigint = BigInt(value);
+            assertBigIntRange(bigint, -(1n << 63n), (1n << 63n) - 1n, "INT64");
+            buffer.writeBigInt64LE(bigint, offset + data.offset);
+            break;
+        }
+        case DataType.INT64BE: {
+            const bigint = BigInt(value);
+            assertBigIntRange(bigint, -(1n << 63n), (1n << 63n) - 1n, "INT64");
+            buffer.writeBigInt64BE(bigint, offset + data.offset);
+            break;
+        }
+        case DataType.UINT64LE: {
+            const bigint = BigInt(value);
+            assertBigIntRange(bigint, 0n, (1n << 64n) - 1n, "UINT64");
+            buffer.writeBigUInt64LE(bigint, offset + data.offset);
+            break;
+        }
+        case DataType.UINT64BE: {
+            const bigint = BigInt(value);
+            assertBigIntRange(bigint, 0n, (1n << 64n) - 1n, "UINT64");
+            buffer.writeBigUInt64BE(bigint, offset + data.offset);
+            break;
+        }
+        case DataType.FLOAT32LE:
+            assertFinite(value, "FLOAT32");
+            buffer.writeFloatLE(value, offset + data.offset);
+            break;
+        case DataType.FLOAT32BE:
+            assertFinite(value, "FLOAT32");
+            buffer.writeFloatBE(value, offset + data.offset);
+            break;
+        case DataType.FLOAT64LE:
+            assertFinite(value, "FLOAT64");
+            buffer.writeDoubleLE(value, offset + data.offset);
+            break;
+        case DataType.FLOAT64BE:
+            assertFinite(value, "FLOAT64");
+            buffer.writeDoubleBE(value, offset + data.offset);
+            break;
+        default:
+            throw new Error("Invalid type");
+    }
+}
+let encoder, decoder;
+function hexToBytes(hex) {
+    let bytes = [];
+    for (let c = 0; c < hex.length; c += 2)
+        bytes.push(parseInt(hex.slice(c, c + 2), 16));
+    // console.log("Hex:", hex, bytes);
+    return bytes;
+}
+function bytesToHex(bytes) {
+    let hex = [];
+    for (let i = 0; i < bytes.length; i++) {
+        const byte = bytes[i];
+        if (byte == undefined)
+            throw new Error("Invalid byte");
+        let current = byte < 0 ? byte + 256 : byte;
+        hex.push((current >>> 4).toString(16));
+        hex.push((current & 0xf).toString(16));
+    }
+    return hex.join("");
+}
+export function toUint8Array(s, hex = false) {
+    if (hex)
+        return hexToBytes(s);
+    if (!encoder)
+        encoder = new TextEncoder(); // UTF-8 por defecto
+    const bytes = encoder.encode(s);
+    // console.log("Raw", bytes);
+    return Array.from(bytes);
+}
+export function toString(n, hex = false) {
+    // console.log("String", n);
+    if (hex)
+        return bytesToHex(n);
+    if (!decoder)
+        decoder = new TextDecoder();
+    return decoder.decode(new Uint8Array(n));
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/size.d.ts

@@ -0,0 +1,4 @@
+import { type StructureConstructor } from "./structure.js";
+import { type Type } from "./type.js";
+export declare function sizeof(type: Type | StructureConstructor): number;
+//# sourceMappingURL=size.d.ts.map

package/dist/size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.d.ts","sourceRoot":"","sources":["../src/size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAgC,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAsCpE,wBAAgB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,oBAAoB,GAAG,MAAM,CAQhE"}

package/dist/size.js

@@ -0,0 +1,46 @@
+import {} from "./structure.js";
+import { DataType } from "./type.js";
+function getDataTypeSize(type) {
+    switch (type) {
+        case DataType.INT8:
+        case DataType.UINT8:
+            return 1;
+        case DataType.INT16LE:
+        case DataType.INT16BE:
+        case DataType.UINT16LE:
+        case DataType.UINT16BE:
+            return 2;
+        case DataType.INT32BE:
+        case DataType.INT32LE:
+        case DataType.UINT32LE:
+        case DataType.UINT32BE:
+            return 4;
+        case DataType.INT64LE:
+        case DataType.INT64BE:
+        case DataType.UINT64LE:
+        case DataType.UINT64BE:
+            return 8;
+        case DataType.FLOAT32LE:
+        case DataType.FLOAT32BE:
+            return 4;
+        case DataType.FLOAT64LE:
+        case DataType.FLOAT64BE:
+            return 8;
+    }
+}
+function getStructureDataSize(structure) {
+    return structure.size;
+}
+function getArrrayDataSize(type) {
+    return sizeof(type[0]) * type[1];
+}
+export function sizeof(type) {
+    return typeof type === "number"
+        ? getDataTypeSize(type)
+        : typeof type === "string"
+            ? 0
+            : Array.isArray(type)
+                ? getArrrayDataSize(type)
+                : getStructureDataSize(type);
+}
+//# sourceMappingURL=size.js.map

package/dist/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../src/size.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAiC,MAAM,WAAW,CAAC;AAEpE,SAAS,eAAe,CAAC,IAAc;IACrC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,IAAI,CAAC;QACnB,KAAK,QAAQ,CAAC,KAAK;YACjB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,OAAO,CAAC;QACtB,KAAK,QAAQ,CAAC,OAAO,CAAC;QACtB,KAAK,QAAQ,CAAC,QAAQ,CAAC;QACvB,KAAK,QAAQ,CAAC,QAAQ;YACpB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,OAAO,CAAC;QACtB,KAAK,QAAQ,CAAC,OAAO,CAAC;QACtB,KAAK,QAAQ,CAAC,QAAQ,CAAC;QACvB,KAAK,QAAQ,CAAC,QAAQ;YACpB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,OAAO,CAAC;QACtB,KAAK,QAAQ,CAAC,OAAO,CAAC;QACtB,KAAK,QAAQ,CAAC,QAAQ,CAAC;QACvB,KAAK,QAAQ,CAAC,QAAQ;YACpB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,SAAS,CAAC;QACxB,KAAK,QAAQ,CAAC,SAAS;YACrB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,SAAS,CAAC;QACxB,KAAK,QAAQ,CAAC,SAAS;YACrB,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,SAA+B;IAC3D,OAAO,SAAS,CAAC,IAAI,CAAC;AACxB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAmB;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AACD,MAAM,UAAU,MAAM,CAAC,IAAiC;IACtD,OAAO,OAAO,IAAI,KAAK,QAAQ;QAC7B,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC;QACvB,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ;YACxB,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBACnB,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;gBACzB,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/structure.d.ts

@@ -0,0 +1,50 @@
+import { type AlignedData, type BindedType, type DomainObject, type StructureDefinitionDataType, type Type } from "./type.js";
+export type StructureFields<T extends DomainObject = DomainObject> = {
+    [K in keyof Record<keyof T, Type>]: AlignedData;
+};
+export interface StructureConstructor<T extends DomainObject = DomainObject> {
+    readonly size: number;
+    readonly fields: StructureFields;
+    /**
+     * Copys the contents of the buffer. Returns a new Instance.
+     * @param buffer
+     */
+    from(buffer: Buffer): Structure<BindedType<T>>;
+    from(buffer: Structure<BindedType<T>>): Structure<BindedType<T>>;
+    toJson(buffer: Buffer): BindedType<T>;
+    new (args: BindedType<T>): Structure<BindedType<T>>;
+}
+export interface StructureMethods<T extends DomainObject> {
+    /**
+     * Copies the contents of the buffer
+     * @param buffer
+     */
+    copy(buffer: Buffer): void;
+    /**
+     * Copies the contents of the structure buffer
+     * @param buffer
+     */
+    copy(structure: Structure<T>): void;
+    /**
+     * Returns the buffer
+     */
+    data(): Buffer;
+    /**
+     * Sets the contents of the buffer to 0
+     */
+    reset(): void;
+    /**
+     * Returns a plain object with the content of the structure
+     */
+    toJson(): T;
+}
+export type Structure<T extends DomainObject> = T & StructureMethods<T>;
+export declare function alignFields<T extends Record<string, Type>>(data: T, packed?: boolean): {
+    fields: StructureFields<T>;
+    size: number;
+};
+export declare function defineProxyProperty(target: Record<string, any>, key: string, field: AlignedData, buffer: Buffer, offset?: number): void;
+export declare function structure<T extends DomainObject>(data: StructureDefinitionDataType<T>, opts?: {
+    packed?: boolean;
+}): StructureConstructor<T>;
+//# sourceMappingURL=structure.d.ts.map

package/dist/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../src/structure.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,WAAW,EAEhB,KAAK,UAAU,EAEf,KAAK,YAAY,EACjB,KAAK,2BAA2B,EAChC,KAAK,IAAI,EACV,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI;KAClE,CAAC,IAAI,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,WAAW;CAChD,CAAC;AACF,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACtC,KAAK,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,YAAY;IACtD;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACpC;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IACd;;OAEG;IACH,MAAM,IAAI,CAAC,CAAC;CACb;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,YAAY,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAKxE,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EACxD,IAAI,EAAE,CAAC,EACP,MAAM,GAAE,OAAe,GACtB;IAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAsB9C;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAU,GACjB,IAAI,CA0BN;AA8MD,wBAAgB,SAAS,CAAC,CAAC,SAAS,YAAY,EAC9C,IAAI,EAAE,2BAA2B,CAAC,CAAC,CAAC,EACpC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,oBAAoB,CAAC,CAAC,CAAC,CAsEzB"}

package/dist/structure.js

@@ -0,0 +1,228 @@
+import { alloc, read, write } from "./memory.js";
+import { sizeof } from "./size.js";
+import { DataType, isArrayDataType, isStructureDataType, } from "./type.js";
+function alignUp(n, align) {
+    return (n + align - 1) & ~(align - 1);
+}
+export function alignFields(data, packed = false) {
+    const fields = {};
+    let offset = 0;
+    let maxAlign = 1;
+    const mnames = new Set();
+    for (const [k, m] of Object.entries(data)) {
+        const size = sizeof(m);
+        if (!packed) {
+            offset = alignUp(offset, size);
+            maxAlign = Math.max(maxAlign, size);
+        }
+        fields[k] = {
+            type: m,
+            size,
+            offset,
+        };
+        offset += size;
+        if (mnames.has(k))
+            throw new Error("Duplicate name");
+        mnames.add(k);
+    }
+    const structSize = packed ? offset : alignUp(offset, maxAlign);
+    return { fields: Object.freeze(fields), size: structSize };
+}
+export function defineProxyProperty(target, key, field, buffer, offset = 0) {
+    // console.log("Define property", target, key, field);
+    const isStructField = isStructureDataType(field.type);
+    const isArrayField = isArrayDataType(field.type);
+    Object.defineProperty(target, key, {
+        get() {
+            // console.log("Get", key, field, isStructField);
+            if (isStructField)
+                return target[key];
+            else if (isArrayField)
+                return readArray(field, buffer, offset);
+            return read(field, buffer, offset);
+        },
+        set(v) {
+            // console.log("Set", key, isStructField);
+            if (isStructField)
+                return writeStructure(field, buffer, v, offset);
+            else if (isArrayField)
+                writeArray(field, v, buffer, offset);
+            else
+                write(field, buffer, v, offset);
+        },
+    });
+}
+function writeStructure(data, buffer, value, offset) {
+    // console.log("Write structure", data, offset, value);
+    for (const [k, field] of Object.entries(data.type.fields)) {
+        if (isStructureDataType(field.type)) {
+            writeStructure(field, buffer, value[k], offset + data.offset);
+        }
+        else if (Array.isArray(field.type)) {
+            writeArray(field, value[k], buffer, offset + data.offset);
+        }
+        else
+            write(field, buffer, value[k], offset + data.offset);
+    }
+}
+function writeArray(data, arr, buffer, offset) {
+    // console.log("Write array", data, offset, arr);
+    const [type, length] = data.type;
+    const isStructure = isStructureDataType(type);
+    const size = sizeof(type);
+    for (let i = 0; i < length; i++) {
+        const value = arr[i];
+        if (isStructure) {
+            writeStructure({
+                offset: i * size,
+                size: size,
+                type,
+            }, buffer, value, offset + data.offset);
+        }
+        else if (isArrayDataType(type)) {
+            writeArray({
+                type: type,
+                offset: i * sizeof(type),
+                size: size,
+            }, value, buffer, offset + data.offset);
+        }
+        else {
+            write({
+                type,
+                size: size,
+                offset: i * size,
+            }, buffer, value, offset + data.offset);
+        }
+    }
+}
+function readArray(data, buffer, offset = 0, mutable = true) {
+    // console.log("Read array", data, offset);
+    const t = [];
+    const [type, length] = data.type;
+    const size = sizeof(type);
+    const isStructure = isStructureDataType(type);
+    const isArray = isArrayDataType(type);
+    for (let i = 0; i < length; i++) {
+        if (isStructure) {
+            t.push(readStructure({
+                type,
+                offset: i * type.size,
+                size: type.size,
+            }, buffer, offset + data.offset, mutable));
+        }
+        else if (isArray) {
+            t.push(readArray({
+                type: type,
+                offset: i * size,
+                size: size,
+            }, buffer, offset + data.offset, mutable));
+        }
+        else {
+            t.push(read({
+                offset: i * size,
+                size,
+                type,
+            }, buffer, offset + data.offset));
+        }
+    }
+    return t;
+}
+function readStructure(data, buffer, offset = 0, mutable = true) {
+    // console.log("readStructure", offset);
+    const t = {};
+    for (const [k, field] of Object.entries(data.type.fields)) {
+        if (mutable)
+            defineProxyProperty(t, k, field, buffer, data.offset + offset);
+        else {
+            if (isStructureDataType(field.type)) {
+                t[k] = readStructure(field, buffer, data.offset + offset, mutable);
+                continue;
+            }
+            if (isArrayDataType(field.type)) {
+                t[k] = readArray(field, buffer, data.offset + offset, mutable);
+            }
+            else
+                t[k] = read(field, buffer, data.offset + offset);
+        }
+    }
+    return t;
+}
+function construct(target, fields, args, buffer, offset = 0, writeData = true) {
+    // console.log("Construct", target, offset);
+    for (const [k, field] of Object.entries(fields)) {
+        const arg = args[k];
+        if (writeData) {
+            if (isStructureDataType(field.type)) {
+                target[k] = {};
+                construct(target[k], field.type.fields, arg ?? {}, buffer, offset + field.offset);
+                continue;
+            }
+            if (Array.isArray(field.type)) {
+                writeArray(field, arg ?? [], buffer, offset);
+            }
+            else {
+                if (arg)
+                    write(field, buffer, arg, offset);
+            }
+        }
+        defineProxyProperty(target, k, field, buffer, offset);
+    }
+}
+export function structure(data, opts) {
+    const { fields, size } = alignFields(data, opts?.packed);
+    let writeData = true;
+    const t = class {
+        static fields = fields;
+        static size = size;
+        __buff__ = alloc(size);
+        static from(arg) {
+            writeData = false;
+            if (arg instanceof Buffer) {
+                if (arg.length !== size)
+                    throw new Error("Invalid buffer size");
+                const inst = new this({});
+                arg.copy(inst.data());
+                return inst;
+            }
+            else {
+                const inst = new this({});
+                arg.data().copy(inst.data());
+                return inst;
+            }
+        }
+        static toJson(buffer) {
+            return readStructure({
+                type: this,
+                offset: 0,
+                size,
+            }, buffer, 0, false);
+        }
+        constructor(args) {
+            construct(this, fields, args, this.__buff__, 0, writeData);
+            writeData = true;
+        }
+        copy(target) {
+            if (target instanceof Buffer) {
+                target.copy(this.__buff__);
+                return;
+            }
+            else
+                target.data().copy(this.__buff__);
+        }
+        data() {
+            return this.__buff__;
+        }
+        reset() {
+            this.__buff__.fill(0);
+        }
+        toJson() {
+            return readStructure({
+                type: t,
+                offset: 0,
+                size,
+            }, this.__buff__, 0, false);
+        }
+    };
+    return t;
+}
+//# sourceMappingURL=structure.js.map

package/dist/structure.js.map

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

package/dist/type.d.ts

@@ -0,0 +1,47 @@
+import { type StructureConstructor } from "./structure.js";
+export declare enum DataType {
+    INT8 = 0,
+    UINT8 = 1,
+    INT16LE = 2,
+    INT16BE = 3,
+    UINT16LE = 4,
+    UINT16BE = 5,
+    INT32LE = 6,
+    INT32BE = 7,
+    UINT32LE = 8,
+    UINT32BE = 9,
+    INT64LE = 10,
+    INT64BE = 11,
+    UINT64LE = 12,
+    UINT64BE = 13,
+    FLOAT32LE = 14,
+    FLOAT32BE = 15,
+    FLOAT64LE = 16,
+    FLOAT64BE = 17
+}
+export type BigIntDataType = DataType.INT64LE | DataType.INT64BE | DataType.UINT64LE | DataType.UINT64BE;
+export type NumericArrayDataType = [type: DataType, size: number];
+export type StructureArrayDataType<T extends Record<string, any>> = [
+    type: StructureConstructor<T>,
+    size: number
+];
+export type DomainObject = Record<string, any>;
+export type InferArray<T extends any> = T extends number ? NumericArrayDataType : T extends DomainObject ? StructureArrayDataType<T> : never;
+export type ArrayDataType = NumericArrayDataType | StructureArrayDataType<DomainObject>;
+export type Type<D extends DomainObject = DomainObject> = DataType | ArrayDataType | StructureConstructor<D>;
+export type DataVale = number | Array<number> | bigint | object;
+export type BindedType<T extends Record<string, any>> = {
+    [K in keyof T]: T[K] extends string ? number[] : T[K] extends DomainObject ? BindedType<T[K]> : T[K];
+};
+export type StructureDefinitionDataType<T extends DomainObject> = {
+    [K in keyof T]: T[K] extends readonly (infer P)[] ? InferArray<P> : T[K] extends number ? DataType : T[K] extends bigint ? BigIntDataType : T[K] extends string ? NumericArrayDataType : T[K] extends DomainObject ? StructureConstructor<T[K]> : never;
+};
+export interface AlignedData<T extends Type = Type> {
+    readonly type: T;
+    readonly offset: number;
+    readonly size: number;
+}
+export declare function isStructureDataType(t: Type): t is StructureConstructor;
+export declare function isArrayDataType(t: Type): t is ArrayDataType;
+export declare function charDataType(length: number): NumericArrayDataType;
+//# sourceMappingURL=type.d.ts.map

package/dist/type.d.ts.map

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

package/dist/type.js

@@ -0,0 +1,32 @@
+import {} from "./structure.js";
+export var DataType;
+(function (DataType) {
+    DataType[DataType["INT8"] = 0] = "INT8";
+    DataType[DataType["UINT8"] = 1] = "UINT8";
+    DataType[DataType["INT16LE"] = 2] = "INT16LE";
+    DataType[DataType["INT16BE"] = 3] = "INT16BE";
+    DataType[DataType["UINT16LE"] = 4] = "UINT16LE";
+    DataType[DataType["UINT16BE"] = 5] = "UINT16BE";
+    DataType[DataType["INT32LE"] = 6] = "INT32LE";
+    DataType[DataType["INT32BE"] = 7] = "INT32BE";
+    DataType[DataType["UINT32LE"] = 8] = "UINT32LE";
+    DataType[DataType["UINT32BE"] = 9] = "UINT32BE";
+    DataType[DataType["INT64LE"] = 10] = "INT64LE";
+    DataType[DataType["INT64BE"] = 11] = "INT64BE";
+    DataType[DataType["UINT64LE"] = 12] = "UINT64LE";
+    DataType[DataType["UINT64BE"] = 13] = "UINT64BE";
+    DataType[DataType["FLOAT32LE"] = 14] = "FLOAT32LE";
+    DataType[DataType["FLOAT32BE"] = 15] = "FLOAT32BE";
+    DataType[DataType["FLOAT64LE"] = 16] = "FLOAT64LE";
+    DataType[DataType["FLOAT64BE"] = 17] = "FLOAT64BE";
+})(DataType || (DataType = {}));
+export function isStructureDataType(t) {
+    return typeof t === "function";
+}
+export function isArrayDataType(t) {
+    return Array.isArray(t);
+}
+export function charDataType(length) {
+    return [DataType.UINT8, length];
+}
+//# sourceMappingURL=type.js.map

package/dist/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../src/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,MAAM,gBAAgB,CAAC;AAE3D,MAAM,CAAN,IAAY,QAmBX;AAnBD,WAAY,QAAQ;IAClB,uCAAQ,CAAA;IACR,yCAAK,CAAA;IACL,6CAAO,CAAA;IACP,6CAAO,CAAA;IACP,+CAAQ,CAAA;IACR,+CAAQ,CAAA;IACR,6CAAO,CAAA;IACP,6CAAO,CAAA;IACP,+CAAQ,CAAA;IACR,+CAAQ,CAAA;IACR,8CAAO,CAAA;IACP,8CAAO,CAAA;IACP,gDAAQ,CAAA;IACR,gDAAQ,CAAA;IACR,kDAAS,CAAA;IACT,kDAAS,CAAA;IACT,kDAAS,CAAA;IACT,kDAAS,CAAA;AACX,CAAC,EAnBW,QAAQ,KAAR,QAAQ,QAmBnB;AAqDD,MAAM,UAAU,mBAAmB,CAAC,CAAO;IACzC,OAAO,OAAO,CAAC,KAAK,UAAU,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAO;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1B,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@zzzeros0/nbsp",
+  "version": "0.1.0",
+  "description": "Zero-copy fixed-size binary structures for NodeJS TypeScript",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": ["dist"],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "binary",
+    "hex",
+    "buffer",
+    "array",
+    "json",
+    "data",
+    "raw",
+    "data-structure",
+    "data-protocol",
+    "struct",
+    "API",
+    "structure",
+    "communication",
+    "protocol",
+    "network",
+    "zero-copy",
+    "zero-copy-structure",
+    "zero-copy-protocol",
+    "zero-copy-communication",
+    "zero-copy-network",
+    "cpp",
+    "c++",
+    "arduino",
+    "esp32",
+    "mqtt",
+    "amqp",
+    "ts",
+    "typescript"
+  ],
+  "author": "zzzeros0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zzzeros0/nbsp.git"
+  },
+  "homepage": "https://github.com/zzzeros0/nbsp.git#readme",
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.9.3"
+  }
+}