@fedify/fedify 2.3.0-dev.1190 → 2.3.0-dev.1213

package/dist/{middleware-C-C_I_wJ.js → middleware-Dft_sYeS.js}

@@ -2,10 +2,10 @@ import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
 import { t as __exportAll } from "./chunk-CRNNMoPX.js";
 import { r as getDefaultActivityTransformers } from "./transformers-BGMIq1cs.js";
-import { D as recordOutboxEnqueue, E as recordOutboxActivity, N as name, O as recordWebFingerHandle, P as version, S as recordCollectionTotalItems, T as recordInboxActivity, a as verifyRequestDetailed, b as recordCollectionPageItems, d as validateCryptoKey, f as getDurationMs, g as isAbortError, h as instrumentDocumentLoader, i as verifyRequest, k as formatAcceptSignature, m as getRemoteHost, n as parseRfc9421SignatureInput, o as exportJwk, p as getFederationMetrics, t as doubleKnock, u as importJwk, v as recordCircuitBreakerStateChange, w as recordFanoutRecipients, x as recordCollectionRequest, y as recordCollectionDispatchDuration } from "./http-Dq_qElWc.js";
-import { _ as hasSignatureLike, b as signJsonLd, c as getKeyOwner, f as compactJsonLd, g as hasSignature, h as getNormalizationContextLoader, i as verifyObject, l as InvalidContextReferenceError, m as detachSignature, n as hasProofLike, o as normalizeOutgoingActivityJsonLd, r as signObject, s as doesActorOwnKey, u as assertSafeJsonLd, v as isClearlyMalformedContextReference, w as wrapContextLoaderForJsonLd, x as verifyCompactJsonLd, y as isInvalidUrlTypeError } from "./proof-Dq_RyTjd.js";
+import { A as formatAcceptSignature, D as recordOutboxEnqueue, E as recordOutboxActivity, F as version, O as recordWebFingerHandle, P as name, S as recordCollectionTotalItems, T as recordInboxActivity, a as verifyRequestDetailed, b as recordCollectionPageItems, d as validateCryptoKey, f as getDurationMs, g as isAbortError, h as instrumentDocumentLoader, i as verifyRequest, k as registerQueueDepthGauge, m as getRemoteHost, n as parseRfc9421SignatureInput, o as exportJwk, p as getFederationMetrics, t as doubleKnock, u as importJwk, v as recordCircuitBreakerStateChange, w as recordFanoutRecipients, x as recordCollectionRequest, y as recordCollectionDispatchDuration } from "./http-B_WbYMnB.js";
+import { _ as hasSignatureLike, b as signJsonLd, c as getKeyOwner, f as compactJsonLd, g as hasSignature, h as getNormalizationContextLoader, i as verifyObject, l as InvalidContextReferenceError, m as detachSignature, n as hasProofLike, o as normalizeOutgoingActivityJsonLd, r as signObject, s as doesActorOwnKey, u as assertSafeJsonLd, v as isClearlyMalformedContextReference, w as wrapContextLoaderForJsonLd, x as verifyCompactJsonLd, y as isInvalidUrlTypeError } from "./proof-BsvB1vGI.js";
 import { n as getNodeInfo, t as nodeInfoToJson } from "./types-CAY3OdLq.js";
-import { n as getAuthenticatedDocumentLoader, t as kvCache } from "./kv-cache-BhPocHdd.js";
+import { n as getAuthenticatedDocumentLoader, t as kvCache } from "./kv-cache-CXo8QM4m.js";
 import { getLogger, withContext } from "@logtape/logtape";
 import { Router, RouterError, assertPath } from "@fedify/uri-template";
 import { Activity, Collection, CollectionPage, CryptographicKey, Link, Multikey, Object as Object$1, OrderedCollection, OrderedCollectionPage, Tombstone, getTypeId, lookupObject, traverseCollection } from "@fedify/vocab";
