@uncefact/untp-utils 0.2.0 → 0.4.0

package/artefacts/schema/untp/0.7.0/linkset.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://untp.unece.org/schema/idr/linkset-schema",
+  "title": "UNTP linkset schema extending RFC 9264 with UNTP link object properties",
+  "description": "A linkset schema aligned with the GS1 resolver linkset schema (https://ref.gs1.org/standards/resolver/linkset-schema) and extended with UNTP-specific link object properties for versioning, access control, and link creation. A UNTP-conformant linkset that omits the UNTP extension properties will also validate against the GS1 schema.",
+  "type": "object",
+  "properties": {
+    "linkset": {
+      "description": "The linkset",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "anchor": {
+            "description": "The URL at the root of the linkset, a.k.a the link context",
+            "type": "string",
+            "pattern": "^https?:\\/\\/[a-zA-Z0-9./]+"
+          },
+          "itemDescription": {
+            "name": "Item description",
+            "description": "A description of the item. Deprecated in favour of description.",
+            "type": "string"
+          },
+          "description": {
+            "name": "Description",
+            "description": "A description of the item. Preferred alternative to itemDescription.",
+            "type": "string"
+          }
+        },
+        "patternProperties": {
+          "(?!(anchor|itemDescription|description))^([a-z-]+$)|(^https?:\\/\\/[a-zA-Z0-9./]+$)": {
+            "title": "Link object schema",
+            "description": "The schema for each link context object for each link relation type. Link relation types are either IANA-registered short names (lowercase alphabetic with hyphens) or full URLs as defined in RFC 8288.",
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "href": {
+                  "name": "href",
+                  "description": "The target URL",
+                  "type": "string",
+                  "pattern": "^https?:\\/\\/[a-zA-Z0-9./]+"
+                },
+                "title": {
+                  "title": "title",
+                  "description": "A human-readable title for the link",
+                  "type": "string"
+                },
+                "hreflang": {
+                  "name": "hreflang",
+                  "description": "The human language(s) of the target resource",
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "pattern": "(^\\w{2}$)|(^\\w{2}-\\w{2}$)"
+                  }
+                },
+                "type": {
+                  "name": "Type",
+                  "description": "The content type (MIME type) of the target resource",
+                  "type": "string",
+                  "pattern": "\\w+/[-+.\\w]+"
+                },
+                "context": {
+                  "name": "Context",
+                  "description": "Any additional descriptor for the link, typically a geography or jurisdiction in which the link applies",
+                  "type": "array"
+                },
+                "fwqs": {
+                  "name": "Forward query strings",
+                  "type": "boolean"
+                },
+                "public": {
+                  "name": "Link can be shared publicly",
+                  "type": "boolean"
+                },
+                "rel": {
+                  "name": "Additional link relations",
+                  "description": "An array of additional IANA or extension link relation types that qualify this link, such as predecessor-version or edit.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "method": {
+                  "name": "HTTP method",
+                  "description": "An array whose first element is the HTTP method (e.g. POST) and subsequent elements are required HTTP header names (e.g. X-API-Key). Used to describe how a client should interact with the target to create or update a linked resource.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "encryptionMethod": {
+                  "name": "Encryption method",
+                  "description": "The encryption algorithm used to protect the target resource (e.g. AES-128). Indicates that the target requires a decryption key or proof of authorised role to access.",
+                  "type": "string"
+                },
+                "accessRole": {
+                  "name": "Access roles",
+                  "description": "An array of role identifiers that are authorised to access the encrypted target resource.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              },
+              "required": ["href", "title"],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": ["anchor"],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": ["linkset"],
+  "additionalProperties": false
+}

package/artefacts/schema/vcdm/2/verifiable-credential.json

@@ -0,0 +1,318 @@
+{
+  "$id": "https://www.w3.org/2022/credentials/v2/verifiable-credential-schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "description": "JSON Schema for a Verifiable Credential according to the Verifiable Credentials Data Model v2",
+  "type": "object",
+  "$defs": {
+    "type": {
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "minItems": 1
+        }
+      ]
+    },
+    "credentialSubject": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        }
+      },
+      "minProperties": 1
+    },
+    "credentialSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "$ref": "#/$defs/type"
+        }
+      },
+      "required": ["id", "type"],
+      "additionalProperties": true
+    },
+    "credentialStatus": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "$ref": "#/$defs/type"
+        }
+      },
+      "required": ["type"],
+      "additionalProperties": true
+    },
+    "refreshService": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "$ref": "#/$defs/type"
+        }
+      },
+      "required": ["id", "type"],
+      "additionalProperties": true
+    },
+    "termsOfUse": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "$ref": "#/$defs/type"
+        }
+      },
+      "required": ["type"],
+      "additionalProperties": true
+    },
+    "evidence": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "$ref": "#/$defs/type"
+        }
+      },
+      "required": ["type"],
+      "additionalProperties": true
+    },
+    "proof": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "$ref": "#/$defs/type"
+        },
+        "proofPurpose": {
+          "type": "string"
+        },
+        "verificationMethod": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "type": "string"
+                  },
+                  "controller": {
+                    "type": "string"
+                  }
+                },
+                "required": ["id", "type", "controller"],
+                "additionalProperties": true
+              }
+            }
+          ]
+        },
+        "created": {
+          "type": "string"
+        },
+        "domain": {
+          "type": "string"
+        },
+        "challenge": {
+          "type": "string"
+        },
+        "proofValue": {
+          "type": "string"
+        }
+      },
+      "required": ["type", "proofPurpose", "verificationMethod"],
+      "additionalProperties": true
+    }
+  },
+  "properties": {
+    "@context": {
+      "type": "array",
+      "contains": {
+        "const": "https://www.w3.org/ns/credentials/v2"
+      },
+      "minItems": 1,
+      "items": {
+        "oneOf": [
+          {
+            "type": "string",
+            "minLength": 1
+          },
+          {
+            "type": "object",
+            "minProperties": 1,
+            "propertyNames": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        ]
+      },
+      "prefixItems": [
+        {
+          "const": "https://www.w3.org/ns/credentials/v2"
+        }
+      ],
+      "uniqueItems": true
+    },
+    "id": {
+      "type": "string"
+    },
+    "type": {
+      "oneOf": [
+        {
+          "type": "array",
+          "contains": {
+            "const": "VerifiableCredential"
+          }
+        },
+        {
+          "type": "string",
+          "enum": ["VerifiableCredential"]
+        }
+      ]
+    },
+    "issuer": {
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "id": {
+              "type": "string"
+            }
+          },
+          "required": ["id"],
+          "additionalProperties": true
+        }
+      ]
+    },
+    "validFrom": {
+      "type": "string",
+      "pattern": "-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T(([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]+)?|(24:00:00(\\.0+)?))(Z|(\\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))"
+    },
+    "validUntil": {
+      "type": "string",
+      "pattern": "-?([1-9][0-9]{3,}|0[0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T(([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](\\.[0-9]+)?|(24:00:00(\\.0+)?))(Z|(\\+|-)((0[0-9]|1[0-3]):[0-5][0-9]|14:00))"
+    },
+    "credentialSubject": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/credentialSubject"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/credentialSubject"
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "credentialStatus": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/credentialStatus"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/credentialStatus"
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "credentialSchema": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/credentialSchema"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/credentialSchema"
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "refreshService": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/refreshService"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/refreshService"
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "termsOfUse": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/termsOfUse"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/termsOfUse"
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "evidence": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/evidence"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/evidence"
+          },
+          "minItems": 1
+        }
+      ]
+    },
+    "proof": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/proof"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/proof"
+          },
+          "minItems": 1
+        }
+      ]
+    }
+  },
+  "required": ["@context", "type", "issuer", "credentialSubject"],
+  "additionalProperties": true
+}

