DrFed changelog
Version 0.2.0
To be released.
DrFed
- Activities and objects saved by the common write operations are now served over ActivityPub as they were saved, with their extension properties and without blind recipients, also inside extension values. Published activities of every type appear in the actor's outbox beside existing
Createactivities. Earlier activities keep the versions they embedded after an edit. A deleted object is answered with aTombstone, and itsDeleteis the only activity about it that remains retrievable. A Public activity that embeds content addressed to particular recipients, even inside an extension value, is not served. Existing IRIs do not change. [#153, #177 by ChanHaeng Lee] - Added immutable document histories for local object creation and accepted incoming Create activities. Database upgrades retain existing object and activity documents, including those of deleted objects. Back up and stop DrFed before running
drfed-migrate. [#150, #164 by Hong Minhee] - Changed https://drfed.org/ to serve the DrFed documentation for the highest released version, prereleases included, along with a changelog page. Documentation for the development version is available at https://canary.drfed.org/. [#134, #137 by ChanHaeng Lee]
- Published the official container image
ghcr.io/fedify-dev/drfedforlinux/amd64andlinux/arm64, with all four commands, along with installation guides for Docker, Podman, and other container tools and Compose examples for PGlite and PostgreSQL. Inside the image,drfed-serveranddrfed-weblisten on0.0.0.0by default; any configured listen address still takes precedence. [#135, #167 by ChanHaeng Lee]
GraphQL APIs
- Added
Resource.currentRevision,Resource.revisions, newest first,Resource.revision(sequence:), and theResourceRevisionnode, which return the saved revisions of a resource, including those of resources saved without legacy details. Each revision returns its saved JSON, whiteout deletion details, and what the current validator finds in it. When the validator reads the document,rootdescribes it by meaning, whatever keys spell its properties: the relations and recipients of the root and of every document it embeds, with the resource currently registered under each IRI, and its custom extension properties. Each revision is read by evidence of its own: local revisions by anyone, revisions addressed to the public by anyone, and received revisions by members of the instance that received them.DocumentNode.sourcetells which revision an embedded document came from, whether it keeps that revision's contents or was derived from it, and whether that revision is still current, superseded, or deleted; it is null when the viewer may not read that revision, and the embedded document itself stays readable. Deleting a resource or its author hides none of its revisions by itself. AResourceis returned bynode,Activity.object, and relations and recipients whenever the viewer may read one of its revisions, even after its current state was restricted, whileResource.detailand the typed node stay hidden.Actor.objectstakes afilterwhoseincludeDeletedlists deleted objects too, andObject.deletedtells when one was deleted. [#154] - Fixed
Resource.detailto returnnullwithout a field error when the resource has no corresponding detail record. [#150, #164 by Hong Minhee]
JavaScript/TypeScript APIs
- Added
@drfed/federation/local-write, the common write operations for local resources.previewLocalWrite()shows every value the server adds, including new IRIs, timestamps, and generated activities, and returns a token;commitLocalWrite()saves exactly those values after checking permission again, all or nothing. It saves an object alone, an activity that refers to existing resources or IRIs, or an activity with new nested objects or activities, and commits actual edits and deletions of current objects with a generatedUpdateorDelete. Saving never delivers anything; publishing, editing, and deleting add an activity to the outbox and require a dispatch reservation from the caller. [#152, #173 by Hong Minhee] - Added
createLegacyObject()to@drfed/federation/local-write, the operation behind thecreateObjectmutation, which creates a Note or Article with aCreatein the outbox as before, andisLocalWriteError(), which tells the error it returns from the object it creates. [#152, #173 by Hong Minhee] - Added
describeDocument()to@drfed/models/document, which describes a valid document's embedded documents, the standard properties their keys stand for, and their IRI references with compact IRIs expanded, as the validator reads them. [#152, #173 by Hong Minhee] - Added
writeTypedResourceRevision()to@drfed/models/resource-revisionto edit or delete an object that has a legacy typed row while keeping the row and its history in step. Revision appends and the newstoreAddressingOccurrences()andreplaceAddressing()in@drfed/models/resourcealso accept addressing occurrences with their source positions. [#152, #173 by Hong Minhee] - Added
@drfed/models/resource-revisionto append and read immutable ActivityStreams document histories. An append fails when its expected revision ID is stale, and object histories can end with a whiteout deletion marker. [#150, #164 by Hong Minhee] - Added the
@drfed/federation/documentsubpath. ItsinterpretDocument()returns every vocabulary document of a saved document with its relations, recipients, and custom extension properties, read by meaning as the validator reads them. [#154] - Added
extensionPropertiesto the nodesdescribeDocument()in@drfed/models/documentreturns: the source keys of each document's custom extension properties. [#154] - Added the
@drfed/federation/servingsubpath. It exportspublicDocument(), the serialization federation reads use for saved documents,parseVocab(), which parses such a document into a Fedify vocabulary object, andloadActivitySnapshot(). [#153, #177 by ChanHaeng Lee] - Added
extensionsto the nodesdescribeDocument()in@drfed/models/documentreturns: the JSON-LD node objects in their extension values, with the standard properties their keys stand for, their types and their IRI references. [#153, #177 by ChanHaeng Lee] - Added
validateDocument()in@drfed/models/documentfor parsed ActivityStreams documents. It returns structured errors and compatibility warnings with original nested field and list-entry paths, preserves custom properties as opaque JSON with warnings, and offers inspectable omission previews for empty arrays on supported properties and absent identifiers. [#151, #166 by Jiwon Kwon] - Added
prepareDocument()to compare documents with trusted server-supplied authority outcomes and creation values. It reports denied identities and server-owned-field conflicts and returns explicit generated-field changes with an independent preview. Permission decisions, identity allocation, and persistence remain the caller's responsibility. [#151, #166 by Jiwon Kwon] - Added offline validation coverage for all named activity types and selected Object, actor, collection, and Link types. Validation and preparation preserve input and perform no remote lookups, resource writes, or delivery. Embedded document and extension traversal is limited to 64 path segments; deeper values produce a support error and an incomplete result. Unsupported types, properties, and context forms produce support findings; poll-specific rules remain separate work. The supported properties and representation limits are documented in packages/models/README.md. [#151, #166 by Jiwon Kwon]
appendResourceRevision()andwriteTypedResourceRevision()in@drfed/models/resource-revisionacceptembeddings, which record the revision each embedded document came from and whether it keeps that revision's contents or was derived from it.commitLocalWrite()in@drfed/federation/local-writerecords them for every document it saves, andcreateandeditrequests acceptsourcesto declare the revision an embedded document was loaded from. Declaring sources requires theunreadableRevisionsoption ofpreviewLocalWrite()andcommitLocalWrite(), such asunreadableRevisions()of the new@drfed/graphql/readable; a source that is missing or that the member may not read fails alike withsource_unavailable. [#154]
Version 0.1.0
Released on October 13, 2026. Initial release.