tigertag 1.0.5 → 1.1.0

package/database/last_update.json

@@ -1 +1 @@
-{"versions":1763073059935,"types":1777884684291,"brands":1777885837902,"filament_diameters":1777895560487,"filament_materials":1778798861002,"aspects":1779219283884,"measure_units":1777896731691}
+{"versions":1763073059935,"types":1777884684291,"brands":1782652927786,"filament_diameters":1777895560487,"filament_materials":1781878743554,"aspects":1779219283884,"measure_units":1777896731691}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tigertag",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "JavaScript SDK for TigerTag RFID material identification",
   "main": "src/index.js",
   "bin": {
@@ -32,7 +32,7 @@
     "electron"
   ],
   "author": "TigerTag <tigertag@tigertag.io> (https://tigertag.io)",
-  "license": "GPL-3.0",
+  "license": "Apache-2.0",
   "homepage": "https://tigertag.io",
   "repository": {
     "type": "git",

package/src/db.js

@@ -1,11 +1,24 @@
 'use strict';
 
-// TigerTag RFID Guide
-// Copyright (C) 2025 TigerTag
+// SPDX-License-Identifier: Apache-2.0
 //
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License.
+// TigerTag SDK
+// Copyright (c) 2025-2026 TigerTag Corp.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// Implementing the TigerTag protocol requires no licence and no payment.
+// https://github.com/TigerTag-Project/TigerTag-RFID-Guide/blob/main/LICENSING.md
 
 /**
  * TigerTag reference database loader and sync utilities.

package/src/index.js

@@ -1,11 +1,24 @@
 'use strict';
 
-// TigerTag RFID Guide
-// Copyright (C) 2025 TigerTag
+// SPDX-License-Identifier: Apache-2.0
 //
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License.
+// TigerTag SDK
+// Copyright (c) 2025-2026 TigerTag Corp.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// Implementing the TigerTag protocol requires no licence and no payment.
+// https://github.com/TigerTag-Project/TigerTag-RFID-Guide/blob/main/LICENSING.md
 
 /**
  * tigertag — JavaScript SDK for TigerTag RFID material identification.

package/src/signature.js

@@ -1,11 +1,24 @@
 'use strict';
 
-// TigerTag RFID Guide
-// Copyright (C) 2025 TigerTag
+// SPDX-License-Identifier: Apache-2.0
 //
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License.
+// TigerTag SDK
+// Copyright (c) 2025-2026 TigerTag Corp.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// Implementing the TigerTag protocol requires no licence and no payment.
+// https://github.com/TigerTag-Project/TigerTag-RFID-Guide/blob/main/LICENSING.md
 
 /**
  * ECDSA-P256 signature verification for TigerTag chips.

package/src/tag.js

@@ -1,11 +1,24 @@
 'use strict';
 
-// TigerTag RFID Guide
-// Copyright (C) 2025 TigerTag
+// SPDX-License-Identifier: Apache-2.0
 //
-// This program is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License.
+// TigerTag SDK
+// Copyright (c) 2025-2026 TigerTag Corp.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// Implementing the TigerTag protocol requires no licence and no payment.
+// https://github.com/TigerTag-Project/TigerTag-RFID-Guide/blob/main/LICENSING.md
 
 /**
  * TigerTag class — binary parsing, serialization, CRUD, and cloud sync.
@@ -424,17 +437,17 @@ class TigerTag {
   static create({
     productId     = MAKER_PRODUCT_ID,
     uid           = null,
-    idMaterial    = 0,
-    idAspect1     = 0,
+    idMaterial    = undefined,   // required
+    idAspect1     = undefined,   // required
     idAspect2     = 0,
-    idType        = 0,
+    idType        = undefined,   // required
     idDiameter    = 0,
-    idBrand       = 0,
-    color1R       = 0, color1G = 0, color1B = 0, color1A = 255,
+    idBrand       = undefined,   // required
+    color1R       = undefined, color1G = undefined, color1B = undefined, color1A = undefined, // required
     color2R       = 0, color2G = 0, color2B = 0,
     color3R       = 0, color3G = 0, color3B = 0,
-    measure       = 0,
-    idUnit        = 0,
+    measure       = undefined,   // required
+    idUnit        = undefined,   // required
     nozzleTempMin = 0,
     nozzleTempMax = 0,
     dryTemp       = 0,
@@ -455,6 +468,24 @@ class TigerTag {
       productId  = MAKER_PRODUCT_ID;
     }
 
+    // ── Required field validation ────────────────────────────────────────────
+    // Check presence only — any value (including 0) is accepted once provided.
+    const _missing = [];
+    if (idMaterial === undefined) _missing.push('idMaterial');
+    if (idAspect1  === undefined) _missing.push('idAspect1');
+    if (idType     === undefined) _missing.push('idType');
+    if (idBrand    === undefined) _missing.push('idBrand');
+    if (measure    === undefined) _missing.push('measure');
+    if (idUnit     === undefined) _missing.push('idUnit');
+    if (color1R    === undefined) _missing.push('color1R');
+    if (color1G    === undefined) _missing.push('color1G');
+    if (color1B    === undefined) _missing.push('color1B');
+    if (color1A    === undefined) _missing.push('color1A');
+    if (_missing.length > 0) {
+      throw new Error(
+        `TigerTag.create() — missing required field(s): ${_missing.join(', ')}`
+      );
+    }
     if (timestamp == null) {
       timestamp = Math.max(0, Math.floor((Date.now() - _TIGERTAG_EPOCH_MS) / 1000));
     }
@@ -1007,7 +1038,9 @@ class TigerTag {
       };
     }
 
-    return {};
+    // Unknown unit — no conversion available; return zero base-unit fields so
+    // consumers always get a defined, safe value instead of undefined/garbage.
+    return { measure_gr: 0, measure_available_gr: 0 };
   }
 
   /**
@@ -1016,6 +1049,14 @@ class TigerTag {
    * @returns {object}
    */
   toRawDict() {
+    // Active color count: aspect2 takes priority for multi-color modes
+    // (Bicolor → 2, Tricolor/Rainbow → 3). Falls back to aspect1 (Basic → 1).
+    const _db = this.db;
+    const _a2cc = (_db.aspect(this.idAspect2) || {}).color_count || 0;
+    const _a1cc = (_db.aspect(this.idAspect1) || {}).color_count || 1;
+    const numColors = _a2cc > 0 ? _a2cc : _a1cc;
+    const colorList = [this.color1Hex, this.color2Hex, this.color3Hex].slice(0, numColors);
+
     return {
       id_tigertag:        this.idTigertag,
       id_product:         this.idProduct,
@@ -1038,16 +1079,18 @@ class TigerTag {
       bed_min:            this.bedTempMin,
       bed_max:            this.bedTempMax,
       timestamp:          this.timestamp,
-      color_r2:           this.color2R,
-      color_g2:           this.color2G,
-      color_b2:           this.color2B,
-      color_r3:           this.color3R,
-      color_g3:           this.color3G,
-      color_b3:           this.color3B,
+      color_r2:           numColors >= 2 ? this.color2R : 0,
+      color_g2:           numColors >= 2 ? this.color2G : 0,
+      color_b2:           numColors >= 2 ? this.color2B : 0,
+      color_r3:           numColors >= 3 ? this.color3R : 0,
+      color_g3:           numColors >= 3 ? this.color3G : 0,
+      color_b3:           numColors >= 3 ? this.color3B : 0,
       td_raw:             this.tdRaw,
       message:            this.customMessage,
       measure_available:  this.measureAvailable,
       ...TigerTag._baseUnitFields(this.measure, this.measureAvailable, this.idUnit),
+      num_colors:         numColors,
+      color_list:         colorList,
       uid:                this.uidHex,
       product_page_url:   this.productPageUrl,
       api_url:            this.apiUrl,

package/LICENSE.md

@@ -1,21 +0,0 @@
-# GNU General Public License v3.0
-
-TigerTag JavaScript SDK
-Copyright (C) 2025 TigerTag
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-GNU General Public License for more details.
-
-You should have received a copy of the GNU General Public License
-along with this program. If not, see <https://www.gnu.org/licenses/>.
-
----
-
-For commercial OEM licensing inquiries, contact: licensing@tigertag.io