@fedify/testing 2.5.0-dev.2446 → 2.5.0-dev.2492

package/dist/mod.cjs

@@ -3,6 +3,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _fedify_fedify_sig = require("@fedify/fedify/sig");
 let _fedify_vocab = require("@fedify/vocab");
 let _fedify_vocab_runtime = require("@fedify/vocab-runtime");
+let _opentelemetry_api = require("@opentelemetry/api");
 let _fedify_fedify_federation = require("@fedify/fedify/federation");
 let es_toolkit = require("es-toolkit");
 let node_assert_strict = require("node:assert/strict");
@@ -192,6 +193,18 @@ async function isSignedByAudience(getSignedKeyOwner, object, isMember) {
 	return false;
 }
 /**
+* The authentication evidence of a mock inbox context that is not given one:
+* nothing is authenticated.
+*/
+const EMPTY_AUTHENTICATION = globalThis.Object.freeze({
+	verified: false,
+	requestSigners: globalThis.Object.freeze([]),
+	documentSigners: globalThis.Object.freeze([]),
+	originAuthenticated: globalThis.Object.freeze([]),
+	expandedActivity: globalThis.Object.freeze([]),
+	baseUrl: null
+});
+/**
 * Creates an InboxContext for testing purposes.
 * Not exported - used internally only. Public API is in mock.ts
 * @param args Partial InboxContext properties
@@ -209,6 +222,7 @@ function createInboxContext(args) {
 			data
 		})),
 		recipient: args.recipient ?? null,
+		authentication: args.authentication ?? EMPTY_AUTHENTICATION,
 		forwardActivity
 	};
 }
@@ -428,9 +442,13 @@ var MockFederation = class {
 	outboxListenersInitialized = false;
 	contextData;
 	receivedActivities = [];
+	documentLoader;
+	contextLoader;
 	constructor(options = {}) {
 		this.options = options;
 		this.contextData = options.contextData;
+		this.documentLoader = options.documentLoader ?? (options.allowPrivateAddress ? (0, _fedify_vocab_runtime.getDocumentLoader)({ allowPrivateAddress: true }) : void 0);
+		this.contextLoader = options.contextLoader ?? this.documentLoader;
 	}
 	setNodeInfoDispatcher(path, dispatcher) {
 		this.nodeInfoDispatcher = dispatcher;
@@ -641,9 +659,9 @@ var MockFederation = class {
 			data: contextData,
 			federation: mockFederation,
 			meterProvider: this.options.meterProvider,
-			tracerProvider: this.options.tracerProvider,
-			documentLoader: this.options.documentLoader,
-			contextLoader: this.options.contextLoader,
+			tracerProvider: this.options.tracerProvider ?? (this.documentLoader == null ? void 0 : _opentelemetry_api.trace.getTracerProvider()),
+			documentLoader: this.documentLoader,
+			contextLoader: this.contextLoader,
 			verifyPortableObject: this.options.verifyPortableObject,
 			portableRequest: options.portableRequest
 		});
@@ -714,10 +732,20 @@ var MockFederation = class {
 		const typeName = activity.constructor.name;
 		const listeners = this.inboxListeners.get(typeName) || [];
 		if (listeners.length > 0 && this.contextData === void 0) throw new Error("MockFederation.receiveActivity(): contextData is not initialized. Please provide contextData through the constructor or call startQueue() before receiving activities.");
+		const receivedActivity = listeners.length > 0 && this.documentLoader != null ? activity.clone({}, {
+			documentLoader: this.documentLoader,
+			contextLoader: this.contextLoader
+		}) : activity;
+		if (receivedActivity !== activity) Reflect.set(receivedActivity, "_cachedJsonLd", Reflect.get(activity, "_cachedJsonLd"));
 		for (const listener of listeners) await listener(createInboxContext({
 			data: this.contextData,
-			federation: this
-		}), activity);
+			federation: this,
+			documentLoader: this.documentLoader,
+			contextLoader: this.contextLoader,
+			tracerProvider: this.options.tracerProvider ?? (this.documentLoader == null ? void 0 : _opentelemetry_api.trace.getTracerProvider()),
+			meterProvider: this.options.meterProvider,
+			verifyPortableObject: this.options.verifyPortableObject
+		}), receivedActivity);
 	}
 	/**
 	* Simulates posting an activity to a local actor outbox.

package/dist/mod.d.cts

@@ -161,6 +161,14 @@ declare function createFederation<TContextData>(options?: {
   * @since 2.3.0
   */
   meterProvider?: any;
+  /**
+  * Use HTTP document loading for received activities and contexts created by
+  * this federation, allowing private addresses such as localhost.
+  * If false or omitted, contexts retain their no-op mock loaders and
+  * received activities retain their own loaders.
+  * @since 2.0.35
+  */
+  allowPrivateAddress?: boolean;
   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;

package/dist/mod.d.ts

