Fedify 1.10.0
Released on December 24, 2025.
@fedify/fedify
-
Enhanced OpenTelemetry instrumentation with span events for capturing detailed activity data. Span events now record complete activity JSON payloads and verification status, enabling richer observability and debugging capabilities without relying solely on span attributes (which only support primitive values). [#323]
- Added
activitypub.activity.receivedspan event to theactivitypub.inboxspan, recording the full activity JSON, verification status (activity verified, HTTP signatures verified, Linked Data signatures verified), and actor information. - Added
activitypub.activity.sentspan event to theactivitypub.send_activityspan, recording the full activity JSON and target inbox URL. - Added
activitypub.object.fetchedspan event to theactivitypub.lookup_objectspan, recording the fetched object's type and complete JSON-LD representation.
- Added
-
Added OpenTelemetry spans for previously uninstrumented operations: [#323]
- Added
activitypub.fetch_documentspan for document loader operations, tracking URL fetching, HTTP redirects, and final document URLs. - Added
activitypub.verify_key_ownershipspan for cryptographic key ownership verification, recording actor ID, key ID, verification result, and the verification method used.
- Added
-
Added optional
list()method to theKvStoreinterface for enumerating entries by key prefix. This method takes an optionalprefixparameter; when omitted or empty, it returns all entries. This enables efficient prefix scanning which is useful for implementing features like distributed trace storage, cache invalidation by prefix, and listing related entries. [#498, #500]- Added
KvStoreListEntryinterface. - Implemented in
MemoryKvStore.
- Added
-
Added
FedifySpanExporterclass that persists ActivityPub activity traces to aKvStorefor distributed tracing support. This enables aggregating trace data across multiple nodes in a distributed deployment, making it possible to build debug dashboards that show complete request flows across web servers and background workers. [#497, #502]- Added
@fedify/fedify/otelmodule. - Added
FedifySpanExporterclass implementing OpenTelemetry'sSpanExporterinterface. - Added
TraceActivityRecordinterface for stored activity data, includingactorIdandsignatureDetailsfields for debug dashboard support. - Added
SignatureVerificationDetailsinterface for detailed signature verification information. - Added
TraceSummaryinterface for trace listing. - Added
FedifySpanExporterOptionsinterface. - Added
GetRecentTracesOptionsinterface. - Added
ActivityDirectiontype.
- Added
@fedify/nestjs
- Allowed Express 5 in the
expresspeer dependency range to support NestJS 11. [#492, #493 by Cho Hasang]