@uncefact/untp-utils 0.1.0 → 0.2.0

package/README.md

@@ -8,12 +8,34 @@ Shared utility primitives for UNTP packages and consumers.
 yarn add @uncefact/untp-utils
 ```
 
+## Sub-entries
+
+The package root exports only `StructuredError`, the base class every
+sub-entry throws from. Each capability is imported from its own subpath so a
+consumer only pulls in the dependencies it needs.
+
+| Subpath                                      | Provides                                                                                      |
+| -------------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `@uncefact/untp-utils/multibase-digest`      | `MultibaseDigest`: encode, decode and verify multibase-encoded multihashes.                   |
+| `@uncefact/untp-utils/artefacts`             | UNTP schema, context and docs URL helpers, and `detectVersionFromContext`.                    |
+| `@uncefact/untp-utils/conformity-vocabulary` | Parses a UNTP conformity scheme or catalogue and validates a conformity claim against it.     |
+| `@uncefact/untp-utils/validation`            | Validates a payload against JSON Schema and expands it as JSON-LD, both guarded against SSRF. |
+| `@uncefact/untp-utils/loaders`               | The schema and JSON-LD document loaders `validation` runs on.                                 |
+| `@uncefact/untp-utils/resolvers`             | IP-pinned document fetching with a conditional-fetch skip chain.                              |
+| `@uncefact/untp-utils/node`                  | `validatePublicUrl`, the SSRF guard the other sub-entries fetch through.                      |
+| `@uncefact/untp-utils/cache`                 | `createInMemoryTtlCache`, a bounded in-memory TTL cache.                                      |
+| `@uncefact/untp-utils/http-headers`          | HTTP header parsing, and the default `User-Agent` guarded fetches send.                       |
+
+Every sub-entry throws a typed error class on failure rather than returning
+an outcome object. See [RELEASE_NOTES.md](./RELEASE_NOTES.md) for what each
+release changes and [CHANGELOG.md](./CHANGELOG.md) for the full history.
+
 ## MultibaseDigest
 
 Encode, decode and verify multibase-encoded multihashes.
 
 ```ts