package/build/artefacts/detect-version-from-context.d.ts

@@ -21,8 +21,13 @@ export interface DetectVersionFromContextOptions {
 }
 /**
  * Derives the spec version from a UNTP document's `@context` by looking for a
- * path segment shaped `/{major}.{minor}.{patch}[-prerelease]/` inside a known
- * UNTP context URL.
+ * path segment shaped `/{major}.{minor}.{patch}[-prerelease]` inside a known
+ * UNTP context URL. Only the part of the URL before any `?` or `#` is read, so
+ * a version-shaped string inside a query or fragment never supplies the
+ * version, while a version that a query or fragment immediately follows still
+ * does. Within that part the segment must be bounded on the left by `/` and on
+ * the right by `/` or the end of the string. The published schema decides the
+ * exact context string that the document must use.
  *
  * Works for any UNTP artefact that publishes a versioned context: credentials
  * (DPP, DCC, DFR, DIA, DTE), conformity schemes, identifier scheme registers,

package/build/artefacts/detect-version-from-context.js

@@ -7,14 +7,24 @@
 export const UNTP_CONTEXT_DOMAINS = ['vocabulary.uncefact.org', 'test.uncefact.org'];
 /**
  * A version segment in a UNTP-published context path. Matches a path segment
- * shaped `/{major}.{minor}.{patch}[-prerelease]/`. The pre-release suffix
- * captures common forms (`-rc1`, `-alpha.2`, `-2024-05-21`, etc.).
+ * shaped `/{major}.{minor}.{patch}[-prerelease]` when it is bounded on the
+ * left by `/` and on the right by `/` or the end of the string. It is applied
+ * to the part of the URL before any `?` or `#`, so query and fragment parts
+ * never supply the version. The pre-release suffix captures common forms (`-rc1`, `-alpha.2`,
+ * `-2024-05-21`, etc.).
+ * This identifies only the version; the published schema decides the exact
+ * context string.
  */
