diff --git a/.agents/skills/README.md b/.agents/skills/README.md
index 4a0e9457..f55ac0d9 100644
--- a/.agents/skills/README.md
+++ b/.agents/skills/README.md
@@ -6,12 +6,14 @@ tarball integrity are recorded in *pnpm-lock.yaml*. There are no checked-in
skill copies. *.claude/skills* points to this directory; pnpm also links the
same dependency skills into *.crush/skills/*.
-| Git development dependency | Skills | Source |
-| --------------------------- | ------------------------------------------- | -------------------------- |
-| `@open-circle/agent-skills` | `formisch`, `valibot` | [open-circle/agent-skills] |
-| `@chillicream/agent-skills` | `graphql-schema-design` | [ChilliCream/agent-skills] |
-| `relay-github-root` | `relay-best-practices`, `relay-performance` | [facebook/relay] |
-| `@dahlia/sacho` | `sacho` | [dahlia/sacho] |
+| Git development dependency | Skills | Source |
+| --------------------------- | ------------------------------------------- | ---------------------------------- |
+| `@open-circle/agent-skills` | `formisch`, `valibot` | [open-circle/agent-skills] |
+| `@chillicream/agent-skills` | `graphql-schema-design` | [ChilliCream/agent-skills] |
+| `relay-github-root` | `relay-best-practices`, `relay-performance` | [facebook/relay] |
+| `@dahlia/sacho` | `sacho` | [dahlia/sacho] |
+| `modern-web-guidance` | `modern-web-guidance`, `chrome-extensions` | [GoogleChrome/modern-web-guidance] |
+| `@leonxlnx/taste-skill` | `design-taste-frontend` | [leonxlnx/taste-skill] |
The pinned skill contents match the latest upstream versions checked during
this migration. ChilliCream is pinned to the last change to its GraphQL schema
@@ -38,3 +40,5 @@ updated source approval in *pnpm-workspace.yaml* together.
[ChilliCream/agent-skills]: https://github.com/ChilliCream/agent-skills
[facebook/relay]: https://github.com/facebook/relay
[dahlia/sacho]: https://github.com/dahlia/sacho
+[GoogleChrome/modern-web-guidance]: https://github.com/GoogleChrome/modern-web-guidance
+[leonxlnx/taste-skill]: https://github.com/leonxlnx/taste-skill
diff --git a/CHANGES.md b/CHANGES.md
index 976f408a..d3d26a2b 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -45,10 +45,35 @@ To be released.
### GraphQL APIs
+ - Added `Resource.currentRevision`, `Resource.revisions`, newest first,
+ `Resource.revision(sequence:)`, and the `ResourceRevision` node, 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, `root` describes 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.source` tells 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. A `Resource` is returned by
+ `node`, `Activity.object`, and relations and recipients whenever the
+ viewer may read one of its revisions, even after its current state was
+ restricted, while `Resource.detail` and the typed node stay hidden.
+ `Actor.objects` takes a `filter` whose `includeDeleted` lists deleted
+ objects too, and `Object.deleted` tells when one was deleted. [[#154]]
- Fixed `Resource.detail` to return `null` without a field error when the
resource has no corresponding detail record.
[[#150], [#164] by Hong Minhee\]
+[#154]: https://github.com/fedify-dev/drfed/issues/154
+
### JavaScript/TypeScript APIs
- Added `@drfed/federation/local-write`, the common write operations for
@@ -85,6 +110,13 @@ To be released.
revision ID is stale, and object histories can end with a whiteout deletion
marker.
[[#150], [#164] by Hong Minhee\]
+ - Added the `@drfed/federation/document` subpath. Its
+ `interpretDocument()` 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 `extensionProperties` to the nodes `describeDocument()` in
+ `@drfed/models/document` returns: the source keys of each document's
+ custom extension properties. [[#154]]
- Added the `@drfed/federation/serving` subpath. It exports
`publicDocument()`, the serialization federation reads use for saved
documents, `parseVocab()`, which parses such a document into a Fedify
@@ -116,6 +148,17 @@ To be released.
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()` and `writeTypedResourceRevision()` in
+ `@drfed/models/resource-revision` accept `embeddings`, 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-write` records them for every document it saves,
+ and `create` and `edit` requests accept `sources` to declare the revision
+ an embedded document was loaded from. Declaring sources requires the
+ `unreadableRevisions` option of `previewLocalWrite()` and
+ `commitLocalWrite()`, such as `unreadableRevisions()` of the new
+ `@drfed/graphql/readable`; a source that is missing or that the member
+ may not read fails alike with `source_unavailable`. [[#154]]
[#151]: https://github.com/fedify-dev/drfed/issues/151
[#152]: https://github.com/fedify-dev/drfed/issues/152
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3e0592ae..69fb5783 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -715,6 +715,14 @@ The GraphQL types for activity deliveries live in
*src/activity-delivery/entry.ts*. Delivery contents are private to local
instance members and administrators, including Relay node lookups.
+The GraphQL types for resource revisions live in *src/revision.ts*. Each
+revision is read by evidence of its own, through `readableRevision()` in
+*src/readable.ts*, never by the current state of its resource nor by where
+its embedded documents came from; only `DocumentNode.source` checks a source
+revision. Filter revisions by it before paging, and use
+`unreadableRevisions()` wherever another layer, such as a local write's
+`sources`, must apply the same rule.
+
CLI and server changes
----------------------
diff --git a/changes.d/graphql/resource-revisions.md b/changes.d/graphql/resource-revisions.md
new file mode 100644
index 00000000..aad16514
--- /dev/null
+++ b/changes.d/graphql/resource-revisions.md
@@ -0,0 +1,27 @@
+---
+links:
+ '#154': https://github.com/fedify-dev/drfed/issues/154
+---
+ - Added `Resource.currentRevision`, `Resource.revisions`, newest first,
+ `Resource.revision(sequence:)`, and the `ResourceRevision` node, 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, `root` describes 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.source` tells 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. A `Resource` is returned by
+ `node`, `Activity.object`, and relations and recipients whenever the
+ viewer may read one of its revisions, even after its current state was
+ restricted, while `Resource.detail` and the typed node stay hidden.
+ `Actor.objects` takes a `filter` whose `includeDeleted` lists deleted
+ objects too, and `Object.deleted` tells when one was deleted. [[#154]]
diff --git a/changes.d/javascript/document-interpretation.md b/changes.d/javascript/document-interpretation.md
new file mode 100644
index 00000000..e1a07702
--- /dev/null
+++ b/changes.d/javascript/document-interpretation.md
@@ -0,0 +1,12 @@
+---
+links:
+ '#154': https://github.com/fedify-dev/drfed/issues/154
+---
+ - Added the `@drfed/federation/document` subpath. Its
+ `interpretDocument()` 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 `extensionProperties` to the nodes `describeDocument()` in
+ `@drfed/models/document` returns: the source keys of each document's
+ custom extension properties. [[#154]]
diff --git a/changes.d/javascript/embedded-sources.md b/changes.d/javascript/embedded-sources.md
new file mode 100644
index 00000000..8bf22567
--- /dev/null
+++ b/changes.d/javascript/embedded-sources.md
@@ -0,0 +1,15 @@
+---
+links:
+ '#154': https://github.com/fedify-dev/drfed/issues/154
+---
+ - `appendResourceRevision()` and `writeTypedResourceRevision()` in
+ `@drfed/models/resource-revision` accept `embeddings`, 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-write` records them for every document it saves,
+ and `create` and `edit` requests accept `sources` to declare the revision
+ an embedded document was loaded from. Declaring sources requires the
+ `unreadableRevisions` option of `previewLocalWrite()` and
+ `commitLocalWrite()`, such as `unreadableRevisions()` of the new
+ `@drfed/graphql/readable`; a source that is missing or that the member
+ may not read fails alike with `source_unavailable`. [[#154]]
diff --git a/docs/internals/local-writes.md b/docs/internals/local-writes.md
index 476905e8..ecba5eed 100644
--- a/docs/internals/local-writes.md
+++ b/docs/internals/local-writes.md
@@ -82,16 +82,17 @@ after the first write throw out of the transaction; nothing partial is left. A
replayed token finds its resources already saved (`resource_conflict`) or the
object already changed (`revision_conflict`).
-| Error | Meaning |
-| ----------------------- | -------------------------------------------------------------------------------------------- |
-| `invalid_request` | Malformed request or resource descriptors, or a missing token or reservation. |
-| `invalid_document` | Validator, authority or server-owned-field diagnostics at submitted paths. |
-| `actor_not_found` | The actor is missing, deleted, not local, on an expired instance, or not the member's. |
-| `invalid_instance_host` | The stored instance host cannot be parsed by this server. |
-| `stale_preview` | The token is invalid, expired, or for another account or request. |
-| `revision_conflict` | The object's current revision is not the expected one. |
-| `resource_conflict` | The resources were already saved, or an IRI is another kind of resource. |
-| `unsupported_edit` | The object is deleted, not the actor's, changes type, or cannot be kept in step (see below). |
+| Error | Meaning |
+| ----------------------- | --------------------------------------------------------------------------------------------- |
+| `invalid_request` | Malformed request or resource descriptors, or a missing token or reservation. |
+| `invalid_document` | Validator, authority or server-owned-field diagnostics at submitted paths. |
+| `actor_not_found` | The actor is missing, deleted, not local, on an expired instance, or not the member's. |
+| `invalid_instance_host` | The stored instance host cannot be parsed by this server. |
+| `stale_preview` | The token is invalid, expired, or for another account or request. |
+| `revision_conflict` | The object's current revision is not the expected one. |
+| `resource_conflict` | The resources were already saved, or an IRI is another kind of resource. |
+| `unsupported_edit` | The object is deleted, not the actor's, changes type, or cannot be kept in step (see below). |
+| `source_unavailable` | A declared source is missing, not a snapshot of its document, or one the member may not read. |
Identity and documents
@@ -136,9 +137,80 @@ from its semantic `to`, `cc`, `bto`, `bcc` and `audience`, each value at its
source position: IRIs as resolved, embedded documents by `id`, `Link` values by
`href`, also written as a list of one value, and anonymous values without a row.
Relations index `actor`, `object`, `target`, `origin`, `result`, `instrument`
-and `attributedTo`. A document that spells one of these properties in several
-ways is refused, since its index would otherwise leave occurrences out. Indexes
-stay `partial`; the documents remain authoritative.
+and `attributedTo`. Both indexes come from `interpretDocument()` in
+`@drfed/federation/document`, which GraphQL reads use too. A document that
+spells one of these properties in several ways is refused, since its index
+would otherwise leave occurrences out. Indexes stay `partial`; the documents
+remain authoritative.
+
+
+Embedded document sources
+-------------------------
+
+Every saved document records, for each embedded document with an `id`, the
+revision it came from when the server knows it, as
+[resource revisions](resource-revisions.md#embedded-document-sources)
+describe. `Link` values and anonymous documents get no source. The source is
+found in this order:
+
+1. A resource saved earlier in the same write, such as a nested new resource
+ kept embedded or the version an edit's `Update` embeds. When the
+ embedded document keeps that resource's new revision, the documents it
+ embeds take the sources recorded for that revision at their own paths,
+ so an `Update` records the sources of the version it carries.
+
+2. A source the request declares for the embedded document's submitted path:
+
+ ~~~~ ts
+ const request = {
+ operation: "create",
+ actorId,
+ document: { type: "Like", object: changedNote },
+ resources: [{ path: [], kind: "activity" }],
+ sources: [{ path: ["object"], revisionId: loadedRevisionId }],
+ } as const;
+ ~~~~
+
+ An editor declares the revision it loaded a document from, so that a
+ changed copy keeps its source. Both `create` and `edit` accept `sources`,
+ and the preview token binds them. Each path must name an embedded document
+ with an `id` that is not a new resource of the write; otherwise the
+ request is `invalid_request`. Its revision must be a snapshot of the
+ resource registered under that `id` that the member may read; otherwise
+ the write fails with `source_unavailable`, with a diagnostic at the
+ declared path. A missing revision and one the member may not read fail
+ alike, so the error tells nothing of revisions the member may not read.
+
+ The local write operations do not decide who may read a revision. The
+ caller passes `unreadableRevisions(ids)` in the options of both
+ `previewLocalWrite()` and `commitLocalWrite()`, which check the declared
+ revisions again, since the member's access may change after the
+ preview. GraphQL's rule is `unreadableRevisions(viewer, ids)` in
+ `@drfed/graphql/readable`:
+
+ ~~~~ ts
+ const access = {
+ unreadableRevisions: (ids: readonly Uuid[]) =>
+ unreadableRevisions({ db, account }, ids),
+ };
+ await previewLocalWrite(env, principal, request, access);
+ ~~~~
+
+ A request that declares sources without the check is `invalid_request`.
+
+Any other embedded document has an unknown source, even when it equals a
+stored revision of the resource under its `id`: the server never guesses a
+source from an IRI. A pasted document and a loaded one declared as its
+source therefore differ only in `DocumentNode.source`.
+
+An embedded document is a `snapshot` of its source when its effective context
+equals the source document's and its JSON, apart from the `@context` key,
+equals the source document's, whatever the order of object keys. Otherwise it
+is `derived`. The comparison is strict, so a document only re-serialized
+differently reads as derived, never the reverse. Previews and commit results
+do not report sources: a writer could otherwise learn whether a guessed
+document equals a revision they may not read. Writes through
+`createLegacyObject()` record no sources.
Edits and deletions
@@ -156,8 +228,11 @@ A deletion appends a whiteout and keeps the object's current addressing, which
describes the last content. The generated `Delete` refers to the object by IRI
and copies the last version's addressing under its context.
-Resources created by the common write have revisions only, so GraphQL details
-ignore them until #154; federation reads serve their documents. Objects created
+Resources created by the common write have revisions only, so GraphQL
+`Resource.detail` ignores them; `Resource.currentRevision` and
+`Resource.revisions` read them, as [resource
+revisions](resource-revisions.md#graphql-reads) describe, and federation reads
+serve their documents. Objects created
by the `createObject` mutation also have legacy typed rows that serving reads;
`writeTypedResourceRevision()` keeps those rows in step. Before writing, the
served columns must agree with the current revision, or the object is refused
diff --git a/docs/internals/resource-revisions.md b/docs/internals/resource-revisions.md
index 5a72060e..e7011663 100644
--- a/docs/internals/resource-revisions.md
+++ b/docs/internals/resource-revisions.md
@@ -169,6 +169,35 @@ ownership or grants access. For legacy data, `fetched` inherits the old
conservative flag and is not proof that an HTTP fetch occurred.
+Embedded document sources
+-------------------------
+
+`revision_embeddings` records where an embedded document of a revision came
+from: its source path, the `source_revision_id` of a snapshot of another
+resource, and its `relation`. A `snapshot` keeps the source revision's
+contents, apart from the context it inherits; a `derived` document started
+from that revision and was changed, for example to test how a peer handles
+other addressing. An embedded document without a row has an unknown source,
+which proves neither that it was nor that it was never saved as a revision:
+older data and pasted documents lack the record. An IRI reference is a
+separate choice, recorded as the `reference` representation of a relation,
+and has no source. A source is no condition on reading the revision that
+records it: who may read an embedded document is decided by the revision
+embedding it alone.
+
+Rows are written with the revision through the `embeddings` input of
+`appendResourceRevision()` and `writeTypedResourceRevision()`, and like other
+projections they cannot be added after the revision is published, changed or
+removed. The database also refuses a source that is not a snapshot or that
+belongs to the same resource. The
+[local writes](local-writes.md#embedded-document-sources) decide the rows;
+legacy capture and received documents record none.
+
+Comparing an embedded document with the current state therefore compares
+revisions of one resource by `sequence`, not timestamps of different
+transactions, which do not follow commit order.
+
+
Legacy capture and upgrades
---------------------------
@@ -202,8 +231,8 @@ Fetched evidence is recomputed when `recordFetchedObject` changes. Deleting a
typed object row removes its object receipts; deleting an activity or removing
a delivery linkage removes that delivery's receipts; deleting a delivery
cascades them. Unavailable and whiteout revisions receive no legacy receipt.
-Existing GraphQL permission checks still use their current evidence rules; the
-new index does not expose historical content.
+GraphQL reads each revision by this evidence, as
+[GraphQL reads](#graphql-reads) describe.
Application boundaries
@@ -215,8 +244,9 @@ generic canonical resource can have no typed detail; its GraphQL
such a resource from its current revision. The common write
operations described in [local writes](local-writes.md) save new resources as
revisions only and keep legacy typed objects in step when editing or deleting
-them. Historical authorization and the other federation surfaces are separate
-work.
+them. GraphQL reads every revision by its own evidence, as
+[GraphQL reads](#graphql-reads) describe. The other federation surfaces are
+separate work.
Appending a whiteout does not create or send a `Delete` activity. The common
delete operation appends it together with the `Delete`, outbox entry and the
@@ -233,3 +263,83 @@ round-trip fixtures, not claims of semantic validation or peer
interoperability. Run `mise run test` for PGlite coverage and
`mise run test:postgres` with an isolated `DRFED_TEST_POSTGRES_URL` for
PostgreSQL migration and concurrency checks.
+
+
+GraphQL reads
+-------------
+
+`Resource.currentRevision`, `Resource.revisions` (newest first by sequence)
+and `ResourceRevision` nodes read histories, generic resources included. A
+revision returns its saved `document` as is, with blind recipients. Its
+`root` and everything below it come from `interpretDocument()` in
+`@drfed/federation/document`, which reads every vocabulary document by
+meaning through `describeDocument()`; local writes build their revision
+indexes with the same function. Relations are read from the document for
+every embedded document, not from `revision_relations`, which hold the root's
+only. When the validator cannot read the document, such as one whose context is
+outside the offline allowlist or one with an unsupported property,
+`interpreted` is false, `root` is null and `diagnostics` tell why; nothing
+falls back to typed rows.
+
+Each revision is read by evidence of its own, in `readableRevision()` in
+*packages/graphql/src/readable.ts*, not by the rule of its resource. An
+administrator reads every revision. Anyone else reads one that was captured
+`local`, whose own revision addressing names the public, or that a receipt
+links to an inbound delivery to a local instance the viewer is an accepted
+member of. A revision without such evidence is readable only while it is the
+current revision of a resource with a legacy typed row that the viewer may
+read, as `Resource.detail` decides. Local histories are therefore open to
+anyone, blind recipients and unpublished activities included. Evidence for
+one revision opens no other: a later delivery naming the same IRI does not
+open an earlier private revision, and a later restriction of the current
+resource does not hide an earlier public one. A Relay node lookup of a
+revision checks the revision itself, and `Resource.revisions` leaves out the
+ones the viewer may not read, so their sequences can skip.
+
+The `Resource` a history is read through follows the same evidence, in
+`readableResourceNode()`: a `node` lookup of a `Resource`, a relation's or
+recipient's `resource`, and `Activity.object` return it when the viewer may
+read it as `Resource.detail` decides or may read any of its revisions. A
+`Resource` node shares its ID with the typed `Object` or `Activity` of the
+same resource, so the lookup tells them apart by the typename of the global
+ID; the typed node and `Resource.detail` keep following the current state.
+
+What a revision embeds never decides whether it is readable. A local
+`Announce` that embeds a `Note` only one instance received is readable by
+anyone, as every local revision is, whether it records that `Note`'s revision
+as its source or was pasted without one: recording a source never makes a
+document harder to read. Only following the source checks the source
+revision, as `DocumentNode.source` does below. Received content stays
+protected where it is read or imported: the received revision itself is
+readable only by the evidence above, and a local write may declare as a
+source only a revision its member may read, as
+[local writes](local-writes.md#embedded-document-sources) describe.
+`unreadableRevisions(viewer, ids)` in `@drfed/graphql/readable` applies the
+same rule to a set of revisions for that check.
+
+Deletion hides no revision by itself: deleting a resource appends a whiteout,
+and its earlier revisions, like those of a resource whose author is deleted,
+stay readable by their own evidence. Only the existing fields, such as
+`Resource.detail`, keep hiding deleted typed rows. `Actor.objects` leaves
+deleted objects out unless its `filter` sets `includeDeleted`, which lists
+them with `Object.deleted` so that their histories can be reached. A
+relation's or recipient's `resource` is opened as `Activity.object` is, deleted
+or not.
+
+`DocumentNode.source` tells where an embedded document came from: its
+`relation`, `snapshot` or `derived`, the source `revision`, and `status`,
+which compares that revision with the current revision of its resource:
+`current` when it is the current one, `deleted` when the current revision is
+a whiteout, and `superseded` otherwise. The status compares revisions only,
+not contents. It is null when the viewer may not read the current revision,
+which would otherwise tell of a revision they may not read. `source` is null
+for the root, for an embedded document whose source is unknown, and when the
+viewer may not read the source revision; these are not told apart, and
+`relation` is not kept alone either, since `snapshot` next to the embedded
+contents would tell those of a revision the viewer may not read. Whatever
+`source` is, the embedded `node`, the `root` and the raw `document` read as
+the revision embedding them does.
+
+`Resource.revision(sequence:)` returns one revision by its sequence, and null
+both for a sequence with no revision and for a revision the viewer may not
+read.
diff --git a/mise.toml b/mise.toml
index 6f804a46..7e9c98ab 100644
--- a/mise.toml
+++ b/mise.toml
@@ -394,6 +394,14 @@ $env.name = $env.usage_name
node scripts/create-account.mts
'''
+[tasks."seed:revisions"]
+description = "Seed resource revisions for UI work into a development PGlite database"
+depends = ["build:backend"]
+usage = '''
+flag "-d --data-path " default=".pgdata" help="PGlite data directory; it must not be seeded yet"
+'''
+run = "node scripts/seed-revisions/main.mts"
+
[tasks."generate:migrate"]
description = "Generate database migration files"
usage = """
diff --git a/package.json b/package.json
index 4ef86fa5..98456aff 100644
--- a/package.json
+++ b/package.json
@@ -3,15 +3,19 @@
"devDependencies": {
"@chillicream/agent-skills": "github:ChilliCream/agent-skills#23b4e12f696885fb5a71dacddddec69124207f94",
"@dahlia/sacho": "github:dahlia/sacho#0.3.2",
+ "@drfed/federation": "workspace:*",
"@drfed/graphql": "workspace:*",
"@drfed/models": "workspace:*",
"@electric-sql/pglite": "catalog:",
+ "@fedify/fedify": "catalog:",
+ "@leonxlnx/taste-skill": "github:leonxlnx/taste-skill#f6b76575f949707b4e3c37cd86cb44b0b98643e8",
"@logtape/logtape": "catalog:",
"@open-circle/agent-skills": "github:open-circle/agent-skills#21d123742218d3cd748056fad78aa88d7da3dc96",
"@sigstore/oci": "0.7.2",
"@types/node": "catalog:",
"drizzle-orm": "catalog:",
"graphql": "catalog:",
+ "modern-web-guidance": "github:GoogleChrome/modern-web-guidance#64a6d708f5a43f2cd3fde5d4d7db3905ba1bdf65",
"relay-github-root": "github:facebook/relay#52c2e68711a698a9708997b9bdf7532c4d7ecdd6",
"vitepress": "^1.6.4"
}
diff --git a/packages/federation/README.md b/packages/federation/README.md
index 8edc3e11..56bfaee3 100644
--- a/packages/federation/README.md
+++ b/packages/federation/README.md
@@ -42,6 +42,7 @@ Exports
| ------------------------------------- | ------------------------------------------------------------- |
| `@drfed/federation` | `createFederation()` (default), `buildFederation()` |
| `@drfed/federation/activity-delivery` | Inbound recording, outbound delivery, and their observations |
+| `@drfed/federation/document` | `interpretDocument()`, which reads saved documents by meaning |
| `@drfed/federation/actor-key` | `ensureActorKeyPairs()` for persisted actor signing keys |
| `@drfed/federation/task-queue` | `KeyGenerationQueue` for background actor key generation |
| `@drfed/federation/local-write` | Common write operations that save, edit, and delete resources |
@@ -64,8 +65,11 @@ alone, an activity referring to existing resources, or an activity with new
nested resources, atomically, and actual edits or deletions of a current
object with a generated `Update` or `Delete`. A preview shows every value the
server adds and returns a token; the commit saves exactly those values after
-checking permission again. Saving never delivers anything. See the
-[local write internals] for the contract.
+checking permission again. Saving never delivers anything. A request may
+declare the revisions its embedded documents came from in `sources`; the
+caller then passes `unreadableRevisions()`, such as the one of
+`@drfed/graphql/readable`, so that only revisions the member may read are
+accepted. See the [local write internals] for the contract.
[local write internals]: https://drfed.org/internals/local-writes
diff --git a/packages/federation/package.json b/packages/federation/package.json
index 22fb75ac..e3215492 100644
--- a/packages/federation/package.json
+++ b/packages/federation/package.json
@@ -54,6 +54,10 @@
"types": "./dist/object.d.mts",
"default": "./dist/object.mjs"
},
+ "./document": {
+ "types": "./dist/document.d.mts",
+ "default": "./dist/document.mjs"
+ },
"./local-write": {
"types": "./dist/local-write.d.mts",
"default": "./dist/local-write.mjs"
@@ -84,6 +88,7 @@
"src/index.ts",
"src/activity-delivery.ts",
"src/object.ts",
+ "src/document.ts",
"src/local-write.ts",
"src/origin.ts",
"src/actor-key.ts",
diff --git a/packages/federation/src/document.test.ts b/packages/federation/src/document.test.ts
new file mode 100644
index 00000000..0567c061
--- /dev/null
+++ b/packages/federation/src/document.test.ts
@@ -0,0 +1,111 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import assert from "node:assert/strict";
+
+import { interpretDocument } from "@drfed/federation/document";
+import { describe, it } from "@logtape/testing-node/autoload";
+
+const AS = "https://www.w3.org/ns/activitystreams";
+
+describe("interpretDocument()", () => {
+ it("reads relations and recipients of every document by meaning", () => {
+ const document = {
+ "@context": [
+ AS,
+ {
+ about: { "@id": "as:object", "@type": "@id" },
+ ex: "https://ext.example/ns#",
+ },
+ ],
+ type: "Undo",
+ id: "https://example.com/undo",
+ actor: "https://example.com/alice",
+ to: [null, "as:Public", { type: "Person" }],
+ about: [
+ {
+ type: "Like",
+ actor: "https://example.com/alice",
+ object: { type: "Link", href: "https://example.com/note" },
+ "ex:note": "kept",
+ },
+ "https://example.com/likes/2",
+ ],
+ };
+ const nodes = interpretDocument(document);
+ assert.ok(nodes != null);
+ const [root, like, link] = nodes;
+ assert.ok(root != null && like != null && link != null);
+ assert.equal(root.iri, "https://example.com/undo");
+ assert.equal(root.value, document);
+ assert.deepEqual(
+ root.relations.map(({ property, path, representation, iri, node }) => [
+ property,
+ path,
+ representation,
+ iri,
+ node?.type ?? null,
+ ]),
+ [
+ ["actor", ["actor"], "reference", "https://example.com/alice", null],
+ ["object", ["about", 0], "embedded", null, `${AS}#Like`],
+ [
+ "object",
+ ["about", 1],
+ "reference",
+ "https://example.com/likes/2",
+ null,
+ ],
+ ],
+ );
+ // A null names nothing; an anonymous recipient keeps its position.
+ assert.deepEqual(
+ root.addressing.map(({ property, position, representation, iri }) => [
+ property,
+ position,
+ representation,
+ iri,
+ ]),
+ [
+ ["to", 1, "reference", `${AS}#Public`],
+ ["to", 2, "embedded", null],
+ ],
+ );
+ assert.equal(like.property, "object");
+ assert.deepEqual(like.extensions, [{ key: "ex:note", value: "kept" }]);
+ assert.deepEqual(
+ like.relations.map(({ property, representation, iri }) => [
+ property,
+ representation,
+ iri,
+ ]),
+ [
+ ["actor", "reference", "https://example.com/alice"],
+ ["object", "link", "https://example.com/note"],
+ ],
+ );
+ assert.equal(like.relations[1]?.node, link);
+ assert.equal(link.iri, "https://example.com/note");
+ });
+
+ it("returns null for a document the validator does not read", () => {
+ assert.equal(
+ interpretDocument({ "@context": AS, type: "Note", tag: [] }),
+ null,
+ );
+ assert.equal(interpretDocument(null), null);
+ });
+});
diff --git a/packages/federation/src/document.ts b/packages/federation/src/document.ts
new file mode 100644
index 00000000..5aa094ee
--- /dev/null
+++ b/packages/federation/src/document.ts
@@ -0,0 +1,35 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+/**
+ * The interpretation of saved documents by meaning: the relations,
+ * recipients and extension properties of the root and of every document it
+ * embeds, as the validator reads them. The indexes local writes save and the
+ * GraphQL read surface share it, so that they cannot disagree. Nothing here
+ * dereferences anything.
+ * @module
+ */
+
+export {
+ type InterpretedNode,
+ RELATION_PROPERTIES,
+ type RecipientOccurrence,
+ type RecipientProperty,
+ type RelationOccurrence,
+ type RelationProperty,
+ type Representation,
+ interpretDocument,
+} from "./document/interpret.ts";
diff --git a/packages/federation/src/document/interpret.ts b/packages/federation/src/document/interpret.ts
new file mode 100644
index 00000000..2fbed966
--- /dev/null
+++ b/packages/federation/src/document/interpret.ts
@@ -0,0 +1,264 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import {
+ ADDRESSING_PROPERTIES,
+ type DocumentNode,
+ type DocumentNodeKind,
+ type FieldPath,
+ type JsonValue,
+ describeDocument,
+} from "@drfed/models/document";
+
+/**
+ * The relations a document's own properties hold, which saved revisions
+ * index at their root: who acts, what it acts on, and who it is attributed
+ * to.
+ */
+export const RELATION_PROPERTIES = [
+ "actor",
+ "object",
+ "target",
+ "origin",
+ "result",
+ "instrument",
+ "attributedTo",
+] as const;
+
+/** The standard name of a relation property. */
+export type RelationProperty = (typeof RELATION_PROPERTIES)[number];
+
+/** The standard name of an addressing property. */
+export type RecipientProperty = (typeof ADDRESSING_PROPERTIES)[number];
+
+/**
+ * How a value names what it stands for: an IRI reference, an embedded
+ * document, or an embedded `Link`.
+ */
+export type Representation = "reference" | "embedded" | "link";
+
+/**
+ * One vocabulary document of a saved document, the root or one embedded at
+ * any depth, as {@link interpretDocument} reads it by meaning.
+ */
+export interface InterpretedNode {
+ /** The source path of the document; `[]` is the root. */
+ readonly path: FieldPath;
+ /**
+ * The standard name of the property that embeds the document, whatever
+ * its source spelling; `null` for the root.
+ */
+ readonly property: string | null;
+ /** The type IRI, such as `…/activitystreams#Note`. */
+ readonly type: string;
+ readonly kind: DocumentNodeKind;
+ /**
+ * The document's own `id`, or the `href` of a `Link`, with a compact IRI
+ * expanded; `null` when it has none.
+ */
+ readonly iri: string | null;
+ /** The document's JSON as saved, with everything it embeds. */
+ readonly value: JsonValue;
+ /**
+ * The occurrences of its own relation properties, in the order of
+ * {@link RELATION_PROPERTIES}, then of their source keys and values,
+ * including duplicates.
+ */
+ readonly relations: readonly RelationOccurrence[];
+ /**
+ * The occurrences of its own addressing properties, in the order of
+ * `ADDRESSING_PROPERTIES`, then of their source keys and values,
+ * including duplicates and anonymous embedded recipients.
+ */
+ readonly addressing: readonly RecipientOccurrence[];
+ /**
+ * Its own custom extension properties, by their source keys, sorted, with
+ * their values as saved.
+ */
+ readonly extensions: readonly {
+ readonly key: string;
+ readonly value: JsonValue;
+ }[];
+}
+
+/** One value of a relation or addressing property. */
+interface Occurrence {
+ /** The source path of the value, including its list index if any. */
+ readonly path: FieldPath;
+ readonly representation: Representation;
+ /**
+ * A reference as resolved, an embedded document's `id`, or a `Link`'s
+ * `href`; `null` for an anonymous embedded value.
+ */
+ readonly iri: string | null;
+ /** The embedded document or `Link`; `null` for a reference. */
+ readonly node: InterpretedNode | null;
+}
+
+/** One value of a relation property. */
+export interface RelationOccurrence extends Occurrence {
+ readonly property: RelationProperty;
+}
+
+/** One value of an addressing property. */
+export interface RecipientOccurrence extends Occurrence {
+ readonly property: RecipientProperty;
+ /**
+ * The index of the value in its source key's list, or 0 for a value
+ * written alone.
+ */
+ readonly position: number;
+}
+
+const pathKey = (path: FieldPath): string => JSON.stringify(path);
+
+/**
+ * Reads the value at a source path. Paths come from documents whose keys
+ * may be spelled `__proto__`, so only own properties are read.
+ * @returns The value, or `undefined` when nothing is there.
+ */
+export function valueAt(
+ document: JsonValue,
+ path: FieldPath,
+): JsonValue | undefined {
+ let value: JsonValue | undefined = document;
+ for (const segment of path) {
+ if (
+ value === null ||
+ typeof value !== "object" ||
+ !Object.hasOwn(value, segment)
+ ) {
+ return undefined;
+ }
+ value = (value as Record)[segment];
+ }
+ return value;
+}
+
+// A document names itself by its id; a Link by its href. A node's
+// identifiers are its own values only.
+const ownIri = (node: DocumentNode): string | null =>
+ node.identifiers.find(
+ ({ property }) => property === (node.kind === "link" ? "href" : "id"),
+ )?.iri ?? null;
+
+interface MutableNode extends InterpretedNode {
+ relations: RelationOccurrence[];
+ addressing: RecipientOccurrence[];
+}
+
+/**
+ * Interprets a saved document by meaning, through `describeDocument()`, so
+ * that aliases, full-IRI keys and compact IRIs read as the validator reads
+ * them, never by key spelling. The relations and recipients of every
+ * vocabulary document are read, not only of the root: the `object` of a
+ * `Like` embedded in an `Undo`, for one. Saved indexes and read surfaces
+ * share it, so that they cannot disagree about what a document says.
+ *
+ * A value of a relation or addressing property is a reference when it is an
+ * IRI, or an embedded document or `Link`. A `null` in a list, which names
+ * nothing, is no occurrence, and positions in a list are kept as written.
+ * @param document A saved document.
+ * @returns The root and every embedded document in traversal order, or
+ * `null` when `describeDocument()` cannot read the document, that
+ * is, unless it validates without errors.
+ */
+export function interpretDocument(
+ document: unknown,
+): readonly InterpretedNode[] | null {
+ const described = describeDocument(document);
+ if (described == null || described.length === 0) return null;
+ // Validation has accepted it as JSON.
+ const json = document as JsonValue;
+ const nodes = new Map(
+ described.map((node) => [
+ pathKey(node.path),
+ {
+ path: node.path,
+ property: node.property ?? null,
+ type: node.type,
+ kind: node.kind,
+ iri: ownIri(node),
+ value: valueAt(json, node.path) ?? null,
+ relations: [],
+ addressing: [],
+ extensions: node.extensionProperties.map((key) => ({
+ key,
+ value: valueAt(json, [...node.path, key]) ?? null,
+ })),
+ },
+ ]),
+ );
+ for (const node of described) {
+ const interpreted = nodes.get(pathKey(node.path))!;
+ const references = new Map(
+ node.identifiers.map(({ path, iri }) => [pathKey(path), iri]),
+ );
+ const occurrences = (
+ property: string,
+ ): (Occurrence & { readonly position: number })[] =>
+ (node.properties.get(property) ?? []).flatMap((source) => {
+ const path = [...node.path, source];
+ const value = valueAt(json, path);
+ const entries: [FieldPath, number][] = Array.isArray(value)
+ ? value.map((_, position) => [[...path, position], position])
+ : value == null
+ ? []
+ : [[path, 0]];
+ return entries.flatMap(
+ ([entryPath, position]): (Occurrence & {
+ readonly position: number;
+ })[] => {
+ const child = nodes.get(pathKey(entryPath));
+ if (child != null) {
+ return [
+ {
+ path: entryPath,
+ position,
+ representation: child.kind === "link" ? "link" : "embedded",
+ iri: child.iri,
+ node: child,
+ },
+ ];
+ }
+ const iri = references.get(pathKey(entryPath));
+ return iri == null
+ ? []
+ : [
+ {
+ path: entryPath,
+ position,
+ representation: "reference",
+ iri,
+ node: null,
+ },
+ ];
+ },
+ );
+ });
+ for (const property of RELATION_PROPERTIES) {
+ for (const { position: _, ...occurrence } of occurrences(property)) {
+ interpreted.relations.push({ property, ...occurrence });
+ }
+ }
+ for (const property of ADDRESSING_PROPERTIES) {
+ for (const occurrence of occurrences(property)) {
+ interpreted.addressing.push({ property, ...occurrence });
+ }
+ }
+ }
+ return [...nodes.values()];
+}
diff --git a/packages/federation/src/local-write-embedding.test.ts b/packages/federation/src/local-write-embedding.test.ts
new file mode 100644
index 00000000..cdd62617
--- /dev/null
+++ b/packages/federation/src/local-write-embedding.test.ts
@@ -0,0 +1,682 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// Writes in one test depend on the state the previous ones left.
+// oxlint-disable no-await-in-loop
+
+import assert from "node:assert/strict";
+
+import {
+ type CommitOptions,
+ type CreateRequest,
+ type EmbeddedSource,
+ type JsonObject,
+ type LocalWriteEnvironment,
+ type LocalWriteRequest,
+ type PreviewOptions,
+ commitLocalWrite,
+ previewLocalWrite,
+} from "@drfed/federation/local-write";
+import { type Database, schema } from "@drfed/models";
+import { PUBLIC_IRI } from "@drfed/models/resource";
+import { loadCurrentResourceRevision } from "@drfed/models/resource-revision";
+import type { Uuid } from "@drfed/models/uuid";
+import { describe, it } from "@logtape/testing-node/autoload";
+import { eq } from "drizzle-orm";
+
+import { withFederation } from "./harness.test.ts";
+import {
+ created,
+ localActorId,
+ localInstanceId,
+ seedLocalActor,
+} from "./seed.test.ts";
+
+const AS = "https://www.w3.org/ns/activitystreams";
+const ROOT_ORIGIN = new URL("https://drfed.org");
+const ACCOUNT_ID = "00000000-0000-4000-8000-000000000301" as Uuid;
+const PRINCIPAL = { accountId: ACCOUNT_ID };
+const MISSING_REVISION_ID = "00000000-0000-4000-8000-000000000999" as Uuid;
+const NOTE = {
+ "@context": AS,
+ type: "Note",
+ content: "Hello
",
+ to: [PUBLIC_IRI],
+};
+
+async function seedMember(db: Database) {
+ await seedLocalActor(db, { keys: false });
+ await db.insert(schema.accounts).values({
+ id: ACCOUNT_ID,
+ email: "member@example.com",
+ name: "Member",
+ created,
+ });
+ await db.insert(schema.instanceMembers).values({
+ accountId: ACCOUNT_ID,
+ instanceId: localInstanceId,
+ accepted: created,
+ created,
+ });
+}
+
+async function environment(
+ harness: Parameters[0]>[0],
+): Promise {
+ return {
+ db: harness.db,
+ federation: harness.federation,
+ rootOrigin: ROOT_ORIGIN,
+ previewKey: await crypto.subtle.generateKey(
+ { name: "HMAC", hash: "SHA-256" },
+ false,
+ ["sign", "verify"],
+ ),
+ };
+}
+
+function create(
+ document: JsonObject,
+ resources: CreateRequest["resources"] = [{ path: [], kind: "object" }],
+ sources?: readonly EmbeddedSource[],
+): CreateRequest {
+ return {
+ operation: "create",
+ actorId: localActorId,
+ document,
+ resources,
+ ...(sources == null ? {} : { sources }),
+ };
+}
+
+const activity = (
+ document: JsonObject,
+ sources?: readonly EmbeddedSource[],
+): CreateRequest => create(document, [{ path: [], kind: "activity" }], sources);
+
+const reserve: NonNullable = () =>
+ Promise.resolve();
+
+/** Lets the principal read every revision. */
+const READ_ALL: PreviewOptions = {
+ unreadableRevisions: () => Promise.resolve(new Set()),
+};
+
+/**
+ * Lets the principal read every revision but the given ones.
+ * @returns The options that check declared sources so.
+ */
+const readAllBut = (...hidden: Uuid[]): PreviewOptions => ({
+ unreadableRevisions: (ids) =>
+ Promise.resolve(new Set(ids.filter((id) => hidden.includes(id)))),
+});
+
+async function write(env: LocalWriteEnvironment, request: LocalWriteRequest) {
+ const preview = await previewLocalWrite(env, PRINCIPAL, request, READ_ALL);
+ assert.ok(preview.ok, JSON.stringify(!preview.ok && preview.error));
+ const outcome = await commitLocalWrite(env, PRINCIPAL, request, {
+ ...READ_ALL,
+ previewToken: preview.preview.token,
+ ...(request.operation === "create" && request.publish !== true
+ ? {}
+ : { reserveDispatch: reserve }),
+ });
+ assert.ok(outcome.ok, JSON.stringify(!outcome.ok && outcome.error));
+ return outcome.result;
+}
+
+async function head(db: Database, id: Uuid) {
+ const revision = await loadCurrentResourceRevision(db, id);
+ assert.ok(revision != null && revision.document != null);
+ return { ...revision, document: revision.document as JsonObject };
+}
+
+async function embeddings(db: Database, revisionId: Uuid) {
+ const rows = await db
+ .select()
+ .from(schema.revisionEmbeddings)
+ .where(eq(schema.revisionEmbeddings.revisionId, revisionId));
+ return rows
+ .map(({ path, sourceRevisionId, relation }) => ({
+ path,
+ sourceRevisionId,
+ relation,
+ }))
+ .toSorted((left, right) =>
+ JSON.stringify(left.path).localeCompare(JSON.stringify(right.path)),
+ );
+}
+
+const withoutContext = ({ "@context": _, ...rest }: JsonObject): JsonObject =>
+ rest;
+
+/**
+ * Saves a Note and edits it once, so that its first revision is past.
+ * @returns The saved Note, its first revision, and its current revision.
+ */
+async function savedNote(env: LocalWriteEnvironment, db: Database) {
+ const [note] = (await write(env, create(NOTE))).resources;
+ assert.ok(note != null);
+ const first = await head(db, note.id);
+ await write(env, {
+ operation: "edit",
+ actorId: localActorId,
+ objectId: note.id,
+ expectedRevisionId: first.id,
+ document: { ...first.document, content: "Edited
" },
+ });
+ return { note, first, current: await head(db, note.id) };
+}
+
+describe("embedded document sources", () => {
+ it("records a nested new resource kept embedded as a snapshot", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const document = {
+ "@context": AS,
+ type: "Create",
+ to: [PUBLIC_IRI],
+ object: { type: "Note", content: "Nested
", to: [PUBLIC_IRI] },
+ };
+ for (const representation of ["embedded", "reference"] as const) {
+ const [note, root] = (
+ await write(
+ env,
+ create(document, [
+ { path: [], kind: "activity" },
+ { path: ["object"], kind: "object", representation },
+ ]),
+ )
+ ).resources;
+ assert.ok(note != null && root != null);
+ assert.deepEqual(
+ await embeddings(harness.db, root.revisionId),
+ representation === "embedded"
+ ? [
+ {
+ path: ["object"],
+ sourceRevisionId: note.revisionId,
+ relation: "snapshot",
+ },
+ ]
+ : [],
+ );
+ assert.deepEqual(await embeddings(harness.db, note.revisionId), []);
+ }
+ });
+ });
+
+ it("records the Update of an edit as a snapshot of the new version", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const [note] = (await write(env, create(NOTE))).resources;
+ assert.ok(note != null);
+ const first = await head(harness.db, note.id);
+ const [version, update] = (
+ await write(env, {
+ operation: "edit",
+ actorId: localActorId,
+ objectId: note.id,
+ expectedRevisionId: first.id,
+ document: { ...first.document, content: "B
" },
+ })
+ ).resources;
+ assert.ok(version != null && update != null);
+ assert.deepEqual(await embeddings(harness.db, update.revisionId), [
+ {
+ path: ["object"],
+ sourceRevisionId: version.revisionId,
+ relation: "snapshot",
+ },
+ ]);
+ assert.deepEqual(await embeddings(harness.db, version.revisionId), []);
+ });
+ });
+
+ it("records a declared source as kept or derived by comparing documents", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const { first } = await savedNote(env, harness.db);
+ for (const [content, relation] of [
+ ["Hello
", "snapshot"],
+ ["Changed
", "derived"],
+ ] as const) {
+ const [like] = (
+ await write(
+ env,
+ activity(
+ {
+ "@context": AS,
+ type: "Like",
+ object: { ...withoutContext(first.document), content },
+ to: [PUBLIC_IRI],
+ },
+ [{ path: ["object"], revisionId: first.id }],
+ ),
+ )
+ ).resources;
+ assert.ok(like != null);
+ assert.deepEqual(await embeddings(harness.db, like.revisionId), [
+ { path: ["object"], sourceRevisionId: first.id, relation },
+ ]);
+ }
+ });
+ });
+
+ it("records declared sources of an edited version, and in its Update", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const { first } = await savedNote(env, harness.db);
+ const [other] = (await write(env, create(NOTE))).resources;
+ assert.ok(other != null);
+ const otherHead = await head(harness.db, other.id);
+ const [version, update] = (
+ await write(env, {
+ operation: "edit",
+ actorId: localActorId,
+ objectId: other.id,
+ expectedRevisionId: otherHead.id,
+ document: {
+ ...otherHead.document,
+ location: withoutContext(first.document),
+ },
+ sources: [{ path: ["location"], revisionId: first.id }],
+ })
+ ).resources;
+ assert.ok(version != null && update != null);
+ assert.deepEqual(await embeddings(harness.db, version.revisionId), [
+ {
+ path: ["location"],
+ sourceRevisionId: first.id,
+ relation: "snapshot",
+ },
+ ]);
+ // The Update keeps the version, so it records the version's sources
+ // at its own paths.
+ assert.deepEqual(await embeddings(harness.db, update.revisionId), [
+ {
+ path: ["object", "location"],
+ sourceRevisionId: first.id,
+ relation: "snapshot",
+ },
+ {
+ path: ["object"],
+ sourceRevisionId: version.revisionId,
+ relation: "snapshot",
+ },
+ ]);
+ });
+ });
+
+ it("treats a different context as derived, and an equal one spelled as a list as kept", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const { first } = await savedNote(env, harness.db);
+ for (const [context, relation] of [
+ [[AS], "snapshot"],
+ [[AS, { extra: "https://example.com/extra" }], "derived"],
+ ] as const) {
+ const [like] = (
+ await write(
+ env,
+ activity(
+ {
+ "@context": context,
+ type: "Like",
+ object: withoutContext(first.document),
+ to: [PUBLIC_IRI],
+ },
+ [{ path: ["object"], revisionId: first.id }],
+ ),
+ )
+ ).resources;
+ assert.ok(like != null);
+ assert.deepEqual(await embeddings(harness.db, like.revisionId), [
+ { path: ["object"], sourceRevisionId: first.id, relation },
+ ]);
+ }
+ });
+ });
+
+ it("records the sources of nested documents at every depth", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const { first } = await savedNote(env, harness.db);
+ const [note, root] = (
+ await write(
+ env,
+ create(
+ {
+ "@context": AS,
+ type: "Create",
+ to: [PUBLIC_IRI],
+ object: {
+ type: "Note",
+ content: "Nested
",
+ to: [PUBLIC_IRI],
+ location: withoutContext(first.document),
+ },
+ },
+ [
+ { path: [], kind: "activity" },
+ { path: ["object"], kind: "object", representation: "embedded" },
+ ],
+ [{ path: ["object", "location"], revisionId: first.id }],
+ ),
+ )
+ ).resources;
+ assert.ok(note != null && root != null);
+ assert.deepEqual(await embeddings(harness.db, note.revisionId), [
+ {
+ path: ["location"],
+ sourceRevisionId: first.id,
+ relation: "snapshot",
+ },
+ ]);
+ assert.deepEqual(await embeddings(harness.db, root.revisionId), [
+ {
+ path: ["object", "location"],
+ sourceRevisionId: first.id,
+ relation: "snapshot",
+ },
+ {
+ path: ["object"],
+ sourceRevisionId: note.revisionId,
+ relation: "snapshot",
+ },
+ ]);
+ });
+ });
+
+ it("never guesses the source of an undeclared document", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const { first, current } = await savedNote(env, harness.db);
+ // Not even a copy of the current snapshot, which a pasted document
+ // may equal by chance.
+ for (const object of [
+ withoutContext(current.document),
+ withoutContext(first.document),
+ { ...withoutContext(current.document), content: "X
" },
+ ]) {
+ const [like] = (
+ await write(
+ env,
+ activity({
+ "@context": AS,
+ type: "Like",
+ object,
+ to: [PUBLIC_IRI],
+ }),
+ )
+ ).resources;
+ assert.ok(like != null);
+ assert.deepEqual(await embeddings(harness.db, like.revisionId), []);
+ }
+ });
+ });
+
+ it("records nothing for a Link, a reference, or a deletion", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const { note, current } = await savedNote(env, harness.db);
+ for (const object of [{ type: "Link", href: note.iri }, note.iri]) {
+ const [like] = (
+ await write(
+ env,
+ activity({
+ "@context": AS,
+ type: "Like",
+ object,
+ to: [PUBLIC_IRI],
+ }),
+ )
+ ).resources;
+ assert.ok(like != null);
+ assert.deepEqual(await embeddings(harness.db, like.revisionId), []);
+ }
+ const [removal] = (
+ await write(env, {
+ operation: "delete",
+ actorId: localActorId,
+ objectId: note.id,
+ expectedRevisionId: current.id,
+ })
+ ).resources;
+ assert.ok(removal != null);
+ assert.deepEqual(await embeddings(harness.db, removal.revisionId), []);
+ });
+ });
+
+ it("refuses invalid declarations in the preview", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const { note, first } = await savedNote(env, harness.db);
+ const [other] = (await write(env, create(NOTE))).resources;
+ assert.ok(other != null);
+ const otherHead = await head(harness.db, other.id);
+ const like = {
+ "@context": AS,
+ type: "Like",
+ object: withoutContext(first.document),
+ instrument: { type: "Link", href: note.iri },
+ to: [PUBLIC_IRI],
+ };
+ const cases: [string, LocalWriteRequest][] = [
+ ["root", activity(like, [{ path: [], revisionId: first.id }])],
+ [
+ "not a document",
+ activity(like, [{ path: ["to", 0], revisionId: first.id }]),
+ ],
+ [
+ "Link",
+ activity(like, [{ path: ["instrument"], revisionId: first.id }]),
+ ],
+ [
+ "twice",
+ activity(like, [
+ { path: ["object"], revisionId: first.id },
+ { path: ["object"], revisionId: first.id },
+ ]),
+ ],
+ [
+ "no id",
+ activity(
+ {
+ ...like,
+ object: { type: "Note", content: "Anonymous
" },
+ },
+ [{ path: ["object"], revisionId: first.id }],
+ ),
+ ],
+ [
+ "new resource",
+ create(
+ {
+ "@context": AS,
+ type: "Create",
+ to: [PUBLIC_IRI],
+ object: { type: "Note", content: "New
" },
+ },
+ [
+ { path: [], kind: "activity" },
+ { path: ["object"], kind: "object" },
+ ],
+ [{ path: ["object"], revisionId: first.id }],
+ ),
+ ],
+ [
+ "malformed",
+ {
+ ...activity(like),
+ sources: "object" as unknown as EmbeddedSource[],
+ },
+ ],
+ [
+ "malformed in an edit",
+ {
+ operation: "edit",
+ actorId: localActorId,
+ objectId: other.id,
+ expectedRevisionId: otherHead.id,
+ document: otherHead.document,
+ sources: [{ path: ["object"], revisionId: "nope" as Uuid }],
+ },
+ ],
+ ];
+ for (const [label, request] of cases) {
+ const preview = await previewLocalWrite(
+ env,
+ PRINCIPAL,
+ request,
+ READ_ALL,
+ );
+ assert.ok(!preview.ok, label);
+ assert.equal(preview.error.type, "invalid_request", label);
+ }
+ // Declaring sources needs a check of what the principal may read.
+ const declared = activity(like, [
+ { path: ["object"], revisionId: first.id },
+ ]);
+ const unchecked = await previewLocalWrite(env, PRINCIPAL, declared);
+ assert.ok(!unchecked.ok);
+ assert.equal(unchecked.error.type, "invalid_request");
+ });
+ });
+
+ it("refuses unavailable sources alike, whatever makes them so", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const { first } = await savedNote(env, harness.db);
+ const [other] = (await write(env, create(NOTE))).resources;
+ assert.ok(other != null);
+ const otherHead = await head(harness.db, other.id);
+ await write(env, {
+ operation: "delete",
+ actorId: localActorId,
+ objectId: other.id,
+ expectedRevisionId: otherHead.id,
+ });
+ const whiteout = await loadCurrentResourceRevision(harness.db, other.id);
+ assert.ok(whiteout?.kind === "whiteout");
+ const like = (revisionId: Uuid) =>
+ activity(
+ {
+ "@context": AS,
+ type: "Like",
+ object: withoutContext(first.document),
+ to: [PUBLIC_IRI],
+ },
+ [{ path: ["object"], revisionId }],
+ );
+ const cases: [string, Uuid, PreviewOptions][] = [
+ ["missing", MISSING_REVISION_ID, READ_ALL],
+ ["unreadable", first.id, readAllBut(first.id)],
+ ["another resource's", otherHead.id, READ_ALL],
+ ["a whiteout", whiteout.id, READ_ALL],
+ ];
+ const errors = [];
+ for (const [label, revisionId, options] of cases) {
+ const preview = await previewLocalWrite(
+ env,
+ PRINCIPAL,
+ like(revisionId),
+ options,
+ );
+ assert.ok(!preview.ok, label);
+ errors.push(preview.error);
+ }
+ // Nothing tells a revision the principal may not read from one that
+ // does not exist.
+ for (const error of errors) {
+ assert.deepEqual(error, {
+ type: "source_unavailable",
+ message: errors[0]!.message,
+ diagnostics: [
+ {
+ reason: "source_unavailable",
+ category: "authority",
+ severity: "error",
+ path: ["object"],
+ message: errors[0]!.diagnostics[0]!.message,
+ },
+ ],
+ });
+ }
+ // The commit checks again, since access may change after the preview.
+ const preview = await previewLocalWrite(
+ env,
+ PRINCIPAL,
+ like(first.id),
+ READ_ALL,
+ );
+ assert.ok(preview.ok);
+ const before = await harness.db.$count(schema.resourceRevisions);
+ const outcome = await commitLocalWrite(env, PRINCIPAL, like(first.id), {
+ ...readAllBut(first.id),
+ previewToken: preview.preview.token,
+ });
+ assert.ok(!outcome.ok);
+ assert.deepEqual(outcome.error, errors[0]);
+ assert.equal(await harness.db.$count(schema.resourceRevisions), before);
+ });
+ });
+
+ it("binds declared sources to the preview token", async () => {
+ await withFederation(async (harness) => {
+ await seedMember(harness.db);
+ const env = await environment(harness);
+ const { first, current } = await savedNote(env, harness.db);
+ const like = {
+ "@context": AS,
+ type: "Like",
+ object: withoutContext(first.document),
+ to: [PUBLIC_IRI],
+ };
+ const preview = await previewLocalWrite(
+ env,
+ PRINCIPAL,
+ activity(like, [{ path: ["object"], revisionId: first.id }]),
+ READ_ALL,
+ );
+ assert.ok(preview.ok);
+ for (const sources of [
+ undefined,
+ [{ path: ["object"], revisionId: current.id }],
+ ]) {
+ const outcome = await commitLocalWrite(
+ env,
+ PRINCIPAL,
+ activity(like, sources),
+ { ...READ_ALL, previewToken: preview.preview.token },
+ );
+ assert.ok(!outcome.ok);
+ assert.equal(outcome.error.type, "stale_preview");
+ }
+ assert.equal(await harness.db.$count(schema.revisionEmbeddings), 1);
+ });
+ });
+});
diff --git a/packages/federation/src/local-write.ts b/packages/federation/src/local-write.ts
index c6268b1c..6e56898c 100644
--- a/packages/federation/src/local-write.ts
+++ b/packages/federation/src/local-write.ts
@@ -40,6 +40,7 @@ export type {
CreateRequest,
DeleteRequest,
EditRequest,
+ EmbeddedSource,
JsonObject,
LocalWriteEnvironment,
LocalWriteError,
@@ -49,6 +50,7 @@ export type {
LocalWriteResult,
NewResource,
PreparedResource,
+ PreviewOptions,
PreviewOutcome,
SavedResource,
WritePrincipal,
diff --git a/packages/federation/src/local-write/context.ts b/packages/federation/src/local-write/context.ts
new file mode 100644
index 00000000..4dfcbd4a
--- /dev/null
+++ b/packages/federation/src/local-write/context.ts
@@ -0,0 +1,67 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import type { FieldPath, JsonValue } from "@drfed/models/document";
+
+import { valueAt } from "../document/interpret.ts";
+
+const ACTIVITY_STREAMS = "https://www.w3.org/ns/activitystreams";
+
+/**
+ * Keys a path for maps and token allocations.
+ * @returns The path's JSON.
+ */
+export function pathKey(path: FieldPath): string {
+ return JSON.stringify(path);
+}
+
+/**
+ * Lists the entries of a `@context` value, a list or one context.
+ * @returns The entries; none for a missing value.
+ */
+export function contextEntries(value: JsonValue | undefined): JsonValue[] {
+ if (value === undefined) return [];
+ return Array.isArray(value) ? [...value] : [value];
+}
+
+/**
+ * Reads the context a document embedded at a path is read with: the
+ * contexts of the documents along the path, its own last, after the
+ * ActivityStreams context the validator assumes when the root states none.
+ * @param document The root document.
+ * @param nodePaths The keys of the paths of the documents it describes, as
+ * {@link pathKey} spells them; other values on the path,
+ * such as plain JSON objects, state no context.
+ * @param path The embedded document's path; `[]` for the root.
+ * @returns The context entries, in order.
+ */
+export function effectiveContext(
+ document: JsonValue,
+ nodePaths: ReadonlySet,
+ path: FieldPath,
+): JsonValue[] {
+ const chain: JsonValue[] = [];
+ for (let length = 0; length <= path.length; length += 1) {
+ const prefix = path.slice(0, length);
+ if (!nodePaths.has(pathKey(prefix))) continue;
+ chain.push(...contextEntries(valueAt(document, [...prefix, "@context"])));
+ }
+ // The validator reads a document without a context as ActivityStreams.
+ if (valueAt(document, ["@context"]) === undefined) {
+ chain.unshift(ACTIVITY_STREAMS);
+ }
+ return chain;
+}
diff --git a/packages/federation/src/local-write/embedding.ts b/packages/federation/src/local-write/embedding.ts
new file mode 100644
index 00000000..6dd81358
--- /dev/null
+++ b/packages/federation/src/local-write/embedding.ts
@@ -0,0 +1,341 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import { type Database, type Transaction, schema } from "@drfed/models";
+import {
+ DIAGNOSTIC_REASONS,
+ type DocumentNode,
+ type FieldPath,
+ type JsonValue,
+} from "@drfed/models/document";
+import type { RevisionEmbeddingInput } from "@drfed/models/resource-revision";
+import type { Uuid } from "@drfed/models/uuid";
+import { and, eq, inArray } from "drizzle-orm";
+
+import {
+ type InterpretedNode,
+ interpretDocument,
+} from "../document/interpret.ts";
+import { effectiveContext, pathKey } from "./context.ts";
+import {
+ type EmbeddedSource,
+ type JsonObject,
+ type LocalWriteError,
+ type PreparedResource,
+ writeError,
+} from "./types.ts";
+
+const ROOT_PATHS: ReadonlySet = new Set([pathKey([])]);
+
+/** A stored revision an embedded document may come from. */
+export interface SourceRevision {
+ /** The IRI of the resource the revision belongs to. */
+ readonly iri: string;
+ readonly kind: "snapshot" | "unavailable" | "whiteout";
+}
+
+/** A stored snapshot an embedding names, with its document to compare. */
+export interface SourceSnapshot {
+ readonly revisionId: Uuid;
+ readonly document: JsonValue;
+}
+
+/** A snapshot this write saved, with the sources recorded for it. */
+export interface SavedSnapshot extends SourceSnapshot {
+ readonly embeddings: readonly RevisionEmbeddingInput[];
+}
+
+/**
+ * Loads the revisions that requests name as sources, with the IRIs of their
+ * resources.
+ * @param hidden The lowercase IDs of revisions the principal may not read,
+ * which are left out as if they did not exist.
+ * @returns The revisions by their lowercase IDs; unknown and hidden IDs are
+ * absent.
+ */
+export async function loadSourceRevisions(
+ db: Database | Transaction,
+ ids: readonly Uuid[],
+ hidden: ReadonlySet = new Set(),
+): Promise> {
+ const shown = ids.filter((id) => !hidden.has(id.toLowerCase()));
+ if (shown.length === 0) return new Map();
+ const rows = await db
+ .select({
+ id: schema.resourceRevisions.id,
+ kind: schema.resourceRevisions.kind,
+ iri: schema.resources.iri,
+ })
+ .from(schema.resourceRevisions)
+ .innerJoin(
+ schema.resources,
+ eq(schema.resources.id, schema.resourceRevisions.resourceId),
+ )
+ .where(inArray(schema.resourceRevisions.id, [...new Set(shown)]));
+ return new Map(
+ rows.map(({ id, kind, iri }) => [id.toLowerCase(), { iri, kind }]),
+ );
+}
+
+/**
+ * Checks the sources a request declares against the submitted document:
+ * each names, once, an embedded document that is not a `Link`, is not a new
+ * resource of the write, and has an `id`, and a stored snapshot of the
+ * resource registered under that `id` that the principal may read. Every
+ * failure of the named revision, whether it does not exist, is no snapshot,
+ * belongs to another resource, or may not be read, is one and the same
+ * `source_unavailable`, so that it tells nothing of revisions the principal
+ * may not read.
+ * @param sources The declared sources.
+ * @param nodes The documents the submitted document describes.
+ * @param newPaths The keys of the paths of the write's new resources.
+ * @param revisions Looks up the declared revisions the principal may read.
+ * @returns Why a declaration is invalid, or null.
+ */
+export async function checkSources(
+ sources: readonly EmbeddedSource[],
+ nodes: readonly DocumentNode[],
+ newPaths: ReadonlySet,
+ revisions: (
+ ids: readonly Uuid[],
+ ) => Promise>,
+): Promise {
+ if (sources.length === 0) return null;
+ const invalid = (message: string) => writeError("invalid_request", message);
+ const byPath = new Map(nodes.map((node) => [pathKey(node.path), node]));
+ const seen = new Set();
+ const named: { path: FieldPath; iri: string; revisionId: Uuid }[] = [];
+ for (const { path, revisionId } of sources) {
+ const key = pathKey(path);
+ if (seen.has(key)) return invalid(`The source of ${key} is listed twice.`);
+ seen.add(key);
+ const node = byPath.get(key);
+ if (node == null || path.length === 0 || node.kind === "link") {
+ return invalid(`${key} is not an embedded document.`);
+ }
+ if (newPaths.has(key)) {
+ return invalid(`${key} is a new resource, which has no source.`);
+ }
+ const iri = node.identifiers.find(({ property }) => property === "id")?.iri;
+ if (iri == null) return invalid(`${key} has no id to name its source.`);
+ named.push({ path, iri, revisionId });
+ }
+ const found = await revisions(named.map(({ revisionId }) => revisionId));
+ const unavailable = named.filter(({ iri, revisionId }) => {
+ const revision = found.get(revisionId.toLowerCase());
+ return revision?.kind !== "snapshot" || revision.iri !== iri;
+ });
+ return unavailable.length === 0
+ ? null
+ : writeError(
+ "source_unavailable",
+ "A declared source is not a saved version of its document that " +
+ "can be read.",
+ unavailable.map(({ path }) => ({
+ reason: "source_unavailable",
+ ...DIAGNOSTIC_REASONS.source_unavailable,
+ path,
+ message: "The source is not a saved version that can be read.",
+ })),
+ );
+}
+
+/**
+ * Compares JSON values by structure: object keys in any order, lists in
+ * order.
+ * @returns Whether the values are equal.
+ */
+export function sameJson(left: JsonValue, right: JsonValue): boolean {
+ if (left === right) return true;
+ if (
+ left === null ||
+ right === null ||
+ typeof left !== "object" ||
+ typeof right !== "object" ||
+ Array.isArray(left) !== Array.isArray(right)
+ ) {
+ return false;
+ }
+ if (Array.isArray(left)) {
+ const list = right as readonly JsonValue[];
+ return (
+ left.length === list.length &&
+ left.every((entry, index) => sameJson(entry, list[index]!))
+ );
+ }
+ const own = left as JsonObject;
+ const other = right as JsonObject;
+ const keys = Object.keys(own);
+ return (
+ keys.length === Object.keys(other).length &&
+ keys.every(
+ (key) => Object.hasOwn(other, key) && sameJson(own[key]!, other[key]!),
+ )
+ );
+}
+
+const withoutContext = (value: JsonValue): JsonValue => {
+ if (value === null || typeof value !== "object" || Array.isArray(value)) {
+ return value;
+ }
+ const { "@context": _, ...rest } = value as JsonObject;
+ return rest;
+};
+
+/**
+ * Tells how an embedded document relates to a stored snapshot: it keeps the
+ * snapshot when it is read with the same context entries and, apart from
+ * their own `@context`, its JSON equals the snapshot's.
+ * @param document The saved document that embeds it.
+ * @param nodePaths The keys of the paths of the documents `document`
+ * describes.
+ * @param path The embedded document's path in `document`.
+ * @param value The embedded document.
+ * @param source The snapshot's document.
+ * @returns `snapshot` or `derived`.
+ */
+export function embeddingRelation(
+ document: JsonValue,
+ nodePaths: ReadonlySet,
+ path: FieldPath,
+ value: JsonValue,
+ source: JsonValue,
+): RevisionEmbeddingInput["relation"] {
+ return sameJson(
+ effectiveContext(document, nodePaths, path),
+ effectiveContext(source, ROOT_PATHS, []),
+ ) && sameJson(withoutContext(value), withoutContext(source))
+ ? "snapshot"
+ : "derived";
+}
+
+async function storedSnapshots(
+ tx: Transaction,
+ ids: readonly Uuid[],
+): Promise> {
+ if (ids.length === 0) return new Map();
+ const rows = await tx
+ .select({
+ revisionId: schema.resourceRevisions.id,
+ document: schema.resourceRevisions.document,
+ })
+ .from(schema.resourceRevisions)
+ .where(
+ and(
+ inArray(schema.resourceRevisions.id, [...new Set(ids)]),
+ eq(schema.resourceRevisions.kind, "snapshot"),
+ ),
+ );
+ return new Map(
+ rows.map(({ revisionId, document }) => [
+ revisionId.toLowerCase(),
+ { revisionId, document: document as JsonValue },
+ ]),
+ );
+}
+
+/**
+ * Finds where the documents a saved document embeds came from, as
+ * `revisionEmbeddings` records it. Only embedded documents, not `Link`s,
+ * with an `id` other than the saved resource's own are considered, at any
+ * depth. Each takes its source from, in order:
+ *
+ * 1. the revision this write saved for its IRI, as a new nested resource
+ * or an edited object; when the document keeps that revision, the
+ * documents it embeds take the sources recorded for that revision too,
+ * so that an `Update` records those of the version it carries;
+ * 2. the revision the request declares for its submitted path, for a
+ * document the request submitted rather than one the server generated.
+ *
+ * Any other has an unknown source and no row, even when it equals a stored
+ * revision of the resource under its IRI: a source is never guessed.
+ * @param tx The write's transaction.
+ * @param resource The prepared resource about to be saved.
+ * @param declared Declared source revisions by the keys of submitted paths,
+ * already checked to be readable snapshots.
+ * @param saved The snapshots this write has saved so far, by IRI.
+ * @returns The embeddings to save with the resource's revision.
+ */
+export async function findEmbeddings(
+ tx: Transaction,
+ resource: PreparedResource,
+ declared: ReadonlyMap,
+ saved: ReadonlyMap,
+): Promise {
+ const nodes = interpretDocument(resource.document) ?? [];
+ const nodePaths = new Set(nodes.map(({ path }) => pathKey(path)));
+ const embedded = nodes.filter(
+ (node): node is InterpretedNode & { readonly iri: string } =>
+ node.path.length > 0 &&
+ node.kind !== "link" &&
+ node.iri != null &&
+ node.iri !== resource.iri,
+ );
+ const declaredFor = (node: InterpretedNode): Uuid | undefined =>
+ resource.generated || saved.has(node.iri ?? "")
+ ? undefined
+ : declared.get(pathKey([...resource.path, ...node.path]));
+ const declaredSnapshots = await storedSnapshots(
+ tx,
+ embedded.flatMap((node) => {
+ const id = declaredFor(node);
+ return id == null ? [] : [id];
+ }),
+ );
+ const direct = embedded.flatMap((node): RevisionEmbeddingInput[] => {
+ const declaredId = declaredFor(node);
+ const source =
+ saved.get(node.iri) ??
+ (declaredId == null
+ ? undefined
+ : declaredSnapshots.get(declaredId.toLowerCase()));
+ if (source == null) return [];
+ const relation = embeddingRelation(
+ resource.document,
+ nodePaths,
+ node.path,
+ node.value,
+ source.document,
+ );
+ return [{ path: node.path, sourceRevisionId: source.revisionId, relation }];
+ });
+ const recorded = new Set(direct.map(({ path }) => pathKey(path)));
+ const inherited = direct.flatMap(({ path, sourceRevisionId, relation }) =>
+ relation === "snapshot"
+ ? [...saved.values()]
+ .filter(({ revisionId }) => revisionId === sourceRevisionId)
+ .flatMap(({ embeddings }) => embeddings)
+ .map((embedding) => ({
+ ...embedding,
+ path: [...path, ...embedding.path],
+ }))
+ .filter((embedding) => !recorded.has(pathKey(embedding.path)))
+ : [],
+ );
+ return [...direct, ...inherited];
+}
+
+/**
+ * Indexes a request's declared sources by the keys of their paths.
+ * @returns The declared revision IDs.
+ */
+export function declaredSources(
+ sources: readonly EmbeddedSource[] | undefined,
+): ReadonlyMap {
+ return new Map(
+ (sources ?? []).map(({ path, revisionId }) => [pathKey(path), revisionId]),
+ );
+}
diff --git a/packages/federation/src/local-write/existing.ts b/packages/federation/src/local-write/existing.ts
index 5c590757..928d88d4 100644
--- a/packages/federation/src/local-write/existing.ts
+++ b/packages/federation/src/local-write/existing.ts
@@ -40,9 +40,11 @@ import { Activity } from "@fedify/vocab";
import { asc, eq } from "drizzle-orm";
import type { WritingActor } from "./actor.ts";
+import { checkSources } from "./embedding.ts";
import {
type IdentityLookups,
checkIndexable,
+ checkSourceShapes,
deniedClaims,
indexDocument,
pathKey,
@@ -100,7 +102,9 @@ export function checkExistingRequest(
) {
return invalid("The document must be a JSON object.");
}
- return null;
+ return request.operation === "edit"
+ ? checkSourceShapes(request.sources)
+ : null;
}
/**
@@ -115,7 +119,15 @@ export function bindableExisting(
actorId: request.actorId,
objectId: request.objectId,
expectedRevisionId: request.expectedRevisionId,
- ...(request.operation === "edit" ? { document: request.document } : {}),
+ ...(request.operation === "edit"
+ ? {
+ document: request.document,
+ sources: (request.sources ?? []).map(({ path, revisionId }) => ({
+ path,
+ revisionId,
+ })),
+ }
+ : {}),
};
}
@@ -413,6 +425,13 @@ export async function prepareEdit(
validateDocument(submitted).diagnostics,
);
}
+ const sourceError = await checkSources(
+ request.sources ?? [],
+ nodes,
+ new Set(),
+ lookups.revisions,
+ );
+ if (sourceError != null) return sourceError;
const root = nodes[0]!;
if (root.type !== target.type) {
return writeError(
diff --git a/packages/federation/src/local-write/operation.ts b/packages/federation/src/local-write/operation.ts
index 0e903777..61f90123 100644
--- a/packages/federation/src/local-write/operation.ts
+++ b/packages/federation/src/local-write/operation.ts
@@ -32,6 +32,7 @@ import {
LegacyResourceRevisionError,
ResourceRevisionStateError,
RevisionConflictError,
+ type RevisionEmbeddingInput,
appendResourceRevision,
writeTypedResourceRevision,
} from "@drfed/models/resource-revision";
@@ -44,6 +45,12 @@ import {
localActorIris,
registeredIris,
} from "./actor.ts";
+import {
+ type SavedSnapshot,
+ declaredSources,
+ findEmbeddings,
+ loadSourceRevisions,
+} from "./embedding.ts";
import {
type WriteTarget,
bindableExisting,
@@ -77,6 +84,7 @@ import {
type LocalWriteRequest,
LocalWriteRollback,
type PreparedResource,
+ type PreviewOptions,
type PreviewOutcome,
type SavedResource,
type WritePrincipal,
@@ -87,13 +95,40 @@ import {
function lookups(
db: Database | Transaction,
actor: WritingActor,
+ hidden: ReadonlySet,
): IdentityLookups {
return {
localActors: (iris) => localActorIris(db, actor.instanceId, iris),
registered: (iris) => registeredIris(db, iris),
+ revisions: (ids) => loadSourceRevisions(db, ids, hidden),
};
}
+/**
+ * Asks which of the revisions a request declares as sources the principal
+ * may not read. It runs before the commit's transaction, since the check
+ * may read the database apart from it.
+ * @returns Their lowercase IDs, or why sources cannot be declared.
+ */
+async function hiddenSources(
+ request: LocalWriteRequest,
+ options: PreviewOptions | undefined,
+): Promise | LocalWriteError> {
+ const ids =
+ request.operation === "delete"
+ ? []
+ : (request.sources ?? []).map(({ revisionId }) => revisionId);
+ if (ids.length === 0) return new Set();
+ if (typeof options?.unreadableRevisions !== "function") {
+ return writeError(
+ "invalid_request",
+ "Declaring sources requires a check of which revisions can be read.",
+ );
+ }
+ const hidden = await options.unreadableRevisions(ids);
+ return new Set([...hidden].map((id) => id.toLowerCase()));
+}
+
function checkRequest(request: LocalWriteRequest): LocalWriteError | null {
if (request === null || typeof request !== "object") {
return writeError("invalid_request", "Expected a write request.");
@@ -141,6 +176,7 @@ async function prepare(
actor: WritingActor,
request: LocalWriteRequest,
allocation: Allocation,
+ hidden: ReadonlySet,
): Promise {
if (request.operation === "create") {
return await prepareCreate(
@@ -149,7 +185,7 @@ async function prepare(
actor,
request,
allocation,
- lookups(db, actor),
+ lookups(db, actor, hidden),
);
}
const target = await loadTarget(
@@ -168,7 +204,7 @@ async function prepare(
target,
request,
allocation,
- lookups(db, actor),
+ lookups(db, actor, hidden),
)
: await prepareDelete(env.federation, actor, target, allocation, () =>
currentAddressing(db, target.id),
@@ -193,9 +229,12 @@ export async function previewLocalWrite(
env: LocalWriteEnvironment,
principal: WritePrincipal,
request: LocalWriteRequest,
+ options?: PreviewOptions,
): Promise {
const requestError = checkRequest(request);
if (requestError != null) return { ok: false, error: requestError };
+ const hidden = await hiddenSources(request, options);
+ if (isLocalWriteError(hidden)) return { ok: false, error: hidden };
const actor = await findWritingActor(
env.db,
env.rootOrigin,
@@ -205,7 +244,14 @@ export async function previewLocalWrite(
);
if (isLocalWriteError(actor)) return { ok: false, error: actor };
const allocation = allocateFor(request);
- const prepared = await prepare(env, env.db, actor, request, allocation);
+ const prepared = await prepare(
+ env,
+ env.db,
+ actor,
+ request,
+ allocation,
+ hidden,
+ );
if (isLocalWriteError(prepared)) return { ok: false, error: prepared };
const token = await issueToken(
env.previewKey,
@@ -231,6 +277,7 @@ async function writeObjectVersion(
target: WriteTarget,
object: PreparedResource,
typed: TypedProjection | null | undefined,
+ embeddings: readonly RevisionEmbeddingInput[],
): Promise {
if (target.typed != null && typed != null) {
const { attributedTo: _, ...columns } = typed;
@@ -242,6 +289,7 @@ async function writeObjectVersion(
columns,
addressingOccurrences: object.addressing,
relations: object.relations,
+ embeddings,
});
return revision.id;
}
@@ -254,6 +302,7 @@ async function writeObjectVersion(
capture: "local",
addressingOccurrences: object.addressing,
relations: object.relations,
+ embeddings,
});
await replaceAddressing(tx, target.id, object.addressing);
return revision.id;
@@ -356,6 +405,8 @@ export async function commitLocalWrite(
),
};
}
+ const hidden = await hiddenSources(request, options);
+ if (isLocalWriteError(hidden)) return { ok: false, error: hidden };
try {
const result = await env.db.transaction(async (tx) => {
const fail = (error: LocalWriteError): never => {
@@ -371,7 +422,14 @@ export async function commitLocalWrite(
if (isLocalWriteError(actor)) fail(actor);
const writer = actor as WritingActor;
if (outboxed) await lockActorCollection(tx, writer.id, "outbox");
- const prepared = await prepare(env, tx, writer, request, allocation);
+ const prepared = await prepare(
+ env,
+ tx,
+ writer,
+ request,
+ allocation,
+ hidden,
+ );
if (isLocalWriteError(prepared)) fail(prepared);
const { resources, target, typed } = prepared as PreparedOperation;
const created = resources.filter(
@@ -416,15 +474,33 @@ export async function commitLocalWrite(
allocation.timestamp,
);
}
+ const declared = declaredSources(
+ request.operation === "delete" ? undefined : request.sources,
+ );
+ // Children are saved before what embeds them, and an edited object
+ // before its Update, so each finds the revisions it embeds here.
+ const snapshots = new Map();
for (const resource of resources) {
+ const embeddings = await findEmbeddings(
+ tx,
+ resource,
+ declared,
+ snapshots,
+ );
if (target != null && resource.id === target.id) {
const revisionId = await writeObjectVersion(
tx,
target,
resource,
typed,
+ embeddings,
);
saved.push({ ...resource, revisionId });
+ snapshots.set(resource.iri, {
+ revisionId,
+ document: resource.document,
+ embeddings,
+ });
continue;
}
const revision = await appendResourceRevision(tx, {
@@ -436,9 +512,15 @@ export async function commitLocalWrite(
capture: "local",
addressingOccurrences: resource.addressing,
relations: resource.relations,
+ embeddings,
});
await storeAddressingOccurrences(tx, resource.id, resource.addressing);
saved.push({ ...resource, revisionId: revision.id });
+ snapshots.set(resource.iri, {
+ revisionId: revision.id,
+ document: resource.document,
+ embeddings,
+ });
}
if (outboxed) {
const activity = saved.at(-1)!;
diff --git a/packages/federation/src/local-write/prepare.ts b/packages/federation/src/local-write/prepare.ts
index 86dcd522..f1ab21cb 100644
--- a/packages/federation/src/local-write/prepare.ts
+++ b/packages/federation/src/local-write/prepare.ts
@@ -34,8 +34,15 @@ import { type Uuid, uuidV7, validateUuid } from "@drfed/models/uuid";
import type { Federation } from "@fedify/fedify";
import { Object as APObject, Activity, Create } from "@fedify/vocab";
+import {
+ RELATION_PROPERTIES,
+ interpretDocument,
+ valueAt,
+} from "../document/interpret.ts";
import { classifyHost } from "../origin.ts";
import type { WritingActor } from "./actor.ts";
+import { effectiveContext, pathKey } from "./context.ts";
+import { type SourceRevision, checkSources } from "./embedding.ts";
import { type Allocation, toMicroseconds } from "./token.ts";
import {
type CreateRequest,
@@ -57,15 +64,6 @@ const NESTING_PROPERTIES: ReadonlySet = new Set([
"result",
"instrument",
]);
-const RELATION_PROPERTIES = [
- "actor",
- "object",
- "target",
- "origin",
- "result",
- "instrument",
- "attributedTo",
-] as const;
/** Database answers the preparation needs about local identities. */
export interface IdentityLookups {
@@ -73,6 +71,8 @@ export interface IdentityLookups {
localActors(iris: readonly string[]): Promise>;
/** The IRIs that are registered resources. */
registered(iris: readonly string[]): Promise>;
+ /** The stored revisions among IDs, by their lowercase IDs. */
+ revisions(ids: readonly Uuid[]): Promise>;
}
/** The submitted documents and their saved forms, ready to persist. */
@@ -82,13 +82,7 @@ export interface PreparedWrite {
readonly resources: readonly PreparedResource[];
}
-/**
- * Keys a path for maps and token allocations.
- * @returns The path's JSON.
- */
-export function pathKey(path: FieldPath): string {
- return JSON.stringify(path);
-}
+export { pathKey } from "./context.ts";
function isPlainObject(value: unknown): value is Record {
if (value === null || typeof value !== "object" || Array.isArray(value)) {
@@ -109,6 +103,26 @@ function isPath(value: unknown): value is FieldPath {
);
}
+/**
+ * Checks the shape of a request's declared sources.
+ * @returns Why they are malformed, or null.
+ */
+export function checkSourceShapes(sources: unknown): LocalWriteError | null {
+ return sources === undefined ||
+ (Array.isArray(sources) &&
+ sources.every(
+ (source: unknown) =>
+ isPlainObject(source) &&
+ isPath(source.path) &&
+ validateUuid(source.revisionId),
+ ))
+ ? null
+ : writeError(
+ "invalid_request",
+ "sources must be a list of paths with revision IDs.",
+ );
+}
+
/**
* Checks the request's shape before anything reads its document, since the
* request may come straight from a client.
@@ -131,6 +145,8 @@ export function checkCreateRequest(
if (!Array.isArray(request.resources)) {
return invalid("resources must be an array.");
}
+ const sourceError = checkSourceShapes(request.sources);
+ if (sourceError != null) return sourceError;
for (const resource of request.resources as unknown[]) {
if (
!isPlainObject(resource) ||
@@ -164,6 +180,10 @@ export function bindableRequest(request: CreateRequest): unknown {
representation: representation ?? "embedded",
})),
publish: request.publish === true,
+ sources: (request.sources ?? []).map(({ path, revisionId }) => ({
+ path,
+ revisionId,
+ })),
};
}
@@ -251,22 +271,7 @@ export function allocate(resources: readonly NewResource[]): Allocation {
}
// Paths come from submitted documents, whose keys may be spelled
-// `__proto__`; only own properties are read or defined.
-function valueAt(document: JsonValue, path: FieldPath): JsonValue | undefined {
- let value: JsonValue | undefined = document;
- for (const segment of path) {
- if (
- value === null ||
- typeof value !== "object" ||
- !Object.hasOwn(value, segment)
- ) {
- return undefined;
- }
- value = (value as Record)[segment];
- }
- return value;
-}
-
+// `__proto__`; only own properties are defined.
function setAt(document: JsonObject, path: FieldPath, value: JsonValue): void {
const parent = valueAt(document, path.slice(0, -1));
if (parent === null || typeof parent !== "object") {
@@ -378,11 +383,6 @@ export async function deniedClaims(
].map((path) => ({ allowed: false, path }));
}
-function contextEntries(value: JsonValue | undefined): JsonValue[] {
- if (value === undefined) return [];
- return Array.isArray(value) ? [...value] : [value];
-}
-
/**
* Refuses a document that spells one indexed property in several ways, as
* in `to` beside an alias of it: their occurrences would share positions,
@@ -408,83 +408,32 @@ export function checkIndexable(document: JsonObject): Diagnostic[] {
}
/**
- * Indexes a saved document's root addressing and relations by meaning.
- * @returns Addressing occurrences at their source positions, and relations.
+ * Indexes a saved document's root addressing and relations by meaning, as
+ * `interpretDocument()` reads them for every document it embeds as well.
+ * Several spellings of one property must have been refused by
+ * {@link checkIndexable}, or their positions would collide.
+ * @returns Addressing occurrences at their source positions, without
+ * anonymous recipients, and relations.
*/
export function indexDocument(document: JsonObject): {
addressing: AddressingOccurrence[];
relations: RevisionRelationInput[];
} {
- const nodes = describeDocument(document) ?? [];
- const root = nodes.find(({ path }) => path.length === 0);
+ const root = interpretDocument(document)?.[0];
if (root == null) return { addressing: [], relations: [] };
- const children = new Map(nodes.map((node) => [pathKey(node.path), node]));
- const identifiers = new Map(
- root.identifiers.map((entry) => [pathKey(entry.path), entry.iri]),
- );
- // An embedded document names a target by its id; a Link by its href.
- const target = (path: FieldPath): string | undefined => {
- const fromRoot = identifiers.get(pathKey(path));
- if (fromRoot != null) return fromRoot;
- const node = children.get(pathKey(path));
- if (node == null) return undefined;
- const property = node.kind === "link" ? "href" : "id";
- // A functional property may be a list with one non-null entry.
- return node.identifiers.find(
- (entry) =>
- entry.property === property &&
- (entry.path.length === path.length + 1 ||
- (entry.path.length === path.length + 2 &&
- typeof entry.path.at(-1) === "number")),
- )?.iri;
- };
- const occurrences = (
- property: string,
- ): { path: FieldPath; position: number }[] => {
- // Several spellings of one property were refused by checkIndexable().
- const source = root.properties.get(property)?.[0];
- if (source == null) return [];
- const value = document[source];
- if (Array.isArray(value)) {
- return value.map((_, position) => ({
- path: [source, position],
- position,
- }));
- }
- return value == null ? [] : [{ path: [source], position: 0 }];
+ return {
+ addressing: root.addressing.flatMap(({ property, position, iri }) =>
+ iri == null ? [] : [{ property, position, iri }],
+ ),
+ relations: root.relations.map(
+ ({ property, path, representation, iri }) => ({
+ property,
+ path,
+ representation,
+ targetIri: iri,
+ }),
+ ),
};
- const addressing: AddressingOccurrence[] = [];
- for (const property of ADDRESSING_PROPERTIES) {
- for (const { path, position } of occurrences(property)) {
- const iri = target(path);
- if (iri != null) addressing.push({ property, position, iri });
- }
- }
- const relations: RevisionRelationInput[] = [];
- for (const property of RELATION_PROPERTIES) {
- for (const { path } of occurrences(property)) {
- const node = children.get(pathKey(path));
- if (node == null) {
- const iri = identifiers.get(pathKey(path));
- if (iri != null) {
- relations.push({
- property,
- path,
- representation: "reference",
- targetIri: iri,
- });
- }
- } else {
- relations.push({
- property,
- path,
- representation: node.kind === "link" ? "link" : "embedded",
- targetIri: target(path) ?? null,
- });
- }
- }
- }
- return { addressing, relations };
}
/**
@@ -508,16 +457,8 @@ function extractNested(
const changes: NormalizationChange[] = [];
const value = valueAt(working, path) as JsonObject;
const standalone = structuredClone(value) as Record;
- const chain: JsonValue[] = [];
- for (let length = 0; length <= path.length; length += 1) {
- const prefix = path.slice(0, length);
- if (!preparedNodes.has(pathKey(prefix))) continue;
- const own = valueAt(prepared, [...prefix, "@context"]);
- chain.push(...contextEntries(own));
- }
+ const chain = effectiveContext(prepared, preparedNodes, path);
const own = value["@context"];
- // The validator reads a document without a context as ActivityStreams.
- if (prepared["@context"] === undefined) chain.unshift(ACTIVITY_STREAMS);
if (chain.length > 0) {
const context = chain.length === 1 ? chain[0]! : chain;
if (JSON.stringify(context) !== JSON.stringify(own ?? null)) {
@@ -585,6 +526,13 @@ export async function prepareCreate(
const byPath = new Map(nodes.map((node) => [pathKey(node.path), node]));
const descriptorError = checkDescriptors(request, byPath);
if (descriptorError != null) return descriptorError;
+ const sourceError = await checkSources(
+ request.sources ?? [],
+ nodes,
+ new Set(request.resources.map(({ path }) => pathKey(path))),
+ lookups.revisions,
+ );
+ if (sourceError != null) return sourceError;
const keys = request.resources.map(({ path }) => pathKey(path));
if (
allocation.ids.size !== keys.length ||
diff --git a/packages/federation/src/local-write/types.ts b/packages/federation/src/local-write/types.ts
index 52fa3bcd..ef3e7805 100644
--- a/packages/federation/src/local-write/types.ts
+++ b/packages/federation/src/local-write/types.ts
@@ -61,6 +61,23 @@ export interface NewResource {
readonly representation?: "embedded" | "reference";
}
+/**
+ * The stored revision an embedded document of a request was derived from,
+ * such as a loaded `Note` changed for an experiment. The principal must be
+ * able to read it, as {@link PreviewOptions.unreadableRevisions} tells; the
+ * server decides whether the document still keeps that revision or was
+ * derived from it.
+ */
+export interface EmbeddedSource {
+ /**
+ * The submitted path of an embedded document with an `id`, not a `Link`
+ * nor a new resource of the write.
+ */
+ readonly path: FieldPath;
+ /** A snapshot of the resource registered under the document's `id`. */
+ readonly revisionId: Uuid;
+}
+
/** Saves new resources: an object alone, an activity, or both nested. */
export interface CreateRequest {
readonly operation: "create";
@@ -71,6 +88,8 @@ export interface CreateRequest {
readonly resources: readonly NewResource[];
/** Adds the root activity to the actor's outbox; needs a reservation. */
readonly publish?: boolean;
+ /** Where embedded documents that are not new resources came from. */
+ readonly sources?: readonly EmbeddedSource[];
}
/**
@@ -85,6 +104,8 @@ export interface EditRequest {
readonly expectedRevisionId: Uuid;
/** The complete new version, usually the loaded document changed. */
readonly document: JsonObject;
+ /** Where documents the new version embeds came from. */
+ readonly sources?: readonly EmbeddedSource[];
}
/**
@@ -108,13 +129,17 @@ export type LocalWriteErrorType =
| "stale_preview"
| "revision_conflict"
| "resource_conflict"
- | "unsupported_edit";
+ | "unsupported_edit"
+ | "source_unavailable";
export interface LocalWriteError {
readonly type: LocalWriteErrorType;
/** For people; use `type` and `diagnostics` for decisions. */
readonly message: string;
- /** Document findings at submitted paths, for `invalid_document`. */
+ /**
+ * Document findings at submitted paths, for `invalid_document`, and the
+ * paths of declared sources, for `source_unavailable`.
+ */
readonly diagnostics: readonly Diagnostic[];
}
@@ -170,7 +195,21 @@ export type CommitOutcome =
| { readonly ok: true; readonly result: LocalWriteResult }
| { readonly ok: false; readonly error: LocalWriteError };
-export interface CommitOptions {
+export interface PreviewOptions {
+ /**
+ * Finds the revisions among IDs that the principal may not read. Each
+ * revision a request declares in `sources` must be one the principal may
+ * read; the preview checks it, and the commit checks it again, since the
+ * principal's access may change in between. One the principal may not
+ * read fails as one that does not exist does, with `source_unavailable`.
+ * Required to declare sources.
+ */
+ readonly unreadableRevisions?: (
+ ids: readonly Uuid[],
+ ) => Promise>;
+}
+
+export interface CommitOptions extends PreviewOptions {
/** The token of the approved preview. */
readonly previewToken: string;
/**
diff --git a/packages/graphql/README.md b/packages/graphql/README.md
index 57b94a7c..c9ac1488 100644
--- a/packages/graphql/README.md
+++ b/packages/graphql/README.md
@@ -75,13 +75,57 @@ when addressed to the public (section 5.6):
`as:Public` and `Public` count as the public as well as its full IRI. What the
viewer may not read is left out as if it did not exist: `node` and `nodes`
-return null for it, as do `Resource.detail` and `Activity.object`, and
-`Actor.objects`, `Object.activities`, and `Collection.items` leave it out
-before paging, so that neither cursors nor `totalCount` tell of it.
+return null for it, as does `Resource.detail`, and `Actor.objects`,
+`Object.activities`, and `Collection.items` leave it out before paging, so
+that neither cursors nor `totalCount` tell of it. A `Resource`, which a
+history is read through, is returned by `node`, `Activity.object`, and the
+`resource` of relations and recipients also when the viewer may read any of
+its revisions; see below.
[ActivityPub]: https://www.w3.org/TR/activitypub/
+Resource revisions
+------------------
+
+`Resource.currentRevision` and `Resource.revisions`, newest first, return the
+saved revisions of any resource, including those saved without legacy
+details; `node` and `nodes` look up a `ResourceRevision` by its ID.
+`ResourceRevision.document` is the saved JSON as is, and `root` describes it
+by meaning: each `DocumentNode`, the root or one embedded at any depth, has
+its type IRI, its own `id` or `href`, its relations and recipients in source
+order, and its custom extension properties. A relation or recipient names
+the resource currently registered under its IRI, opened as
+`Activity.object` is, while `node` keeps the embedded value as saved. When
+the validator cannot read the document, `interpreted` is false and
+`diagnostics` tell why.
+
+Each revision is read by evidence of its own: anyone reads local revisions,
+blind recipients included, and revisions addressed to the public; members of
+a local instance read what a delivery to it carried; and a revision without
+such evidence is readable only while it is current and its resource is, as
+above. A `Resource` with a revision the viewer may read is found even when
+its current state is restricted, while its typed details stay hidden.
+Where a revision's embedded documents came from never hides it.
+Deletion hides no revision by itself, while `Resource.detail` and the other
+existing fields keep hiding what was deleted; `Actor.objects` lists deleted
+objects, with `Object.deleted`, only when its filter sets `includeDeleted`.
+`Resource.revision(sequence:)` returns one revision by its sequence.
+`DocumentNode.source` names the 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 the source revision, and nothing else of the document
+changes. See [resource revision internals].
+
+`unreadableRevisions(viewer, ids)` in `@drfed/graphql/readable` tells which
+revisions a viewer may not read by the same rule. Pass it to
+`previewLocalWrite()` and `commitLocalWrite()` of
+`@drfed/federation/local-write`, which check that a writer declares as
+sources only revisions they may read.
+
+[resource revision internals]: https://drfed.org/internals/resource-revisions#graphql-reads
+
+
Login mail and shutdown
-----------------------
diff --git a/packages/graphql/package.json b/packages/graphql/package.json
index 339af365..5671008e 100644
--- a/packages/graphql/package.json
+++ b/packages/graphql/package.json
@@ -74,6 +74,10 @@
"types": "./dist/object.d.mts",
"default": "./dist/object.mjs"
},
+ "./readable": {
+ "types": "./dist/readable.d.mts",
+ "default": "./dist/readable.mjs"
+ },
"./activity-delivery": {
"types": "./dist/activity-delivery/entry.d.mts",
"default": "./dist/activity-delivery/entry.mjs"
@@ -93,6 +97,7 @@
"src/instance.ts",
"src/schema.ts",
"src/object.ts",
+ "src/readable.ts",
"src/activity-delivery/entry.ts"
],
"dts": {
diff --git a/packages/graphql/src/auth/mail.ts b/packages/graphql/src/auth/mail.ts
index 7813a932..e9509365 100644
--- a/packages/graphql/src/auth/mail.ts
+++ b/packages/graphql/src/auth/mail.ts
@@ -54,12 +54,14 @@ export async function sendMail(
const renderLoginEmail = (loginUrl: string): MessageContent => ({
// FIXME: https://github.com/fedify-dev/drfed/issues/35
+ // oxlint-disable no-inline-comments
text: `Hello, Welcome to DrFed! If you request to login to DrFed, please visit:
-open ${loginUrl}
+open ${loginUrl}${/* Split between the link and the last `\n` */ " "}
Otherwise, please just ignore this mail.`,
});
+// oxlint-enable no-inline-comments
export function logReceipt(receipt: Receipt): void {
if (receipt.successful) {
diff --git a/packages/graphql/src/builder.ts b/packages/graphql/src/builder.ts
index 96338ff3..bb0d9306 100644
--- a/packages/graphql/src/builder.ts
+++ b/packages/graphql/src/builder.ts
@@ -31,7 +31,11 @@ import { GraphQLScalarType, Kind } from "graphql";
import { JSONResolver, URLResolver, UUIDResolver } from "graphql-scalars";
import OperationsPlugin, { type OperationTracker } from "./operations.ts";
-import { hideUnreadableNodes, memberInstances } from "./readable.ts";
+import {
+ hideUnreadableNodes,
+ memberInstances,
+ owningResourceOf,
+} from "./readable.ts";
/**
* The context data for the GraphQL server, which includes the incoming request
@@ -173,18 +177,17 @@ export const builder = new SchemaBuilder({
relay: {
nodeQueryOptions: {
resolve: async (_, { id }, ctx, __, resolveNode) => {
- const [node] = await hideUnreadableNodes(ctx, [
- filterDeleted(await resolveNode(id)),
- ]);
+ const [node] = await hideHiddenNodes(
+ ctx,
+ [id],
+ [await resolveNode(id)],
+ );
return node;
},
},
nodesQueryOptions: {
resolve: async (_, { ids }, ctx, __, resolveNodes) =>
- await hideUnreadableNodes(
- ctx,
- (await resolveNodes(ids)).map(filterDeleted),
- ),
+ await hideHiddenNodes(ctx, ids, await resolveNodes(ids)),
},
},
scopeAuth: {
@@ -224,6 +227,26 @@ const filterDeleted = (node: unknown): unknown =>
? null
: node;
+const RESOURCE_TYPENAME = "Resource";
+
+// A node that belongs to a resource, such as a revision, is hidden by its own
+// readability, by hideUnreadableNodes(); its own deletion time, as that of a
+// whiteout, tells of the history it records and hides nothing. A `Resource`
+// node, which shares its ID with the typed node of the same resource, is
+// told apart by the typename its global ID names.
+const hideHiddenNodes = (
+ context: UserContext,
+ ids: readonly { readonly typename: string }[],
+ nodes: readonly unknown[],
+): Promise =>
+ hideUnreadableNodes(
+ context,
+ nodes.map((node) =>
+ owningResourceOf(node) == null ? filterDeleted(node) : node,
+ ),
+ ids.map(({ typename }) => typename === RESOURCE_TYPENAME),
+ );
+
/**
* Determines whether the viewer is an accepted member of the `Instance` that
* the given `LocalInstance` backs. Pending members, i.e. those who have been
diff --git a/packages/graphql/src/object.test.ts b/packages/graphql/src/object.test.ts
index e63c993d..21692d52 100644
--- a/packages/graphql/src/object.test.ts
+++ b/packages/graphql/src/object.test.ts
@@ -627,6 +627,66 @@ describe("Actor.objects", () => {
assert.deepEqual(previous.data.node.objects.edges, connection.edges);
});
});
+
+ it("lists deleted objects too when the filter includes them", async () => {
+ await withTestHarness(async ({ db, post }) => {
+ await seedLocalActor(db);
+ const [liveId, deletedId] = [uuid(), uuid()];
+ const deleted = Temporal.Instant.from("2026-02-01T00:00:00Z");
+ await seedObjects(
+ db,
+ [liveId, deletedId].map((id, index) => ({
+ id,
+ actorId: localActorId,
+ type: "Note" as const,
+ iri: `https://test.example/${id}`,
+ contentHtml: "test",
+ published: Temporal.Instant.from(
+ index === 0 ? "2026-01-02T00:00:00Z" : "2026-01-01T00:00:00Z",
+ ),
+ deleted: id === deletedId ? deleted : null,
+ })),
+ );
+ const query = `query($actor: ID!, $filter: ActorObjectFilter) {
+ node(id: $actor) { ... on Actor {
+ objects(first: 10, filter: $filter) {
+ totalCount edges { node { uuid deleted } }
+ }
+ } }
+ }`;
+ const list = async (filter: unknown) =>
+ await (
+ await post({
+ query,
+ variables: { actor: globalId("Actor", localActorId), filter },
+ })
+ ).json();
+ const live = { node: { uuid: liveId, deleted: null } };
+ for (const filter of [null, {}, { includeDeleted: false }]) {
+ assert.deepEqual(await list(filter), {
+ data: { node: { objects: { totalCount: 1, edges: [live] } } },
+ });
+ }
+ assert.deepEqual(await list({ includeDeleted: true }), {
+ data: {
+ node: {
+ objects: {
+ totalCount: 2,
+ edges: [
+ live,
+ {
+ node: {
+ uuid: deletedId,
+ deleted: "2026-02-01T00:00:00Z",
+ },
+ },
+ ],
+ },
+ },
+ },
+ });
+ });
+ });
});
describe("Query.node", () => {
diff --git a/packages/graphql/src/object.ts b/packages/graphql/src/object.ts
index 1fdfcb2a..2e4c5b78 100644
--- a/packages/graphql/src/object.ts
+++ b/packages/graphql/src/object.ts
@@ -125,6 +125,15 @@ const ObjectRef = builder.drizzleNode("objects", {
description:
"The time the object was stored in DrFed, distinct from its publication time.",
}),
+ deleted: t.expose("deleted", {
+ type: "DateTime",
+ nullable: true,
+ description:
+ "When the object was deleted, or null while it is not. Only " +
+ "`Actor.objects` returns deleted objects, when its filter includes " +
+ "them; its revisions, a whiteout last, stay readable through " +
+ "`resource`.",
+ }),
}),
});
export const ActivityPubObject: DrFedObjectRef = ObjectRef;
@@ -164,9 +173,28 @@ builder.drizzleObjectField("objects", "activities", (t) =>
}),
);
+const ActorObjectFilter = builder.inputType("ActorObjectFilter", {
+ description: "Narrows the objects `Actor.objects` lists.",
+ fields: (t) => ({
+ includeDeleted: t.boolean({
+ required: true,
+ defaultValue: false,
+ description:
+ "Whether deleted objects are listed too, so that their histories " +
+ "can be inspected.",
+ }),
+ }),
+});
+type ObjectFilter = typeof ActorObjectFilter.$inferInput | null | undefined;
+const includesDeleted = (filter: ObjectFilter): boolean =>
+ filter?.includeDeleted === true;
+
const objectsConnection = drizzleConnectionHelpers(builder, "objects", {
- query: (_, ctx) => ({
- where: { RAW: (table) => readableResource(ctx, table.id) },
+ query: ({ filter }: { filter?: ObjectFilter }, ctx) => ({
+ where: {
+ ...(includesDeleted(filter) ? {} : { deleted: { isNull: true } }),
+ RAW: (table) => readableResource(ctx, table.id),
+ },
orderBy: { published: "desc", id: "desc" },
}),
});
@@ -174,8 +202,9 @@ builder.drizzleObjectField("actors", "objects", (t) =>
t.connection(
{
type: ActivityPubObject,
+ args: { filter: t.arg({ type: ActorObjectFilter }) },
description:
- "Non-deleted objects the viewer may read, newest publication first. A local actor's objects are readable whatever their addressing; see `Object` for a remote actor's.",
+ "Objects the viewer may read, newest publication first, without deleted ones unless the filter includes them. A local actor's objects are readable whatever their addressing; see `Object` for a remote actor's.",
select(args, ctx, nestedSelection) {
return {
with: {
@@ -191,7 +220,9 @@ builder.drizzleObjectField("actors", "objects", (t) =>
schema.objects,
and(
eq(schema.objects.actorId, actor.id),
- isNull(schema.objects.deleted),
+ includesDeleted(args.filter)
+ ? undefined
+ : isNull(schema.objects.deleted),
readableResource(ctx, schema.objects.id),
),
);
@@ -204,7 +235,7 @@ builder.drizzleObjectField("actors", "objects", (t) =>
fields: (fb) => ({
totalCount: fb.int({
description:
- "The number of non-deleted objects authored by this actor that the viewer may read.",
+ "The number of objects authored by this actor that the viewer may read, counted with the same filter as the list.",
resolve: (connection) => connection.totalCount(),
}),
}),
diff --git a/packages/graphql/src/readable.ts b/packages/graphql/src/readable.ts
index be45ec8d..a696825b 100644
--- a/packages/graphql/src/readable.ts
+++ b/packages/graphql/src/readable.ts
@@ -22,10 +22,15 @@ import {
activityDeliveries,
actors,
addressing,
+ collections,
instanceMembers,
instances,
objects,
+ resourceHeads,
+ resourceRevisions,
resources,
+ revisionAddressing,
+ revisionReceipts,
} from "@drfed/models/schema";
import { type Uuid, validateUuid } from "@drfed/models/uuid";
import {
@@ -116,6 +121,20 @@ const carriers = alias(activities, "readable_carriers");
const entries = alias(addressing, "readable_addressing");
const targets = alias(resources, "readable_targets");
const deliveries = alias(activityDeliveries, "readable_deliveries");
+const visibleOwners = alias(actors, "visible_owners");
+const ownedObjects = alias(objects, "visible_objects");
+const ownedActivities = alias(activities, "visible_activities");
+const ownedCollections = alias(collections, "visible_collections");
+const typedActors = alias(actors, "legacy_typed_actors");
+const typedObjects = alias(objects, "legacy_typed_objects");
+const typedActivities = alias(activities, "legacy_typed_activities");
+const typedCollections = alias(collections, "legacy_typed_collections");
+const evidenced = alias(resourceRevisions, "evidenced_revisions");
+const evidencedAddressing = alias(revisionAddressing, "evidenced_addressing");
+const evidencedReceipts = alias(revisionReceipts, "evidenced_receipts");
+const receiptDeliveries = alias(activityDeliveries, "receipt_deliveries");
+const evidencedHeads = alias(resourceHeads, "evidenced_heads");
+const listedRevisions = alias(resourceRevisions, "listed_revisions");
const remoteActivity = (id: SQLWrapper): SQL => sql`exists (
select 1 from ${activities} ${remoteActivities}
@@ -200,6 +219,160 @@ export function readableResource(viewer: Viewer, id: SQLWrapper): SQL {
return sql`(${readableActivity(viewer, id)} and ${readableObject(viewer, id)})`;
}
+/**
+ * Excludes deleted actors and objects, including resources authored or
+ * owned by deleted actors. Revisions do not use it: a deletion appends a
+ * whiteout, and the history before it stays readable, as
+ * {@link readableRevision} tells.
+ * @param id The resource ID in an outer query.
+ * @returns The condition on the ID.
+ */
+export function visibleResource(id: SQLWrapper): SQL {
+ return sql`not exists (
+ select 1 from ${actors} ${visibleOwners}
+ where ${visibleOwners.id} = ${id} and ${visibleOwners.deleted} is not null
+ ) and not exists (
+ select 1 from ${objects} ${ownedObjects}
+ join ${actors} ${visibleOwners} on ${visibleOwners.id} = ${ownedObjects.actorId}
+ where ${ownedObjects.id} = ${id}
+ and (${ownedObjects.deleted} is not null or ${visibleOwners.deleted} is not null)
+ ) and not exists (
+ select 1 from ${activities} ${ownedActivities}
+ join ${actors} ${visibleOwners} on ${visibleOwners.id} = ${ownedActivities.actorId}
+ where ${ownedActivities.id} = ${id} and ${visibleOwners.deleted} is not null
+ ) and not exists (
+ select 1 from ${collections} ${ownedCollections}
+ join ${actors} ${visibleOwners} on ${visibleOwners.id} = ${ownedCollections.ownerActorId}
+ where ${ownedCollections.id} = ${id} and ${visibleOwners.deleted} is not null
+ )`;
+}
+
+/**
+ * Matches a resource with a legacy typed row, whose readability
+ * {@link readableResource} decides by that row. It is the only place
+ * {@link readableRevision} reads legacy typed tables, so that it goes when
+ * they do.
+ * @param id The resource ID in an outer query.
+ * @returns The condition on the ID.
+ */
+function legacyTypedRow(id: SQLWrapper): SQL {
+ return sql`(exists (
+ select 1 from ${actors} ${typedActors} where ${typedActors.id} = ${id}
+ ) or exists (
+ select 1 from ${objects} ${typedObjects} where ${typedObjects.id} = ${id}
+ ) or exists (
+ select 1 from ${activities} ${typedActivities} where ${typedActivities.id} = ${id}
+ ) or exists (
+ select 1 from ${collections} ${typedCollections} where ${typedCollections.id} = ${id}
+ ))`;
+}
+
+/**
+ * Restricts revisions to those the viewer may read. An administrator reads
+ * every revision. Anyone else reads a revision by evidence of that
+ * particular revision, never by the current state of its resource:
+ *
+ * - DrFed saved it for a local actor, so it is readable by anyone, with
+ * its blind recipients and whether published or not, as
+ * `Object.document` is.
+ * - Its own addressing is public.
+ * - A receipt links it to an inbound delivery to a local instance the
+ * viewer may read, as {@link viewableInstance} tells.
+ * - It is the current revision of a resource with a legacy typed row that
+ * {@link readableResource} lets the viewer read, since that row
+ * describes only its current version.
+ *
+ * What a revision embeds, and the revisions its embedded documents came
+ * from, never decide whether it is readable: a document recording its
+ * sources reads as the same document pasted without them. Only following
+ * a source to its revision checks that revision.
+ *
+ * A later revision being restricted, or deleted, hides no earlier one that
+ * was public, and a later delivery or public revision of the same IRI opens
+ * no earlier private one. A revision of a deleted resource, or of one
+ * whose author is deleted, stays readable to whoever may read it.
+ * @param viewer The viewer and the database.
+ * @param id The revision ID in an outer query.
+ * @returns The condition on the ID.
+ */
+export function readableRevision(viewer: Viewer, id: SQLWrapper): SQL {
+ if (viewer.account?.admin === true) return sql`true`;
+ return sql`exists (
+ select 1 from ${resourceRevisions} ${evidenced}
+ where ${evidenced.id} = ${id} and (
+ ${evidenced.capture} = 'local'
+ or exists (
+ select 1 from ${revisionAddressing} ${evidencedAddressing}
+ where ${evidencedAddressing.revisionId} = ${evidenced.id}
+ and ${inArray(evidencedAddressing.iri, PUBLIC_IRIS)}
+ )
+ or exists (
+ select 1 from ${revisionReceipts} ${evidencedReceipts}
+ join ${activityDeliveries} ${receiptDeliveries}
+ on ${receiptDeliveries.id} = ${evidencedReceipts.deliveryId}
+ where ${evidencedReceipts.revisionId} = ${evidenced.id}
+ and ${receiptDeliveries.direction} = 'inbound'
+ and ${viewableInstance(viewer, receiptDeliveries.instanceId)}
+ )
+ or (
+ exists (
+ select 1 from ${resourceHeads} ${evidencedHeads}
+ where ${evidencedHeads.resourceId} = ${evidenced.resourceId}
+ and ${evidencedHeads.revisionId} = ${evidenced.id}
+ )
+ and ${legacyTypedRow(evidenced.resourceId)}
+ and ${readableResource(viewer, evidenced.resourceId)}
+ )
+ )
+ )`;
+}
+
+/**
+ * Restricts resources to those the viewer may know of as `Resource` nodes:
+ * those {@link readableResource} lets the viewer read, and those with a
+ * revision the viewer may read, as {@link readableRevision} tells. A
+ * resource's current state, which its legacy typed row describes, may be
+ * restricted after an earlier revision was public or received; that hides
+ * neither the revision nor the resource it is read through. The typed
+ * details of the resource still follow {@link readableResource}.
+ * @param viewer The viewer and the database.
+ * @param id The resource ID in an outer query.
+ * @returns The condition on the ID.
+ */
+export function readableResourceNode(viewer: Viewer, id: SQLWrapper): SQL {
+ if (viewer.account?.admin === true) return sql`true`;
+ return sql`(${readableResource(viewer, id)} or exists (
+ select 1 from ${resourceRevisions} ${listedRevisions}
+ where ${listedRevisions.resourceId} = ${id}
+ and ${readableRevision(viewer, listedRevisions.id)}
+ ))`;
+}
+
+/**
+ * Finds the revisions among the given IDs that the viewer may not read, as
+ * {@link readableRevision} decides. IDs of no stored revision are never
+ * among them. A local write takes it to check the sources a writer
+ * declares, so that a writer embeds as a snapshot or derivation only what
+ * they may read.
+ * @returns The IDs the viewer may not read.
+ */
+export async function unreadableRevisions(
+ viewer: Viewer,
+ ids: readonly Uuid[],
+): Promise> {
+ if (ids.length === 0 || viewer.account?.admin === true) return new Set();
+ const rows = await viewer.db
+ .select({ id: resourceRevisions.id })
+ .from(resourceRevisions)
+ .where(
+ and(
+ inArray(resourceRevisions.id, [...new Set(ids)]),
+ not(readableRevision(viewer, resourceRevisions.id)),
+ ),
+ );
+ return new Set(rows.map(({ id }) => id));
+}
+
/**
* Finds the resources among the given IDs that the viewer may not read, as
* {@link readableResource} decides. IDs of anything but a resource are never
@@ -232,30 +405,108 @@ export const isReadableResource = async (
id: Uuid,
): Promise => !(await unreadableResources(viewer, [id])).has(id);
-const nodeIdOf = (node: unknown): Uuid | null =>
+/**
+ * Finds the resources among the given IDs that the viewer may not know of as
+ * `Resource` nodes, as {@link readableResourceNode} decides. IDs of anything
+ * but a resource are never among them.
+ * @returns The IDs the viewer may not know of.
+ */
+export async function unreadableResourceNodes(
+ viewer: Viewer,
+ ids: readonly Uuid[],
+): Promise> {
+ if (ids.length === 0 || viewer.account?.admin === true) return new Set();
+ const rows = await viewer.db
+ .select({ id: resources.id })
+ .from(resources)
+ .where(
+ and(
+ inArray(resources.id, [...new Set(ids)]),
+ not(readableResourceNode(viewer, resources.id)),
+ ),
+ );
+ return new Set(rows.map(({ id }) => id));
+}
+
+/**
+ * Determines whether the viewer may know of the resource as a `Resource`
+ * node.
+ * @returns Whether {@link readableResourceNode} holds for it.
+ */
+export const isReadableResourceNode = async (
+ viewer: Viewer,
+ id: Uuid,
+): Promise => !(await unreadableResourceNodes(viewer, [id])).has(id);
+
+const uuidOf = (node: unknown, key: "id" | "resourceId"): Uuid | null =>
node != null &&
typeof node === "object" &&
- "id" in node &&
- validateUuid(node.id)
- ? node.id
+ key in node &&
+ validateUuid((node as Record)[key])
+ ? ((node as Record)[key] as Uuid)
: null;
+/**
+ * Tells the resource a Relay node belongs to without being its typed detail,
+ * as a revision belongs to its resource. Such a node is hidden by its own
+ * readability, as {@link readableRevision} tells, and nothing of its
+ * resource's, such as a deletion, hides it.
+ * @returns The resource ID, or null for any other node.
+ */
+export const owningResourceOf = (node: unknown): Uuid | null =>
+ uuidOf(node, "resourceId");
+
+/** How {@link hideUnreadableNodes} checks a node. */
+type NodeKind = "revision" | "resource" | "typed";
+
/**
* Replaces the Relay nodes the viewer may not read by null, as if they did
- * not exist. Activities, objects, and resources share their IDs, so a node's
- * ID alone tells whether it is one the viewer may not read.
+ * not exist. Activities, objects, and resources share their IDs, so the
+ * caller tells which nodes are `Resource` nodes, which are checked by
+ * {@link readableResourceNode}; the ID of any other node tells whether
+ * {@link readableResource} lets the viewer read it. A node that belongs to a
+ * resource, such as a revision, is checked by {@link readableRevision}
+ * instead, as {@link owningResourceOf} tells.
+ * @param viewer The viewer and the database.
+ * @param nodes The resolved nodes.
+ * @param resourceNodes Whether the node at each index is a `Resource` node.
* @returns The nodes, in the same order.
*/
export async function hideUnreadableNodes(
viewer: Viewer,
nodes: readonly unknown[],
+ resourceNodes: readonly boolean[] = [],
): Promise {
- const hidden = await unreadableResources(
- viewer,
- nodes.map(nodeIdOf).filter((id) => id != null),
- );
- return nodes.map((node) => {
- const id = nodeIdOf(node);
+ const kindOf = (node: unknown, index: number): NodeKind =>
+ owningResourceOf(node) != null
+ ? "revision"
+ : resourceNodes[index] === true
+ ? "resource"
+ : "typed";
+ const kinds = nodes.map((node, index) => kindOf(node, index));
+ const idsOf = (kind: NodeKind) =>
+ nodes.map((node, index) =>
+ kinds[index] === kind ? uuidOf(node, "id") : null,
+ );
+ const ids = {
+ revision: idsOf("revision"),
+ resource: idsOf("resource"),
+ typed: idsOf("typed"),
+ };
+ const present = (list: readonly (Uuid | null)[]) =>
+ list.filter((id) => id != null);
+ const [hiddenTyped, hiddenResources, hiddenRevisions] = await Promise.all([
+ unreadableResources(viewer, present(ids.typed)),
+ unreadableResourceNodes(viewer, present(ids.resource)),
+ unreadableRevisions(viewer, present(ids.revision)),
+ ]);
+ return nodes.map((node, index) => {
+ const kind: NodeKind = kinds[index] ?? "typed";
+ const id = ids[kind][index];
+ if (kind === "revision") {
+ return id == null || hiddenRevisions.has(id) ? null : node;
+ }
+ const hidden = kind === "resource" ? hiddenResources : hiddenTyped;
return id != null && hidden.has(id) ? null : node;
});
}
diff --git a/packages/graphql/src/resource.ts b/packages/graphql/src/resource.ts
index d7218b2c..6ba5ffd7 100644
--- a/packages/graphql/src/resource.ts
+++ b/packages/graphql/src/resource.ts
@@ -32,7 +32,9 @@ import {
import {
type Viewer,
isReadableResource,
+ isReadableResourceNode,
readableResource,
+ visibleResource,
} from "./readable.ts";
export const ResourceKind = builder.enumType("ResourceKind", {
@@ -356,10 +358,10 @@ const ActivityRef = builder.drizzleNode("activities", {
nullable: true,
description:
"The resource the activity acts on, or null when there is none or " +
- "the viewer may not read it.",
+ "the viewer may read neither it nor any of its revisions.",
select: { with: { object: true } },
resolve: async (row, _, ctx) =>
- row.object != null && (await isReadableResource(ctx, row.object.id))
+ row.object != null && (await isReadableResourceNode(ctx, row.object.id))
? row.object
: null,
}),
@@ -414,28 +416,3 @@ const ActivityRef = builder.drizzleNode("activities", {
});
export const Activity: DrFedObjectRef = ActivityRef;
registerAddressingFields("activities");
-
-/**
- * Excludes deleted actors and objects, including resources authored or
- * owned by deleted actors.
- * @returns A predicate for a resource ID in an outer query.
- */
-function visibleResource(id: SQLWrapper): SQL {
- return sql`not exists (
- select 1 from ${schema.actors}
- where ${schema.actors.id} = ${id} and ${schema.actors.deleted} is not null
- ) and not exists (
- select 1 from ${schema.objects}
- join ${schema.actors} on ${schema.actors.id} = ${schema.objects.actorId}
- where ${schema.objects.id} = ${id}
- and (${schema.objects.deleted} is not null or ${schema.actors.deleted} is not null)
- ) and not exists (
- select 1 from ${schema.activities}
- join ${schema.actors} on ${schema.actors.id} = ${schema.activities.actorId}
- where ${schema.activities.id} = ${id} and ${schema.actors.deleted} is not null
- ) and not exists (
- select 1 from ${schema.collections}
- join ${schema.actors} on ${schema.actors.id} = ${schema.collections.ownerActorId}
- where ${schema.collections.id} = ${id} and ${schema.actors.deleted} is not null
- )`;
-}
diff --git a/packages/graphql/src/revision.test.ts b/packages/graphql/src/revision.test.ts
new file mode 100644
index 00000000..40001ec8
--- /dev/null
+++ b/packages/graphql/src/revision.test.ts
@@ -0,0 +1,1631 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// Writes and pages depend on the ones before them.
+// oxlint-disable no-await-in-loop
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+
+import {
+ type CreateRequest,
+ type EmbeddedSource,
+ type JsonObject,
+ type LocalWriteEnvironment,
+ type LocalWriteRequest,
+ type PreviewOptions,
+ type SavedResource,
+ commitLocalWrite,
+ previewLocalWrite,
+} from "@drfed/federation/local-write";
+import { unreadableRevisions } from "@drfed/graphql/readable";
+import { type Database, schema } from "@drfed/models";
+import { PUBLIC_IRI, ensureResource } from "@drfed/models/resource";
+import {
+ appendResourceRevision,
+ captureLegacyResourceRevision,
+ loadCurrentResourceRevision,
+ writeTypedResourceRevision,
+} from "@drfed/models/resource-revision";
+import type { Account } from "@drfed/models/schema";
+import { type Uuid, uuidV7 } from "@drfed/models/uuid";
+import { eq } from "drizzle-orm";
+
+import { hashSecret } from "./auth/hash.ts";
+import { type TestHarness, withTestHarness } from "./harness.test.ts";
+import {
+ accountId,
+ created,
+ expires,
+ globalId,
+ localActorId,
+ localInstanceId,
+ remoteActorId,
+ seedAuthenticatedLocalInstance,
+ seedLocalActor,
+ seedObjects,
+ seedRemoteActor,
+} from "./seed.test.ts";
+
+const AS = "https://www.w3.org/ns/activitystreams";
+const ACTOR_IRI = `https://test-instance.drfed.org/users/${localActorId}`;
+const FEATURED_IRI = `${ACTOR_IRI}/featured`;
+const BLIND = "https://remote.example/users/blind";
+const PRINCIPAL = { accountId: accountId as Uuid };
+const ACTIVITY: CreateRequest["resources"] = [{ path: [], kind: "activity" }];
+const CAROL = "https://remote.example/users/carol";
+
+const revisionId = (id: string): string =>
+ Buffer.from(`ResourceRevision:${id}`).toString("base64");
+
+interface Writer {
+ readonly harness: TestHarness;
+ readonly env: LocalWriteEnvironment;
+ /** The account of the local instance's member, who writes. */
+ readonly account: Account;
+ readonly auth: RequestInit;
+ /**
+ * Saves new resources and returns their IDs and IRIs, root last. Declared
+ * sources are checked against what the writer may read.
+ */
+ save(
+ document: JsonObject,
+ resources?: CreateRequest["resources"],
+ sources?: readonly EmbeddedSource[],
+ ): Promise<{ id: Uuid; iri: string }[]>;
+ /** Commits an edit or deletion. */
+ change(request: LocalWriteRequest): Promise;
+ /** Sends a query, anonymously unless `init` authenticates it. */
+ query(
+ query: string,
+ variables?: Record,
+ init?: RequestInit,
+ ): Promise<{ data?: Record; errors?: unknown[] }>;
+}
+
+/**
+ * Checks declared sources as the GraphQL layer reads revisions for an
+ * account.
+ * @returns The options that pass the check to a local write.
+ */
+const readerOf = (db: Database, account: Account): PreviewOptions => ({
+ unreadableRevisions: (ids) => unreadableRevisions({ db, account }, ids),
+});
+
+async function withWriter(
+ // oxlint-disable-next-line promise/prefer-await-to-callbacks
+ callback: (writer: Writer) => Promise,
+): Promise {
+ await withTestHarness(async (harness) => {
+ const auth = await seedAuthenticatedLocalInstance(harness.db);
+ await seedLocalActor(harness.db);
+ const account = await harness.db.query.accounts.findFirst({
+ where: { id: accountId },
+ });
+ assert.ok(account != null);
+ const env: LocalWriteEnvironment = {
+ db: harness.db,
+ federation: harness.federation,
+ rootOrigin: new URL("https://drfed.org"),
+ previewKey: await crypto.subtle.generateKey(
+ { name: "HMAC", hash: "SHA-256" },
+ false,
+ ["sign", "verify"],
+ ),
+ };
+ const access = readerOf(harness.db, account);
+ const commit = async (request: LocalWriteRequest) => {
+ const preview = await previewLocalWrite(env, PRINCIPAL, request, access);
+ assert.ok(preview.ok, JSON.stringify(!preview.ok && preview.error));
+ const outcome = await commitLocalWrite(env, PRINCIPAL, request, {
+ ...access,
+ previewToken: preview.preview.token,
+ // Edits and deletions require a reservation; nothing is sent here.
+ ...(request.operation === "create"
+ ? {}
+ : { reserveDispatch: () => Promise.resolve() }),
+ });
+ assert.ok(outcome.ok, JSON.stringify(!outcome.ok && outcome.error));
+ return outcome.result;
+ };
+ // oxlint-disable-next-line promise/prefer-await-to-callbacks, node/callback-return
+ await callback({
+ harness,
+ env,
+ account,
+ auth,
+ async save(document, resources, sources) {
+ const result = await commit({
+ operation: "create",
+ actorId: localActorId,
+ document: { "@context": AS, ...document },
+ resources: resources ?? [{ path: [], kind: "object" }],
+ ...(sources == null ? {} : { sources }),
+ });
+ return result.resources.map(({ id, iri }) => ({ id, iri }));
+ },
+ async change(request) {
+ return (await commit(request)).resources;
+ },
+ async query(query, variables, init) {
+ const response = await harness.post(
+ { query, variables: variables ?? {} },
+ init,
+ );
+ return await response.json();
+ },
+ });
+ });
+}
+
+async function head(db: Database, id: Uuid) {
+ const revision = await loadCurrentResourceRevision(db, id);
+ assert.ok(revision != null);
+ return revision;
+}
+
+const edit = (
+ objectId: Uuid,
+ expectedRevisionId: Uuid,
+ document: JsonObject,
+): LocalWriteRequest => ({
+ operation: "edit",
+ actorId: localActorId,
+ objectId,
+ expectedRevisionId,
+ document,
+});
+
+const currentRoot = (selection: string): string =>
+ `query($id: ID!) { node(id: $id) { ... on Resource { currentRevision { root { ${selection} } } } } }`;
+
+describe("Resource.currentRevision", () => {
+ it("reads relations of embedded documents, as the Like in an Undo", async () => {
+ await withWriter(async ({ save, query }) => {
+ const [note] = await save({ type: "Note", content: "liked" });
+ assert.ok(note != null);
+ const [undo] = await save(
+ {
+ type: "Undo",
+ object: { type: "Like", actor: ACTOR_IRI, object: note.iri },
+ },
+ [{ path: [], kind: "activity" }],
+ );
+ assert.ok(undo != null);
+ const body = await query(
+ currentRoot(`
+ type kind iri
+ relations(property: object) {
+ property path representation iri resource { iri }
+ node {
+ path property type kind iri
+ relations(property: object) {
+ path representation iri node { type }
+ resource { iri kind currentRevision { root { type } } }
+ }
+ }
+ }`),
+ { id: globalId("Resource", undo.id) },
+ );
+ assert.equal(body.errors, undefined);
+ assert.deepEqual(body.data?.node.currentRevision.root, {
+ type: `${AS}#Undo`,
+ kind: "activity",
+ iri: undo.iri,
+ relations: [
+ {
+ property: "object",
+ path: ["object"],
+ representation: "embedded",
+ iri: null,
+ resource: null,
+ node: {
+ path: ["object"],
+ property: "object",
+ type: `${AS}#Like`,
+ kind: "activity",
+ iri: null,
+ relations: [
+ {
+ path: ["object", "object"],
+ representation: "reference",
+ iri: note.iri,
+ node: null,
+ resource: {
+ iri: note.iri,
+ kind: "object",
+ currentRevision: { root: { type: `${AS}#Note` } },
+ },
+ },
+ ],
+ },
+ },
+ ],
+ });
+ });
+ });
+
+ it("keeps an embedded version while the resource shows its edited one", async () => {
+ await withWriter(async ({ harness, save, change, query }) => {
+ const [note, create] = await save(
+ {
+ type: "Create",
+ to: [PUBLIC_IRI],
+ object: { type: "Note", content: "A", to: [PUBLIC_IRI] },
+ },
+ [
+ { path: [], kind: "activity" },
+ { path: ["object"], kind: "object" },
+ ],
+ );
+ assert.ok(note != null && create != null);
+ const saved = await head(harness.db, note.id);
+ await change(
+ edit(note.id, saved.id, {
+ ...(saved.document as JsonObject),
+ content: "B",
+ }),
+ );
+ const body = await query(
+ currentRoot(`relations(property: object) {
+ representation iri
+ node { document }
+ resource { currentRevision { sequence document } }
+ }`),
+ { id: globalId("Resource", create.id) },
+ );
+ assert.equal(body.errors, undefined);
+ assert.ok(body.data != null);
+ const [relation] = body.data.node.currentRevision.root.relations;
+ assert.equal(relation.representation, "embedded");
+ assert.equal(relation.iri, note.iri);
+ assert.equal(relation.node.document.content, "A");
+ assert.equal(relation.resource.currentRevision.sequence, 2);
+ assert.equal(relation.resource.currentRevision.document.content, "B");
+ });
+ });
+
+ it("reads no object of an intransitive activity", async () => {
+ await withWriter(async ({ save, query }) => {
+ const [arrive] = await save({ type: "Arrive" }, [
+ { path: [], kind: "activity" },
+ ]);
+ assert.ok(arrive != null);
+ const body = await query(
+ currentRoot(`
+ objects: relations(property: object) { iri }
+ actors: relations(property: actor) {
+ representation iri resource { kind }
+ }`),
+ { id: globalId("Resource", arrive.id) },
+ );
+ assert.deepEqual(body, {
+ data: {
+ node: {
+ currentRevision: {
+ root: {
+ objects: [],
+ actors: [
+ {
+ representation: "reference",
+ iri: ACTOR_IRI,
+ resource: { kind: "actor" },
+ },
+ ],
+ },
+ },
+ },
+ },
+ });
+ });
+ });
+
+ it("reads the collection target of an Add", async () => {
+ await withWriter(async ({ save, query }) => {
+ const [note] = await save({ type: "Note", content: "featured" });
+ assert.ok(note != null);
+ const [add] = await save(
+ {
+ type: "Add",
+ object: note.iri,
+ target: { type: "OrderedCollection", id: FEATURED_IRI },
+ },
+ [{ path: [], kind: "activity" }],
+ );
+ assert.ok(add != null);
+ const body = await query(
+ currentRoot(`relations(property: target) {
+ representation iri node { kind type } resource { kind iri }
+ }`),
+ { id: globalId("Resource", add.id) },
+ );
+ assert.deepEqual(body.data?.node.currentRevision.root.relations, [
+ {
+ representation: "embedded",
+ iri: FEATURED_IRI,
+ node: { kind: "collection", type: `${AS}#OrderedCollection` },
+ resource: { kind: "collection", iri: FEATURED_IRI },
+ },
+ ]);
+ });
+ });
+
+ it("tells unregistered IRIs from registered ones of an unknown kind", async () => {
+ await withWriter(async ({ harness, save, query }) => {
+ const unregistered = "https://remote.example/unregistered";
+ const unknown = "https://remote.example/unknown";
+ await ensureResource(harness.db, unknown);
+ const [undo] = await save(
+ {
+ type: "Undo",
+ object: [
+ { type: "Like", object: unregistered },
+ { type: "Like", object: unknown },
+ ],
+ },
+ [{ path: [], kind: "activity" }],
+ );
+ assert.ok(undo != null);
+ const body = await query(
+ currentRoot(`relations(property: object) {
+ path node { relations { iri resource { iri kind } } }
+ }`),
+ { id: globalId("Resource", undo.id) },
+ );
+ assert.deepEqual(body.data?.node.currentRevision.root.relations, [
+ {
+ path: ["object", 0],
+ node: { relations: [{ iri: unregistered, resource: null }] },
+ },
+ {
+ path: ["object", 1],
+ node: {
+ relations: [
+ { iri: unknown, resource: { iri: unknown, kind: "unknown" } },
+ ],
+ },
+ },
+ ]);
+ });
+ });
+
+ it("returns a document with a context outside the offline allowlist uninterpreted", async () => {
+ await withWriter(async ({ harness, query }) => {
+ const resource = await ensureResource(
+ harness.db,
+ `${ACTOR_IRI}/${uuidV7()}`,
+ );
+ const document = {
+ "@context": [AS, "https://context.example/ns"],
+ id: resource.iri,
+ type: "Note",
+ content: "contextual",
+ };
+ await appendResourceRevision(harness.db, {
+ resourceId: resource.id,
+ resourceKind: "object",
+ expectedRevisionId: null,
+ kind: "snapshot",
+ capture: "local",
+ document,
+ });
+ const body = await query(
+ `query($id: ID!) { node(id: $id) { ... on Resource { currentRevision {
+ kind capture interpreted root { type } document
+ diagnostics { reason category severity path }
+ } } } }`,
+ { id: globalId("Resource", resource.id) },
+ );
+ assert.deepEqual(body, {
+ data: {
+ node: {
+ currentRevision: {
+ kind: "snapshot",
+ capture: "local",
+ interpreted: false,
+ root: null,
+ document,
+ diagnostics: [
+ {
+ reason: "context_unavailable_offline",
+ category: "support",
+ severity: "error",
+ path: ["@context", 1],
+ },
+ ],
+ },
+ },
+ },
+ });
+ });
+ });
+
+ it("returns a document with an unsupported property uninterpreted", async () => {
+ await withWriter(async ({ harness, query }) => {
+ const resource = await ensureResource(
+ harness.db,
+ `${ACTOR_IRI}/${uuidV7()}`,
+ );
+ const document = {
+ "@context": AS,
+ id: resource.iri,
+ type: "Note",
+ content: "tagged",
+ tag: [{ type: "Mention", href: ACTOR_IRI }],
+ };
+ await appendResourceRevision(harness.db, {
+ resourceId: resource.id,
+ resourceKind: "object",
+ expectedRevisionId: null,
+ kind: "snapshot",
+ capture: "local",
+ document,
+ });
+ const body = await query(
+ `query($id: ID!) { node(id: $id) { ... on Resource { currentRevision {
+ interpreted root { type } document diagnostics { reason category severity path }
+ } } } }`,
+ { id: globalId("Resource", resource.id) },
+ );
+ assert.deepEqual(body, {
+ data: {
+ node: {
+ currentRevision: {
+ interpreted: false,
+ root: null,
+ document,
+ diagnostics: [
+ {
+ reason: "unsupported_property",
+ category: "support",
+ severity: "error",
+ path: ["tag"],
+ },
+ ],
+ },
+ },
+ },
+ });
+ });
+ });
+
+ it("shows anyone the blind recipients of a local resource", async () => {
+ await withWriter(async ({ save, query }) => {
+ const [note] = await save({
+ type: "Note",
+ content: "secret",
+ to: [PUBLIC_IRI],
+ bto: [BLIND],
+ bcc: [{ type: "Person", id: BLIND }, BLIND],
+ });
+ assert.ok(note != null);
+ const body = await query(
+ `query($id: ID!) { node(id: $id) { ... on Resource { currentRevision {
+ document
+ root {
+ addressing { property position path representation iri }
+ bcc: addressing(property: bcc) { iri resource { kind } }
+ }
+ } } } }`,
+ { id: globalId("Resource", note.id) },
+ );
+ assert.equal(body.errors, undefined);
+ const revision = body.data?.node.currentRevision;
+ assert.deepEqual(revision.document.bto, [BLIND]);
+ assert.deepEqual(revision.document.bcc, [
+ { type: "Person", id: BLIND },
+ BLIND,
+ ]);
+ assert.deepEqual(revision.root.addressing, [
+ {
+ property: "to",
+ position: 0,
+ path: ["to", 0],
+ representation: "reference",
+ iri: PUBLIC_IRI,
+ },
+ {
+ property: "bto",
+ position: 0,
+ path: ["bto", 0],
+ representation: "reference",
+ iri: BLIND,
+ },
+ {
+ property: "bcc",
+ position: 0,
+ path: ["bcc", 0],
+ representation: "embedded",
+ iri: BLIND,
+ },
+ {
+ property: "bcc",
+ position: 1,
+ path: ["bcc", 1],
+ representation: "reference",
+ iri: BLIND,
+ },
+ ]);
+ assert.deepEqual(revision.root.bcc, [
+ { iri: BLIND, resource: { kind: "unknown" } },
+ { iri: BLIND, resource: { kind: "unknown" } },
+ ]);
+ });
+ });
+
+ it("returns custom extension properties by their source keys", async () => {
+ await withWriter(async ({ save, query }) => {
+ const [note] = await save({
+ "@context": [AS, { ex: "https://ext.example/ns#" }],
+ type: "Note",
+ content: "extended",
+ "ex:mood": { level: 3 },
+ });
+ assert.ok(note != null);
+ const body = await query(currentRoot("extensions { key value }"), {
+ id: globalId("Resource", note.id),
+ });
+ assert.deepEqual(body.data?.node.currentRevision.root.extensions, [
+ { key: "ex:mood", value: { level: 3 } },
+ ]);
+ });
+ });
+});
+
+describe("Resource.revisions", () => {
+ it("pages revisions newest first and rejects an invalid cursor", async () => {
+ await withWriter(async ({ harness, save, change, query }) => {
+ const [note] = await save({ type: "Note", content: "1" });
+ assert.ok(note != null);
+ for (const content of ["2", "3"]) {
+ const current = await head(harness.db, note.id);
+ await change(
+ edit(note.id, current.id, {
+ ...(current.document as JsonObject),
+ content,
+ }),
+ );
+ }
+ const page = `query($id: ID!, $first: Int, $after: String, $last: Int, $before: String) {
+ node(id: $id) { ... on Resource {
+ revisions(first: $first, after: $after, last: $last, before: $before) {
+ edges { cursor node { sequence document } }
+ pageInfo { hasNextPage hasPreviousPage }
+ }
+ } }
+ }`;
+ const id = globalId("Resource", note.id);
+ const seen: [number, string][] = [];
+ let after: string | undefined;
+ for (let index = 0; index < 5; index += 1) {
+ const body = await query(page, { id, first: 1, after });
+ assert.equal(body.errors, undefined);
+ assert.ok(body.data != null);
+ const { edges, pageInfo } = body.data.node.revisions;
+ assert.equal(edges.length, 1);
+ seen.push([edges[0].node.sequence, edges[0].node.document.content]);
+ if (!pageInfo.hasNextPage) break;
+ after = edges[0].cursor;
+ }
+ assert.deepEqual(seen, [
+ [3, "3"],
+ [2, "2"],
+ [1, "1"],
+ ]);
+ const last = await query(page, { id, last: 2 });
+ assert.deepEqual(
+ last.data?.node.revisions.edges.map(
+ ({ node }: { node: { sequence: number } }) => node.sequence,
+ ),
+ [2, 1],
+ );
+ assert.equal(last.data?.node.revisions.pageInfo.hasPreviousPage, true);
+ for (const cursor of [
+ "invalid",
+ Buffer.from("DC:x").toString("base64"),
+ ]) {
+ const invalid = await query(page, { id, first: 1, after: cursor });
+ assert.ok((invalid.errors?.length ?? 0) > 0);
+ }
+ });
+ });
+
+ it("ends with a whiteout whose former types are IRIs", async () => {
+ await withWriter(async ({ harness, save, change, query }) => {
+ const [note] = await save({ type: "Note", content: "gone" });
+ assert.ok(note != null);
+ const current = await head(harness.db, note.id);
+ await change({
+ operation: "delete",
+ actorId: localActorId,
+ objectId: note.id,
+ expectedRevisionId: current.id,
+ });
+ const whiteout = await head(harness.db, note.id);
+ const fields = `kind deleted formerTypes document interpreted root { type } diagnostics { reason }`;
+ const body = await query(
+ `query($id: ID!, $revision: ID!) {
+ node(id: $id) { ... on Resource {
+ currentRevision { id ${fields} }
+ revisions { edges { node { kind } } }
+ } }
+ revision: node(id: $revision) { ... on ResourceRevision { ${fields} resource { iri } } }
+ }`,
+ {
+ id: globalId("Resource", note.id),
+ revision: revisionId(whiteout.id),
+ },
+ );
+ assert.equal(body.errors, undefined);
+ const expected = {
+ kind: "whiteout",
+ deleted: whiteout.deleted?.toString(),
+ formerTypes: [`${AS}#Note`],
+ document: null,
+ interpreted: false,
+ root: null,
+ diagnostics: [],
+ };
+ assert.deepEqual(body.data?.node.currentRevision, {
+ id: revisionId(whiteout.id),
+ ...expected,
+ });
+ assert.deepEqual(body.data?.node.revisions.edges, [
+ { node: { kind: "whiteout" } },
+ { node: { kind: "snapshot" } },
+ ]);
+ // A whiteout's own deletion time does not hide it as a node.
+ assert.deepEqual(body.data?.revision, {
+ ...expected,
+ resource: { iri: note.iri },
+ });
+ });
+ });
+});
+
+describe("Access to revisions", () => {
+ // The rules for remote resources are still those of their legacy typed
+ // rows, so this fixture builds them.
+ it("follows the rule of a remote resource the viewer may not read", async () => {
+ await withWriter(async ({ harness, auth, query }) => {
+ const { db } = harness;
+ await seedRemoteActor(db);
+ const remoteId = uuidV7();
+ const remoteIri = `https://remote.example.com/notes/${remoteId}`;
+ await seedObjects(db, {
+ id: remoteId,
+ actorId: remoteActorId,
+ type: "Note",
+ iri: remoteIri,
+ contentHtml: "private",
+ document: { type: "Note", content: "private" },
+ addressing: { to: ["https://remote.example.com/users/carol"] },
+ });
+ const revision = await db.transaction((tx) =>
+ captureLegacyResourceRevision(tx, remoteId),
+ );
+ // A local note addresses the remote one, which reaches its resource.
+ const localId = uuidV7();
+ await seedObjects(db, {
+ id: localId,
+ actorId: localActorId,
+ type: "Note",
+ iri: `${ACTOR_IRI}/${localId}`,
+ contentHtml: "public",
+ addressing: { to: [remoteIri] },
+ });
+ const read = `query($local: ID!, $revision: ID!) {
+ local: node(id: $local) { ... on Object { to {
+ iri currentRevision { document } revisions { edges { node { document } } }
+ } } }
+ revision: node(id: $revision) { ... on ResourceRevision { document } }
+ revisions: nodes(ids: [$revision]) { id }
+ }`;
+ const variables = {
+ local: globalId("Object", localId),
+ revision: revisionId(revision),
+ };
+ // Neither an anonymous viewer nor a member of an instance that did not
+ // receive it may read it.
+ for (const init of [undefined, auth]) {
+ assert.deepEqual(await query(read, variables, init), {
+ data: {
+ local: {
+ to: [
+ {
+ iri: remoteIri,
+ currentRevision: null,
+ revisions: { edges: [] },
+ },
+ ],
+ },
+ revision: null,
+ revisions: [null],
+ },
+ });
+ }
+ });
+ });
+
+ // Deletion hides typed rows from their existing fields, so the fixture
+ // builds one to tell that it hides no revision; a resource without typed
+ // rows is covered by the whiteout test above.
+ it("keeps the history of a deleted object and author readable", async () => {
+ await withWriter(async ({ harness, auth, save, query }) => {
+ const { db } = harness;
+ const noteId = uuidV7();
+ const noteIri = `${ACTOR_IRI}/notes/${noteId}`;
+ const document = {
+ "@context": AS,
+ id: noteIri,
+ type: "Note",
+ content: "deleted contents",
+ };
+ await seedObjects(db, {
+ id: noteId,
+ actorId: localActorId,
+ type: "Note",
+ iri: noteIri,
+ contentHtml: "deleted contents",
+ document,
+ });
+ const snapshot = await db.transaction((tx) =>
+ captureLegacyResourceRevision(tx, noteId),
+ );
+ const [like] = await save({ type: "Like", object: noteIri }, [
+ { path: [], kind: "activity" },
+ ]);
+ assert.ok(like != null);
+ await writeTypedResourceRevision(db, {
+ resourceId: noteId,
+ expectedRevisionId: snapshot,
+ kind: "whiteout",
+ deleted: Temporal.Now.instant(),
+ formerTypes: ["Note"],
+ });
+ const read = `query($note: ID!, $revision: ID!, $like: ID!) {
+ note: node(id: $note) { ... on Resource {
+ detail { __typename }
+ currentRevision { kind }
+ revisions { edges { node { kind document } } }
+ } }
+ revision: node(id: $revision) { ... on ResourceRevision { document } }
+ like: node(id: $like) { ... on Resource { currentRevision { root {
+ relations(property: object) { iri resource { iri } }
+ } } } }
+ }`;
+ const variables = {
+ note: globalId("Resource", noteId),
+ revision: revisionId(snapshot),
+ like: globalId("Resource", like.id),
+ };
+ const expected = {
+ data: {
+ note: {
+ // The existing fields keep hiding what was deleted.
+ detail: null,
+ currentRevision: { kind: "whiteout" },
+ revisions: {
+ edges: [
+ { node: { kind: "whiteout", document: null } },
+ { node: { kind: "snapshot", document } },
+ ],
+ },
+ },
+ revision: { document },
+ like: {
+ currentRevision: {
+ root: {
+ relations: [{ iri: noteIri, resource: { iri: noteIri } }],
+ },
+ },
+ },
+ },
+ };
+ for (const init of [undefined, auth]) {
+ assert.deepEqual(await query(read, variables, init), expected);
+ }
+ // Nor does deleting the author hide the history.
+ await db
+ .update(schema.actors)
+ .set({ deleted: Temporal.Now.instant() })
+ .where(eq(schema.actors.id, localActorId));
+ assert.deepEqual(await query(read, variables), expected);
+ });
+ });
+
+ it("keeps the history of a generic resource received from elsewhere closed", async () => {
+ await withWriter(async ({ harness, auth, save }) => {
+ const resource = await ensureResource(
+ harness.db,
+ `https://remote.example/generic/${uuidV7()}`,
+ );
+ const received = await appendResourceRevision(harness.db, {
+ resourceId: resource.id,
+ resourceKind: "object",
+ expectedRevisionId: null,
+ kind: "snapshot",
+ capture: "received",
+ document: {
+ "@context": AS,
+ id: resource.iri,
+ type: "Note",
+ content: "private revision contents",
+ },
+ });
+ const [like] = await save({ type: "Like", object: resource.iri }, [
+ { path: [], kind: "activity" },
+ ]);
+ assert.ok(like != null);
+ const history =
+ "iri kind currentRevision { document } revisions { edges { node { document } } }";
+ const read = `query($id: ID!, $revision: ID!, $like: ID!) {
+ node(id: $id) { ... on Resource { ${history} } }
+ revision: node(id: $revision) { ... on ResourceRevision { document } }
+ like: node(id: $like) { ... on Resource { currentRevision { root {
+ relations(property: object) { resource { ${history} } }
+ } } } }
+ }`;
+ const variables = {
+ id: globalId("Resource", resource.id),
+ revision: revisionId(received.id),
+ like: globalId("Resource", like.id),
+ };
+ const closed = {
+ iri: resource.iri,
+ kind: "object",
+ currentRevision: null,
+ revisions: { edges: [] },
+ };
+ for (const init of [undefined, auth]) {
+ const response = await harness.post({ query: read, variables }, init);
+ const text = await response.text();
+ assert.ok(!text.includes("private revision contents"));
+ assert.deepEqual(JSON.parse(text), {
+ data: {
+ node: closed,
+ revision: null,
+ like: {
+ currentRevision: {
+ root: { relations: [{ resource: closed }] },
+ },
+ },
+ },
+ });
+ }
+ });
+ });
+});
+
+/**
+ * Signs in an account: an administrator, an accepted member of the given
+ * local instance, or one that is neither.
+ * @returns Its account and the request options that authenticate as it.
+ */
+async function seedViewer(
+ db: Database,
+ { admin = false, memberOf }: { admin?: boolean; memberOf?: Uuid } = {},
+): Promise<{ account: Account; auth: RequestInit }> {
+ const id = uuidV7();
+ const token = `token-${id}`;
+ const [account] = await db
+ .insert(schema.accounts)
+ .values({
+ id,
+ email: `${id}@example.com`,
+ name: admin ? "Admin" : "Viewer",
+ admin,
+ created,
+ })
+ .returning();
+ assert.ok(account != null);
+ await db.insert(schema.sessions).values({
+ id: uuidV7(),
+ accountId: id,
+ tokenHash: await hashSecret(token),
+ });
+ if (memberOf != null) {
+ await db.insert(schema.instanceMembers).values({
+ accountId: id,
+ instanceId: memberOf,
+ accepted: created,
+ created,
+ });
+ }
+ return { account, auth: { headers: { authorization: `Bearer ${token}` } } };
+}
+
+/**
+ * Opens a second workspace, a local instance apart from the writer's.
+ * @returns Its instance ID.
+ */
+async function seedWorkspace(db: Database): Promise {
+ const id = uuidV7();
+ await db
+ .insert(schema.localInstances)
+ .values({ id, slug: "workspace-b", expires });
+ await db
+ .insert(schema.instances)
+ .values({ id, localId: id, created, host: "workspace-b.drfed.org" });
+ return id;
+}
+
+/**
+ * Stores a revision received from elsewhere, addressed as given.
+ * @returns Its resource's IRI and the revision ID.
+ */
+async function receive(
+ db: Database,
+ iri: string,
+ to: readonly string[],
+ content: string,
+): Promise<{ resourceId: Uuid; revisionId: Uuid }> {
+ const resource = await ensureResource(db, iri);
+ const current = await loadCurrentResourceRevision(db, resource.id);
+ const revision = await appendResourceRevision(db, {
+ resourceId: resource.id,
+ resourceKind: "object",
+ expectedRevisionId: current?.id ?? null,
+ kind: "snapshot",
+ capture: "received",
+ document: { "@context": AS, id: iri, type: "Note", content, to: [...to] },
+ addressing: { to: [...to] },
+ });
+ return { resourceId: resource.id, revisionId: revision.id };
+}
+
+/** Links a revision to an inbound delivery to a local instance. */
+async function receipt(
+ db: Database,
+ revision: Uuid,
+ instanceId: Uuid = localInstanceId,
+): Promise {
+ const deliveryId = uuidV7();
+ await db.insert(schema.activityDeliveries).values({
+ id: deliveryId,
+ instanceId,
+ direction: "inbound",
+ status: "received",
+ verificationResult: "verified",
+ inboxUrl: `${ACTOR_IRI}/inbox`,
+ body: Buffer.from(""),
+ completed: Temporal.Now.instant(),
+ });
+ await db
+ .insert(schema.revisionReceipts)
+ .values({ deliveryId, revisionId: revision, role: "object" });
+}
+
+/**
+ * Saves a local activity that embeds a document as its `object`, with the
+ * embedding recorded when a source is given. It records the source
+ * directly, without the check a local write makes, as if the writer could
+ * read the source when saving and may not any more.
+ * @returns The activity's resource ID, IRI, and revision ID.
+ */
+async function embed(
+ db: Database,
+ type: string,
+ object: JsonObject,
+ source?: { revisionId: Uuid; relation: "snapshot" | "derived" },
+): Promise<{ resourceId: Uuid; iri: string; revisionId: Uuid }> {
+ const resource = await ensureResource(db, `${ACTOR_IRI}/${uuidV7()}`);
+ const revision = await appendResourceRevision(db, {
+ resourceId: resource.id,
+ resourceKind: "activity",
+ expectedRevisionId: null,
+ kind: "snapshot",
+ capture: "local",
+ document: {
+ "@context": AS,
+ id: resource.iri,
+ type,
+ actor: ACTOR_IRI,
+ object,
+ },
+ ...(source == null
+ ? {}
+ : {
+ embeddings: [
+ {
+ path: ["object"],
+ sourceRevisionId: source.revisionId,
+ relation: source.relation,
+ },
+ ],
+ }),
+ });
+ return {
+ resourceId: resource.id,
+ iri: resource.iri,
+ revisionId: revision.id,
+ };
+}
+
+const withoutContext = ({ "@context": _, ...rest }: JsonObject): JsonObject =>
+ rest;
+
+/**
+ * Replaces an IRI in a response, to compare two responses about resources
+ * that differ only in their IRIs.
+ * @returns The response with the IRI replaced.
+ */
+const withoutIri = (value: unknown, iri: string): unknown =>
+ JSON.parse(JSON.stringify(value).replaceAll(iri, ""));
+
+describe("Access to revisions across workspaces", () => {
+ // Workspace A is the writer's local instance; only workspace B received a
+ // private Note from elsewhere.
+ const privateNote = async (db: Database) => {
+ const workspaceB = await seedWorkspace(db);
+ const iri = `https://remote.example/notes/${uuidV7()}`;
+ const received = await receive(
+ db,
+ iri,
+ [`${CAROL}/followers`],
+ "only workspace B received this",
+ );
+ await receipt(db, received.revisionId, workspaceB);
+ const stored = await head(db, received.resourceId);
+ return {
+ workspaceB,
+ ...received,
+ embedded: withoutContext(stored.document as JsonObject),
+ };
+ };
+
+ it("hides a revision only B received from A, but no local document embedding it", async () => {
+ await withWriter(async ({ harness, auth, query }) => {
+ const { db } = harness;
+ const note = await privateNote(db);
+ const memberB = await seedViewer(db, { memberOf: note.workspaceB });
+ const outsider = await seedViewer(db);
+ const admin = await seedViewer(db, { admin: true });
+ const sourced = await embed(db, "Like", note.embedded, {
+ revisionId: note.revisionId,
+ relation: "snapshot",
+ });
+ const pasted = await embed(db, "Like", note.embedded);
+ const read = `query($note: ID!, $revision: ID!, $sourced: ID!, $pasted: ID!) {
+ note: node(id: $note) { ... on Resource {
+ currentRevision { id }
+ revision(sequence: 1) { id }
+ revisions { edges { node { id } } pageInfo { hasNextPage } }
+ } }
+ revision: node(id: $revision) { ... on ResourceRevision { sequence } }
+ revisions: nodes(ids: [$revision]) { id }
+ sourced: node(id: $sourced) { ...embedding }
+ pasted: node(id: $pasted) { ...embedding }
+ }
+ fragment embedding on Resource { currentRevision {
+ document
+ root { relations(property: object) { node {
+ document
+ source { relation status revision { id } }
+ } } }
+ } }`;
+ const own = revisionId(note.revisionId);
+ const variables = {
+ note: globalId("Resource", note.resourceId),
+ revision: own,
+ sourced: globalId("Resource", sourced.resourceId),
+ pasted: globalId("Resource", pasted.resourceId),
+ };
+ const copy = async (resourceId: Uuid, source: unknown) => ({
+ currentRevision: {
+ document: (await head(db, resourceId)).document,
+ root: {
+ relations: [{ node: { document: note.embedded, source } }],
+ },
+ },
+ });
+ const closed = {
+ data: {
+ note: {
+ currentRevision: null,
+ revision: null,
+ revisions: { edges: [], pageInfo: { hasNextPage: false } },
+ },
+ revision: null,
+ revisions: [null],
+ sourced: await copy(sourced.resourceId, null),
+ pasted: await copy(pasted.resourceId, null),
+ },
+ };
+ const open = {
+ data: {
+ note: {
+ currentRevision: { id: own },
+ revision: { id: own },
+ revisions: {
+ edges: [{ node: { id: own } }],
+ pageInfo: { hasNextPage: false },
+ },
+ },
+ revision: { sequence: 1 },
+ revisions: [{ id: own }],
+ sourced: await copy(sourced.resourceId, {
+ relation: "snapshot",
+ status: "current",
+ revision: { id: own },
+ }),
+ pasted: await copy(pasted.resourceId, null),
+ },
+ };
+ // Neither a member of A, nor of no workspace, nor anyone anonymous may
+ // read the revision, even by its ID alone; the local documents that
+ // embed it stay whole, and the one that recorded it as its source
+ // reads as the pasted one, but for its IRI.
+ for (const init of [undefined, auth, outsider.auth]) {
+ const response = await harness.post({ query: read, variables }, init);
+ const text = await response.text();
+ assert.ok(!text.includes(own));
+ const body = JSON.parse(text);
+ assert.deepEqual(body, closed);
+ assert.deepEqual(
+ withoutIri(body.data.sourced, sourced.iri),
+ withoutIri(body.data.pasted, pasted.iri),
+ );
+ }
+ for (const init of [memberB.auth, admin.auth]) {
+ assert.deepEqual(await query(read, variables, init), open);
+ }
+ });
+ });
+
+ it("refuses a member of A to embed a revision only B received as a source", async () => {
+ await withWriter(async ({ harness, env, account, save }) => {
+ const { db } = harness;
+ const note = await privateNote(db);
+ const memberB = await seedViewer(db, { memberOf: note.workspaceB });
+ const admin = await seedViewer(db, { admin: true });
+ const like = (revision: Uuid): LocalWriteRequest => ({
+ operation: "create",
+ actorId: localActorId,
+ document: {
+ "@context": AS,
+ type: "Like",
+ object: note.embedded,
+ to: [PUBLIC_IRI],
+ },
+ resources: ACTIVITY,
+ sources: [{ path: ["object"], revisionId: revision }],
+ });
+ const access = readerOf(db, account);
+ const refused = await previewLocalWrite(
+ env,
+ PRINCIPAL,
+ like(note.revisionId),
+ access,
+ );
+ assert.ok(!refused.ok);
+ assert.equal(refused.error.type, "source_unavailable");
+ assert.deepEqual(
+ refused.error.diagnostics.map(({ path }) => path),
+ [["object"]],
+ );
+ // It fails as a revision that does not exist does.
+ assert.deepEqual(
+ await previewLocalWrite(env, PRINCIPAL, like(uuidV7()), access),
+ refused,
+ );
+ // Pasting it without a source is not refused.
+ await save(
+ { type: "Like", object: note.embedded, to: [PUBLIC_IRI] },
+ ACTIVITY,
+ );
+ // Members of B and administrators may read it, so may declare it.
+ assert.deepEqual(
+ await unreadableRevisions({ db, account }, [note.revisionId]),
+ new Set([note.revisionId]),
+ );
+ for (const viewer of [memberB, admin]) {
+ assert.deepEqual(
+ await unreadableRevisions({ db, account: viewer.account }, [
+ note.revisionId,
+ ]),
+ new Set(),
+ );
+ }
+ });
+ });
+});
+
+describe("Access to revisions by their own evidence", () => {
+ it("opens no earlier private revision by a later public one, nor tells of it by paging", async () => {
+ await withWriter(async ({ harness, query }) => {
+ const { db } = harness;
+ const workspaceB = await seedWorkspace(db);
+ const memberB = await seedViewer(db, { memberOf: workspaceB });
+ const iri = `https://remote.example/notes/${uuidV7()}`;
+ await receive(db, iri, [PUBLIC_IRI], "public at first");
+ const hidden = await receive(db, iri, [CAROL], "private");
+ await receipt(db, hidden.revisionId, workspaceB);
+ await receive(db, iri, [PUBLIC_IRI], "public again");
+ const read = `query($id: ID!, $first: Int, $after: String) {
+ node(id: $id) { ... on Resource {
+ currentRevision { sequence }
+ revision(sequence: 2) { sequence }
+ revisions(first: $first, after: $after) {
+ edges { cursor node { sequence } }
+ pageInfo { hasNextPage }
+ }
+ } }
+ }`;
+ const id = globalId("Resource", hidden.resourceId);
+ const page = async (
+ init: RequestInit | undefined,
+ first: number,
+ after?: string,
+ ) => {
+ const body = await query(read, { id, first, after }, init);
+ assert.equal(body.errors, undefined);
+ assert.ok(body.data != null);
+ const { currentRevision, revision, revisions } = body.data.node;
+ return {
+ currentRevision,
+ revision,
+ sequences: revisions.edges.map(
+ ({ node }: { node: { sequence: number } }) => node.sequence,
+ ),
+ cursor: revisions.edges.at(-1)?.cursor as string | undefined,
+ hasNextPage: revisions.pageInfo.hasNextPage,
+ };
+ };
+ const both = await page(undefined, 2);
+ assert.deepEqual(
+ { ...both, cursor: undefined },
+ {
+ currentRevision: { sequence: 3 },
+ revision: null,
+ sequences: [3, 1],
+ cursor: undefined,
+ hasNextPage: false,
+ },
+ );
+ // Pages of one revision skip the private one as if it did not exist.
+ const first = await page(undefined, 1);
+ assert.deepEqual([first.sequences, first.hasNextPage], [[3], true]);
+ const second = await page(undefined, 1, first.cursor);
+ assert.deepEqual([second.sequences, second.hasNextPage], [[1], false]);
+ const forB = await page(memberB.auth, 2);
+ assert.deepEqual(
+ [forB.revision, forB.sequences, forB.hasNextPage],
+ [{ sequence: 2 }, [3, 2], true],
+ );
+ });
+ });
+
+ it("keeps an earlier public revision readable after a private one", async () => {
+ await withWriter(async ({ harness, query }) => {
+ const { db } = harness;
+ const iri = `https://remote.example/notes/${uuidV7()}`;
+ const first = await receive(db, iri, [PUBLIC_IRI], "public");
+ await receive(db, iri, ["https://remote.example/users/carol"], "private");
+ const stored = (await db.query.resourceRevisions.findFirst({
+ where: { id: first.revisionId },
+ }))!;
+ const like = await embed(
+ db,
+ "Like",
+ withoutContext(stored.document as JsonObject),
+ { revisionId: first.revisionId, relation: "snapshot" },
+ );
+ const read = `query($id: ID!, $like: ID!) {
+ node(id: $id) { ... on Resource {
+ currentRevision { id }
+ revisions { edges { node { sequence document } } }
+ } }
+ like: node(id: $like) { ... on Resource { currentRevision { root {
+ relations(property: object) { node { source {
+ relation status revision { sequence }
+ } } }
+ } } } }
+ }`;
+ const variables = {
+ id: globalId("Resource", first.resourceId),
+ like: globalId("Resource", like.resourceId),
+ };
+ const sourceOf = (status: string | null) => ({
+ currentRevision: {
+ root: {
+ relations: [
+ {
+ node: {
+ source: {
+ relation: "snapshot",
+ status,
+ revision: { sequence: 1 },
+ },
+ },
+ },
+ ],
+ },
+ },
+ });
+ const response = await harness.post({ query: read, variables });
+ const text = await response.text();
+ assert.ok(!text.includes('"private"'));
+ assert.deepEqual(JSON.parse(text), {
+ data: {
+ node: {
+ currentRevision: null,
+ revisions: {
+ edges: [{ node: { sequence: 1, document: stored.document } }],
+ },
+ },
+ // Whether a later revision exists is not told without reading it.
+ like: sourceOf(null),
+ },
+ });
+ const admin = await seedViewer(db, { admin: true });
+ const body = await query(read, variables, admin.auth);
+ assert.equal(body.data?.node.revisions.edges.length, 2);
+ assert.deepEqual(body.data?.like, sourceOf("superseded"));
+ });
+ });
+});
+
+describe("Resource nodes read through their revisions", () => {
+ // The rule for a remote resource with a legacy typed row follows its
+ // current state, which no delivery to the viewer's workspace opens here;
+ // only a receipt opens its revision.
+ it("finds a resource by a revision the viewer may read, but not its typed details", async () => {
+ await withWriter(async ({ harness, query }) => {
+ const { db } = harness;
+ await seedRemoteActor(db);
+ const workspaceB = await seedWorkspace(db);
+ const memberB = await seedViewer(db, { memberOf: workspaceB });
+ const outsider = await seedViewer(db);
+ const remoteId = uuidV7();
+ const iri = `https://remote.example.com/notes/${remoteId}`;
+ const document = { type: "Note", content: "private" };
+ await seedObjects(db, {
+ id: remoteId,
+ actorId: remoteActorId,
+ type: "Note",
+ iri,
+ contentHtml: "private",
+ document,
+ addressing: { to: [CAROL] },
+ });
+ const revision = await db.transaction((tx) =>
+ captureLegacyResourceRevision(tx, remoteId),
+ );
+ await receipt(db, revision, workspaceB);
+ const like = await embed(db, "Like", { ...document, id: iri });
+ const read = `query($id: ID!, $typed: ID!, $like: ID!) {
+ node(id: $id) { ... on Resource {
+ iri
+ detail { __typename }
+ revisions { edges { node { sequence document } } }
+ } }
+ typed: node(id: $typed) { ... on Object { uuid } }
+ nodes(ids: [$id, $typed]) { id }
+ like: node(id: $like) { ... on Resource { currentRevision { root {
+ relations(property: object) { resource { iri } }
+ } } } }
+ }`;
+ const variables = {
+ id: globalId("Resource", remoteId),
+ typed: globalId("Object", remoteId),
+ like: globalId("Resource", like.resourceId),
+ };
+ const relations = (resource: unknown) => ({
+ currentRevision: { root: { relations: [{ resource }] } },
+ });
+ assert.deepEqual(await query(read, variables, memberB.auth), {
+ data: {
+ node: {
+ iri,
+ // The typed details follow the rule of the current state.
+ detail: null,
+ revisions: { edges: [{ node: { sequence: 1, document } }] },
+ },
+ typed: null,
+ nodes: [{ id: variables.id }, null],
+ like: relations({ iri }),
+ },
+ });
+ // Without a revision to read, nothing tells of the resource.
+ for (const init of [undefined, outsider.auth]) {
+ assert.deepEqual(await query(read, variables, init), {
+ data: {
+ node: null,
+ typed: null,
+ nodes: [null, null],
+ like: relations(null),
+ },
+ });
+ }
+ });
+ });
+});
+
+describe("DocumentNode.source", () => {
+ const source = `query($id: ID!) { node(id: $id) { ... on Resource {
+ currentRevision { root { source { relation } relations(property: object) {
+ node { source { relation status revision { id sequence } } }
+ } } }
+ } } }`;
+
+ const read = async (
+ query: Writer["query"],
+ resourceId: Uuid,
+ ): Promise => {
+ const body = await query(source, { id: globalId("Resource", resourceId) });
+ assert.equal(body.errors, undefined);
+ const root = body.data?.node.currentRevision.root;
+ // The root is no embedded document.
+ assert.equal(root.source, null);
+ return root.relations[0].node.source;
+ };
+
+ it("follows a saved Create and the Update of its edited Note to the deletion", async () => {
+ await withWriter(async ({ harness, save, change, query }) => {
+ const [note, create] = await save(
+ {
+ type: "Create",
+ to: [PUBLIC_IRI],
+ object: { type: "Note", content: "A", to: [PUBLIC_IRI] },
+ },
+ [
+ { path: [], kind: "activity" },
+ { path: ["object"], kind: "object", representation: "embedded" },
+ ],
+ );
+ assert.ok(note != null && create != null);
+ const first = await head(harness.db, note.id);
+ const [, update] = await change(
+ edit(note.id, first.id, {
+ ...(first.document as JsonObject),
+ content: "B",
+ }),
+ );
+ assert.ok(update != null);
+ const second = await head(harness.db, note.id);
+ const of = (revision: Uuid, sequence: number, status: string) => ({
+ relation: "snapshot",
+ status,
+ revision: { id: revisionId(revision), sequence },
+ });
+ assert.deepEqual(
+ await read(query, create.id),
+ of(first.id, 1, "superseded"),
+ );
+ assert.deepEqual(
+ await read(query, update.id),
+ of(second.id, 2, "current"),
+ );
+ await change({
+ operation: "delete",
+ actorId: localActorId,
+ objectId: note.id,
+ expectedRevisionId: second.id,
+ });
+ assert.deepEqual(
+ await read(query, create.id),
+ of(first.id, 1, "deleted"),
+ );
+ assert.deepEqual(
+ await read(query, update.id),
+ of(second.id, 2, "deleted"),
+ );
+ });
+ });
+
+ it("knows the source of a loaded document only when it is declared", async () => {
+ await withWriter(async ({ harness, save, query }) => {
+ const [note] = await save({
+ type: "Note",
+ content: "A",
+ to: [PUBLIC_IRI],
+ });
+ assert.ok(note != null);
+ const loaded = await head(harness.db, note.id);
+ const object = withoutContext(loaded.document as JsonObject);
+ const sources = [{ path: ["object"], revisionId: loaded.id }];
+ const like = (embedded: JsonObject) => ({
+ type: "Like",
+ object: embedded,
+ to: [PUBLIC_IRI],
+ });
+ const [kept] = await save(like(object), ACTIVITY, sources);
+ const [derived] = await save(
+ like({ ...object, content: "changed" }),
+ ACTIVITY,
+ sources,
+ );
+ // A pasted copy has an unknown source, even when it keeps the
+ // current revision.
+ const [pasted] = await save(like(object), ACTIVITY);
+ assert.ok(kept != null && derived != null && pasted != null);
+ const of = (relation: string) => ({
+ relation,
+ status: "current",
+ revision: { id: revisionId(loaded.id), sequence: 1 },
+ });
+ assert.deepEqual(await read(query, kept.id), of("snapshot"));
+ assert.deepEqual(await read(query, derived.id), of("derived"));
+ assert.equal(await read(query, pasted.id), null);
+ });
+ });
+
+ it("tells snapshots and derived documents and where their sources stand", async () => {
+ await withWriter(async ({ harness, query }) => {
+ const { db } = harness;
+ const note = await ensureResource(db, `${ACTOR_IRI}/notes/${uuidV7()}`);
+ const document = { id: note.iri, type: "Note", content: "1" };
+ const first = await appendResourceRevision(db, {
+ resourceId: note.id,
+ resourceKind: "object",
+ expectedRevisionId: null,
+ kind: "snapshot",
+ capture: "local",
+ document: { "@context": AS, ...document },
+ });
+ const create = await embed(db, "Create", document, {
+ revisionId: first.id,
+ relation: "snapshot",
+ });
+ const announce = await embed(
+ db,
+ "Announce",
+ { ...document, content: "changed" },
+ { revisionId: first.id, relation: "derived" },
+ );
+ const pasted = await embed(db, "Like", document);
+ const expected = (relation: string, status: string) => ({
+ relation,
+ status,
+ revision: { id: revisionId(first.id), sequence: 1 },
+ });
+ assert.deepEqual(
+ await read(query, create.resourceId),
+ expected("snapshot", "current"),
+ );
+ assert.deepEqual(
+ await read(query, announce.resourceId),
+ expected("derived", "current"),
+ );
+ // A document embedded without a recorded source has an unknown one.
+ assert.equal(await read(query, pasted.resourceId), null);
+ const second = await appendResourceRevision(db, {
+ resourceId: note.id,
+ resourceKind: "object",
+ expectedRevisionId: first.id,
+ kind: "snapshot",
+ capture: "local",
+ document: { "@context": AS, ...document, content: "2" },
+ });
+ assert.deepEqual(
+ await read(query, create.resourceId),
+ expected("snapshot", "superseded"),
+ );
+ await appendResourceRevision(db, {
+ resourceId: note.id,
+ resourceKind: "object",
+ expectedRevisionId: second.id,
+ kind: "whiteout",
+ deleted: Temporal.Now.instant(),
+ formerTypes: ["Note"],
+ });
+ assert.deepEqual(
+ await read(query, create.resourceId),
+ expected("snapshot", "deleted"),
+ );
+ });
+ });
+});
diff --git a/packages/graphql/src/revision.ts b/packages/graphql/src/revision.ts
new file mode 100644
index 00000000..c77b49cc
--- /dev/null
+++ b/packages/graphql/src/revision.ts
@@ -0,0 +1,746 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import {
+ type InterpretedNode,
+ RELATION_PROPERTIES,
+ type RecipientOccurrence,
+ type RelationOccurrence,
+ interpretDocument,
+} from "@drfed/federation/document";
+import { schema } from "@drfed/models";
+import {
+ type Diagnostic,
+ type DiagnosticCategory,
+ type DiagnosticSeverity,
+ type DocumentNodeKind,
+ validateDocument,
+} from "@drfed/models/document";
+import type {
+ ResourceRevision as ResourceRevisionRow,
+ Resource as ResourceRow,
+ RevisionEmbedding,
+} from "@drfed/models/schema";
+import type { Uuid } from "@drfed/models/uuid";
+import { and, eq, inArray } from "drizzle-orm";
+
+import builder, { type DrFedObjectRef, type UserContext } from "./builder.ts";
+import { readableResourceNode, readableRevision } from "./readable.ts";
+import { Resource } from "./resource.ts";
+
+const ACTIVITY_STREAMS = "https://www.w3.org/ns/activitystreams#";
+
+const ResourceRevisionKind = builder.enumType("ResourceRevisionKind", {
+ description: "What a revision records.",
+ values: {
+ snapshot: { description: "A saved document." },
+ unavailable: {
+ description:
+ "A legacy typed row that had no retained document; nothing replaces it.",
+ },
+ whiteout: {
+ description:
+ "A deletion: its time and the types the resource had, but no document.",
+ },
+ } satisfies Record,
+});
+const ResourceRevisionCapture = builder.enumType("ResourceRevisionCapture", {
+ description:
+ "How DrFed came to store a revision. Neither proves ownership nor " +
+ "grants access.",
+ values: {
+ local: { description: "Saved by DrFed for a local actor." },
+ received: { description: "Received in an inbound activity." },
+ embedded: { description: "Embedded in another received document." },
+ fetched: {
+ description:
+ "Fetched apart from an activity. For legacy data, a conservative " +
+ "flag that is no proof an HTTP fetch occurred.",
+ },
+ } satisfies Record,
+});
+const DocumentNodeKindEnum = builder.enumType("DocumentNodeKind", {
+ description: "The vocabulary category of a document's type.",
+ values: {
+ activity: {},
+ actor: {},
+ collection: {},
+ link: {},
+ object: {},
+ } satisfies Record,
+});
+const RelationProperty = builder.enumType("RelationProperty", {
+ description: "A property that relates a document to another resource.",
+ values: RELATION_PROPERTIES,
+});
+const AddressingProperty = builder.enumType("AddressingProperty", {
+ description: "A property that addresses a document's recipients.",
+ values: schema.addressingPropertyEnum.enumValues,
+});
+const RelationRepresentation = builder.enumType("RelationRepresentation", {
+ description: "How a value names what it stands for.",
+ values: {
+ reference: { description: "An IRI." },
+ embedded: { description: "An embedded document." },
+ link: { description: "An embedded `Link`, which names it by `href`." },
+ } satisfies Record,
+});
+const DiagnosticCategoryEnum = builder.enumType("DiagnosticCategory", {
+ values: {
+ vocabulary: {
+ description: "The document breaks a vocabulary or JSON-LD rule.",
+ },
+ authority: { description: "The document claims what it may not." },
+ support: { description: "DrFed's validator cannot check it." },
+ compatibility: {
+ description: "Valid, but other implementations may read it otherwise.",
+ },
+ } satisfies Record,
+});
+const DiagnosticSeverityEnum = builder.enumType("DiagnosticSeverity", {
+ values: {
+ error: {},
+ warning: {},
+ } satisfies Record,
+});
+
+const DocumentExtension = builder.objectRef<{
+ readonly key: string;
+ readonly value: unknown;
+}>("DocumentExtension");
+DocumentExtension.implement({
+ description: "A custom extension property, preserved as opaque JSON.",
+ fields: (t) => ({
+ key: t.exposeString("key", {
+ description: "The key in its source spelling.",
+ }),
+ value: t.expose("value", { type: "JSON", description: "As saved." }),
+ }),
+});
+
+const DocumentDiagnostic = builder.objectRef("DocumentDiagnostic");
+DocumentDiagnostic.implement({
+ description: "A finding of the document validator.",
+ fields: (t) => ({
+ reason: t.exposeString("reason", {
+ description:
+ "A stable classification, such as `unsupported_property`. Use it " +
+ "for decisions rather than `message`.",
+ }),
+ category: t.expose("category", { type: DiagnosticCategoryEnum }),
+ severity: t.expose("severity", { type: DiagnosticSeverityEnum }),
+ path: t.expose("path", {
+ type: "JSON",
+ description:
+ "The source keys and list indexes leading to the finding; `[]` is " +
+ "the root.",
+ }),
+ message: t.exposeString("message", {
+ description: "For people; it may change.",
+ }),
+ }),
+});
+
+const DocumentSourceRelation = builder.enumType("DocumentSourceRelation", {
+ description:
+ "How an embedded document relates to the revision it came from, as " +
+ "recorded when the document embedding it was saved.",
+ values: {
+ snapshot: {
+ description:
+ "It keeps the source revision's contents, apart from the context " +
+ "it inherits from the document embedding it.",
+ },
+ derived: {
+ description:
+ "It started from the source revision and was changed, as a test " +
+ "input with other addressing or an altered property.",
+ },
+ } satisfies Record,
+});
+const DocumentSourceStatus = builder.enumType("DocumentSourceStatus", {
+ description:
+ "Where the source revision stands in its resource's history. It " +
+ "compares revisions, not contents.",
+ values: {
+ current: { description: "It is the resource's current revision." },
+ superseded: {
+ description:
+ "A later revision is current, which may have the same contents.",
+ },
+ deleted: { description: "The resource's current revision is a whiteout." },
+ },
+});
+
+type SourceStatus = "current" | "superseded" | "deleted";
+
+/** A recorded embedding whose source revision the viewer may read. */
+interface Source {
+ readonly relation: RevisionEmbedding["relation"];
+ readonly revision: ResourceRevisionRow;
+ /** Null when the viewer may not read the resource's current revision. */
+ readonly status: SourceStatus | null;
+}
+const DocumentSource = builder.objectRef("DocumentSource");
+
+const DocumentNode = builder.objectRef("DocumentNode");
+const DocumentRelation =
+ builder.objectRef("DocumentRelation");
+const DocumentRecipient =
+ builder.objectRef("DocumentRecipient");
+
+const resourceLookups = new WeakMap<
+ UserContext,
+ Map>
+>();
+
+/**
+ * Finds the resource registered under an IRI, as `Activity.object` opens
+ * it: only when the viewer may read it or one of its revisions. A deleted
+ * one is found too, since its revisions stay readable. Lookups are shared within a request, since
+ * a document may name one IRI many times.
+ * @returns The resource, or null.
+ */
+function registeredResource(
+ ctx: UserContext,
+ iri: string | null,
+): Promise {
+ if (iri == null) return Promise.resolve(null);
+ let lookups = resourceLookups.get(ctx);
+ if (lookups == null) {
+ lookups = new Map();
+ resourceLookups.set(ctx, lookups);
+ }
+ let lookup = lookups.get(iri);
+ if (lookup == null) {
+ lookup = (async () =>
+ (await ctx.db.query.resources.findFirst({
+ where: {
+ iri,
+ RAW: (table) => readableResourceNode(ctx, table.id),
+ },
+ })) ?? null)();
+ lookups.set(iri, lookup);
+ }
+ return lookup;
+}
+
+// The revision each interpreted node belongs to.
+const nodeRevisions = new WeakMap();
+
+const sourceLookups = new WeakMap<
+ UserContext,
+ Map>>
+>();
+
+/**
+ * Tells where a source revision stands against its resource's current
+ * revision. An `unavailable` current revision, a legacy typed row without a
+ * retained document, is a later revision like any other.
+ * @param revision The source revision.
+ * @param current The current revision of its resource, when the viewer may
+ * read it.
+ * @returns The status, or null without a readable current revision.
+ */
+const statusOf = (
+ revision: ResourceRevisionRow,
+ current: Pick | undefined,
+): SourceStatus | null =>
+ current == null
+ ? null
+ : current.id === revision.id
+ ? "current"
+ : current.kind === "whiteout"
+ ? "deleted"
+ : "superseded";
+
+/**
+ * Loads the recorded sources of a revision's embedded documents that the
+ * viewer may read, with where each stands, in two queries per revision
+ * whatever the number of documents it embeds. Lookups are shared within a
+ * request.
+ * @returns The sources, keyed by the JSON of the embedded documents' paths.
+ */
+function sourcesOf(
+ ctx: UserContext,
+ revisionId: Uuid,
+): Promise> {
+ let lookups = sourceLookups.get(ctx);
+ if (lookups == null) {
+ lookups = new Map();
+ sourceLookups.set(ctx, lookups);
+ }
+ let lookup = lookups.get(revisionId);
+ if (lookup == null) {
+ lookup = (async () => {
+ const embeddings = await ctx.db
+ .select({
+ path: schema.revisionEmbeddings.path,
+ relation: schema.revisionEmbeddings.relation,
+ revision: schema.resourceRevisions,
+ })
+ .from(schema.revisionEmbeddings)
+ .innerJoin(
+ schema.resourceRevisions,
+ eq(
+ schema.resourceRevisions.id,
+ schema.revisionEmbeddings.sourceRevisionId,
+ ),
+ )
+ .where(
+ and(
+ eq(schema.revisionEmbeddings.revisionId, revisionId),
+ readableRevision(ctx, schema.resourceRevisions.id),
+ ),
+ );
+ const resourceIds = [
+ ...new Set(embeddings.map(({ revision }) => revision.resourceId)),
+ ];
+ const heads =
+ resourceIds.length === 0
+ ? []
+ : await ctx.db
+ .select({
+ resourceId: schema.resourceHeads.resourceId,
+ id: schema.resourceRevisions.id,
+ kind: schema.resourceRevisions.kind,
+ })
+ .from(schema.resourceHeads)
+ .innerJoin(
+ schema.resourceRevisions,
+ eq(
+ schema.resourceRevisions.id,
+ schema.resourceHeads.revisionId,
+ ),
+ )
+ .where(
+ and(
+ inArray(schema.resourceHeads.resourceId, resourceIds),
+ readableRevision(ctx, schema.resourceRevisions.id),
+ ),
+ );
+ const current = new Map(
+ heads.map((head) => [head.resourceId, head] as const),
+ );
+ return new Map(
+ embeddings.map(({ path, relation, revision }) => [
+ JSON.stringify(path),
+ {
+ relation,
+ revision,
+ status: statusOf(revision, current.get(revision.resourceId)),
+ },
+ ]),
+ );
+ })();
+ lookups.set(revisionId, lookup);
+ }
+ return lookup;
+}
+
+/**
+ * Finds the recorded source of an embedded document, when the viewer may
+ * read the source revision. Whatever it finds, the document itself reads
+ * as the revision embedding it does.
+ * @returns The source, or null for the root, for a document whose source is
+ * unknown, and for a source the viewer may not read, which are not
+ * told apart.
+ */
+async function sourceOf(
+ ctx: UserContext,
+ node: InterpretedNode,
+): Promise {
+ const revisionId = nodeRevisions.get(node);
+ if (revisionId == null || node.path.length === 0) return null;
+ return (
+ (await sourcesOf(ctx, revisionId)).get(JSON.stringify(node.path)) ?? null
+ );
+}
+
+const occurrenceFields = {
+ representation: {
+ description:
+ "Whether the value is an IRI, an embedded document or a `Link`.",
+ },
+ iri:
+ "A reference's IRI, an embedded document's `id`, or a `Link`'s `href`, " +
+ "with a compact IRI expanded; null for an anonymous embedded value.",
+ resource:
+ "The resource currently registered under `iri`, or null when there is " +
+ "none, or when the viewer may read neither it nor any of its " +
+ "revisions. A deleted resource is returned too, since its revisions " +
+ "stay readable. It is never fetched.",
+} as const;
+
+DocumentRelation.implement({
+ description:
+ "One value of a relation property, in source order including duplicates.",
+ fields: (t) => ({
+ property: t.expose("property", { type: RelationProperty }),
+ path: t.expose("path", {
+ type: "JSON",
+ description:
+ "The source path of the value from the root of the saved document, " +
+ 'such as `["object", 0]`.',
+ }),
+ representation: t.expose("representation", {
+ type: RelationRepresentation,
+ ...occurrenceFields.representation,
+ }),
+ iri: t.expose("iri", {
+ type: "URL",
+ nullable: true,
+ description: occurrenceFields.iri,
+ }),
+ node: t.expose("node", {
+ type: DocumentNode,
+ nullable: true,
+ description:
+ "The embedded document or `Link` as the saved document embeds it, " +
+ "which may differ from the resource's current revision; null for a " +
+ "reference.",
+ }),
+ resource: t.field({
+ type: Resource,
+ nullable: true,
+ description: occurrenceFields.resource,
+ resolve: (occurrence, _, ctx) => registeredResource(ctx, occurrence.iri),
+ }),
+ }),
+});
+
+DocumentRecipient.implement({
+ description:
+ "One value of an addressing property, in source order including " +
+ "duplicates and anonymous embedded recipients.",
+ fields: (t) => ({
+ property: t.expose("property", { type: AddressingProperty }),
+ position: t.exposeInt("position", {
+ description:
+ "The index of the value in its property's list, or 0 for a value " +
+ "written alone.",
+ }),
+ path: t.expose("path", {
+ type: "JSON",
+ description:
+ "The source path of the value from the root of the saved document.",
+ }),
+ representation: t.expose("representation", {
+ type: RelationRepresentation,
+ ...occurrenceFields.representation,
+ }),
+ iri: t.expose("iri", {
+ type: "URL",
+ nullable: true,
+ description: occurrenceFields.iri,
+ }),
+ resource: t.field({
+ type: Resource,
+ nullable: true,
+ description: occurrenceFields.resource,
+ resolve: (occurrence, _, ctx) => registeredResource(ctx, occurrence.iri),
+ }),
+ }),
+});
+
+DocumentNode.implement({
+ description:
+ "A vocabulary document of a saved revision, the root or one embedded in " +
+ "it at any depth, read by meaning, whatever keys spell its properties. " +
+ "It may be anonymous.",
+ fields: (t) => ({
+ path: t.expose("path", {
+ type: "JSON",
+ description:
+ 'The source path from the root, such as `["object", 0]`; `[]` is ' +
+ "the root.",
+ }),
+ property: t.exposeString("property", {
+ nullable: true,
+ description:
+ "The standard name of the property that embeds it, whatever its " +
+ "source spelling; null for the root.",
+ }),
+ type: t.expose("type", {
+ type: "URL",
+ description: "The type IRI, such as `…/activitystreams#Note`.",
+ }),
+ kind: t.expose("kind", { type: DocumentNodeKindEnum }),
+ iri: t.expose("iri", {
+ type: "URL",
+ nullable: true,
+ description:
+ "Its `id`, or the `href` of a `Link`, with a compact IRI expanded; " +
+ "null when it has none.",
+ }),
+ document: t.expose("value", {
+ type: "JSON",
+ description: "Its JSON as saved, with everything it embeds.",
+ }),
+ relations: t.field({
+ type: [DocumentRelation],
+ args: { property: t.arg({ type: RelationProperty }) },
+ description:
+ "Its own `actor`, `object`, `target`, `origin`, `result`, " +
+ "`instrument` and `attributedTo` values, or those of one property, " +
+ "in that order, then in source order including duplicates. Empty " +
+ "for a property it does not have.",
+ resolve: (node, { property }) =>
+ property == null
+ ? node.relations
+ : node.relations.filter((entry) => entry.property === property),
+ }),
+ addressing: t.field({
+ type: [DocumentRecipient],
+ args: { property: t.arg({ type: AddressingProperty }) },
+ description:
+ "Its own `to`, `cc`, `bto`, `bcc` and `audience` values, or those " +
+ "of one property, in that order, then in source order including " +
+ "duplicates.",
+ resolve: (node, { property }) =>
+ property == null
+ ? node.addressing
+ : node.addressing.filter((entry) => entry.property === property),
+ }),
+ extensions: t.expose("extensions", {
+ type: [DocumentExtension],
+ description:
+ "Its own custom extension properties, by their source keys, sorted.",
+ }),
+ source: t.field({
+ type: DocumentSource,
+ nullable: true,
+ description:
+ "The revision this embedded document came from, as recorded when " +
+ "the document embedding it was saved. Null for the root, for an " +
+ "embedded document whose source is unknown, such as one saved " +
+ "before sources were recorded or pasted without one, and when the " +
+ "viewer may not read the source revision, which are not told " +
+ "apart. It hides nothing else: the document reads as the revision " +
+ "embedding it does, whatever its source.",
+ resolve: (node, _, ctx) => sourceOf(ctx, node),
+ }),
+ }),
+});
+
+DocumentSource.implement({
+ description:
+ "The revision an embedded document came from, which the viewer may " +
+ "read.",
+ fields: (t) => ({
+ relation: t.expose("relation", { type: DocumentSourceRelation }),
+ revision: t.field({
+ type: ResourceRevisionRef,
+ description: "The source revision, of the resource the document names.",
+ resolve: (source) => source.revision,
+ }),
+ status: t.field({
+ type: DocumentSourceStatus,
+ nullable: true,
+ description:
+ "Whether the source revision is still current, or a later revision " +
+ "or a deletion followed it; null when the viewer may not read the " +
+ "resource's current revision.",
+ resolve: (source) => source.status,
+ }),
+ }),
+});
+
+type Content = Pick;
+
+const interpretations = new WeakMap();
+const validations = new WeakMap();
+
+/**
+ * Interprets a revision's document once per loaded row.
+ * @returns The root, or null unless the revision is a snapshot whose
+ * document the validator reads without errors.
+ */
+function rootOf(revision: Content): InterpretedNode | null {
+ if (!interpretations.has(revision)) {
+ const nodes =
+ revision.kind === "snapshot"
+ ? interpretDocument(revision.document)
+ : null;
+ for (const node of nodes ?? []) nodeRevisions.set(node, revision.id);
+ interpretations.set(revision, nodes?.[0] ?? null);
+ }
+ return interpretations.get(revision)!;
+}
+
+function diagnosticsOf(revision: Content): readonly Diagnostic[] {
+ let diagnostics = validations.get(revision);
+ if (diagnostics == null) {
+ diagnostics =
+ revision.kind === "snapshot"
+ ? validateDocument(revision.document).diagnostics
+ : [];
+ validations.set(revision, diagnostics);
+ }
+ return diagnostics;
+}
+
+const content = { columns: { id: true, kind: true, document: true } } as const;
+
+const ResourceRevisionRef = builder.drizzleNode("resourceRevisions", {
+ name: "ResourceRevision",
+ description:
+ "An immutable revision of a resource. Each revision, past ones " +
+ "included, is readable by evidence of its own, not by the current " +
+ "state of its resource: one saved by DrFed for a local actor by anyone, " +
+ "blind recipients and unpublished activities included; one addressed " +
+ "to the public by anyone; one a receipt links to a delivery to a local " +
+ "instance the viewer is a member of by its members; and the current " +
+ "revision of a resource with a legacy typed row as `Activity` and " +
+ "`Object` tell. Where its embedded documents came from never hides " +
+ "it. Administrators read every revision. A later " +
+ "restriction or deletion of the resource hides no earlier revision. A " +
+ "revision the viewer may not read is left out as if it did not exist.",
+ // A node lookup checks the revision by its own ID.
+ select: { columns: { id: true, resourceId: true } },
+ id: { column: (revision) => revision.id },
+ fields: (t) => ({
+ resource: t.relation("resource"),
+ sequence: t.exposeInt("sequence", {
+ description: "Increases with each revision of the resource.",
+ }),
+ kind: t.expose("kind", { type: ResourceRevisionKind }),
+ capture: t.expose("capture", { type: ResourceRevisionCapture }),
+ backfilled: t.exposeBoolean("backfilled", {
+ description: "Whether the migration from legacy typed rows created it.",
+ }),
+ created: t.expose("created", {
+ type: "DateTime",
+ description: "When DrFed stored the revision.",
+ }),
+ document: t.expose("document", {
+ type: "JSON",
+ nullable: true,
+ description:
+ "The saved JSON as is, `bto` and `bcc` included for local " +
+ "resources. Read `root` instead of parsing it by keys, which " +
+ "aliases and contexts may spell otherwise. Null unless `kind` is " +
+ "`snapshot`, or for a snapshot of JSON null.",
+ }),
+ interpreted: t.boolean({
+ description:
+ "Whether `root` could be derived from `document`. When false, " +
+ "`root` is null and, for a snapshot, `diagnostics` explain why.",
+ select: content,
+ resolve: (revision) => rootOf(revision) != null,
+ }),
+ root: t.field({
+ type: DocumentNode,
+ nullable: true,
+ description:
+ "The root document read by meaning; null unless `interpreted`.",
+ select: content,
+ resolve: (revision) => rootOf(revision),
+ }),
+ diagnostics: t.field({
+ type: [DocumentDiagnostic],
+ description:
+ "What the current validator finds in the saved document, which may " +
+ "differ from what it found when the revision was stored. Empty " +
+ "unless `kind` is `snapshot`.",
+ select: content,
+ resolve: (revision) => diagnosticsOf(revision),
+ }),
+ deleted: t.expose("deleted", {
+ type: "DateTime",
+ nullable: true,
+ description: "The deletion time of a whiteout; null otherwise.",
+ }),
+ formerTypes: t.field({
+ type: ["URL"],
+ nullable: true,
+ description:
+ "The type IRIs the resource had, for a whiteout; null otherwise. " +
+ 'Stored ActivityStreams names, such as `"Note"`, are expanded with ' +
+ "`https://www.w3.org/ns/activitystreams#`.",
+ select: { columns: { formerTypes: true } },
+ resolve: (revision) =>
+ revision.formerTypes?.map((type) =>
+ type.includes(":") ? type : `${ACTIVITY_STREAMS}${type}`,
+ ) ?? null,
+ }),
+ }),
+});
+export const ResourceRevision: DrFedObjectRef = ResourceRevisionRef;
+
+builder.drizzleObjectField("resources", "currentRevision", (t) =>
+ t.field({
+ type: ResourceRevisionRef,
+ nullable: true,
+ description:
+ "The current revision; null for a resource without revisions, or when " +
+ "the viewer may not read the current revision.",
+ select: { columns: { id: true } },
+ resolve: async (resource, _, ctx) =>
+ (await ctx.db.query.resourceRevisions.findFirst({
+ where: {
+ RAW: (table) =>
+ and(
+ inArray(
+ table.id,
+ ctx.db
+ .select({ id: schema.resourceHeads.revisionId })
+ .from(schema.resourceHeads)
+ .where(eq(schema.resourceHeads.resourceId, resource.id)),
+ ),
+ readableRevision(ctx, table.id),
+ )!,
+ },
+ })) ?? null,
+ }),
+);
+
+builder.drizzleObjectField("resources", "revision", (t) =>
+ t.field({
+ type: ResourceRevisionRef,
+ nullable: true,
+ args: { sequence: t.arg.int({ required: true }) },
+ description:
+ "The revision with the given sequence; null when there is none, or " +
+ "when the viewer may not read it, which are not told apart.",
+ select: { columns: { id: true } },
+ resolve: async (resource, { sequence }, ctx) =>
+ (await ctx.db.query.resourceRevisions.findFirst({
+ where: {
+ resourceId: resource.id,
+ sequence,
+ RAW: (table) => readableRevision(ctx, table.id),
+ },
+ })) ?? null,
+ }),
+);
+
+builder.drizzleObjectField("resources", "revisions", (t) =>
+ t.relatedConnection(
+ "revisions",
+ {
+ description:
+ "The revisions the viewer may read, newest first. Others are left " +
+ "out, so sequences may skip.",
+ query: (_, ctx) => ({
+ where: { RAW: (table) => readableRevision(ctx, table.id) },
+ orderBy: { sequence: "desc" },
+ }),
+ },
+ { name: "ResourceRevisionConnection" },
+ { name: "ResourceRevisionEdge" },
+ ),
+);
diff --git a/packages/graphql/src/schema.ts b/packages/graphql/src/schema.ts
index aca3c3e4..869cc19e 100644
--- a/packages/graphql/src/schema.ts
+++ b/packages/graphql/src/schema.ts
@@ -19,6 +19,7 @@ import "./instance.ts";
import "./auth/entry.ts";
import "./actor.ts";
import "./object.ts";
+import "./revision.ts";
import "./activity-delivery/entry.ts";
import "./key.ts";
import builder from "./builder.ts";
diff --git a/packages/models/drizzle/20261113080536_revision_embeddings/migration.sql b/packages/models/drizzle/20261113080536_revision_embeddings/migration.sql
new file mode 100644
index 00000000..623e7389
--- /dev/null
+++ b/packages/models/drizzle/20261113080536_revision_embeddings/migration.sql
@@ -0,0 +1,14 @@
+CREATE TYPE "revision_embedding_relation" AS ENUM('snapshot', 'derived');--> statement-breakpoint
+CREATE TABLE "revision_embeddings" (
+ "revision_id" uuid,
+ "path" jsonb,
+ "source_revision_id" uuid NOT NULL,
+ "relation" "revision_embedding_relation" NOT NULL,
+ CONSTRAINT "revision_embeddings_pkey" PRIMARY KEY("revision_id","path"),
+ CONSTRAINT "revision_embeddings_path_check" CHECK (jsonb_typeof("path") = 'array' AND jsonb_array_length("path") > 0),
+ CONSTRAINT "revision_embeddings_source_check" CHECK ("source_revision_id" <> "revision_id")
+);
+--> statement-breakpoint
+CREATE INDEX "revision_embeddings_source_index" ON "revision_embeddings" ("source_revision_id");--> statement-breakpoint
+ALTER TABLE "revision_embeddings" ADD CONSTRAINT "revision_embeddings_revision_id_resource_revisions_id_fkey" FOREIGN KEY ("revision_id") REFERENCES "resource_revisions"("id") ON DELETE RESTRICT;--> statement-breakpoint
+ALTER TABLE "revision_embeddings" ADD CONSTRAINT "revision_embeddings_source_revision_fkey" FOREIGN KEY ("source_revision_id") REFERENCES "resource_revisions"("id") ON DELETE RESTRICT;
\ No newline at end of file
diff --git a/packages/models/drizzle/20261113080536_revision_embeddings/snapshot.json b/packages/models/drizzle/20261113080536_revision_embeddings/snapshot.json
new file mode 100644
index 00000000..34ddb991
--- /dev/null
+++ b/packages/models/drizzle/20261113080536_revision_embeddings/snapshot.json
@@ -0,0 +1,4634 @@
+{
+ "version": "8",
+ "dialect": "postgres",
+ "id": "f867ba22-2861-4e0b-a6c6-4c560fc4682e",
+ "prevIds": ["871c1f3c-b3f3-4880-9f18-bb1e3a844354"],
+ "ddl": [
+ {
+ "values": ["inbound", "outbound"],
+ "name": "activity_delivery_direction",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": [
+ "received",
+ "acknowledged",
+ "unverified",
+ "rejected",
+ "queued",
+ "sent",
+ "failed",
+ "permanently_failed",
+ "abandoned"
+ ],
+ "name": "activity_delivery_status",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["http_signature", "ld_signature", "object_integrity_proof"],
+ "name": "activity_delivery_verification_mechanism",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": [
+ "verified",
+ "invalid_signature",
+ "key_fetch_error",
+ "no_signature",
+ "unattempted",
+ "unobserved"
+ ],
+ "name": "activity_delivery_verification_result",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["Create"],
+ "name": "activity_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["Application", "Group", "Organization", "Person", "Service"],
+ "name": "actor_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["to", "cc", "bto", "bcc", "audience"],
+ "name": "addressing_property",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["followers", "following", "featured", "outbox"],
+ "name": "collection_role",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["Collection", "OrderedCollection"],
+ "name": "collection_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["RSASSA-PKCS1-v1_5", "Ed25519"],
+ "name": "local_actor_key_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["Article", "Note"],
+ "name": "object_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["actor", "object", "activity", "collection", "unknown"],
+ "name": "resource_kind",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["local", "received", "embedded", "fetched"],
+ "name": "resource_revision_capture",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["snapshot", "unavailable", "whiteout"],
+ "name": "resource_revision_kind",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["partial", "complete"],
+ "name": "resource_revision_projection",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["snapshot", "derived"],
+ "name": "revision_embedding_relation",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["activity", "object"],
+ "name": "revision_receipt_role",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["reference", "embedded", "link"],
+ "name": "revision_relation_representation",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "accounts",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activities",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activity_deliveries",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activity_delivery_actor_collections",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activity_delivery_actors",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activity_delivery_attempts",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "actor_collection_references",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "actors",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "addressing",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "collection_items",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "collections",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "instance_members",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "instances",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "key_versions",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "keys",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "local_actor_keys",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "local_actors",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "local_instances",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "login_challenges",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "objects",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "resource_heads",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "resource_revisions",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "resources",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "revision_addressing",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "revision_embeddings",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "revision_receipts",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "revision_relations",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "sessions",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "varchar(255)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "email",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "varchar(100)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "name",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "10",
+ "generated": null,
+ "identity": null,
+ "name": "max_instances",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "admin",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "activity_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "object_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "published",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "instance_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "activity_delivery_direction",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "direction",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "activity_delivery_status",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "status",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "activity_delivery_verification_mechanism",
+ "typeSchema": "public",
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "verification_mechanism",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "activity_delivery_verification_result",
+ "typeSchema": "public",
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "verification_result",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 1,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "types",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "activity_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "activity_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "carried_snapshot",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "fetched_object",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "carried_object_snapshot",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "object_type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "object_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "signed_key_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "verification_key_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "remote_actor_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "remote_host",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "inbox_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "request_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "headers",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "bytea",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "body",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "status_code",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "response_body",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "error",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "payload",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 1,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "recipient_iris",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "completed",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "delivery_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "collection_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "delivery_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "inbox_owner",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "addressed",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "addressed_directly",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "sender",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "delivery_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "succeeded",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "status_code",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "response_body",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "error",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "type": "collection_role",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "role",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "collection_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "local_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "actor_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "username",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "instance_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "inbox_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "followers_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "profile_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "avatar_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "header_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "name",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "bio_html",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "automatically_approves_followers",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "field_htmls",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "emojis",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "tags",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "sensitive",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "suspended",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "suspended_until",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "successor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 1,
+ "default": "(ARRAY[]::text[])",
+ "generated": null,
+ "identity": null,
+ "name": "aliases",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "0",
+ "generated": null,
+ "identity": null,
+ "name": "following_count",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "0",
+ "generated": null,
+ "identity": null,
+ "name": "followers_count",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "updated",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "published",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "deleted",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "source_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "addressing_property",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "property",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "position",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "target_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "collection_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "item_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "position",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "observed",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "collection_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "owner_actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "total_items",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "updated",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "account_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "instance_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "admin",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "accepted",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "local_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "varchar(259)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "host",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "node_info_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "software",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "software_version",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "key_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "public_key",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "fingerprint",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "first_seen",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "last_seen",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "keys"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "keys"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "keys"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "local_actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "type": "local_actor_key_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "public_key",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "private_key",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "avatar",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "header",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "type": "varchar(63)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "slug",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "expires",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "10",
+ "generated": null,
+ "identity": null,
+ "name": "max_actors",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "account_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "char(6)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "code",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP + INTERVAL '15 minutes'",
+ "generated": null,
+ "identity": null,
+ "name": "expires",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "consumed",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "activity_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "fetched",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "object_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "name",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "summary",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "content_html",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "varchar(35)",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "language",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "sensitive",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "published",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "updated",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "deleted",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "resource_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_heads"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_heads"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "gen_random_uuid()",
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "resource_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "sequence",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "resource_revision_kind",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "kind",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "resource_revision_capture",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "capture",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "backfilled",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 1,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "former_types",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "deleted",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "resource_revision_projection",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": "'partial'",
+ "generated": null,
+ "identity": null,
+ "name": "projection",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resources"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resources"
+ },
+ {
+ "type": "resource_kind",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "kind",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resources"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resources"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "type": "addressing_property",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "property",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "position",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "path",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "source_revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "type": "revision_embedding_relation",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "relation",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "delivery_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "type": "revision_receipt_role",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "role",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "occurrence",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "property",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "path",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "revision_relation_representation",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "representation",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "target_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "account_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "type": "varchar(64)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "token_hash",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP + INTERVAL '1 month'",
+ "generated": null,
+ "identity": null,
+ "name": "expires",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "actor_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"published\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_actor_published_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "object_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "published",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_object_published_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "instance_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"created\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_instance_created_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "actor_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_actor_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "activity_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"created\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_activity_created_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "verification_key_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_verification_key_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "activity_iri",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "inbox_url",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": "\"direction\" = 'outbound'",
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_outbound_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "actor_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"created\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"delivery_id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_actor_created_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "delivery_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "created",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_attempt_delivery_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "collection_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "actor_collection_reference_collection_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "username",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "instance_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": true,
+ "where": "\"local_id\" IS NOT NULL",
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "username_key",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "instance_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "actor_instance_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "target_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "property",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "addressing_target_property_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "collection_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "position",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "collection_item_position_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "nameExplicit": false,
+ "columns": [
+ {
+ "value": "account_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": "\"accepted\" IS NOT NULL",
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "instance_members_accountId_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "nameExplicit": false,
+ "columns": [
+ {
+ "value": "instance_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": "\"accepted\" IS NOT NULL",
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "instance_members_instanceId_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "key_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "first_seen",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "key_version_key_first_seen_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "actor_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"published\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "object_actor_published_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "iri",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "property",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "revision_addressing_iri_property_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "source_revision_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "revision_embeddings_source_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "revision_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "revision_receipts_revision_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "property",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "target_iri",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "revision_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "revision_relations_property_target_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activities_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activities_actorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["object_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "activities_object_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["instance_id"],
+ "schemaTo": "public",
+ "tableTo": "instances",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_deliveries_instance_id_instances_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "activity_deliveries_actor_id_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["activity_id"],
+ "schemaTo": "public",
+ "tableTo": "activities",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "activity_deliveries_activity_id_activities_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["verification_key_id"],
+ "schemaTo": "public",
+ "tableTo": "key_versions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "activity_deliveries_verification_key_id_key_versions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["delivery_id", "actor_id"],
+ "schemaTo": "public",
+ "tableTo": "activity_delivery_actors",
+ "columnsTo": ["delivery_id", "actor_id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_delivery_actor_collections_link_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["delivery_id"],
+ "schemaTo": "public",
+ "tableTo": "activity_deliveries",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_delivery_actors_eZEmaeqml3qX_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_delivery_actors_actor_id_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["delivery_id"],
+ "schemaTo": "public",
+ "tableTo": "activity_deliveries",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_delivery_attempts_BJqYxUSnVaXX_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actor_collection_references_actorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["collection_id"],
+ "schemaTo": "public",
+ "tableTo": "collections",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actor_collection_references_collectionId_collections_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actors_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["local_id"],
+ "schemaTo": "public",
+ "tableTo": "local_actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actors_localId_local_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["instance_id"],
+ "schemaTo": "public",
+ "tableTo": "instances",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actors_instanceId_instances_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["successor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "actors_successorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["source_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "addressing_sourceId_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["target_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "addressing_targetId_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["collection_id"],
+ "schemaTo": "public",
+ "tableTo": "collections",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "collection_items_collectionId_collections_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["item_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "collection_items_itemId_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "collections_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["owner_actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "collections_ownerActorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["account_id"],
+ "schemaTo": "public",
+ "tableTo": "accounts",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "NO ACTION",
+ "name": "instance_members_accountId_accounts_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["instance_id"],
+ "schemaTo": "public",
+ "tableTo": "instances",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "NO ACTION",
+ "name": "instance_members_instanceId_instances_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["local_id"],
+ "schemaTo": "public",
+ "tableTo": "local_instances",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "instances_localId_local_instances_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["key_id"],
+ "schemaTo": "public",
+ "tableTo": "keys",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "key_versions_key_id_keys_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["local_actor_id"],
+ "schemaTo": "public",
+ "tableTo": "local_actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "local_actor_keys_local_actor_id_local_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["account_id"],
+ "schemaTo": "public",
+ "tableTo": "accounts",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "login_tokens_accountId_accounts_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "objects_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "objects_actorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["activity_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "objects_activity_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["resource_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "resource_heads_resource_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "resource_heads"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["resource_id", "revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["resource_id", "id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "resource_heads_resource_revision_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "resource_heads"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["resource_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "resource_revisions_resource_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_addressing_revision_id_resource_revisions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_embeddings_revision_id_resource_revisions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["source_revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_embeddings_source_revision_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["delivery_id"],
+ "schemaTo": "public",
+ "tableTo": "activity_deliveries",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "revision_receipts_delivery_id_activity_deliveries_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_receipts_revision_id_resource_revisions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_relations_revision_id_resource_revisions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["account_id"],
+ "schemaTo": "public",
+ "tableTo": "accounts",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "sessions_accountId_accounts_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "columns": ["delivery_id", "actor_id", "collection_iri"],
+ "nameExplicit": false,
+ "name": "activity_delivery_actor_collections_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "columns": ["delivery_id", "actor_id"],
+ "nameExplicit": false,
+ "name": "activity_delivery_actors_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "columns": ["actor_id", "role"],
+ "nameExplicit": false,
+ "name": "actor_collection_references_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "columns": ["collection_id", "item_id"],
+ "nameExplicit": false,
+ "name": "collection_items_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "columns": ["instance_id", "account_id"],
+ "nameExplicit": false,
+ "name": "instance_members_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "columns": ["local_actor_id", "type"],
+ "nameExplicit": false,
+ "name": "local_actor_keys_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "columns": ["revision_id", "property", "position"],
+ "nameExplicit": false,
+ "name": "revision_addressing_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "columns": ["revision_id", "path"],
+ "nameExplicit": false,
+ "name": "revision_embeddings_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "columns": ["delivery_id", "revision_id", "role"],
+ "nameExplicit": false,
+ "name": "revision_receipts_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "columns": ["revision_id", "occurrence"],
+ "nameExplicit": false,
+ "name": "revision_relations_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "accounts_pkey",
+ "schema": "public",
+ "table": "accounts",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "activities_pkey",
+ "schema": "public",
+ "table": "activities",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "activity_deliveries_pkey",
+ "schema": "public",
+ "table": "activity_deliveries",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "activity_delivery_attempts_pkey",
+ "schema": "public",
+ "table": "activity_delivery_attempts",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "actors_pkey",
+ "schema": "public",
+ "table": "actors",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "addressing_pkey",
+ "schema": "public",
+ "table": "addressing",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "collections_pkey",
+ "schema": "public",
+ "table": "collections",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "instances_pkey",
+ "schema": "public",
+ "table": "instances",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "key_versions_pkey",
+ "schema": "public",
+ "table": "key_versions",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "keys_pkey",
+ "schema": "public",
+ "table": "keys",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "local_actors_pkey",
+ "schema": "public",
+ "table": "local_actors",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "local_instances_pkey",
+ "schema": "public",
+ "table": "local_instances",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "login_tokens_pkey",
+ "schema": "public",
+ "table": "login_challenges",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "objects_pkey",
+ "schema": "public",
+ "table": "objects",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["resource_id"],
+ "nameExplicit": false,
+ "name": "resource_heads_pkey",
+ "schema": "public",
+ "table": "resource_heads",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "resource_revisions_pkey",
+ "schema": "public",
+ "table": "resource_revisions",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "resources_pkey",
+ "schema": "public",
+ "table": "resources",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "sessions_pkey",
+ "schema": "public",
+ "table": "sessions",
+ "entityType": "pks"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["source_id", "property", "position"],
+ "nullsNotDistinct": false,
+ "name": "addressing_source_property_position_key",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["key_id", "fingerprint"],
+ "nullsNotDistinct": false,
+ "name": "key_versions_key_id_fingerprint_unique",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["activity_id"],
+ "nullsNotDistinct": false,
+ "name": "objects_activity_id_key",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["resource_id", "sequence"],
+ "nullsNotDistinct": false,
+ "name": "resource_revisions_resource_sequence_key",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["resource_id", "id"],
+ "nullsNotDistinct": false,
+ "name": "resource_revisions_resource_id_key",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["email"],
+ "nullsNotDistinct": false,
+ "name": "accounts_email_key",
+ "schema": "public",
+ "table": "accounts",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["local_id"],
+ "nullsNotDistinct": false,
+ "name": "actors_localId_key",
+ "schema": "public",
+ "table": "actors",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["host"],
+ "nullsNotDistinct": false,
+ "name": "instances_host_key",
+ "schema": "public",
+ "table": "instances",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["iri"],
+ "nullsNotDistinct": false,
+ "name": "keys_iri_key",
+ "schema": "public",
+ "table": "keys",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["slug"],
+ "nullsNotDistinct": false,
+ "name": "local_instances_slug_key",
+ "schema": "public",
+ "table": "local_instances",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["iri"],
+ "nullsNotDistinct": false,
+ "name": "resources_iri_key",
+ "schema": "public",
+ "table": "resources",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["token_hash"],
+ "nullsNotDistinct": false,
+ "name": "sessions_tokenHash_key",
+ "schema": "public",
+ "table": "sessions",
+ "entityType": "uniques"
+ },
+ {
+ "value": "\"email\" ~ '^[^@]+@[^@]+\\.[^@]+$'",
+ "name": "accounts_email_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "value": "\"max_instances\" >= 0",
+ "name": "accounts_max_instances_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "value": "trim(both from \"name\") <> ''",
+ "name": "accounts_name_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "value": "(\"direction\" = 'inbound' AND \"status\" IN ('received', 'acknowledged', 'unverified', 'rejected')) OR (\"direction\" = 'outbound' AND \"status\" IN ('queued', 'sent', 'failed', 'permanently_failed', 'abandoned'))",
+ "name": "activity_deliveries_direction_status_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "(\"completed\" IS NULL) = (\"status\" = 'queued')",
+ "name": "activity_deliveries_completed_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"status_code\" IS NULL OR \"status_code\" BETWEEN 100 AND 599",
+ "name": "activity_deliveries_status_code_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"direction\" <> 'outbound' OR \"verification_key_id\" IS NULL",
+ "name": "activity_deliveries_outbound_key_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "(\"direction\" = 'inbound') = (\"verification_result\" IS NOT NULL)",
+ "name": "activity_deliveries_verification_result_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"verification_mechanism\" IS NULL OR (\"direction\" = 'inbound' AND \"verification_result\" NOT IN ('unattempted', 'unobserved'))",
+ "name": "activity_deliveries_verification_mechanism_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "(\"direction\" = 'inbound') = (\"body\" IS NOT NULL)",
+ "name": "activity_deliveries_body_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"activity_id\" IS NULL OR \"direction\" = 'outbound' OR (\"verification_result\" = 'verified' AND \"status\" IN ('received', 'acknowledged'))",
+ "name": "activity_deliveries_activity_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"inbox_owner\" OR \"addressed\" OR \"sender\"",
+ "name": "activity_delivery_actors_role_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "value": "NOT \"addressed_directly\" OR \"addressed\"",
+ "name": "activity_delivery_actors_addressed_directly_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "value": "\"status_code\" IS NULL OR \"status_code\" BETWEEN 100 AND 599",
+ "name": "activity_delivery_attempts_status_code_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "value": "\"succeeded\" = (\"error\" IS NULL)",
+ "name": "activity_delivery_attempts_error_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "value": "\"local_id\" IS NULL OR \"username\" NOT LIKE '%@%'",
+ "name": "actors_username_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "value": "\"local_id\" IS NULL OR \"username\" IS NOT NULL",
+ "name": "actors_local_username_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "value": "\n \"suspended_until\" IS NULL OR (\n \"suspended\" IS NOT NULL AND\n \"suspended_until\" > \"suspended\"\n )\n ",
+ "name": "actors_suspended_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "value": "\"last_seen\" >= \"first_seen\"",
+ "name": "key_versions_seen_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "value": "NOT (\"public_key\" ?| array['d','p','q','dp','dq','qi','oth','k'])",
+ "name": "key_versions_public_key_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "value": "jsonb_typeof(\"public_key\") = 'object' AND NOT (\"public_key\" ?| array['d','p','q','dp','dq','qi','oth','k'])",
+ "name": "local_actor_keys_public_key_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "value": "\"slug\" ~ '^[a-z0-9][a-z0-9-]{2,61}[a-z0-9]$'\n AND (\"slug\" !~ '^..--' OR \"slug\" ~ '^xn--')",
+ "name": "local_instances_slug_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "value": "\"max_actors\" > 0",
+ "name": "instances_max_actors_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "value": "trim(both from \"content_html\") <> ''",
+ "name": "objects_content_html_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "value": "\"sequence\" > 0",
+ "name": "resource_revisions_sequence_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "value": "(\"kind\" = 'snapshot' AND \"document\" IS NOT NULL)\n OR (\"kind\" IN ('unavailable', 'whiteout') AND \"document\" IS NULL)",
+ "name": "resource_revisions_document_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "value": "(\"kind\" = 'whiteout' AND \"deleted\" IS NOT NULL AND \"former_types\" IS NOT NULL)\n OR (\"kind\" <> 'whiteout' AND \"deleted\" IS NULL AND \"former_types\" IS NULL)",
+ "name": "resource_revisions_deletion_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "value": "\"position\" >= 0",
+ "name": "revision_addressing_position_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "value": "jsonb_typeof(\"path\") = 'array' AND jsonb_array_length(\"path\") > 0",
+ "name": "revision_embeddings_path_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "value": "\"source_revision_id\" <> \"revision_id\"",
+ "name": "revision_embeddings_source_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "value": "\"occurrence\" >= 0",
+ "name": "revision_relations_occurrence_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "value": "\"path\" IS NULL OR json_typeof(\"path\") = 'array'",
+ "name": "revision_relations_path_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "value": "\"representation\" <> 'reference' OR \"target_iri\" IS NOT NULL",
+ "name": "revision_relations_reference_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_relations"
+ }
+ ],
+ "renames": []
+}
diff --git a/packages/models/drizzle/20261113080537_guard_revision_embeddings/migration.sql b/packages/models/drizzle/20261113080537_guard_revision_embeddings/migration.sql
new file mode 100644
index 00000000..c6cd5961
--- /dev/null
+++ b/packages/models/drizzle/20261113080537_guard_revision_embeddings/migration.sql
@@ -0,0 +1,42 @@
+-- An embedding names the stored snapshot of another resource it came from.
+CREATE FUNCTION drfed_guard_revision_embedding_insert() RETURNS trigger
+LANGUAGE plpgsql AS $$
+DECLARE
+ owner_id uuid;
+ source_owner_id uuid;
+ source_kind resource_revision_kind;
+BEGIN
+ SELECT resource_id INTO owner_id
+ FROM resource_revisions WHERE id = NEW.revision_id;
+ SELECT resource_id, kind INTO source_owner_id, source_kind
+ FROM resource_revisions WHERE id = NEW.source_revision_id;
+ IF NOT FOUND THEN
+ RAISE EXCEPTION 'Embedding source revision does not exist'
+ USING ERRCODE = '23503',
+ CONSTRAINT = 'revision_embeddings_source_revision_fkey';
+ END IF;
+ IF source_kind <> 'snapshot' THEN
+ RAISE EXCEPTION 'An embedding source must be a snapshot'
+ USING ERRCODE = '23514',
+ CONSTRAINT = 'revision_embeddings_source_kind_guard';
+ END IF;
+ IF source_owner_id = owner_id THEN
+ RAISE EXCEPTION 'An embedding source must belong to another resource'
+ USING ERRCODE = '23514',
+ CONSTRAINT = 'revision_embeddings_source_resource_guard';
+ END IF;
+ RETURN NEW;
+END;
+$$;
+--> statement-breakpoint
+CREATE TRIGGER revision_embeddings_source_guard BEFORE INSERT ON revision_embeddings
+FOR EACH ROW EXECUTE FUNCTION drfed_guard_revision_embedding_insert();
+--> statement-breakpoint
+CREATE TRIGGER revision_embeddings_insert_guard BEFORE INSERT ON revision_embeddings
+FOR EACH ROW EXECUTE FUNCTION drfed_guard_revision_projection_insert();
+--> statement-breakpoint
+CREATE TRIGGER revision_embeddings_immutable BEFORE UPDATE OR DELETE ON revision_embeddings
+FOR EACH ROW EXECUTE FUNCTION drfed_reject_revision_mutation();
+--> statement-breakpoint
+CREATE TRIGGER revision_embeddings_no_truncate BEFORE TRUNCATE ON revision_embeddings
+FOR EACH STATEMENT EXECUTE FUNCTION drfed_reject_revision_mutation();
diff --git a/packages/models/drizzle/20261113080537_guard_revision_embeddings/snapshot.json b/packages/models/drizzle/20261113080537_guard_revision_embeddings/snapshot.json
new file mode 100644
index 00000000..714ebfd1
--- /dev/null
+++ b/packages/models/drizzle/20261113080537_guard_revision_embeddings/snapshot.json
@@ -0,0 +1,4634 @@
+{
+ "id": "cca19e71-9298-4ce6-91cd-a43b4753442f",
+ "prevIds": ["f867ba22-2861-4e0b-a6c6-4c560fc4682e"],
+ "version": "8",
+ "dialect": "postgres",
+ "ddl": [
+ {
+ "values": ["inbound", "outbound"],
+ "name": "activity_delivery_direction",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": [
+ "received",
+ "acknowledged",
+ "unverified",
+ "rejected",
+ "queued",
+ "sent",
+ "failed",
+ "permanently_failed",
+ "abandoned"
+ ],
+ "name": "activity_delivery_status",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["http_signature", "ld_signature", "object_integrity_proof"],
+ "name": "activity_delivery_verification_mechanism",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": [
+ "verified",
+ "invalid_signature",
+ "key_fetch_error",
+ "no_signature",
+ "unattempted",
+ "unobserved"
+ ],
+ "name": "activity_delivery_verification_result",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["Create"],
+ "name": "activity_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["Application", "Group", "Organization", "Person", "Service"],
+ "name": "actor_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["to", "cc", "bto", "bcc", "audience"],
+ "name": "addressing_property",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["followers", "following", "featured", "outbox"],
+ "name": "collection_role",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["Collection", "OrderedCollection"],
+ "name": "collection_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["RSASSA-PKCS1-v1_5", "Ed25519"],
+ "name": "local_actor_key_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["Article", "Note"],
+ "name": "object_type",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["actor", "object", "activity", "collection", "unknown"],
+ "name": "resource_kind",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["local", "received", "embedded", "fetched"],
+ "name": "resource_revision_capture",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["snapshot", "unavailable", "whiteout"],
+ "name": "resource_revision_kind",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["partial", "complete"],
+ "name": "resource_revision_projection",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["snapshot", "derived"],
+ "name": "revision_embedding_relation",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["activity", "object"],
+ "name": "revision_receipt_role",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "values": ["reference", "embedded", "link"],
+ "name": "revision_relation_representation",
+ "entityType": "enums",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "accounts",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activities",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activity_deliveries",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activity_delivery_actor_collections",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activity_delivery_actors",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "activity_delivery_attempts",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "actor_collection_references",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "actors",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "addressing",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "collection_items",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "collections",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "instance_members",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "instances",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "key_versions",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "keys",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "local_actor_keys",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "local_actors",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "local_instances",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "login_challenges",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "objects",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "resource_heads",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "resource_revisions",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "resources",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "revision_addressing",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "revision_embeddings",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "revision_receipts",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "revision_relations",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "isRlsEnabled": false,
+ "name": "sessions",
+ "entityType": "tables",
+ "schema": "public"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "varchar(255)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "email",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "varchar(100)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "name",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "10",
+ "generated": null,
+ "identity": null,
+ "name": "max_instances",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "admin",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "activity_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "object_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "published",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "instance_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "activity_delivery_direction",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "direction",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "activity_delivery_status",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "status",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "activity_delivery_verification_mechanism",
+ "typeSchema": "public",
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "verification_mechanism",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "activity_delivery_verification_result",
+ "typeSchema": "public",
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "verification_result",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 1,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "types",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "activity_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "activity_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "carried_snapshot",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "fetched_object",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "carried_object_snapshot",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "object_type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "object_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "signed_key_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "verification_key_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "remote_actor_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "remote_host",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "inbox_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "request_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "headers",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "bytea",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "body",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "status_code",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "response_body",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "error",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "payload",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 1,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "recipient_iris",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "completed",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "delivery_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "collection_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "delivery_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "inbox_owner",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "addressed",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "addressed_directly",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "sender",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "delivery_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "succeeded",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "status_code",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "response_body",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "error",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "type": "collection_role",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "role",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "collection_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "local_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "actor_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "username",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "instance_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "inbox_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "followers_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "profile_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "avatar_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "header_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "name",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "bio_html",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "automatically_approves_followers",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "field_htmls",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "emojis",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "'{}'",
+ "generated": null,
+ "identity": null,
+ "name": "tags",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "sensitive",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "suspended",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "suspended_until",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "successor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 1,
+ "default": "(ARRAY[]::text[])",
+ "generated": null,
+ "identity": null,
+ "name": "aliases",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "0",
+ "generated": null,
+ "identity": null,
+ "name": "following_count",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "0",
+ "generated": null,
+ "identity": null,
+ "name": "followers_count",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "updated",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "published",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "deleted",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "source_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "addressing_property",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "property",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "position",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "target_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "collection_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "item_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "position",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "observed",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "collection_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "owner_actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "total_items",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "updated",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "account_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "instance_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "admin",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "accepted",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "local_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "varchar(259)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "host",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "node_info_url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "software",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "software_version",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "key_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "public_key",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "fingerprint",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "first_seen",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "last_seen",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "keys"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "keys"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "keys"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "local_actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "type": "local_actor_key_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "public_key",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "private_key",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "avatar",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actors"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "header",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_actors"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "type": "varchar(63)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "slug",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "expires",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "10",
+ "generated": null,
+ "identity": null,
+ "name": "max_actors",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "account_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "char(6)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "code",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP + INTERVAL '15 minutes'",
+ "generated": null,
+ "identity": null,
+ "name": "expires",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "consumed",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "actor_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "activity_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "fetched",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "object_type",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "type",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "url",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "name",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "summary",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "content_html",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "varchar(35)",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "language",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "sensitive",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "published",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "updated",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "deleted",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "resource_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_heads"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_heads"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "gen_random_uuid()",
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "resource_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "sequence",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "resource_revision_kind",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "kind",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "resource_revision_capture",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "capture",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "boolean",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "false",
+ "generated": null,
+ "identity": null,
+ "name": "backfilled",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "document",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 1,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "former_types",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "deleted",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "resource_revision_projection",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": "'partial'",
+ "generated": null,
+ "identity": null,
+ "name": "projection",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resources"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resources"
+ },
+ {
+ "type": "resource_kind",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "kind",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resources"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "resources"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "type": "addressing_property",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "property",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "position",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "type": "jsonb",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "path",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "source_revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "type": "revision_embedding_relation",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "relation",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "delivery_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "type": "revision_receipt_role",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "role",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "revision_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "integer",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "occurrence",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "property",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "json",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "path",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "revision_relation_representation",
+ "typeSchema": "public",
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "representation",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "text",
+ "typeSchema": null,
+ "notNull": false,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "target_iri",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "type": "uuid",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "account_id",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "type": "varchar(64)",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": null,
+ "generated": null,
+ "identity": null,
+ "name": "token_hash",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP",
+ "generated": null,
+ "identity": null,
+ "name": "created",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "type": "timestamp with time zone",
+ "typeSchema": null,
+ "notNull": true,
+ "dimensions": 0,
+ "default": "CURRENT_TIMESTAMP + INTERVAL '1 month'",
+ "generated": null,
+ "identity": null,
+ "name": "expires",
+ "entityType": "columns",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "actor_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"published\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_actor_published_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "object_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "published",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_object_published_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "instance_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"created\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_instance_created_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "actor_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_actor_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "activity_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"created\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_activity_created_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "verification_key_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_verification_key_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "activity_iri",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "inbox_url",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": "\"direction\" = 'outbound'",
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_outbound_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "actor_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"created\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"delivery_id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_actor_created_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "delivery_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "created",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "activity_delivery_attempt_delivery_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "collection_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "actor_collection_reference_collection_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "username",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "instance_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": true,
+ "where": "\"local_id\" IS NOT NULL",
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "username_key",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "instance_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "actor_instance_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "target_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "property",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "addressing_target_property_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "collection_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "position",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "collection_item_position_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "nameExplicit": false,
+ "columns": [
+ {
+ "value": "account_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": "\"accepted\" IS NOT NULL",
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "instance_members_accountId_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "nameExplicit": false,
+ "columns": [
+ {
+ "value": "instance_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": "\"accepted\" IS NOT NULL",
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "instance_members_instanceId_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "key_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "first_seen",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "key_version_key_first_seen_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "actor_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"published\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "\"id\" desc",
+ "isExpression": true,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "object_actor_published_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "iri",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "property",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "revision_addressing_iri_property_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "source_revision_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "revision_embeddings_source_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "revision_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "revision_receipts_revision_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "nameExplicit": true,
+ "columns": [
+ {
+ "value": "property",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "target_iri",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ },
+ {
+ "value": "revision_id",
+ "isExpression": false,
+ "asc": true,
+ "nullsFirst": false,
+ "opclass": null
+ }
+ ],
+ "isUnique": false,
+ "where": null,
+ "with": "",
+ "method": "btree",
+ "concurrently": false,
+ "name": "revision_relations_property_target_index",
+ "entityType": "indexes",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activities_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activities_actorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["object_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "activities_object_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activities"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["instance_id"],
+ "schemaTo": "public",
+ "tableTo": "instances",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_deliveries_instance_id_instances_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "activity_deliveries_actor_id_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["activity_id"],
+ "schemaTo": "public",
+ "tableTo": "activities",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "activity_deliveries_activity_id_activities_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["verification_key_id"],
+ "schemaTo": "public",
+ "tableTo": "key_versions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "activity_deliveries_verification_key_id_key_versions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["delivery_id", "actor_id"],
+ "schemaTo": "public",
+ "tableTo": "activity_delivery_actors",
+ "columnsTo": ["delivery_id", "actor_id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_delivery_actor_collections_link_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["delivery_id"],
+ "schemaTo": "public",
+ "tableTo": "activity_deliveries",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_delivery_actors_eZEmaeqml3qX_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_delivery_actors_actor_id_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["delivery_id"],
+ "schemaTo": "public",
+ "tableTo": "activity_deliveries",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "activity_delivery_attempts_BJqYxUSnVaXX_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actor_collection_references_actorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["collection_id"],
+ "schemaTo": "public",
+ "tableTo": "collections",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actor_collection_references_collectionId_collections_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actors_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["local_id"],
+ "schemaTo": "public",
+ "tableTo": "local_actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actors_localId_local_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["instance_id"],
+ "schemaTo": "public",
+ "tableTo": "instances",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "actors_instanceId_instances_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["successor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "actors_successorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["source_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "addressing_sourceId_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["target_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "addressing_targetId_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["collection_id"],
+ "schemaTo": "public",
+ "tableTo": "collections",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "collection_items_collectionId_collections_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["item_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "collection_items_itemId_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "collections_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["owner_actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "collections_ownerActorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "collections"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["account_id"],
+ "schemaTo": "public",
+ "tableTo": "accounts",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "NO ACTION",
+ "name": "instance_members_accountId_accounts_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["instance_id"],
+ "schemaTo": "public",
+ "tableTo": "instances",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "NO ACTION",
+ "name": "instance_members_instanceId_instances_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["local_id"],
+ "schemaTo": "public",
+ "tableTo": "local_instances",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "instances_localId_local_instances_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "instances"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["key_id"],
+ "schemaTo": "public",
+ "tableTo": "keys",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "key_versions_key_id_keys_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["local_actor_id"],
+ "schemaTo": "public",
+ "tableTo": "local_actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "local_actor_keys_local_actor_id_local_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["account_id"],
+ "schemaTo": "public",
+ "tableTo": "accounts",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "login_tokens_accountId_accounts_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "login_challenges"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "objects_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["actor_id"],
+ "schemaTo": "public",
+ "tableTo": "actors",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "objects_actorId_actors_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["activity_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "SET NULL",
+ "name": "objects_activity_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["resource_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "resource_heads_resource_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "resource_heads"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["resource_id", "revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["resource_id", "id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "resource_heads_resource_revision_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "resource_heads"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["resource_id"],
+ "schemaTo": "public",
+ "tableTo": "resources",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "resource_revisions_resource_id_resources_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_addressing_revision_id_resource_revisions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_embeddings_revision_id_resource_revisions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["source_revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_embeddings_source_revision_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["delivery_id"],
+ "schemaTo": "public",
+ "tableTo": "activity_deliveries",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "revision_receipts_delivery_id_activity_deliveries_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_receipts_revision_id_resource_revisions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["revision_id"],
+ "schemaTo": "public",
+ "tableTo": "resource_revisions",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "RESTRICT",
+ "name": "revision_relations_revision_id_resource_revisions_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["account_id"],
+ "schemaTo": "public",
+ "tableTo": "accounts",
+ "columnsTo": ["id"],
+ "onUpdate": "NO ACTION",
+ "onDelete": "CASCADE",
+ "name": "sessions_accountId_accounts_id_fkey",
+ "entityType": "fks",
+ "schema": "public",
+ "table": "sessions"
+ },
+ {
+ "columns": ["delivery_id", "actor_id", "collection_iri"],
+ "nameExplicit": false,
+ "name": "activity_delivery_actor_collections_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "activity_delivery_actor_collections"
+ },
+ {
+ "columns": ["delivery_id", "actor_id"],
+ "nameExplicit": false,
+ "name": "activity_delivery_actors_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "columns": ["actor_id", "role"],
+ "nameExplicit": false,
+ "name": "actor_collection_references_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "actor_collection_references"
+ },
+ {
+ "columns": ["collection_id", "item_id"],
+ "nameExplicit": false,
+ "name": "collection_items_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "collection_items"
+ },
+ {
+ "columns": ["instance_id", "account_id"],
+ "nameExplicit": false,
+ "name": "instance_members_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "instance_members"
+ },
+ {
+ "columns": ["local_actor_id", "type"],
+ "nameExplicit": false,
+ "name": "local_actor_keys_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "columns": ["revision_id", "property", "position"],
+ "nameExplicit": false,
+ "name": "revision_addressing_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "columns": ["revision_id", "path"],
+ "nameExplicit": false,
+ "name": "revision_embeddings_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "columns": ["delivery_id", "revision_id", "role"],
+ "nameExplicit": false,
+ "name": "revision_receipts_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "revision_receipts"
+ },
+ {
+ "columns": ["revision_id", "occurrence"],
+ "nameExplicit": false,
+ "name": "revision_relations_pkey",
+ "entityType": "pks",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "accounts_pkey",
+ "schema": "public",
+ "table": "accounts",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "activities_pkey",
+ "schema": "public",
+ "table": "activities",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "activity_deliveries_pkey",
+ "schema": "public",
+ "table": "activity_deliveries",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "activity_delivery_attempts_pkey",
+ "schema": "public",
+ "table": "activity_delivery_attempts",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "actors_pkey",
+ "schema": "public",
+ "table": "actors",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "addressing_pkey",
+ "schema": "public",
+ "table": "addressing",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "collections_pkey",
+ "schema": "public",
+ "table": "collections",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "instances_pkey",
+ "schema": "public",
+ "table": "instances",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "key_versions_pkey",
+ "schema": "public",
+ "table": "key_versions",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "keys_pkey",
+ "schema": "public",
+ "table": "keys",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "local_actors_pkey",
+ "schema": "public",
+ "table": "local_actors",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "local_instances_pkey",
+ "schema": "public",
+ "table": "local_instances",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "login_tokens_pkey",
+ "schema": "public",
+ "table": "login_challenges",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "objects_pkey",
+ "schema": "public",
+ "table": "objects",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["resource_id"],
+ "nameExplicit": false,
+ "name": "resource_heads_pkey",
+ "schema": "public",
+ "table": "resource_heads",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "resource_revisions_pkey",
+ "schema": "public",
+ "table": "resource_revisions",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "resources_pkey",
+ "schema": "public",
+ "table": "resources",
+ "entityType": "pks"
+ },
+ {
+ "columns": ["id"],
+ "nameExplicit": false,
+ "name": "sessions_pkey",
+ "schema": "public",
+ "table": "sessions",
+ "entityType": "pks"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["source_id", "property", "position"],
+ "nullsNotDistinct": false,
+ "name": "addressing_source_property_position_key",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "addressing"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["key_id", "fingerprint"],
+ "nullsNotDistinct": false,
+ "name": "key_versions_key_id_fingerprint_unique",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["activity_id"],
+ "nullsNotDistinct": false,
+ "name": "objects_activity_id_key",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["resource_id", "sequence"],
+ "nullsNotDistinct": false,
+ "name": "resource_revisions_resource_sequence_key",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "nameExplicit": true,
+ "columns": ["resource_id", "id"],
+ "nullsNotDistinct": false,
+ "name": "resource_revisions_resource_id_key",
+ "entityType": "uniques",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["email"],
+ "nullsNotDistinct": false,
+ "name": "accounts_email_key",
+ "schema": "public",
+ "table": "accounts",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["local_id"],
+ "nullsNotDistinct": false,
+ "name": "actors_localId_key",
+ "schema": "public",
+ "table": "actors",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["host"],
+ "nullsNotDistinct": false,
+ "name": "instances_host_key",
+ "schema": "public",
+ "table": "instances",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["iri"],
+ "nullsNotDistinct": false,
+ "name": "keys_iri_key",
+ "schema": "public",
+ "table": "keys",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["slug"],
+ "nullsNotDistinct": false,
+ "name": "local_instances_slug_key",
+ "schema": "public",
+ "table": "local_instances",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["iri"],
+ "nullsNotDistinct": false,
+ "name": "resources_iri_key",
+ "schema": "public",
+ "table": "resources",
+ "entityType": "uniques"
+ },
+ {
+ "nameExplicit": false,
+ "columns": ["token_hash"],
+ "nullsNotDistinct": false,
+ "name": "sessions_tokenHash_key",
+ "schema": "public",
+ "table": "sessions",
+ "entityType": "uniques"
+ },
+ {
+ "value": "\"email\" ~ '^[^@]+@[^@]+\\.[^@]+$'",
+ "name": "accounts_email_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "value": "\"max_instances\" >= 0",
+ "name": "accounts_max_instances_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "value": "trim(both from \"name\") <> ''",
+ "name": "accounts_name_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "accounts"
+ },
+ {
+ "value": "(\"direction\" = 'inbound' AND \"status\" IN ('received', 'acknowledged', 'unverified', 'rejected')) OR (\"direction\" = 'outbound' AND \"status\" IN ('queued', 'sent', 'failed', 'permanently_failed', 'abandoned'))",
+ "name": "activity_deliveries_direction_status_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "(\"completed\" IS NULL) = (\"status\" = 'queued')",
+ "name": "activity_deliveries_completed_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"status_code\" IS NULL OR \"status_code\" BETWEEN 100 AND 599",
+ "name": "activity_deliveries_status_code_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"direction\" <> 'outbound' OR \"verification_key_id\" IS NULL",
+ "name": "activity_deliveries_outbound_key_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "(\"direction\" = 'inbound') = (\"verification_result\" IS NOT NULL)",
+ "name": "activity_deliveries_verification_result_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"verification_mechanism\" IS NULL OR (\"direction\" = 'inbound' AND \"verification_result\" NOT IN ('unattempted', 'unobserved'))",
+ "name": "activity_deliveries_verification_mechanism_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "(\"direction\" = 'inbound') = (\"body\" IS NOT NULL)",
+ "name": "activity_deliveries_body_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"activity_id\" IS NULL OR \"direction\" = 'outbound' OR (\"verification_result\" = 'verified' AND \"status\" IN ('received', 'acknowledged'))",
+ "name": "activity_deliveries_activity_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_deliveries"
+ },
+ {
+ "value": "\"inbox_owner\" OR \"addressed\" OR \"sender\"",
+ "name": "activity_delivery_actors_role_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "value": "NOT \"addressed_directly\" OR \"addressed\"",
+ "name": "activity_delivery_actors_addressed_directly_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_delivery_actors"
+ },
+ {
+ "value": "\"status_code\" IS NULL OR \"status_code\" BETWEEN 100 AND 599",
+ "name": "activity_delivery_attempts_status_code_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "value": "\"succeeded\" = (\"error\" IS NULL)",
+ "name": "activity_delivery_attempts_error_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "activity_delivery_attempts"
+ },
+ {
+ "value": "\"local_id\" IS NULL OR \"username\" NOT LIKE '%@%'",
+ "name": "actors_username_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "value": "\"local_id\" IS NULL OR \"username\" IS NOT NULL",
+ "name": "actors_local_username_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "value": "\n \"suspended_until\" IS NULL OR (\n \"suspended\" IS NOT NULL AND\n \"suspended_until\" > \"suspended\"\n )\n ",
+ "name": "actors_suspended_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "actors"
+ },
+ {
+ "value": "\"last_seen\" >= \"first_seen\"",
+ "name": "key_versions_seen_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "value": "NOT (\"public_key\" ?| array['d','p','q','dp','dq','qi','oth','k'])",
+ "name": "key_versions_public_key_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "key_versions"
+ },
+ {
+ "value": "jsonb_typeof(\"public_key\") = 'object' AND NOT (\"public_key\" ?| array['d','p','q','dp','dq','qi','oth','k'])",
+ "name": "local_actor_keys_public_key_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "local_actor_keys"
+ },
+ {
+ "value": "\"slug\" ~ '^[a-z0-9][a-z0-9-]{2,61}[a-z0-9]$'\n AND (\"slug\" !~ '^..--' OR \"slug\" ~ '^xn--')",
+ "name": "local_instances_slug_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "value": "\"max_actors\" > 0",
+ "name": "instances_max_actors_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "local_instances"
+ },
+ {
+ "value": "trim(both from \"content_html\") <> ''",
+ "name": "objects_content_html_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "objects"
+ },
+ {
+ "value": "\"sequence\" > 0",
+ "name": "resource_revisions_sequence_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "value": "(\"kind\" = 'snapshot' AND \"document\" IS NOT NULL)\n OR (\"kind\" IN ('unavailable', 'whiteout') AND \"document\" IS NULL)",
+ "name": "resource_revisions_document_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "value": "(\"kind\" = 'whiteout' AND \"deleted\" IS NOT NULL AND \"former_types\" IS NOT NULL)\n OR (\"kind\" <> 'whiteout' AND \"deleted\" IS NULL AND \"former_types\" IS NULL)",
+ "name": "resource_revisions_deletion_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "resource_revisions"
+ },
+ {
+ "value": "\"position\" >= 0",
+ "name": "revision_addressing_position_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_addressing"
+ },
+ {
+ "value": "jsonb_typeof(\"path\") = 'array' AND jsonb_array_length(\"path\") > 0",
+ "name": "revision_embeddings_path_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "value": "\"source_revision_id\" <> \"revision_id\"",
+ "name": "revision_embeddings_source_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_embeddings"
+ },
+ {
+ "value": "\"occurrence\" >= 0",
+ "name": "revision_relations_occurrence_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "value": "\"path\" IS NULL OR json_typeof(\"path\") = 'array'",
+ "name": "revision_relations_path_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_relations"
+ },
+ {
+ "value": "\"representation\" <> 'reference' OR \"target_iri\" IS NOT NULL",
+ "name": "revision_relations_reference_check",
+ "entityType": "checks",
+ "schema": "public",
+ "table": "revision_relations"
+ }
+ ],
+ "renames": []
+}
diff --git a/packages/models/migrations-manifest.json b/packages/models/migrations-manifest.json
index 2d307ad9..de887f8c 100644
--- a/packages/models/migrations-manifest.json
+++ b/packages/models/migrations-manifest.json
@@ -116,6 +116,14 @@
{
"name": "20261026192411_capture_legacy_resource_revisions",
"sha256": "25deff8bc6684620fb679c1d339c8803cdcb1b5a8c5f9a9771c95411a185eee3"
+ },
+ {
+ "name": "20261113080536_revision_embeddings",
+ "sha256": "52427c6e8a430652bbca4aa351bcb35d0933ac372b221e9dd13cd2a537c68084"
+ },
+ {
+ "name": "20261113080537_guard_revision_embeddings",
+ "sha256": "565918b747d0a6d092cdb1d68cf709a729b705c17489b2e333aca294c692b8f5"
}
]
}
diff --git a/packages/models/src/document.test.ts b/packages/models/src/document.test.ts
index 28434066..4d997d17 100644
--- a/packages/models/src/document.test.ts
+++ b/packages/models/src/document.test.ts
@@ -4126,6 +4126,7 @@ describe("describeDocument() semantic view", () => {
},
],
custom: { type: "Note", actor: "https://example.com/mallory" },
+ "https://ext.example/ns#flag": true,
};
const original = structuredClone(input);
const nodes = describeDocument(input);
@@ -4165,6 +4166,12 @@ describe("describeDocument() semantic view", () => {
object: ["object"],
type: ["type"],
});
+ // Neither `@context` nor any key of a standard property is an extension.
+ assert.deepEqual(nodes[0]!.extensionProperties, [
+ "custom",
+ "https://ext.example/ns#flag",
+ ]);
+ assert.deepEqual(nodes[1]!.extensionProperties, []);
assert.deepEqual(input, original);
});
diff --git a/packages/models/src/document.ts b/packages/models/src/document.ts
index 7d37fc1e..6d7ddcd1 100644
--- a/packages/models/src/document.ts
+++ b/packages/models/src/document.ts
@@ -89,6 +89,7 @@ export const DIAGNOSTIC_REASONS = {
invalid_context: { category: "vocabulary", severity: "error" },
unauthorized_local_identity: { category: "authority", severity: "error" },
server_owned_field_conflict: { category: "authority", severity: "error" },
+ source_unavailable: { category: "authority", severity: "error" },
context_unavailable_offline: { category: "support", severity: "error" },
unsupported_context_form: { category: "support", severity: "error" },
unsupported_type: { category: "support", severity: "error" },
@@ -2602,6 +2603,12 @@ export interface DocumentNode {
* not listed.
*/
readonly properties: ReadonlyMap;
+ /**
+ * The source keys of the document's own custom extension properties, whose
+ * values are preserved as opaque JSON, sorted by key. Together with
+ * the keys in `properties` and `@context`, they are all of its keys.
+ */
+ readonly extensionProperties: readonly string[];
/**
* String IRI references held by this document's own reference properties
* (`id`, `actor`, `object`, addressing, `href`, and so on), with compact
@@ -3043,6 +3050,10 @@ export function describeDocument(
fields.filter(({ compatible }) => compatible),
context,
),
+ // Validation has reported any other unnamed key as an error.
+ extensionProperties: fields
+ .filter(({ name }) => name == null)
+ .map(({ source }) => source),
}));
const described = [
...extensions.map(({ values, path, context }) =>
diff --git a/packages/models/src/relations.ts b/packages/models/src/relations.ts
index 31bd4c0b..e848c384 100644
--- a/packages/models/src/relations.ts
+++ b/packages/models/src/relations.ts
@@ -37,6 +37,11 @@ export const relations = defineRelations(schema, (r) => ({
from: r.resourceRevisions.id,
to: r.revisionReceipts.revisionId,
}),
+ embeddings: r.many.revisionEmbeddings({
+ from: r.resourceRevisions.id,
+ to: r.revisionEmbeddings.revisionId,
+ alias: "embeddings",
+ }),
},
resourceHeads: {
resource: r.one.resources({
@@ -64,6 +69,19 @@ export const relations = defineRelations(schema, (r) => ({
optional: false,
}),
},
+ revisionEmbeddings: {
+ revision: r.one.resourceRevisions({
+ from: r.revisionEmbeddings.revisionId,
+ to: r.resourceRevisions.id,
+ optional: false,
+ alias: "embeddings",
+ }),
+ source: r.one.resourceRevisions({
+ from: r.revisionEmbeddings.sourceRevisionId,
+ to: r.resourceRevisions.id,
+ optional: false,
+ }),
+ },
revisionReceipts: {
revision: r.one.resourceRevisions({
from: r.revisionReceipts.revisionId,
@@ -405,7 +423,6 @@ export const relations = defineRelations(schema, (r) => ({
objects: r.many.objects({
from: r.actors.id,
to: r.objects.actorId,
- where: { deleted: { isNull: true } },
}),
instance: r.one.instances({
from: r.actors.instanceId,
diff --git a/packages/models/src/resource-revision-embedding.test.ts b/packages/models/src/resource-revision-embedding.test.ts
new file mode 100644
index 00000000..209ecdb1
--- /dev/null
+++ b/packages/models/src/resource-revision-embedding.test.ts
@@ -0,0 +1,379 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// Writes in one test depend on the state left by the previous ones.
+// oxlint-disable no-await-in-loop
+
+import assert from "node:assert/strict";
+import { it } from "node:test";
+
+import { ensureResource, storeAddressing } from "@drfed/models/resource";
+import {
+ type RevisionEmbeddingInput,
+ appendResourceRevision,
+ captureLegacyResourceRevision,
+ loadCurrentResourceRevision,
+ writeTypedResourceRevision,
+} from "@drfed/models/resource-revision";
+import { type Uuid, uuidV7 } from "@drfed/models/uuid";
+
+import {
+ type RevisionFixture,
+ revisionBackends,
+ revisionPostgresUrl,
+ withRevisionDatabase,
+} from "./resource-revision-fixture.ts";
+
+const PUBLIC = "https://www.w3.org/ns/activitystreams#Public";
+
+async function snapshot(
+ fixture: RevisionFixture,
+ document: Record,
+ embeddings?: readonly RevisionEmbeddingInput[],
+) {
+ const resource = await ensureResource(
+ fixture.db,
+ `https://example.test/resources/${uuidV7()}`,
+ );
+ const revision = await appendResourceRevision(fixture.db, {
+ resourceId: resource.id,
+ resourceKind: "object",
+ expectedRevisionId: null,
+ kind: "snapshot",
+ document,
+ capture: "local",
+ ...(embeddings === undefined ? {} : { embeddings }),
+ });
+ return { resource, revision };
+}
+
+async function embeddingRows(fixture: RevisionFixture, revisionId: string) {
+ const { rows } = await fixture.query<{
+ path: string;
+ source_revision_id: string;
+ relation: string;
+ }>(
+ "SELECT path::text AS path, source_revision_id, relation::text AS relation FROM revision_embeddings WHERE revision_id = $1 ORDER BY path::text",
+ [revisionId],
+ );
+ return rows.map(({ path, source_revision_id, relation }) => ({
+ path: JSON.parse(path) as unknown,
+ sourceRevisionId: source_revision_id,
+ relation,
+ }));
+}
+
+// Drivers wrap database errors; the constraint name may sit on a cause.
+function constraintOf(error: unknown): string | undefined {
+ let detail: unknown = error;
+ while (detail instanceof Error) {
+ for (const key of ["constraint", "constraint_name"]) {
+ const value = (detail as unknown as Record)[key];
+ if (typeof value === "string") return value;
+ }
+ detail = detail.cause;
+ }
+ return undefined;
+}
+
+async function rejectsWith(
+ run: () => Promise,
+ constraint: string,
+): Promise {
+ await assert.rejects(run, (error) => {
+ assert.equal(constraintOf(error), constraint);
+ return true;
+ });
+}
+
+for (const backend of revisionBackends) {
+ const options = { skip: backend === "postgres" && !revisionPostgresUrl };
+
+ it(
+ `stores embeddings with an appended snapshot on ${backend}`,
+ options,
+ async () => {
+ await withRevisionDatabase(backend, async (fixture) => {
+ const note = await snapshot(fixture, { type: "Note", content: "a" });
+ const like = await snapshot(fixture, { type: "Note", content: "b" });
+ const parent = await snapshot(fixture, { type: "Create" }, [
+ {
+ path: ["object", 0],
+ sourceRevisionId: note.revision.id,
+ relation: "snapshot",
+ },
+ {
+ path: ["object", 1, "inReplyTo"],
+ sourceRevisionId: like.revision.id,
+ relation: "derived",
+ },
+ ]);
+ assert.deepEqual(await embeddingRows(fixture, parent.revision.id), [
+ {
+ path: ["object", 0],
+ sourceRevisionId: note.revision.id,
+ relation: "snapshot",
+ },
+ {
+ path: ["object", 1, "inReplyTo"],
+ sourceRevisionId: like.revision.id,
+ relation: "derived",
+ },
+ ]);
+ // The relations reach the rows from either side.
+ const loaded = await fixture.db.query.resourceRevisions.findFirst({
+ where: { id: parent.revision.id },
+ with: { embeddings: { with: { source: true } } },
+ });
+ assert.deepEqual(
+ loaded?.embeddings
+ .map(({ source }) => source.id)
+ .toSorted((left, right) => left.localeCompare(right)),
+ [note.revision.id, like.revision.id].toSorted((left, right) =>
+ left.localeCompare(right),
+ ),
+ );
+ // A snapshot without embeddings stores none.
+ assert.deepEqual(await embeddingRows(fixture, note.revision.id), []);
+ });
+ },
+ );
+
+ it(`stores embeddings with a typed edit on ${backend}`, options, async () => {
+ await withRevisionDatabase(backend, async (fixture) => {
+ const instanceId = uuidV7();
+ const actorId = uuidV7();
+ const objectId = uuidV7() as Uuid;
+ const iri = `https://typed.example/objects/${objectId}`;
+ const document = { id: iri, type: "Note", content: "first" };
+ await fixture.query("INSERT INTO instances (id, host) VALUES ($1, $2)", [
+ instanceId,
+ `${instanceId}.example`,
+ ]);
+ await fixture.query(
+ "INSERT INTO resources (id, iri, kind) VALUES ($1, $2, 'actor'), ($3, $4, 'object')",
+ [actorId, `https://typed.example/actors/${actorId}`, objectId, iri],
+ );
+ await fixture.query(
+ "INSERT INTO actors (id, type, instance_id, inbox_url) VALUES ($1, 'Person', $2, 'https://typed.example/inbox')",
+ [actorId, instanceId],
+ );
+ await fixture.query(
+ "INSERT INTO objects (id, actor_id, type, content_html, document) VALUES ($1, $2, 'Note', 'first', $3::json)",
+ [objectId, actorId, JSON.stringify(document)],
+ );
+ const revisionId = await fixture.db.transaction(async (tx) => {
+ await storeAddressing(tx, objectId, { to: [PUBLIC] });
+ return await captureLegacyResourceRevision(tx, objectId);
+ });
+ const attachment = await snapshot(fixture, {
+ type: "Document",
+ name: "attached",
+ });
+ const edited = await writeTypedResourceRevision(fixture.db, {
+ resourceId: objectId,
+ expectedRevisionId: revisionId,
+ kind: "snapshot",
+ document: {
+ ...document,
+ content: "second",
+ attachment: { type: "Document", name: "attached" },
+ },
+ columns: {
+ url: null,
+ name: null,
+ summary: null,
+ contentHtml: "second",
+ language: null,
+ sensitive: false,
+ published: Temporal.Instant.from("2026-11-01T00:00:00Z"),
+ updated: Temporal.Instant.from("2026-11-02T00:00:00Z"),
+ },
+ addressingOccurrences: [{ property: "to", position: 0, iri: PUBLIC }],
+ embeddings: [
+ {
+ path: ["attachment"],
+ sourceRevisionId: attachment.revision.id,
+ relation: "snapshot",
+ },
+ ],
+ });
+ assert.equal(edited.sequence, 2);
+ assert.deepEqual(await embeddingRows(fixture, edited.id), [
+ {
+ path: ["attachment"],
+ sourceRevisionId: attachment.revision.id,
+ relation: "snapshot",
+ },
+ ]);
+ });
+ });
+
+ it(
+ `rejects embedding sources that are no other resource's snapshot on ${backend}`,
+ options,
+ async () => {
+ await withRevisionDatabase(backend, async (fixture) => {
+ const deleted = await snapshot(fixture, { type: "Note" });
+ const whiteout = await appendResourceRevision(fixture.db, {
+ resourceId: deleted.resource.id,
+ resourceKind: "object",
+ expectedRevisionId: deleted.revision.id,
+ kind: "whiteout",
+ deleted: Temporal.Now.instant(),
+ formerTypes: ["Note"],
+ });
+ const embedding = (sourceRevisionId: Uuid): RevisionEmbeddingInput => ({
+ path: ["object"],
+ sourceRevisionId,
+ relation: "snapshot",
+ });
+ await rejectsWith(
+ () => snapshot(fixture, { type: "Create" }, [embedding(whiteout.id)]),
+ "revision_embeddings_source_kind_guard",
+ );
+ await rejectsWith(
+ () =>
+ snapshot(fixture, { type: "Create" }, [
+ embedding(uuidV7() as Uuid),
+ ]),
+ "revision_embeddings_source_revision_fkey",
+ );
+ const edited = await snapshot(fixture, { type: "Note" });
+ await rejectsWith(
+ () =>
+ appendResourceRevision(fixture.db, {
+ resourceId: edited.resource.id,
+ resourceKind: "object",
+ expectedRevisionId: edited.revision.id,
+ kind: "snapshot",
+ document: { type: "Note", content: "again" },
+ capture: "local",
+ embeddings: [embedding(edited.revision.id)],
+ }),
+ "revision_embeddings_source_resource_guard",
+ );
+ // A rejected embedding leaves no part of the revision behind.
+ const head = await loadCurrentResourceRevision(
+ fixture.db,
+ edited.resource.id,
+ );
+ assert.equal(head?.id, edited.revision.id);
+ const { rows } = await fixture.query<{ count: number }>(
+ "SELECT count(*)::int AS count FROM resource_revisions WHERE kind = 'snapshot' AND document::text = $1",
+ [JSON.stringify({ type: "Create" })],
+ );
+ assert.equal(Number(rows[0]?.count), 0);
+ });
+ },
+ );
+
+ it(
+ `seals embeddings with their published revision on ${backend}`,
+ options,
+ async () => {
+ await withRevisionDatabase(backend, async (fixture) => {
+ const note = await snapshot(fixture, { type: "Note" });
+ const other = await snapshot(fixture, { type: "Note" });
+ const parent = await snapshot(fixture, { type: "Create" }, [
+ {
+ path: ["object"],
+ sourceRevisionId: note.revision.id,
+ relation: "snapshot",
+ },
+ ]);
+ await rejectsWith(
+ () =>
+ fixture.query(
+ `INSERT INTO revision_embeddings (revision_id, path, source_revision_id, relation) VALUES ($1, '["target"]', $2, 'derived')`,
+ [parent.revision.id, other.revision.id],
+ ),
+ "revision_embeddings_sealed",
+ );
+ await rejectsWith(
+ () =>
+ fixture.query(
+ "UPDATE revision_embeddings SET relation = 'derived' WHERE revision_id = $1",
+ [parent.revision.id],
+ ),
+ "revision_embeddings_immutable",
+ );
+ await rejectsWith(
+ () =>
+ fixture.query(
+ "DELETE FROM revision_embeddings WHERE revision_id = $1",
+ [parent.revision.id],
+ ),
+ "revision_embeddings_immutable",
+ );
+ await rejectsWith(
+ () => fixture.query("TRUNCATE revision_embeddings"),
+ "revision_embeddings_immutable",
+ );
+ assert.equal(
+ (await embeddingRows(fixture, parent.revision.id)).length,
+ 1,
+ );
+ });
+ },
+ );
+
+ it(
+ `validates embedding input before writing on ${backend}`,
+ options,
+ async () => {
+ await withRevisionDatabase(backend, async (fixture) => {
+ const note = await snapshot(fixture, { type: "Note" });
+ const sourceRevisionId = note.revision.id;
+ const invalid: unknown[] = [
+ "not a list",
+ [{ path: [], sourceRevisionId, relation: "snapshot" }],
+ [{ path: "object", sourceRevisionId, relation: "snapshot" }],
+ [{ path: ["object", -1], sourceRevisionId, relation: "snapshot" }],
+ [{ path: ["object", 1.5], sourceRevisionId, relation: "snapshot" }],
+ [{ path: [true], sourceRevisionId, relation: "snapshot" }],
+ [
+ { path: ["object"], sourceRevisionId, relation: "snapshot" },
+ { path: ["object"], sourceRevisionId, relation: "derived" },
+ ],
+ [
+ {
+ path: ["object"],
+ sourceRevisionId: "not-a-uuid",
+ relation: "snapshot",
+ },
+ ],
+ [{ path: ["object"], sourceRevisionId, relation: "copy" }],
+ ];
+ for (const embeddings of invalid) {
+ await assert.rejects(
+ () =>
+ snapshot(
+ fixture,
+ { type: "Create" },
+ embeddings as readonly RevisionEmbeddingInput[],
+ ),
+ TypeError,
+ );
+ }
+ const { rows } = await fixture.query<{ count: number }>(
+ "SELECT count(*)::int AS count FROM revision_embeddings",
+ );
+ assert.equal(Number(rows[0]?.count), 0);
+ });
+ },
+ );
+}
diff --git a/packages/models/src/resource-revision.ts b/packages/models/src/resource-revision.ts
index 0c2ad7b8..54aaa4e7 100644
--- a/packages/models/src/resource-revision.ts
+++ b/packages/models/src/resource-revision.ts
@@ -31,6 +31,7 @@ import {
type NewActivityPubObject,
type ResourceRevision,
type RevisionAddressing,
+ type RevisionEmbedding,
type RevisionRelation,
activities,
addressingPropertyEnum,
@@ -42,6 +43,8 @@ import {
resourceRevisions,
resources,
revisionAddressing,
+ revisionEmbeddingRelationEnum,
+ revisionEmbeddings,
revisionRelations,
} from "./schema.ts";
import { storableText } from "./text.ts";
@@ -67,6 +70,19 @@ export interface RevisionRelationInput {
readonly targetIri?: string | null;
}
+/**
+ * Where an embedded document of a new snapshot came from, as
+ * `revisionEmbeddings` records it. The caller decides the relation by
+ * comparing the documents; nothing is compared here.
+ */
+export interface RevisionEmbeddingInput {
+ /** The embedded document's source path from the root; never `[]`. */
+ readonly path: readonly (string | number)[];
+ /** A snapshot of another resource, stored before this revision. */
+ readonly sourceRevisionId: Uuid;
+ readonly relation: RevisionEmbedding["relation"];
+}
+
interface AppendBase {
readonly resourceId: Uuid;
readonly resourceKind: "object" | "activity";
@@ -86,6 +102,8 @@ export type AppendResourceRevisionInput = AppendBase &
*/
readonly addressingOccurrences?: readonly AddressingOccurrence[];
readonly relations?: readonly RevisionRelationInput[];
+ /** Embedded documents whose source is known, each path once. */
+ readonly embeddings?: readonly RevisionEmbeddingInput[];
readonly projection?: ResourceRevision["projection"];
}
| {
@@ -241,6 +259,44 @@ function relationRows(
});
}
+function embeddingRows(
+ input: readonly RevisionEmbeddingInput[] = [],
+): Omit[] {
+ if (!Array.isArray(input)) {
+ throw new TypeError("Embedding projections must be arrays.");
+ }
+ const paths = new Set();
+ return input.map(({ path, sourceRevisionId, relation }) => {
+ if (
+ !Array.isArray(path) ||
+ path.length < 1 ||
+ Array.from(path).some(
+ (part) =>
+ typeof part !== "string" &&
+ !(Number.isSafeInteger(part) && part >= 0),
+ )
+ ) {
+ throw new TypeError(
+ "An embedding path must name a nonempty list of field names and " +
+ "nonnegative indexes.",
+ );
+ }
+ for (const part of path) if (typeof part === "string") text(part);
+ const key = JSON.stringify(path);
+ if (paths.has(key)) {
+ throw new TypeError("Each embedding path must be given once.");
+ }
+ paths.add(key);
+ if (!validateUuid(sourceRevisionId)) {
+ throw new TypeError("Expected a source revision UUID.");
+ }
+ if (!revisionEmbeddingRelationEnum.enumValues.includes(relation)) {
+ throw new TypeError("Invalid embedding relation.");
+ }
+ return { path: [...path], sourceRevisionId, relation };
+ });
+}
+
async function current(
db: Database | Transaction,
resourceId: Uuid,
@@ -286,6 +342,7 @@ interface PreparedRevision extends AppendBase {
readonly projection: ResourceRevision["projection"] | undefined;
readonly addressing: Omit[];
readonly relations: Omit[];
+ readonly embeddings: Omit[];
readonly deleted: Temporal.Instant | null;
readonly formerTypes: string[] | null;
}
@@ -330,6 +387,7 @@ function prepareSnapshot(
projection,
addressing,
relations: relationRows(input.relations),
+ embeddings: embeddingRows(input.embeddings),
deleted: null,
formerTypes: null,
};
@@ -353,6 +411,7 @@ function prepareWhiteout(
projection: undefined,
addressing: [],
relations: [],
+ embeddings: [],
deleted: input.deleted,
formerTypes,
};
@@ -473,6 +532,7 @@ async function appendPrepared(
formerTypes,
addressing,
relations,
+ embeddings,
} = input;
const id = uuidV7();
const [revision] = await tx
@@ -511,6 +571,11 @@ async function appendPrepared(
.insert(revisionRelations)
.values(relations.map((row) => ({ ...row, revisionId: id })));
}
+ if (embeddings.length > 0) {
+ await tx
+ .insert(revisionEmbeddings)
+ .values(embeddings.map((row) => ({ ...row, revisionId: id })));
+ }
if (previous === null) {
await tx.insert(resourceHeads).values({ resourceId, revisionId: id });
} else {
@@ -661,6 +726,8 @@ export type TypedResourceRevisionInput = TypedRevisionBase &
Partial>;
readonly addressingOccurrences: readonly AddressingOccurrence[];
readonly relations?: readonly RevisionRelationInput[];
+ /** Embedded documents whose source is known, each path once. */
+ readonly embeddings?: readonly RevisionEmbeddingInput[];
readonly projection?: ResourceRevision["projection"];
}
| {
@@ -740,6 +807,9 @@ export async function writeTypedResourceRevision(
...(input.relations === undefined
? {}
: { relations: input.relations }),
+ ...(input.embeddings === undefined
+ ? {}
+ : { embeddings: input.embeddings }),
...(input.projection === undefined
? {}
: { projection: input.projection }),
diff --git a/packages/models/src/schema.ts b/packages/models/src/schema.ts
index 38240612..6d4a7839 100644
--- a/packages/models/src/schema.ts
+++ b/packages/models/src/schema.ts
@@ -1064,6 +1064,47 @@ export const revisionRelations = pgTable(
],
);
+export const revisionEmbeddingRelationEnum = pgEnum(
+ "revision_embedding_relation",
+ ["snapshot", "derived"],
+);
+/**
+ * Where an embedded document of a revision came from, recorded when the
+ * revision was saved: the revision of another resource whose contents it
+ * keeps, apart from the context it inherits, or from which it was derived.
+ * An embedded document without a row has an unknown source. Rows are part
+ * of the immutable history of their revision.
+ */
+export const revisionEmbeddings = pgTable(
+ "revision_embeddings",
+ {
+ revisionId: uuid("revision_id")
+ .$type()
+ .notNull()
+ .references(() => resourceRevisions.id, { onDelete: "restrict" }),
+ path: jsonb().$type().notNull(),
+ sourceRevisionId: uuid("source_revision_id").$type().notNull(),
+ relation: revisionEmbeddingRelationEnum().notNull(),
+ },
+ (t) => [
+ primaryKey({ columns: [t.revisionId, t.path] }),
+ foreignKey({
+ name: "revision_embeddings_source_revision_fkey",
+ columns: [t.sourceRevisionId],
+ foreignColumns: [resourceRevisions.id],
+ }).onDelete("restrict"),
+ check(
+ "revision_embeddings_path_check",
+ sql`jsonb_typeof(${t.path}) = 'array' AND jsonb_array_length(${t.path}) > 0`,
+ ),
+ check(
+ "revision_embeddings_source_check",
+ sql`${t.sourceRevisionId} <> ${t.revisionId}`,
+ ),
+ index("revision_embeddings_source_index").on(t.sourceRevisionId),
+ ],
+);
+
export const revisionReceiptRoleEnum = pgEnum("revision_receipt_role", [
"activity",
"object",
@@ -1094,3 +1135,4 @@ export type ResourceHead = typeof resourceHeads.$inferSelect;
export type RevisionAddressing = typeof revisionAddressing.$inferSelect;
export type RevisionRelation = typeof revisionRelations.$inferSelect;
export type RevisionReceipt = typeof revisionReceipts.$inferSelect;
+export type RevisionEmbedding = typeof revisionEmbeddings.$inferSelect;
diff --git a/packages/web/src/components/ActivityLogBox.tsx b/packages/web/src/components/ActivityLogBox.tsx
index 2e36e96f..9601cc39 100644
--- a/packages/web/src/components/ActivityLogBox.tsx
+++ b/packages/web/src/components/ActivityLogBox.tsx
@@ -14,10 +14,13 @@
// You should have received a copy of the GNU Affero General Public License
// along with this program. If not, see .
+import { A } from "@solidjs/router";
import { graphql } from "relay-runtime";
import { For, Show, createMemo, createSignal } from "solid-js";
import { createFragment } from "solid-relay";
+import { resourceHref } from "~/resource.ts";
+
import type { ActivityLogBox_log$key } from "./__generated__/ActivityLogBox_log.graphql.ts";
import { ActivityLogSource } from "./ActivityLogSource.tsx";
import { CopyButton } from "./CopyButton.tsx";
@@ -46,6 +49,15 @@ export function ActivityLogBox(props: { $log: ActivityLogBox_log$key }) {
created
payload
rawBody
+ activity {
+ resource {
+ id
+ }
+ object {
+ id
+ kind
+ }
+ }
}
`,
() => props.$log,
@@ -117,6 +129,27 @@ export function ActivityLogBox(props: { $log: ActivityLogBox_log$key }) {
+
+ {(activity) => (
+
+
+ Activity history
+
+
+ {(object) => (
+ Object history
+ )}
+
+
+ )}
+
{log().direction === "inbound" && log().payload == undefined
? "Raw received body"
diff --git a/packages/web/src/components/ActorObjectList.tsx b/packages/web/src/components/ActorObjectList.tsx
index c44dfc9e..b9eb26eb 100644
--- a/packages/web/src/components/ActorObjectList.tsx
+++ b/packages/web/src/components/ActorObjectList.tsx
@@ -14,24 +14,39 @@
// You should have received a copy of the GNU Affero General Public License
// along with this program. If not, see .
+import { A } from "@solidjs/router";
import { graphql } from "relay-runtime";
-import { For, Show } from "solid-js";
-import { createFragment } from "solid-relay";
+import { For, Show, createSignal } from "solid-js";
+import { createRefetchableFragment } from "solid-relay";
+
+import { resourceHref } from "~/resource.ts";
import type { ActorObjectList_actor$key } from "./__generated__/ActorObjectList_actor.graphql.ts";
+import type { ActorObjectListRefetchQuery } from "./__generated__/ActorObjectListRefetchQuery.graphql.ts";
import { CopyButton } from "./CopyButton.tsx";
+import { FilterCheckbox, FilterDisclosure } from "./FilterDisclosure.tsx";
+import { LoadingIndicator } from "./LoadingIndicator.tsx";
import styles from "~/styles/actor.module.css";
/**
- * Displays an actor's latest objects with their raw HTML content.
+ * Displays an actor's latest objects with their raw HTML content, and those
+ * it deleted when the filter asks for them.
* @returns The object list or its empty state.
*/
export function ActorObjectList(props: { $actor: ActorObjectList_actor$key }) {
- const data = createFragment(
+ const [data, refetch] = createRefetchableFragment<
+ ActorObjectListRefetchQuery,
+ ActorObjectList_actor$key
+ >(
graphql`
- fragment ActorObjectList_actor on Actor @throwOnFieldError {
- objects(first: 20) {
+ fragment ActorObjectList_actor on Actor
+ @throwOnFieldError
+ @argumentDefinitions(
+ includeDeleted: { type: "Boolean", defaultValue: false }
+ )
+ @refetchable(queryName: "ActorObjectListRefetchQuery") {
+ objects(first: 20, filter: { includeDeleted: $includeDeleted }) {
edges {
node {
id
@@ -39,7 +54,11 @@ export function ActorObjectList(props: { $actor: ActorObjectList_actor$key }) {
name
contentHtml
published
+ deleted
iri
+ resource {
+ id
+ }
}
}
}
@@ -47,12 +66,48 @@ export function ActorObjectList(props: { $actor: ActorObjectList_actor$key }) {
`,
() => props.$actor,
);
+ const [includeDeleted, setIncludeDeleted] = createSignal(false);
+ const [pending, setPending] = createSignal(false);
+ const [failed, setFailed] = createSignal(false);
+ function filterDeleted(checked: boolean) {
+ setIncludeDeleted(checked);
+ setPending(true);
+ setFailed(false);
+ refetch(
+ { includeDeleted: checked },
+ {
+ fetchPolicy: "store-and-network",
+ onComplete(error) {
+ setPending(false);
+ setFailed(error != undefined);
+ },
+ },
+ );
+ }
return (
-
+
{(actor) => (
- Objects
+
+
+
+
+
+
+ Could not load the objects. Change the filter to try again.
+
+
0}
fallback={No objects yet.
}
@@ -62,10 +117,29 @@ export function ActorObjectList(props: { $actor: ActorObjectList_actor$key }) {
{(edge) => (
{(object) => (
-
+
+
+ {WORDING.sourceLink(source().revision.sequence)}
+
+
+
+ {WORDING.currentLink}
+
+
+
+ )}
+
+ );
+}
+
+/**
+ * A relation value drawn as one line: a reference, a `Link`, or an embedded
+ * document that is not expanded.
+ * @returns The line.
+ */
+function RelationLine(props: {
+ $relation: ResourceDocumentRelation_relation$key;
+}) {
+ const data = createFragment(
+ graphql`
+ fragment ResourceDocumentRelation_relation on DocumentRelation
+ @throwOnFieldError {
+ representation
+ iri
+ path
+ resource {
+ id
+ }
+ }
+ `,
+ () => props.$relation,
+ );
+ return (
+
+ {(relation) => (
+
+
+
+ Embedded
+
+ {relation().iri ?? Anonymous }
+
+
+
+ Link
+ {relation().iri}
+
+
+ Reference
+
+
+
+
+ {WORDING.unreadableReference}
+
+
+
+
+
+ )}
+
+ );
+}
+
+/**
+ * One document node: its header line and what it holds below it. The root
+ * stands alone; an embedded document is a disclosure joined to its parent by
+ * a guide line.
+ * @returns The node.
+ */
+function NodeView(props: {
+ $node: ResourceDocumentParts_node$key;
+ depth: number;
+ relations: readonly T[];
+ diagnostics: readonly Diagnostic[];
+ /** Whether a source could have been recorded; see `SourceLabels`. */
+ sourceExpected: boolean;
+ /** Draws the document an embedded value holds. */
+ embedded: (node: NonNullable, relation: T) => JSX.Element;
+}) {
+ const data = createFragment(
+ graphql`
+ fragment ResourceDocumentParts_node on DocumentNode @throwOnFieldError {
+ type
+ kind
+ iri
+ path
+ addressing {
+ property
+ position
+ iri
+ resource {
+ id
+ }
+ }
+ extensions {
+ key
+ value
+ }
+ source {
+ relation
+ status
+ revision {
+ sequence
+ resource {
+ id
+ }
+ }
+ }
+ }
+ `,
+ () => props.$node,
+ );
+ return (
+
+ {(node) => {
+ const path = () => toPath(node().path);
+ const header = () => (
+
+ );
+ // The source links stay out of the summary, which must hold no
+ // interactive element of its own.
+ const body = () => (
+
+
0}>
+
+
+
+
+
pathKey(diagnostic.path) === pathKey(path()),
+ )}
+ />
+
+ {(relation) => (
+
+ }
+ >
+ {(child) => props.embedded(child(), relation)}
+
+
+ )}
+
+
+ {(recipient) => (
+
+
+ [{recipient.position}]
+
+ Anonymous }
+ >
+ {(iri) => (
+
+ )}
+
+
+
+
+ )}
+
+ 0}>
+ Extension properties
+
+
+ {(extension) => (
+
+
+ {extension.key}
+
+
+
+ {formatJson(extension.value)}
+
+
+
+ )}
+
+
+
+
+ );
+ return (
+ 0}
+ fallback={
+
+ {header()}
+ {body()}
+
+ }
+ >
+
+ {header()}
+ {body()}
+
+
+ );
+ }}
+
+ );
+}
+
+/**
+ * A document three levels below the root, whose embedded documents are shown
+ * as saved JSON.
+ * @returns The node.
+ */
+function Level3(props: {
+ $node: ResourceDocumentLevel3_node$key;
+ diagnostics: readonly Diagnostic[];
+ sourceExpected: boolean;
+}) {
+ const data = createFragment(
+ graphql`
+ fragment ResourceDocumentLevel3_node on DocumentNode @throwOnFieldError {
+ ...ResourceDocumentParts_node
+ relations {
+ property
+ representation
+ ...ResourceDocumentRelation_relation
+ node {
+ document
+ }
+ }
+ }
+ `,
+ () => props.$node,
+ );
+ return (
+
+ {(node) => (
+ {
+ const document: unknown = child.document;
+ return (
+ <>
+
+
+ >
+ );
+ }}
+ />
+ )}
+
+ );
+}
+
+/**
+ * A document two levels below the root.
+ * @returns The node.
+ */
+function Level2(props: {
+ $node: ResourceDocumentLevel2_node$key;
+ diagnostics: readonly Diagnostic[];
+ sourceExpected: boolean;
+}) {
+ const data = createFragment(
+ graphql`
+ fragment ResourceDocumentLevel2_node on DocumentNode @throwOnFieldError {
+ ...ResourceDocumentParts_node
+ relations {
+ property
+ representation
+ ...ResourceDocumentRelation_relation
+ resource {
+ revisions(first: 1) {
+ edges {
+ cursor
+ }
+ }
+ }
+ node {
+ ...ResourceDocumentLevel3_node
+ }
+ }
+ }
+ `,
+ () => props.$node,
+ );
+ return (
+
+ {(node) => (
+ (
+ 0
+ }
+ />
+ )}
+ />
+ )}
+
+ );
+}
+
+/**
+ * A document one level below the root.
+ * @returns The node.
+ */
+function Level1(props: {
+ $node: ResourceDocumentLevel1_node$key;
+ diagnostics: readonly Diagnostic[];
+ sourceExpected: boolean;
+}) {
+ const data = createFragment(
+ graphql`
+ fragment ResourceDocumentLevel1_node on DocumentNode @throwOnFieldError {
+ ...ResourceDocumentParts_node
+ relations {
+ property
+ representation
+ ...ResourceDocumentRelation_relation
+ resource {
+ revisions(first: 1) {
+ edges {
+ cursor
+ }
+ }
+ }
+ node {
+ ...ResourceDocumentLevel2_node
+ }
+ }
+ }
+ `,
+ () => props.$node,
+ );
+ return (
+
+ {(node) => (
+ (
+ 0
+ }
+ />
+ )}
+ />
+ )}
+
+ );
+}
+
+/**
+ * The root document of a revision and what it embeds.
+ * @returns The document tree.
+ */
+export function DocumentTree(props: {
+ $root: ResourceDocumentLevel0_node$key;
+ diagnostics: readonly Diagnostic[];
+}) {
+ const data = createFragment(
+ graphql`
+ fragment ResourceDocumentLevel0_node on DocumentNode @throwOnFieldError {
+ ...ResourceDocumentParts_node
+ relations {
+ property
+ representation
+ ...ResourceDocumentRelation_relation
+ resource {
+ revisions(first: 1) {
+ edges {
+ cursor
+ }
+ }
+ }
+ node {
+ ...ResourceDocumentLevel1_node
+ }
+ }
+ }
+ `,
+ () => props.$root,
+ );
+ return (
+
+ {(node) => (
+ (
+ 0
+ }
+ />
+ )}
+ />
+ )}
+
+ );
+}
diff --git a/packages/web/src/components/ResourceRevision.tsx b/packages/web/src/components/ResourceRevision.tsx
new file mode 100644
index 00000000..56d2d12e
--- /dev/null
+++ b/packages/web/src/components/ResourceRevision.tsx
@@ -0,0 +1,236 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import { graphql } from "relay-runtime";
+import { For, Match, Show, Switch, createMemo } from "solid-js";
+import { createFragment } from "solid-relay";
+
+import { pathKey, toPath, typeLabel } from "~/resource.ts";
+
+import type { ResourceRevision_revision$key } from "./__generated__/ResourceRevision_revision.graphql.ts";
+import {
+ type Diagnostic,
+ DiagnosticList,
+ DocumentTree,
+ JsonDisclosure,
+} from "./ResourceDocument.tsx";
+
+import styles from "~/styles/resource.module.css";
+
+/** A node of the document tree, as far as the tree draws nodes. */
+interface DrawnNode {
+ readonly path: unknown;
+ readonly relations?: readonly {
+ readonly representation: string;
+ readonly node?: DrawnNode | null | undefined;
+ }[];
+}
+
+/**
+ * Collects the paths of the nodes the document tree draws: the root and the
+ * embedded documents three levels below it, as far as the fragment selects.
+ * @returns The path keys.
+ */
+const drawnPaths = (node: DrawnNode): readonly string[] => [
+ pathKey(toPath(node.path)),
+ ...(node.relations ?? []).flatMap((relation) =>
+ relation.representation === "embedded" && relation.node != undefined
+ ? drawnPaths(relation.node)
+ : [],
+ ),
+];
+
+/**
+ * A stored time, written as stored.
+ * @returns The time element.
+ */
+export function TimeText(props: { value: string }) {
+ return {props.value} ;
+}
+
+/**
+ * One revision: how DrFed stored it and what it holds.
+ * @returns The revision.
+ */
+export function ResourceRevision(props: {
+ $revision: ResourceRevision_revision$key;
+ /** Whether it is the current revision of its resource. */
+ head: boolean;
+}) {
+ const data = createFragment(
+ graphql`
+ fragment ResourceRevision_revision on ResourceRevision
+ @throwOnFieldError {
+ id
+ sequence
+ kind
+ capture
+ backfilled
+ created
+ deleted
+ formerTypes
+ interpreted
+ document
+ diagnostics {
+ severity
+ category
+ reason
+ path
+ message
+ }
+ root {
+ ...ResourceDocumentLevel0_node
+ path
+ relations {
+ representation
+ node {
+ path
+ relations {
+ representation
+ node {
+ path
+ relations {
+ representation
+ node {
+ path
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ `,
+ () => props.$revision,
+ );
+ const diagnostics = createMemo((): readonly Diagnostic[] =>
+ (data()?.diagnostics ?? []).map((diagnostic) => ({
+ severity: diagnostic.severity,
+ category: diagnostic.category,
+ reason: diagnostic.reason,
+ path: toPath(diagnostic.path),
+ message: diagnostic.message,
+ })),
+ );
+ // Findings of a node the tree draws are shown on that node; the rest below.
+ const unplaced = createMemo(() => {
+ const root = data()?.root;
+ if (root == undefined) return diagnostics();
+ const paths = new Set(drawnPaths(root));
+ return diagnostics().filter(
+ (diagnostic) => !paths.has(pathKey(diagnostic.path)),
+ );
+ });
+ const savedDocument = (): unknown => data()?.document;
+ return (
+
+ {(revision) => (
+
+
+
+
+
+ DrFed could not interpret this document, so only its saved
+ JSON is shown. The validator findings below tell why.
+
+ }
+ >
+ {(root) => (
+
+ )}
+
+
+ {/* Keyed so that each revision's disclosure starts anew. */}
+
+
+
+
+
+
+ This revision records a deletion. It holds no document.
+
+
+
+
+ No document was retained for this revision.
+
+
+
+
+ )}
+
+ );
+}
diff --git a/packages/web/src/components/ResourceTimeline.tsx b/packages/web/src/components/ResourceTimeline.tsx
new file mode 100644
index 00000000..53aa4cc7
--- /dev/null
+++ b/packages/web/src/components/ResourceTimeline.tsx
@@ -0,0 +1,176 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import { A } from "@solidjs/router";
+import { graphql } from "relay-runtime";
+import { For, Match, Show, Switch, createMemo, createSignal } from "solid-js";
+import { createPaginationFragment } from "solid-relay";
+
+import { WORDING, resourceHref, timelineEntries } from "~/resource.ts";
+
+import type { ResourceTimeline_resource$key } from "./__generated__/ResourceTimeline_resource.graphql.ts";
+import { LoadingIndicator } from "./LoadingIndicator.tsx";
+import { TimeText } from "./ResourceRevision.tsx";
+
+import styles from "~/styles/resource.module.css";
+
+const PAGE_SIZE = 20;
+
+/**
+ * The history of a resource as a vertical timeline, newest first, with the
+ * revisions the viewer may not read counted between them.
+ * @returns The timeline.
+ */
+export function ResourceTimeline(props: {
+ $resource: ResourceTimeline_resource$key;
+ /** The sequence of the revision shown beside it. */
+ selected: number | undefined;
+}) {
+ const data = createPaginationFragment(
+ graphql`
+ fragment ResourceTimeline_resource on Resource
+ @throwOnFieldError
+ @argumentDefinitions(
+ count: { type: "Int", defaultValue: 20 }
+ cursor: { type: "String" }
+ )
+ @refetchable(queryName: "ResourceTimelinePaginationQuery") {
+ id
+ currentRevision {
+ sequence
+ }
+ revisions(first: $count, after: $cursor)
+ @connection(key: "ResourceTimeline_revisions") {
+ edges {
+ node {
+ id
+ sequence
+ kind
+ capture
+ backfilled
+ created
+ }
+ }
+ }
+ }
+ `,
+ () => props.$resource,
+ );
+ const [failed, setFailed] = createSignal(false);
+ const entries = createMemo(() =>
+ timelineEntries(
+ (data()?.revisions.edges ?? []).map((edge) => edge.node),
+ data()?.currentRevision?.sequence,
+ !data.hasNext,
+ ),
+ );
+ function loadOlder() {
+ if (!data.hasNext || data.isLoadingNext) return;
+ setFailed(false);
+ data.loadNext(PAGE_SIZE, {
+ onComplete(error) {
+ if (error) setFailed(true);
+ },
+ });
+ }
+ return (
+
+ {(resource) => (
+
+ {/* Safari drops list semantics without list markers. */}
+ {/* oxlint-disable-next-line jsx-a11y/no-redundant-roles */}
+
+
+ {(entry) => (
+
+
+ {WORDING.headUnreadable}
+
+
+ {(gap) => (
+
+ {WORDING.gap(gap().count)}
+
+ )}
+
+
+ {(item) => (
+
+
+
+ #{item().revision.sequence}
+
+ {item().revision.kind}
+
+ Current
+
+
+
+ {item().revision.capture}
+ {item().revision.backfilled ? " · backfilled" : ""}
+
+
+
+
+
+ )}
+
+
+ )}
+
+
+
+
+ Could not load older revisions.{" "}
+
+ Retry
+
+
+
+
+
+
+
+
+ Load older revisions
+
+
+
+ )}
+
+ );
+}
diff --git a/packages/web/src/resource.ts b/packages/web/src/resource.ts
new file mode 100644
index 00000000..59166bcc
--- /dev/null
+++ b/packages/web/src/resource.ts
@@ -0,0 +1,141 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// Calculations and wording of the resource page, apart from rendering.
+
+const ACTIVITY_STREAMS = "https://www.w3.org/ns/activitystreams#";
+const SEQUENCE_PATTERN = /^[1-9]\d*$/v;
+/** The largest value of GraphQL's `Int`. */
+const MAXIMUM_SEQUENCE = 2_147_483_647;
+
+/** The source keys and list indexes from the root of a saved document. */
+export type Path = readonly (string | number)[];
+
+/**
+ * Narrows a `path` the GraphQL `JSON` scalar returns.
+ * @returns The path, or `[]` for a value that is not one.
+ */
+export const toPath = (value: unknown): Path =>
+ Array.isArray(value) &&
+ value.every((token) => typeof token === "string" || Number.isInteger(token))
+ ? (value as Path)
+ : [];
+
+/**
+ * A key that compares two paths by their tokens.
+ * @returns The key.
+ */
+export const pathKey = (path: Path): string => JSON.stringify(path);
+
+/**
+ * Escapes a reference token of a JSON Pointer (RFC 6901, section 3).
+ * @returns The escaped token.
+ */
+const pointerToken = (token: string | number) =>
+ String(token).replaceAll("~", "~0").replaceAll("/", "~1");
+
+/**
+ * Writes a source path as a JSON Pointer (RFC 6901).
+ * @returns The pointer, or `undefined` for the root, which is not shown.
+ */
+export const formatPointer = (path: Path): string | undefined =>
+ path.length === 0
+ ? undefined
+ : `/${path.map((token) => pointerToken(token)).join("/")}`;
+
+/**
+ * The term of an ActivityStreams type, or any other type IRI in full.
+ * @returns The term or the IRI.
+ */
+export const typeLabel = (iri: string): string =>
+ iri.startsWith(ACTIVITY_STREAMS) && iri.length > ACTIVITY_STREAMS.length
+ ? iri.slice(ACTIVITY_STREAMS.length)
+ : iri;
+
+/**
+ * Reads the `revision` search parameter.
+ * @returns The sequence, or `undefined` for a value that names none.
+ */
+export const parseSequence = (parameter: string): number | undefined => {
+ if (!SEQUENCE_PATTERN.test(parameter)) return undefined;
+ const sequence = Number(parameter);
+ return sequence <= MAXIMUM_SEQUENCE ? sequence : undefined;
+};
+
+/**
+ * The page of a resource, or of one of its revisions.
+ * @returns The path and search string.
+ */
+export const resourceHref = (id: string, sequence?: number): string =>
+ sequence === undefined
+ ? `/resource/${encodeURIComponent(id)}`
+ : `/resource/${encodeURIComponent(id)}?revision=${sequence}`;
+
+/** A revision as the timeline places it. */
+export interface TimelineRevision {
+ readonly sequence: number;
+}
+
+/** One entry of the timeline, newest first. */
+export type TimelineEntry =
+ | { readonly type: "head-unreadable" }
+ | { readonly type: "revision"; readonly revision: T; readonly head: boolean }
+ | { readonly type: "gap"; readonly count: number };
+
+/**
+ * Lays out the loaded revisions with the gaps between their sequences. The
+ * gap below the oldest is known only once every page is loaded, and the gap
+ * above an unreadable head is never known.
+ * @param revisions The loaded revisions, newest first.
+ * @param head The sequence of the current revision, or `undefined` when the
+ * viewer may not read it.
+ * @param complete Whether no older revision is left to load.
+ * @returns The timeline entries, newest first.
+ */
+export const timelineEntries = (
+ revisions: readonly T[],
+ head: number | undefined,
+ complete: boolean,
+): readonly TimelineEntry[] => [
+ ...(head === undefined && revisions.length > 0
+ ? [{ type: "head-unreadable" } as const]
+ : []),
+ ...revisions.flatMap((revision, index): readonly TimelineEntry[] => {
+ const next = revisions[index + 1];
+ const last = complete ? revision.sequence - 1 : 0;
+ const gap =
+ next === undefined ? last : revision.sequence - next.sequence - 1;
+ return [
+ { type: "revision", revision, head: revision.sequence === head },
+ ...(gap > 0 ? [{ type: "gap", count: gap } as const] : []),
+ ];
+ }),
+];
+
+/** The messages of the resource page. */
+export const WORDING = {
+ gap: (count: number): string =>
+ count === 1
+ ? "1 revision you cannot read"
+ : `${count} revisions you cannot read`,
+ headUnreadable: "You cannot read the current revision.",
+ missingRevision: "This resource has no such revision that you can read.",
+ showLatest: "Show the latest revision",
+ unreadableReference: "Details unavailable",
+ sourceLink: (sequence: number): string => `From revision ${sequence}`,
+ currentLink: "Current revision",
+ unknownKind: "Unresolved IRI. DrFed stores no details for it.",
+} as const;
diff --git a/packages/web/src/routes/resource/[id].tsx b/packages/web/src/routes/resource/[id].tsx
new file mode 100644
index 00000000..2fb30420
--- /dev/null
+++ b/packages/web/src/routes/resource/[id].tsx
@@ -0,0 +1,254 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// A resource and its revisions, at /resource/{id}?revision={sequence}.
+// Without `revision`, the latest revision the viewer may read is shown.
+
+import { Title } from "@solidjs/meta";
+import {
+ A,
+ type RouteDefinition,
+ type RouteSectionProps,
+ query,
+ useSearchParams,
+} from "@solidjs/router";
+import { graphql } from "relay-runtime";
+import { ErrorBoundary, Match, Show, Suspense, Switch } from "solid-js";
+import {
+ createLazyLoadQuery,
+ createPreloadedQuery,
+ loadQuery,
+ useRelayEnvironment,
+} from "solid-relay";
+
+import { CopyButton } from "~/components/CopyButton.tsx";
+import { LoadingIndicator } from "~/components/LoadingIndicator.tsx";
+import { ResourceRevision } from "~/components/ResourceRevision.tsx";
+import { ResourceTimeline } from "~/components/ResourceTimeline.tsx";
+import { WORDING, parseSequence, resourceHref } from "~/resource.ts";
+
+import type { ResourcePageQuery } from "./__generated__/ResourcePageQuery.graphql.ts";
+import type { ResourcePageRevisionQuery } from "./__generated__/ResourcePageRevisionQuery.graphql.ts";
+
+import styles from "~/styles/resource.module.css";
+
+const resourcePageQuery = graphql`
+ query ResourcePageQuery($id: ID!) @throwOnFieldError {
+ node(id: $id) {
+ ... on Resource @alias(as: "resource") {
+ id
+ iri
+ kind
+ currentRevision {
+ sequence
+ }
+ latest: revisions(first: 1) {
+ edges {
+ node {
+ sequence
+ }
+ }
+ }
+ ...ResourceTimeline_resource
+ }
+ }
+ }
+`;
+
+const resourcePageRevisionQuery = graphql`
+ query ResourcePageRevisionQuery($id: ID!, $sequence: Int!)
+ @throwOnFieldError {
+ node(id: $id) {
+ ... on Resource @alias(as: "resource") {
+ revision(sequence: $sequence) {
+ ...ResourceRevision_revision
+ }
+ }
+ }
+ }
+`;
+
+const loadResourcePageQuery = query(
+ (id: string) =>
+ loadQuery(useRelayEnvironment()(), resourcePageQuery, {
+ id,
+ }),
+ "ResourcePageQuery",
+);
+
+export const route = {
+ preload({ params }) {
+ if (params.id === undefined) {
+ throw new Error("Missing resource ID route parameter.");
+ }
+ return loadResourcePageQuery(params.id);
+ },
+} satisfies RouteDefinition;
+
+type RouteData = ReturnType;
+
+export default function ResourcePage(props: RouteSectionProps) {
+ return (
+
+ Resource — DrFed
+
+ ← All instances
+
+
+ Unable to load this resource. Please reload the page to try again.
+
+ }
+ >
+ }>
+
+
+
+
+ );
+}
+
+function ResourceContent(props: { data: RouteData }) {
+ const data = createPreloadedQuery(
+ resourcePageQuery,
+ () => props.data,
+ );
+ const [search] = useSearchParams<{ revision?: string }>();
+ const parameter = () => search.revision;
+ return (
+
+ Resource not found.}>
+ {(resource) => {
+ const latest = () => resource().latest.edges[0]?.node.sequence;
+ // The sequence to show; undefined when the parameter names none.
+ const shown = () => {
+ const value = parameter();
+ return value === undefined ? latest() : parseSequence(value);
+ };
+ return (
+ <>
+ {resource().iri} — DrFed
+
+
+
+ {WORDING.unknownKind}
+
+
+ No revisions to show
+
+
+
+
+
+
+ }
+ >
+ {(sequence) => (
+
+ }
+ >
+
+
+ )}
+
+
+
+
+
+ >
+ );
+ }}
+
+
+ );
+}
+
+/**
+ * The note that `revision` names no revision the viewer may read.
+ * @returns The heading and note.
+ */
+function MissingRevision(props: { id: string; parameter: string }) {
+ return (
+ <>
+ Revision {props.parameter}
+
+ {WORDING.missingRevision}{" "}
+ {WORDING.showLatest}
+
+ >
+ );
+}
+
+/**
+ * The revision with a sequence, read on its own so that the timeline keeps
+ * its loaded pages while another revision is chosen.
+ * @returns The revision, or the note that there is none to read.
+ */
+function RevisionPanel(props: {
+ id: string;
+ sequence: number;
+ /** The sequence of the current revision, if the viewer may read it. */
+ head: number | undefined;
+}) {
+ const data = createLazyLoadQuery(
+ resourcePageRevisionQuery,
+ () => ({ id: props.id, sequence: props.sequence }),
+ );
+ return (
+
+
+ }
+ >
+ {(revision) => (
+
+ )}
+
+
+ );
+}
diff --git a/packages/web/src/styles/activity-log.module.css b/packages/web/src/styles/activity-log.module.css
index 2bb5f357..c254d777 100644
--- a/packages/web/src/styles/activity-log.module.css
+++ b/packages/web/src/styles/activity-log.module.css
@@ -32,9 +32,11 @@ along with this program. If not, see .
gap: 0.75rem;
}
+/* Each entry takes three quarters of the row, on the side of its direction,
+ so that the two directions stay apart without leaving half a row empty. */
.row {
display: grid;
- grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+ grid-template-columns: repeat(4, minmax(0, 1fr));
gap: 1rem;
}
@@ -43,15 +45,15 @@ along with this program. If not, see .
}
.incoming {
- grid-column: 1;
+ grid-column: 1 / span 3;
}
.outgoing {
- grid-column: 2;
+ grid-column: 2 / span 3;
}
.box {
- border: 1px solid var(--line);
+ border: 1px solid var(--rule);
border-radius: 0.5rem;
padding: 0.75rem;
}
@@ -70,6 +72,22 @@ along with this program. If not, see .
display: block;
}
+.resourceLinks {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 0.5rem 1rem;
+}
+.resourceLinks a {
+ display: inline-flex;
+ align-items: center;
+ min-block-size: 1.5rem;
+}
+@media (pointer: coarse) {
+ .resourceLinks a {
+ min-block-size: 2.75rem;
+ }
+}
+
.source pre {
white-space: pre-wrap;
overflow-wrap: anywhere;
diff --git a/packages/web/src/styles/actor.module.css b/packages/web/src/styles/actor.module.css
index 558ba9fc..93422e78 100644
--- a/packages/web/src/styles/actor.module.css
+++ b/packages/web/src/styles/actor.module.css
@@ -31,7 +31,7 @@ along with this program. If not, see .
display: flex;
align-items: center;
gap: 1rem;
- border-bottom: 1px solid var(--line);
+ border-bottom: 1px solid var(--rule);
padding-bottom: 1.25rem;
}
.header > div {
@@ -55,7 +55,7 @@ along with this program. If not, see .
}
.panel {
background: var(--card);
- border: 1px solid var(--line);
+ border: 1px solid var(--rule);
border-radius: var(--radius);
padding: clamp(1rem, 3vw, 1.75rem);
}
@@ -63,6 +63,13 @@ along with this program. If not, see .
margin: 0;
font-size: 1.3rem;
}
+.panelHeader {
+ display: flex;
+ flex-wrap: wrap;
+ align-items: start;
+ justify-content: space-between;
+ gap: 0.75rem 1rem;
+}
.fields {
margin: 1.25rem 0 0;
}
@@ -71,7 +78,7 @@ along with this program. If not, see .
grid-template-columns: 8rem minmax(0, 1fr);
gap: 1rem;
padding: 1rem 0;
- border-top: 1px solid var(--line);
+ border-top: 1px solid var(--rule);
}
.fields dt {
color: var(--ink-soft);
@@ -119,7 +126,7 @@ along with this program. If not, see .
}
.objectList > li {
min-width: 0;
- border-top: 1px solid var(--line);
+ border-top: 1px solid var(--rule);
padding: 1.5rem 0;
}
.objectList > li:last-child {
@@ -154,6 +161,19 @@ along with this program. If not, see .
grid-column: 1 / -1;
min-width: 0;
}
+.objectHistory {
+ grid-column: 1 / -1;
+ justify-self: start;
+ display: inline-flex;
+ align-items: center;
+ min-block-size: 1.5rem;
+ font-size: 0.8rem;
+}
+@media (pointer: coarse) {
+ .objectHistory {
+ min-block-size: 2.75rem;
+ }
+}
.objectIri {
flex: 1;
min-width: 0;
@@ -177,6 +197,14 @@ along with this program. If not, see .
.objectContent code {
font: inherit;
}
+.deletedObject .objectContent {
+ border-left-color: var(--rule);
+ color: var(--ink-soft);
+}
+.deletedLabel {
+ color: var(--ink-soft);
+ font-weight: 400;
+}
.objectEmpty {
color: var(--ink-soft);
margin: 1.25rem 0 0;
diff --git a/packages/web/src/styles/app.module.css b/packages/web/src/styles/app.module.css
index 1a7d69a0..6a64300d 100644
--- a/packages/web/src/styles/app.module.css
+++ b/packages/web/src/styles/app.module.css
@@ -22,7 +22,7 @@ along with this program. If not, see .
.header {
background: color-mix(in srgb, var(--bg) 92%, transparent);
- border-bottom: 1px solid var(--line);
+ border-bottom: 1px solid var(--rule);
position: sticky;
top: 0;
z-index: 10;
@@ -90,7 +90,7 @@ along with this program. If not, see .
}
.headerAction {
- border: 1px solid var(--line-strong);
+ border: 1px solid var(--ink-faint);
border-radius: var(--radius-pill);
margin-left: auto;
min-height: 2.4rem;
diff --git a/packages/web/src/styles/buttons.module.css b/packages/web/src/styles/buttons.module.css
index 2d3d56e5..ca39fffc 100644
--- a/packages/web/src/styles/buttons.module.css
+++ b/packages/web/src/styles/buttons.module.css
@@ -30,7 +30,7 @@ along with this program. If not, see .
justify-content: center;
background: var(--card);
color: var(--ink);
- border: 1px solid var(--line);
+ border: 1px solid var(--ink-faint);
border-radius: var(--radius-sm);
padding: 0.35rem 0.65rem;
cursor: pointer;
diff --git a/packages/web/src/styles/drfed.css b/packages/web/src/styles/drfed.css
index 63015080..c32e7d29 100644
--- a/packages/web/src/styles/drfed.css
+++ b/packages/web/src/styles/drfed.css
@@ -55,6 +55,10 @@ along with this program. If not, see .
--on-accent: #ffffff;
--line: #e9e5e1;
--line-strong: #dad4cf;
+ /* Borders and separators: halfway between the strong line and the faint
+ ink in oklab, so that they stand out of the ground in either scheme
+ (2:1 light, 2.8:1 dark). Control boundaries take --ink-faint, at 3:1. */
+ --rule: color-mix(in oklab, var(--line-strong), var(--ink-faint));
--danger: #cf3f43;
--success: #247a46;
--warning: #9a5800;
diff --git a/packages/web/src/styles/filter.module.css b/packages/web/src/styles/filter.module.css
new file mode 100644
index 00000000..f2523654
--- /dev/null
+++ b/packages/web/src/styles/filter.module.css
@@ -0,0 +1,122 @@
+/*
+DrFed: A web-based platform for developing and debugging ActivityPub apps
+Copyright (C) 2026 DrFed team
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see .
+*/
+
+.filter {
+ position: relative;
+}
+/* Stays a list item, so that it keeps its disclosure marker. */
+.toggle {
+ cursor: pointer;
+ display: list-item;
+ inline-size: fit-content;
+ list-style-position: inside;
+ border: 1px solid var(--ink-faint);
+ border-radius: var(--radius-sm);
+ padding: 0.35rem 0.75rem;
+ color: var(--ink);
+ font-size: 0.85rem;
+ font-weight: 700;
+}
+.toggle:focus-visible {
+ outline: 3px solid var(--accent-soft);
+ outline-offset: 0.2rem;
+}
+.count {
+ color: var(--accent-strong);
+}
+.conditions {
+ display: grid;
+ gap: 0.5rem;
+ margin: 0.75rem 0 0;
+ border: 0;
+ padding: 0;
+}
+.legend {
+ margin-block-end: 0.25rem;
+ padding: 0;
+ color: var(--ink-soft);
+ font-size: 0.8rem;
+ font-weight: 700;
+}
+.condition {
+ display: flex;
+ align-items: center;
+ gap: 0.5rem;
+ min-block-size: 1.5rem;
+ font-size: 0.9rem;
+ accent-color: var(--accent-strong);
+}
+
+@media (pointer: coarse) {
+ .toggle,
+ .condition {
+ min-block-size: 2.75rem;
+ }
+}
+
+/* Without accent-color, the native box is hidden and drawn in its place. */
+@supports not (accent-color: var(--accent-strong)) {
+ .checkbox {
+ position: absolute;
+ clip-path: inset(50%);
+ overflow: hidden;
+ width: 1px;
+ height: 1px;
+ margin: -1px;
+ padding: 0;
+ border: 0;
+ white-space: nowrap;
+ }
+ .checkbox + span {
+ position: relative;
+ padding-inline-start: 1.6rem;
+ }
+ .checkbox + span::before {
+ content: "";
+ position: absolute;
+ inset-inline-start: 0;
+ top: 50%;
+ width: 1.1rem;
+ height: 1.1rem;
+ translate: 0 -50%;
+ box-sizing: border-box;
+ border: 2px solid var(--ink-faint);
+ background: var(--surface);
+ }
+ .checkbox:focus-visible + span::before {
+ outline: 3px solid var(--accent-soft);
+ outline-offset: 2px;
+ }
+ .checkbox:checked + span::before {
+ border-color: var(--accent-strong);
+ background: var(--accent-strong);
+ }
+ .checkbox:checked + span::after {
+ content: "\2713" / "";
+ position: absolute;
+ inset-inline-start: 0.2rem;
+ top: 50%;
+ translate: 0 -50%;
+ color: var(--bg);
+ font-size: 0.8rem;
+ font-weight: 700;
+ }
+ .checkbox:disabled + span {
+ opacity: 0.6;
+ }
+}
diff --git a/packages/web/src/styles/form.module.css b/packages/web/src/styles/form.module.css
index 8e71adce..fe2c48d0 100644
--- a/packages/web/src/styles/form.module.css
+++ b/packages/web/src/styles/form.module.css
@@ -25,7 +25,7 @@ along with this program. If not, see .
.panel {
background: var(--card);
- border: 1px solid var(--line);
+ border: 1px solid var(--rule);
border-radius: var(--radius);
box-shadow: var(--shadow-sm);
max-width: 28rem;
@@ -34,7 +34,7 @@ along with this program. If not, see .
}
.header {
- border-bottom: 1px solid var(--line);
+ border-bottom: 1px solid var(--rule);
margin: 0 calc(clamp(1.5rem, 4vw, 2rem) * -1) 1.5rem;
padding: 0 clamp(1.5rem, 4vw, 2rem) 1.5rem;
}
@@ -82,7 +82,7 @@ along with this program. If not, see .
.input {
background: var(--surface-2);
- border: 1px solid var(--line-strong);
+ border: 1px solid var(--ink-faint);
border-radius: var(--radius-sm);
color: var(--ink);
min-width: 0;
diff --git a/packages/web/src/styles/instance.module.css b/packages/web/src/styles/instance.module.css
index f6752114..b4bc7997 100644
--- a/packages/web/src/styles/instance.module.css
+++ b/packages/web/src/styles/instance.module.css
@@ -39,7 +39,7 @@ along with this program. If not, see .
.header {
align-items: center;
- border-bottom: 1px solid var(--line);
+ border-bottom: 1px solid var(--rule);
display: flex;
gap: 1rem;
justify-content: space-between;
@@ -75,7 +75,7 @@ along with this program. If not, see .
.details,
.actors {
background: var(--card);
- border: 1px solid var(--line);
+ border: 1px solid var(--rule);
border-radius: var(--radius);
box-shadow: var(--shadow-sm);
padding: clamp(1.25rem, 3vw, 1.75rem);
@@ -103,7 +103,7 @@ along with this program. If not, see .
.endpointList div {
align-items: baseline;
- border-top: 1px solid var(--line);
+ border-top: 1px solid var(--rule);
display: grid;
gap: 1rem;
grid-template-columns: 8rem minmax(0, 1fr);
@@ -152,7 +152,7 @@ along with this program. If not, see .
}
.actorList {
- border-top: 1px solid var(--line);
+ border-top: 1px solid var(--rule);
}
.actorCard {
@@ -163,7 +163,7 @@ along with this program. If not, see .
}
.actorCard + .actorCard {
- border-top: 1px solid var(--line);
+ border-top: 1px solid var(--rule);
}
.actorMarker {
diff --git a/packages/web/src/styles/loading.module.css b/packages/web/src/styles/loading.module.css
new file mode 100644
index 00000000..2b282b42
--- /dev/null
+++ b/packages/web/src/styles/loading.module.css
@@ -0,0 +1,30 @@
+/*
+DrFed: A web-based platform for developing and debugging ActivityPub apps
+Copyright (C) 2026 DrFed team
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see .
+*/
+
+.loading {
+ display: flex;
+ align-items: center;
+ gap: 0.6rem;
+ margin: 0.75rem 0;
+ color: var(--ink-soft);
+ font-size: 0.9rem;
+}
+.bar {
+ inline-size: 5rem;
+ flex-shrink: 0;
+}
diff --git a/packages/web/src/styles/object.module.css b/packages/web/src/styles/object.module.css
index 5273cfc4..7cfb698b 100644
--- a/packages/web/src/styles/object.module.css
+++ b/packages/web/src/styles/object.module.css
@@ -64,7 +64,7 @@ along with this program. If not, see .
.selectContent {
background: var(--card);
- border: 1px solid var(--line-strong);
+ border: 1px solid var(--ink-faint);
border-radius: var(--radius-sm);
box-shadow: var(--shadow-md);
max-width: calc(100vw - 2rem);
@@ -116,7 +116,7 @@ along with this program. If not, see .
}
.actions {
- border-top: 1px solid var(--line);
+ border-top: 1px solid var(--rule);
display: flex;
gap: 0.75rem;
justify-content: flex-end;
@@ -125,7 +125,7 @@ along with this program. If not, see .
.reset {
background: var(--card);
- border: 1px solid var(--line-strong);
+ border: 1px solid var(--ink-faint);
border-radius: var(--radius-sm);
color: var(--ink);
cursor: pointer;
diff --git a/packages/web/src/styles/resource.module.css b/packages/web/src/styles/resource.module.css
new file mode 100644
index 00000000..22871e7f
--- /dev/null
+++ b/packages/web/src/styles/resource.module.css
@@ -0,0 +1,411 @@
+/*
+DrFed: A web-based platform for developing and debugging ActivityPub apps
+Copyright (C) 2026 DrFed team
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see .
+*/
+
+/* The resource page: a history rail beside the revision it shows. */
+
+.page {
+ display: grid;
+ gap: 1.5rem;
+ min-width: 0;
+ padding-bottom: 3rem;
+}
+.backLink {
+ display: inline-flex;
+ align-items: center;
+ min-block-size: 1.5rem;
+ color: var(--ink-soft);
+ font-weight: 700;
+ justify-self: start;
+ text-decoration: none;
+}
+.page a {
+ color: var(--ink);
+ text-decoration-color: var(--accent-soft);
+ text-underline-offset: 0.2rem;
+}
+.page a:focus-visible,
+.page summary:focus-visible,
+.page button:focus-visible {
+ outline: 3px solid var(--accent-soft);
+ outline-offset: 0.2rem;
+}
+.header {
+ border-bottom: 1px solid var(--rule);
+ min-width: 0;
+ padding-bottom: 1.25rem;
+}
+.header h1 {
+ font-family: var(--font-mono);
+ font-size: clamp(1.1rem, 3vw, 1.6rem);
+ margin: 0;
+ overflow-wrap: anywhere;
+}
+.label {
+ color: var(--accent-strong);
+ font-weight: 700;
+ margin: 0 0 0.5rem;
+}
+.panel {
+ min-width: 0;
+}
+.panel h2 {
+ font-size: 1.3rem;
+ margin: 0 0 1rem;
+}
+.notice {
+ color: var(--ink-soft);
+ margin: 1rem 0 0;
+}
+.empty {
+ color: var(--ink-soft);
+ display: block;
+ margin: 0;
+}
+.faint {
+ color: var(--ink-faint);
+ font-family: var(--font-sans);
+ font-style: italic;
+}
+.sectionLabel {
+ color: var(--ink-soft);
+ font-size: var(--text-label);
+ font-weight: 700;
+ letter-spacing: var(--tracking-label);
+ margin: 1rem 0 0.5rem;
+ text-transform: uppercase;
+}
+.path {
+ color: var(--ink-soft);
+ font-family: var(--font-mono);
+ font-size: 0.8rem;
+ overflow-wrap: anywhere;
+}
+.iri {
+ font-family: var(--font-mono);
+ font-size: 0.85rem;
+ min-width: 0;
+ overflow-wrap: anywhere;
+}
+.position {
+ color: var(--ink-soft);
+ font-family: var(--font-mono);
+ font-size: 0.85rem;
+}
+
+/* Labels: plain words, all neutral and told apart by their wording. */
+.pill,
+.pillEmbedded {
+ color: var(--ink-soft);
+ font-family: var(--font-sans);
+ font-size: 0.75rem;
+ font-style: normal;
+ font-weight: 700;
+ white-space: nowrap;
+}
+.pillEmbedded {
+ color: var(--accent-strong);
+}
+.labels {
+ align-items: baseline;
+ display: inline-flex;
+ flex-wrap: wrap;
+ gap: 0.35rem 0.5rem;
+}
+.sourceRow {
+ margin: 0 0 0.5rem;
+}
+.page .sourceLink {
+ display: inline-flex;
+ align-items: center;
+ min-block-size: 1.5rem;
+ color: var(--ink-soft);
+ font-family: var(--font-sans);
+ font-size: 0.8rem;
+ font-weight: 600;
+}
+
+/* Layout. */
+.railLayout {
+ align-items: start;
+ display: grid;
+ gap: 1.5rem;
+ grid-template-columns: minmax(14rem, 17rem) minmax(0, 1fr);
+}
+.railLayout > .panel + .panel {
+ align-self: stretch;
+ border-inline-start: 1px solid var(--rule);
+ padding-inline-start: clamp(1rem, 3vw, 1.75rem);
+}
+.loadMore {
+ background: var(--card);
+ border: 1px solid var(--ink-faint);
+ border-radius: var(--radius-sm);
+ color: var(--ink);
+ cursor: pointer;
+ font-weight: 700;
+ margin-top: 1rem;
+ padding: 0.5rem 1rem;
+}
+.loadMore:hover {
+ background: var(--surface-2);
+}
+
+/* Standalone links and buttons are at least 24px tall, 44px on touch. */
+@media (pointer: coarse) {
+ .backLink,
+ .page .sourceLink,
+ .page .entrySequence,
+ .loadMore {
+ min-block-size: 2.75rem;
+ }
+}
+
+/* The timeline: dots on a line. */
+.timeline {
+ border-left: 2px solid var(--rule);
+ list-style: none;
+ margin: 0 0 0 0.45rem;
+ min-width: 0;
+ padding: 0;
+}
+.timeline > li {
+ padding: 0.5rem 0.5rem 0.5rem 1.1rem;
+ position: relative;
+}
+.revisionEntry {
+ display: grid;
+ gap: 0.1rem;
+ min-width: 0;
+}
+.timeline > .revisionEntry::before {
+ background: var(--card);
+ border: 2px solid var(--accent-soft);
+ border-radius: 50%;
+ content: "";
+ height: 0.7rem;
+ left: -0.45rem;
+ position: absolute;
+ top: 0.85rem;
+ width: 0.7rem;
+}
+.timeline > .selectedEntry::before {
+ background: var(--accent);
+ border-color: var(--accent);
+}
+.timeline > .whiteoutEntry::before {
+ border-color: var(--danger);
+}
+.timeline > .whiteoutEntry.selectedEntry::before {
+ background: var(--danger);
+}
+.timeline > .gapEntry {
+ border-left: 2px dashed var(--rule);
+ color: var(--ink-faint);
+ font-size: 0.85rem;
+ font-style: italic;
+ margin-left: -2px;
+}
+.entryLine {
+ align-items: baseline;
+ display: flex;
+ flex-wrap: wrap;
+ gap: 0.25rem 0.5rem;
+}
+.page .entrySequence {
+ display: inline-flex;
+ align-items: center;
+ min-block-size: 1.5rem;
+ font-family: var(--font-mono);
+ font-weight: 700;
+}
+.entryDetail {
+ color: var(--ink-soft);
+ font-family: var(--font-mono);
+ font-size: 0.75rem;
+ overflow-wrap: anywhere;
+}
+
+/* A revision. */
+.revision {
+ display: grid;
+ gap: 1rem;
+ min-width: 0;
+}
+.revisionHeader h2 {
+ margin: 0;
+}
+.fields {
+ margin: 0.75rem 0 0;
+}
+.fields > div {
+ border-top: 1px solid var(--rule);
+ display: grid;
+ gap: 1rem;
+ grid-template-columns: 8rem minmax(0, 1fr);
+ padding: 0.6rem 0;
+}
+.fields dt {
+ color: var(--ink-soft);
+ font-weight: 700;
+}
+.fields dd {
+ font-family: var(--font-mono);
+ font-size: 0.9rem;
+ margin: 0;
+ overflow-wrap: anywhere;
+}
+
+/* Saved JSON. */
+.json {
+ border-top: 1px solid var(--rule);
+ margin-top: 0.75rem;
+ min-width: 0;
+ padding-top: 0.5rem;
+}
+.json > summary {
+ cursor: pointer;
+ font-weight: 700;
+}
+.json pre {
+ font-size: 0.8rem;
+ overflow-wrap: anywhere;
+ white-space: pre-wrap;
+}
+
+/* Validator findings. */
+.diagnostics {
+ list-style: none;
+ margin: 0.75rem 0 0;
+ padding: 0;
+}
+.diagnostics > li {
+ border-top: 1px solid var(--rule);
+ padding: 0.5rem 0;
+}
+.diagnostics p {
+ margin: 0;
+ overflow-wrap: anywhere;
+}
+.diagnosticHead {
+ align-items: baseline;
+ display: flex;
+ flex-wrap: wrap;
+ gap: 0.25rem 0.75rem;
+ margin-bottom: 0.25rem;
+}
+.diagnosticError .diagnosticHead strong {
+ color: var(--danger);
+}
+.diagnosticWarning .diagnosticHead strong {
+ color: var(--warning);
+}
+
+/* Document nodes. */
+.rootNode {
+ min-width: 0;
+}
+.nodeHeader {
+ align-items: baseline;
+ display: flex;
+ flex-wrap: wrap;
+ gap: 0.35rem 0.6rem;
+ min-width: 0;
+}
+.nodeType {
+ font-family: var(--font-mono);
+ font-size: 1.05rem;
+ font-weight: 700;
+ overflow-wrap: anywhere;
+}
+.nodeSummary {
+ cursor: pointer;
+ list-style-position: outside;
+}
+.nodeSummary .nodeHeader {
+ display: inline-flex;
+}
+.nodeBody {
+ min-width: 0;
+}
+.groups {
+ display: grid;
+ gap: 0.75rem;
+ margin: 0;
+}
+.groups dt code {
+ font-weight: 700;
+}
+.groups dd {
+ margin: 0.25rem 0 0;
+ min-width: 0;
+}
+.values {
+ display: grid;
+ gap: 0.6rem;
+ list-style: none;
+ margin: 0;
+ padding: 0 0 0 1rem;
+}
+.value {
+ min-width: 0;
+}
+.valueLine {
+ align-items: baseline;
+ display: flex;
+ flex-wrap: wrap;
+ gap: 0.25rem 0.6rem;
+ min-width: 0;
+}
+.extensionValue {
+ font-family: var(--font-mono);
+ font-size: 0.8rem;
+ margin: 0;
+ overflow-wrap: anywhere;
+ white-space: pre-wrap;
+}
+
+/* An embedded document, joined to its parent by a guide line. */
+.embedded {
+ min-width: 0;
+}
+.embedded > .nodeBody {
+ border-left: 1px solid var(--rule);
+ margin-left: 0.4rem;
+ padding-left: 1rem;
+}
+
+@media (max-width: 900px) {
+ .railLayout {
+ grid-template-columns: minmax(0, 1fr);
+ }
+ .railLayout > :first-child {
+ border-top: 1px solid var(--rule);
+ order: 2;
+ padding-top: 1.5rem;
+ }
+ .railLayout > .panel + .panel {
+ border-inline-start: 0;
+ padding-inline-start: 0;
+ }
+}
+@media (max-width: 600px) {
+ .fields > div {
+ gap: 0.25rem;
+ grid-template-columns: 1fr;
+ }
+}
diff --git a/packages/web/src/styles/toast.module.css b/packages/web/src/styles/toast.module.css
index 05ccf5be..5419783e 100644
--- a/packages/web/src/styles/toast.module.css
+++ b/packages/web/src/styles/toast.module.css
@@ -40,7 +40,7 @@ along with this program. If not, see .
padding: 1rem;
background: var(--surface);
color: var(--ink);
- border: 1px solid var(--line-strong);
+ border: 1px solid var(--rule);
border-radius: var(--radius-sm);
box-shadow: var(--shadow-md);
}
diff --git a/packages/web/src/styles/workspace.module.css b/packages/web/src/styles/workspace.module.css
index fe35e912..2c04e67f 100644
--- a/packages/web/src/styles/workspace.module.css
+++ b/packages/web/src/styles/workspace.module.css
@@ -23,7 +23,7 @@ along with this program. If not, see .
.header {
align-items: center;
- border-bottom: 1px solid var(--line);
+ border-bottom: 1px solid var(--rule);
display: flex;
gap: 1rem;
justify-content: space-between;
@@ -86,7 +86,7 @@ along with this program. If not, see .
.instanceList {
background: var(--card);
- border: 1px solid var(--line);
+ border: 1px solid var(--rule);
border-radius: var(--radius);
box-shadow: var(--shadow-sm);
overflow: hidden;
@@ -101,7 +101,7 @@ along with this program. If not, see .
}
.instanceCard + .instanceCard {
- border-top: 1px solid var(--line);
+ border-top: 1px solid var(--rule);
}
.instanceCard:hover {
@@ -152,7 +152,7 @@ along with this program. If not, see .
.emptyState {
background: var(--card);
- border: 1px dashed var(--line-strong);
+ border: 1px dashed var(--rule);
border-radius: var(--radius);
margin: 0 auto;
max-width: var(--container-narrow);
@@ -176,7 +176,7 @@ along with this program. If not, see .
}
.secondaryButton {
- border: 1px solid var(--line-strong);
+ border: 1px solid var(--ink-faint);
color: var(--ink);
min-height: 2.75rem;
padding: 0.65rem 1rem;
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 8fb6fd05..5c13e327 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -136,6 +136,9 @@ importers:
'@dahlia/sacho':
specifier: github:dahlia/sacho#0.3.2
version: https://codeload.github.com/dahlia/sacho/tar.gz/e8cb82260b34a29685fbe341e9c196d919cf9e9c
+ '@drfed/federation':
+ specifier: workspace:*
+ version: link:packages/federation
'@drfed/graphql':
specifier: workspace:*
version: link:packages/graphql
@@ -145,6 +148,12 @@ importers:
'@electric-sql/pglite':
specifier: 'catalog:'
version: 0.5.3
+ '@fedify/fedify':
+ specifier: 'catalog:'
+ version: 2.4.3
+ '@leonxlnx/taste-skill':
+ specifier: github:leonxlnx/taste-skill#f6b76575f949707b4e3c37cd86cb44b0b98643e8
+ version: https://codeload.github.com/leonxlnx/taste-skill/tar.gz/f6b76575f949707b4e3c37cd86cb44b0b98643e8
'@logtape/logtape':
specifier: 'catalog:'
version: 2.3.0-dev.840
@@ -163,6 +172,9 @@ importers:
graphql:
specifier: 'catalog:'
version: 16.14.2
+ modern-web-guidance:
+ specifier: github:GoogleChrome/modern-web-guidance#64a6d708f5a43f2cd3fde5d4d7db3905ba1bdf65
+ version: https://codeload.github.com/GoogleChrome/modern-web-guidance/tar.gz/64a6d708f5a43f2cd3fde5d4d7db3905ba1bdf65
relay-github-root:
specifier: github:facebook/relay#52c2e68711a698a9708997b9bdf7532c4d7ecdd6
version: https://codeload.github.com/facebook/relay/tar.gz/52c2e68711a698a9708997b9bdf7532c4d7ecdd6
@@ -1443,6 +1455,10 @@ packages:
peerDependencies:
solid-js: ^1.8.8
+ '@leonxlnx/taste-skill@https://codeload.github.com/leonxlnx/taste-skill/tar.gz/f6b76575f949707b4e3c37cd86cb44b0b98643e8':
+ resolution: {gitHosted: true, integrity: sha512-lhWLSUyUP92EoOgg0zUSkYVFEhGfCjcPBC7lD4XLQnC1P70rKpt5JN3omhrZeVPBWMSGLlnaL4kOg0KppOyiaw==, tarball: https://codeload.github.com/leonxlnx/taste-skill/tar.gz/f6b76575f949707b4e3c37cd86cb44b0b98643e8}
+ version: 0.0.0
+
'@logtape/drizzle-orm@2.2.2':
resolution: {integrity: sha512-Z/TrI5BbOCSJPmoyogy9RERtAxs/hlyI+e/uay1PSY68/ZddPqfudbS6MGgFylAiACprJ0d0zEiGeysUQUcQ2A==}
peerDependencies:
@@ -1558,6 +1574,7 @@ packages:
'@opentelemetry/sdk-trace-base@2.11.0':
resolution: {integrity: sha512-H19x/TX/LZdqiYOjM7fqtSxwlplC5pgelavqbQdHbhdq0q/AI/TGkM2dfGuuynTXmJPeF2HoZVoPDu+TGoW78A==}
engines: {node: ^18.19.0 || >=20.6.0}
+ deprecated: Use @opentelemetry/sdk-trace package
peerDependencies:
'@opentelemetry/api': '>=1.3.0 <1.10.0'
@@ -3856,6 +3873,12 @@ packages:
mitt@3.0.1:
resolution: {integrity: sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw==}
+ modern-web-guidance@https://codeload.github.com/GoogleChrome/modern-web-guidance/tar.gz/64a6d708f5a43f2cd3fde5d4d7db3905ba1bdf65:
+ resolution: {gitHosted: true, integrity: sha512-YsINlbv4kBwhCe6MZOlYygyLZci7gRLka9GHgYMpbKPXgeOfPgLsttbKT8wqnC9jhmtFIm7EXGIXLJEwjx58RA==, tarball: https://codeload.github.com/GoogleChrome/modern-web-guidance/tar.gz/64a6d708f5a43f2cd3fde5d4d7db3905ba1bdf65}
+ version: 1.0.1
+ engines: {node: '>=22.0.0', vscode: ^1.90.0}
+ hasBin: true
+
ms@2.1.3:
resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
@@ -5617,6 +5640,8 @@ snapshots:
'@solid-primitives/utils': 6.4.1(solid-js@1.9.17)
solid-js: 1.9.17
+ '@leonxlnx/taste-skill@https://codeload.github.com/leonxlnx/taste-skill/tar.gz/f6b76575f949707b4e3c37cd86cb44b0b98643e8': {}
+
'@logtape/drizzle-orm@2.2.2(@logtape/logtape@2.3.0-dev.840)':
dependencies:
'@logtape/logtape': 2.3.0-dev.840
@@ -7638,6 +7663,8 @@ snapshots:
mitt@3.0.1: {}
+ modern-web-guidance@https://codeload.github.com/GoogleChrome/modern-web-guidance/tar.gz/64a6d708f5a43f2cd3fde5d4d7db3905ba1bdf65: {}
+
ms@2.1.3: {}
nanoid@3.3.19: {}
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 3e108f18..78e20172 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -28,6 +28,10 @@ permissions:
skills: true
"@optique/core":
skills: true
+ "modern-web-guidance@https://codeload.github.com/GoogleChrome/modern-web-guidance/tar.gz/64a6d708f5a43f2cd3fde5d4d7db3905ba1bdf65":
+ skills: true
+ "@leonxlnx/taste-skill@https://codeload.github.com/leonxlnx/taste-skill/tar.gz/f6b76575f949707b4e3c37cd86cb44b0b98643e8":
+ skills: true
solid-relay:
skills: true
diff --git a/scripts/seed-revisions/case.mts b/scripts/seed-revisions/case.mts
new file mode 100644
index 00000000..c40cbd0e
--- /dev/null
+++ b/scripts/seed-revisions/case.mts
@@ -0,0 +1,68 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import type { LocalWriteEnvironment } from "@drfed/federation/local-write";
+import type { Database } from "@drfed/models";
+import type { Uuid } from "@drfed/models/uuid";
+
+import type { Workspace } from "./environment.mts";
+import type { Writer } from "./writer.mts";
+
+export const CAROL_IRI = "https://mastodon.example/users/carol";
+export const CAROL_FOLLOWERS_IRI = `${CAROL_IRI}/followers`;
+
+/**
+ * Composes the IRI of one of Carol's notes.
+ * @returns The IRI.
+ */
+export const carolNote = (name: string): string =>
+ `https://mastodon.example/users/carol/statuses/${name}`;
+
+/** What every case works with. */
+export interface CaseContext {
+ readonly db: Database;
+ readonly env: LocalWriteEnvironment;
+ /** Workspace A, whose actor writes every local resource. */
+ readonly alice: Workspace;
+ /** Workspace B, which only receives. */
+ readonly bob: Workspace;
+ /** Writes as the actor of workspace A. */
+ readonly writer: Writer;
+}
+
+/** A resource to open in the UI to see a case. */
+export interface SeededResource {
+ readonly label: string;
+ readonly id: Uuid;
+ readonly iri: string;
+}
+
+export interface SeededCase {
+ readonly number: number;
+ readonly title: string;
+ readonly resources: readonly SeededResource[];
+}
+
+export type SeedCase = (context: CaseContext) => Promise;
+
+/**
+ * Labels a saved resource for the report.
+ * @returns The labelled resource.
+ */
+export const labelled = (
+ label: string,
+ { id, iri }: { readonly id: Uuid; readonly iri: string },
+): SeededResource => ({ label, id, iri });
diff --git a/scripts/seed-revisions/cases-access.mts b/scripts/seed-revisions/cases-access.mts
new file mode 100644
index 00000000..38922a42
--- /dev/null
+++ b/scripts/seed-revisions/cases-access.mts
@@ -0,0 +1,120 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import { PUBLIC_IRI } from "@drfed/models/resource";
+
+import {
+ CAROL_FOLLOWERS_IRI,
+ CAROL_IRI,
+ type SeedCase,
+ carolNote,
+ labelled,
+} from "./case.mts";
+import { receiveNote } from "./received.mts";
+import { ACTIVITY, loadHead, withoutContext } from "./writer.mts";
+
+const privateEmbedding: SeedCase = async ({ db, alice, writer }) => {
+ const iri = carolNote("followers-only");
+ const note = await receiveNote(db, {
+ iri,
+ attributedTo: CAROL_IRI,
+ content: "For my followers only",
+ to: [CAROL_FOLLOWERS_IRI],
+ deliveredTo: [alice],
+ });
+ // A member of A may read the Note, so may declare it as the source.
+ const announce = await writer.save(
+ { type: "Announce", object: withoutContext(note.document) },
+ ACTIVITY,
+ [{ path: ["object"], revisionId: note.revisionId }],
+ );
+ const head = await loadHead(db, announce.id);
+ const undo = await writer.save(
+ { type: "Undo", object: withoutContext(head.document) },
+ ACTIVITY,
+ [
+ { path: ["object"], revisionId: head.revisionId },
+ { path: ["object", "object"], revisionId: note.revisionId },
+ ],
+ );
+ return {
+ number: 16,
+ title:
+ "Announce embedding a private Note only A received (17: the Undo " +
+ "embedding that Announce)",
+ resources: [
+ labelled("Announce", announce),
+ labelled("Undo (case 17)", undo),
+ { label: "Carol's Note", id: note.resourceId, iri },
+ ],
+ };
+};
+
+const laterRestricted: SeedCase = async ({ db, alice, bob, writer }) => {
+ const iri = carolNote("public-then-private");
+ const first = await receiveNote(db, {
+ iri,
+ attributedTo: CAROL_IRI,
+ content: "Public at first",
+ to: [PUBLIC_IRI],
+ deliveredTo: [alice, bob],
+ });
+ const liked = await writer.save(
+ { type: "Like", object: withoutContext(first.document) },
+ ACTIVITY,
+ [{ path: ["object"], revisionId: first.revisionId }],
+ );
+ await receiveNote(db, {
+ iri,
+ attributedTo: CAROL_IRI,
+ content: "Restricted to followers later",
+ to: [CAROL_FOLLOWERS_IRI],
+ deliveredTo: [alice],
+ });
+ return {
+ number: 18,
+ title:
+ "Like embedding a public revision whose Note A alone later received " +
+ "a private revision of (19: the Note's history)",
+ resources: [
+ labelled("Like", liked),
+ { label: "Carol's Note (case 19)", id: first.resourceId, iri },
+ ],
+ };
+};
+
+const receivedByBoth: SeedCase = async ({ db, alice, bob }) => {
+ const iri = carolNote("followers-only-both");
+ const note = await receiveNote(db, {
+ iri,
+ attributedTo: CAROL_IRI,
+ content: "For my followers on both instances",
+ to: [CAROL_FOLLOWERS_IRI],
+ deliveredTo: [alice, bob],
+ });
+ return {
+ number: 20,
+ title: "A private Note both A and B received",
+ resources: [{ label: "Carol's Note", id: note.resourceId, iri }],
+ };
+};
+
+/** Cases 16 to 20: who may read a revision. */
+export const ACCESS_CASES: readonly SeedCase[] = [
+ privateEmbedding,
+ laterRestricted,
+ receivedByBoth,
+];
diff --git a/scripts/seed-revisions/cases-depth.mts b/scripts/seed-revisions/cases-depth.mts
new file mode 100644
index 00000000..29528278
--- /dev/null
+++ b/scripts/seed-revisions/cases-depth.mts
@@ -0,0 +1,159 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// A document nested deeper than the resource page expands, so that its
+// guide lines, labels and the saved JSON below the third level can be seen.
+//
+// Keep dependent database writes sequential.
+// oxlint-disable no-await-in-loop
+
+import type { EmbeddedSource, JsonObject } from "@drfed/federation/local-write";
+import type { Uuid } from "@drfed/models/uuid";
+
+import { type CaseContext, type SeedCase, labelled } from "./case.mts";
+import { ACTIVITY, loadHead, withoutContext } from "./writer.mts";
+
+/** A saved level of the chain, ready to be embedded in the next. */
+interface Level {
+ readonly label: string;
+ readonly id: Uuid;
+ readonly iri: string;
+ readonly revisionId: Uuid;
+ /** The level as the next one embeds it. */
+ readonly embedded: JsonObject;
+ /** The sources it declared, by their paths below its root. */
+ readonly sources: readonly EmbeddedSource[];
+}
+
+/** How each level wraps the one below it, from the bottom up. */
+const WRAPPERS: readonly {
+ readonly label: string;
+ readonly kind: "object" | "activity";
+ readonly key: string;
+ readonly document: JsonObject;
+}[] = [
+ {
+ label: "Create",
+ kind: "activity",
+ key: "object",
+ document: { type: "Create" },
+ },
+ {
+ label: "Like",
+ kind: "activity",
+ key: "object",
+ document: { type: "Like" },
+ },
+ {
+ label: "Announce",
+ kind: "activity",
+ key: "object",
+ document: { type: "Announce" },
+ },
+ {
+ label: "Announce of the Announce",
+ kind: "activity",
+ key: "object",
+ document: { type: "Announce" },
+ },
+ {
+ label: "Undo",
+ kind: "activity",
+ key: "object",
+ document: { type: "Undo" },
+ },
+];
+
+/**
+ * The sources a level declares for the level it embeds under a key: that
+ * level itself, and every source it declared, one key deeper.
+ * @returns The sources.
+ */
+const sourcesOf = (key: string, inner: Level): readonly EmbeddedSource[] => [
+ { path: [key], revisionId: inner.revisionId },
+ ...inner.sources.map(({ path, revisionId }) => ({
+ path: [key, ...path],
+ revisionId,
+ })),
+];
+
+/**
+ * Saves a document as a resource of workspace A.
+ * @returns The saved level.
+ */
+async function saveLevel(
+ { db, writer }: CaseContext,
+ label: string,
+ document: JsonObject,
+ kind: "object" | "activity",
+ sources: readonly EmbeddedSource[],
+): Promise {
+ const saved = await writer.save(
+ document,
+ kind === "activity" ? ACTIVITY : undefined,
+ sources.length === 0 ? undefined : sources,
+ );
+ const head = await loadHead(db, saved.id);
+ return {
+ label,
+ id: saved.id,
+ iri: saved.iri,
+ revisionId: head.revisionId,
+ embedded: withoutContext(head.document),
+ sources,
+ };
+}
+
+const deepChain: SeedCase = async (context) => {
+ const levels: Level[] = [
+ await saveLevel(
+ context,
+ "Note",
+ { type: "Note", content: "The note at the bottom, five levels down" },
+ "object",
+ [],
+ ),
+ ];
+ for (const { label, kind, key, document } of WRAPPERS) {
+ const inner = levels.at(-1);
+ if (inner == null) throw new Error("Missing the level below.");
+ levels.push(
+ await saveLevel(
+ context,
+ label,
+ { ...document, [key]: inner.embedded },
+ kind,
+ sourcesOf(key, inner),
+ ),
+ );
+ }
+ const [bottom] = levels;
+ if (bottom == null) throw new Error("Missing the bottom level.");
+ // Every snapshot of the bottom note is now behind its current revision.
+ await context.writer.edit(bottom.id, {
+ content: "Edited after it was embedded",
+ });
+ return {
+ number: 25,
+ title:
+ "Undo(Announce(Announce(Like(Create(Note))))), six levels with " +
+ "a source declared at every depth, the bottom Note edited afterwards",
+ resources: levels.toReversed().map((level) => labelled(level.label, level)),
+ };
+};
+
+/** Case 25: a document nested past what the resource page expands. */
+export const DEPTH_CASES: readonly SeedCase[] = [deepChain];
diff --git a/scripts/seed-revisions/cases-documents.mts b/scripts/seed-revisions/cases-documents.mts
new file mode 100644
index 00000000..94461da7
--- /dev/null
+++ b/scripts/seed-revisions/cases-documents.mts
@@ -0,0 +1,157 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import { ensureResource } from "@drfed/models/resource";
+import { appendResourceRevision } from "@drfed/models/resource-revision";
+import { uuidV7 } from "@drfed/models/uuid";
+
+import { type SeedCase, labelled } from "./case.mts";
+import { ACTIVITY, AS } from "./writer.mts";
+
+const UNREGISTERED_IRI = "https://remote.example/unregistered";
+const UNKNOWN_IRI = "https://remote.example/unknown";
+
+const nestedUndo: SeedCase = async ({ alice, writer }) => {
+ const note = await writer.save({ type: "Note", content: "A liked note" });
+ const undo = await writer.save(
+ {
+ type: "Undo",
+ object: { type: "Like", actor: alice.actorIri, object: note.iri },
+ },
+ ACTIVITY,
+ );
+ return {
+ number: 1,
+ title: "Undo(Like(Note)) nesting",
+ resources: [labelled("Undo", undo), labelled("Note", note)],
+ };
+};
+
+const addTarget: SeedCase = async ({ alice, writer }) => {
+ const note = await writer.save({ type: "Note", content: "A featured note" });
+ const add = await writer.save(
+ {
+ type: "Add",
+ object: note.iri,
+ target: { type: "OrderedCollection", id: `${alice.actorIri}/featured` },
+ },
+ ACTIVITY,
+ );
+ return {
+ number: 2,
+ title: "Add with a collection target",
+ resources: [labelled("Add", add)],
+ };
+};
+
+const unresolvedReferences: SeedCase = async ({ db, writer }) => {
+ await ensureResource(db, UNKNOWN_IRI);
+ const undo = await writer.save(
+ {
+ type: "Undo",
+ object: [
+ { type: "Like", object: UNREGISTERED_IRI },
+ { type: "Like", object: UNKNOWN_IRI },
+ ],
+ },
+ ACTIVITY,
+ );
+ return {
+ number: 3,
+ title: "References to an unregistered IRI and one of an unknown kind",
+ resources: [labelled("Undo", undo)],
+ };
+};
+
+const intransitive: SeedCase = async ({ writer }) => ({
+ number: 4,
+ title: "Arrive without an object",
+ resources: [
+ labelled("Arrive", await writer.save({ type: "Arrive" }, ACTIVITY)),
+ ],
+});
+
+const editedAfterCreate: SeedCase = async ({ writer }) => {
+ const [note, create] = await writer.saveAll(
+ { type: "Create", object: { type: "Note", content: "First version" } },
+ [
+ { path: ["object"], kind: "object", representation: "embedded" },
+ ...ACTIVITY,
+ ],
+ );
+ if (note == null || create == null) throw new Error("Missing a resource.");
+ await writer.edit(note.id, { content: "Second version" });
+ return {
+ number: 5,
+ title: "Create(Note), then the Note edited",
+ resources: [labelled("Create", create), labelled("Note", note)],
+ };
+};
+
+const extensionsAndUninterpreted: SeedCase = async ({ db, alice, writer }) => {
+ const extended = await writer.save({
+ "@context": [AS, { ex: "https://ext.example/ns#" }],
+ type: "Note",
+ content: "A note with an extension property",
+ "ex:mood": { level: 3 },
+ });
+ const tagged = await ensureResource(db, `${alice.actorIri}/seed/${uuidV7()}`);
+ // The validator refuses `tag`, so the common write cannot save this one.
+ await appendResourceRevision(db, {
+ resourceId: tagged.id,
+ resourceKind: "object",
+ expectedRevisionId: null,
+ kind: "snapshot",
+ capture: "local",
+ document: {
+ "@context": AS,
+ id: tagged.iri,
+ type: "Note",
+ content: "A note that is not interpreted",
+ tag: [{ type: "Mention", href: alice.actorIri }],
+ },
+ });
+ return {
+ number: 6,
+ title: "Extension properties, and a document that is not interpreted",
+ resources: [
+ labelled("Note with an extension", extended),
+ labelled("Uninterpreted Note", tagged),
+ ],
+ };
+};
+
+const deleted: SeedCase = async ({ writer }) => {
+ const note = await writer.save({ type: "Note", content: "Soon deleted" });
+ await writer.edit(note.id, { content: "Edited before deletion" });
+ await writer.remove(note.id);
+ return {
+ number: 7,
+ title: "A deleted object: a whiteout after two snapshots",
+ resources: [labelled("Note", note)],
+ };
+};
+
+/** Cases 1 to 7: how documents and histories are read. */
+export const DOCUMENT_CASES: readonly SeedCase[] = [
+ nestedUndo,
+ addTarget,
+ unresolvedReferences,
+ intransitive,
+ editedAfterCreate,
+ extensionsAndUninterpreted,
+ deleted,
+];
diff --git a/scripts/seed-revisions/cases-links.mts b/scripts/seed-revisions/cases-links.mts
new file mode 100644
index 00000000..050f8c3d
--- /dev/null
+++ b/scripts/seed-revisions/cases-links.mts
@@ -0,0 +1,295 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// The pages that link to a resource page read legacy typed rows: the actor
+// page lists objects, and the activity log links a delivery to its stored
+// `Create`. The common write stores revisions only, so these cases create
+// objects as the `createObject` mutation does, and record the deliveries of
+// their `Create`s directly, as no path delivers between seeded instances.
+//
+// Keep dependent database writes sequential.
+// oxlint-disable no-await-in-loop
+
+import {
+ type JsonObject,
+ type LegacyObjectInput,
+ createLegacyObject,
+ isLocalWriteError,
+} from "@drfed/federation/local-write";
+import { type Database, schema } from "@drfed/models";
+import { PUBLIC_IRI } from "@drfed/models/resource";
+import { type Uuid, uuidV7 } from "@drfed/models/uuid";
+
+import {
+ type CaseContext,
+ type SeedCase,
+ type SeededResource,
+} from "./case.mts";
+import type { Workspace } from "./environment.mts";
+import { loadHead } from "./writer.mts";
+
+/** More edits than the timeline loads at once, which is 20 revisions. */
+const LONG_HISTORY_EDITS = 24;
+const ACCEPTED = 202;
+const SERVER_ERROR = 500;
+
+/** A legacy object with its `Create`. */
+interface LegacyNote {
+ readonly object: SeededResource;
+ readonly create: SeededResource;
+}
+
+/** How an outbound delivery ended. */
+interface Outcome {
+ readonly status: "sent" | "failed";
+ readonly statusCode: number;
+ readonly error?: string;
+}
+
+/**
+ * Reads the IRI of a resource.
+ * @returns The labelled resource.
+ */
+async function resourceOf(
+ db: Database,
+ label: string,
+ id: Uuid,
+): Promise {
+ const resource = await db.query.resources.findFirst({ where: { id } });
+ if (resource == null) throw new Error(`No resource ${id}.`);
+ return { label, id, iri: resource.iri };
+}
+
+/**
+ * Creates a public object of workspace A as the `createObject` mutation
+ * does, so that it is listed on the actor page.
+ * @returns The object and its `Create`.
+ */
+async function createLegacy(
+ { db, env, alice }: CaseContext,
+ label: string,
+ input: Pick,
+): Promise {
+ const created = await createLegacyObject(
+ env,
+ { accountId: alice.member.accountId },
+ {
+ actorId: alice.actorId,
+ summary: null,
+ language: null,
+ sensitive: false,
+ addressing: { to: [PUBLIC_IRI] },
+ ...input,
+ },
+ );
+ if (isLocalWriteError(created)) throw new Error(JSON.stringify(created));
+ if (created.activityId == null) throw new Error("Missing the Create.");
+ return {
+ object: await resourceOf(db, label, created.id),
+ create: await resourceOf(db, `Create of the ${label}`, created.activityId),
+ };
+}
+
+/**
+ * Edits a legacy object's content once for each of the given versions.
+ */
+async function editContents(
+ { writer }: CaseContext,
+ objectId: Uuid,
+ contents: readonly string[],
+): Promise {
+ for (const content of contents) {
+ await writer.edit(objectId, { content: `${content}
` });
+ }
+}
+
+/**
+ * Reads the inbox of a workspace's actor.
+ * @returns The inbox URL.
+ */
+async function inboxOf(db: Database, { actorId }: Workspace): Promise {
+ const actor = await db.query.actors.findFirst({ where: { id: actorId } });
+ if (actor == null) throw new Error(`No actor ${actorId}.`);
+ return actor.inboxUrl;
+}
+
+/**
+ * The `Create` as DrFed delivers it: its saved document without blind
+ * recipients.
+ * @returns The payload.
+ */
+async function payloadOf(db: Database, createId: Uuid): Promise {
+ const {
+ bto: _bto,
+ bcc: _bcc,
+ ...payload
+ } = (await loadHead(db, createId)).document;
+ return payload;
+}
+
+/**
+ * Records that workspace A sent a `Create` to the actor of another
+ * workspace, and, when it was sent, that the other workspace received it.
+ */
+async function recordDelivery(
+ { db, alice }: CaseContext,
+ { object, create }: LegacyNote,
+ recipient: Workspace,
+ outcome: Outcome,
+): Promise {
+ const payload = await payloadOf(db, create.id);
+ const inboxUrl = await inboxOf(db, recipient);
+ const completed = Temporal.Now.instant();
+ const common = {
+ type: "Create",
+ types: ["Create"],
+ activityIri: create.iri,
+ activityId: create.id,
+ objectType: "Note",
+ objectIri: object.iri,
+ inboxUrl,
+ requestUrl: inboxUrl,
+ payload,
+ completed,
+ } satisfies Partial;
+ await db.insert(schema.activityDeliveries).values({
+ ...common,
+ id: uuidV7(),
+ instanceId: alice.instanceId,
+ actorId: alice.actorId,
+ direction: "outbound",
+ status: outcome.status,
+ statusCode: outcome.statusCode,
+ error: outcome.error ?? null,
+ recipientIris: [recipient.actorIri],
+ });
+ if (outcome.status !== "sent") return;
+ await db.insert(schema.activityDeliveries).values({
+ ...common,
+ id: uuidV7(),
+ instanceId: recipient.instanceId,
+ actorId: recipient.actorId,
+ direction: "inbound",
+ status: "received",
+ verificationMechanism: "http_signature",
+ verificationResult: "verified",
+ carriedSnapshot: true,
+ carriedObjectSnapshot: true,
+ remoteActorIri: alice.actorIri,
+ remoteHost: alice.host,
+ body: Buffer.from(JSON.stringify(payload)),
+ statusCode: ACCEPTED,
+ });
+}
+
+const listedObjects: SeedCase = async (context) => {
+ const note = await createLegacy(context, "Note", {
+ type: "Note",
+ contentHtml: "Listed, first version
",
+ name: null,
+ });
+ await editContents(context, note.object.id, [
+ "Listed, second version",
+ "Listed, third version",
+ ]);
+ const article = await createLegacy(context, "Article", {
+ type: "Article",
+ contentHtml: "An article, first version
",
+ name: "A titled article",
+ });
+ await editContents(context, article.object.id, [
+ "An article, second version",
+ ]);
+ return {
+ number: 21,
+ title:
+ "Objects on A's actor page with Revision history links: " +
+ "a Note edited twice and an Article edited once",
+ resources: [note.object, article.object],
+ };
+};
+
+const longHistory: SeedCase = async (context) => {
+ const note = await createLegacy(context, "Note", {
+ type: "Note",
+ contentHtml: "Version 1
",
+ name: null,
+ });
+ await editContents(
+ context,
+ note.object.id,
+ Array.from(
+ { length: LONG_HISTORY_EDITS },
+ (_, index) => `Version ${index + 2}`,
+ ),
+ );
+ return {
+ number: 22,
+ title:
+ `A Note on A's actor page edited ${LONG_HISTORY_EDITS} times, ` +
+ "more than the timeline loads at once",
+ resources: [note.object],
+ };
+};
+
+const deliveredCreate: SeedCase = async (context) => {
+ const note = await createLegacy(context, "Note", {
+ type: "Note",
+ contentHtml: "Delivered to B
",
+ name: null,
+ });
+ await recordDelivery(context, note, context.bob, {
+ status: "sent",
+ statusCode: ACCEPTED,
+ });
+ await editContents(context, note.object.id, ["Edited after delivery"]);
+ return {
+ number: 23,
+ title:
+ "A Create sent by A and received by B: Activity and Object history " +
+ "links in both activity logs, the Note edited after delivery",
+ resources: [note.create, note.object],
+ };
+};
+
+const deletedAfterFailure: SeedCase = async (context) => {
+ const note = await createLegacy(context, "Note", {
+ type: "Note",
+ contentHtml: "Undelivered, then deleted
",
+ name: null,
+ });
+ await recordDelivery(context, note, context.bob, {
+ status: "failed",
+ statusCode: SERVER_ERROR,
+ error: "The remote inbox answered 500 Internal Server Error.",
+ });
+ await context.writer.remove(note.object.id);
+ return {
+ number: 24,
+ title:
+ "A Create whose delivery from A failed, then its Note deleted: " +
+ "gone from A's actor page, but linked from A's activity log",
+ resources: [note.create, note.object],
+ };
+};
+
+/** Cases 21 to 24: the pages that link to resource pages. */
+export const LINK_CASES: readonly SeedCase[] = [
+ listedObjects,
+ longHistory,
+ deliveredCreate,
+ deletedAfterFailure,
+];
diff --git a/scripts/seed-revisions/cases-sources.mts b/scripts/seed-revisions/cases-sources.mts
new file mode 100644
index 00000000..4b25509e
--- /dev/null
+++ b/scripts/seed-revisions/cases-sources.mts
@@ -0,0 +1,231 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import {
+ type JsonObject,
+ createLegacyObject,
+ isLocalWriteError,
+} from "@drfed/federation/local-write";
+import { PUBLIC_IRI } from "@drfed/models/resource";
+import type { Uuid } from "@drfed/models/uuid";
+
+import { type CaseContext, type SeedCase, labelled } from "./case.mts";
+import { ACTIVITY, AS, loadHead, withoutContext } from "./writer.mts";
+
+interface SavedNote {
+ readonly id: Uuid;
+ readonly iri: string;
+ /** The revision an editor would have loaded the note from. */
+ readonly revisionId: Uuid;
+ /** The note as another document embeds it. */
+ readonly embedded: JsonObject;
+}
+
+async function saveNote(
+ { db, writer }: CaseContext,
+ content: string,
+): Promise {
+ const { id, iri } = await writer.save({ type: "Note", content });
+ const head = await loadHead(db, id);
+ return {
+ id,
+ iri,
+ revisionId: head.revisionId,
+ embedded: withoutContext(head.document),
+ };
+}
+
+const like = (object: JsonObject): JsonObject => ({ type: "Like", object });
+
+const declared = (note: SavedNote) => [
+ { path: ["object"], revisionId: note.revisionId },
+];
+
+const snapshotCurrent: SeedCase = async (context) => {
+ const note = await saveNote(context, "Embedded as it is");
+ const saved = await context.writer.save(
+ like(note.embedded),
+ ACTIVITY,
+ declared(note),
+ );
+ return {
+ number: 8,
+ title: "Snapshot of a source that is still current",
+ resources: [labelled("Like", saved), labelled("Note", note)],
+ };
+};
+
+const snapshotSuperseded: SeedCase = async (context) => {
+ const note = await saveNote(context, "Embedded, then edited");
+ const saved = await context.writer.save(
+ like(note.embedded),
+ ACTIVITY,
+ declared(note),
+ );
+ await context.writer.edit(note.id, { content: "Edited after the Like" });
+ return {
+ number: 9,
+ title: "Snapshot of a source with a newer revision",
+ resources: [labelled("Like", saved), labelled("Note", note)],
+ };
+};
+
+const snapshotDeleted: SeedCase = async (context) => {
+ const note = await saveNote(context, "Embedded, then deleted");
+ const saved = await context.writer.save(
+ like(note.embedded),
+ ACTIVITY,
+ declared(note),
+ );
+ await context.writer.remove(note.id);
+ return {
+ number: 10,
+ title: "Snapshot of a source that was deleted",
+ resources: [labelled("Like", saved), labelled("Note", note)],
+ };
+};
+
+const derivedCurrent: SeedCase = async (context) => {
+ const note = await saveNote(context, "Loaded by an editor");
+ const saved = await context.writer.save(
+ like({ ...note.embedded, content: "Changed before embedding" }),
+ ACTIVITY,
+ declared(note),
+ );
+ return {
+ number: 11,
+ title: "Derived from a declared source that is still current",
+ resources: [labelled("Like", saved), labelled("Note", note)],
+ };
+};
+
+const derivedSuperseded: SeedCase = async (context) => {
+ const note = await saveNote(context, "Loaded, then edited apart");
+ const saved = await context.writer.save(
+ like({ ...note.embedded, content: "Changed before embedding" }),
+ ACTIVITY,
+ declared(note),
+ );
+ await context.writer.edit(note.id, { content: "Edited after the Like" });
+ return {
+ number: 12,
+ title: "Derived from a declared source with a newer revision",
+ resources: [labelled("Like", saved), labelled("Note", note)],
+ };
+};
+
+const unknownSource: SeedCase = async (context) => {
+ const { env, alice, writer } = context;
+ const note = await saveNote(context, "Read by a script");
+ await writer.edit(note.id, { content: "Edited before the script saved" });
+ // Nothing is declared, so the stale copy has no known source.
+ const stale = await writer.save(like(note.embedded), ACTIVITY);
+ const legacy = await createLegacyObject(
+ env,
+ { accountId: alice.member.accountId },
+ {
+ actorId: alice.actorId,
+ type: "Note",
+ contentHtml: "Created through createObject
",
+ name: null,
+ summary: null,
+ language: null,
+ sensitive: false,
+ addressing: { to: [PUBLIC_IRI] },
+ },
+ );
+ if (isLocalWriteError(legacy)) throw new Error(JSON.stringify(legacy));
+ if (legacy.activityId == null) throw new Error("Missing the legacy Create.");
+ return {
+ number: 13,
+ title: "Unknown sources: an undeclared stale copy and a legacy Create",
+ resources: [
+ labelled("Like of a stale copy", stale),
+ labelled("Note", note),
+ { label: "Legacy Create", id: legacy.activityId, iri: "" },
+ { label: "Legacy Note", id: legacy.id, iri: "" },
+ ],
+ };
+};
+
+const reserialized: SeedCase = async (context) => {
+ const note = await saveNote(context, "Serialized differently");
+ const reordered = Object.fromEntries(
+ Object.entries(note.embedded).toReversed(),
+ );
+ const kept = await context.writer.save(
+ like(reordered),
+ ACTIVITY,
+ declared(note),
+ );
+ const recontextualized = await context.writer.save(
+ like({
+ "@context": [AS, { ex: "https://ext.example/ns#" }],
+ ...note.embedded,
+ }),
+ ACTIVITY,
+ declared(note),
+ );
+ return {
+ number: 14,
+ title: "Reordered keys stay a snapshot; another context is derived",
+ resources: [
+ labelled("Like with reordered keys", kept),
+ labelled("Like with another context", recontextualized),
+ labelled("Note", note),
+ ],
+ };
+};
+
+const deepSources: SeedCase = async (context) => {
+ const { db, writer } = context;
+ const note = await saveNote(context, "Embedded two levels deep");
+ const liked = await writer.save(
+ like(note.embedded),
+ ACTIVITY,
+ declared(note),
+ );
+ const head = await loadHead(db, liked.id);
+ const undo = await writer.save(
+ { type: "Undo", object: withoutContext(head.document) },
+ ACTIVITY,
+ [
+ { path: ["object"], revisionId: head.revisionId },
+ { path: ["object", "object"], revisionId: note.revisionId },
+ ],
+ );
+ return {
+ number: 15,
+ title: "Undo(Like(Note)) with a source at both depths",
+ resources: [
+ labelled("Undo", undo),
+ labelled("Like", liked),
+ labelled("Note", note),
+ ],
+ };
+};
+
+/** Cases 8 to 15: where embedded documents came from. */
+export const SOURCE_CASES: readonly SeedCase[] = [
+ snapshotCurrent,
+ snapshotSuperseded,
+ snapshotDeleted,
+ derivedCurrent,
+ derivedSuperseded,
+ unknownSource,
+ reserialized,
+ deepSources,
+];
diff --git a/scripts/seed-revisions/environment.mts b/scripts/seed-revisions/environment.mts
new file mode 100644
index 00000000..86cdb07c
--- /dev/null
+++ b/scripts/seed-revisions/environment.mts
@@ -0,0 +1,238 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// Keep dependent database writes sequential.
+// oxlint-disable no-await-in-loop
+
+import createFederation from "@drfed/federation";
+import type { LocalWriteEnvironment } from "@drfed/federation/local-write";
+import { createYogaServer } from "@drfed/graphql";
+import {
+ type Database,
+ migrate,
+ openPersistentPglite,
+ relations,
+ schema,
+} from "@drfed/models";
+import { type Uuid, uuidV7 } from "@drfed/models/uuid";
+import { MemoryKvStore } from "@fedify/fedify";
+import { eq } from "drizzle-orm";
+import { drizzle } from "drizzle-orm/pglite";
+
+const SLUG_A = "seed-a";
+const SLUG_B = "seed-b";
+const ACCOUNTS = [
+ { key: "alice", name: "Alice", email: "alice@example.com", admin: false },
+ { key: "bob", name: "Bob", email: "bob@example.com", admin: false },
+ { key: "admin", name: "Admin", email: "admin@example.com", admin: true },
+] as const;
+
+/** An account the seed created, with an access token of its session. */
+export interface Member {
+ readonly accountId: Uuid;
+ readonly name: string;
+ readonly email: string;
+ readonly token: string;
+}
+
+/** A local instance with its one member and one actor. */
+export interface Workspace {
+ readonly instanceId: Uuid;
+ readonly host: string;
+ readonly actorId: Uuid;
+ readonly actorIri: string;
+ /** Generated at random, so the report names it. */
+ readonly actorUsername: string;
+ readonly member: Member;
+}
+
+/** A GraphQL response body. */
+export interface GraphqlBody {
+ // oxlint-disable-next-line typescript/no-explicit-any
+ readonly data?: Record;
+ readonly errors?: readonly unknown[];
+}
+
+/** Sends a GraphQL request as a member, or anonymously for null. */
+export type GraphqlRequest = (
+ member: Member | null,
+ query: string,
+ variables?: Record,
+) => Promise;
+
+export interface SeedEnvironment {
+ readonly db: Database;
+ readonly write: LocalWriteEnvironment;
+ readonly graphql: GraphqlRequest;
+ readonly alice: Workspace;
+ readonly bob: Workspace;
+ readonly admin: Member;
+ close(): Promise;
+}
+
+/**
+ * Encodes a Relay global ID.
+ * @returns The ID.
+ */
+export const globalId = (type: string, id: string): string =>
+ Buffer.from(`${type}:${id}`).toString("base64");
+
+const hashToken = async (token: string): Promise =>
+ new Uint8Array(
+ await crypto.subtle.digest("SHA-256", new TextEncoder().encode(token)),
+ ).toHex();
+
+async function createMembers(db: Database): Promise> {
+ const created = Temporal.Now.instant();
+ const members: Record = {};
+ for (const { key, name, email, admin } of ACCOUNTS) {
+ const accountId = uuidV7();
+ const token = `seed-${key}-token`;
+ await db
+ .insert(schema.accounts)
+ .values({ id: accountId, email, name, admin, created });
+ await db.insert(schema.sessions).values({
+ id: uuidV7(),
+ accountId,
+ tokenHash: await hashToken(token),
+ });
+ members[key] = { accountId, name, email, token };
+ }
+ return members;
+}
+
+async function createWorkspace(
+ db: Database,
+ graphql: GraphqlRequest,
+ member: Member,
+ slug: string,
+): Promise {
+ const mutate = async (query: string, variables: Record) => {
+ const body = await graphql(member, query, variables);
+ if (body.errors != null) throw new Error(JSON.stringify(body.errors));
+ };
+ await mutate(
+ "mutation($slug: String!) { createInstance(slug: $slug) { __typename } }",
+ { slug },
+ );
+ const [instance] = await db
+ .select({ id: schema.instances.id, host: schema.instances.host })
+ .from(schema.instances)
+ .innerJoin(
+ schema.localInstances,
+ eq(schema.localInstances.id, schema.instances.localId),
+ )
+ .where(eq(schema.localInstances.slug, slug));
+ if (instance == null) throw new Error(`Instance ${slug} was not created.`);
+ await mutate(
+ `mutation($instance: ID!) {
+ generateActors(instance: $instance, size: 1) { __typename }
+ }`,
+ { instance: globalId("Instance", instance.id) },
+ );
+ const [actor] = await db
+ .select({
+ id: schema.actors.id,
+ iri: schema.resources.iri,
+ username: schema.actors.username,
+ })
+ .from(schema.actors)
+ .innerJoin(schema.resources, eq(schema.resources.id, schema.actors.id))
+ .where(eq(schema.actors.instanceId, instance.id));
+ if (actor == null) throw new Error(`No actor was created on ${slug}.`);
+ return {
+ instanceId: instance.id,
+ host: instance.host,
+ actorId: actor.id,
+ actorIri: actor.iri,
+ actorUsername: actor.username ?? "",
+ member,
+ };
+}
+
+/**
+ * Opens the PGlite store, migrates it, and creates the accounts, instances
+ * and actors every case shares. A store that was seeded before is refused,
+ * because revisions cannot be replaced.
+ * @returns The environment; close it when done.
+ */
+export async function openSeedEnvironment(
+ dataPath: string,
+ rootOrigin: URL,
+): Promise {
+ const store = await openPersistentPglite(dataPath);
+ try {
+ await store.ready;
+ const { client } = store;
+ await migrate({ credentials: { driver: "pglite", client } });
+ const db: Database = drizzle({ client, relations, schema });
+ const seeded = await db.$count(
+ schema.localInstances,
+ eq(schema.localInstances.slug, SLUG_A),
+ );
+ if (seeded > 0) {
+ throw new Error(
+ `${dataPath} is already seeded. Revisions are immutable, so ` +
+ "remove the directory and run the seed again.",
+ );
+ }
+ const federation = await createFederation(db, { kv: new MemoryKvStore() });
+ const yoga = createYogaServer(db, federation, {
+ rootOrigin,
+ loginOrigins: new Set(),
+ });
+ const endpoint = new URL("/graphql", rootOrigin).href;
+ const graphql: GraphqlRequest = async (member, query, variables = {}) => {
+ const response = await yoga.fetch(endpoint, {
+ method: "POST",
+ headers: {
+ "content-type": "application/json",
+ ...(member == null
+ ? {}
+ : { authorization: `Bearer ${member.token}` }),
+ },
+ body: JSON.stringify({ query, variables }),
+ });
+ return (await response.json()) as GraphqlBody;
+ };
+ const members = await createMembers(db);
+ const { alice, bob, admin } = members;
+ if (alice == null || bob == null || admin == null) {
+ throw new Error("Missing a seeded account.");
+ }
+ return {
+ db,
+ graphql,
+ write: {
+ db,
+ federation,
+ rootOrigin,
+ previewKey: await crypto.subtle.generateKey(
+ { name: "HMAC", hash: "SHA-256" },
+ false,
+ ["sign", "verify"],
+ ),
+ },
+ alice: await createWorkspace(db, graphql, alice, SLUG_A),
+ bob: await createWorkspace(db, graphql, bob, SLUG_B),
+ admin,
+ close: () => store.close(),
+ };
+ } catch (error) {
+ await store.close();
+ throw error;
+ }
+}
diff --git a/scripts/seed-revisions/main.mts b/scripts/seed-revisions/main.mts
new file mode 100644
index 00000000..017a0a1e
--- /dev/null
+++ b/scripts/seed-revisions/main.mts
@@ -0,0 +1,111 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// Seeds resource revisions for UI work into the development PGlite store.
+// Run it through `mise run seed:revisions` while `mise run dev` is stopped:
+// only one process can open the store.
+//
+// oxlint-disable no-console no-await-in-loop
+import { join } from "node:path";
+import process from "node:process";
+
+import type { SeedCase, SeededCase } from "./case.mts";
+import { ACCESS_CASES } from "./cases-access.mts";
+import { DEPTH_CASES } from "./cases-depth.mts";
+import { DOCUMENT_CASES } from "./cases-documents.mts";
+import { LINK_CASES } from "./cases-links.mts";
+import { SOURCE_CASES } from "./cases-sources.mts";
+import { openSeedEnvironment } from "./environment.mts";
+import { type Viewer, reportCases } from "./report.mts";
+import { createWriter } from "./writer.mts";
+
+const DEFAULT_DATA_PATH = ".pgdata";
+const DEFAULT_ROOT_ORIGIN = "http://drfed.localhost:8888";
+const CASES: readonly SeedCase[] = [
+ ...DOCUMENT_CASES,
+ ...SOURCE_CASES,
+ ...ACCESS_CASES,
+ ...LINK_CASES,
+ ...DEPTH_CASES,
+];
+
+// The development server reads its origins from this file; use the same.
+try {
+ process.loadEnvFile(
+ join(import.meta.dirname, "..", "..", "packages", "drfed", ".env"),
+ );
+} catch {
+ // Use the development default when the file is unavailable.
+}
+
+async function main(): Promise {
+ const dataPath = process.env.usage_data_path ?? DEFAULT_DATA_PATH;
+ const rootOrigin = new URL(
+ process.env.DRFED_ROOT_ORIGIN ?? DEFAULT_ROOT_ORIGIN,
+ );
+ const seed = await openSeedEnvironment(dataPath, rootOrigin);
+ try {
+ const { db, alice, bob, admin } = seed;
+ const context = {
+ db,
+ env: seed.write,
+ alice,
+ bob,
+ writer: createWriter(seed.write, alice),
+ };
+ const seeded: SeededCase[] = [];
+ for (const run of CASES) seeded.push(await run(context));
+ const viewers: readonly Viewer[] = [
+ { label: "Alice (A)", member: alice.member },
+ { label: "Bob (B)", member: bob.member },
+ { label: "Admin", member: admin },
+ { label: "Anonymous", member: null },
+ ];
+ console.log(`Seeded ${dataPath} under ${rootOrigin.origin}.`);
+ console.log("");
+ console.log(
+ "Accounts. The web UI lists only the instances of the account logged " +
+ "in, so log in by email as Alice or Bob to see a workspace; the admin " +
+ "is a member of none. The tokens are for GraphQL requests only:",
+ );
+ for (const { name, email, token } of [alice.member, bob.member, admin]) {
+ console.log(` ${name} <${email}>: ${token}`);
+ }
+ for (const [label, workspace] of [
+ ["A", alice],
+ ["B", bob],
+ ] as const) {
+ console.log(
+ `Workspace ${label}: ${workspace.host}, member ${workspace.member.email}, ` +
+ `actor @${workspace.actorUsername} ${workspace.actorIri}`,
+ );
+ }
+ console.log("");
+ console.log("Each resource below is followed by what every viewer reads.");
+ for (const line of await reportCases(seed.graphql, viewers, seeded)) {
+ console.log(line);
+ }
+ } finally {
+ await seed.close();
+ }
+}
+
+try {
+ await main();
+} catch (error) {
+ console.error(error);
+ process.exitCode = 1;
+}
diff --git a/scripts/seed-revisions/received.mts b/scripts/seed-revisions/received.mts
new file mode 100644
index 00000000..846ff315
--- /dev/null
+++ b/scripts/seed-revisions/received.mts
@@ -0,0 +1,88 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// Keep dependent database writes sequential.
+// oxlint-disable no-await-in-loop
+
+import type { JsonObject } from "@drfed/federation/local-write";
+import { type Database, schema } from "@drfed/models";
+import { ensureResource } from "@drfed/models/resource";
+import {
+ appendResourceRevision,
+ loadCurrentResourceRevision,
+} from "@drfed/models/resource-revision";
+import { type Uuid, uuidV7 } from "@drfed/models/uuid";
+
+import type { Workspace } from "./environment.mts";
+import { AS } from "./writer.mts";
+
+/** A remote `Note` as an inbound delivery would carry it. */
+export interface ReceivedNote {
+ readonly iri: string;
+ readonly attributedTo: string;
+ readonly content: string;
+ readonly to: readonly string[];
+ /** The workspaces whose inboxes received it. */
+ readonly deliveredTo: readonly Workspace[];
+}
+
+/**
+ * Stores a version of a remote `Note` as a received revision, with a receipt
+ * for each workspace it was delivered to. No write path stores received
+ * documents as revisions yet, so the rows are written directly.
+ * @returns The note's resource ID and the new revision's ID.
+ */
+export async function receiveNote(
+ db: Database,
+ { iri, attributedTo, content, to, deliveredTo }: ReceivedNote,
+): Promise<{ resourceId: Uuid; revisionId: Uuid; document: JsonObject }> {
+ const resource = await ensureResource(db, iri);
+ const current = await loadCurrentResourceRevision(db, resource.id);
+ const document: JsonObject = {
+ "@context": AS,
+ id: iri,
+ type: "Note",
+ attributedTo,
+ content,
+ to: [...to],
+ };
+ const revision = await appendResourceRevision(db, {
+ resourceId: resource.id,
+ resourceKind: "object",
+ expectedRevisionId: current?.id ?? null,
+ kind: "snapshot",
+ capture: "received",
+ document,
+ addressing: { to: [...to] },
+ });
+ for (const { instanceId, actorIri } of deliveredTo) {
+ const deliveryId = uuidV7();
+ await db.insert(schema.activityDeliveries).values({
+ id: deliveryId,
+ instanceId,
+ direction: "inbound",
+ status: "received",
+ verificationResult: "verified",
+ inboxUrl: `${actorIri}/inbox`,
+ body: Buffer.from(JSON.stringify(document)),
+ completed: Temporal.Now.instant(),
+ });
+ await db
+ .insert(schema.revisionReceipts)
+ .values({ deliveryId, revisionId: revision.id, role: "object" });
+ }
+ return { resourceId: resource.id, revisionId: revision.id, document };
+}
diff --git a/scripts/seed-revisions/report.mts b/scripts/seed-revisions/report.mts
new file mode 100644
index 00000000..2e6ca822
--- /dev/null
+++ b/scripts/seed-revisions/report.mts
@@ -0,0 +1,174 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+// Keep the viewers' requests in a fixed order.
+// oxlint-disable no-await-in-loop
+
+import type { SeededCase } from "./case.mts";
+import { type GraphqlRequest, type Member, globalId } from "./environment.mts";
+
+const NODE = "type iri source { relation status revision { sequence } }";
+const RELATION =
+ "path representation resource { currentRevision { sequence } }";
+const QUERY = `query($id: ID!) { node(id: $id) { ... on Resource {
+ iri kind
+ currentRevision { sequence kind capture interpreted root {
+ ${NODE} relations { ${RELATION} node {
+ ${NODE} relations { ${RELATION} node {
+ ${NODE}
+ } }
+ } }
+ } }
+ revisions(first: 50) { edges { node { sequence kind capture } } }
+} } }`;
+
+/** Who reads the seeded data, by a label for the report. */
+export interface Viewer {
+ readonly label: string;
+ readonly member: Member | null;
+}
+
+interface NodeView {
+ readonly type: string | null;
+ readonly iri: string | null;
+ readonly source: {
+ readonly relation: string;
+ readonly status: string | null;
+ readonly revision: { readonly sequence: number };
+ } | null;
+ readonly relations?: readonly {
+ readonly path: readonly (string | number)[];
+ readonly representation: string;
+ readonly resource: {
+ readonly currentRevision: { readonly sequence: number } | null;
+ } | null;
+ readonly node: NodeView | null;
+ }[];
+}
+
+type Relation = NonNullable[number];
+
+/**
+ * How a client may present where an embedded document came from, told from
+ * fields a reader already has:
+ *
+ * - `recorded`: the revision recorded its source.
+ * - `anonymous`: the document has no `id`, so it can have no source, and
+ * nothing needs to be shown.
+ * - `no-revisions`: no revision of the resource under its `id` is readable
+ * by the viewer, usually because none exists, as for a collection, so
+ * there was nothing to compare it with.
+ * - `unrecorded`: the resource has revisions, but none was recorded as the
+ * source. The document may still equal one of them; this is not a
+ * warning.
+ */
+export type SourceDisplay =
+ | "recorded"
+ | "anonymous"
+ | "no-revisions"
+ | "unrecorded";
+
+/**
+ * Classifies an embedded document by {@link SourceDisplay}.
+ * @returns The class.
+ */
+export function sourceDisplay({ node, resource }: Relation): SourceDisplay {
+ if (node?.source != null) return "recorded";
+ if (node?.iri == null) return "anonymous";
+ return resource?.currentRevision == null ? "no-revisions" : "unrecorded";
+}
+
+const shortType = (type: string | null): string =>
+ type?.split("#").at(-1) ?? "?";
+
+/**
+ * Lists the embedded documents under a node with their sources.
+ * @returns One line per embedded document, parents first.
+ */
+function embeddedSources(parent: NodeView): string[] {
+ return (parent.relations ?? []).flatMap((relation) => {
+ const { path, representation, node } = relation;
+ if (representation !== "embedded" || node == null) return [];
+ const { source } = node;
+ const described =
+ source == null
+ ? `no source (${sourceDisplay(relation)})`
+ : `${source.relation} of #${source.revision.sequence}, status ${source.status ?? "null"}`;
+ return [
+ `${path.join(".")} (${shortType(node.type)}): ${described}`,
+ ...embeddedSources(node),
+ ];
+ });
+}
+
+// oxlint-disable-next-line typescript/no-explicit-any
+function describe(node: Record | null | undefined): string[] {
+ if (node == null || node.kind == null) return ["resource: null"];
+ const revisions = (
+ node.revisions.edges as { node: { sequence: number; kind: string } }[]
+ ).map(({ node: { sequence, kind } }) =>
+ kind === "snapshot" ? `#${sequence}` : `#${sequence} ${kind}`,
+ );
+ const current = node.currentRevision;
+ const uninterpreted =
+ current?.kind === "snapshot" && !current.interpreted
+ ? " (not interpreted)"
+ : "";
+ const head =
+ current == null
+ ? "null"
+ : `#${current.sequence} ${current.kind} ${current.capture}${uninterpreted}`;
+ const lines = [
+ `kind ${node.kind}; revisions [${revisions.join(", ")}]; current ${head}`,
+ ];
+ const root = current?.root as NodeView | null | undefined;
+ return root == null ? lines : [...lines, ...embeddedSources(root)];
+}
+
+/**
+ * Reads every seeded resource as every viewer through GraphQL.
+ * @returns The report as text lines.
+ */
+export async function reportCases(
+ graphql: GraphqlRequest,
+ viewers: readonly Viewer[],
+ cases: readonly SeededCase[],
+): Promise {
+ const lines: string[] = [];
+ for (const { number, title, resources } of cases) {
+ lines.push("", `## ${number}. ${title}`);
+ for (const { label, id, iri } of resources) {
+ lines.push("", `${label}: ${globalId("Resource", id)}`);
+ if (iri !== "") lines.push(` ${iri}`);
+ for (const viewer of viewers) {
+ const body = await graphql(viewer.member, QUERY, {
+ id: globalId("Resource", id),
+ });
+ const described =
+ body.errors == null
+ ? describe(body.data?.node)
+ : [`errors: ${JSON.stringify(body.errors)}`];
+ lines.push(
+ ...described.map(
+ (line, index) =>
+ ` ${index === 0 ? viewer.label.padEnd(10) : " ".repeat(10)} ${line}`,
+ ),
+ );
+ }
+ }
+ }
+ return lines;
+}
diff --git a/scripts/seed-revisions/writer.mts b/scripts/seed-revisions/writer.mts
new file mode 100644
index 00000000..2fcea71b
--- /dev/null
+++ b/scripts/seed-revisions/writer.mts
@@ -0,0 +1,165 @@
+// DrFed: A web-based platform for developing and debugging ActivityPub apps
+// Copyright (C) 2026 DrFed team
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see .
+
+import {
+ type CreateRequest,
+ type EmbeddedSource,
+ type JsonObject,
+ type LocalWriteEnvironment,
+ type LocalWriteRequest,
+ type LocalWriteResult,
+ type SavedResource,
+ commitLocalWrite,
+ previewLocalWrite,
+} from "@drfed/federation/local-write";
+import { unreadableRevisions } from "@drfed/graphql/readable";
+import type { Database } from "@drfed/models";
+import { loadCurrentResourceRevision } from "@drfed/models/resource-revision";
+import type { Uuid } from "@drfed/models/uuid";
+
+import type { Workspace } from "./environment.mts";
+
+export const AS = "https://www.w3.org/ns/activitystreams";
+export const ACTIVITY: CreateRequest["resources"] = [
+ { path: [], kind: "activity" },
+];
+const OBJECT: CreateRequest["resources"] = [{ path: [], kind: "object" }];
+
+/** The current snapshot of a resource. */
+export interface Head {
+ readonly revisionId: Uuid;
+ readonly document: JsonObject;
+}
+
+/** Local writes of one actor, through the common write operations. */
+export interface Writer {
+ /** Saves new resources. @returns The root resource, saved last. */
+ save(
+ document: JsonObject,
+ resources?: CreateRequest["resources"],
+ sources?: readonly EmbeddedSource[],
+ ): Promise;
+ /** Saves new resources. @returns All of them, the root last. */
+ saveAll(
+ document: JsonObject,
+ resources: CreateRequest["resources"],
+ sources?: readonly EmbeddedSource[],
+ ): Promise;
+ /** Edits an object by changing its current document. */
+ edit(objectId: Uuid, changes: JsonObject): Promise;
+ /** Deletes an object, appending a whiteout. */
+ remove(objectId: Uuid): Promise;
+}
+
+/**
+ * Drops the `@context` of a stored document, to embed it in another.
+ * @returns The rest of the document.
+ */
+export const withoutContext = ({
+ "@context": _,
+ ...rest
+}: JsonObject): JsonObject => rest;
+
+/**
+ * Reads the current snapshot of a resource.
+ * @returns Its revision ID and document.
+ */
+export async function loadHead(db: Database, resourceId: Uuid): Promise {
+ const revision = await loadCurrentResourceRevision(db, resourceId);
+ if (revision?.document == null) {
+ throw new Error(`Resource ${resourceId} has no current snapshot.`);
+ }
+ return {
+ revisionId: revision.id,
+ document: revision.document as JsonObject,
+ };
+}
+
+/**
+ * Makes the writer of a workspace's actor. Nothing it saves is delivered:
+ * edits and deletions get a reservation that does nothing. Declared sources
+ * must be revisions the member may read, as GraphQL reads them.
+ * @returns The writer.
+ */
+export function createWriter(
+ env: LocalWriteEnvironment,
+ { actorId, member }: Workspace,
+): Writer {
+ const principal = { accountId: member.accountId };
+ const access = {
+ unreadableRevisions: async (ids: readonly Uuid[]) => {
+ const account = await env.db.query.accounts.findFirst({
+ where: { id: member.accountId },
+ });
+ if (account == null) throw new Error("The member has no account.");
+ return await unreadableRevisions({ db: env.db, account }, ids);
+ },
+ };
+ const commit = async (
+ request: LocalWriteRequest,
+ ): Promise => {
+ const preview = await previewLocalWrite(env, principal, request, access);
+ if (!preview.ok) throw new Error(JSON.stringify(preview.error));
+ const outcome = await commitLocalWrite(env, principal, request, {
+ ...access,
+ previewToken: preview.preview.token,
+ ...(request.operation === "create"
+ ? {}
+ : { reserveDispatch: () => Promise.resolve() }),
+ });
+ if (!outcome.ok) throw new Error(JSON.stringify(outcome.error));
+ return outcome.result;
+ };
+ const saveAll: Writer["saveAll"] = async (document, resources, sources) => {
+ const result = await commit({
+ operation: "create",
+ actorId,
+ document: { "@context": AS, ...document },
+ resources,
+ ...(sources == null ? {} : { sources }),
+ });
+ return result.resources;
+ };
+ return {
+ saveAll,
+ async save(document, resources, sources) {
+ const saved = (await saveAll(document, resources ?? OBJECT, sources)).at(
+ -1,
+ );
+ if (saved == null) throw new Error("Nothing was saved.");
+ return saved;
+ },
+ async edit(objectId, changes) {
+ const head = await loadHead(env.db, objectId);
+ await commit({
+ operation: "edit",
+ actorId,
+ objectId,
+ expectedRevisionId: head.revisionId,
+ document: { ...head.document, ...changes },
+ });
+ },
+ async remove(objectId) {
+ const head = await loadHead(env.db, objectId);
+ await commit({
+ operation: "delete",
+ actorId,
+ objectId,
+ expectedRevisionId: head.revisionId,
+ });
+ },
+ };
+}