@fedify/fedify 2.0.0-dev.323 → 2.0.0-dev.372

package/dist/{middleware-LQKxYF7X.js → middleware-CEcrmJf2.js}

@@ -3,10 +3,10 @@
           import { URLPattern } from "urlpattern-polyfill";
         
 import { getDefaultActivityTransformers } from "./transformers-C3FLHUd6.js";
-import { deno_default, doubleKnock, exportJwk, importJwk, validateCryptoKey, verifyRequest } from "./http-C02fQ5SX.js";
-import { detachSignature, doesActorOwnKey, getKeyOwner, hasSignature, signJsonLd, signObject, verifyJsonLd, verifyObject } from "./proof-OjMPhNWs.js";
+import { deno_default, doubleKnock, exportJwk, importJwk, validateCryptoKey, verifyRequest } from "./http-C_qj3I7F.js";
+import { detachSignature, doesActorOwnKey, getKeyOwner, hasSignature, signJsonLd, signObject, verifyJsonLd, verifyObject } from "./proof-Cq8LNpQ3.js";
 import { getNodeInfo, nodeInfoToJson } from "./types-C93Ob9cU.js";
-import { getAuthenticatedDocumentLoader, kvCache } from "./kv-cache-BLxaWwPk.js";
+import { getAuthenticatedDocumentLoader, kvCache } from "./kv-cache-CibadbOC.js";
 import { getLogger, withContext } from "@logtape/logtape";
 import { Activity, Collection, CollectionPage, CryptographicKey, Link, Multikey, Object as Object$1, OrderedCollection, OrderedCollectionPage, getTypeId, lookupObject, traverseCollection } from "@fedify/vocab";
 import { SpanKind, SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
@@ -322,6 +322,7 @@ var FederationBuilderImpl = class {
 	inboxListeners;
 	inboxErrorHandler;
 	sharedInboxKeyDispatcher;
+	outboxPermanentFailureHandler;
 	idempotencyStrategy;
 	collectionTypeIds;
 	collectionCallbacks;
@@ -337,7 +338,7 @@ var FederationBuilderImpl = class {
 		this.collectionTypeIds = {};
 	}
 	async build(options) {
-		const { FederationImpl: FederationImpl$1 } = await import("./middleware-BhYGJwH9.js");
+		const { FederationImpl: FederationImpl$1 } = await import("./middleware-BDQ8PDFx.js");
 		const f = new FederationImpl$1(options);
 		const trailingSlashInsensitiveValue = f.router.trailingSlashInsensitive;
 		f.router = this.router.clone();
@@ -359,6 +360,7 @@ var FederationBuilderImpl = class {
 		f.inboxListeners = this.inboxListeners?.clone();
 		f.inboxErrorHandler = this.inboxErrorHandler;
 		f.sharedInboxKeyDispatcher = this.sharedInboxKeyDispatcher;
+		f.outboxPermanentFailureHandler = this.outboxPermanentFailureHandler;
 		f.idempotencyStrategy = this.idempotencyStrategy;
 		return f;
 	}
@@ -840,6 +842,9 @@ var FederationBuilderImpl = class {
 		const path = this.router.build(`collection:${routeName}`, values) ?? this.router.build(`orderedCollection:${routeName}`, values);
 		return path;
 	}
+	setOutboxPermanentFailureHandler(handler) {
+		this.outboxPermanentFailureHandler = handler;
+	}
 	/**
 	* Converts a name (string or symbol) to a unique string identifier.
 	* For symbols, generates and caches a UUID if not already present.
@@ -2180,7 +2185,7 @@ async function sendActivityInternal({ activity, activityId, keys, inbox, headers
 			statusText: response.statusText,
 			error
 		});
-		throw new Error(`Failed to send activity ${activityId} to ${inbox.href} (${response.status} ${response.statusText}):\n${error}`);
+		throw new SendActivityError(inbox, response.status, `Failed to send activity ${activityId} to ${inbox.href} (${response.status} ${response.statusText}):\n${error}`, error);
 	}
 	span.addEvent("activitypub.activity.sent", {
 		"activitypub.activity.json": JSON.stringify(activity),
@@ -2188,6 +2193,40 @@ async function sendActivityInternal({ activity, activityId, keys, inbox, headers
 		"activitypub.activity.id": activityId ?? ""
 	});
 }
+/**
+* An error that is thrown when an activity fails to send to a remote inbox.
+* It contains structured information about the failure, including the HTTP
+* status code, the inbox URL, and the response body.
+* @since 2.0.0
+*/
+var SendActivityError = class extends Error {
+	/**
+	* The inbox URL that the activity was being sent to.
+	*/
+	inbox;
+	/**
+	* The HTTP status code returned by the inbox.
+	*/
+	statusCode;
+	/**
+	* The response body from the inbox, if any.
+	*/
+	responseBody;
+	/**
+	* Creates a new {@link SendActivityError}.
+	* @param inbox The inbox URL.
+	* @param statusCode The HTTP status code.
+	* @param message The error message.
+	* @param responseBody The response body.
+	*/
+	constructor(inbox, statusCode, message, responseBody) {
+		super(message);
+		this.name = "SendActivityError";
+		this.inbox = inbox;
+		this.statusCode = statusCode;
+		this.responseBody = responseBody;
+	}
+};
 
 //#endregion
 //#region src/federation/webfinger.ts
@@ -2349,12 +2388,13 @@ var FederationImpl = class extends FederationBuilderImpl {
 	allowPrivateAddress;
 	userAgent;
 	onOutboxError;
+	permanentFailureStatusCodes;
 	signatureTimeWindow;
 	skipSignatureVerification;
 	outboxRetryPolicy;
 	inboxRetryPolicy;
 	activityTransformers;
-	tracerProvider;
+	_tracerProvider;
 	firstKnock;
 	constructor(options) {
 		super();
@@ -2430,14 +2470,18 @@ 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.skipSignatureVerification = options.skipSignatureVerification ?? false;
 		this.outboxRetryPolicy = options.outboxRetryPolicy ?? createExponentialBackoffPolicy();
 		this.inboxRetryPolicy = options.inboxRetryPolicy ?? createExponentialBackoffPolicy();
 		this.activityTransformers = options.activityTransformers ?? getDefaultActivityTransformers();
-		this.tracerProvider = options.tracerProvider ?? trace.getTracerProvider();
+		this._tracerProvider = options.tracerProvider;
 		this.firstKnock = options.firstKnock;
 	}
+	get tracerProvider() {
+		return this._tracerProvider ?? trace.getTracerProvider();
+	}
 	_initializeRouter() {
 		this.router.add("/.well-known/webfinger", "webfinger");
 		this.router.add("/.well-known/nodeinfo", "nodeInfoJrd");
@@ -2478,18 +2522,24 @@ var FederationImpl = class extends FederationBuilderImpl {
 				kind: SpanKind.CONSUMER,
 				attributes: { "activitypub.activity.type": message.activityType }
 			}, extractedContext, async (span) => {
-				if (message.activityId != null) span.setAttribute("activitypub.activity.id", message.activityId);
-				try {
-					await this.#listenFanoutMessage(contextData, message);
-				} catch (e) {
-					span.setStatus({
-						code: SpanStatusCode.ERROR,
-						message: String(e)
-					});
-					throw e;
-				} finally {
-					span.end();
-				}
+				const spanCtx = span.spanContext();
+				return await withContext({
+					traceId: spanCtx.traceId,
+					spanId: spanCtx.spanId
+				}, async () => {
+					if (message.activityId != null) span.setAttribute("activitypub.activity.id", message.activityId);
+					try {
+						await this.#listenFanoutMessage(contextData, message);
+					} catch (e) {
+						span.setStatus({
+							code: SpanStatusCode.ERROR,
+							message: String(e)
+						});
+						throw e;
+					} finally {
+						span.end();
+					}
+				});
 			});
 			else if (message.type === "outbox") await tracer.startActiveSpan("activitypub.outbox", {
 				kind: SpanKind.CONSUMER,
@@ -2498,34 +2548,46 @@ var FederationImpl = class extends FederationBuilderImpl {
 					"activitypub.activity.retries": message.attempt
 				}
 			}, extractedContext, async (span) => {
-				if (message.activityId != null) span.setAttribute("activitypub.activity.id", message.activityId);
-				try {
-					await this.#listenOutboxMessage(contextData, message, span);
-				} catch (e) {
-					span.setStatus({
-						code: SpanStatusCode.ERROR,
-						message: String(e)
-					});
-					throw e;
-				} finally {
-					span.end();
-				}
+				const spanCtx = span.spanContext();
+				return await withContext({
+					traceId: spanCtx.traceId,
+					spanId: spanCtx.spanId
+				}, async () => {
+					if (message.activityId != null) span.setAttribute("activitypub.activity.id", message.activityId);
+					try {
+						await this.#listenOutboxMessage(contextData, message, span);
+					} catch (e) {
+						span.setStatus({
+							code: SpanStatusCode.ERROR,
+							message: String(e)
+						});
+						throw e;
+					} finally {
+						span.end();
+					}
+				});
 			});
 			else if (message.type === "inbox") await tracer.startActiveSpan("activitypub.inbox", {
 				kind: SpanKind.CONSUMER,
 				attributes: { "activitypub.shared_inbox": message.identifier == null }
 			}, extractedContext, async (span) => {
-				try {
-					await this.#listenInboxMessage(contextData, message, span);
-				} catch (e) {
-					span.setStatus({
-						code: SpanStatusCode.ERROR,
-						message: String(e)
-					});
-					throw e;
-				} finally {
-					span.end();
-				}
+				const spanCtx = span.spanContext();
+				return await withContext({
+					traceId: spanCtx.traceId,
+					spanId: spanCtx.spanId
+				}, async () => {
+					try {
+						await this.#listenInboxMessage(contextData, message, span);
+					} catch (e) {
+						span.setStatus({
+							code: SpanStatusCode.ERROR,
+							message: String(e)
+						});
+						throw e;
+					} finally {
+						span.end();
+					}
+				});
 			});
 		});
 	}
@@ -2612,13 +2674,44 @@ var FederationImpl = class extends FederationBuilderImpl {
 				tracerProvider: this.tracerProvider
 			});
 			try {
-				this.onOutboxError?.(error, activity);
+				await this.onOutboxError?.(error, activity);
 			} catch (error$1) {
 				logger$1.error("An unexpected error occurred in onError handler:\n{error}", {
 					...logData,
 					error: error$1
 				});
 			}
