@uncefact/untp-utils 0.1.0 → 0.3.0

package/build/validation/validate-jsonld.test.js

@@ -0,0 +1,257 @@
+import { jest } from '@jest/globals';
+import { createInMemoryTtlCache } from '../cache/in-memory-ttl-cache.js';
+import { JsonLdExpansionFailedError, JsonLdInvalidShapeError, JsonLdValidationError } from './errors.js';
+const toRDF = jest.fn();
+const expand = jest.fn();
+const documentLoader = jest.fn();
+const createJsonLdDocumentLoader = jest.fn(() => documentLoader);
+jest.unstable_mockModule('jsonld', () => ({
+    default: { toRDF, expand },
+    toRDF,
+    expand,
+}));
+// The loader factory is mocked so this suite can assert the option threading
+// (contextCache -> cache) without invoking the real resolver stack; the
+// factory's own behaviour is covered in loaders/jsonld-document-loader.test.ts.
+jest.unstable_mockModule('../loaders/jsonld-document-loader.js', () => ({
+    createJsonLdDocumentLoader,
+}));
+const { validateJsonLd, expandJsonLd } = await import('./validate-jsonld.js');
+describe('validateJsonLd', () => {
+    beforeEach(() => {
+        toRDF.mockReset();
+        expand.mockReset();
+        documentLoader.mockReset();
+        createJsonLdDocumentLoader.mockClear();
+    });
+    it('returns void when JSON-LD expansion succeeds', async () => {
+        toRDF.mockResolvedValue([]);
+        await expect(validateJsonLd({ '@context': 'https://example.com' })).resolves.toBeUndefined();
+        expect(toRDF).toHaveBeenCalledWith({ '@context': 'https://example.com' }, expect.objectContaining({ safe: true, documentLoader: expect.any(Function) }));
+    });
+    it('throws JsonLdExpansionFailedError when toRDF rejects', async () => {
+        toRDF.mockRejectedValue(new Error('Invalid JSON-LD'));
+        await expect(validateJsonLd({})).rejects.toMatchObject({
+            name: 'JsonLdExpansionFailedError',
+            code: 'jsonld.expansion-failed',
+            received: 'Invalid JSON-LD',
+        });
+    });
+    it('captures the original error on Error.cause', async () => {
+        const cause = new Error('Missing @context');
+        toRDF.mockRejectedValue(cause);
+        await expect(validateJsonLd({})).rejects.toMatchObject({ cause });
+    });
+    describe('rehydrating a buried jsonld.js loader error', () => {
+        // jsonld.js's own JsonLdError stores a document loader's rejection at
+        // the proprietary `details.cause` and never sets native `Error.cause`
+        // (jsonld@8.3.3 `lib/JsonLdError.js`, loader wrap in
+        // `lib/ContextResolver.js`). `validateJsonLd` rehydrates it onto the
+        // caught error's native `cause` so a plain `.cause` walk reaches it,
+        // matching the schema-fetch path (see `validate-jsonld.ssrf.test.ts`).
+        it('rehydrates the buried loader error onto the native cause chain', async () => {
+            const buried = new Error('SSRF rejected');
+            const jsonldError = Object.assign(new Error('Dereferencing a URL did not result in a valid JSON-LD object.'), {
+                name: 'jsonld.InvalidUrl',
+                details: { code: 'loading remote context failed', url: 'https://internal.example', cause: buried },
+            });
+            toRDF.mockRejectedValue(jsonldError);
+            const error = await validateJsonLd({}).catch((e) => e);
+            expect(error.cause).toBe(jsonldError);
+            // Without the rehydration, jsonldError.cause stays unset (jsonld.js
+            // never sets it), so this hop would be absent.
+            expect(jsonldError.cause).toBe(buried);
+        });
+        it('does not add a spurious cause when the jsonld error has no buried loader error', async () => {
+            // A malformed @context never reaches the document loader, so jsonld.js's
+            // details carry no `cause` to rehydrate.
+            const jsonldError = Object.assign(new Error('Invalid JSON-LD syntax; @context must be an object.'), {
+                name: 'jsonld.SyntaxError',
+                details: { code: 'invalid @context' },
+            });
+            toRDF.mockRejectedValue(jsonldError);
+            await validateJsonLd({}).catch(() => undefined);
+            // Asserts absence, not merely `undefined`: an implementation that sets
+            // `error.cause = undefined` unconditionally would pass a `toBeUndefined()`
+            // check but still fabricate a `cause` property that was never there.
+            expect('cause' in jsonldError).toBe(false);
+        });
+        it('does not clobber an existing native cause on the jsonld error', async () => {
+            const existingCause = new Error('existing, legitimate native cause');
+            const buried = new Error('buried loader error, must not overwrite the existing cause');
+            const jsonldError = Object.assign(new Error('wrapped', { cause: existingCause }), {
+                name: 'jsonld.InvalidUrl',
+                details: { cause: buried },
+            });
+            toRDF.mockRejectedValue(jsonldError);
+            await validateJsonLd({}).catch(() => undefined);
+            expect(jsonldError.cause).toBe(existingCause);
+        });
+        // A term's own remote @context (a JSON-LD 1.1 "scoped context") is
+        // resolved through the same document loader, but on failure jsonld.js's
+        // scoped-context branch (lib/context.js) discards the loader's error
+        // entirely and throws a fresh JsonLdError with no `details.cause` at
+        // all (see validate-jsonld.ssrf.test.ts for the real-jsonld
+        // reproduction). validateJsonLd recovers it by tracking the last error
+        // the document loader threw during the call and using that as a
+        // fallback cause.
+        describe('recovering via the tracked-loader fallback', () => {
+            /** Simulates toRDF calling the documentLoader it was given, then rejecting as jsonld.js would. */
+            function rejectAfterCallingLoader(url, rejection) {
+                toRDF.mockImplementation(async (...args) => {
+                    const opts = args[1];
+                    await opts.documentLoader(url).catch(() => undefined);
+                    throw rejection;
+                });
+            }
+            it('recovers the tracked loader error when the jsonld error has no buried cause of its own', async () => {
+                const loaderError = new Error('SSRF rejected, recorded from the tracked loader');
+                documentLoader.mockRejectedValue(loaderError);
+                const scopedContextError = Object.assign(new Error('Invalid JSON-LD syntax; invalid scoped context.'), {
+                    name: 'jsonld.SyntaxError',
+                    details: { code: 'invalid scoped context', context: 'https://internal.example', term: 'myTerm' },
+                });
+                rejectAfterCallingLoader('https://internal.example', scopedContextError);
+                await validateJsonLd({}).catch(() => undefined);
+                // Without the fallback, this jsonld error's details carry no `cause`
+                // at all, so scopedContextError.cause would stay unset.
+                expect(scopedContextError.cause).toBe(loaderError);
+            });
+            it('prefers the buried details.cause over the fallback when jsonld.js kept both', async () => {
+                const buried = new Error('buried on details.cause, should win');
+                const fallbackLoaderError = new Error('recorded from the tracked loader, should lose');
+                documentLoader.mockRejectedValue(fallbackLoaderError);
+                const jsonldError = Object.assign(new Error('wrapped'), {
+                    name: 'jsonld.InvalidUrl',
+                    details: { cause: buried },
+                });
+                rejectAfterCallingLoader('https://example.com', jsonldError);
+                await validateJsonLd({}).catch(() => undefined);
+                expect(jsonldError.cause).toBe(buried);
+            });
+            it('does not fabricate a cause when the loader never threw during the call', async () => {
+                // The loader succeeds (or is never called); the eventual rejection
+                // is for an unrelated reason, so there is nothing to fall back to.
+                documentLoader.mockResolvedValue({ documentUrl: 'https://example.com', document: {} });
+                const unrelatedError = Object.assign(new Error('Invalid JSON-LD syntax; @context must be an object.'), {
+                    name: 'jsonld.SyntaxError',
+                    details: { code: 'invalid @context' },
+                });
+                rejectAfterCallingLoader('https://example.com', unrelatedError);
+                await validateJsonLd({}).catch(() => undefined);
+                expect('cause' in unrelatedError).toBe(false);
+            });
+        });
+    });
+    it('throws JsonLdInvalidShapeError when the document is not an object', async () => {
+        await expect(validateJsonLd('not-an-object')).rejects.toMatchObject({
+            name: 'JsonLdInvalidShapeError',
+            code: 'jsonld.invalid-shape',
+            received: 'string',
+            expected: 'object',
+        });
+        expect(toRDF).not.toHaveBeenCalled();
+    });
+    it('throws JsonLdInvalidShapeError for null input', async () => {
+        await expect(validateJsonLd(null)).rejects.toMatchObject({
+            name: 'JsonLdInvalidShapeError',
+            received: 'null',
+        });
+    });
+    it('passes safe: false to toRDF when options.safe is false', async () => {
+        toRDF.mockResolvedValue([]);
+        await validateJsonLd({ '@context': 'https://example.com' }, { safe: false });
+        expect(toRDF).toHaveBeenCalledWith({ '@context': 'https://example.com' }, expect.objectContaining({ safe: false, documentLoader: expect.any(Function) }));
+    });
+    it('defaults safe to true when no options provided', async () => {
+        toRDF.mockResolvedValue([]);
+        await validateJsonLd({ '@context': 'https://example.com' });
+        expect(toRDF).toHaveBeenCalledWith({ '@context': 'https://example.com' }, expect.objectContaining({ safe: true, documentLoader: expect.any(Function) }));
+    });
+    it('creates the document loader with the supplied contextCache', async () => {
+        toRDF.mockResolvedValue([]);
+        const contextCache = createInMemoryTtlCache({ ttlMs: 60_000 });
+        await validateJsonLd({ '@context': 'https://example.com' }, { contextCache });
+        expect(createJsonLdDocumentLoader).toHaveBeenCalledWith({
+            cache: contextCache,
+            bundledFallback: undefined,
+            onBundledFallback: undefined,
+        });
+    });
+    it('forwards the bundled-fallback switch and listener to the document loader', async () => {
+        const onBundledFallback = jest.fn();
+        await validateJsonLd({ '@context': 'https://example.com' }, { bundledFallback: false, onBundledFallback });
+        expect(createJsonLdDocumentLoader).toHaveBeenCalledWith({
+            cache: undefined,
+            bundledFallback: false,
+            onBundledFallback,
+        });
+    });
+    it('passes toRDF a loader that delegates to the one createJsonLdDocumentLoader created', async () => {
+        toRDF.mockResolvedValue([]);
+        const remoteDoc = { documentUrl: 'https://example.com', document: {} };
+        documentLoader.mockResolvedValue(remoteDoc);
+        await validateJsonLd({ '@context': 'https://example.com' });
+        expect(createJsonLdDocumentLoader).toHaveBeenCalledWith({
+            cache: undefined,
+            bundledFallback: undefined,
+            onBundledFallback: undefined,
+        });
+        // validateJsonLd wraps the created loader (to record failures for
+        // rehydrateJsonLdCause's fallback, see validate-jsonld.ts), so toRDF
+        // receives a different function reference; assert delegation instead.
+        const passedOptions = toRDF.mock.calls[0]?.[1];
+        await expect(passedOptions.documentLoader('https://example.com')).resolves.toBe(remoteDoc);
+        expect(documentLoader).toHaveBeenCalledWith('https://example.com');
+    });
+    it('handles non-Error thrown values', async () => {
+        toRDF.mockRejectedValue('string error');
+        await expect(validateJsonLd({})).rejects.toMatchObject({
+            code: 'jsonld.expansion-failed',
+            received: 'string error',
+        });
+    });
+    it('every concrete error extends JsonLdValidationError', async () => {
+        await expect(validateJsonLd(null)).rejects.toBeInstanceOf(JsonLdValidationError);
+        toRDF.mockRejectedValue(new Error('x'));
+        await expect(validateJsonLd({})).rejects.toBeInstanceOf(JsonLdValidationError);
+    });
+});
+describe('expandJsonLd', () => {
+    beforeEach(() => {
+        expand.mockReset();
+        createJsonLdDocumentLoader.mockClear();
+    });
+    it('returns the expanded document from jsonld.expand run in safe mode through the guarded loader', async () => {
+        const expanded = [{ '@type': ['https://example.com/T'] }];
+        expand.mockResolvedValue(expanded);
+        await expect(expandJsonLd({ '@context': 'https://example.com', type: 'T' })).resolves.toBe(expanded);
+        expect(expand).toHaveBeenCalledWith({ '@context': 'https://example.com', type: 'T' }, expect.objectContaining({ safe: true, documentLoader: expect.any(Function) }));
+        expect(createJsonLdDocumentLoader).toHaveBeenCalledTimes(1);
+    });
+    it('rejects a document that is not an object with JsonLdInvalidShapeError', async () => {
+        await expect(expandJsonLd('nope')).rejects.toBeInstanceOf(JsonLdInvalidShapeError);
+        expect(expand).not.toHaveBeenCalled();
+    });
+    it('wraps a jsonld rejection as JsonLdExpansionFailedError with the loader failure as its cause', async () => {
+        const loaderFailure = new Error('refused');
+        documentLoader.mockRejectedValue(loaderFailure);
+        expand.mockImplementation((async (_doc, opts) => {
+            await opts.documentLoader('https://example.com');
+        }));
+        const error = await expandJsonLd({ '@context': 'https://example.com' }).catch((e) => e);
+        expect(error).toBeInstanceOf(JsonLdExpansionFailedError);
+        expect(error.cause).toBe(loaderFailure);
+    });
+    it('uses a caller-supplied document loader instead of building one', async () => {
+        const supplied = jest.fn(async (url) => ({ documentUrl: url, document: {} }));
+        expand.mockImplementation((async (_doc, opts) => {
+            await opts.documentLoader('https://example.com');
+            return [];
+        }));
+        await expandJsonLd({ '@context': 'https://example.com' }, { documentLoader: supplied });
+        expect(supplied).toHaveBeenCalledWith('https://example.com');
+        expect(createJsonLdDocumentLoader).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=validate-jsonld.test.js.map

package/build/validation/validate-jsonld.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uncefact/untp-utils",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Shared utility primitives for UNTP packages and consumers.",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -9,33 +9,107 @@
       "types": "./build/index.d.ts",
       "default": "./build/index.js"
     },
+    "./common": {
+      "types": "./build/common/index.d.ts",
+      "default": "./build/common/index.js"
+    },
+    "./artefacts": {
+      "types": "./build/artefacts/index.d.ts",
+      "default": "./build/artefacts/index.js"
+    },
     "./multibase-digest": {
       "types": "./build/multibase-digest/index.d.ts",
       "default": "./build/multibase-digest/index.js"
+    },
+    "./conformity-vocabulary": {
+      "types": "./build/conformity-vocabulary/index.d.ts",
+      "default": "./build/conformity-vocabulary/index.js"
+    },
+    "./validation": {
+      "types": "./build/validation/index.d.ts",
+      "default": "./build/validation/index.js"
+    },
+    "./loaders": {
+      "types": "./build/loaders/index.d.ts",
+      "default": "./build/loaders/index.js"
+    },
+    "./node": {
+      "types": "./build/node/index.d.ts",
+      "default": "./build/node/index.js"
+    },
+    "./cache": {
+      "types": "./build/cache/index.d.ts",
+      "default": "./build/cache/index.js"
+    },
+    "./resolvers": {
+      "types": "./build/resolvers/index.d.ts",
+      "default": "./build/resolvers/index.js"
+    },
+    "./http-headers": {
+      "types": "./build/http-headers/index.d.ts",
+      "default": "./build/http-headers/index.js"
+    },
+    "./bundled-artefacts": {
+      "types": "./build/bundle/public.d.ts",
+      "default": "./build/bundle/public.js"
     }
   },
   "typesVersions": {
     "*": {
+      "artefacts": [
+        "./build/artefacts/index.d.ts"
+      ],
       "multibase-digest": [
         "./build/multibase-digest/index.d.ts"
+      ],
+      "conformity-vocabulary": [
+        "./build/conformity-vocabulary/index.d.ts"
+      ],
+      "validation": [
+        "./build/validation/index.d.ts"
+      ],
+      "loaders": [
+        "./build/loaders/index.d.ts"
+      ],
+      "node": [
+        "./build/node/index.d.ts"
+      ],
+      "cache": [
+        "./build/cache/index.d.ts"
+      ],
+      "resolvers": [
+        "./build/resolvers/index.d.ts"
+      ],
+      "http-headers": [
+        "./build/http-headers/index.d.ts"
+      ],
+      "common": [
+        "./build/common/index.d.ts"
+      ],
+      "bundled-artefacts": [
+        "./build/bundle/public.d.ts"
       ]
     }
   },
   "files": [
-    "build"
+    "build",
+    "artefacts"
   ],
   "scripts": {
     "build": "tsc --build --clean && tsc",
     "watch": "tsc -b --watch",
     "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest",
-    "test:coverage": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --coverage"
+    "test:coverage": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --coverage",
+    "artefacts:check": "node scripts/refresh-artefacts.mjs --check",
+    "artefacts:refresh": "node scripts/refresh-artefacts.mjs"
   },
   "type": "module",
   "keywords": [
     "untp",
     "multibase",
     "multihash",
-    "digest"
+    "digest",
+    "conformity-vocabulary"
   ],
   "author": "",
   "license": "Apache-2.0",
@@ -45,10 +119,17 @@
     "directory": "packages/untp-utils"
   },
   "dependencies": {
-    "multiformats": "^13.3.1"
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "ipaddr.js": "^2.4.0",
+    "jsonld": "^8.3.3",
+    "multiformats": "^13.3.1",
+    "undici": "^6.25.0"
   },
   "devDependencies": {
+    "@jest/globals": "29.7.0",
     "@types/jest": "29.5.11",
+    "@types/jsonld": "^1.5.15",
     "cross-env": "^7.0.3",
     "jest": "29.7.0",
     "ts-jest": "29.1.1",