-const UNTP_VERSION_PATH_SEGMENT = /\/(\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?)\//;
+const UNTP_VERSION_PATH_SEGMENT = /\/(\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?)(?=\/|$)/;
 /**
  * Derives the spec version from a UNTP document's `@context` by looking for a
- * path segment shaped `/{major}.{minor}.{patch}[-prerelease]/` inside a known
- * UNTP context URL.
+ * path segment shaped `/{major}.{minor}.{patch}[-prerelease]` inside a known
+ * UNTP context URL. Only the part of the URL before any `?` or `#` is read, so
+ * a version-shaped string inside a query or fragment never supplies the
+ * version, while a version that a query or fragment immediately follows still
+ * does. Within that part the segment must be bounded on the left by `/` and on
+ * the right by `/` or the end of the string. The published schema decides the
+ * exact context string that the document must use.
  *
  * Works for any UNTP artefact that publishes a versioned context: credentials
  * (DPP, DCC, DFR, DIA, DTE), conformity schemes, identifier scheme registers,
@@ -46,7 +56,8 @@ export function detectVersionFromContext(doc, options = {}) {
         if (!matchesDomain(url)) {
             continue;
         }
-        const match = url.match(UNTP_VERSION_PATH_SEGMENT);
+        const path = url.split(/[?#]/, 1)[0];
+        const match = path.match(UNTP_VERSION_PATH_SEGMENT);
         if (match) {
             return match[1];
         }

package/build/artefacts/detect-version-from-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"detect-version-from-context.js","sourceRoot":"","sources":["../../src/artefacts/detect-version-from-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,yBAAyB,EAAE,mBAAmB,CAAU,CAAC;AAE9F;;;;GAIG;AACH,MAAM,yBAAyB,GAAG,yCAAyC,CAAC;AAiB5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAY,EACZ,UAA2C,EAAE;IAE7C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAI,GAAgC,CAAC,UAAU,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACnD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,kBAAkB,CAAC,MAA0B;IACpD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"detect-version-from-context.js","sourceRoot":"","sources":["../../src/artefacts/detect-version-from-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,yBAAyB,EAAE,mBAAmB,CAAU,CAAC;AAE9F;;;;;;;;;GASG;AACH,MAAM,yBAAyB,GAAG,+CAA+C,CAAC;AAiBlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAY,EACZ,UAA2C,EAAE;IAE7C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAI,GAAgC,CAAC,UAAU,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACpD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,kBAAkB,CAAC,MAA0B;IACpD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/build/artefacts/detect-version-from-context.test.js

@@ -15,6 +15,61 @@ describe('detectVersionFromContext', () => {
             const doc = { '@context': 'https://vocabulary.uncefact.org/untp/0.7.0-rc.1/context/' };
             expect(detectVersionFromContext(doc)).toBe('0.7.0-rc.1');
         });
+        it('returns the version when it is the terminal path segment without a trailing slash', () => {
+            const doc = { '@context': 'https://test.uncefact.org/vocabulary/untp/dpp/0.5.0' };
+            expect(detectVersionFromContext(doc)).toBe('0.5.0');
+        });
+        it('recognises a terminal pre-release version without a trailing slash', () => {
+            const doc = { '@context': 'https://vocabulary.uncefact.org/untp/0.7.0-rc.1' };
+            expect(detectVersionFromContext(doc)).toBe('0.7.0-rc.1');
+        });
+        it('uses the first version-shaped path segment', () => {
+            // The first version-shaped segment wins when a later path segment also looks like a version.
+            const doc = { '@context': 'https://vocabulary.uncefact.org/untp/0.6.0/dpp/0.7.0/' };
+            expect(detectVersionFromContext(doc)).toBe('0.6.0');
+        });
+        it('ignores a version-shaped path in a query', () => {
+            const doc = { '@context': 'https://vocabulary.uncefact.org/untp/context?path=/0.7.0' };
+            expect(detectVersionFromContext(doc)).toBeUndefined();
+        });
+        it('ignores a version-shaped path in a fragment', () => {
+            const doc = { '@context': 'https://vocabulary.uncefact.org/untp/context#path=/0.7.0' };
+            expect(detectVersionFromContext(doc)).toBeUndefined();
+        });
+        it('uses a genuine pathname version after a query-only context entry', () => {
+            const doc = {
+                '@context': [
+                    'https://vocabulary.uncefact.org/untp/context?path=/0.7.0',
+                    'https://vocabulary.uncefact.org/untp/0.6.0/context/',
+                ],
+            };
+            expect(detectVersionFromContext(doc)).toBe('0.6.0');
+        });
+        it('recognises a version bounded by a query string', () => {
+            const doc = { '@context': 'https://test.uncefact.org/vocabulary/untp/dpp/0.5.0?format=json' };
+            expect(detectVersionFromContext(doc)).toBe('0.5.0');
+        });
+        it('recognises a version bounded by a fragment', () => {
+            const doc = { '@context': 'https://test.uncefact.org/vocabulary/untp/dpp/0.5.0#context' };
+            expect(detectVersionFromContext(doc)).toBe('0.5.0');
+        });
+        it('rejects a version with a trailing dot', () => {
+            const doc = { '@context': 'https://test.uncefact.org/vocabulary/untp/dpp/0.5.0./' };
+            expect(detectVersionFromContext(doc)).toBeUndefined();
+        });
+        it('rejects a four-part version', () => {
+            const doc = { '@context': 'https://test.uncefact.org/vocabulary/untp/dpp/0.5.0.1/' };
+            expect(detectVersionFromContext(doc)).toBeUndefined();
+        });
+        it('does not detect a filename-shaped version on an unrelated domain', () => {
+            const doc = { '@context': 'https://example.org/untp/0.5.0-rc.1.jsonld' };
+            expect(detectVersionFromContext(doc)).toBeUndefined();
+        });
+        it('keeps the complete filename-shaped suffix when the domain is recognised', () => {
+            // SemVer permits dotted prerelease identifiers, so the detector cannot tell a filename extension from a prerelease part; no published UNTP context has this shape.
+            const doc = { '@context': 'https://vocabulary.uncefact.org/untp/0.5.0-rc.1.jsonld' };
+            expect(detectVersionFromContext(doc)).toBe('0.5.0-rc.1.jsonld');
+        });
         it('recognises the test.uncefact.org domain', () => {
             const doc = { '@context': 'https://test.uncefact.org/untp/0.7.0/context/' };
             expect(detectVersionFromContext(doc)).toBe('0.7.0');
@@ -23,6 +78,10 @@ describe('detectVersionFromContext', () => {
             const doc = { '@context': ['https://schema.org/', 'https://example.com/0.7.0/'] };
             expect(detectVersionFromContext(doc)).toBeUndefined();
         });
+        it('does not recognise a filename-embedded version', () => {
+            const doc = { '@context': 'https://aatp.foodagility.com/context/aatp-dlp-context-0.4.0.jsonld' };
+            expect(detectVersionFromContext(doc, { domain: 'aatp.foodagility.com' })).toBeUndefined();
+        });
         it('skips non-string entries within an array @context', () => {
             const doc = {
                 '@context': [{ '@vocab': 'https://example.com/' }, 'https://vocabulary.uncefact.org/untp/0.7.0/context/'],

package/build/artefacts/detect-version-from-context.test.js.map

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

package/build/artefacts/urls.d.ts

@@ -74,6 +74,13 @@ export interface UntpArtefactUrls {
  *   `ConformityScheme`). Must be a recognised type.
  * @param version - Semantic version of the artefact (e.g. `0.7.0`).
  * @returns The {@link UntpArtefactUrls} appropriate for the version.
- * @throws {Error} When `type` is not a recognised UNTP artefact type.
+ * @throws {Error} When `type` is not a recognised UNTP artefact type, or when `type` is
+ * `ConformityScheme` and `version` is before 0.7.0.
  */
 export declare function buildUntpArtefactUrls(type: string, version: string): UntpArtefactUrls;
