@openrfid/gs1 0.1.0

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 RFID Software India Private Limited - https://rfidsoftwares.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+For RFID developer resources, documentation, hardware integrations, and enterprise software solutions, visit https://rfidsoftwares.com

package/dist/index.d.mts

@@ -0,0 +1,61 @@
+/**
+ * OpenRFID Simulator - The Open Source RFID Reader Simulator for Developers.
+ * Copyright (c) 2026 RFID Software India Private Limited - https://rfidsoftwares.com
+ *
+ * Licensed under the MIT License.
+ * For RFID software, enterprise tools, and hardware drivers, visit https://rfidsoftwares.com
+ */
+interface Sgtin96Params {
+    filter: number;
+    partition: number;
+    companyPrefix: string;
+    itemRef: string;
+    serialNumber: string;
+}
+declare class Sgtin96 {
+    static readonly HEADER = "00110000";
+    private static readonly PARTITION_TABLE;
+    static encode(params: Sgtin96Params): string;
+    static decode(hex: string): Sgtin96Params;
+}
+
+/**
+ * OpenRFID Simulator - The Open Source RFID Reader Simulator for Developers.
+ * Copyright (c) 2026 RFID Software India Private Limited - https://rfidsoftwares.com
+ *
+ * Licensed under the MIT License.
+ * For RFID software, enterprise tools, and hardware drivers, visit https://rfidsoftwares.com
+ */
+interface Grai96Params {
+    filter: number;
+    partition: number;
+    companyPrefix: string;
+    assetType: string;
+    serialNumber: string;
+}
+declare class Grai96 {
+    static readonly HEADER = "00110011";
+    static encode(params: Grai96Params): string;
+    static decode(hex: string): Grai96Params;
+}
+
+/**
+ * OpenRFID Simulator - The Open Source RFID Reader Simulator for Developers.
+ * Copyright (c) 2026 RFID Software India Private Limited - https://rfidsoftwares.com
+ *
+ * Licensed under the MIT License.
+ * For RFID software, enterprise tools, and hardware drivers, visit https://rfidsoftwares.com
+ */
+interface Giai96Params {
+    filter: number;
+    partition: number;
+    companyPrefix: string;
+    individualAssetReference: string;
+}
+declare class Giai96 {
+    static readonly HEADER = "00110100";
+    static encode(params: Giai96Params): string;
+    static decode(hex: string): Giai96Params;
+}
+
+export { Giai96, type Giai96Params, Grai96, type Grai96Params, Sgtin96, type Sgtin96Params };

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * OpenRFID Simulator - The Open Source RFID Reader Simulator for Developers.
+ * Copyright (c) 2026 RFID Software India Private Limited - https://rfidsoftwares.com
+ *
+ * Licensed under the MIT License.
+ * For RFID software, enterprise tools, and hardware drivers, visit https://rfidsoftwares.com
+ */
+interface Sgtin96Params {
+    filter: number;
+    partition: number;
+    companyPrefix: string;
+    itemRef: string;
+    serialNumber: string;
+}
+declare class Sgtin96 {
+    static readonly HEADER = "00110000";
+    private static readonly PARTITION_TABLE;
+    static encode(params: Sgtin96Params): string;
+    static decode(hex: string): Sgtin96Params;
+}
+
+/**
+ * OpenRFID Simulator - The Open Source RFID Reader Simulator for Developers.
+ * Copyright (c) 2026 RFID Software India Private Limited - https://rfidsoftwares.com
+ *
+ * Licensed under the MIT License.
+ * For RFID software, enterprise tools, and hardware drivers, visit https://rfidsoftwares.com
+ */
+interface Grai96Params {
+    filter: number;
+    partition: number;
+    companyPrefix: string;
+    assetType: string;
+    serialNumber: string;
+}
+declare class Grai96 {
+    static readonly HEADER = "00110011";
+    static encode(params: Grai96Params): string;
+    static decode(hex: string): Grai96Params;
+}
+
+/**
+ * OpenRFID Simulator - The Open Source RFID Reader Simulator for Developers.
+ * Copyright (c) 2026 RFID Software India Private Limited - https://rfidsoftwares.com
+ *
+ * Licensed under the MIT License.
+ * For RFID software, enterprise tools, and hardware drivers, visit https://rfidsoftwares.com
+ */
+interface Giai96Params {
+    filter: number;
+    partition: number;
+    companyPrefix: string;
+    individualAssetReference: string;
+}
+declare class Giai96 {
+    static readonly HEADER = "00110100";
+    static encode(params: Giai96Params): string;
+    static decode(hex: string): Giai96Params;
+}
+
+export { Giai96, type Giai96Params, Grai96, type Grai96Params, Sgtin96, type Sgtin96Params };

