@uncefact/untp-utils 0.1.0 → 0.3.0

package/build/loaders/jsonld-document-loader.test.js

@@ -0,0 +1,111 @@
+import { ResolverNetworkError } from '../resolvers/errors.js';
+import { ResolutionFailedError } from '../node/errors.js';
+import { createInMemoryTtlCache } from '../cache/in-memory-ttl-cache.js';
+import { jest } from '@jest/globals';
+const resolveJsonDocument = jest.fn();
+jest.unstable_mockModule('../resolvers/index.js', () => ({
+    resolveJsonDocument,
+}));
+const { createJsonLdDocumentLoader } = await import('./jsonld-document-loader.js');
+describe('createJsonLdDocumentLoader', () => {
+    beforeEach(() => {
+        resolveJsonDocument.mockReset();
+    });
+    it('resolves the URL through resolveJsonDocument and returns the RemoteDocument shape', async () => {
+        resolveJsonDocument.mockResolvedValue({
+            json: { '@context': { name: 'http://schema.org/name' } },
+            finalUrl: 'https://ex.test/ctx',
+        });
+        const result = await createJsonLdDocumentLoader()('https://ex.test/ctx');
+        expect(result).toEqual({
+            documentUrl: 'https://ex.test/ctx',
+            document: { '@context': { name: 'http://schema.org/name' } },
+        });
+    });
+    it('requests JSON-LD via the default Accept', async () => {
+        resolveJsonDocument.mockResolvedValue({ json: {}, finalUrl: 'https://ex.test/ctx' });
+        await createJsonLdDocumentLoader()('https://ex.test/ctx');
+        expect(resolveJsonDocument).toHaveBeenCalledWith('https://ex.test/ctx', expect.objectContaining({ accept: expect.stringContaining('application/ld+json') }));
+    });
+    it('lets the caller override the Accept header', async () => {
+        resolveJsonDocument.mockResolvedValue({ json: {}, finalUrl: 'https://ex.test/ctx' });
+        await createJsonLdDocumentLoader({ accept: 'application/json' })('https://ex.test/ctx');
+        expect(resolveJsonDocument).toHaveBeenCalledWith('https://ex.test/ctx', expect.objectContaining({ accept: 'application/json' }));
+    });
+    it('reports the post-redirect finalUrl as documentUrl', async () => {
+        resolveJsonDocument.mockResolvedValue({ json: {}, finalUrl: 'https://ex.test/final' });
+        const result = await createJsonLdDocumentLoader()('https://ex.test/start');
+        expect(result.documentUrl).toBe('https://ex.test/final');
+    });
+    it('forwards resolver options (e.g. allowedSchemes) to resolveJsonDocument', async () => {
+        resolveJsonDocument.mockResolvedValue({ json: {}, finalUrl: 'https://ex.test/ctx' });
+        await createJsonLdDocumentLoader({ allowedSchemes: ['https'] })('https://ex.test/ctx');
+        expect(resolveJsonDocument).toHaveBeenCalledWith('https://ex.test/ctx', expect.objectContaining({ allowedSchemes: ['https'] }));
+    });
+    it('propagates resolveJsonDocument rejections (SSRF guard, HTTP errors, bad JSON) unchanged', async () => {
+        const guardError = Object.assign(new Error('private address'), { code: 'url.private-address' });
+        resolveJsonDocument.mockRejectedValue(guardError);
+        await expect(createJsonLdDocumentLoader()('http://127.0.0.1/ctx')).rejects.toBe(guardError);
+    });
+    describe('with a cache', () => {
+        it('reuses a resolved context within the TTL instead of re-fetching', async () => {
+            resolveJsonDocument.mockResolvedValue({ json: { '@context': {} }, finalUrl: 'https://ex.test/ctx' });
+            const cache = createInMemoryTtlCache({ ttlMs: 60_000 });
+            const load = createJsonLdDocumentLoader({ cache });
+            await load('https://ex.test/ctx');
+            await load('https://ex.test/ctx');
+            expect(resolveJsonDocument).toHaveBeenCalledTimes(1);
+        });
+        it('does not cache a rejected resolution (re-checks next time)', async () => {
+            const cache = createInMemoryTtlCache({ ttlMs: 60_000 });
+            const load = createJsonLdDocumentLoader({ cache });
+            resolveJsonDocument.mockRejectedValueOnce(new Error('blocked'));
+            await expect(load('https://ex.test/ctx')).rejects.toThrow('blocked');
+            resolveJsonDocument.mockResolvedValueOnce({ json: {}, finalUrl: 'https://ex.test/ctx' });
+            await expect(load('https://ex.test/ctx')).resolves.toEqual({
+                documentUrl: 'https://ex.test/ctx',
+                document: {},
+            });
+            expect(resolveJsonDocument).toHaveBeenCalledTimes(2);
+        });
+    });
+});
+describe('createJsonLdDocumentLoader bundled fallback', () => {
+    const CONTEXT_URL = 'https://vocabulary.uncefact.org/untp/0.7.0/context/';
+    beforeEach(() => {
+        resolveJsonDocument.mockReset();
+    });
+    it('serves the bundled context under the requested URL when its fetch fails', async () => {
+        resolveJsonDocument.mockRejectedValue(new ResolverNetworkError(CONTEXT_URL, new Error('ENOTFOUND')));
+        const onBundledFallback = jest.fn();
+        const load = createJsonLdDocumentLoader({ onBundledFallback });
+        const result = await load(CONTEXT_URL);
+        expect(result.documentUrl).toBe(CONTEXT_URL);
+        expect(Object.keys(result.document)).toContain('@context');
+        expect(onBundledFallback).toHaveBeenCalledWith({ url: CONTEXT_URL, cause: expect.any(Error) });
+    });
+    it('rethrows for a context the bundle does not carry', async () => {
+        const cause = new ResolverNetworkError('https://example.com/context.jsonld', new Error('ENOTFOUND'));
+        resolveJsonDocument.mockRejectedValue(cause);
+        const load = createJsonLdDocumentLoader();
+        await expect(load('https://example.com/context.jsonld')).rejects.toBe(cause);
+    });
+    it('serves the copy when the context host name stops resolving', async () => {
+        resolveJsonDocument.mockRejectedValue(new ResolutionFailedError('vocabulary.uncefact.org', new Error('ENOTFOUND')));
+        const result = await createJsonLdDocumentLoader()(CONTEXT_URL);
+        expect(result.documentUrl).toBe(CONTEXT_URL);
+    });
+    it('rethrows when the fallback is switched off', async () => {
+        const cause = new ResolverNetworkError(CONTEXT_URL, new Error('ENOTFOUND'));
+        resolveJsonDocument.mockRejectedValue(cause);
+        await expect(createJsonLdDocumentLoader({ bundledFallback: false })(CONTEXT_URL)).rejects.toBe(cause);
+    });
+    it('caches a bundled context so the next load does not retry the network', async () => {
+        resolveJsonDocument.mockRejectedValue(new ResolverNetworkError(CONTEXT_URL, new Error('ENOTFOUND')));
+        const load = createJsonLdDocumentLoader({ cache: createInMemoryTtlCache({ ttlMs: 60_000 }) });
+        await load(CONTEXT_URL);
+        await load(CONTEXT_URL);
+        expect(resolveJsonDocument).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=jsonld-document-loader.test.js.map

package/build/loaders/jsonld-document-loader.test.js.map

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

package/build/loaders/schema-loader.d.ts

@@ -0,0 +1,31 @@
+import type { BundledFallbackOptions } from '../bundle/fallback.js';
+import type { TtlCache } from '../cache/ttl-cache.js';
+/**
+ * Loads a JSON Schema document by URL. `T` declares the shape the caller
+ * expects the fetched schema to have; the loader asserts the parsed JSON to
+ * `T` without runtime validation, so a mismatch surfaces downstream (for
+ * schemas, at Ajv compile time).
+ */
+export interface SchemaLoader<T extends object = object> {
+    load(url: string): Promise<T>;
+}
+/**
+ * Returns a {@link SchemaLoader} that fetches schemas over HTTP through the
+ * guarded resolver. If `cache` is supplied, results are read through the
+ * cache; otherwise every call makes a fresh network request. Failed loads
+ * are never cached; a successfully fetched and parsed document is cached
+ * even if it later fails Ajv compilation.
+ *
+ * When the host cannot deliver a bundled UNTP artefact (see
+ * `isHostDeliveryFailure`: unreachable, non-2xx, bad body, size, redirect or
+ * time bounds), the bundled copy is returned instead and
+ * `options.onBundledFallback` is told (see {@link BundledFallbackOptions}); a
+ * bundled copy served this way is cached like a fetched one. A URL the SSRF
+ * guard refused, an unexpected error, and any URL the bundle does not carry
+ * fail exactly as before.
+ *
+ * @throws {SchemaLoaderError} on `load(url)` if the underlying fetch fails
+ *   and no bundled copy stands in. The concrete subclass identifies which
+ *   step failed.
+ */
+export declare function createSchemaLoader<T extends object = object>(cache?: TtlCache<T>, options?: BundledFallbackOptions): SchemaLoader<T>;

package/build/loaders/schema-loader.js

@@ -0,0 +1,83 @@
+import { withBundledFallback } from '../bundle/fallback.js';
+import { ResolverHttpError, ResolverInvalidJsonError, ResolverNetworkError } from '../resolvers/errors.js';
+import { SchemaLoaderHttpError, SchemaLoaderInvalidJsonError, SchemaLoaderNetworkError } from './errors.js';
+const FETCH_TIMEOUT_MS = 10_000;
+const SCHEMA_ACCEPT = 'application/schema+json, application/json;q=0.9';
+/**
+ * Maps the guarded resolver's typed errors onto this package's public error
+ * contract. HTTP-status and invalid-JSON failures keep their dedicated types.
+ * The two failure modes that predate the guarded resolver (plain network
+ * errors and unparseable JSON) unwrap to their underlying transport / parser
+ * error, so `received` and `cause` carry the raw diagnostic exactly as they
+ * did before the resolver was introduced. Every other failure (timeout, size
+ * cap, redirect cap, SSRF / URL-validation rejections) surfaces as
+ * {@link SchemaLoaderNetworkError} with the typed resolver error preserved on
+ * `cause`, because for those the typed error is the informative diagnostic.
+ */
+function toSchemaLoaderError(url, cause) {
+    if (cause instanceof ResolverHttpError) {
+        return new SchemaLoaderHttpError(url, cause.status);
+    }
+    if (cause instanceof ResolverInvalidJsonError) {
+        return new SchemaLoaderInvalidJsonError(url, cause.cause ?? cause);
+    }
+    if (cause instanceof ResolverNetworkError) {
+        return new SchemaLoaderNetworkError(url, cause.cause ?? cause);
+    }
+    return new SchemaLoaderNetworkError(url, cause);
+}
+/**
+ * Fetches a schema through the guarded resolver so the URL passes the
+ * `validatePublicUrl` SSRF guard (public scheme, non-private/non-metadata
+ * address, IP-pinned) with the resolver's size, redirect, and timeout bounds
+ * applied.
+ *
+ * @throws {SchemaLoaderNetworkError} if the request rejects, times out, or fails the SSRF guard.
+ * @throws {SchemaLoaderHttpError} on a non-2xx HTTP status.
+ * @throws {SchemaLoaderInvalidJsonError} if the body is not parseable as JSON.
+ */
+async function fetchSchema(url, options) {
+    // Lazy import: the resolver stack pulls in undici, which jsdom test
+    // environments cannot evaluate, so it loads at fetch time to keep this
+    // module importable there.
+    const { resolveJsonDocument } = await import('../resolvers/index.js');
+    try {
+        // The fallback classifies the resolver's own error, before it is mapped
+        // to this package's public error classes, so an untyped failure inside
+        // the fetch never reads as a host outage.
+        return await withBundledFallback(url, options, async () => {
+            const { json } = await resolveJsonDocument(url, { accept: SCHEMA_ACCEPT, totalTimeoutMs: FETCH_TIMEOUT_MS });
+            return json;
+        });
+    }
+    catch (cause) {
+        throw toSchemaLoaderError(url, cause);
+    }
+}
+/**
+ * Returns a {@link SchemaLoader} that fetches schemas over HTTP through the
+ * guarded resolver. If `cache` is supplied, results are read through the
+ * cache; otherwise every call makes a fresh network request. Failed loads
+ * are never cached; a successfully fetched and parsed document is cached
+ * even if it later fails Ajv compilation.
+ *
+ * When the host cannot deliver a bundled UNTP artefact (see
+ * `isHostDeliveryFailure`: unreachable, non-2xx, bad body, size, redirect or
+ * time bounds), the bundled copy is returned instead and
+ * `options.onBundledFallback` is told (see {@link BundledFallbackOptions}); a
+ * bundled copy served this way is cached like a fetched one. A URL the SSRF
+ * guard refused, an unexpected error, and any URL the bundle does not carry
+ * fail exactly as before.
+ *
+ * @throws {SchemaLoaderError} on `load(url)` if the underlying fetch fails
+ *   and no bundled copy stands in. The concrete subclass identifies which
+ *   step failed.
+ */
+export function createSchemaLoader(cache, options) {
+    const load = (url) => fetchSchema(url, options);
+    if (!cache) {
+        return { load };
+    }
+    return { load: (url) => cache.get(url, () => load(url)) };
+}
+//# sourceMappingURL=schema-loader.js.map

package/build/loaders/schema-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-loader.js","sourceRoot":"","sources":["../../src/loaders/schema-loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAY5G,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,aAAa,GAAG,iDAAiD,CAAC;AAExE;;;;;;;;;;GAUG;AACH,SAAS,mBAAmB,CAAC,GAAW,EAAE,KAAc;IACtD,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;QACvC,OAAO,IAAI,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;QAC9C,OAAO,IAAI,4BAA4B,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;QAC1C,OAAO,IAAI,wBAAwB,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,wBAAwB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,WAAW,CAAmB,GAAW,EAAE,OAA2C;IACnG,oEAAoE;IACpE,uEAAuE;IACvE,2BAA2B;IAC3B,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,wEAAwE;QACxE,uEAAuE;QACvE,0CAA0C;QAC1C,OAAO,MAAM,mBAAmB,CAAI,GAAG,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;YAC3D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAC7G,OAAO,IAAS,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAmB,EACnB,OAAgC;IAEhC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,WAAW,CAAI,GAAG,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/build/loaders/schema-loader.ssrf.test.d.ts

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

package/build/loaders/schema-loader.ssrf.test.js

@@ -0,0 +1,55 @@
+import http from 'node:http';
+import { createSchemaLoader } from './schema-loader.js';
+import { SchemaLoaderNetworkError } from './errors.js';
+import { UrlValidationError } from '../node/errors.js';
+/**
+ * End-to-end SSRF regression for schema loading. Unlike `schema-loader.test.ts`,
+ * this suite does NOT mock the resolver stack: it exercises the real
+ * `createSchemaLoader` -> `resolveJsonDocument` -> `validatePublicUrl` chain
+ * against a live loopback server standing in for an internal service.
+ *
+ * The load-bearing assertion is that the canary server is NEVER contacted. The
+ * pre-guard implementation fetched schemas with a raw `fetch` that would have
+ * reached a private URL; the guard rejects it before any connection.
+ *
+ * @see https://github.com/uncefact/tests-untp/issues/707
+ */
+describe('createSchemaLoader SSRF guard (real resolver stack)', () => {
+    let server;
+    let baseUrl;
+    let hits = 0;
+    beforeAll(async () => {
+        server = http.createServer((_req, res) => {
+            hits += 1;
+            res.setHeader('content-type', 'application/schema+json');
+            res.end(JSON.stringify({ $schema: 'https://json-schema.org/draft/2020-12/schema' }));
+        });
+        await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+        const address = server.address();
+        baseUrl = `http://127.0.0.1:${address.port}`;
+    });
+    afterAll(async () => {
+        await new Promise((resolve, reject) => server.close((err) => (err ? reject(err) : resolve())));
+    });
+    beforeEach(() => {
+        hits = 0;
+    });
+    it('never contacts a private schema URL', async () => {
+        const error = await createSchemaLoader()
+            .load(`${baseUrl}/schema.json`)
+            .catch((e) => e);
+        expect(error).toBeInstanceOf(SchemaLoaderNetworkError);
+        // The rejection came from the SSRF guard, preserved on the cause chain.
+        expect(error.cause).toBeInstanceOf(UrlValidationError);
+        // The security property: the loopback canary was never reached.
+        expect(hits).toBe(0);
+    });
+    it('rejects a metadata-service schema URL literal', async () => {
+        const error = await createSchemaLoader()
+            .load('http://169.254.169.254/latest/schema.json')
+            .catch((e) => e);
+        expect(error).toBeInstanceOf(SchemaLoaderNetworkError);
+        expect(error.cause).toBeInstanceOf(UrlValidationError);
+    });
+});
+//# sourceMappingURL=schema-loader.ssrf.test.js.map

package/build/loaders/schema-loader.ssrf.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-loader.ssrf.test.js","sourceRoot":"","sources":["../../src/loaders/schema-loader.ssrf.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IACnE,IAAI,MAAmB,CAAC;IACxB,IAAI,OAAe,CAAC;IACpB,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YACvC,IAAI,IAAI,CAAC,CAAC;YACV,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,yBAAyB,CAAC,CAAC;YACzD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAiB,CAAC;QAChD,OAAO,GAAG,oBAAoB,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,GAAG,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,KAAK,GAAG,MAAM,kBAAkB,EAAE;aACrC,IAAI,CAAC,GAAG,OAAO,cAAc,CAAC;aAC9B,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAE5B,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;QACvD,wEAAwE;QACxE,MAAM,CAAE,KAAkC,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;QACrF,gEAAgE;QAChE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,KAAK,GAAG,MAAM,kBAAkB,EAAE;aACrC,IAAI,CAAC,2CAA2C,CAAC;aACjD,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAE5B,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;QACvD,MAAM,CAAE,KAAkC,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/loaders/schema-loader.test.d.ts

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

package/build/loaders/schema-loader.test.js

@@ -0,0 +1,217 @@
+import { jest } from '@jest/globals';
+import { createInMemoryTtlCache } from '../cache/in-memory-ttl-cache.js';
+import { ResolverHttpError, ResolverInvalidJsonError, ResolverNetworkError, ResolverTimedOutError, } from '../resolvers/errors.js';
+import { PrivateHostnameError, ResolutionFailedError } from '../node/errors.js';
+import { SchemaLoaderError, SchemaLoaderHttpError, SchemaLoaderInvalidJsonError, SchemaLoaderNetworkError, } from './errors.js';
+const resolveJsonDocument = jest.fn();
+// Mock the resolver entry point but keep the real error classes so the
+// loader's `instanceof` mapping continues to work.
+jest.unstable_mockModule('../resolvers/index.js', () => ({
+    resolveJsonDocument,
+    ResolverHttpError,
+    ResolverInvalidJsonError,
+}));
+const { createSchemaLoader } = await import('./schema-loader.js');
+const SCHEMA_URL = 'https://example.com/schema.json';
+function mockOk(body) {
+    resolveJsonDocument.mockResolvedValue({ json: body, finalUrl: SCHEMA_URL });
+}
+describe('createSchemaLoader', () => {
+    beforeEach(() => {
+        resolveJsonDocument.mockReset();
+    });
+    describe('uncached (no cache supplied)', () => {
+        it('resolves with the parsed schema body', async () => {
+            mockOk({ $schema: 'foo' });
+            await expect(createSchemaLoader().load(SCHEMA_URL)).resolves.toEqual({ $schema: 'foo' });
+        });
+        it('fetches the URL through the guarded resolver', async () => {
+            mockOk({ $schema: 'foo' });
+            await createSchemaLoader().load(SCHEMA_URL);
+            expect(resolveJsonDocument).toHaveBeenCalledWith(SCHEMA_URL, expect.objectContaining({
+                accept: expect.stringContaining('application/schema+json'),
+                totalTimeoutMs: 10_000,
+            }));
+        });
+        it('fetches afresh on every call', async () => {
+            mockOk({ $schema: 'foo' });
+            const loader = createSchemaLoader();
+            await loader.load(SCHEMA_URL);
+            await loader.load(SCHEMA_URL);
+            expect(resolveJsonDocument).toHaveBeenCalledTimes(2);
+        });
+        it('types load() by the caller-declared schema shape', async () => {
+            mockOk({ $id: SCHEMA_URL });
+            const loader = createSchemaLoader();
+            const schema = await loader.load(SCHEMA_URL);
+            // The generic is a compile-time assertion only; the value is the parsed JSON.
+            expect(schema.$id).toBe(SCHEMA_URL);
+        });
+    });
+    describe('cached (cache supplied)', () => {
+        it('caches subsequent loads within the TTL', async () => {
+            mockOk({ $schema: 'foo' });
+            const loader = createSchemaLoader(createInMemoryTtlCache({ ttlMs: 60_000 }));
+            await loader.load(SCHEMA_URL);
+            await loader.load(SCHEMA_URL);
+            expect(resolveJsonDocument).toHaveBeenCalledTimes(1);
+        });
+        it('deduplicates concurrent loads for the same URL via the cache', async () => {
+            let resolve;
+            resolveJsonDocument.mockImplementation(() => new Promise((r) => {
+                resolve = r;
+            }));
+            const loader = createSchemaLoader(createInMemoryTtlCache({ ttlMs: 60_000 }));
+            const a = loader.load(SCHEMA_URL);
+            const b = loader.load(SCHEMA_URL);
+            // The loader imports the guarded resolver lazily, so the mocked fetch
+            // starts a tick after load(); wait for it before releasing the promise.
+            while (resolveJsonDocument.mock.calls.length === 0) {
+                await new Promise((r) => setImmediate(r));
+            }
+            resolve({ json: { $schema: 'foo' }, finalUrl: SCHEMA_URL });
+            await expect(a).resolves.toEqual({ $schema: 'foo' });
+            await expect(b).resolves.toEqual({ $schema: 'foo' });
+            expect(resolveJsonDocument).toHaveBeenCalledTimes(1);
+        });
+        it('two loaders with separate caches do not share state', async () => {
+            mockOk({ $schema: 'foo' });
+            const a = createSchemaLoader(createInMemoryTtlCache({ ttlMs: 60_000 }));
+            const b = createSchemaLoader(createInMemoryTtlCache({ ttlMs: 60_000 }));
+            await a.load(SCHEMA_URL);
+            await b.load(SCHEMA_URL);
+            expect(resolveJsonDocument).toHaveBeenCalledTimes(2);
+        });
+        it('clearing the cache forces the next load to re-fetch', async () => {
+            mockOk({ $schema: 'foo' });
+            const cache = createInMemoryTtlCache({ ttlMs: 60_000 });
+            const loader = createSchemaLoader(cache);
+            await loader.load(SCHEMA_URL);
+            expect(resolveJsonDocument).toHaveBeenCalledTimes(1);
+            await cache.clear();
+            await loader.load(SCHEMA_URL);
+            expect(resolveJsonDocument).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe('error mapping (applies to both cached and uncached paths)', () => {
+        it('maps a resolver HTTP error to SchemaLoaderHttpError with the status', async () => {
+            resolveJsonDocument.mockRejectedValue(new ResolverHttpError(SCHEMA_URL, 503));
+            const error = (await createSchemaLoader()
+                .load(SCHEMA_URL)
+                .catch((e) => e));
+            expect(error).toBeInstanceOf(SchemaLoaderHttpError);
+            expect(error.status).toBe(503);
+        });
+        it('maps a resolver invalid-JSON error to SchemaLoaderInvalidJsonError with the parser diagnostic', async () => {
+            const parserError = new Error('Unexpected token < in JSON at position 0');
+            resolveJsonDocument.mockRejectedValue(new ResolverInvalidJsonError(SCHEMA_URL, parserError));
+            const error = (await createSchemaLoader()
+                .load(SCHEMA_URL)
+                .catch((e) => e));
+            expect(error).toBeInstanceOf(SchemaLoaderInvalidJsonError);
+            expect(error.received).toBe('Unexpected token < in JSON at position 0');
+            expect(error.cause).toBe(parserError);
+        });
+        it('maps a resolver network error to SchemaLoaderNetworkError with the transport diagnostic', async () => {
+            const transportError = new Error('connection refused');
+            resolveJsonDocument.mockRejectedValue(new ResolverNetworkError(SCHEMA_URL, transportError));
+            const error = (await createSchemaLoader()
+                .load(SCHEMA_URL)
+                .catch((e) => e));
+            expect(error).toBeInstanceOf(SchemaLoaderNetworkError);
+            expect(error.received).toBe('connection refused');
+            expect(error.cause).toBe(transportError);
+        });
+        it('keeps the typed resolver error as the cause for new failure modes (timeout)', async () => {
+            const cause = new ResolverTimedOutError(SCHEMA_URL, 10_000, new Error('aborted'));
+            resolveJsonDocument.mockRejectedValue(cause);
+            const error = (await createSchemaLoader()
+                .load(SCHEMA_URL)
+                .catch((e) => e));
+            expect(error).toBeInstanceOf(SchemaLoaderNetworkError);
+            expect(error.cause).toBe(cause);
+        });
+        it('maps an SSRF / URL-validation rejection to SchemaLoaderNetworkError, preserving the cause', async () => {
+            const cause = new PrivateHostnameError('127.0.0.1');
+            resolveJsonDocument.mockRejectedValue(cause);
+            const error = (await createSchemaLoader()
+                .load(SCHEMA_URL)
+                .catch((e) => e));
+            expect(error).toBeInstanceOf(SchemaLoaderNetworkError);
+            expect(error.cause).toBe(cause);
+        });
+        it('does not cache failed loads (retries on next call)', async () => {
+            const loader = createSchemaLoader(createInMemoryTtlCache({ ttlMs: 60_000 }));
+            resolveJsonDocument.mockRejectedValueOnce(new ResolverHttpError(SCHEMA_URL, 503));
+            await expect(loader.load(SCHEMA_URL)).rejects.toBeInstanceOf(SchemaLoaderHttpError);
+            mockOk({ $schema: 'foo' });
+            await expect(loader.load(SCHEMA_URL)).resolves.toEqual({ $schema: 'foo' });
+            expect(resolveJsonDocument).toHaveBeenCalledTimes(2);
+        });
+        it('every concrete error extends SchemaLoaderError', async () => {
+            const loader = createSchemaLoader();
+            resolveJsonDocument.mockRejectedValueOnce(new ResolverNetworkError(SCHEMA_URL, new Error('x')));
+            await expect(loader.load(SCHEMA_URL)).rejects.toBeInstanceOf(SchemaLoaderError);
+            resolveJsonDocument.mockRejectedValueOnce(new ResolverHttpError(SCHEMA_URL, 404));
+            await expect(loader.load(SCHEMA_URL)).rejects.toBeInstanceOf(SchemaLoaderError);
+            resolveJsonDocument.mockRejectedValueOnce(new ResolverInvalidJsonError(SCHEMA_URL, new Error('x')));
+            await expect(loader.load(SCHEMA_URL)).rejects.toBeInstanceOf(SchemaLoaderError);
+        });
+    });
+});
+describe('createSchemaLoader bundled fallback', () => {
+    const BUNDLED_URL = 'https://untp.unece.org/artefacts/schema/v0.7.0/dpp/DigitalProductPassport.json';
+    beforeEach(() => {
+        resolveJsonDocument.mockReset();
+    });
+    it('serves the bundled schema when the fetch of a bundled URL fails, and reports it', async () => {
+        resolveJsonDocument.mockRejectedValue(new ResolverNetworkError(BUNDLED_URL, new Error('ENOTFOUND')));
+        const onBundledFallback = jest.fn();
+        const loader = createSchemaLoader(undefined, { onBundledFallback });
+        const schema = await loader.load(BUNDLED_URL);
+        expect(JSON.stringify(schema)).toContain('DigitalProductPassport');
+        expect(onBundledFallback).toHaveBeenCalledTimes(1);
+        expect(onBundledFallback.mock.calls[0][0]).toMatchObject({
+            url: BUNDLED_URL,
+            cause: expect.any(ResolverNetworkError),
+        });
+    });
+    it('falls back on an upstream HTTP failure too, since the artefact is immutable once published', async () => {
+        resolveJsonDocument.mockRejectedValue(new ResolverHttpError(BUNDLED_URL, 403));
+        const loader = createSchemaLoader();
+        await expect(loader.load(BUNDLED_URL)).resolves.toBeDefined();
+    });
+    it('caches a bundled copy so the next load does not retry the network', async () => {
+        resolveJsonDocument.mockRejectedValue(new ResolverNetworkError(BUNDLED_URL, new Error('ENOTFOUND')));
+        const loader = createSchemaLoader(createInMemoryTtlCache({ ttlMs: 60_000 }));
+        await loader.load(BUNDLED_URL);
+        await loader.load(BUNDLED_URL);
+        expect(resolveJsonDocument).toHaveBeenCalledTimes(1);
+    });
+    it('still fails exactly as before for a URL the bundle does not carry', async () => {
+        resolveJsonDocument.mockRejectedValue(new ResolverNetworkError(SCHEMA_URL, new Error('ENOTFOUND')));
+        const onBundledFallback = jest.fn();
+        const loader = createSchemaLoader(undefined, { onBundledFallback });
+        await expect(loader.load(SCHEMA_URL)).rejects.toBeInstanceOf(SchemaLoaderNetworkError);
+        expect(onBundledFallback).not.toHaveBeenCalled();
+    });
+    it('serves the copy when DNS resolution fails, the outage behind uncefact/tests-untp#1006', async () => {
+        resolveJsonDocument.mockRejectedValue(new ResolutionFailedError('untp.unece.org', new Error('ENOTFOUND')));
+        const loader = createSchemaLoader();
+        await expect(loader.load(BUNDLED_URL)).resolves.toBeDefined();
+    });
+    it('rethrows an untyped failure inside the fetch as a loader error instead of serving the copy', async () => {
+        const bug = new TypeError('resolver programming error');
+        resolveJsonDocument.mockRejectedValue(bug);
+        const onBundledFallback = jest.fn();
+        const loader = createSchemaLoader(undefined, { onBundledFallback });
+        await expect(loader.load(BUNDLED_URL)).rejects.toBeInstanceOf(SchemaLoaderNetworkError);
+        expect(onBundledFallback).not.toHaveBeenCalled();
+    });
+    it('can be switched off', async () => {
+        resolveJsonDocument.mockRejectedValue(new ResolverNetworkError(BUNDLED_URL, new Error('ENOTFOUND')));
+        const loader = createSchemaLoader(undefined, { bundledFallback: false });
+        await expect(loader.load(BUNDLED_URL)).rejects.toBeInstanceOf(SchemaLoaderNetworkError);
+    });
+});
+//# sourceMappingURL=schema-loader.test.js.map

package/build/loaders/schema-loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-loader.test.js","sourceRoot":"","sources":["../../src/loaders/schema-loader.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,MAAM,mBAAmB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AAEtC,uEAAuE;AACvE,mDAAmD;AACnD,IAAI,CAAC,mBAAmB,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,CAAC;IACvD,mBAAmB;IACnB,iBAAiB;IACjB,wBAAwB;CACzB,CAAC,CAAC,CAAC;AAEJ,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAElE,MAAM,UAAU,GAAG,iCAAiC,CAAC;AAErD,SAAS,MAAM,CAAC,IAAY;IAC1B,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAW,CAAC,CAAC;AACvF,CAAC;AAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,UAAU,CAAC,GAAG,EAAE;QACd,mBAAmB,CAAC,SAAS,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;QAC5C,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3B,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3B,MAAM,kBAAkB,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5C,MAAM,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,CAC9C,UAAU,EACV,MAAM,CAAC,gBAAgB,CAAC;gBACtB,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,CAAC;gBAC1D,cAAc,EAAE,MAAM;aACvB,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;YAC5C,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;YACpC,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;YAChE,MAAM,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,kBAAkB,EAAmB,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7C,8EAA8E;YAC9E,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;YACtD,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,sBAAsB,CAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YACrF,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;YAC5E,IAAI,OAAyD,CAAC;YAC9D,mBAAmB,CAAC,kBAAkB,CACpC,GAAG,EAAE,CACH,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBAChB,OAAO,GAAG,CAAoD,CAAC;YACjE,CAAC,CAAU,CACd,CAAC;YACF,MAAM,MAAM,GAAG,kBAAkB,CAAC,sBAAsB,CAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAErF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAClC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAClC,sEAAsE;YACtE,wEAAwE;YACxE,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5D,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3B,MAAM,CAAC,GAAG,kBAAkB,CAAC,sBAAsB,CAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAChF,MAAM,CAAC,GAAG,kBAAkB,CAAC,sBAAsB,CAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAChF,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;YACnE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,sBAAsB,CAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACzC,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACrD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACzE,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;YACnF,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAU,CAAC,CAAC;YACvF,MAAM,KAAK,GAAG,CAAC,MAAM,kBAAkB,EAAE;iBACtC,IAAI,CAAC,UAAU,CAAC;iBAChB,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAA0B,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+FAA+F,EAAE,KAAK,IAAI,EAAE;YAC7G,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAC1E,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,wBAAwB,CAAC,UAAU,EAAE,WAAW,CAAU,CAAC,CAAC;YACtG,MAAM,KAAK,GAAG,CAAC,MAAM,kBAAkB,EAAE;iBACtC,IAAI,CAAC,UAAU,CAAC;iBAChB,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAiC,CAAC;YAC7D,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,4BAA4B,CAAC,CAAC;YAC3D,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YACxE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yFAAyF,EAAE,KAAK,IAAI,EAAE;YACvG,MAAM,cAAc,GAAG,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACvD,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,oBAAoB,CAAC,UAAU,EAAE,cAAc,CAAU,CAAC,CAAC;YACrG,MAAM,KAAK,GAAG,CAAC,MAAM,kBAAkB,EAAE;iBACtC,IAAI,CAAC,UAAU,CAAC;iBAChB,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAA6B,CAAC;YACzD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;YAC3F,MAAM,KAAK,GAAG,IAAI,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAClF,mBAAmB,CAAC,iBAAiB,CAAC,KAAc,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,CAAC,MAAM,kBAAkB,EAAE;iBACtC,IAAI,CAAC,UAAU,CAAC;iBAChB,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAA6B,CAAC;YACzD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2FAA2F,EAAE,KAAK,IAAI,EAAE;YACzG,MAAM,KAAK,GAAG,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;YACpD,mBAAmB,CAAC,iBAAiB,CAAC,KAAc,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,CAAC,MAAM,kBAAkB,EAAE;iBACtC,IAAI,CAAC,UAAU,CAAC;iBAChB,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAA6B,CAAC;YACzD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,MAAM,GAAG,kBAAkB,CAAC,sBAAsB,CAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YACrF,mBAAmB,CAAC,qBAAqB,CAAC,IAAI,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAU,CAAC,CAAC;YAC3F,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;YACpF,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3E,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;YACpC,mBAAmB,CAAC,qBAAqB,CAAC,IAAI,oBAAoB,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC,CAAU,CAAC,CAAC;YACzG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;YAChF,mBAAmB,CAAC,qBAAqB,CAAC,IAAI,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAU,CAAC,CAAC;YAC3F,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;YAChF,mBAAmB,CAAC,qBAAqB,CAAC,IAAI,wBAAwB,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC,GAAG,CAAC,CAAU,CAAC,CAAC;YAC7G,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,MAAM,WAAW,GAAG,gFAAgF,CAAC;IAErG,UAAU,CAAC,GAAG,EAAE;QACd,mBAAmB,CAAC,SAAS,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;QAC/F,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,oBAAoB,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,WAAW,CAAC,CAAU,CAAC,CAAC;QAC9G,MAAM,iBAAiB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QACnE,MAAM,CAAC,iBAAiB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YACvD,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC;SACxC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4FAA4F,EAAE,KAAK,IAAI,EAAE;QAC1G,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,CAAC,WAAW,EAAE,GAAG,CAAU,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACpC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,oBAAoB,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,WAAW,CAAC,CAAU,CAAC,CAAC;QAC9G,MAAM,MAAM,GAAG,kBAAkB,CAAC,sBAAsB,CAAS,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACrF,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/B,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/B,MAAM,CAAC,mBAAmB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,oBAAoB,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC,WAAW,CAAC,CAAU,CAAC,CAAC;QAC7G,MAAM,iBAAiB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACpE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;QACvF,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uFAAuF,EAAE,KAAK,IAAI,EAAE;QACrG,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,qBAAqB,CAAC,gBAAgB,EAAE,IAAI,KAAK,CAAC,WAAW,CAAC,CAAU,CAAC,CAAC;QACpH,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACpC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4FAA4F,EAAE,KAAK,IAAI,EAAE;QAC1G,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACxD,mBAAmB,CAAC,iBAAiB,CAAC,GAAY,CAAC,CAAC;QACpD,MAAM,iBAAiB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACpE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;QACxF,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;QACnC,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,oBAAoB,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,WAAW,CAAC,CAAU,CAAC,CAAC;QAC9G,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/multibase-digest/multibase-digest.d.ts

@@ -51,6 +51,15 @@ export declare class MultibaseDigest {
      * @throws If `algorithm` or `base` is not in the allow-list.
      */
     static fromData(data: Uint8Array, opts: MultibaseDigestOptions): Promise<MultibaseDigest>;
+    /**
+     * UTF-8 encodes `text` and delegates to {@link MultibaseDigest.fromData}.
+     * Convenience for the very common case of digesting a string of content
+     * (rendered template HTML, JSON-serialised credential, etc.) without
+     * hand-rolling the `TextEncoder` boilerplate at every call site.
+     *
+     * @throws If `algorithm` or `base` is not in the allow-list.
+     */
+    static fromText(text: string, opts: MultibaseDigestOptions): Promise<MultibaseDigest>;
     /**
      * Wraps an already-computed raw `digest` (the bytes a hash function produces,
      * no multihash prefix) and tags it with the requested multibase encoding. The
@@ -61,6 +70,20 @@ export declare class MultibaseDigest {
      *   does not match the expected size for `algorithm`.
      */
     static fromDigest(digest: Uint8Array, opts: MultibaseDigestOptions): MultibaseDigest;
+    /**
+     * Wraps a hex-encoded raw `digest` and tags it with the requested multibase
+     * encoding. The caller asserts the algorithm; the decoded byte length must
+     * match its expected digest size.
+     *
+     * Provided as the canonical bridge from hex-based legacy systems (Uncefact
+     * storage's pre-migration `hash` field, RI rows still holding hex values
+     * during the multibase migration, etc.) to multibase-encoded consumers.
+     *
+     * @throws If `hex` is empty, contains non-hex characters, or has an odd
+     *   number of characters, or if the decoded byte length does not match
+     *   the expected size for `algorithm`.
+     */
+    static fromHex(hex: string, opts: MultibaseDigestOptions): MultibaseDigest;
     /**
      * Parses a multibase string into a {@link MultibaseDigest}. The algorithm and
      * multibase encoding are both recovered from the string itself: the leading