+			if (error instanceof SendActivityError && this.permanentFailureStatusCodes.includes(error.statusCode)) {
+				logger$1.warn("Permanent delivery failure for activity {activityId} to {inbox} ({status}); not retrying.", {
+					...logData,
+					status: error.statusCode
+				});
+				if (this.outboxPermanentFailureHandler != null) {
+					const ctx = this.#createContext(new URL(message.baseUrl), _, { documentLoader: this.documentLoaderFactory(loaderOptions) });
+					try {
+						await this.outboxPermanentFailureHandler(ctx, {
+							inbox: new URL(message.inbox),
+							activity,
+							error,
+							statusCode: error.statusCode,
+							actorIds: (message.actorIds ?? []).flatMap((id) => {
+								try {
+									return [new URL(id)];
+								} catch {
+									logger$1.warn("Invalid actorId URL in OutboxMessage: {id}", { id });
+									return [];
+								}
+							})
+						});
+					} catch (handlerError) {
+						logger$1.error("An unexpected error occurred in outboxPermanentFailureHandler:\n{error}", {
+							...logData,
+							error: handlerError
+						});
+					}
+				}
+				return;
+			}
 			if (this.outboxQueue?.nativeRetrial) {
 				logger$1.error("Failed to send activity {activityId} to {inbox}; backend will handle retry:\n{error}", {
 					...logData,
@@ -2909,6 +3002,7 @@ var FederationImpl = class extends FederationBuilderImpl {
 				activityType: getTypeId(activity).href,
 				inbox,
 				sharedInbox: inboxes[inbox].sharedInbox,
+				actorIds: [...inboxes[inbox].actorIds],
 				started: (/* @__PURE__ */ new Date()).toISOString(),
 				attempt: 0,
 				headers: collectionSync == null ? {} : { "Collection-Synchronization": await buildCollectionSynchronizationHeader(collectionSync, inboxes[inbox].actorIds) },
@@ -2966,54 +3060,60 @@ var FederationImpl = class extends FederationBuilderImpl {
 					[ATTR_URL_FULL]: request.url
 				}
 			}, async (span) => {
-				const logger$1 = getLogger([
-					"fedify",
-					"federation",
-					"http"
-				]);
-				if (span.isRecording()) for (const [k, v] of request.headers) span.setAttribute(ATTR_HTTP_REQUEST_HEADER(k), [v]);
-				let response;
-				try {
-					response = await this.#fetch(request, {
-						...options,
-						span,
-						tracer
-					});
-					if (acceptsJsonLd(request)) response.headers.set("Vary", "Accept");
-				} catch (error) {
-					span.setStatus({
-						code: SpanStatusCode.ERROR,
-						message: `${error}`
-					});
+				const spanCtx = span.spanContext();
+				return await withContext({
+					traceId: spanCtx.traceId,
+					spanId: spanCtx.spanId
+				}, async () => {
+					const logger$1 = getLogger([
+						"fedify",
+						"federation",
+						"http"
+					]);
+					if (span.isRecording()) for (const [k, v] of request.headers) span.setAttribute(ATTR_HTTP_REQUEST_HEADER(k), [v]);
+					let response;
+					try {
+						response = await this.#fetch(request, {
+							...options,
+							span,
+							tracer
+						});
+						if (acceptsJsonLd(request)) response.headers.set("Vary", "Accept");
+					} catch (error) {
+						span.setStatus({
+							code: SpanStatusCode.ERROR,
+							message: `${error}`
+						});
+						span.end();
+						logger$1.error("An error occurred while serving request {method} {url}: {error}", {
+							method: request.method,
+							url: request.url,
+							error
+						});
+						throw error;
+					}
+					if (span.isRecording()) {
+						span.setAttribute(ATTR_HTTP_RESPONSE_STATUS_CODE, response.status);
+						for (const [k, v] of response.headers) span.setAttribute(ATTR_HTTP_RESPONSE_HEADER(k), [v]);
+						span.setStatus({
+							code: response.status >= 500 ? SpanStatusCode.ERROR : SpanStatusCode.UNSET,
+							message: response.statusText
+						});
+					}
 					span.end();
-					logger$1.error("An error occurred while serving request {method} {url}: {error}", {
+					const url = new URL(request.url);
+					const logTpl = "{method} {path}: {status}";
+					const values = {
 						method: request.method,
+						path: `${url.pathname}${url.search}`,
 						url: request.url,
-						error
-					});
-					throw error;
-				}
-				if (span.isRecording()) {
-					span.setAttribute(ATTR_HTTP_RESPONSE_STATUS_CODE, response.status);
-					for (const [k, v] of response.headers) span.setAttribute(ATTR_HTTP_RESPONSE_HEADER(k), [v]);
-					span.setStatus({
-						code: response.status >= 500 ? SpanStatusCode.ERROR : SpanStatusCode.UNSET,
-						message: response.statusText
-					});
-				}
-				span.end();
-				const url = new URL(request.url);
-				const logTpl = "{method} {path}: {status}";
-				const values = {
-					method: request.method,
-					path: `${url.pathname}${url.search}`,
-					url: request.url,
-					status: response.status
-				};
-				if (response.status >= 500) logger$1.error(logTpl, values);
-				else if (response.status >= 400) logger$1.warn(logTpl, values);
-				else logger$1.info(logTpl, values);
-				return response;
+						status: response.status
+					};
+					if (response.status >= 500) logger$1.error(logTpl, values);
+					else if (response.status >= 400) logger$1.warn(logTpl, values);
+					else logger$1.info(logTpl, values);
+					return response;
+				});
 			});
 		});
 	}