+/**
+ * The published Identity Resolver link set schema URL for a UNTP version. The schema exists from
+ * 0.7.0 under the artefacts layout only (`/idr/LinksetSchema.json`); no legacy per-type form ever
+ * existed, so this is a single layout rather than a version switch.
+ */
+export declare function buildLinkSetSchemaUrl(version: string): string;

package/build/artefacts/urls.js

@@ -91,10 +91,10 @@ const DOCS_VERSION_FALLBACKS = {
  * @throws {Error} When `type` is not a recognised UNTP artefact type.
  */
 export function buildSpecificationPageUrl(type, version) {
-    const slug = UNTP_SPECIFICATION_PAGE_SLUGS[type];
-    if (!slug) {
+    if (!Object.hasOwn(UNTP_SPECIFICATION_PAGE_SLUGS, type)) {
         throw new Error(`Unknown UNTP artefact type "${type}". Expected one of: ${Object.keys(UNTP_SPECIFICATION_PAGE_SLUGS).join(', ')}.`);
     }
+    const slug = UNTP_SPECIFICATION_PAGE_SLUGS[type];
     const docsVersion = DOCS_VERSION_FALLBACKS[version] ?? version;
     if (docsVersion === CURRENT_UNTP_DOCS_VERSION) {
         return `${DOCS_BASE}/specification/${slug}`;
@@ -111,13 +111,17 @@ export function buildSpecificationPageUrl(type, version) {
  *   `ConformityScheme`). Must be a recognised type.
  * @param version - Semantic version of the artefact (e.g. `0.7.0`).
  * @returns The {@link UntpArtefactUrls} appropriate for the version.
- * @throws {Error} When `type` is not a recognised UNTP artefact type.
+ * @throws {Error} When `type` is not a recognised UNTP artefact type, or when `type` is
+ * `ConformityScheme` and `version` is before 0.7.0.
  */
 export function buildUntpArtefactUrls(type, version) {
-    const shortCode = UNTP_SHORT_CREDENTIAL_TYPES[type];
-    if (!shortCode) {
+    if (!Object.hasOwn(UNTP_SHORT_CREDENTIAL_TYPES, type)) {
         throw new Error(`Unknown UNTP artefact type "${type}". Expected one of: ${Object.keys(UNTP_SHORT_CREDENTIAL_TYPES).join(', ')}.`);
     }
+    const shortCode = UNTP_SHORT_CREDENTIAL_TYPES[type];
+    if (type === 'ConformityScheme' && !isV070OrAbove(version)) {
+        throw new Error(`ConformityScheme has no artefacts for versions before UNTP 0.7.0 and "${version}" is not a UNTP 0.7.0 or later version.`);
+    }
     if (isV070OrAbove(version)) {
         const fileName = UNTP_CORE_SCHEMA_FILENAMES[type];
         return {
@@ -130,4 +134,12 @@ export function buildUntpArtefactUrls(type, version) {
         contextUrl: `${LEGACY_BASE}/${shortCode}/${version}/context/`,
     };
 }
+/**
+ * The published Identity Resolver link set schema URL for a UNTP version. The schema exists from
+ * 0.7.0 under the artefacts layout only (`/idr/LinksetSchema.json`); no legacy per-type form ever
+ * existed, so this is a single layout rather than a version switch.
+ */
+export function buildLinkSetSchemaUrl(version) {
+    return `${ARTEFACTS_SCHEMA_BASE}/v${version}/idr/LinksetSchema.json`;
+}
 //# sourceMappingURL=urls.js.map