Fedify 0.7.0

Released on April 23, 2024.

• Added PUBLIC_COLLECTION constant for public addressing.

• Federation now supports authorized fetch for actor dispatcher and collection dispatchers.

  • Added ActorCallbackSetters.authorize() method.
  • Added CollectionCallbackSetters.authorize() method.
  • Added AuthorizedPredicate type.
  • Added RequestContext.getSignedKey() method.
  • Added RequestContext.getSignedKeyOwner() method.
  • Added FederationFetchOptions.onUnauthorized option for handling unauthorized fetches.
  • Added getKeyOwner() function.

• The default implementation of FederationFetchOptions.onNotAcceptable option now responds with Vary: Accept, Signature header.

• Added log messages using the LogTape library. Currently the below logger categories are used:

  • ["fedify"]
  • ["fedify", "federation"]
  • ["fedify", "federation", "inbox"]
  • ["fedify", "federation", "outbox"]

• Added RequestContext.getActor() method.

• Activity Vocabulary classes now have typeId static property.

• Dispatcher setters and inbox listener setters in Federation now take a path as `${string}{handle}${string}` instead of string so that it is more type-safe.

• Added generalized object dispatchers. [#33]

  • Added Federation.setObjectDispatcher() method.
  • Added ObjectDispatcher type.
  • Added ObjectAuthorizePredicate type.
  • Added Context.getObjectUri() method.
  • Added RequestContext.getObject() method.

Fedify 0.6.1

Released on April 17, 2024.

• Fixed a bug of new Federation() constructor that if it is once called the process will never exit. [#39]

Fedify 0.5.2

Released on April 17, 2024.

• Fixed a bug of new Federation() constructor that if it is once called the process will never exit. [#39]

Fedify 0.6.0

Released on April 9, 2024.

• DocumentLoader is now propagated to the loaded remote objects from Activity Vocabulary objects. [#27]

  • Added options parameter to Activity Vocabulary constructors.
  • Added options parameter to clone() method of Activity Vocabulary objects.
  • The Activity Vocabulary object passed to InboxListener now implicitly loads remote object with an authenticated DocumentLoader.

• Added Federation.fetch() method.

  • Deprecated Federation.handle() method. Use Federation.fetch() method instead.
  • Renamed FederationHandlerParameters type to FederationFetchOptions.
  • Added integrateFetchOptions() function.
  • Deprecated integrateHandlerOptions() function.

• Added @fedify/fedify/x/hono module for integrating with Hono middleware. [#25]

  • Added federation() function.
  • Added ContextDataFactory type.

• Context.sendActivity() method now throws TypeError instead of silently failing when the given Activity object lacks the actor property.

• Context.sendActivity() method now uses an authenticated document loader under the hood.

• Added outbox error handler to Federation.

  • Added onOutboxError option to new Federation() constructor.
  • Added OutboxErrorHandler type.

Fedify 0.5.1

Released on April 5, 2024.

• Fixed a bug of Federation that its actor/collection dispatchers had done content negotiation before determining if the resource exists or not. It also fixed a bug that integrateHandler() from @fedify/fedify/x/fresh had responded with 406 Not Acceptable instead of 404 Not Found when the resource does not exist in the web browser. [#34]

Fedify 0.5.0

Released on April 2, 2024.

• Fedify is now available on npm: @fedify/fedify. [#24]

• Abstract key-value store for caching.

  • Added KvStore interface.
  • Added KvStoreSetOptions interface.
  • Added KvKey type.
  • Added DenoKvStore class.
  • KvCacheParameters.kv option now accepts a KvStore instead of Deno.Kv.
  • KvCacheParameters.prefix option now accepts a KvKey instead of Deno.KvKey.
  • FederationParameters.kv option now accepts a KvStore instead of Deno.Kv.
  • FederationKvPrefixes.activityIdempotence option now accepts a KvKey instead of Deno.KvKey.
  • FederationKvPrefixes.remoteDocument option now accepts a KvKey instead of Deno.KvKey.

• Abstract message queue for outgoing activities.

  • Added MessageQueue interface.
  • Added MessageQueueEnqueueOptions interface.
  • Added InProcessMessageQueue class.
  • Added FederationParameters.queue option.

• Added @fedify/fedify/x/denokv module for adapting Deno.Kv to KvStore and MessageQueue. It is only available in Deno runtime.

  • Added DenoKvStore class.
  • Added DenoKvMessageQueue class.

• Added PropertyValue to Activity Vocabulary API. [#29]

  • Added PropertyValue class.
  • new Object() constructor's attachments option now accepts PropertyValue objects.
  • new Object() constructor's attachment option now accepts a PropertyValue object.
  • Object.getAttachments() method now yields PropertyValue objects besides Object and Link objects.
  • Object.getAttachment() method now returns a PropertyValue object besides an Object and a Link object.
  • Object.clone() method's attachments option now accepts PropertyValue objects.
  • Object.clone() method's attachment option now accepts a PropertyValue object.

• Removed dependency on jose.

  • Added exportSpki() function.
  • Added importSpki() function.

• Fixed a bug that Application.manuallyApprovesFollowers, Group.manuallyApprovesFollowers, Organization.manuallyApprovesFollowers, Person.manuallyApprovesFollowers, and Service.manuallyApprovesFollowers properties were not properly displayed in Mastodon.

Fedify 0.4.0

Released on March 26, 2024.

• Added @fedify/fedify/x/fresh module for integrating with Fresh middleware.

  • Added integrateHandler() function.
  • Added integrateHandlerOptions() function.

• Added getActorHandle() function.

• Fedify now has authenticated document loader. [#12]

  • Added Context.getDocumentLoader() method.
  • Added getAuthenticatedDocumentLoader() function.
  • Added AuthenticatedDocumentLoaderFactory type.
  • Added authenticatedDocumentLoaderFactory option to new Federation() constructor.
  • Context.documentLoader property now returns an authenticated document loader in personal inbox listeners. (Note that it's not affected in shared inbox listeners.)

• Added singular accessors to Object's icon and image properties.

  • new Object() constructor now accepts icon option.
  • new Object() constructor now accepts image option.
  • Added Object.getIcon() method.
  • Added Object.getImage() method.
  • Object.clone() method now accepts icon option.
  • Object.clone() method now accepts image option.

• Object's icon and image properties no more accept Link objects.

  • new Object() constructor's icons option no more accepts Link objects.
  • new Object() constructor's images option no more accepts Link objects.
  • Object.getIcons() method no more yields Link objects.
  • Object.getImages() method no more yields Link objects.
  • Object.clone() method's icons option no more accepts Link objects.
  • Object.clone() method's images option no more accepts Link objects.

• Object's attributedTo property was renamed to attribution.

  • new Object() constructor's attributedTo option was renamed to attribution.
  • new Object() constructor's attributedTos option was renamed to attributions.
  • Object.getAttributedTo() method is renamed to Object.getAttribution().
  • Object.getAttributedTos() method is renamed to Object.getAttributions().
  • Object.clone() method's attributedTo option is renamed to attribution.
  • Object.clone() method's attributedTos option is renamed to attributions.

• Object's attribution property (was attributedTo) now accepts only Actor objects.

  • new Object() constructor's attribution option (was attributedTo) now accepts only an Actor object.
  • new Object() constructor's attributions option (was attributedTos) now accepts only Actor objects.
  • Object.getAttribution() method (was getAttributedTo()) now returns only an Actor object.
  • Object.getAttributions() method (was getAttributedTos()) now returns only Actor objects.
  • Object.clone() method's attribution option (attributedTo) now accepts only an Actor object.
  • Object.clone() method's attributions option (attributedTos) now accepts only Actor objects.

• Activity's object property no more accepts Link objects.

  • new Activity() constructor's object option no more accepts a Link object.
  • new Activity() constructor's objects option no more accepts Link objects.
  • Activity.getObject() method no more returns a Link object.
  • Activity.getObjects() method no more returns Link objects.
  • Activity.clone() method's object option no more accepts a Link object.
  • Activity.clone() method's objects option no more accepts Link objects.

• Activity's actor property now accepts only Actor objects.

  • new Activity() constructor's actor option now accepts only an Actor object.
  • new Activity() constructor's actors option now accepts only Actor objects.
  • Activity.getActor() method now returns only an Actor object.
  • Activity.getActors() method now returns only Actor objects.
  • Activity.clone() method's actor option now accepts only an Actor object.
  • Activity.clone() method's actors option now accepts only Actor objects.

• Added sensitive property to Object class.

  • new Object() constructor now accepts sensitive option.
  • Added Object.sensitive attribute.
  • Object.clone() method now accepts sensitive option.

• Now lookupWebFinger() follows redirections.

• The http://webfinger.net/rel/profile-page links in WebFinger responses now omit type property.

Fedify 0.3.0

Released on March 15, 2024.

• Added utility functions for responding with an ActivityPub object:

  • Added respondWithObject() function.
  • Added respondWithObjectIfAcceptable() function.
  • Added RespondWithObjectOptions interface.

• Added utility functions for generating and exporting cryptographic keys which are compatible with popular ActivityPub software:

  • Added generateCryptoKeyPair() function.
  • Added exportJwk() function.
  • Added importJwk() function.

• The following functions and methods now throw TypeError if the specified CryptoKey is not extractable:

  • Context.getActorKey() method
  • Context.sendActivity() method
  • Federation.sendActivity() method

• Added immediate option to Context.sendActivity() and Federation.sendActivity() methods.

• Added SendActivityOptions interface.

• Now onNotFound/onNotAcceptable options are optional for Federation.handle() method. [#9]

Fedify 0.2.0

Released on March 10, 2024.

• Implemented NodeInfo 2.1 protocol. [#1]

  • Now Federation.handle() accepts requests for /.well-known/nodeinfo.
  • Added Federation.setNodeInfoDispatcher() method.
  • Added Context.getNodeInfoUri() method.
  • Added NodeInfo interface.
  • Added Software interface.
  • Added Protocol type.
  • Added Services interface.
  • Added InboundService type.
  • Added OutboundService type.
  • Added Usage interface.
  • Added NodeInfoDispatcher type.
  • Added nodeInfoToJson() function.

• Implemented WebFinger client.

  • Added lookupObject() function.
  • Added lookupWebFinger() function.

• Federation.handle() now responds with Access-Control-Allow-Origin: * header for WebFinger requests.

• fetchDocumentLoader(), the default document loader, now sends Accept: application/activity+json, application/ld+json header (was Accept: application/ld+json only).

Fedify 0.1.0

Initial release. Released on March 8, 2024.