@@ -161,6 +161,14 @@ declare function createFederation<TContextData>(options?: {
   * @since 2.3.0
   */
   meterProvider?: any;
+  /**
+  * Use HTTP document loading for received activities and contexts created by
+  * this federation, allowing private addresses such as localhost.
+  * If false or omitted, contexts retain their no-op mock loaders and
+  * received activities retain their own loaders.
+  * @since 2.0.35
+  */
+  allowPrivateAddress?: boolean;
   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;

package/dist/mod.js

@@ -1,7 +1,8 @@
 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, decodeMultibase, formatIri, fromCompatibleEf61Id, getFe34Origin, parseDigestMultibase, parseHashlink, parseIri } from "@fedify/vocab-runtime";
+import { arePortableUrisEqual, canonicalizePortableUri, decodeMultibase, formatIri, fromCompatibleEf61Id, getDocumentLoader, getFe34Origin, parseDigestMultibase, parseHashlink, parseIri } from "@fedify/vocab-runtime";
+import { trace } from "@opentelemetry/api";
 import { RouterError } from "@fedify/fedify/federation";
 import { delay } from "es-toolkit";
 import { deepStrictEqual, ok, strictEqual } from "node:assert/strict";
@@ -191,6 +192,18 @@ async function isSignedByAudience(getSignedKeyOwner, object, isMember) {
 	return false;
 }
 /**
+* The authentication evidence of a mock inbox context that is not given one:
+* nothing is authenticated.
+*/
+const EMPTY_AUTHENTICATION = globalThis.Object.freeze({
+	verified: false,
+	requestSigners: globalThis.Object.freeze([]),
+	documentSigners: globalThis.Object.freeze([]),
+	originAuthenticated: globalThis.Object.freeze([]),
+	expandedActivity: globalThis.Object.freeze([]),
+	baseUrl: null
+});
+/**
 * Creates an InboxContext for testing purposes.
 * Not exported - used internally only. Public API is in mock.ts
 * @param args Partial InboxContext properties
@@ -208,6 +221,7 @@ function createInboxContext(args) {
 			data
 		})),
 		recipient: args.recipient ?? null,
+		authentication: args.authentication ?? EMPTY_AUTHENTICATION,
 		forwardActivity
 	};
 }
@@ -427,9 +441,13 @@ var MockFederation = class {
 	outboxListenersInitialized = false;
 	contextData;
 	receivedActivities = [];
+	documentLoader;
+	contextLoader;
 	constructor(options = {}) {
 		this.options = options;
 		this.contextData = options.contextData;
+		this.documentLoader = options.documentLoader ?? (options.allowPrivateAddress ? getDocumentLoader({ allowPrivateAddress: true }) : void 0);
+		this.contextLoader = options.contextLoader ?? this.documentLoader;
 	}
 	setNodeInfoDispatcher(path, dispatcher) {
 		this.nodeInfoDispatcher = dispatcher;
@@ -640,9 +658,9 @@ var MockFederation = class {
 			data: contextData,
 			federation: mockFederation,
 			meterProvider: this.options.meterProvider,
-			tracerProvider: this.options.tracerProvider,
-			documentLoader: this.options.documentLoader,
-			contextLoader: this.options.contextLoader,
+			tracerProvider: this.options.tracerProvider ?? (this.documentLoader == null ? void 0 : trace.getTracerProvider()),
+			documentLoader: this.documentLoader,
+			contextLoader: this.contextLoader,
 			verifyPortableObject: this.options.verifyPortableObject,
 			portableRequest: options.portableRequest
 		});
@@ -713,10 +731,20 @@ var MockFederation = class {
 		const typeName = activity.constructor.name;
 		const listeners = this.inboxListeners.get(typeName) || [];
 		if (listeners.length > 0 && this.contextData === void 0) throw new Error("MockFederation.receiveActivity(): contextData is not initialized. Please provide contextData through the constructor or call startQueue() before receiving activities.");
+		const receivedActivity = listeners.length > 0 && this.documentLoader != null ? activity.clone({}, {
+			documentLoader: this.documentLoader,
+			contextLoader: this.contextLoader
+		}) : activity;
+		if (receivedActivity !== activity) Reflect.set(receivedActivity, "_cachedJsonLd", Reflect.get(activity, "_cachedJsonLd"));
 		for (const listener of listeners) await listener(createInboxContext({
 			data: this.contextData,
-			federation: this
-		}), activity);
+			federation: this,
+			documentLoader: this.documentLoader,
+			contextLoader: this.contextLoader,
+			tracerProvider: this.options.tracerProvider ?? (this.documentLoader == null ? void 0 : trace.getTracerProvider()),
+			meterProvider: this.options.meterProvider,
+			verifyPortableObject: this.options.verifyPortableObject
+		}), receivedActivity);
 	}
 	/**
 	* Simulates posting an activity to a local actor outbox.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/testing",
-  "version": "2.5.0-dev.2446+2014cb03",
+  "version": "2.5.0-dev.2492+4648c04e",
   "description": "Testing utilities for Fedify applications",
   "keywords": [
     "fedify",
@@ -47,13 +47,14 @@
     "package.json"
   ],
   "peerDependencies": {
-    "@fedify/fedify": "^2.5.0-dev.2446+2014cb03"
+    "@fedify/fedify": "^2.5.0-dev.2492+4648c04e"
   },
   "dependencies": {
+    "@opentelemetry/api": "~1.9.1",
     "es-toolkit": "1.46.1",
     "temporal-polyfill": "^1.0.1",
-    "@fedify/vocab": "2.5.0-dev.2446+2014cb03",
-    "@fedify/vocab-runtime": "^2.5.0-dev.2446+2014cb03"
+    "@fedify/vocab-runtime": "^2.5.0-dev.2492+4648c04e",
+    "@fedify/vocab": "2.5.0-dev.2492+4648c04e"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -61,9 +62,7 @@
     "@std/async": "npm:@jsr/std__async@^1.0.13",
     "tsdown": "^0.22.0",
     "typescript": "^6.0.0",
-    "@fedify/fixture": "^2.0.0",
-    "@fedify/vocab": "^2.5.0-dev.2446+2014cb03",
-    "@fedify/vocab-runtime": "^2.5.0-dev.2446+2014cb03"
+    "@fedify/fixture": "^2.0.0"
   },
   "scripts": {
     "build:self": "tsdown",