@@ -4197,4 +4297,4 @@ function getRequestId(request) {
 }
 
 //#endregion
-export { ContextImpl, FederationImpl, InboxContextImpl, KvSpecDeterminer, Router$1 as Router, RouterError, buildCollectionSynchronizationHeader, createExponentialBackoffPolicy, createFederation, createFederationBuilder, digest, handleWebFinger, respondWithObject, respondWithObjectIfAcceptable };
+export { ContextImpl, FederationImpl, InboxContextImpl, KvSpecDeterminer, Router$1 as Router, RouterError, SendActivityError, buildCollectionSynchronizationHeader, createExponentialBackoffPolicy, createFederation, createFederationBuilder, digest, handleWebFinger, respondWithObject, respondWithObjectIfAcceptable };

package/dist/middleware-COrE1spG.cjs

@@ -0,0 +1,12 @@
+
+          const { Temporal } = require("@js-temporal/polyfill");
+          const { URLPattern } = require("urlpattern-polyfill");
+        
+require('./transformers-3g8GZwkZ.cjs');
+require('./http-B8cUSIVv.cjs');
+const require_middleware = require('./middleware-DfAuhaf7.cjs');
+require('./proof-EVy7shg_.cjs');
+require('./types-Cd_hszr_.cjs');
+require('./kv-cache-CkfpyCN5.cjs');
+
+exports.FederationImpl = require_middleware.FederationImpl;