@tracepass/dpp-identifiers 0.9.0

package/dist/product.js.map

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

package/dist/uri.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Identifier URI construction and parsing for the EN 18219 resolver path.
+ *
+ * identifierToUri   — build a resolver URL from any ProductIdentifier.
+ *   gs1     → Digital Link path `/01/<gtin14>/21/<encoded-serial>`
+ *   iso15459 → `/<agency>/<encoded-primaryId>[/<encoded-serial>]`
+ *   iec61406 / did / doi → null (they carry their own canonical URL)
+ *
+ * identifierOwnUrl  — the identifier's own URL form, when it has one.
+ *   iec61406 → the Identification Link uri
+ *   doi      → `https://doi.org/<doi>`
+ *   did      → null (resolution is method-specific; the DID itself is not a URL)
+ *   gs1/iso15459 → null (no URL intrinsic to the identifier; use identifierToUri)
+ *
+ * parseResolverPath — inverse of identifierToUri, for gs1 and iso15459 only.
+ *   Leading digits in the first path segment → GS1 AI path (AI 01 + AI 21).
+ *   A 1–3 char uppercase `[A-Z][A-Z0-9]{0,2}` first segment → ISO/IEC 15459 agency.
+ *   Otherwise → null (e.g. "/about/team", "/api/v1", lowercase-agency paths).
+ *
+ *   ⚠️  Consumers MUST match their own reserved app routes (/p, /api, /docs, …)
+ *   BEFORE delegating to parseResolverPath. A 1–3 char uppercase route (e.g. /P)
+ *   is indistinguishable from a 1-char ISO/IEC 15459 agency code — the function
+ *   cannot tell them apart and will return a spurious iso15459 result. Pre-empt
+ *   all known app routes first, then call parseResolverPath for the remainder.
+ *
+ * identifierKey     — a canonical string for deduplication / map keys.
+ *   gs1      → `gs1:<gtin14>:<serial>`
+ *   iso15459 → `iso15459:<agency>:<primaryId>:<serial|>` (empty string if no serial)
+ *   iec61406 → `iec61406:<uri>`
+ *   did      → `did:<did>`
+ *   doi      → `doi:<lowercased-bare>`
+ *
+ * Note on open question: does the iso15459 path form match the ISO/IEC 18975
+ * resolver path that EN 18219 scheme 1 references? ISO/IEC 18975 is paywalled
+ * and unread. Until that is resolved, the path here is a TracePass resolver
+ * route, not a claim of conformance with 18975. The identifier's own `raw`/`uri`
+ * field is its authoritative form.
+ */
+import type { ProductIdentifier } from "@tracepass/dpp-types";
+/**
+ * Build a resolver URL for a `ProductIdentifier`.
+ *
+ * @param id           - the (validated, normalised) identifier
+ * @param resolverBase - the resolver's bare domain, e.g. `"id.example.com"`
+ * @returns the full resolver URL, or `null` for schemes that carry their own URL
+ */
+export declare function identifierToUri(id: ProductIdentifier, resolverBase: string): string | null;
+/**
+ * Return the identifier's own canonical URL, when it has one.
+ * `null` when the identifier type does not define its own URL form.
+ */
+export declare function identifierOwnUrl(id: ProductIdentifier): string | null;
+/**
+ * Parse a resolver path back into a `ProductIdentifier`.
+ *
+ * Handles the two schemes emitted by `identifierToUri`:
+ *   - `/01/<gtin14>/21/<encoded-serial>` → `{scheme: "gs1", …}`
+ *   - `/<AGENCY>/<encoded-primaryId>[/<encoded-serial>]` → `{scheme: "iso15459", …}`
+ *
+ * Returns `null` for any path that doesn't match, including:
+ *   - "/about/team"  — first segment "about" is 5 chars, exceeds the 3-char limit
+ *   - "/api/v1/…"   — first segment "api" is lowercase
+ *   - "/mh/ABC"     — first segment "mh" is lowercase (ISO/IEC 15459 agency codes
+ *                     are always uppercase per EN 18219; `identifierToUri` always
+ *                     emits uppercase)
+ *
+ * ⚠️  The agency-code shape check (1–3 chars, `[A-Z][A-Z0-9]{0,2}`) cannot
+ * distinguish a short app route from a valid agency code. For example, "/P/x"
+ * is indistinguishable from a passport with agency "P" and primaryId "x" — it
+ * will parse. Consumers MUST match their own reserved routes (/P, /API, /DOCS, …)
+ * BEFORE delegating to `parseResolverPath`.
+ *
+ * The first path segment determines the scheme: a digit-only segment is a GS1
+ * Application Identifier (we only emit `01`); a 1–3 char uppercase segment is
+ * an ISO/IEC 15459 issuing agency code.
+ */
+export declare function parseResolverPath(path: string): ProductIdentifier | null;
+/**
+ * A canonical string key for deduplication and map-key use.
+ *
+ * The key is stable and unique within its scheme domain. DOI keys are
+ * lower-cased (DOI identifiers are case-insensitive per the DOI Handbook).
+ */
+export declare function identifierKey(id: ProductIdentifier): string;
+//# sourceMappingURL=uri.d.ts.map