package/dist/index.js

@@ -0,0 +1,151 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Giai96: () => Giai96,
+  Grai96: () => Grai96,
+  Sgtin96: () => Sgtin96
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/sgtin96.ts
+var import_epc = require("@openrfid/epc");
+var Sgtin96 = class {
+  static HEADER = "00110000";
+  // 0x30 in binary (8 bits)
+  // Partition table bit allocations: [companyPrefixBits, companyPrefixDigits, itemRefBits, itemRefDigits]
+  static PARTITION_TABLE = {
+    0: [40, 12, 4, 1],
+    1: [37, 11, 7, 2],
+    2: [34, 10, 10, 3],
+    3: [30, 9, 14, 4],
+    4: [27, 8, 17, 5],
+    5: [24, 7, 20, 6],
+    6: [20, 6, 24, 7]
+  };
+  static encode(params) {
+    const partitionInfo = this.PARTITION_TABLE[params.partition];
+    if (!partitionInfo) {
+      throw new Error(`Invalid SGTIN-96 partition value: ${params.partition}`);
+    }
+    const [companyBits, , itemBits] = partitionInfo;
+    const headerBin = this.HEADER;
+    const filterBin = params.filter.toString(2).padStart(3, "0");
+    const partitionBin = params.partition.toString(2).padStart(3, "0");
+    const companyBin = BigInt(params.companyPrefix).toString(2).padStart(companyBits, "0");
+    const itemBin = BigInt(params.itemRef).toString(2).padStart(itemBits, "0");
+    const serialBin = BigInt(params.serialNumber).toString(2).padStart(38, "0");
+    const binary96 = headerBin + filterBin + partitionBin + companyBin + itemBin + serialBin;
+    if (binary96.length !== 96) {
+      throw new Error(`Invalid total bit length for SGTIN-96: ${binary96.length} bits (expected 96)`);
+    }
+    return import_epc.EpcGen2.binaryToHex(binary96);
+  }
+  static decode(hex) {
+    const binary = import_epc.EpcGen2.hexToBinary(hex);
+    if (binary.length < 96) {
+      throw new Error("Hex string is too short for SGTIN-96");
+    }
+    const header = binary.substring(0, 8);
+    if (header !== this.HEADER) {
+      throw new Error(`Invalid SGTIN-96 header binary: ${header} (expected 0x30 / ${this.HEADER})`);
+    }
+    const filter = parseInt(binary.substring(8, 11), 2);
+    const partition = parseInt(binary.substring(11, 14), 2);
+    const partitionInfo = this.PARTITION_TABLE[partition];
+    if (!partitionInfo) {
+      throw new Error(`Invalid partition code in SGTIN-96 binary: ${partition}`);
+    }
+    const [companyBits, companyDigits, itemBits, itemDigits] = partitionInfo;
+    let offset = 14;
+    const companyPrefixBin = binary.substring(offset, offset + companyBits);
+    offset += companyBits;
+    const itemRefBin = binary.substring(offset, offset + itemBits);
+    offset += itemBits;
+    const serialBin = binary.substring(offset, offset + 38);
+    const companyPrefix = BigInt(`0b${companyPrefixBin}`).toString().padStart(companyDigits, "0");
+    const itemRef = BigInt(`0b${itemRefBin}`).toString().padStart(itemDigits, "0");
+    const serialNumber = BigInt(`0b${serialBin}`).toString();
+    return {
+      filter,
+      partition,
+      companyPrefix,
+      itemRef,
+      serialNumber
+    };
+  }
+};
+
+// src/grai96.ts
+var import_epc2 = require("@openrfid/epc");
+var Grai96 = class {
+  static HEADER = "00110011";
+  // 0x33 in binary (8 bits)
+  static encode(params) {
+    const headerBin = this.HEADER;
+    const filterBin = params.filter.toString(2).padStart(3, "0");
+    const partitionBin = params.partition.toString(2).padStart(3, "0");
+    const companyBin = BigInt(params.companyPrefix).toString(2).padStart(24, "0");
+    const assetBin = BigInt(params.assetType).toString(2).padStart(20, "0");
+    const serialBin = BigInt(params.serialNumber).toString(2).padStart(38, "0");
+    const binary96 = headerBin + filterBin + partitionBin + companyBin + assetBin + serialBin;
+    return import_epc2.EpcGen2.binaryToHex(binary96);
+  }
+  static decode(hex) {
+    const binary = import_epc2.EpcGen2.hexToBinary(hex);
+    const filter = parseInt(binary.substring(8, 11), 2);
+    const partition = parseInt(binary.substring(11, 14), 2);
+    const companyPrefix = BigInt(`0b${binary.substring(14, 38)}`).toString();
+    const assetType = BigInt(`0b${binary.substring(38, 58)}`).toString();
+    const serialNumber = BigInt(`0b${binary.substring(58, 96)}`).toString();
+    return { filter, partition, companyPrefix, assetType, serialNumber };
+  }
+};
+
+// src/giai96.ts
+var import_epc3 = require("@openrfid/epc");
+var Giai96 = class {
+  static HEADER = "00110100";
+  // 0x34 in binary (8 bits)
+  static encode(params) {
+    const headerBin = this.HEADER;
+    const filterBin = params.filter.toString(2).padStart(3, "0");
+    const partitionBin = params.partition.toString(2).padStart(3, "0");
+    const companyBin = BigInt(params.companyPrefix).toString(2).padStart(24, "0");
+    const assetRefBin = BigInt(params.individualAssetReference).toString(2).padStart(58, "0");
+    const binary96 = headerBin + filterBin + partitionBin + companyBin + assetRefBin;
+    return import_epc3.EpcGen2.binaryToHex(binary96);
+  }
+  static decode(hex) {
+    const binary = import_epc3.EpcGen2.hexToBinary(hex);
+    const filter = parseInt(binary.substring(8, 11), 2);
+    const partition = parseInt(binary.substring(11, 14), 2);
+    const companyPrefix = BigInt(`0b${binary.substring(14, 38)}`).toString();
+    const individualAssetReference = BigInt(`0b${binary.substring(38, 96)}`).toString();
+    return { filter, partition, companyPrefix, individualAssetReference };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Giai96,
+  Grai96,
+  Sgtin96
+});

