@tracepass/gs1-utils 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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.

package/README.md

@@ -0,0 +1,53 @@
+<div align="center">
+<a href="https://www.tracepass.eu"><img src="https://www.tracepass.eu/tracepass-logo.svg" alt="TracePass" height="72"></a>
+
+# @tracepass/gs1-utils
+
+**GTIN and GLN check digits, GS1 Digital Link build and parse. Zero dependencies in the core; the optional `./qr` subpath asks for `qrcode` as a peer.**
+
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](../../LICENSE)
+[![Dependencies](https://img.shields.io/badge/core%20runtime%20deps-0-success)](#)
+
+Part of [**tracepass-open**](https://github.com/malinoto/tracepass-open) · Maintained by [TracePass](https://www.tracepass.eu)
+</div>
+
+---
+
+```bash
+npm install @tracepass/gs1-utils
+```
+
+```ts
+import { validateGtin, validateGln, buildDigitalLinkUri, parseDigitalLinkUri } from "@tracepass/gs1-utils";
+
+validateGtin("09520123456788");   // true — mod-10 check digit
+validateGtin("09520123456780");   // false
+validateGln("5012345678900");     // true — 13 digits, mod-10
+
+buildDigitalLinkUri("id.example.com", "09520123456788", "SN-1");
+// "https://id.example.com/01/09520123456788/21/SN-1"
+
+parseDigitalLinkUri("https://id.example.com/01/09520123456788/21/SN-1");
+// { gtin: "09520123456788", serialNumber: "SN-1" }
+```
+
+`buildDigitalLinkUri` takes a **bare domain** — `id.example.com`, not
+`https://id.example.com`.
+
+## QR codes are a separate subpath
+
+Rendering a QR code needs a dependency, and identifier validation doesn't. So the core
+stays dependency-free and QR lives behind its own entry point, with `qrcode` declared an
+optional peer:
+
+```bash
+npm install @tracepass/gs1-utils qrcode
+```
+
+```ts
+import { generateQrCode } from "@tracepass/gs1-utils/qr";
+```
+
+## License
+
+[Apache-2.0](../../LICENSE)

package/dist/digital-link.d.ts

@@ -0,0 +1,35 @@
+/**
+ * GS1 Digital Link URI utilities.
+ *
+ * A Digital Link URI encodes a GTIN (AI 01) and serial number (AI 21) as
+ * path segments:
+ *
+ *   https://example.com/01/<gtin>/21/<serial>
+ *
+ * See: https://www.gs1.org/standards/gs1-digital-link
+ */
+/**
+ * Build a GS1 Digital Link URI from components.
+ *
+ * @param domain  - fully qualified domain (e.g. "id.tracepass.eu")
+ * @param gtin    - 14-digit GTIN
+ * @param serialNumber - product serial number (percent-encoded if needed)
+ * @returns full URI, e.g. "https://id.tracepass.eu/01/01234567890128/21/ABC-123"
+ */
+export declare function buildDigitalLinkUri(domain: string, gtin: string, serialNumber: string): string;
+/**
+ * Parse a GS1 Digital Link URI and extract GTIN + serial number.
+ * Accepts URIs with or without scheme.
+ *
+ * @returns parsed components or null if the URI doesn't match the expected pattern
+ */
+export declare function parseDigitalLinkUri(uri: string): {
+    gtin: string;
+    serialNumber: string;
+} | null;
+/**
+ * Build the path segments array for the [...uri] catch-all route.
+ * Returns e.g. ["01", "01234567890128", "21", "ABC-123"]
+ */
+export declare function buildDigitalLinkSegments(gtin: string, serialNumber: string): string[];
+//# sourceMappingURL=digital-link.d.ts.map

package/dist/digital-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digital-link.d.ts","sourceRoot":"","sources":["../src/digital-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GACV;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAY/C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAEV"}

package/dist/digital-link.js

@@ -0,0 +1,52 @@
+/**
+ * GS1 Digital Link URI utilities.
+ *
+ * A Digital Link URI encodes a GTIN (AI 01) and serial number (AI 21) as
+ * path segments:
+ *
+ *   https://example.com/01/<gtin>/21/<serial>
+ *
+ * See: https://www.gs1.org/standards/gs1-digital-link
+ */
+/** GS1 Application Identifier for GTIN */
+const AI_GTIN = "01";
+/** GS1 Application Identifier for serial number */
+const AI_SERIAL = "21";
+/**
+ * Build a GS1 Digital Link URI from components.
+ *
+ * @param domain  - fully qualified domain (e.g. "id.tracepass.eu")
+ * @param gtin    - 14-digit GTIN
+ * @param serialNumber - product serial number (percent-encoded if needed)
+ * @returns full URI, e.g. "https://id.tracepass.eu/01/01234567890128/21/ABC-123"
+ */
+export function buildDigitalLinkUri(domain, gtin, serialNumber) {
+    const cleanDomain = domain.replace(/\/+$/, "");
+    const encodedSerial = encodeURIComponent(serialNumber);
+    return `https://${cleanDomain}/${AI_GTIN}/${gtin}/${AI_SERIAL}/${encodedSerial}`;
+}
+/**
+ * Parse a GS1 Digital Link URI and extract GTIN + serial number.
+ * Accepts URIs with or without scheme.
+ *
+ * @returns parsed components or null if the URI doesn't match the expected pattern
+ */
+export function parseDigitalLinkUri(uri) {
+    // Strip scheme + authority to get the path.
+    // Handles https://domain/01/…, http://domain/01/…, or bare path /01/…
+    const match = uri.match(/\/01\/(\d{14})\/21\/([^/?#]+)/);
+    if (!match)
+        return null;
+    return {
+        gtin: match[1],
+        serialNumber: decodeURIComponent(match[2]),
+    };
+}
+/**
+ * Build the path segments array for the [...uri] catch-all route.
+ * Returns e.g. ["01", "01234567890128", "21", "ABC-123"]
+ */
+export function buildDigitalLinkSegments(gtin, serialNumber) {
+    return [AI_GTIN, gtin, AI_SERIAL, encodeURIComponent(serialNumber)];
+}
+//# sourceMappingURL=digital-link.js.map

package/dist/digital-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digital-link.js","sourceRoot":"","sources":["../src/digital-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0CAA0C;AAC1C,MAAM,OAAO,GAAG,IAAI,CAAC;AACrB,mDAAmD;AACnD,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,IAAY,EACZ,YAAoB;IAEpB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACvD,OAAO,WAAW,WAAW,IAAI,OAAO,IAAI,IAAI,IAAI,SAAS,IAAI,aAAa,EAAE,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW;IAEX,4CAA4C;IAC5C,sEAAsE;IACtE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CACrB,+BAA+B,CAChC,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACd,YAAY,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,YAAoB;IAEpB,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/dist/gln.d.ts

@@ -0,0 +1,45 @@
+/**
+ * GS1 GLN (Global Location Number) validation and check digit calculation.
+ *
+ * A GLN is a 13-digit string where the last digit is a check digit computed
+ * using the GS1 modulo-10 algorithm (alternating ×3/×1 from the right).
+ *
+ * Where GTIN identifies a *product*, GLN identifies a *party or place* —
+ * a legal entity, a physical site, or a functional role within an organisation.
+ * GLN is the GS1 Digital Link primary key for the `/414/{gln}` resolver path,
+ * and the canonical identifier for economic operators in EU compliance contexts
+ * (Battery Regulation 2023/1542 Articles 47–50, PPWR 2025/40 Article 11, etc.).
+ *
+ * The check-digit algorithm itself is identical to GTIN's, but because the
+ * data length is even (12 digits + 1 check digit = 13) instead of odd (13 + 1
+ * for GTIN-14), the ×3/×1 weight pattern is inverted relative to GTIN: the
+ * left-most data digit gets ×1 here, where GTIN-14's left-most gets ×3.
+ */
+/**
+ * Calculate the GS1 check digit for the first 12 digits of a GLN.
+ * @param gln12 - exactly 12 numeric characters
+ * @returns the single check-digit character ("0"-"9")
+ */
+export declare function calculateCheckDigit(gln12: string): string;
+/**
+ * Validate a 13-digit GLN string.
+ * Returns true only when the string is 13 numeric characters and the check
+ * digit matches.
+ */
+export declare function validateGln(gln: string): boolean;
+/**
+ * Coerce common user-input shapes into a clean 13-digit GLN string, or null
+ * if the cleaned value isn't a valid GLN.
+ *
+ * Handles:
+ *   - leading/trailing whitespace
+ *   - "GLN:" / "GLN " prefix (case-insensitive — Battery passport datasheets
+ *     often write "GLN: 7610999999990" in body copy)
+ *   - internal whitespace (some EDI feeds emit "7610 9999 9999 0")
+ *   - hyphens used as visual separators (less common but seen)
+ *
+ * Does NOT auto-fix typos — the check digit must validate. A 13-digit string
+ * with a wrong check digit returns null, not a "corrected" GLN.
+ */
+export declare function normalizeGln(input: string): string | null;
+//# sourceMappingURL=gln.d.ts.map

package/dist/gln.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gln.d.ts","sourceRoot":"","sources":["../src/gln.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASzD"}

package/dist/gln.js

@@ -0,0 +1,74 @@
+/**
+ * GS1 GLN (Global Location Number) validation and check digit calculation.
+ *
+ * A GLN is a 13-digit string where the last digit is a check digit computed
+ * using the GS1 modulo-10 algorithm (alternating ×3/×1 from the right).
+ *
+ * Where GTIN identifies a *product*, GLN identifies a *party or place* —
+ * a legal entity, a physical site, or a functional role within an organisation.
+ * GLN is the GS1 Digital Link primary key for the `/414/{gln}` resolver path,
+ * and the canonical identifier for economic operators in EU compliance contexts
+ * (Battery Regulation 2023/1542 Articles 47–50, PPWR 2025/40 Article 11, etc.).
+ *
+ * The check-digit algorithm itself is identical to GTIN's, but because the
+ * data length is even (12 digits + 1 check digit = 13) instead of odd (13 + 1
+ * for GTIN-14), the ×3/×1 weight pattern is inverted relative to GTIN: the
+ * left-most data digit gets ×1 here, where GTIN-14's left-most gets ×3.
+ */
+/**
+ * Calculate the GS1 check digit for the first 12 digits of a GLN.
+ * @param gln12 - exactly 12 numeric characters
+ * @returns the single check-digit character ("0"-"9")
+ */
+export function calculateCheckDigit(gln12) {
+    if (!/^\d{12}$/.test(gln12)) {
+        throw new Error("calculateCheckDigit expects exactly 12 digits");
+    }
+    let sum = 0;
+    for (let i = 0; i < 12; i++) {
+        const digit = Number(gln12[i]);
+        // Counted from the right, the rightmost data digit gets ×3, next ×1, etc.
+        // For 12 input digits the parity flips relative to GTIN-14: position 0
+        // (left-most) is at distance 11 from the right (odd) → ×1; position 1
+        // is at distance 10 (even) → ×3.
+        sum += i % 2 === 0 ? digit * 1 : digit * 3;
+    }
+    const remainder = sum % 10;
+    return remainder === 0 ? "0" : String(10 - remainder);
+}
+/**
+ * Validate a 13-digit GLN string.
+ * Returns true only when the string is 13 numeric characters and the check
+ * digit matches.
+ */
+export function validateGln(gln) {
+    if (!/^\d{13}$/.test(gln)) {
+        return false;
+    }
+    const expected = calculateCheckDigit(gln.slice(0, 12));
+    return gln[12] === expected;
+}
+/**
+ * Coerce common user-input shapes into a clean 13-digit GLN string, or null
+ * if the cleaned value isn't a valid GLN.
+ *
+ * Handles:
+ *   - leading/trailing whitespace
+ *   - "GLN:" / "GLN " prefix (case-insensitive — Battery passport datasheets
+ *     often write "GLN: 7610999999990" in body copy)
+ *   - internal whitespace (some EDI feeds emit "7610 9999 9999 0")
+ *   - hyphens used as visual separators (less common but seen)
+ *
+ * Does NOT auto-fix typos — the check digit must validate. A 13-digit string
+ * with a wrong check digit returns null, not a "corrected" GLN.
+ */
+export function normalizeGln(input) {
+    if (typeof input !== "string")
+        return null;
+    const cleaned = input
+        .trim()
+        .replace(/^gln[:\s]+/i, "") // strip leading "GLN:" / "GLN " prefix
+        .replace(/[\s-]/g, ""); // strip whitespace + hyphens
+    return validateGln(cleaned) ? cleaned : null;
+}
+//# sourceMappingURL=gln.js.map

package/dist/gln.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gln.js","sourceRoot":"","sources":["../src/gln.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,0EAA0E;QAC1E,uEAAuE;QACvE,sEAAsE;QACtE,iCAAiC;QACjC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,GAAG,EAAE,CAAC;IAC3B,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3C,MAAM,OAAO,GAAG,KAAK;SAClB,IAAI,EAAE;SACN,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,uCAAuC;SAClE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAM,6BAA6B;IAE5D,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC"}

package/dist/gtin.d.ts

@@ -0,0 +1,19 @@
+/**
+ * GS1 GTIN validation and check digit calculation.
+ *
+ * A GTIN-14 is a 14-digit string. The last digit is a check digit computed
+ * using the GS1 modulo-10 algorithm (alternating ×3/×1 from the right).
+ */
+/**
+ * Calculate the GS1 check digit for the first 13 digits of a GTIN-14.
+ * @param gtin13 - exactly 13 numeric characters
+ * @returns the single check-digit character ("0"-"9")
+ */
+export declare function calculateCheckDigit(gtin13: string): string;
+/**
+ * Validate a 14-digit GTIN string (GTIN-14).
+ * Returns true only when the string is 14 numeric characters and the check
+ * digit matches.
+ */
+export declare function validateGtin(gtin: string): boolean;
+//# sourceMappingURL=gtin.d.ts.map

package/dist/gtin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtin.d.ts","sourceRoot":"","sources":["../src/gtin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAe1D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOlD"}

package/dist/gtin.js

@@ -0,0 +1,38 @@
+/**
+ * GS1 GTIN validation and check digit calculation.
+ *
+ * A GTIN-14 is a 14-digit string. The last digit is a check digit computed
+ * using the GS1 modulo-10 algorithm (alternating ×3/×1 from the right).
+ */
+/**
+ * Calculate the GS1 check digit for the first 13 digits of a GTIN-14.
+ * @param gtin13 - exactly 13 numeric characters
+ * @returns the single check-digit character ("0"-"9")
+ */
+export function calculateCheckDigit(gtin13) {
+    if (!/^\d{13}$/.test(gtin13)) {
+        throw new Error("calculateCheckDigit expects exactly 13 digits");
+    }
+    let sum = 0;
+    for (let i = 0; i < 13; i++) {
+        const digit = Number(gtin13[i]);
+        // positions 0,2,4,… get ×3; positions 1,3,5,… get ×1 (from left,
+        // for a 14-digit number the even-indexed positions are multiplied by 3)
+        sum += i % 2 === 0 ? digit * 3 : digit * 1;
+    }
+    const remainder = sum % 10;
+    return remainder === 0 ? "0" : String(10 - remainder);
+}
+/**
+ * Validate a 14-digit GTIN string (GTIN-14).
+ * Returns true only when the string is 14 numeric characters and the check
+ * digit matches.
+ */
+export function validateGtin(gtin) {
+    if (!/^\d{14}$/.test(gtin)) {
+        return false;
+    }
+    const expected = calculateCheckDigit(gtin.slice(0, 13));
+    return gtin[13] === expected;
+}
+//# sourceMappingURL=gtin.js.map

package/dist/gtin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtin.js","sourceRoot":"","sources":["../src/gtin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,iEAAiE;QACjE,wEAAwE;QACxE,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,GAAG,EAAE,CAAC;IAC3B,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAC;AAC/B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * GS1 identifier utilities — GTIN, GLN, and Digital Link.
+ *
+ * Zero dependencies. QR-code rendering lives at the `@tracepass/gs1-utils/qr`
+ * subpath so the core stays dependency-free.
+ */
+export { buildDigitalLinkUri, parseDigitalLinkUri, buildDigitalLinkSegments, } from "./digital-link.js";
+export { validateGln, normalizeGln, calculateCheckDigit as calculateGlnCheckDigit, } from "./gln.js";
+export { validateGtin, calculateCheckDigit as calculateGtinCheckDigit, } from "./gtin.js";
+export { parseAcceptLanguage, detectLanguage } from "./language.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;;;;;GAKG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,IAAI,sBAAsB,GAC9C,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,YAAY,EACZ,mBAAmB,IAAI,uBAAuB,GAC/C,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * GS1 identifier utilities — GTIN, GLN, and Digital Link.
+ *
+ * Zero dependencies. QR-code rendering lives at the `@tracepass/gs1-utils/qr`
+ * subpath so the core stays dependency-free.
+ */
+export { buildDigitalLinkUri, parseDigitalLinkUri, buildDigitalLinkSegments, } from "./digital-link.js";
+// `calculateCheckDigit` exists in both gln.ts and gtin.ts with the same mod-10
+// algorithm but different length rules, so each is re-exported under its own
+// name rather than colliding at the barrel.
+export { validateGln, normalizeGln, calculateCheckDigit as calculateGlnCheckDigit, } from "./gln.js";
+export { validateGtin, calculateCheckDigit as calculateGtinCheckDigit, } from "./gtin.js";
+export { parseAcceptLanguage, detectLanguage } from "./language.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;;;;;GAKG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,6EAA6E;AAC7E,4CAA4C;AAC5C,OAAO,EACL,WAAW,EACX,YAAY,EACZ,mBAAmB,IAAI,sBAAsB,GAC9C,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,YAAY,EACZ,mBAAmB,IAAI,uBAAuB,GAC/C,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/language.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Language detection utilities for the public passport viewer.
+ */
+/**
+ * Parse an Accept-Language header into a sorted array of language codes.
+ *
+ * Example: "en-US,en;q=0.9,de;q=0.7" → ["en-US", "en", "de"]
+ */
+export declare function parseAcceptLanguage(header: string): string[];
+/**
+ * Detect the best language for the passport viewer.
+ *
+ * Priority:
+ * 1. ?lang= query parameter
+ * 2. Accept-Language header (highest quality factor)
+ * 3. Fallback to "en"
+ *
+ * Returns a 2-letter ISO 639-1 code (e.g. "en", "de", "fr").
+ */
+export declare function detectLanguage(request: Request): string;
+//# sourceMappingURL=language.d.ts.map

package/dist/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../src/language.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAa5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAkBvD"}

package/dist/language.js

@@ -0,0 +1,49 @@
+/**
+ * Language detection utilities for the public passport viewer.
+ */
+/**
+ * Parse an Accept-Language header into a sorted array of language codes.
+ *
+ * Example: "en-US,en;q=0.9,de;q=0.7" → ["en-US", "en", "de"]
+ */
+export function parseAcceptLanguage(header) {
+    if (!header)
+        return [];
+    return header
+        .split(",")
+        .map((part) => {
+        const [lang, qPart] = part.trim().split(";");
+        const q = qPart ? parseFloat(qPart.replace(/^\s*q\s*=\s*/, "")) : 1;
+        return { lang: lang.trim(), q: isNaN(q) ? 0 : q };
+    })
+        .sort((a, b) => b.q - a.q)
+        .map((entry) => entry.lang)
+        .filter(Boolean);
+}
+/**
+ * Detect the best language for the passport viewer.
+ *
+ * Priority:
+ * 1. ?lang= query parameter
+ * 2. Accept-Language header (highest quality factor)
+ * 3. Fallback to "en"
+ *
+ * Returns a 2-letter ISO 639-1 code (e.g. "en", "de", "fr").
+ */
+export function detectLanguage(request) {
+    const url = new URL(request.url);
+    const langParam = url.searchParams.get("lang");
+    if (langParam && /^[a-z]{2}(-[A-Z]{2})?$/.test(langParam)) {
+        return langParam.split("-")[0];
+    }
+    const acceptLanguage = request.headers.get("accept-language");
+    if (acceptLanguage) {
+        const langs = parseAcceptLanguage(acceptLanguage);
+        if (langs.length > 0) {
+            // Return just the 2-letter code
+            return langs[0].split("-")[0].toLowerCase();
+        }
+    }
+    return "en";
+}
+//# sourceMappingURL=language.js.map

package/dist/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../src/language.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,OAAO,MAAM;SACV,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACzB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,SAAS,IAAI,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC9D,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,gCAAgC;YAChC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/qr.d.ts

@@ -0,0 +1,19 @@
+/**
+ * QR code generation for GS1 Digital Link URIs.
+ *
+ * Uppercases the scheme + domain portion so the QR encoder can use
+ * alphanumeric mode for those characters, producing a smaller (denser) code.
+ */
+/**
+ * Generate a QR code PNG buffer for the given URI.
+ *
+ * - Error correction level M (15 % recovery)
+ * - Margin: 4 modules
+ * - Width: 300 px
+ * - Scheme + domain uppercased for smaller QR
+ *
+ * @param uri - full GS1 Digital Link URI
+ * @returns PNG image as a Node.js Buffer
+ */
+export declare function generateQrCode(uri: string): Promise<Buffer>;
+//# sourceMappingURL=qr.d.ts.map

package/dist/qr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.d.ts","sourceRoot":"","sources":["../src/qr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWjE"}

package/dist/qr.js

@@ -0,0 +1,47 @@
+/**
+ * QR code generation for GS1 Digital Link URIs.
+ *
+ * Uppercases the scheme + domain portion so the QR encoder can use
+ * alphanumeric mode for those characters, producing a smaller (denser) code.
+ */
+import QRCode from "qrcode";
+/**
+ * Uppercase the scheme and domain of a URI to allow QR alphanumeric encoding.
+ * e.g. "https://id.tracepass.eu/01/…" → "HTTPS://ID.TRACEPASS.EU/01/…"
+ *
+ * Only the scheme + authority are uppercased; the path is left as-is because
+ * serial numbers may be case-sensitive.
+ */
+function uppercaseSchemeAndDomain(uri) {
+    try {
+        const url = new URL(uri);
+        const schemePlusDomain = `${url.protocol}//${url.host}`;
+        return uri.replace(schemePlusDomain, schemePlusDomain.toUpperCase());
+    }
+    catch {
+        // If not a valid URL, return as-is
+        return uri;
+    }
+}
+/**
+ * Generate a QR code PNG buffer for the given URI.
+ *
+ * - Error correction level M (15 % recovery)
+ * - Margin: 4 modules
+ * - Width: 300 px
+ * - Scheme + domain uppercased for smaller QR
+ *
+ * @param uri - full GS1 Digital Link URI
+ * @returns PNG image as a Node.js Buffer
+ */
+export async function generateQrCode(uri) {
+    const optimizedUri = uppercaseSchemeAndDomain(uri);
+    const buffer = await QRCode.toBuffer(optimizedUri, {
+        errorCorrectionLevel: "M",
+        margin: 4,
+        width: 300,
+        type: "png",
+    });
+    return buffer;
+}
+//# sourceMappingURL=qr.js.map

package/dist/qr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.js","sourceRoot":"","sources":["../src/qr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B;;;;;;GAMG;AACH,SAAS,wBAAwB,CAAC,GAAW;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,gBAAgB,GAAG,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;QACxD,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;QACnC,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,YAAY,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE;QACjD,oBAAoB,EAAE,GAAG;QACzB,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@tracepass/gs1-utils",
+  "version": "0.1.0",
+  "description": "GS1 identifier utilities for Digital Product Passports — GTIN and GLN check-digit validation, GS1 Digital Link URI build/parse. Zero dependencies in the core; the optional QR subpath asks for qrcode as a peer.",
+  "keywords": ["gs1", "gtin", "gln", "digital-link", "digital-product-passport", "dpp", "barcode"],
+  "license": "Apache-2.0",
+  "author": "TracePass LTD (https://tracepass.eu)",
+  "homepage": "https://github.com/malinoto/tracepass-open/tree/main/packages/gs1-utils#readme",
+  "repository": { "type": "git", "url": "git+https://github.com/malinoto/tracepass-open.git", "directory": "packages/gs1-utils" },
+  "bugs": "https://github.com/malinoto/tracepass-open/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
+    "./qr": { "types": "./dist/qr.d.ts", "import": "./dist/qr.js" }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "sideEffects": false,
+  "publishConfig": { "access": "public" },
+  "scripts": { "build": "tsc -p tsconfig.build.json", "clean": "rm -rf dist" },
+  "peerDependencies": { "qrcode": "^1.5.0" },
+  "peerDependenciesMeta": { "qrcode": { "optional": true } },
+  "devDependencies": { "typescript": "^5.6.3", "qrcode": "^1.5.4", "@types/qrcode": "^1.5.5" },
+  "engines": { "node": ">=18" }
+}