@fedify/testing 2.4.0-dev.2240 → 2.4.0-dev.2247

package/dist/mod.cjs

@@ -629,7 +629,7 @@ var MockFederation = class {
 	async processQueuedTask(contextData, _message) {
 		this.contextData = contextData;
 	}
-	createContext(baseUrlOrRequest, contextData) {
+	createContext(baseUrlOrRequest, contextData, options = {}) {
 		const mockFederation = this;
 		const request = baseUrlOrRequest instanceof Request ? baseUrlOrRequest : null;
 		return new MockContext({
@@ -638,10 +638,63 @@ var MockFederation = class {
 			data: contextData,
 			federation: mockFederation,
 			meterProvider: this.options.meterProvider,
-			tracerProvider: this.options.tracerProvider
+			tracerProvider: this.options.tracerProvider,
+			documentLoader: this.options.documentLoader,
+			contextLoader: this.options.contextLoader,
+			verifyPortableObject: this.options.verifyPortableObject,
+			portableRequest: options.portableRequest
 		});
 	}
 	async fetch(request, options) {
+		if (this.hashlinkMediaDispatcher != null) {
+			const url = new URL(request.url);
+			if ((url.protocol === "http:" || url.protocol === "https:") && url.pathname.startsWith("/.well-known/apgateway/")) {
+				const encoded = url.pathname.slice(23);
+				if (/^hl(?::|%3A)/i.test(encoded)) {
+					if (request.method !== "GET" && request.method !== "HEAD") return new Response("Method not allowed.", {
+						status: 405,
+						headers: {
+							Allow: "GET, HEAD",
+							"Content-Type": "text/plain; charset=utf-8"
+						}
+					});
+					let media;
+					try {
+						let hashlink;
+						try {
+							hashlink = decodeURIComponent(encoded);
+						} catch (error) {
+							throw new TypeError("Invalid percent-encoding in the hashlink.", { cause: error });
+						}
+						const { digestMultibase } = (0, _fedify_vocab_runtime.parseHashlink)(hashlink);
+						const { digest } = (0, _fedify_vocab_runtime.parseDigestMultibase)(digestMultibase);
+						media = globalThis.Object.freeze({
+							hashlink: `hl:${digestMultibase}`,
+							digestMultibase,
+							algorithm: "sha2-256",
+							digest,
+							multihash: (0, _fedify_vocab_runtime.decodeMultibase)(digestMultibase)
+						});
+					} catch (error) {
+						if (!(error instanceof TypeError)) throw error;
+						return new Response(request.method === "HEAD" ? null : "Malformed hashlink.", {
+							status: 400,
+							headers: { "Content-Type": "text/plain; charset=utf-8" }
+						});
+					}
+					const context = this.createContext(request, options.contextData);
+					const response = await this.hashlinkMediaDispatcher(context, media);
+					if (response == null) return options.onNotFound == null ? new Response("Not Found", { status: 404 }) : await options.onNotFound(request);
+					if (request.method !== "HEAD" || response.body == null) return response;
+					response.body.cancel().catch(() => {});
+					return new Response(null, {
+						status: response.status,
+						statusText: response.statusText,
+						headers: response.headers
+					});
+				}
+			}
+		}
 		if (options.onNotFound) return options.onNotFound(request);
 		return new Response("Not Found", { status: 404 });
 	}
@@ -864,6 +917,10 @@ var MockContext = class MockContext {
 	tracerProvider;
 	request;
 	url;
+	portableRequest;
+	verifyPortableObject;
+	hasDocumentLoader;
+	hasContextLoader;
 	sentActivities = [];
 	constructor(options) {
 		const url = options.url ?? new URL("https://example.com");
@@ -873,6 +930,10 @@ var MockContext = class MockContext {
 		this.hostname = url.hostname;
 		this.url = url;
 		this.request = options.request ?? new Request(url);
+		this.portableRequest = options.portableRequest;
+		this.verifyPortableObject = options.verifyPortableObject;
+		this.hasDocumentLoader = options.hasDocumentLoader ?? options.documentLoader != null;
+		this.hasContextLoader = options.hasContextLoader ?? options.contextLoader != null;
 		this.data = options.data;
 		this.federation = options.federation;
 		this.documentLoader = options.documentLoader ?? (async (url) => ({
@@ -937,10 +998,15 @@ var MockContext = class MockContext {
 	clone(data) {
 		return new MockContext({
 			url: this.url,
+			request: this.request,
 			data,
 			federation: this.federation,
 			documentLoader: this.documentLoader,
 			contextLoader: this.contextLoader,
+			verifyPortableObject: this.verifyPortableObject,
+			portableRequest: this.portableRequest,
+			hasDocumentLoader: this.hasDocumentLoader,
+			hasContextLoader: this.hasContextLoader,
 			meterProvider: this.meterProvider,
 			tracerProvider: this.tracerProvider
 		});
@@ -1106,8 +1172,21 @@ var MockContext = class MockContext {
 		if ("keyId" in params) return this.documentLoader;
 		return Promise.resolve(this.documentLoader);
 	}
-	lookupObject(_uri, _options) {
-		return Promise.resolve(null);
+	lookupObject(uri, options = {}) {
+		if (!this.hasDocumentLoader && options.documentLoader == null || (options.verifyPortableObject ?? this.verifyPortableObject) == null) return Promise.resolve(null);
+		const value = typeof uri === "string" ? uri : (0, _fedify_vocab_runtime.formatIri)(uri);
+		if (!/^ap(?:\+ef61)?:\/\//i.test(value)) try {
+			if ((0, _fedify_vocab_runtime.fromCompatibleEf61Id)(value) == null) return Promise.resolve(null);
+		} catch (error) {
+			if (error instanceof TypeError) return Promise.resolve(null);
+			throw error;
+		}
+		return (0, _fedify_vocab.lookupObject)(uri, {
+			...options,
+			documentLoader: options.documentLoader ?? this.documentLoader,
+			contextLoader: options.contextLoader ?? (this.hasContextLoader ? this.contextLoader : options.documentLoader ?? this.contextLoader),
+			verifyPortableObject: options.verifyPortableObject ?? this.verifyPortableObject
+		});
 	}
 	traverseCollection(_collection, _options) {
 		return { async *[Symbol.asyncIterator]() {} };

package/dist/mod.d.cts

@@ -1,6 +1,7 @@
 /// <reference lib="esnext.temporal" />
-import { Context, Federation, InboxContext, OutboxContext, RequestContext } from "@fedify/fedify/federation";
+import { Context, Federation, InboxContext, OutboxContext, PortableRequest, RequestContext } from "@fedify/fedify/federation";
 import { Activity } from "@fedify/vocab";
+import { DocumentLoader, PortableObjectVerifier } from "@fedify/vocab-runtime";
 import { KvStore, MessageQueue } from "@fedify/fedify";
 
 //#region src/context.d.ts
@@ -86,7 +87,7 @@ interface SentActivity {
 * Extends the standard Context interface with additional testing utilities.
 * @since 1.9.1
 */
-interface TestContext<TContextData> extends Omit<Context<TContextData>, "clone">, Pick<RequestContext<TContextData>, "request" | "url" | "getActor" | "getObject" | "getSignedKey" | "getSignedKeyOwner" | "isSignedByAudience" | "sendActivity" | "routeActivity"> {
+interface TestContext<TContextData> extends Omit<Context<TContextData>, "clone">, Pick<RequestContext<TContextData>, "request" | "url" | "portableRequest" | "getActor" | "getObject" | "getSignedKey" | "getSignedKeyOwner" | "isSignedByAudience" | "sendActivity" | "routeActivity"> {
   clone(data: TContextData): TestContext<TContextData>;
   getSentActivities(): Array<{
     sender: any;
@@ -108,7 +109,13 @@ interface TestFederation<TContextData> extends Omit<Federation<TContextData>, "c
   receiveActivity(activity: Activity): Promise<void>;
   postOutboxActivity(identifier: string, activity: Activity): Promise<void>;
   reset(): void;
-  createContext(baseUrlOrRequest: URL | Request, contextData: TContextData): TestContext<TContextData>;
+  createContext(baseUrl: URL, contextData: TContextData): TestContext<TContextData>;
+  createContext(request: Request, contextData: TContextData, options?: {
+    portableRequest?: PortableRequest;
+  }): TestContext<TContextData>;
+  createContext(baseUrlOrRequest: URL | Request, contextData: TContextData, options?: {
+    portableRequest?: PortableRequest;
+  }): TestContext<TContextData>;
 }
 /**
 * Creates a mock Federation instance for testing purposes.
@@ -154,7 +161,15 @@ declare function createFederation<TContextData>(options?: {
   * @since 2.3.0
   */
   meterProvider?: any;
-  tracerProvider?: any;
+  tracerProvider?: any; /** The document loader used by mock context lookups. @since 2.4.0 */
+  documentLoader?: DocumentLoader; /** The JSON-LD context loader used by mock context lookups. @since 2.4.0 */
+  contextLoader?: DocumentLoader;
+  /**
+  * The portable object verifier used by mock context lookups when a
+  * document loader is provided.  Mock collection traversal remains empty.
+  * @since 2.4.0
+  */
+  verifyPortableObject?: PortableObjectVerifier;
 }): TestFederation<TContextData>;
 //#endregion
 //#region src/kv-tester.d.ts

package/dist/mod.d.ts

@@ -1,6 +1,7 @@
 /// <reference lib="esnext.temporal" />
 import { Activity } from "@fedify/vocab";
-import { Context, Federation, InboxContext, OutboxContext, RequestContext } from "@fedify/fedify/federation";
+import { DocumentLoader, PortableObjectVerifier } from "@fedify/vocab-runtime";
+import { Context, Federation, InboxContext, OutboxContext, PortableRequest, RequestContext } from "@fedify/fedify/federation";
 import { KvStore, MessageQueue } from "@fedify/fedify";
 
 //#region src/context.d.ts
@@ -86,7 +87,7 @@ interface SentActivity {
 * Extends the standard Context interface with additional testing utilities.
 * @since 1.9.1
 */
-interface TestContext<TContextData> extends Omit<Context<TContextData>, "clone">, Pick<RequestContext<TContextData>, "request" | "url" | "getActor" | "getObject" | "getSignedKey" | "getSignedKeyOwner" | "isSignedByAudience" | "sendActivity" | "routeActivity"> {
+interface TestContext<TContextData> extends Omit<Context<TContextData>, "clone">, Pick<RequestContext<TContextData>, "request" | "url" | "portableRequest" | "getActor" | "getObject" | "getSignedKey" | "getSignedKeyOwner" | "isSignedByAudience" | "sendActivity" | "routeActivity"> {
   clone(data: TContextData): TestContext<TContextData>;
   getSentActivities(): Array<{
     sender: any;
@@ -108,7 +109,13 @@ interface TestFederation<TContextData> extends Omit<Federation<TContextData>, "c
   receiveActivity(activity: Activity): Promise<void>;
   postOutboxActivity(identifier: string, activity: Activity): Promise<void>;
   reset(): void;
-  createContext(baseUrlOrRequest: URL | Request, contextData: TContextData): TestContext<TContextData>;
+  createContext(baseUrl: URL, contextData: TContextData): TestContext<TContextData>;
+  createContext(request: Request, contextData: TContextData, options?: {
+    portableRequest?: PortableRequest;
+  }): TestContext<TContextData>;
+  createContext(baseUrlOrRequest: URL | Request, contextData: TContextData, options?: {
+    portableRequest?: PortableRequest;
+  }): TestContext<TContextData>;
 }
 /**
 * Creates a mock Federation instance for testing purposes.
@@ -154,7 +161,15 @@ declare function createFederation<TContextData>(options?: {
   * @since 2.3.0
   */
   meterProvider?: any;
-  tracerProvider?: any;
+  tracerProvider?: any; /** The document loader used by mock context lookups. @since 2.4.0 */
+  documentLoader?: DocumentLoader; /** The JSON-LD context loader used by mock context lookups. @since 2.4.0 */
+  contextLoader?: DocumentLoader;
+  /**
+  * The portable object verifier used by mock context lookups when a
+  * document loader is provided.  Mock collection traversal remains empty.
+  * @since 2.4.0
+  */
+  verifyPortableObject?: PortableObjectVerifier;
 }): TestFederation<TContextData>;
 //#endregion
 //#region src/kv-tester.d.ts

package/dist/mod.js

@@ -1,7 +1,7 @@
 import { Temporal } from "temporal-polyfill";
 import { hasProofLike, hasSignatureLike } from "@fedify/fedify/sig";
 import { Activity, CryptographicKey, Multikey, PUBLIC_COLLECTION, Tombstone, lookupObject, traverseCollection } from "@fedify/vocab";
-import { arePortableUrisEqual, canonicalizePortableUri, formatIri, fromCompatibleEf61Id, getFe34Origin, parseIri } from "@fedify/vocab-runtime";
+import { arePortableUrisEqual, canonicalizePortableUri, decodeMultibase, formatIri, fromCompatibleEf61Id, getFe34Origin, parseDigestMultibase, parseHashlink, parseIri } from "@fedify/vocab-runtime";
 import { RouterError } from "@fedify/fedify/federation";
 import { delay } from "es-toolkit";
 import { deepStrictEqual, ok, strictEqual } from "node:assert/strict";
@@ -628,7 +628,7 @@ var MockFederation = class {
 	async processQueuedTask(contextData, _message) {
 		this.contextData = contextData;
 	}
-	createContext(baseUrlOrRequest, contextData) {
+	createContext(baseUrlOrRequest, contextData, options = {}) {
 		const mockFederation = this;
 		const request = baseUrlOrRequest instanceof Request ? baseUrlOrRequest : null;
 		return new MockContext({
@@ -637,10 +637,63 @@ var MockFederation = class {
 			data: contextData,
 			federation: mockFederation,
 			meterProvider: this.options.meterProvider,
-			tracerProvider: this.options.tracerProvider
+			tracerProvider: this.options.tracerProvider,
+			documentLoader: this.options.documentLoader,
+			contextLoader: this.options.contextLoader,
+			verifyPortableObject: this.options.verifyPortableObject,
+			portableRequest: options.portableRequest
 		});
 	}
 	async fetch(request, options) {
+		if (this.hashlinkMediaDispatcher != null) {
+			const url = new URL(request.url);
+			if ((url.protocol === "http:" || url.protocol === "https:") && url.pathname.startsWith("/.well-known/apgateway/")) {
+				const encoded = url.pathname.slice(23);
+				if (/^hl(?::|%3A)/i.test(encoded)) {
+					if (request.method !== "GET" && request.method !== "HEAD") return new Response("Method not allowed.", {
+						status: 405,
+						headers: {
+							Allow: "GET, HEAD",
+							"Content-Type": "text/plain; charset=utf-8"
+						}
+					});
+					let media;
+					try {
+						let hashlink;
+						try {
+							hashlink = decodeURIComponent(encoded);
+						} catch (error) {
+							throw new TypeError("Invalid percent-encoding in the hashlink.", { cause: error });
+						}
+						const { digestMultibase } = parseHashlink(hashlink);
+						const { digest } = parseDigestMultibase(digestMultibase);
+						media = globalThis.Object.freeze({
+							hashlink: `hl:${digestMultibase}`,
+							digestMultibase,
+							algorithm: "sha2-256",
+							digest,
+							multihash: decodeMultibase(digestMultibase)
+						});
+					} catch (error) {
+						if (!(error instanceof TypeError)) throw error;
+						return new Response(request.method === "HEAD" ? null : "Malformed hashlink.", {
+							status: 400,
+							headers: { "Content-Type": "text/plain; charset=utf-8" }
+						});
+					}
+					const context = this.createContext(request, options.contextData);
+					const response = await this.hashlinkMediaDispatcher(context, media);
+					if (response == null) return options.onNotFound == null ? new Response("Not Found", { status: 404 }) : await options.onNotFound(request);
+					if (request.method !== "HEAD" || response.body == null) return response;
+					response.body.cancel().catch(() => {});
+					return new Response(null, {
+						status: response.status,
+						statusText: response.statusText,
+						headers: response.headers
+					});
+				}
+			}
+		}
 		if (options.onNotFound) return options.onNotFound(request);
 		return new Response("Not Found", { status: 404 });
 	}
@@ -863,6 +916,10 @@ var MockContext = class MockContext {
 	tracerProvider;
 	request;
 	url;
+	portableRequest;
+	verifyPortableObject;
+	hasDocumentLoader;
+	hasContextLoader;
 	sentActivities = [];
 	constructor(options) {
 		const url = options.url ?? new URL("https://example.com");
@@ -872,6 +929,10 @@ var MockContext = class MockContext {
 		this.hostname = url.hostname;
 		this.url = url;
 		this.request = options.request ?? new Request(url);
+		this.portableRequest = options.portableRequest;
+		this.verifyPortableObject = options.verifyPortableObject;
+		this.hasDocumentLoader = options.hasDocumentLoader ?? options.documentLoader != null;
+		this.hasContextLoader = options.hasContextLoader ?? options.contextLoader != null;
 		this.data = options.data;
 		this.federation = options.federation;
 		this.documentLoader = options.documentLoader ?? (async (url) => ({
@@ -936,10 +997,15 @@ var MockContext = class MockContext {
 	clone(data) {
 		return new MockContext({
 			url: this.url,
+			request: this.request,
 			data,
 			federation: this.federation,
 			documentLoader: this.documentLoader,
 			contextLoader: this.contextLoader,
+			verifyPortableObject: this.verifyPortableObject,
+			portableRequest: this.portableRequest,
+			hasDocumentLoader: this.hasDocumentLoader,
+			hasContextLoader: this.hasContextLoader,
 			meterProvider: this.meterProvider,
 			tracerProvider: this.tracerProvider
 		});
@@ -1105,8 +1171,21 @@ var MockContext = class MockContext {
 		if ("keyId" in params) return this.documentLoader;
 		return Promise.resolve(this.documentLoader);
 	}
-	lookupObject(_uri, _options) {
-		return Promise.resolve(null);
+	lookupObject(uri, options = {}) {
+		if (!this.hasDocumentLoader && options.documentLoader == null || (options.verifyPortableObject ?? this.verifyPortableObject) == null) return Promise.resolve(null);
+		const value = typeof uri === "string" ? uri : formatIri(uri);
+		if (!/^ap(?:\+ef61)?:\/\//i.test(value)) try {
+			if (fromCompatibleEf61Id(value) == null) return Promise.resolve(null);
+		} catch (error) {
+			if (error instanceof TypeError) return Promise.resolve(null);
+			throw error;
+		}
+		return lookupObject(uri, {
+			...options,
+			documentLoader: options.documentLoader ?? this.documentLoader,
+			contextLoader: options.contextLoader ?? (this.hasContextLoader ? this.contextLoader : options.documentLoader ?? this.contextLoader),
+			verifyPortableObject: options.verifyPortableObject ?? this.verifyPortableObject
+		});
 	}
 	traverseCollection(_collection, _options) {
 		return { async *[Symbol.asyncIterator]() {} };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/testing",
-  "version": "2.4.0-dev.2240+79613fa6",
+  "version": "2.4.0-dev.2247+4fe1b8c3",
   "description": "Testing utilities for Fedify applications",
   "keywords": [
     "fedify",
@@ -47,13 +47,13 @@
     "package.json"
   ],
   "peerDependencies": {
-    "@fedify/fedify": "^2.4.0-dev.2240+79613fa6"
+    "@fedify/fedify": "^2.4.0-dev.2247+4fe1b8c3"
   },
   "dependencies": {
     "es-toolkit": "1.46.1",
     "temporal-polyfill": "^1.0.1",
-    "@fedify/vocab": "2.4.0-dev.2240+79613fa6",
-    "@fedify/vocab-runtime": "^2.4.0-dev.2240+79613fa6"
+    "@fedify/vocab": "2.4.0-dev.2247+4fe1b8c3",
+    "@fedify/vocab-runtime": "^2.4.0-dev.2247+4fe1b8c3"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",