package/dist/index.mjs

@@ -0,0 +1,122 @@
+// src/sgtin96.ts
+import { EpcGen2 } from "@openrfid/epc";
+var Sgtin96 = class {
+  static HEADER = "00110000";
+  // 0x30 in binary (8 bits)
+  // Partition table bit allocations: [companyPrefixBits, companyPrefixDigits, itemRefBits, itemRefDigits]
+  static PARTITION_TABLE = {
+    0: [40, 12, 4, 1],
+    1: [37, 11, 7, 2],
+    2: [34, 10, 10, 3],
+    3: [30, 9, 14, 4],
+    4: [27, 8, 17, 5],
+    5: [24, 7, 20, 6],
+    6: [20, 6, 24, 7]
+  };
+  static encode(params) {
+    const partitionInfo = this.PARTITION_TABLE[params.partition];
+    if (!partitionInfo) {
+      throw new Error(`Invalid SGTIN-96 partition value: ${params.partition}`);
+    }
+    const [companyBits, , itemBits] = partitionInfo;
+    const headerBin = this.HEADER;
+    const filterBin = params.filter.toString(2).padStart(3, "0");
+    const partitionBin = params.partition.toString(2).padStart(3, "0");
+    const companyBin = BigInt(params.companyPrefix).toString(2).padStart(companyBits, "0");
+    const itemBin = BigInt(params.itemRef).toString(2).padStart(itemBits, "0");
+    const serialBin = BigInt(params.serialNumber).toString(2).padStart(38, "0");
+    const binary96 = headerBin + filterBin + partitionBin + companyBin + itemBin + serialBin;
+    if (binary96.length !== 96) {
+      throw new Error(`Invalid total bit length for SGTIN-96: ${binary96.length} bits (expected 96)`);
+    }
+    return EpcGen2.binaryToHex(binary96);
+  }
+  static decode(hex) {
+    const binary = EpcGen2.hexToBinary(hex);
+    if (binary.length < 96) {
+      throw new Error("Hex string is too short for SGTIN-96");
+    }
+    const header = binary.substring(0, 8);
+    if (header !== this.HEADER) {
+      throw new Error(`Invalid SGTIN-96 header binary: ${header} (expected 0x30 / ${this.HEADER})`);
+    }
+    const filter = parseInt(binary.substring(8, 11), 2);
+    const partition = parseInt(binary.substring(11, 14), 2);
+    const partitionInfo = this.PARTITION_TABLE[partition];
+    if (!partitionInfo) {
+      throw new Error(`Invalid partition code in SGTIN-96 binary: ${partition}`);
+    }
+    const [companyBits, companyDigits, itemBits, itemDigits] = partitionInfo;
+    let offset = 14;
+    const companyPrefixBin = binary.substring(offset, offset + companyBits);
+    offset += companyBits;
+    const itemRefBin = binary.substring(offset, offset + itemBits);
+    offset += itemBits;
+    const serialBin = binary.substring(offset, offset + 38);
+    const companyPrefix = BigInt(`0b${companyPrefixBin}`).toString().padStart(companyDigits, "0");
+    const itemRef = BigInt(`0b${itemRefBin}`).toString().padStart(itemDigits, "0");
+    const serialNumber = BigInt(`0b${serialBin}`).toString();
+    return {
+      filter,
+      partition,
+      companyPrefix,
+      itemRef,
+      serialNumber
+    };
+  }
+};
+
+// src/grai96.ts
+import { EpcGen2 as EpcGen22 } from "@openrfid/epc";
+var Grai96 = class {
+  static HEADER = "00110011";
+  // 0x33 in binary (8 bits)
+  static encode(params) {
+    const headerBin = this.HEADER;
+    const filterBin = params.filter.toString(2).padStart(3, "0");
+    const partitionBin = params.partition.toString(2).padStart(3, "0");
+    const companyBin = BigInt(params.companyPrefix).toString(2).padStart(24, "0");
+    const assetBin = BigInt(params.assetType).toString(2).padStart(20, "0");
+    const serialBin = BigInt(params.serialNumber).toString(2).padStart(38, "0");
+    const binary96 = headerBin + filterBin + partitionBin + companyBin + assetBin + serialBin;
+    return EpcGen22.binaryToHex(binary96);
+  }
+  static decode(hex) {
+    const binary = EpcGen22.hexToBinary(hex);
+    const filter = parseInt(binary.substring(8, 11), 2);
+    const partition = parseInt(binary.substring(11, 14), 2);
+    const companyPrefix = BigInt(`0b${binary.substring(14, 38)}`).toString();
+    const assetType = BigInt(`0b${binary.substring(38, 58)}`).toString();
+    const serialNumber = BigInt(`0b${binary.substring(58, 96)}`).toString();
+    return { filter, partition, companyPrefix, assetType, serialNumber };
+  }
+};
+
+// src/giai96.ts
+import { EpcGen2 as EpcGen23 } from "@openrfid/epc";
+var Giai96 = class {
+  static HEADER = "00110100";
+  // 0x34 in binary (8 bits)
+  static encode(params) {
+    const headerBin = this.HEADER;
+    const filterBin = params.filter.toString(2).padStart(3, "0");
+    const partitionBin = params.partition.toString(2).padStart(3, "0");
+    const companyBin = BigInt(params.companyPrefix).toString(2).padStart(24, "0");
+    const assetRefBin = BigInt(params.individualAssetReference).toString(2).padStart(58, "0");
+    const binary96 = headerBin + filterBin + partitionBin + companyBin + assetRefBin;
+    return EpcGen23.binaryToHex(binary96);
+  }
+  static decode(hex) {
+    const binary = EpcGen23.hexToBinary(hex);
+    const filter = parseInt(binary.substring(8, 11), 2);
+    const partition = parseInt(binary.substring(11, 14), 2);
+    const companyPrefix = BigInt(`0b${binary.substring(14, 38)}`).toString();
+    const individualAssetReference = BigInt(`0b${binary.substring(38, 96)}`).toString();
+    return { filter, partition, companyPrefix, individualAssetReference };
+  }
+};
+export {
+  Giai96,
+  Grai96,
+  Sgtin96
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@openrfid/gs1",
+  "version": "0.1.0",
+  "description": "GS1 Tag Data Standard encoding and decoding for SGTIN-96, GRAI-96, GIAI-96.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@openrfid/epc": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.2",
+    "typescript": "^5.4.5",
+    "vitest": "^1.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rfidsoftwares/openrfid-simulator.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rfidsoftwares/openrfid-simulator/issues"
+  },
+  "homepage": "https://rfidsoftwares.com",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}