package/dist/uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.d.ts","sourceRoot":"","sources":["../src/uri.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8B1F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAwBrE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAmDxE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,iBAAiB,GAAG,MAAM,CAuB3D"}

package/dist/uri.js

@@ -0,0 +1,199 @@
+/**
+ * Identifier URI construction and parsing for the EN 18219 resolver path.
+ *
+ * identifierToUri   — build a resolver URL from any ProductIdentifier.
+ *   gs1     → Digital Link path `/01/<gtin14>/21/<encoded-serial>`
+ *   iso15459 → `/<agency>/<encoded-primaryId>[/<encoded-serial>]`
+ *   iec61406 / did / doi → null (they carry their own canonical URL)
+ *
+ * identifierOwnUrl  — the identifier's own URL form, when it has one.
+ *   iec61406 → the Identification Link uri
+ *   doi      → `https://doi.org/<doi>`
+ *   did      → null (resolution is method-specific; the DID itself is not a URL)
+ *   gs1/iso15459 → null (no URL intrinsic to the identifier; use identifierToUri)
+ *
+ * parseResolverPath — inverse of identifierToUri, for gs1 and iso15459 only.
+ *   Leading digits in the first path segment → GS1 AI path (AI 01 + AI 21).
+ *   A 1–3 char uppercase `[A-Z][A-Z0-9]{0,2}` first segment → ISO/IEC 15459 agency.
+ *   Otherwise → null (e.g. "/about/team", "/api/v1", lowercase-agency paths).
+ *
+ *   ⚠️  Consumers MUST match their own reserved app routes (/p, /api, /docs, …)
+ *   BEFORE delegating to parseResolverPath. A 1–3 char uppercase route (e.g. /P)
+ *   is indistinguishable from a 1-char ISO/IEC 15459 agency code — the function
+ *   cannot tell them apart and will return a spurious iso15459 result. Pre-empt
+ *   all known app routes first, then call parseResolverPath for the remainder.
+ *
+ * identifierKey     — a canonical string for deduplication / map keys.
+ *   gs1      → `gs1:<gtin14>:<serial>`
+ *   iso15459 → `iso15459:<agency>:<primaryId>:<serial|>` (empty string if no serial)
+ *   iec61406 → `iec61406:<uri>`
+ *   did      → `did:<did>`
+ *   doi      → `doi:<lowercased-bare>`
+ *
+ * Note on open question: does the iso15459 path form match the ISO/IEC 18975
+ * resolver path that EN 18219 scheme 1 references? ISO/IEC 18975 is paywalled
+ * and unread. Until that is resolved, the path here is a TracePass resolver
+ * route, not a claim of conformance with 18975. The identifier's own `raw`/`uri`
+ * field is its authoritative form.
+ */
+/**
+ * Build a resolver URL for a `ProductIdentifier`.
+ *
+ * @param id           - the (validated, normalised) identifier
+ * @param resolverBase - the resolver's bare domain, e.g. `"id.example.com"`
+ * @returns the full resolver URL, or `null` for schemes that carry their own URL
+ */
+export function identifierToUri(id, resolverBase) {
+    const base = resolverBase.replace(/\/+$/, "");
+    switch (id.scheme) {
+        case "gs1":
+            return (`https://${base}/01/${id.gtin}/21/${encodeURIComponent(id.serialNumber)}`);
+        case "iso15459": {
+            const parts = [
+                encodeURIComponent(id.issuingAgencyCode),
+                encodeURIComponent(id.primaryId),
+            ];
+            if (id.serial)
+                parts.push(encodeURIComponent(id.serial));
+            return `https://${base}/${parts.join("/")}`;
+        }
+        case "iec61406":
+        case "did":
+        case "doi":
+            // These schemes carry their own canonical URL; use identifierOwnUrl.
+            return null;
+        default: {
+            const _exhaustive = id;
+            void _exhaustive;
+            return null;
+        }
+    }
+}
+/**
+ * Return the identifier's own canonical URL, when it has one.
+ * `null` when the identifier type does not define its own URL form.
+ */
+export function identifierOwnUrl(id) {
+    switch (id.scheme) {
+        case "iec61406":
+            return id.uri;
+        case "doi":
+            // DOI is always stored as bare form; resolve via the global DOI resolver.
+            return `https://doi.org/${id.doi}`;
+        case "did":
+            // DID resolution is method-specific; the DID itself is not a URL.
+            return null;
+        case "gs1":
+        case "iso15459":
+            // These have no intrinsic URL; they need a resolver. Use identifierToUri.
+            return null;
+        default: {
+            const _exhaustive = id;
+            void _exhaustive;
+            return null;
+        }
+    }
+}
+/**
+ * Parse a resolver path back into a `ProductIdentifier`.
+ *
+ * Handles the two schemes emitted by `identifierToUri`:
+ *   - `/01/<gtin14>/21/<encoded-serial>` → `{scheme: "gs1", …}`
+ *   - `/<AGENCY>/<encoded-primaryId>[/<encoded-serial>]` → `{scheme: "iso15459", …}`
+ *
+ * Returns `null` for any path that doesn't match, including:
+ *   - "/about/team"  — first segment "about" is 5 chars, exceeds the 3-char limit
+ *   - "/api/v1/…"   — first segment "api" is lowercase
+ *   - "/mh/ABC"     — first segment "mh" is lowercase (ISO/IEC 15459 agency codes
+ *                     are always uppercase per EN 18219; `identifierToUri` always
+ *                     emits uppercase)
+ *
+ * ⚠️  The agency-code shape check (1–3 chars, `[A-Z][A-Z0-9]{0,2}`) cannot
+ * distinguish a short app route from a valid agency code. For example, "/P/x"
+ * is indistinguishable from a passport with agency "P" and primaryId "x" — it
+ * will parse. Consumers MUST match their own reserved routes (/P, /API, /DOCS, …)
+ * BEFORE delegating to `parseResolverPath`.
+ *
+ * The first path segment determines the scheme: a digit-only segment is a GS1
+ * Application Identifier (we only emit `01`); a 1–3 char uppercase segment is
+ * an ISO/IEC 15459 issuing agency code.
+ */
+export function parseResolverPath(path) {
+    // Normalise: strip leading slash, strip query/fragment
+    const clean = path.replace(/^\//, "").split("?")[0].split("#")[0];
+    if (!clean)
+        return null;
+    const segments = clean.split("/");
+    if (segments.length < 2)
+        return null;
+    const first = segments[0];
+    if (!first)
+        return null;
+    // GS1 AI path: leading all-digit segment
+    if (/^\d+$/.test(first)) {
+        // Only handle the /01/<gtin>/21/<serial> form we emit.
+        if (first !== "01" || segments.length < 4 || segments[2] !== "21")
+            return null;
+        const gtin = segments[1];
+        let serial;
+        try {
+            serial = decodeURIComponent(segments[3]);
+        }
+        catch {
+            // Malformed percent-sequence (e.g. bare %) → treat as not found, not 500.
+            return null;
+        }
+        return { scheme: "gs1", gtin, serialNumber: serial };
+    }
+    // ISO/IEC 15459 agency path: exactly 1–3 chars, uppercase [A-Z][A-Z0-9]{0,2}.
+    // identifierToUri always emits uppercase agency codes; lowercase paths are
+    // rejected (the caller may uppercase and retry if needed).
+    if (/^[A-Z][A-Z0-9]{0,2}$/.test(first)) {
+        let issuingAgencyCode;
+        let primaryId;
+        let serial;
+        try {
+            issuingAgencyCode = decodeURIComponent(first).toUpperCase();
+            primaryId = decodeURIComponent(segments[1]);
+            serial = segments[2] ? decodeURIComponent(segments[2]) : undefined;
+        }
+        catch {
+            return null;
+        }
+        const raw = [issuingAgencyCode, primaryId, serial].filter(Boolean).join("/");
+        return {
+            scheme: "iso15459",
+            issuingAgencyCode,
+            primaryId,
+            serial,
+            raw,
+        };
+    }
+    return null;
+}
+/**
+ * A canonical string key for deduplication and map-key use.
+ *
+ * The key is stable and unique within its scheme domain. DOI keys are
+ * lower-cased (DOI identifiers are case-insensitive per the DOI Handbook).
+ */
+export function identifierKey(id) {
+    switch (id.scheme) {
+        case "gs1":
+            return `gs1:${id.gtin}:${id.serialNumber}`;
+        case "iso15459":
+            return `iso15459:${id.issuingAgencyCode}:${id.primaryId}:${id.serial ?? ""}`;
+        case "iec61406":
+            return `iec61406:${id.uri}`;
+        case "did":
+            return `did:${id.did}`;
+        case "doi":
+            return `doi:${id.doi.toLowerCase()}`;
+        default: {
+            const _exhaustive = id;
+            void _exhaustive;
+            return `unknown:${JSON.stringify(id)}`;
+        }
+    }
+}
+//# sourceMappingURL=uri.js.map

package/dist/uri.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@tracepass/dpp-identifiers",
+  "version": "0.9.0",
+  "description": "Validate and parse EU Digital Product Passport identifiers (EN 18219) — GS1 Digital Link, ISO/IEC 15459, IEC 61406, DID, DOI. Pure functions, no network, no third-party runtime dependencies.",
+  "keywords": [
+    "digital-product-passport",
+    "dpp",
+    "en18219",
+    "espr",
+    "gs1",
+    "gtin",
+    "iso15459",
+    "iec61406",
+    "did",
+    "doi",
+    "identifier",
+    "eu-regulation",
+    "circular-economy"
+  ],
+  "license": "Apache-2.0",
+  "author": "TracePass LTD (https://tracepass.eu)",
+  "homepage": "https://github.com/malinoto/tracepass-open/tree/main/packages/dpp-identifiers#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/malinoto/tracepass-open.git",
+    "directory": "packages/dpp-identifiers"
+  },
+  "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"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@tracepass/dpp-types": "^0.9.0",
+    "@tracepass/gs1-utils": "^0.9.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}