-import { MultibaseDigest } from '@uncefact/untp-utils';
+import { MultibaseDigest } from '@uncefact/untp-utils/multibase-digest';
 
 // Hash some data, wrap as a multihash, encode as a multibase string.
 const digest = await MultibaseDigest.fromData(new TextEncoder().encode('hello'), {

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

@@ -0,0 +1,46 @@
+/**
+ * Domains UNTP publishes versioned contexts under. UNTP v0.7 and above
+ * publish to `vocabulary.uncefact.org`; earlier versions (pre-0.7) were
+ * published to `test.uncefact.org`. Both are kept in the matcher so
+ * documents from either era resolve to a version string.
+ */
+export declare const UNTP_CONTEXT_DOMAINS: readonly ["vocabulary.uncefact.org", "test.uncefact.org"];
+/**
+ * Options for {@link detectVersionFromContext}.
+ */
+export interface DetectVersionFromContextOptions {
+    /**
+     * When set, only context URLs whose hostname contains this substring are
+     * considered. Useful for extensions, where each extension publishes its own
+     * versioned context under a domain distinct from the UNTP core context.
+     *
+     * When omitted, any UNTP context domain ({@link UNTP_CONTEXT_DOMAINS}) is
+     * considered.
+     */
+    domain?: string;
+}
+/**
+ * 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.
+ *
+ * Works for any UNTP artefact that publishes a versioned context: credentials
+ * (DPP, DCC, DFR, DIA, DTE), conformity schemes, identifier scheme registers,
+ * etc. The function is data-only: it never fetches, never resolves contexts.
+ *
+ * @param doc - Any object that may carry an `@context` field. The field may
+ *   be a string or an array; non-string entries in arrays are ignored.
+ *   Non-object inputs return `undefined`.
+ * @param options - {@link DetectVersionFromContextOptions}.
+ * @returns The detected version string (for example `0.7.0` or `0.7.0-rc1`),
+ *   or `undefined` when no matching UNTP context URL is found.
+ *
+ * @example
+ * detectVersionFromContext({ '@context': ['https://vocabulary.uncefact.org/untp/0.7.0/context/'] });
+ * // → '0.7.0'
+ *
+ * @example
+ * detectVersionFromContext(extensionCredential, { domain: 'aatp.example.com' });
+ * // → '0.5.0' (or whatever the extension publishes)
+ */
+export declare function detectVersionFromContext(doc: unknown, options?: DetectVersionFromContextOptions): string | undefined;

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

@@ -0,0 +1,77 @@
+/**
+ * Domains UNTP publishes versioned contexts under. UNTP v0.7 and above
+ * publish to `vocabulary.uncefact.org`; earlier versions (pre-0.7) were
+ * published to `test.uncefact.org`. Both are kept in the matcher so
+ * documents from either era resolve to a version string.
+ */
+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.).
+ */
+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.
+ *
+ * Works for any UNTP artefact that publishes a versioned context: credentials
+ * (DPP, DCC, DFR, DIA, DTE), conformity schemes, identifier scheme registers,
+ * etc. The function is data-only: it never fetches, never resolves contexts.
+ *
+ * @param doc - Any object that may carry an `@context` field. The field may
+ *   be a string or an array; non-string entries in arrays are ignored.
+ *   Non-object inputs return `undefined`.
+ * @param options - {@link DetectVersionFromContextOptions}.
+ * @returns The detected version string (for example `0.7.0` or `0.7.0-rc1`),
+ *   or `undefined` when no matching UNTP context URL is found.
+ *
+ * @example
+ * detectVersionFromContext({ '@context': ['https://vocabulary.uncefact.org/untp/0.7.0/context/'] });
+ * // → '0.7.0'
+ *
+ * @example
+ * detectVersionFromContext(extensionCredential, { domain: 'aatp.example.com' });
+ * // → '0.5.0' (or whatever the extension publishes)
+ */
+export function detectVersionFromContext(doc, options = {}) {
+    if (!doc || typeof doc !== 'object') {
+        return undefined;
+    }
+    const contextField = doc['@context'];
+    const candidates = collectContextStrings(contextField);
+    const matchesDomain = buildDomainMatcher(options.domain);
+    for (const url of candidates) {
+        if (!matchesDomain(url)) {
+            continue;
+        }
+        const match = url.match(UNTP_VERSION_PATH_SEGMENT);
+        if (match) {
+            return match[1];
+        }
+    }
+    return undefined;
+}
+function collectContextStrings(context) {
+    if (typeof context === 'string') {
+        return [context];
+    }
+    if (Array.isArray(context)) {
+        const out = [];
+        for (const entry of context) {
+            if (typeof entry === 'string') {
+                out.push(entry);
+            }
+        }
+        return out;
+    }
+    return [];
+}
+function buildDomainMatcher(domain) {
+    if (domain) {
+        return (url) => url.includes(domain);
+    }
+    return (url) => UNTP_CONTEXT_DOMAINS.some((d) => url.includes(d));
+}
+//# sourceMappingURL=detect-version-from-context.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,69 @@
+import { detectVersionFromContext } from './detect-version-from-context.js';
+describe('detectVersionFromContext', () => {
+    describe('UNTP context detection (default domain set)', () => {
+        it('returns the version from a single string @context', () => {
+            const doc = { '@context': 'https://vocabulary.uncefact.org/untp/0.7.0/context/' };
+            expect(detectVersionFromContext(doc)).toBe('0.7.0');
+        });
+        it('returns the version when @context is an array including the UNTP context', () => {
+            const doc = {
+                '@context': ['https://www.w3.org/ns/credentials/v2', 'https://vocabulary.uncefact.org/untp/0.7.0/context/'],
+            };
+            expect(detectVersionFromContext(doc)).toBe('0.7.0');
+        });
+        it('recognises pre-release versions', () => {
+            const doc = { '@context': 'https://vocabulary.uncefact.org/untp/0.7.0-rc.1/context/' };
+            expect(detectVersionFromContext(doc)).toBe('0.7.0-rc.1');
+        });
+        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');
+        });
+        it('returns undefined for non-UNTP context domains', () => {
+            const doc = { '@context': ['https://schema.org/', 'https://example.com/0.7.0/'] };
+            expect(detectVersionFromContext(doc)).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/'],
+            };
+            expect(detectVersionFromContext(doc)).toBe('0.7.0');
+        });
+    });
+    describe('domain-scoped detection', () => {
+        it('finds the version under a caller-supplied domain (extension context)', () => {
+            const doc = {
+                '@context': [
+                    'https://www.w3.org/ns/credentials/v2',
+                    'https://vocabulary.uncefact.org/untp/0.7.0/context/',
+                    'https://aatp.example.com/untp/0.5.0/context/',
+                ],
+            };
+            expect(detectVersionFromContext(doc, { domain: 'aatp.example.com' })).toBe('0.5.0');
+        });
+        it('returns undefined when no context matches the supplied domain', () => {
+            const doc = {
+                '@context': ['https://vocabulary.uncefact.org/untp/0.7.0/context/'],
+            };
+            expect(detectVersionFromContext(doc, { domain: 'nope.example.com' })).toBeUndefined();
+        });
+    });
+    describe('input handling', () => {
+        it('returns undefined when @context is missing', () => {
+            expect(detectVersionFromContext({})).toBeUndefined();
+        });
+        it('returns undefined for non-object input', () => {
+            expect(detectVersionFromContext(null)).toBeUndefined();
+            expect(detectVersionFromContext(undefined)).toBeUndefined();
+            expect(detectVersionFromContext('a string')).toBeUndefined();
+            expect(detectVersionFromContext(42)).toBeUndefined();
+        });
+    });
+    describe('regex robustness', () => {
+        it('ignores version-like substrings outside a path segment', () => {
+            const doc = { '@context': 'https://vocabulary.uncefact.org/untp/context?v=1.2.3' };
+            expect(detectVersionFromContext(doc)).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=detect-version-from-context.test.js.map

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

@@ -0,0 +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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"}

package/build/artefacts/index.d.ts

@@ -0,0 +1,3 @@
+export * from './version.js';
+export * from './urls.js';
+export * from './detect-version-from-context.js';

package/build/artefacts/index.js

@@ -0,0 +1,4 @@
+export * from './version.js';
+export * from './urls.js';
+export * from './detect-version-from-context.js';
+//# sourceMappingURL=index.js.map

package/build/artefacts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artefacts/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kCAAkC,CAAC"}

package/build/artefacts/urls.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Construction of UNTP artefact URLs (JSON Schema and JSON-LD context) for a
+ * given credential / artefact type and spec version.
+ *
+ * UNTP v0.7.0 relocated the artefacts. Schemas moved from the legacy
+ * per-credential-type layout on `test.uncefact.org` to the unece.org
+ * artefacts origin, and the JSON-LD context was unified into a single
+ * per-version context on `vocabulary.uncefact.org` (the same context URL for
+ * every type, including the Conformity Vocabulary Catalogue `ConformityScheme`
+ * artefact, which was introduced in v0.7.0). Earlier versions (v0.6.x)
+ * continue to be served from the legacy layout. This is the forward
+ * counterpart to {@link detectVersionFromContext}, which derives the version
+ * from a context URL.
+ *
+ * @see https://untp.unece.org/artefacts/schema/v0.7.0/dpp/DigitalProductPassport.json
+ * @see https://vocabulary.uncefact.org/untp/0.7.0/context/
+ */
+/** Short artefact codes used in UNTP artefact paths, keyed by credential / artefact type. */
+export declare const UNTP_SHORT_CREDENTIAL_TYPES: Record<string, string>;
+/**
+ * v0.7.0+ core schema file names keyed by credential / artefact type. Most
+ * match the type verbatim; `DigitalConformityCredential` is published as
+ * `ConformityCredential`.
+ */
+export declare const UNTP_CORE_SCHEMA_FILENAMES: Record<string, string>;
+/**
+ * UNTP specification page slugs keyed by credential / artefact type. Slugs are
+ * version-independent. Several differ from the credential type name:
+ * `DigitalConformityCredential` is documented at `ConformityCredential`,
+ * `DigitalTraceabilityEvent` at the plural `DigitalTraceabilityEvents`, and
+ * `ConformityScheme` at `ConformityVocabularyCatalog`.
+ */
+export declare const UNTP_SPECIFICATION_PAGE_SLUGS: Record<string, string>;
+/**
+ * The UNTP docs version currently served at the unversioned ("current") docs
+ * path. This version is linked at `/docs/specification/<slug>`; older versions
+ * are linked at `/docs/<version>/specification/<slug>`.
+ *
+ * Maintenance point: update this when UNTP promotes a newer docs version to
+ * current. The previously-current version then gains its own
+ * `/docs/<version>/` path, so this constant moving keeps existing links
+ * pointing at the right version.
+ */
+export declare const CURRENT_UNTP_DOCS_VERSION = "0.7.0";
+/**
+ * Builds the human-readable UNTP specification page URL for a credential /
+ * artefact type at a given version.
+ *
+ * The current docs version ({@link CURRENT_UNTP_DOCS_VERSION}) is served at
+ * the unversioned `/docs/specification/<slug>` path; older versions resolve to
+ * `/docs/<version>/specification/<slug>`. Versions without their own docs fall
+ * back to the nearest published docs version (see `DOCS_VERSION_FALLBACKS`).
+ *
+ * @param type - UNTP credential / artefact type (e.g. `DigitalProductPassport`).
+ * @param version - Semantic version of the artefact (e.g. `0.7.0`).
+ * @returns The specification page URL.
+ * @throws {Error} When `type` is not a recognised UNTP artefact type.
+ */
+export declare function buildSpecificationPageUrl(type: string, version: string): string;
+/** The schema and context URLs for a UNTP artefact. */
+export interface UntpArtefactUrls {
+    /** URL of the JSON Schema the document validates against. */
+    schemaUrl: string;
+    /** URL of the JSON-LD context the document references in `@context`. */
+    contextUrl: string;
+}
+/**
+ * Builds the JSON Schema and JSON-LD context URLs for a UNTP artefact.
+ *
+ * `ConformityScheme` was introduced in v0.7.0 and has no legacy layout; only
+ * call it with a v0.7.0+ version.
+ *
+ * @param type - UNTP credential / artefact type (e.g. `DigitalProductPassport`,
+ *   `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.
+ */
+export declare function buildUntpArtefactUrls(type: string, version: string): UntpArtefactUrls;

package/build/artefacts/urls.js

@@ -0,0 +1,133 @@
+/**
+ * Construction of UNTP artefact URLs (JSON Schema and JSON-LD context) for a
+ * given credential / artefact type and spec version.
+ *
+ * UNTP v0.7.0 relocated the artefacts. Schemas moved from the legacy
+ * per-credential-type layout on `test.uncefact.org` to the unece.org
+ * artefacts origin, and the JSON-LD context was unified into a single
+ * per-version context on `vocabulary.uncefact.org` (the same context URL for
+ * every type, including the Conformity Vocabulary Catalogue `ConformityScheme`
+ * artefact, which was introduced in v0.7.0). Earlier versions (v0.6.x)
+ * continue to be served from the legacy layout. This is the forward
+ * counterpart to {@link detectVersionFromContext}, which derives the version
+ * from a context URL.
+ *
+ * @see https://untp.unece.org/artefacts/schema/v0.7.0/dpp/DigitalProductPassport.json
+ * @see https://vocabulary.uncefact.org/untp/0.7.0/context/
+ */
+import { isV070OrAbove } from './version.js';
+const LEGACY_BASE = 'https://test.uncefact.org/vocabulary/untp';
+const ARTEFACTS_SCHEMA_BASE = 'https://untp.unece.org/artefacts/schema';
+const UNIFIED_CONTEXT_BASE = 'https://vocabulary.uncefact.org/untp';
+/** Short artefact codes used in UNTP artefact paths, keyed by credential / artefact type. */
+export const UNTP_SHORT_CREDENTIAL_TYPES = {
+    DigitalProductPassport: 'dpp',
+    DigitalConformityCredential: 'dcc',
+    DigitalTraceabilityEvent: 'dte',
+    DigitalFacilityRecord: 'dfr',
+    DigitalIdentityAnchor: 'dia',
+    ConformityScheme: 'cvc',
+};
+/**
+ * v0.7.0+ core schema file names keyed by credential / artefact type. Most
+ * match the type verbatim; `DigitalConformityCredential` is published as
+ * `ConformityCredential`.
+ */
+export const UNTP_CORE_SCHEMA_FILENAMES = {
+    DigitalProductPassport: 'DigitalProductPassport',
+    DigitalConformityCredential: 'ConformityCredential',
+    DigitalTraceabilityEvent: 'DigitalTraceabilityEvent',
+    DigitalFacilityRecord: 'DigitalFacilityRecord',
+    DigitalIdentityAnchor: 'DigitalIdentityAnchor',
+    ConformityScheme: 'ConformityScheme',
+};
+const DOCS_BASE = 'https://untp.unece.org/docs';
+/**
+ * UNTP specification page slugs keyed by credential / artefact type. Slugs are
+ * version-independent. Several differ from the credential type name:
+ * `DigitalConformityCredential` is documented at `ConformityCredential`,
+ * `DigitalTraceabilityEvent` at the plural `DigitalTraceabilityEvents`, and
+ * `ConformityScheme` at `ConformityVocabularyCatalog`.
+ */
+export const UNTP_SPECIFICATION_PAGE_SLUGS = {
+    DigitalProductPassport: 'DigitalProductPassport',
+    DigitalConformityCredential: 'ConformityCredential',
+    DigitalTraceabilityEvent: 'DigitalTraceabilityEvents',
+    DigitalFacilityRecord: 'DigitalFacilityRecord',
+    DigitalIdentityAnchor: 'DigitalIdentityAnchor',
+    ConformityScheme: 'ConformityVocabularyCatalog',
+};
+/**
+ * The UNTP docs version currently served at the unversioned ("current") docs
+ * path. This version is linked at `/docs/specification/<slug>`; older versions
+ * are linked at `/docs/<version>/specification/<slug>`.
+ *
+ * Maintenance point: update this when UNTP promotes a newer docs version to
+ * current. The previously-current version then gains its own
+ * `/docs/<version>/` path, so this constant moving keeps existing links
+ * pointing at the right version.
+ */
+export const CURRENT_UNTP_DOCS_VERSION = '0.7.0';
+/**
+ * Versions that ship no docs of their own, mapped to the published docs
+ * version that covers them. UNTP released 0.6.1 schemas without separate
+ * 0.6.1 docs; the 0.6.0 docs document the whole 0.6.x line.
+ */
+const DOCS_VERSION_FALLBACKS = {
+    '0.6.1': '0.6.0',
+};
+/**
+ * Builds the human-readable UNTP specification page URL for a credential /
+ * artefact type at a given version.
+ *
+ * The current docs version ({@link CURRENT_UNTP_DOCS_VERSION}) is served at
+ * the unversioned `/docs/specification/<slug>` path; older versions resolve to
+ * `/docs/<version>/specification/<slug>`. Versions without their own docs fall
+ * back to the nearest published docs version (see `DOCS_VERSION_FALLBACKS`).
+ *
+ * @param type - UNTP credential / artefact type (e.g. `DigitalProductPassport`).
+ * @param version - Semantic version of the artefact (e.g. `0.7.0`).
+ * @returns The specification page URL.
+ * @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) {
+        throw new Error(`Unknown UNTP artefact type "${type}". Expected one of: ${Object.keys(UNTP_SPECIFICATION_PAGE_SLUGS).join(', ')}.`);
+    }
+    const docsVersion = DOCS_VERSION_FALLBACKS[version] ?? version;
+    if (docsVersion === CURRENT_UNTP_DOCS_VERSION) {
+        return `${DOCS_BASE}/specification/${slug}`;
+    }
+    return `${DOCS_BASE}/${docsVersion}/specification/${slug}`;
+}
+/**
+ * Builds the JSON Schema and JSON-LD context URLs for a UNTP artefact.
+ *
+ * `ConformityScheme` was introduced in v0.7.0 and has no legacy layout; only
+ * call it with a v0.7.0+ version.
+ *
+ * @param type - UNTP credential / artefact type (e.g. `DigitalProductPassport`,
+ *   `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.
+ */
+export function buildUntpArtefactUrls(type, version) {
+    const shortCode = UNTP_SHORT_CREDENTIAL_TYPES[type];
+    if (!shortCode) {
+        throw new Error(`Unknown UNTP artefact type "${type}". Expected one of: ${Object.keys(UNTP_SHORT_CREDENTIAL_TYPES).join(', ')}.`);
+    }
+    if (isV070OrAbove(version)) {
+        const fileName = UNTP_CORE_SCHEMA_FILENAMES[type];
+        return {
+            schemaUrl: `${ARTEFACTS_SCHEMA_BASE}/v${version}/${shortCode}/${fileName}.json`,
+            contextUrl: `${UNIFIED_CONTEXT_BASE}/${version}/context/`,
+        };
+    }
+    return {
+        schemaUrl: `${LEGACY_BASE}/${shortCode}/untp-${shortCode}-schema-${version}.json`,
+        contextUrl: `${LEGACY_BASE}/${shortCode}/${version}/context/`,
+    };
+}
+//# sourceMappingURL=urls.js.map

package/build/artefacts/urls.js.map

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

package/build/artefacts/urls.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/artefacts/urls.test.js

@@ -0,0 +1,91 @@
+import { buildUntpArtefactUrls, buildSpecificationPageUrl, UNTP_SHORT_CREDENTIAL_TYPES, UNTP_CORE_SCHEMA_FILENAMES, UNTP_SPECIFICATION_PAGE_SLUGS, } from './urls';
+describe('buildUntpArtefactUrls', () => {
+    describe('v0.6.x (legacy layout)', () => {
+        it('builds the legacy per-credential-type schema and context URLs', () => {
+            expect(buildUntpArtefactUrls('DigitalProductPassport', '0.6.1')).toEqual({
+                schemaUrl: 'https://test.uncefact.org/vocabulary/untp/dpp/untp-dpp-schema-0.6.1.json',
+                contextUrl: 'https://test.uncefact.org/vocabulary/untp/dpp/0.6.1/context/',
+            });
+        });
+        it('uses the legacy layout for v0.6.0', () => {
+            expect(buildUntpArtefactUrls('DigitalConformityCredential', '0.6.0')).toEqual({
+                schemaUrl: 'https://test.uncefact.org/vocabulary/untp/dcc/untp-dcc-schema-0.6.0.json',
+                contextUrl: 'https://test.uncefact.org/vocabulary/untp/dcc/0.6.0/context/',
+            });
+        });
+    });
+    describe('v0.7.0+ (artefacts layout)', () => {
+        it('builds the artefacts schema URL and unified context URL for DPP', () => {
+            expect(buildUntpArtefactUrls('DigitalProductPassport', '0.7.0')).toEqual({
+                schemaUrl: 'https://untp.unece.org/artefacts/schema/v0.7.0/dpp/DigitalProductPassport.json',
+                contextUrl: 'https://vocabulary.uncefact.org/untp/0.7.0/context/',
+            });
+        });
+        it('maps DigitalConformityCredential to the ConformityCredential schema file name', () => {
+            expect(buildUntpArtefactUrls('DigitalConformityCredential', '0.7.0').schemaUrl).toBe('https://untp.unece.org/artefacts/schema/v0.7.0/dcc/ConformityCredential.json');
+        });
+        it.each([
+            ['DigitalFacilityRecord', 'dfr', 'DigitalFacilityRecord'],
+            ['DigitalIdentityAnchor', 'dia', 'DigitalIdentityAnchor'],
+            ['DigitalTraceabilityEvent', 'dte', 'DigitalTraceabilityEvent'],
+        ])('builds the artefacts schema URL for %s', (type, shortCode, fileName) => {
+            expect(buildUntpArtefactUrls(type, '0.7.0').schemaUrl).toBe(`https://untp.unece.org/artefacts/schema/v0.7.0/${shortCode}/${fileName}.json`);
+        });
+        it('builds the artefacts schema and unified context URLs for ConformityScheme (introduced in v0.7.0)', () => {
+            expect(buildUntpArtefactUrls('ConformityScheme', '0.7.0')).toEqual({
+                schemaUrl: 'https://untp.unece.org/artefacts/schema/v0.7.0/cvc/ConformityScheme.json',
+                contextUrl: 'https://vocabulary.uncefact.org/untp/0.7.0/context/',
+            });
+        });
+        it('shares one unified context URL across credentials and the conformity scheme', () => {
+            const dpp = buildUntpArtefactUrls('DigitalProductPassport', '0.7.0').contextUrl;
+            const dte = buildUntpArtefactUrls('DigitalTraceabilityEvent', '0.7.0').contextUrl;
+            const cvc = buildUntpArtefactUrls('ConformityScheme', '0.7.0').contextUrl;
+            expect(new Set([dpp, dte, cvc]).size).toBe(1);
+            expect(dpp).toBe('https://vocabulary.uncefact.org/untp/0.7.0/context/');
+        });
+        it('treats a future minor (0.8.0) as the artefacts layout', () => {
+            expect(buildUntpArtefactUrls('DigitalProductPassport', '0.8.0').schemaUrl).toBe('https://untp.unece.org/artefacts/schema/v0.8.0/dpp/DigitalProductPassport.json');
+        });
+        it('treats a future major (1.0.0) as the artefacts layout', () => {
+            expect(buildUntpArtefactUrls('DigitalProductPassport', '1.0.0').contextUrl).toBe('https://vocabulary.uncefact.org/untp/1.0.0/context/');
+        });
+    });
+    describe('unknown artefact type', () => {
+        it('throws with a helpful message listing the supported types', () => {
+            expect(() => buildUntpArtefactUrls('DigitalLivestockPassport', '0.7.0')).toThrow(/Unknown UNTP artefact type/);
+        });
+    });
+    describe('exported maps', () => {
+        it('the short-code and schema-filename maps agree on the set of supported types', () => {
+            expect(Object.keys(UNTP_SHORT_CREDENTIAL_TYPES).sort()).toEqual(Object.keys(UNTP_CORE_SCHEMA_FILENAMES).sort());
+        });
+    });
+});
+describe('buildSpecificationPageUrl', () => {
+    it('links the current docs version (0.7.0) at the unversioned path', () => {
+        expect(buildSpecificationPageUrl('DigitalProductPassport', '0.7.0')).toBe('https://untp.unece.org/docs/specification/DigitalProductPassport');
+    });
+    it('links an older version (0.6.0) at the versioned path', () => {
+        expect(buildSpecificationPageUrl('DigitalProductPassport', '0.6.0')).toBe('https://untp.unece.org/docs/0.6.0/specification/DigitalProductPassport');
+    });
+    it('falls back to the 0.6.0 docs for 0.6.1 (which has no docs of its own)', () => {
+        expect(buildSpecificationPageUrl('DigitalProductPassport', '0.6.1')).toBe('https://untp.unece.org/docs/0.6.0/specification/DigitalProductPassport');
+    });
+    it('uses the ConformityCredential slug for DigitalConformityCredential', () => {
+        expect(buildSpecificationPageUrl('DigitalConformityCredential', '0.7.0')).toBe('https://untp.unece.org/docs/specification/ConformityCredential');
+    });
+    it('uses the plural DigitalTraceabilityEvents slug for DigitalTraceabilityEvent', () => {
+        expect(buildSpecificationPageUrl('DigitalTraceabilityEvent', '0.6.0')).toBe('https://untp.unece.org/docs/0.6.0/specification/DigitalTraceabilityEvents');
+    });
+    it('uses the ConformityVocabularyCatalog slug for ConformityScheme', () => {
+        expect(buildSpecificationPageUrl('ConformityScheme', '0.7.0')).toBe('https://untp.unece.org/docs/specification/ConformityVocabularyCatalog');
+    });
+    it('throws for an unknown artefact type', () => {
+        expect(() => buildSpecificationPageUrl('DigitalLivestockPassport', '0.7.0')).toThrow(/Unknown UNTP artefact type/);
+    });
+    it('keeps the slug set aligned with the short-code map', () => {
+        expect(Object.keys(UNTP_SPECIFICATION_PAGE_SLUGS).sort()).toEqual(Object.keys(UNTP_SHORT_CREDENTIAL_TYPES).sort());
+    });
+});
+//# sourceMappingURL=urls.test.js.map

package/build/artefacts/urls.test.js.map

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

package/build/artefacts/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * UNTP spec version predicates.
+ *
+ * The v0.7.0 boundary is significant because v0.7.0 relocated the published
+ * artefacts (see `./urls.ts`): schema origin, context unification, and the
+ * introduction of the Conformity Vocabulary Catalogue.
+ */
+/** Returns true when the given UNTP version string is v0.7.0 or newer. */
+export declare function isV070OrAbove(version: string): boolean;

package/build/artefacts/version.js

@@ -0,0 +1,17 @@
+/**
+ * UNTP spec version predicates.
+ *
+ * The v0.7.0 boundary is significant because v0.7.0 relocated the published
+ * artefacts (see `./urls.ts`): schema origin, context unification, and the
+ * introduction of the Conformity Vocabulary Catalogue.
+ */
+/** Returns true when the given UNTP version string is v0.7.0 or newer. */
+export function isV070OrAbove(version) {
+    const match = version.match(/^(\d+)\.(\d+)/);
+    if (!match)
+        return false;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return major > 0 || (major === 0 && minor >= 7);
+}
+//# sourceMappingURL=version.js.map

package/build/artefacts/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/artefacts/version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/build/artefacts/version.test.d.ts

@@ -0,0 +1 @@
+export {};