@@ -16,6 +16,7 @@ import { FetchError, getDocumentLoader } from "@fedify/vocab-runtime";
 import { ATTR_HTTP_REQUEST_HEADER, ATTR_HTTP_REQUEST_METHOD, ATTR_HTTP_RESPONSE_HEADER, ATTR_HTTP_RESPONSE_STATUS_CODE, ATTR_URL_FULL } from "@opentelemetry/semantic-conventions";
 import jsonld from "@fedify/vocab-runtime/jsonld";
 import { lookupWebFinger } from "@fedify/webfinger";
+import { DataPointType, MeterProvider as MeterProvider$1, MetricReader } from "@opentelemetry/sdk-metrics";
 import { domainToASCII } from "node:url";
 //#region src/federation/activity-listener.ts
 var ActivityListenerSet = class {
@@ -117,6 +118,13 @@ var FederationBuilderImpl = class {
 		this.collectionCallbacks = {};
 		this.collectionTypeIds = {};
 	}
+	/**
+	* Builds the federation object.
+	* @param options Parameters for initializing the federation object.
+	* @returns The federation object.
+	* @throws {TypeError} If benchmark mode and `meterProvider` are both
+	* specified.
+	*/
 	async build(options) {
 		const { FederationImpl } = await Promise.resolve().then(() => middleware_exports);
 		const f = new FederationImpl(options);
@@ -3072,36 +3080,6 @@ function handleNodeInfoJrd(_request, context) {
 	return Promise.resolve(response);
 }
 //#endregion
-//#region src/federation/retry.ts
-/**
-* Creates an exponential backoff retry policy.  The delay between retries
-* starts at the `initialDelay` and is multiplied by the `factor` for each
-* subsequent retry, up to the `maxDelay`.  The policy will give up after
-* `maxAttempts` attempts.  The actual delay is randomized to avoid
-* synchronization (jitter).
-* @param options The options for the policy.
-* @returns The retry policy.
-* @since 0.12.0
-*/
-function createExponentialBackoffPolicy(options = {}) {
-	const initialDelay = Temporal.Duration.from(options.initialDelay ?? { seconds: 1 });
-	const maxDelay = Temporal.Duration.from(options.maxDelay ?? { hours: 12 });
-	const maxAttempts = options.maxAttempts ?? 10;
-	const factor = options.factor ?? 2;
-	const jitter = options.jitter ?? true;
-	return ({ attempts }) => {
-		if (attempts >= maxAttempts) return null;
-		let milliseconds = initialDelay.total("millisecond");
-		milliseconds *= factor ** attempts;
-		if (jitter) {
-			milliseconds *= 1 + Math.random();
-			milliseconds = Math.round(milliseconds);
-		}
-		const delay = Temporal.Duration.from({ milliseconds });
-		return Temporal.Duration.compare(delay, maxDelay) > 0 ? maxDelay : delay;
-	};
-}
-//#endregion
 //#region src/federation/send.ts
 /**
 * Extracts the inbox URLs from recipients.
@@ -3331,6 +3309,231 @@ var SendActivityError = class extends Error {
 	}
 };
 //#endregion
+//#region src/federation/bench.ts
+/**
+* Metric reader owned by `benchmarkMode`.
+* @since 2.3.0
+*/
+var BenchmarkMetricReader = class extends MetricReader {
+	onShutdown() {
+		return Promise.resolve();
+	}
+	onForceFlush() {
+		return Promise.resolve();
+	}
+};
+/**
+* Creates the in-process OpenTelemetry meter provider used by benchmark mode.
+* @returns The meter provider and the metric reader attached to it.
+* @since 2.3.0
+*/
+function createBenchmarkMeterProvider() {
+	const reader = new BenchmarkMetricReader();
+	return {
+		meterProvider: new MeterProvider$1({ readers: [reader] }),
+		reader
+	};
+}
+/**
+* Collects and serializes benchmark-mode metrics from a benchmark reader.
+* @param reader The benchmark metric reader to collect from.
+* @returns A server metric snapshot with any collection errors stringified.
+* @since 2.3.0
+*/
+async function collectBenchmarkMetrics(reader) {
+	const result = await reader.collect();
+	return {
+		version: 1,
+		source: "server",
+		generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		scopeMetrics: serializeScopeMetrics(result.resourceMetrics),
+		errors: result.errors.map((error) => String(error))
+	};
+}
+/**
+* Handles `GET /.well-known/fedify/bench/stats`.
+* @param request The HTTP request to handle.
+* @param reader The benchmark metric reader to collect from.
+* @returns A JSON metric snapshot response, or `405 Method Not Allowed`.
+* @since 2.3.0
+*/
+async function handleBenchmarkStats(request, reader) {
+	if (request.method !== "GET") return new Response("Method not allowed", {
+		status: 405,
+		headers: { "Allow": "GET" }
+	});
+	return jsonResponse(await collectBenchmarkMetrics(reader));
+}
+/**
+* Handles `POST /.well-known/fedify/bench/trigger`.
+*
+* The handler validates a benchmark trigger request, checks recipients against
+* server-controlled trigger options, and calls `Context.sendActivity()` to use
+* the target's normal outbox path.
+* @param request The HTTP request to handle.
+* @param context The Fedify context used to resolve actors and send activity.
+* @param options Server-controlled benchmark trigger delivery options.
+* @returns A JSON response describing the sent activity, or a validation error.
+* @since 2.3.0
+*/
+async function handleBenchmarkTrigger(request, context, options = {}) {
+	if (request.method !== "POST") return new Response("Method not allowed", {
+		status: 405,
+		headers: { "Allow": "POST" }
+	});
+	let json;
+	try {
+		json = await request.json();
+	} catch {
+		return jsonResponse({ error: "Invalid JSON request body." }, 400);
+	}
+	try {
+		const body = asRecord(json, "request body");
+		const sender = parseSender(body.sender);
+		const recipients = await parseRecipients(body.recipients, context);
+		const activity = await parseActivity(body.activity, context);
+		if (activity.id == null) throw new BenchmarkTriggerError("activity must have an id.");
+		const activityId = activity.id.href;
+		const inboxes = extractInboxes({ recipients });
+		const inboxUrls = Object.keys(inboxes);
+		if (inboxUrls.length < 1) throw new BenchmarkTriggerError("No valid recipient inboxes found. The recipients list must not be empty.");
+		const unsafeInboxes = options.allowUnsafeRecipients ? [] : inboxUrls.filter((inbox) => !options.sinks?.has(inbox));
+		if (unsafeInboxes.length > 0) return jsonResponse({
+			error: "unsafe_recipient",
+			unsafeInboxes
+		}, 403);
+		await context.sendActivity(sender, recipients, activity);
+		return jsonResponse({
+			version: 1,
+			activityId,
+			queueCorrelationId: activityId,
+			recipientCount: recipients.length,
+			inboxCount: inboxUrls.length
+		}, 202);
+	} catch (error) {
+		if (error instanceof BenchmarkTriggerError) return jsonResponse({ error: error.message }, error.status);
+		throw error;
+	}
+}
+var BenchmarkTriggerError = class extends Error {
+	status;
+	constructor(message, status = 400) {
+		super(message);
+		this.status = status;
+	}
+};
+function parseSender(value) {
+	const sender = asRecord(value, "sender");
+	if (typeof sender.identifier === "string") return { identifier: sender.identifier };
+	if (typeof sender.username === "string") return { username: sender.username };
+	throw new BenchmarkTriggerError("sender must be { identifier } or { username }.");
+}
+async function parseRecipients(value, context) {
+	if (!Array.isArray(value)) throw new BenchmarkTriggerError("recipients must be an array.");
+	return await Promise.all(value.map(async (item) => {
+		let object;
+		try {
+			object = await Object$1.fromJsonLd(item, {
+				documentLoader: context.documentLoader,
+				contextLoader: context.contextLoader
+			});
+		} catch (error) {
+			throw new BenchmarkTriggerError(`Invalid ActivityPub recipient: ${error}`);
+		}
+		if (!isRecipient(object)) throw new BenchmarkTriggerError("each recipient must be an ActivityPub actor.");
+		const recipient = object;
+		if (recipient.id == null || recipient.inboxId == null) throw new BenchmarkTriggerError("each recipient must have id and inbox properties.");
+		return recipient;
+	}));
+}
+function isRecipient(value) {
+	return value != null && typeof value === "object" && "id" in value && "inboxId" in value;
+}
+async function parseActivity(value, context) {
+	try {
+		return await Activity.fromJsonLd(value, {
+			documentLoader: context.documentLoader,
+			contextLoader: context.contextLoader
+		});
+	} catch (error) {
+		throw new BenchmarkTriggerError(`Invalid ActivityPub activity: ${error}`);
+	}
+}
+function asRecord(value, name) {
+	if (value == null || typeof value !== "object" || Array.isArray(value)) throw new BenchmarkTriggerError(`${name} must be an object.`);
+	return value;
+}
+function jsonResponse(body, status = 200) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: { "Content-Type": "application/json" }
+	});
+}
+function serializeScopeMetrics(resourceMetrics) {
+	return resourceMetrics.scopeMetrics.map(serializeScope);
+}
+function serializeScope(scopeMetrics) {
+	return {
+		scope: {
+			name: scopeMetrics.scope.name,
+			version: scopeMetrics.scope.version
+		},
+		metrics: scopeMetrics.metrics.map(serializeMetric)
+	};
+}
+function serializeMetric(metric) {
+	return {
+		name: metric.descriptor.name,
+		description: metric.descriptor.description,
+		unit: metric.descriptor.unit,
+		dataPointType: serializeDataPointType(metric.dataPointType),
+		dataPoints: metric.dataPoints.map((point) => ({
+			attributes: { ...point.attributes },
+			startTime: point.startTime,
+			endTime: point.endTime,
+			value: point.value
+		}))
+	};
+}
+function serializeDataPointType(dataPointType) {
+	switch (dataPointType) {
+		case DataPointType.HISTOGRAM: return "histogram";
+		case DataPointType.EXPONENTIAL_HISTOGRAM: return "exponential_histogram";
+		case DataPointType.GAUGE: return "gauge";
+		case DataPointType.SUM: return "sum";
+	}
+}
+//#endregion
+//#region src/federation/retry.ts
+/**
+* Creates an exponential backoff retry policy.  The delay between retries
+* starts at the `initialDelay` and is multiplied by the `factor` for each
+* subsequent retry, up to the `maxDelay`.  The policy will give up after
+* `maxAttempts` attempts.  The actual delay is randomized to avoid
+* synchronization (jitter).
+* @param options The options for the policy.
+* @returns The retry policy.
+* @since 0.12.0
+*/
+function createExponentialBackoffPolicy(options = {}) {
+	const initialDelay = Temporal.Duration.from(options.initialDelay ?? { seconds: 1 });
+	const maxDelay = Temporal.Duration.from(options.maxDelay ?? { hours: 12 });
+	const maxAttempts = options.maxAttempts ?? 10;
+	const factor = options.factor ?? 2;
+	const jitter = options.jitter ?? true;
+	return ({ attempts }) => {
+		if (attempts >= maxAttempts) return null;
+		let milliseconds = initialDelay.total("millisecond");
+		milliseconds *= factor ** attempts;
+		if (jitter) {
+			milliseconds *= 1 + Math.random();
+			milliseconds = Math.round(milliseconds);
+		}
+		const delay = Temporal.Duration.from({ milliseconds });
+		return Temporal.Duration.compare(delay, maxDelay) > 0 ? maxDelay : delay;
+	};
+}
+//#endregion
 //#region src/federation/webfinger.ts
 const logger = getLogger([
 	"fedify",
@@ -3527,6 +3730,7 @@ var middleware_exports = /* @__PURE__ */ __exportAll({
 	createFederation: () => createFederation
 });
 const circuitBreakerCasWarningKvStores = /* @__PURE__ */ new WeakSet();
+let nextQueueDepthGaugeSourceId = 0;
 const retryAfterHttpDate = /* @__PURE__ */ new RegExp("^(?:(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun), \\d{2} (?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \\d{4} \\d{2}:\\d{2}:\\d{2} GMT|(?:Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday), \\d{2}-(?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)-\\d{2} \\d{2}:\\d{2}:\\d{2} GMT|(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun) (?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) (?: \\d|\\d{2}) \\d{2}:\\d{2}:\\d{2} \\d{4})$");
 function parseRetryAfter(headers, now = Temporal.Now.instant()) {
 	const value = headers.get("Retry-After");
@@ -3555,6 +3759,54 @@ function parseRetryAfterDuration(durationLike) {
 function clampNegativeDelay(delay) {
 	return delay.sign < 0 ? Temporal.Duration.from({ seconds: 0 }) : delay;
 }
+function getBenchmarkRelaxations(allowPrivateAddress, signatureTimeWindow) {
+	const relaxations = [];
+	if (allowPrivateAddress) relaxations.push({
+		protection: "private_address_checks",
+		effect: "disabled",
+		effectiveValue: true
+	});
+	if (signatureTimeWindow === false) relaxations.push({
+		protection: "http_signature_time_window",
+		effect: "disabled",
+		effectiveValue: false,
+		secureDefaultSeconds: 3600
+	});
+	else try {
+		const seconds = Temporal.Duration.from(signatureTimeWindow).total({ unit: "seconds" });
+		if (seconds !== 3600) relaxations.push({
+			protection: "http_signature_time_window",
+			effect: "changed",
+			effectiveSeconds: seconds,
+			secureDefaultSeconds: 3600
+		});
+	} catch {}
+	return relaxations;
+}
+function formatBenchmarkRelaxations(relaxations) {
+	if (relaxations.length < 1) return "no benchmark-only protections relaxed";
+	return relaxations.map((relaxation) => {
+		switch (relaxation.protection) {
+			case "private_address_checks": return "private address checks disabled (allowPrivateAddress=true)";
+			case "http_signature_time_window":
+				if (relaxation.effect === "disabled") return `HTTP Signature time window disabled (signatureTimeWindow=false)`;
+				return `HTTP Signature time window set to ${relaxation.effectiveSeconds}s (secure default: ${relaxation.secureDefaultSeconds}s)`;
+		}
+	}).join("; ");
+}
+function getBenchmarkTriggerOptions(benchmarkOptions) {
+	const sinks = benchmarkOptions.triggerSinks?.map((sink) => {
+		try {
+			return new URL(sink).href;
+		} catch {
+			throw new TypeError("benchmarkMode.triggerSinks must contain only URLs.");
+		}
+	});
+	return {
+		sinks: sinks == null ? void 0 : new Set(sinks),
+		allowUnsafeRecipients: benchmarkOptions.allowUnsafeTriggerRecipients === true
+	};
+}
 function maxDelay(first, second) {
 	return Temporal.Duration.compare(first, second) >= 0 ? first : second;
 }
@@ -3591,8 +3843,10 @@ function isPermanentInboxParseError(error) {
 }
 /**
 * Create a new {@link Federation} instance.
-* @param parameters Parameters for initializing the instance.
+* @param options Parameters for initializing the instance.
 * @returns A new {@link Federation} instance.
+* @throws {TypeError} If benchmark mode and `meterProvider` are both
+* specified.
 * @since 0.10.0
 */
 function createFederation(options) {
@@ -3626,8 +3880,31 @@ var FederationImpl = class extends FederationBuilderImpl {
 	_meterProvider;
 	firstKnock;
 	inboxChallengePolicy;
+	benchmarkMode;
+	benchmarkMetricReader;
+	benchmarkTriggerOptions;
+	#queueDepthGaugeSourceId = `fedify-${(++nextQueueDepthGaugeSourceId).toString(36)}`;
+	#queueDepthGaugeEntries = [];
+	#queueDepthGaugeMeterProvider;
 	constructor(options) {
 		super();
+		const benchmarkMode = options.benchmarkMode != null && options.benchmarkMode !== false;
+		const benchmarkOptions = typeof options.benchmarkMode === "object" ? options.benchmarkMode : {};
+		const hasCustomLoaderFactory = options.documentLoaderFactory != null || options.contextLoaderFactory != null;
+		const allowPrivateAddress = options.allowPrivateAddress ?? (benchmarkMode && !hasCustomLoaderFactory ? true : false);
+		const signatureTimeWindow = options.signatureTimeWindow ?? (benchmarkMode ? false : { hours: 1 });
+		if (benchmarkMode && options.meterProvider != null) throw new TypeError("benchmarkMode requires Fedify to own the meterProvider; OpenTelemetry metric readers cannot be added after a MeterProvider is constructed.");
+		if (benchmarkMode) {
+			const relaxations = getBenchmarkRelaxations(allowPrivateAddress, signatureTimeWindow);
+			const relaxationSummary = formatBenchmarkRelaxations(relaxations);
+			getLogger([
+				"fedify",
+				"federation",
+				"benchmark"
+			]).warn(`Fedify benchmarkMode is enabled; ${relaxationSummary}. Benchmark endpoints are active and must not be used in production.`, { relaxations });
+		}
+		this.benchmarkMode = benchmarkMode;
+		this.benchmarkTriggerOptions = benchmarkMode ? getBenchmarkTriggerOptions(benchmarkOptions) : {};
 		this.kv = options.kv;
 		this.kvPrefixes = {
 			activityIdempotence: ["_fedify", "activityIdempotence"],
@@ -3695,13 +3972,13 @@ var FederationImpl = class extends FederationBuilderImpl {
 		}
 		this.router.trailingSlashInsensitive = options.trailingSlashInsensitive ?? false;
 		this._initializeRouter();
-		if (options.allowPrivateAddress || options.userAgent != null) {
+		if (options.allowPrivateAddress === true || options.userAgent != null) {
 			if (options.documentLoaderFactory != null) throw new TypeError("Cannot set documentLoaderFactory with allowPrivateAddress or userAgent options.");
 			if (options.contextLoaderFactory != null) throw new TypeError("Cannot set contextLoaderFactory with allowPrivateAddress or userAgent options.");
 			if (options.authenticatedDocumentLoaderFactory != null) throw new TypeError("Cannot set authenticatedDocumentLoaderFactory with allowPrivateAddress or userAgent options.");
 		}
-		const { allowPrivateAddress, userAgent } = options;
-		this.allowPrivateAddress = allowPrivateAddress ?? false;
+		const { userAgent } = options;
+		this.allowPrivateAddress = allowPrivateAddress;
 		const userDocumentLoaderFactory = options.documentLoaderFactory;
 		const userContextLoaderFactory = options.contextLoaderFactory;
 		const userAuthFactory = options.authenticatedDocumentLoaderFactory;
@@ -3749,25 +4026,55 @@ var FederationImpl = class extends FederationBuilderImpl {
 		this.userAgent = userAgent;
 		this.onOutboxError = options.onOutboxError;
 		this.permanentFailureStatusCodes = options.permanentFailureStatusCodes ?? [404, 410];
-		this.signatureTimeWindow = options.signatureTimeWindow ?? { hours: 1 };
+		this.signatureTimeWindow = signatureTimeWindow;
 		this.skipSignatureVerification = options.skipSignatureVerification ?? false;
 		this.inboxChallengePolicy = options.inboxChallengePolicy;
 		this.outboxRetryPolicy = options.outboxRetryPolicy ?? createExponentialBackoffPolicy();
 		this.inboxRetryPolicy = options.inboxRetryPolicy ?? createExponentialBackoffPolicy();
 		this.activityTransformers = options.activityTransformers ?? getDefaultActivityTransformers();
 		this._tracerProvider = options.tracerProvider;
-		this._meterProvider = options.meterProvider;
+		if (benchmarkMode) {
+			const benchmarkMetrics = createBenchmarkMeterProvider();
+			this._meterProvider = benchmarkMetrics.meterProvider;
+			this.benchmarkMetricReader = benchmarkMetrics.reader;
+		} else this._meterProvider = options.meterProvider;
+		this.#queueDepthGaugeEntries = [
+			{
+				role: "inbox",
+				queue: this.inboxQueue
+			},
+			{
+				role: "outbox",
+				queue: this.outboxQueue
+			},
+			{
+				role: "fanout",
+				queue: this.fanoutQueue
+			}
+		];
+		this.#registerQueueDepthGauge(this._meterProvider ?? metrics.getMeterProvider());
 		this.firstKnock = options.firstKnock;
 	}
 	get tracerProvider() {
 		return this._tracerProvider ?? trace.getTracerProvider();
 	}
 	get meterProvider() {
-		return this._meterProvider ?? metrics.getMeterProvider();
+		const meterProvider = this._meterProvider ?? metrics.getMeterProvider();
+		this.#registerQueueDepthGauge(meterProvider);
+		return meterProvider;
+	}
+	#registerQueueDepthGauge(meterProvider) {
+		if (meterProvider === this.#queueDepthGaugeMeterProvider) return;
+		registerQueueDepthGauge(meterProvider, this.#queueDepthGaugeEntries, { sourceId: this.#queueDepthGaugeSourceId });
+		this.#queueDepthGaugeMeterProvider = meterProvider;
 	}
 	_initializeRouter() {
 		this.router.add("/.well-known/webfinger", "webfinger");
 		this.router.add("/.well-known/nodeinfo", "nodeInfoJrd");
+		if (this.benchmarkMode) {
+			this.router.add("/.well-known/fedify/bench/stats", "benchmarkStats");
+			this.router.add("/.well-known/fedify/bench/trigger", "benchmarkTrigger");
+		}
 	}
 	_getTracer() {
 		return this.tracerProvider.getTracer(name, version);
@@ -4779,6 +5086,8 @@ var FederationImpl = class extends FederationBuilderImpl {
 				context,
 				nodeInfoDispatcher: this.nodeInfoDispatcher
 			});
+			case "benchmarkStats": return await handleBenchmarkStats(request, this.benchmarkMetricReader);
+			case "benchmarkTrigger": return await handleBenchmarkTrigger(request, context, this.benchmarkTriggerOptions);
 		}
 		if (request.method !== "POST" && !acceptsJsonLd(request)) {
 			metricState.endpoint = "not_acceptable";
@@ -5018,6 +5327,8 @@ function getEndpointCategory(routeName) {
 		case "liked": return "liked";
 		case "featured": return "featured";
 		case "featuredTags": return "featured_tags";
+		case "benchmarkStats":
+		case "benchmarkTrigger": return "benchmark";
 		default: return "not_found";
 	}
 }
@@ -6088,4 +6399,4 @@ function getRequestId(request) {
 	return `req_${Date.now().toString(36)}${Math.random().toString(36).slice(2, 8)}`;
 }
 //#endregion
-export { createExponentialBackoffPolicy as a, buildCollectionSynchronizationHeader as c, normalizeCircuitBreakerOptions as d, parseCircuitBreakerKvState as f, SendActivityError as i, digest as l, middleware_exports as n, respondWithObject as o, createFederationBuilder as p, handleWebFinger as r, respondWithObjectIfAcceptable as s, createFederation as t, CircuitBreaker as u };
+export { SendActivityError as a, buildCollectionSynchronizationHeader as c, normalizeCircuitBreakerOptions as d, parseCircuitBreakerKvState as f, createExponentialBackoffPolicy as i, digest as l, middleware_exports as n, respondWithObject as o, createFederationBuilder as p, handleWebFinger as r, respondWithObjectIfAcceptable as s, createFederation as t, CircuitBreaker as u };