@ecsplico/editor 2.1.2 → 3.1.0

package/dist/adapters/comments/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","names":[],"sources":["../../../src/adapters/comments/server.ts"],"sourcesContent":["import { isPortableAnchor } from '../anchors'\nimport { CommentStoreError, invalid } from './errors'\nimport type { Annotation, Comment, CommentStore, CreateThreadInput, ThreadStatus } from './types'\n\n// Framework-free REST handler of a document's comments endpoint: the host routes `GET`/`POST` of\n// `<base>/<documentId>` here after its own authentication and authorisation (the handler trusts the caller, including\n// the `authorId` of new comments), and answers with `status` and `body`. Nitro, Express or a test's fetch stub all fit.\n\nexport type { Annotation, Comment, CommentAction, CommentStore, CommentThread, CreateThreadInput, Discussion, NewThread, ThreadStatus } from './types'\nexport { CommentStoreError } from './errors'\n\nexport interface CommentsRequest {\n  method: string\n  documentId: string\n  /** The parsed JSON body of a `POST`. */\n  body?: unknown\n}\n\nexport interface CommentsResponse {\n  status: number\n  /** JSON; `{ error }` for a refused request. */\n  body: unknown\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value)\nconst isText = (value: unknown): value is string => typeof value === 'string'\nconst isId = (value: unknown): value is string => isText(value) && value !== ''\n\nfunction commentOf(value: unknown): Comment {\n  if (!isRecord(value) || !isId(value.id) || !isText(value.body) || !isId(value.authorId) || !isId(value.createdAt)) throw invalid('Ein Kommentar braucht id, body, authorId und createdAt')\n  for (const key of ['authorName', 'authorColor', 'editedAt']) {\n    if (value[key] !== undefined && !isText(value[key])) throw invalid(`Kommentar-Feld „${key}“ muss Text sein`)\n  }\n  const { id, body, authorId, createdAt } = value\n  const { authorName, authorColor, editedAt } = value as Record<string, string | undefined>\n  return { id, body, authorId, createdAt, ...(authorName !== undefined && { authorName }), ...(authorColor !== undefined && { authorColor }), ...(editedAt !== undefined && { editedAt }) }\n}\n\nfunction annotationOf(value: unknown): Annotation {\n  if (!isRecord(value) || !isId(value.id) || !isId(value.threadId) || !isPortableAnchor(value.anchor)) throw invalid('Eine Annotation braucht id, threadId und einen gültigen anchor')\n  return { id: value.id, threadId: value.threadId, anchor: value.anchor }\n}\n\nfunction threadInputOf(value: unknown): CreateThreadInput {\n  if (!isRecord(value) || !isId(value.id) || !isId(value.annotationId)) throw invalid('Ein Thread braucht id, annotationId und initialComment')\n  return { id: value.id, annotationId: value.annotationId, initialComment: commentOf(value.initialComment) }\n}\n\nfunction idOf(value: Record<string, unknown>, key: string): string {\n  const id = value[key]\n  if (!isId(id)) throw invalid(`„${key}“ muss ein nicht leerer String sein`)\n  return id\n}\n\nfunction statusOf(value: unknown): ThreadStatus {\n  if (value !== 'open' && value !== 'resolved') throw invalid('„status“ muss „open“ oder „resolved“ sein')\n  return value\n}\n\nasync function perform(store: CommentStore, documentId: string, body: unknown): Promise<unknown> {\n  if (!isRecord(body)) throw invalid('Der Request-Body muss ein JSON-Objekt mit „action“ sein')\n  switch (body.action) {\n    case 'create':\n      return store.createThread(documentId, { annotation: annotationOf(body.annotation), thread: threadInputOf(body.thread) })\n    case 'reply':\n      return { thread: await store.addComment(documentId, idOf(body, 'threadId'), commentOf(body.comment)) }\n    case 'status':\n      return { thread: await store.setThreadStatus(documentId, idOf(body, 'threadId'), statusOf(body.status)) }\n    case 'update-annotation':\n      return { annotation: await store.updateAnchor(documentId, annotationOf(body.annotation)) }\n    case 'remove':\n      await store.removeThread(documentId, idOf(body, 'threadId'))\n      return { ok: true }\n    case 'edit':\n      if (!isText(body.body)) throw invalid('„body“ muss Text sein')\n      return { thread: await store.editComment(documentId, idOf(body, 'threadId'), idOf(body, 'commentId'), body.body, isId(body.editedAt) ? body.editedAt : new Date().toISOString()) }\n    case 'remove-comment':\n      return { thread: await store.removeComment(documentId, idOf(body, 'threadId'), idOf(body, 'commentId')) }\n    default:\n      throw invalid('Unbekannte Kommentar-Aktion')\n  }\n}\n\n/**\n * `GET` → `200` with the document's `Discussion`; `POST` with a `CommentAction` → `200` with the changed `thread`/`annotation`\n * (`create`: both; `remove`: `{ ok: true }`). Refused requests answer `404` (unknown ids), `409` (duplicate ids), `400`\n * (malformed input) or `405` with `{ error }`; anything else is a server fault and is thrown.\n */\nexport async function handleCommentsRequest(store: CommentStore, request: CommentsRequest): Promise<CommentsResponse> {\n  const method = request.method.toUpperCase()\n  try {\n    if (method === 'GET') return { status: 200, body: await store.getDiscussion(request.documentId) }\n    if (method === 'POST') return { status: 200, body: await perform(store, request.documentId, request.body) }\n    return { status: 405, body: { error: `Methode ${request.method} ist nicht erlaubt` } } // i18n-ignore: HTTP error body of the comments route (server messages stay German, like src/server)\n  }\n  catch (error) {\n    if (error instanceof CommentStoreError) return { status: error.status, body: { error: error.message } }\n    throw error\n  }\n}\n"],"mappings":";;;AAwBA,MAAM,YAAY,UAAqD,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC1I,MAAM,UAAU,UAAoC,OAAO,UAAU;AACrE,MAAM,QAAQ,UAAoC,OAAO,KAAK,KAAK,UAAU;AAE7E,SAAS,UAAU,OAAyB;CAC1C,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,MAAM,EAAE,KAAK,CAAC,OAAO,MAAM,IAAI,KAAK,CAAC,KAAK,MAAM,QAAQ,KAAK,CAAC,KAAK,MAAM,SAAS,GAAG,MAAM,QAAQ,wDAAwD;CACzL,KAAK,MAAM,OAAO;EAAC;EAAc;EAAe;CAAU,GACxD,IAAI,MAAM,SAAS,KAAA,KAAa,CAAC,OAAO,MAAM,IAAI,GAAG,MAAM,QAAQ,mBAAmB,IAAI,iBAAiB;CAE7G,MAAM,EAAE,IAAI,MAAM,UAAU,cAAc;CAC1C,MAAM,EAAE,YAAY,aAAa,aAAa;CAC9C,OAAO;EAAE;EAAI;EAAM;EAAU;EAAW,GAAI,eAAe,KAAA,KAAa,EAAE,WAAW;EAAI,GAAI,gBAAgB,KAAA,KAAa,EAAE,YAAY;EAAI,GAAI,aAAa,KAAA,KAAa,EAAE,SAAS;CAAG;AAC1L;AAEA,SAAS,aAAa,OAA4B;CAChD,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,MAAM,EAAE,KAAK,CAAC,KAAK,MAAM,QAAQ,KAAK,CAAC,iBAAiB,MAAM,MAAM,GAAG,MAAM,QAAQ,gEAAgE;CACnL,OAAO;EAAE,IAAI,MAAM;EAAI,UAAU,MAAM;EAAU,QAAQ,MAAM;CAAO;AACxE;AAEA,SAAS,cAAc,OAAmC;CACxD,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,MAAM,EAAE,KAAK,CAAC,KAAK,MAAM,YAAY,GAAG,MAAM,QAAQ,wDAAwD;CAC5I,OAAO;EAAE,IAAI,MAAM;EAAI,cAAc,MAAM;EAAc,gBAAgB,UAAU,MAAM,cAAc;CAAE;AAC3G;AAEA,SAAS,KAAK,OAAgC,KAAqB;CACjE,MAAM,KAAK,MAAM;CACjB,IAAI,CAAC,KAAK,EAAE,GAAG,MAAM,QAAQ,IAAI,IAAI,oCAAoC;CACzE,OAAO;AACT;AAEA,SAAS,SAAS,OAA8B;CAC9C,IAAI,UAAU,UAAU,UAAU,YAAY,MAAM,QAAQ,2CAA2C;CACvG,OAAO;AACT;AAEA,eAAe,QAAQ,OAAqB,YAAoB,MAAiC;CAC/F,IAAI,CAAC,SAAS,IAAI,GAAG,MAAM,QAAQ,yDAAyD;CAC5F,QAAQ,KAAK,QAAb;EACE,KAAK,UACH,OAAO,MAAM,aAAa,YAAY;GAAE,YAAY,aAAa,KAAK,UAAU;GAAG,QAAQ,cAAc,KAAK,MAAM;EAAE,CAAC;EACzH,KAAK,SACH,OAAO,EAAE,QAAQ,MAAM,MAAM,WAAW,YAAY,KAAK,MAAM,UAAU,GAAG,UAAU,KAAK,OAAO,CAAC,EAAE;EACvG,KAAK,UACH,OAAO,EAAE,QAAQ,MAAM,MAAM,gBAAgB,YAAY,KAAK,MAAM,UAAU,GAAG,SAAS,KAAK,MAAM,CAAC,EAAE;EAC1G,KAAK,qBACH,OAAO,EAAE,YAAY,MAAM,MAAM,aAAa,YAAY,aAAa,KAAK,UAAU,CAAC,EAAE;EAC3F,KAAK;GACH,MAAM,MAAM,aAAa,YAAY,KAAK,MAAM,UAAU,CAAC;GAC3D,OAAO,EAAE,IAAI,KAAK;EACpB,KAAK;GACH,IAAI,CAAC,OAAO,KAAK,IAAI,GAAG,MAAM,QAAQ,uBAAuB;GAC7D,OAAO,EAAE,QAAQ,MAAM,MAAM,YAAY,YAAY,KAAK,MAAM,UAAU,GAAG,KAAK,MAAM,WAAW,GAAG,KAAK,MAAM,KAAK,KAAK,QAAQ,IAAI,KAAK,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY,CAAC,EAAE;EACnL,KAAK,kBACH,OAAO,EAAE,QAAQ,MAAM,MAAM,cAAc,YAAY,KAAK,MAAM,UAAU,GAAG,KAAK,MAAM,WAAW,CAAC,EAAE;EAC1G,SACE,MAAM,QAAQ,6BAA6B;CAC/C;AACF;;;;;;AAOA,eAAsB,sBAAsB,OAAqB,SAAqD;CACpH,MAAM,SAAS,QAAQ,OAAO,YAAY;CAC1C,IAAI;EACF,IAAI,WAAW,OAAO,OAAO;GAAE,QAAQ;GAAK,MAAM,MAAM,MAAM,cAAc,QAAQ,UAAU;EAAE;EAChG,IAAI,WAAW,QAAQ,OAAO;GAAE,QAAQ;GAAK,MAAM,MAAM,QAAQ,OAAO,QAAQ,YAAY,QAAQ,IAAI;EAAE;EAC1G,OAAO;GAAE,QAAQ;GAAK,MAAM,EAAE,OAAO,WAAW,QAAQ,OAAO,oBAAoB;EAAE;CACvF,SACO,OAAO;EACZ,IAAI,iBAAiB,mBAAmB,OAAO;GAAE,QAAQ,MAAM;GAAQ,MAAM,EAAE,OAAO,MAAM,QAAQ;EAAE;EACtG,MAAM;CACR;AACF"}
+{"version":3,"file":"server.js","names":[],"sources":["../../../src/adapters/comments/server.ts"],"sourcesContent":["import { isPortableAnchor } from '../anchors'\nimport { CommentStoreError, invalid } from './errors'\nimport type { Annotation, Comment, CommentStore, CreateThreadInput, ThreadStatus } from './types'\n\n// Framework-free REST handler of a document's comments endpoint: the host routes `GET`/`POST` of\n// `<base>/<documentId>` here after its own authentication and authorisation (the handler trusts the caller, including\n// the `authorId` of new comments), and answers with `status` and `body`. Nitro, Express or a test's fetch stub all fit.\n\nexport type { Annotation, Comment, CommentAction, CommentStore, CommentThread, CreateThreadInput, Discussion, NewThread, ThreadStatus } from './types'\nexport { CommentStoreError } from './errors'\n// The pure operations of a stored `Discussion` (the JSON store is built from them): a host `CommentStore` over its own database applies them to the record it loaded and writes the record back. They change the record in place and throw `CommentStoreError` for unknown ids, duplicates and malformed input.\nexport { addComment, createThread, editComment, emptyDiscussion, removeComment, removeThread, setThreadStatus, updateAnchor } from './record'\n\nexport interface CommentsRequest {\n  method: string\n  documentId: string\n  /** The parsed JSON body of a `POST`. */\n  body?: unknown\n}\n\nexport interface CommentsResponse {\n  status: number\n  /** JSON; `{ error }` for a refused request. */\n  body: unknown\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null && !Array.isArray(value)\nconst isText = (value: unknown): value is string => typeof value === 'string'\nconst isId = (value: unknown): value is string => isText(value) && value !== ''\n\nfunction commentOf(value: unknown): Comment {\n  if (!isRecord(value) || !isId(value.id) || !isText(value.body) || !isId(value.authorId) || !isId(value.createdAt)) throw invalid('Ein Kommentar braucht id, body, authorId und createdAt')\n  for (const key of ['authorName', 'authorColor', 'editedAt']) {\n    if (value[key] !== undefined && !isText(value[key])) throw invalid(`Kommentar-Feld „${key}“ muss Text sein`)\n  }\n  const { id, body, authorId, createdAt } = value\n  const { authorName, authorColor, editedAt } = value as Record<string, string | undefined>\n  return { id, body, authorId, createdAt, ...(authorName !== undefined && { authorName }), ...(authorColor !== undefined && { authorColor }), ...(editedAt !== undefined && { editedAt }) }\n}\n\nfunction annotationOf(value: unknown): Annotation {\n  if (!isRecord(value) || !isId(value.id) || !isId(value.threadId) || !isPortableAnchor(value.anchor)) throw invalid('Eine Annotation braucht id, threadId und einen gültigen anchor')\n  return { id: value.id, threadId: value.threadId, anchor: value.anchor }\n}\n\nfunction threadInputOf(value: unknown): CreateThreadInput {\n  if (!isRecord(value) || !isId(value.id) || !isId(value.annotationId)) throw invalid('Ein Thread braucht id, annotationId und initialComment')\n  return { id: value.id, annotationId: value.annotationId, initialComment: commentOf(value.initialComment) }\n}\n\nfunction idOf(value: Record<string, unknown>, key: string): string {\n  const id = value[key]\n  if (!isId(id)) throw invalid(`„${key}“ muss ein nicht leerer String sein`)\n  return id\n}\n\nfunction statusOf(value: unknown): ThreadStatus {\n  if (value !== 'open' && value !== 'resolved') throw invalid('„status“ muss „open“ oder „resolved“ sein')\n  return value\n}\n\nasync function perform(store: CommentStore, documentId: string, body: unknown): Promise<unknown> {\n  if (!isRecord(body)) throw invalid('Der Request-Body muss ein JSON-Objekt mit „action“ sein')\n  switch (body.action) {\n    case 'create':\n      return store.createThread(documentId, { annotation: annotationOf(body.annotation), thread: threadInputOf(body.thread) })\n    case 'reply':\n      return { thread: await store.addComment(documentId, idOf(body, 'threadId'), commentOf(body.comment)) }\n    case 'status':\n      return { thread: await store.setThreadStatus(documentId, idOf(body, 'threadId'), statusOf(body.status)) }\n    case 'update-annotation':\n      return { annotation: await store.updateAnchor(documentId, annotationOf(body.annotation)) }\n    case 'remove':\n      await store.removeThread(documentId, idOf(body, 'threadId'))\n      return { ok: true }\n    case 'edit':\n      if (!isText(body.body)) throw invalid('„body“ muss Text sein')\n      return { thread: await store.editComment(documentId, idOf(body, 'threadId'), idOf(body, 'commentId'), body.body, isId(body.editedAt) ? body.editedAt : new Date().toISOString()) }\n    case 'remove-comment':\n      return { thread: await store.removeComment(documentId, idOf(body, 'threadId'), idOf(body, 'commentId')) }\n    default:\n      throw invalid('Unbekannte Kommentar-Aktion')\n  }\n}\n\n/**\n * `GET` → `200` with the document's `Discussion`; `POST` with a `CommentAction` → `200` with the changed `thread`/`annotation`\n * (`create`: both; `remove`: `{ ok: true }`). Refused requests answer `404` (unknown ids), `409` (duplicate ids), `400`\n * (malformed input) or `405` with `{ error }`; anything else is a server fault and is thrown.\n */\nexport async function handleCommentsRequest(store: CommentStore, request: CommentsRequest): Promise<CommentsResponse> {\n  const method = request.method.toUpperCase()\n  try {\n    if (method === 'GET') return { status: 200, body: await store.getDiscussion(request.documentId) }\n    if (method === 'POST') return { status: 200, body: await perform(store, request.documentId, request.body) }\n    return { status: 405, body: { error: `Methode ${request.method} ist nicht erlaubt` } } // i18n-ignore: HTTP error body of the comments route (server messages stay German, like src/server)\n  }\n  catch (error) {\n    if (error instanceof CommentStoreError) return { status: error.status, body: { error: error.message } }\n    throw error\n  }\n}\n"],"mappings":"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"}

package/dist/adapters/comments/types.d.ts

@@ -73,8 +73,8 @@ export interface CommentStore {
   removeDocuments(prefix: string): Promise<number>;
 }
 /**
- * The body of a `POST` to a document's comments endpoint (`handleCommentsRequest` answers it, `createRestCommentsModel`
- * sends it). `GET` answers the document's `Discussion`. The first five actions are skaile-forge's original wire format.
+ * The body of a `POST` to a document's comments endpoint (`handleCommentsRequest` answers it, the REST comments model of
+ * `createHttpBackend().comments` sends it). `GET` answers the document's `Discussion`. The first five actions are skaile-forge's original wire format.
  */
 export type CommentAction = {
   action: 'create';

package/dist/adapters/document-state.d.ts

@@ -0,0 +1,23 @@
+import { CollaborationToken, EditorBackend } from "../core/backend.js";
+import { AuthorIdentity } from "../core/feature.js";
+import "../core/index.js";
+import { JSONContent } from "@tiptap/core";
+//#region src/adapters/document-state.d.ts
+export interface EditorDocumentOptions {
+  /** Where documents, the collaboration session and the comments live. Default: the backend of the editor context (`createEditor` / `EditorContextProvider`). Collaboration and comments need one that has them, e.g. `createHttpBackend()` (`@ecsplico/editor/adapters/http`). */
+  backend?: EditorBackend;
+  /**
+   * Live collaboration: `true`, or `{ token }` for the token the collaboration server's `Identity.authenticate` receives.
+   * With it the Y.Doc is the document: the server loads and stores the content, so the hook neither loads nor saves it
+   * (`modelValue` stays `undefined`, `dirty` stays `false`, `save()` resolves at once). Needs `backend.collaboration`.
+   */
+  collaboration?: boolean | {
+    token?: CollaborationToken;
+  };
+  /** Who writes: labels remote carets and is the author of new comments; `null` or omitted = nobody (no comments). */
+  user?: AuthorIdentity | null | (() => AuthorIdentity | null);
+  /** Whether the user may comment now (a reader of a read-only document may be refused); default `true`. */
+  canComment?: boolean | (() => boolean);
+}
+//#endregion
+//# sourceMappingURL=document-state.d.ts.map

package/dist/adapters/document-state.js

@@ -0,0 +1,66 @@
+//#region src/adapters/document-state.ts
+const EMPTY_DOCUMENT = {
+	type: "doc",
+	content: [{ type: "paragraph" }]
+};
+/**
+* The document as compared for "unsaved changes": without block ids. The editor gives every block of loaded content an
+* id the moment it mounts (stored files have none yet); that is not an edit the user made, so it must not mark a
+* freshly opened document dirty. Saving still writes the ids.
+*/
+const withoutBlockIds = (node) => {
+	const { attrs, content, ...rest } = node;
+	const kept = attrs && Object.fromEntries(Object.entries(attrs).filter(([name]) => name !== "id"));
+	return {
+		...rest,
+		...kept && Object.keys(kept).length > 0 && { attrs: kept },
+		...content && { content: content.map(withoutBlockIds) }
+	};
+};
+const fingerprint = (content) => JSON.stringify(withoutBlockIds(content));
+/** The state after `documents.load` answered: `null` (no such document) starts empty. */
+function loadedDocument(content) {
+	if (content === null) return {
+		modelValue: structuredClone(EMPTY_DOCUMENT),
+		saved: fingerprint(EMPTY_DOCUMENT),
+		missing: true
+	};
+	return {
+		modelValue: content,
+		saved: fingerprint(content),
+		missing: false
+	};
+}
+/** Edits since the content was loaded or last saved; never in collaboration mode (the Y.Doc is the document) or before the first load. */
+function isDirty(collaborating, modelValue, saved) {
+	return !collaborating && modelValue !== void 0 && saved !== null && fingerprint(modelValue) !== saved;
+}
+/** The `fingerprint` a save of `content` would store, or `null` when there is nothing to save: no content yet, not ready, or unchanged and already stored. */
+function fingerprintToSave(content, ready, saved, missing) {
+	if (content === void 0 || !ready) return null;
+	const next = fingerprint(content);
+	return next === saved && !missing ? null : next;
+}
+const errorOf = (cause) => cause instanceof Error ? cause : new Error(String(cause));
+/** The `capability` of `backend`; throws the developer error when it lacks it (called at setup, not on the first request). */
+function requireCapability(backend, capability) {
+	const port = backend[capability];
+	if (!port) throw new Error(`@ecsplico/editor: useEditorDocument needs backend capability "${capability}", which "${backend.name}" lacks`);
+	return port;
+}
+/** Opens the live session of document `id`; `close()` ends it (provider and Y.Doc). */
+function openSession(collaboration, id, option, user) {
+	const { ydoc, provider, dispose } = collaboration.connect(id, typeof option === "object" ? option.token : void 0);
+	return {
+		session: {
+			ydoc,
+			provider,
+			...user && { user }
+		},
+		close: dispose
+	};
+}
+//#endregion
+export { EMPTY_DOCUMENT, errorOf, fingerprint, fingerprintToSave, isDirty, loadedDocument, openSession, requireCapability };
+
+//# sourceMappingURL=document-state.js.map

package/dist/adapters/document-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-state.js","names":[],"sources":["../../src/adapters/document-state.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport type { CollaborationSession } from '../core'\nimport type { CollaborationToken, EditorBackend } from '../core/backend'\nimport type { AuthorIdentity } from '../core/feature'\n\n// What the Vue and React `useEditorDocument` hooks share: their options, the empty document, the \"unsaved edits\"\n// comparison and the collaboration session built from the backend. Framework-free; nothing here talks HTTP, the hooks\n// reach documents, collaboration and comments only through `EditorBackend`.\n\nexport interface EditorDocumentOptions {\n  /** Where documents, the collaboration session and the comments live. Default: the backend of the editor context (`createEditor` / `EditorContextProvider`). Collaboration and comments need one that has them, e.g. `createHttpBackend()` (`@ecsplico/editor/adapters/http`). */\n  backend?: EditorBackend\n  /**\n   * Live collaboration: `true`, or `{ token }` for the token the collaboration server's `Identity.authenticate` receives.\n   * With it the Y.Doc is the document: the server loads and stores the content, so the hook neither loads nor saves it\n   * (`modelValue` stays `undefined`, `dirty` stays `false`, `save()` resolves at once). Needs `backend.collaboration`.\n   */\n  collaboration?: boolean | { token?: CollaborationToken }\n  /** Who writes: labels remote carets and is the author of new comments; `null` or omitted = nobody (no comments). */\n  user?: AuthorIdentity | null | (() => AuthorIdentity | null)\n  /** Whether the user may comment now (a reader of a read-only document may be refused); default `true`. */\n  canComment?: boolean | (() => boolean)\n}\n\nexport const EMPTY_DOCUMENT: JSONContent = { type: 'doc', content: [{ type: 'paragraph' }] }\n\n/**\n * The document as compared for \"unsaved changes\": without block ids. The editor gives every block of loaded content an\n * id the moment it mounts (stored files have none yet); that is not an edit the user made, so it must not mark a\n * freshly opened document dirty. Saving still writes the ids.\n */\nconst withoutBlockIds = (node: JSONContent): JSONContent => {\n  const { attrs, content, ...rest } = node\n  const kept = attrs && Object.fromEntries(Object.entries(attrs).filter(([name]) => name !== 'id'))\n  return {\n    ...rest,\n    ...(kept && Object.keys(kept).length > 0 && { attrs: kept }),\n    ...(content && { content: content.map(withoutBlockIds) }),\n  }\n}\nexport const fingerprint = (content: JSONContent): string => JSON.stringify(withoutBlockIds(content))\n\n/** What a load leaves in the hook's state; `missing` = the document does not exist in the backend yet (the first save creates it even if nothing was typed). */\nexport interface LoadedDocument {\n  modelValue: JSONContent\n  /** `fingerprint` of the JSON the backend holds (the empty document while it does not exist). */\n  saved: string\n  missing: boolean\n}\n\n/** The state after `documents.load` answered: `null` (no such document) starts empty. */\nexport function loadedDocument(content: JSONContent | null): LoadedDocument {\n  if (content === null) return { modelValue: structuredClone(EMPTY_DOCUMENT), saved: fingerprint(EMPTY_DOCUMENT), missing: true }\n  return { modelValue: content, saved: fingerprint(content), missing: false }\n}\n\n/** Edits since the content was loaded or last saved; never in collaboration mode (the Y.Doc is the document) or before the first load. */\nexport function isDirty(collaborating: boolean, modelValue: JSONContent | undefined, saved: string | null): boolean {\n  return !collaborating && modelValue !== undefined && saved !== null && fingerprint(modelValue) !== saved\n}\n\n/** The `fingerprint` a save of `content` would store, or `null` when there is nothing to save: no content yet, not ready, or unchanged and already stored. */\nexport function fingerprintToSave(content: JSONContent | undefined, ready: boolean, saved: string | null, missing: boolean): string | null {\n  if (content === undefined || !ready) return null\n  const next = fingerprint(content)\n  return next === saved && !missing ? null : next\n}\n\nexport const errorOf = (cause: unknown) => cause instanceof Error ? cause : new Error(String(cause))\n\n/** The `capability` of `backend`; throws the developer error when it lacks it (called at setup, not on the first request). */\nexport function requireCapability<K extends 'documents' | 'collaboration'>(backend: EditorBackend, capability: K): NonNullable<EditorBackend[K]> {\n  const port = backend[capability]\n  if (!port) throw new Error(`@ecsplico/editor: useEditorDocument needs backend capability \"${capability}\", which \"${backend.name}\" lacks`)\n  return port as NonNullable<EditorBackend[K]>\n}\n\n/** Opens the live session of document `id`; `close()` ends it (provider and Y.Doc). */\nexport function openSession(collaboration: NonNullable<EditorBackend['collaboration']>, id: string, option: EditorDocumentOptions['collaboration'], user: AuthorIdentity | null): { session: CollaborationSession, close: () => void } {\n  const { ydoc, provider, dispose } = collaboration.connect(id, typeof option === 'object' ? option.token : undefined)\n  return { session: { ydoc, provider, ...(user && { user }) }, close: dispose }\n}\n"],"mappings":";AAwBA,MAAa,iBAA8B;CAAE,MAAM;CAAO,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC;AAAE;;;;;;AAO3F,MAAM,mBAAmB,SAAmC;CAC1D,MAAM,EAAE,OAAO,SAAS,GAAG,SAAS;CACpC,MAAM,OAAO,SAAS,OAAO,YAAY,OAAO,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,SAAS,IAAI,CAAC;CAChG,OAAO;EACL,GAAG;EACH,GAAI,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,KAAK,EAAE,OAAO,KAAK;EAC1D,GAAI,WAAW,EAAE,SAAS,QAAQ,IAAI,eAAe,EAAE;CACzD;AACF;AACA,MAAa,eAAe,YAAiC,KAAK,UAAU,gBAAgB,OAAO,CAAC;;AAWpG,SAAgB,eAAe,SAA6C;CAC1E,IAAI,YAAY,MAAM,OAAO;EAAE,YAAY,gBAAgB,cAAc;EAAG,OAAO,YAAY,cAAc;EAAG,SAAS;CAAK;CAC9H,OAAO;EAAE,YAAY;EAAS,OAAO,YAAY,OAAO;EAAG,SAAS;CAAM;AAC5E;;AAGA,SAAgB,QAAQ,eAAwB,YAAqC,OAA+B;CAClH,OAAO,CAAC,iBAAiB,eAAe,KAAA,KAAa,UAAU,QAAQ,YAAY,UAAU,MAAM;AACrG;;AAGA,SAAgB,kBAAkB,SAAkC,OAAgB,OAAsB,SAAiC;CACzI,IAAI,YAAY,KAAA,KAAa,CAAC,OAAO,OAAO;CAC5C,MAAM,OAAO,YAAY,OAAO;CAChC,OAAO,SAAS,SAAS,CAAC,UAAU,OAAO;AAC7C;AAEA,MAAa,WAAW,UAAmB,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;;AAGnG,SAAgB,kBAA2D,SAAwB,YAA8C;CAC/I,MAAM,OAAO,QAAQ;CACrB,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,iEAAiE,WAAW,YAAY,QAAQ,KAAK,QAAQ;CACxI,OAAO;AACT;;AAGA,SAAgB,YAAY,eAA4D,IAAY,QAAgD,MAAmF;CACrO,MAAM,EAAE,MAAM,UAAU,YAAY,cAAc,QAAQ,IAAI,OAAO,WAAW,WAAW,OAAO,QAAQ,KAAA,CAAS;CACnH,OAAO;EAAE,SAAS;GAAE;GAAM;GAAU,GAAI,QAAQ,EAAE,KAAK;EAAG;EAAG,OAAO;CAAQ;AAC9E"}

package/dist/adapters/documents.js

@@ -1,6 +1,6 @@
 import { settingsKey } from "./shared.js";
 import { HttpError } from "../server/errors.js";
-import { authenticated, empty, json } from "../server/handlers/context.js";
+import { authenticated, empty, json, port } from "../server/handlers/context.js";
 import { handleCommentsRequest } from "./comments/server.js";
 //#region src/adapters/documents.ts
 const isDocument = (value) => typeof value === "object" && value !== null && "type" in value && value.type === "doc";
@@ -9,10 +9,11 @@ function documentId(request) {
 	if (!id) throw new HttpError(400, "Dokument-ID fehlt");
 	return id;
 }
-/** The user and what they may do with document `id`: 403 when the adapter's `authorize` refuses. */
+/** The user and what they may do with document `id`: 403 when the identity port's `authorize` refuses. */
 async function accessOf(ctx, request, id) {
 	const user = await authenticated(ctx, request);
-	const access = ctx.adapter.authorize ? await ctx.adapter.authorize(user, id) : { readOnly: false };
+	const { identity } = ctx.ports;
+	const access = identity.authorize ? await identity.authorize(user, id) : { readOnly: false };
 	if (!access) throw new HttpError(403, "Kein Zugriff auf dieses Dokument");
 	return {
 		user,
@@ -21,18 +22,18 @@ async function accessOf(ctx, request, id) {
 }
 /**
 * The document's TipTap JSON: the live content when the collaboration server has the document open (unsaved edits
-* included), else what the adapter stores; `404` when there is none.
+* included), else what the documents port stores; `404` when there is none.
 */
 async function documentGet(ctx, request) {
 	const id = documentId(request);
 	await accessOf(ctx, request, id);
-	const content = ctx.collab?.liveContent(id) ?? await ctx.adapter.loadContent(id);
+	const content = ctx.collab?.liveContent(id) ?? await ctx.ports.documents.loadContent(id);
 	if (!content) throw new HttpError(404, "Dokument nicht gefunden");
 	return json(content);
 }
 /**
 * Stores the request's TipTap JSON (`400` for anything but a `{ type: 'doc' }` object, `403` for a read-only user).
-* Creates the document on adapters that manage documents (`putDocument`); on the others only existing documents can be saved.
+* Creates the document when the documents port manages documents (`putDocument`); otherwise only existing documents can be saved.
 */
 async function documentPut(ctx, request) {
 	const id = documentId(request);
@@ -45,8 +46,9 @@ async function documentPut(ctx, request) {
 		throw new HttpError(400, "Ungültiger JSON-Body");
 	}
 	if (!isDocument(body)) throw new HttpError(400, "Der Body muss ein TipTap-Dokument sein ({ \"type\": \"doc\", … })");
-	if (ctx.adapter.putDocument) await ctx.adapter.putDocument(id, body);
-	else if (await ctx.adapter.loadContent(id)) await ctx.adapter.storeContent(id, body);
+	const { documents } = ctx.ports;
+	if (documents.putDocument) await documents.putDocument(id, body);
+	else if (await documents.loadContent(id)) await documents.storeContent(id, body);
 	else throw new HttpError(404, "Dokument nicht gefunden");
 	return empty();
 }
@@ -54,7 +56,7 @@ async function documentPut(ctx, request) {
 async function commentsGet(ctx, request) {
 	const id = documentId(request);
 	await accessOf(ctx, request, id);
-	const { status, body } = await handleCommentsRequest(ctx.store, {
+	const { status, body } = await handleCommentsRequest(port(ctx, "comments"), {
 		method: "GET",
 		documentId: id
 	});
@@ -94,8 +96,9 @@ async function commentsPost(ctx, request) {
 		throw new HttpError(400, "Ungültiger JSON-Body");
 	}
 	const self = settingsKey(user);
-	if ((await authorsOf(ctx.store, id, recordOf(body))).some((author) => author !== self)) throw new HttpError(403, "Kommentare dürfen nur unter der eigenen Kennung geschrieben und geändert werden");
-	const { status, body: answer } = await handleCommentsRequest(ctx.store, {
+	const store = port(ctx, "comments");
+	if ((await authorsOf(store, id, recordOf(body))).some((author) => author !== self)) throw new HttpError(403, "Kommentare dürfen nur unter der eigenen Kennung geschrieben und geändert werden");
+	const { status, body: answer } = await handleCommentsRequest(store, {
 		method: "POST",
 		documentId: id,
 		body

package/dist/adapters/documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"documents.js","names":[],"sources":["../../src/adapters/documents.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport { HttpError } from '../server'\nimport { authenticated, empty, type HandlerContext, type HandlerRequest, type HandlerResponse, json } from '../server/handlers'\nimport { settingsKey, type DocumentAdmin } from './shared'\nimport { handleCommentsRequest } from './comments/server'\nimport type { CommentStore, Discussion } from './comments/types'\n\n// Framework-free handlers of the two routes this package adds to the editor's own (`/api/editor/*`): a document's\n// content (what `useEditorDocument` loads and saves) and its comments endpoint. They follow the editor's handler shape\n// (`(ctx, request) => HandlerResponse`, `HttpError` for refusals), so any HTTP server can mount them; `./server/nitro`\n// does so for Nitro. Authentication is the adapter's `authenticate`, per-document access its optional `authorize`.\n\n/** What the document handlers need: the editor's handler context, whose adapter may also manage documents (`json`, `drizzle`). */\nexport interface DocumentsContext extends HandlerContext {\n  adapter: HandlerContext['adapter'] & Partial<DocumentAdmin>\n}\n\nconst isDocument = (value: unknown): value is JSONContent => typeof value === 'object' && value !== null && 'type' in value && value.type === 'doc'\n\nfunction documentId(request: HandlerRequest): string {\n  const id = request.params?.id\n  if (!id) throw new HttpError(400, 'Dokument-ID fehlt')\n  return id\n}\n\n/** The user and what they may do with document `id`: 403 when the adapter's `authorize` refuses. */\nasync function accessOf(ctx: DocumentsContext, request: HandlerRequest, id: string): Promise<{ user: object, readOnly: boolean }> {\n  const user = await authenticated(ctx, request)\n  const access = ctx.adapter.authorize ? await ctx.adapter.authorize(user, id) : { readOnly: false }\n  if (!access) throw new HttpError(403, 'Kein Zugriff auf dieses Dokument')\n  return { user, readOnly: access.readOnly }\n}\n\n/**\n * The document's TipTap JSON: the live content when the collaboration server has the document open (unsaved edits\n * included), else what the adapter stores; `404` when there is none.\n */\nexport async function documentGet(ctx: DocumentsContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const id = documentId(request)\n  await accessOf(ctx, request, id)\n  const content = ctx.collab?.liveContent(id) ?? await ctx.adapter.loadContent(id)\n  if (!content) throw new HttpError(404, 'Dokument nicht gefunden')\n  return json(content)\n}\n\n/**\n * Stores the request's TipTap JSON (`400` for anything but a `{ type: 'doc' }` object, `403` for a read-only user).\n * Creates the document on adapters that manage documents (`putDocument`); on the others only existing documents can be saved.\n */\nexport async function documentPut(ctx: DocumentsContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const id = documentId(request)\n  const { readOnly } = await accessOf(ctx, request, id)\n  if (readOnly) throw new HttpError(403, 'Dokument ist schreibgeschützt')\n  let body: unknown\n  try {\n    body = await request.readJson?.()\n  }\n  catch {\n    throw new HttpError(400, 'Ungültiger JSON-Body')\n  }\n  if (!isDocument(body)) throw new HttpError(400, 'Der Body muss ein TipTap-Dokument sein ({ \"type\": \"doc\", … })')\n  if (ctx.adapter.putDocument) await ctx.adapter.putDocument(id, body)\n  else if (await ctx.adapter.loadContent(id)) await ctx.adapter.storeContent(id, body)\n  else throw new HttpError(404, 'Dokument nicht gefunden')\n  return empty()\n}\n\nexport interface CommentsRouteContext extends DocumentsContext {\n  store: CommentStore\n}\n\n/** `GET`: the document's `Discussion`. */\nexport async function commentsGet(ctx: CommentsRouteContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const id = documentId(request)\n  await accessOf(ctx, request, id)\n  const { status, body } = await handleCommentsRequest(ctx.store, { method: 'GET', documentId: id })\n  return json(body, status)\n}\n\nconst recordOf = (value: unknown): Record<string, unknown> => typeof value === 'object' && value !== null ? value as Record<string, unknown> : {}\n\n/** The comment authors a `CommentAction` writes (new comments) or touches (edits and deletions of existing ones). */\nasync function authorsOf(store: CommentStore, id: string, body: Record<string, unknown>): Promise<string[]> {\n  // A malformed comment has no author to compare; the handler answers it with 400.\n  const authorOf = (comment: unknown) => {\n    const { authorId } = recordOf(comment)\n    return typeof authorId === 'string' ? [authorId] : []\n  }\n  switch (body.action) {\n    case 'create':\n      return authorOf(recordOf(body.thread).initialComment)\n    case 'reply':\n      return authorOf(body.comment)\n    case 'edit':\n    case 'remove-comment': {\n      const discussion: Discussion = await store.getDiscussion(id)\n      const thread = discussion.threads.find(candidate => candidate.id === body.threadId)\n      const comment = thread?.comments.find(candidate => candidate.id === body.commentId)\n      // An unknown id is the handler's 404, not an authorisation question.\n      return comment ? [comment.authorId] : []\n    }\n    default:\n      return []\n  }\n}\n\n/**\n * `POST` with a `CommentAction` (see `handleCommentsRequest`). The handler trusts its caller, so this route does the\n * authorising: read-only users write nothing, and a user only writes comments under their own id and only edits or\n * deletes their own comments (`403` otherwise).\n */\nexport async function commentsPost(ctx: CommentsRouteContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const id = documentId(request)\n  const { user, readOnly } = await accessOf(ctx, request, id)\n  if (readOnly) throw new HttpError(403, 'Dokument ist schreibgeschützt')\n  let body: unknown\n  try {\n    body = await request.readJson?.()\n  }\n  catch {\n    throw new HttpError(400, 'Ungültiger JSON-Body')\n  }\n  const self = settingsKey(user)\n  if ((await authorsOf(ctx.store, id, recordOf(body))).some(author => author !== self)) throw new HttpError(403, 'Kommentare dürfen nur unter der eigenen Kennung geschrieben und geändert werden')\n  const { status, body: answer } = await handleCommentsRequest(ctx.store, { method: 'POST', documentId: id, body })\n  return json(answer, status)\n}\n"],"mappings":"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"}
+{"version":3,"file":"documents.js","names":[],"sources":["../../src/adapters/documents.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport { HttpError } from '../server'\nimport { authenticated, empty, type HandlerContext, type HandlerRequest, type HandlerResponse, json, port } from '../server/handlers'\nimport { settingsKey } from './shared'\nimport { handleCommentsRequest } from './comments/server'\nimport type { CommentStore, Discussion } from './comments/types'\n\n// Framework-free handlers of the two routes this package adds to the editor's own (`/api/editor/*`): a document's\n// content (what `useEditorDocument` loads and saves) and its comments endpoint. They follow the editor's handler shape\n// (`(ctx, request) => HandlerResponse`, `HttpError` for refusals), so any HTTP server can mount them; `./server/nitro`\n// does so for Nitro. Authentication is `ports.identity.authenticate`, per-document access its optional `authorize`.\n\nconst isDocument = (value: unknown): value is JSONContent => typeof value === 'object' && value !== null && 'type' in value && value.type === 'doc'\n\nfunction documentId(request: HandlerRequest): string {\n  const id = request.params?.id\n  if (!id) throw new HttpError(400, 'Dokument-ID fehlt')\n  return id\n}\n\n/** The user and what they may do with document `id`: 403 when the identity port's `authorize` refuses. */\nasync function accessOf(ctx: HandlerContext, request: HandlerRequest, id: string): Promise<{ user: object, readOnly: boolean }> {\n  const user = await authenticated(ctx, request)\n  const { identity } = ctx.ports\n  const access = identity.authorize ? await identity.authorize(user, id) : { readOnly: false }\n  if (!access) throw new HttpError(403, 'Kein Zugriff auf dieses Dokument')\n  return { user, readOnly: access.readOnly }\n}\n\n/**\n * The document's TipTap JSON: the live content when the collaboration server has the document open (unsaved edits\n * included), else what the documents port stores; `404` when there is none.\n */\nexport async function documentGet(ctx: HandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const id = documentId(request)\n  await accessOf(ctx, request, id)\n  const content = ctx.collab?.liveContent(id) ?? await ctx.ports.documents.loadContent(id)\n  if (!content) throw new HttpError(404, 'Dokument nicht gefunden')\n  return json(content)\n}\n\n/**\n * Stores the request's TipTap JSON (`400` for anything but a `{ type: 'doc' }` object, `403` for a read-only user).\n * Creates the document when the documents port manages documents (`putDocument`); otherwise only existing documents can be saved.\n */\nexport async function documentPut(ctx: HandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const id = documentId(request)\n  const { readOnly } = await accessOf(ctx, request, id)\n  if (readOnly) throw new HttpError(403, 'Dokument ist schreibgeschützt')\n  let body: unknown\n  try {\n    body = await request.readJson?.()\n  }\n  catch {\n    throw new HttpError(400, 'Ungültiger JSON-Body')\n  }\n  if (!isDocument(body)) throw new HttpError(400, 'Der Body muss ein TipTap-Dokument sein ({ \"type\": \"doc\", … })')\n  const { documents } = ctx.ports\n  if (documents.putDocument) await documents.putDocument(id, body)\n  else if (await documents.loadContent(id)) await documents.storeContent(id, body)\n  else throw new HttpError(404, 'Dokument nicht gefunden')\n  return empty()\n}\n\n/** `GET`: the document's `Discussion`. */\nexport async function commentsGet(ctx: HandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const id = documentId(request)\n  await accessOf(ctx, request, id)\n  const { status, body } = await handleCommentsRequest(port(ctx, 'comments'), { method: 'GET', documentId: id })\n  return json(body, status)\n}\n\nconst recordOf = (value: unknown): Record<string, unknown> => typeof value === 'object' && value !== null ? value as Record<string, unknown> : {}\n\n/** The comment authors a `CommentAction` writes (new comments) or touches (edits and deletions of existing ones). */\nasync function authorsOf(store: CommentStore, id: string, body: Record<string, unknown>): Promise<string[]> {\n  // A malformed comment has no author to compare; the handler answers it with 400.\n  const authorOf = (comment: unknown) => {\n    const { authorId } = recordOf(comment)\n    return typeof authorId === 'string' ? [authorId] : []\n  }\n  switch (body.action) {\n    case 'create':\n      return authorOf(recordOf(body.thread).initialComment)\n    case 'reply':\n      return authorOf(body.comment)\n    case 'edit':\n    case 'remove-comment': {\n      const discussion: Discussion = await store.getDiscussion(id)\n      const thread = discussion.threads.find(candidate => candidate.id === body.threadId)\n      const comment = thread?.comments.find(candidate => candidate.id === body.commentId)\n      // An unknown id is the handler's 404, not an authorisation question.\n      return comment ? [comment.authorId] : []\n    }\n    default:\n      return []\n  }\n}\n\n/**\n * `POST` with a `CommentAction` (see `handleCommentsRequest`). The handler trusts its caller, so this route does the\n * authorising: read-only users write nothing, and a user only writes comments under their own id and only edits or\n * deletes their own comments (`403` otherwise).\n */\nexport async function commentsPost(ctx: HandlerContext, request: HandlerRequest): Promise<HandlerResponse> {\n  const id = documentId(request)\n  const { user, readOnly } = await accessOf(ctx, request, id)\n  if (readOnly) throw new HttpError(403, 'Dokument ist schreibgeschützt')\n  let body: unknown\n  try {\n    body = await request.readJson?.()\n  }\n  catch {\n    throw new HttpError(400, 'Ungültiger JSON-Body')\n  }\n  const self = settingsKey(user)\n  const store = port(ctx, 'comments')\n  if ((await authorsOf(store, id, recordOf(body))).some(author => author !== self)) throw new HttpError(403, 'Kommentare dürfen nur unter der eigenen Kennung geschrieben und geändert werden')\n  const { status, body: answer } = await handleCommentsRequest(store, { method: 'POST', documentId: id, body })\n  return json(answer, status)\n}\n"],"mappings":";;;;;AAYA,MAAM,cAAc,UAAyC,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU,SAAS,MAAM,SAAS;AAE9I,SAAS,WAAW,SAAiC;CACnD,MAAM,KAAK,QAAQ,QAAQ;CAC3B,IAAI,CAAC,IAAI,MAAM,IAAI,UAAU,KAAK,mBAAmB;CACrD,OAAO;AACT;;AAGA,eAAe,SAAS,KAAqB,SAAyB,IAA0D;CAC9H,MAAM,OAAO,MAAM,cAAc,KAAK,OAAO;CAC7C,MAAM,EAAE,aAAa,IAAI;CACzB,MAAM,SAAS,SAAS,YAAY,MAAM,SAAS,UAAU,MAAM,EAAE,IAAI,EAAE,UAAU,MAAM;CAC3F,IAAI,CAAC,QAAQ,MAAM,IAAI,UAAU,KAAK,kCAAkC;CACxE,OAAO;EAAE;EAAM,UAAU,OAAO;CAAS;AAC3C;;;;;AAMA,eAAsB,YAAY,KAAqB,SAAmD;CACxG,MAAM,KAAK,WAAW,OAAO;CAC7B,MAAM,SAAS,KAAK,SAAS,EAAE;CAC/B,MAAM,UAAU,IAAI,QAAQ,YAAY,EAAE,KAAK,MAAM,IAAI,MAAM,UAAU,YAAY,EAAE;CACvF,IAAI,CAAC,SAAS,MAAM,IAAI,UAAU,KAAK,yBAAyB;CAChE,OAAO,KAAK,OAAO;AACrB;;;;;AAMA,eAAsB,YAAY,KAAqB,SAAmD;CACxG,MAAM,KAAK,WAAW,OAAO;CAC7B,MAAM,EAAE,aAAa,MAAM,SAAS,KAAK,SAAS,EAAE;CACpD,IAAI,UAAU,MAAM,IAAI,UAAU,KAAK,+BAA+B;CACtE,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,QAAQ,WAAW;CAClC,QACM;EACJ,MAAM,IAAI,UAAU,KAAK,sBAAsB;CACjD;CACA,IAAI,CAAC,WAAW,IAAI,GAAG,MAAM,IAAI,UAAU,KAAK,mEAA+D;CAC/G,MAAM,EAAE,cAAc,IAAI;CAC1B,IAAI,UAAU,aAAa,MAAM,UAAU,YAAY,IAAI,IAAI;MAC1D,IAAI,MAAM,UAAU,YAAY,EAAE,GAAG,MAAM,UAAU,aAAa,IAAI,IAAI;MAC1E,MAAM,IAAI,UAAU,KAAK,yBAAyB;CACvD,OAAO,MAAM;AACf;;AAGA,eAAsB,YAAY,KAAqB,SAAmD;CACxG,MAAM,KAAK,WAAW,OAAO;CAC7B,MAAM,SAAS,KAAK,SAAS,EAAE;CAC/B,MAAM,EAAE,QAAQ,SAAS,MAAM,sBAAsB,KAAK,KAAK,UAAU,GAAG;EAAE,QAAQ;EAAO,YAAY;CAAG,CAAC;CAC7G,OAAO,KAAK,MAAM,MAAM;AAC1B;AAEA,MAAM,YAAY,UAA4C,OAAO,UAAU,YAAY,UAAU,OAAO,QAAmC,CAAC;;AAGhJ,eAAe,UAAU,OAAqB,IAAY,MAAkD;CAE1G,MAAM,YAAY,YAAqB;EACrC,MAAM,EAAE,aAAa,SAAS,OAAO;EACrC,OAAO,OAAO,aAAa,WAAW,CAAC,QAAQ,IAAI,CAAC;CACtD;CACA,QAAQ,KAAK,QAAb;EACE,KAAK,UACH,OAAO,SAAS,SAAS,KAAK,MAAM,CAAC,CAAC,cAAc;EACtD,KAAK,SACH,OAAO,SAAS,KAAK,OAAO;EAC9B,KAAK;EACL,KAAK,kBAAkB;GAGrB,MAAM,WADS,MADsB,MAAM,cAAc,EAAE,EAAA,CACjC,QAAQ,MAAK,cAAa,UAAU,OAAO,KAAK,QACrD,CAAC,EAAE,SAAS,MAAK,cAAa,UAAU,OAAO,KAAK,SAAS;GAElF,OAAO,UAAU,CAAC,QAAQ,QAAQ,IAAI,CAAC;EACzC;EACA,SACE,OAAO,CAAC;CACZ;AACF;;;;;;AAOA,eAAsB,aAAa,KAAqB,SAAmD;CACzG,MAAM,KAAK,WAAW,OAAO;CAC7B,MAAM,EAAE,MAAM,aAAa,MAAM,SAAS,KAAK,SAAS,EAAE;CAC1D,IAAI,UAAU,MAAM,IAAI,UAAU,KAAK,+BAA+B;CACtE,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,QAAQ,WAAW;CAClC,QACM;EACJ,MAAM,IAAI,UAAU,KAAK,sBAAsB;CACjD;CACA,MAAM,OAAO,YAAY,IAAI;CAC7B,MAAM,QAAQ,KAAK,KAAK,UAAU;CAClC,KAAK,MAAM,UAAU,OAAO,IAAI,SAAS,IAAI,CAAC,EAAA,CAAG,MAAK,WAAU,WAAW,IAAI,GAAG,MAAM,IAAI,UAAU,KAAK,iFAAiF;CAC5L,MAAM,EAAE,QAAQ,MAAM,WAAW,MAAM,sBAAsB,OAAO;EAAE,QAAQ;EAAQ,YAAY;EAAI;CAAK,CAAC;CAC5G,OAAO,KAAK,QAAQ,MAAM;AAC5B"}

package/dist/adapters/drizzle.d.ts

@@ -1,6 +1,6 @@
 import { AssetRecord } from "../features/media/assets.js";
 import "../features/media/schema.js";
-import { AdapterHooks, StoredEditorAdapter } from "./shared.js";
+import { AdapterHooks, StoredPorts } from "./shared.js";
 import { BaseSQLiteDatabase } from "drizzle-orm/sqlite-core";
 import { JSONContent } from "@tiptap/core";
 //#region src/adapters/drizzle.d.ts
@@ -287,7 +287,7 @@ export interface DrizzleAdapterOptions extends AdapterHooks {
  * `putDocument`. Single-statement operations only (no transaction), so the adapter runs on sync and async drivers;
  * `deleteDocument` removes content first, so a concurrent `storeContent` finds nothing to update. No theme library.
  */
-export declare function createDrizzleAdapter({ db, tables, ...hooks }: DrizzleAdapterOptions): StoredEditorAdapter;
+export declare function createDrizzleAdapter({ db, tables, ...hooks }: DrizzleAdapterOptions): StoredPorts;
 //#endregion
 export {};
 //# sourceMappingURL=drizzle.d.ts.map

package/dist/adapters/drizzle.js

@@ -1,4 +1,4 @@
-import { bytesOf, identityPart, settingsKey } from "./shared.js";
+import { bytesOf, directoryOf, identityOf, settingsKey } from "./shared.js";
 import { randomUUID } from "node:crypto";
 import { and, eq, sql } from "drizzle-orm";
 import { blob, primaryKey, sqliteTable, text } from "drizzle-orm/sqlite-core";
@@ -56,98 +56,107 @@ function createDrizzleAdapter({ db, tables, ...hooks }) {
 	const { documents, states, settings, assets } = tables;
 	const documentContent = async (id) => (await db.select({ content: documents.content }).from(documents).where(eq(documents.id, id)).get())?.content ?? null;
 	return {
-		...identityPart(hooks),
-		loadContent: documentContent,
-		async storeContent(id, content) {
-			await db.update(documents).set({
-				content,
-				version: randomUUID(),
-				updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-			}).where(eq(documents.id, id)).run();
+		identity: identityOf(hooks),
+		directory: directoryOf(hooks),
+		documents: {
+			loadContent: documentContent,
+			async storeContent(id, content) {
+				await db.update(documents).set({
+					content,
+					version: randomUUID(),
+					updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+				}).where(eq(documents.id, id)).run();
+			},
+			async contentVersion(id) {
+				return (await db.select({ version: documents.version }).from(documents).where(eq(documents.id, id)).get())?.version ?? null;
+			},
+			async listContents() {
+				return db.select({
+					id: documents.id,
+					content: documents.content
+				}).from(documents).orderBy(documents.id).all();
+			},
+			async putDocument(id, content) {
+				const row = {
+					content,
+					version: randomUUID(),
+					updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+				};
+				await db.insert(documents).values({
+					id,
+					...row
+				}).onConflictDoUpdate({
+					target: documents.id,
+					set: row
+				}).run();
+			},
+			async deleteDocument(id) {
+				await db.delete(documents).where(eq(documents.id, id)).run();
+				await db.delete(states).where(eq(states.id, id)).run();
+				await db.delete(assets).where(eq(assets.id, id)).run();
+			},
+			async listDocumentIds() {
+				return (await db.select({ id: documents.id }).from(documents).orderBy(documents.id).all()).map((row) => row.id);
+			}
 		},
-		async contentVersion(id) {
-			return (await db.select({ version: documents.version }).from(documents).where(eq(documents.id, id)).get())?.version ?? null;
+		collabState: {
+			async loadState(id) {
+				const row = await db.select({ state: states.state }).from(states).where(eq(states.id, id)).get();
+				return row ? bytesOf(row.state) : null;
+			},
+			async storeState(id, state) {
+				const data = Buffer.from(state);
+				await db.insert(states).values({
+					id,
+					state: data
+				}).onConflictDoUpdate({
+					target: states.id,
+					set: { state: data }
+				}).run();
+			},
+			async removeState(id) {
+				await db.delete(states).where(eq(states.id, id)).run();
+			}
 		},
-		async listContents() {
-			return db.select({
-				id: documents.id,
-				content: documents.content
-			}).from(documents).orderBy(documents.id).all();
-		},
-		async loadState(id) {
-			const row = await db.select({ state: states.state }).from(states).where(eq(states.id, id)).get();
-			return row ? bytesOf(row.state) : null;
-		},
-		async storeState(id, state) {
-			const data = Buffer.from(state);
-			await db.insert(states).values({
-				id,
-				state: data
-			}).onConflictDoUpdate({
-				target: states.id,
-				set: { state: data }
-			}).run();
-		},
-		async removeState(id) {
-			await db.delete(states).where(eq(states.id, id)).run();
-		},
-		async storeAsset(id, { data, ...record }) {
-			await db.insert(assets).values({
-				id,
-				name: record.name,
-				record,
-				data
-			}).onConflictDoUpdate({
-				target: [assets.id, assets.name],
-				set: {
+		assets: {
+			async storeAsset(id, { data, ...record }) {
+				await db.insert(assets).values({
+					id,
+					name: record.name,
 					record,
 					data
-				}
-			}).run();
-		},
-		async loadAsset(id, name) {
-			const row = await db.select({
-				record: assets.record,
-				data: assets.data
-			}).from(assets).where(and(eq(assets.id, id), eq(assets.name, name))).get();
-			return row ? {
-				record: row.record,
-				data: Buffer.from(row.data)
-			} : null;
-		},
-		async loadSettings(user) {
-			return (await db.select({ json: settings.json }).from(settings).where(eq(settings.userId, settingsKey(user))).get())?.json ?? null;
-		},
-		async storeSettings(user, value) {
-			await db.insert(settings).values({
-				userId: settingsKey(user),
-				json: value
-			}).onConflictDoUpdate({
-				target: settings.userId,
-				set: { json: value }
-			}).run();
-		},
-		async putDocument(id, content) {
-			const row = {
-				content,
-				version: randomUUID(),
-				updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-			};
-			await db.insert(documents).values({
-				id,
-				...row
-			}).onConflictDoUpdate({
-				target: documents.id,
-				set: row
-			}).run();
-		},
-		async deleteDocument(id) {
-			await db.delete(documents).where(eq(documents.id, id)).run();
-			await db.delete(states).where(eq(states.id, id)).run();
-			await db.delete(assets).where(eq(assets.id, id)).run();
+				}).onConflictDoUpdate({
+					target: [assets.id, assets.name],
+					set: {
+						record,
+						data
+					}
+				}).run();
+			},
+			async loadAsset(id, name) {
+				const row = await db.select({
+					record: assets.record,
+					data: assets.data
+				}).from(assets).where(and(eq(assets.id, id), eq(assets.name, name))).get();
+				return row ? {
+					record: row.record,
+					data: Buffer.from(row.data)
+				} : null;
+			}
 		},
-		async listDocumentIds() {
-			return (await db.select({ id: documents.id }).from(documents).orderBy(documents.id).all()).map((row) => row.id);
+		settings: {
+			async loadSettings(user) {
+				return (await db.select({ json: settings.json }).from(settings).where(eq(settings.userId, settingsKey(user))).get())?.json ?? null;
+			},
+			async storeSettings(user, value) {
+				await db.insert(settings).values({
+					userId: settingsKey(user),
+					json: value
+				}).onConflictDoUpdate({
+					target: settings.userId,
+					set: { json: value }
+				}).run();
+			}
 		}
 	};
 }

package/dist/adapters/drizzle.js.map

@@ -1 +1 @@
-{"version":3,"file":"drizzle.js","names":[],"sources":["../../src/adapters/drizzle.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto'\nimport type { JSONContent } from '@tiptap/core'\nimport type { AssetRecord } from '../features/media/schema'\nimport { and, eq, sql } from 'drizzle-orm'\nimport { type BaseSQLiteDatabase, blob, primaryKey, sqliteTable, text } from 'drizzle-orm/sqlite-core'\nimport { type AdapterHooks, bytesOf, identityPart, settingsKey, type StoredEditorAdapter } from './shared'\n\nconst EDITOR_TABLES = {\n  documents: sqliteTable('editor_documents', {\n    id: text('id').primaryKey(),\n    content: text('content', { mode: 'json' }).$type<JSONContent>().notNull(),\n    version: text('version').notNull(),\n    updatedAt: text('updated_at').notNull(),\n  }),\n  states: sqliteTable('editor_states', {\n    id: text('id').primaryKey(),\n    state: blob('state', { mode: 'buffer' }).notNull(),\n  }),\n  settings: sqliteTable('editor_settings', {\n    userId: text('user_id').primaryKey(),\n    json: text('json', { mode: 'json' }).$type<unknown>().notNull(),\n  }),\n  assets: sqliteTable('editor_assets', {\n    id: text('id').notNull(),\n    name: text('name').notNull(),\n    record: text('record', { mode: 'json' }).$type<AssetRecord>().notNull(),\n    data: blob('data', { mode: 'buffer' }).notNull(),\n  }, table => [primaryKey({ columns: [table.id, table.name] })]),\n}\n\nexport type EditorTables = typeof EDITOR_TABLES\n\n/**\n * The tables of the editor's storage in a SQLite database (`bun:sqlite`, better-sqlite3, libsql, D1):\n *\n *     editor_documents(id PK, content json, version text, updated_at text)   TipTap JSON + opaque content version\n *     editor_states(id PK, state blob)                                        the collab server's state bytes\n *     editor_settings(user_id PK, json json)                                  per-user editor settings\n *     editor_assets(id, name, record json, data blob; PK (id, name))          uploaded files\n *\n * Call it from the host's drizzle schema (so `drizzle-kit` migrates the tables) or use `bootstrapEditorTables` in a\n * host that creates its tables with `CREATE TABLE IF NOT EXISTS`.\n */\nexport const editorTables = (): EditorTables => EDITOR_TABLES\n\n/** Any drizzle SQLite database, sync (`bun:sqlite`, better-sqlite3) or async (libsql, D1). */\nexport type EditorDb = BaseSQLiteDatabase<'sync' | 'async', unknown, Record<string, unknown>>\n\n/** `CREATE TABLE IF NOT EXISTS` for the tables of `editorTables()`, for hosts without migrations. */\nexport async function bootstrapEditorTables(db: EditorDb): Promise<void> {\n  await db.run(sql`CREATE TABLE IF NOT EXISTS editor_documents (id text PRIMARY KEY NOT NULL, content text NOT NULL, version text NOT NULL, updated_at text NOT NULL)`)\n  await db.run(sql`CREATE TABLE IF NOT EXISTS editor_states (id text PRIMARY KEY NOT NULL, state blob NOT NULL)`)\n  await db.run(sql`CREATE TABLE IF NOT EXISTS editor_settings (user_id text PRIMARY KEY NOT NULL, json text NOT NULL)`)\n  await db.run(sql`CREATE TABLE IF NOT EXISTS editor_assets (id text NOT NULL, name text NOT NULL, record text NOT NULL, data blob NOT NULL, PRIMARY KEY (id, name))`)\n}\n\nexport interface DrizzleAdapterOptions extends AdapterHooks {\n  db: EditorDb\n  tables: EditorTables\n}\n\n/**\n * The editor's adapter on drizzle tables. Every write to a document's content (`storeContent`, `putDocument`) stores a\n * fresh random `version`, which `contentVersion` returns: a document changed by any other writer keeps its row's\n * version only if that writer left it alone, so hosts that edit `editor_documents` themselves must go through\n * `putDocument` (or set `version` to anything new). `storeContent` only updates existing rows: create documents with\n * `putDocument`. Single-statement operations only (no transaction), so the adapter runs on sync and async drivers;\n * `deleteDocument` removes content first, so a concurrent `storeContent` finds nothing to update. No theme library.\n */\nexport function createDrizzleAdapter({ db, tables, ...hooks }: DrizzleAdapterOptions): StoredEditorAdapter {\n  const { documents, states, settings, assets } = tables\n\n  const documentContent = async (id: string) => (await db.select({ content: documents.content }).from(documents).where(eq(documents.id, id)).get())?.content ?? null\n\n  return {\n    ...identityPart(hooks),\n\n    loadContent: documentContent,\n    async storeContent(id, content) {\n      await db.update(documents).set({ content, version: randomUUID(), updatedAt: new Date().toISOString() }).where(eq(documents.id, id)).run()\n    },\n    async contentVersion(id) {\n      return (await db.select({ version: documents.version }).from(documents).where(eq(documents.id, id)).get())?.version ?? null\n    },\n    async listContents() {\n      return db.select({ id: documents.id, content: documents.content }).from(documents).orderBy(documents.id).all()\n    },\n\n    async loadState(id) {\n      const row = await db.select({ state: states.state }).from(states).where(eq(states.id, id)).get()\n      return row ? bytesOf(row.state) : null\n    },\n    async storeState(id, state) {\n      const data = Buffer.from(state)\n      await db.insert(states).values({ id, state: data }).onConflictDoUpdate({ target: states.id, set: { state: data } }).run()\n    },\n    async removeState(id) {\n      await db.delete(states).where(eq(states.id, id)).run()\n    },\n\n    async storeAsset(id, { data, ...record }) {\n      await db.insert(assets).values({ id, name: record.name, record, data })\n        .onConflictDoUpdate({ target: [assets.id, assets.name], set: { record, data } }).run()\n    },\n    async loadAsset(id, name) {\n      const row = await db.select({ record: assets.record, data: assets.data }).from(assets).where(and(eq(assets.id, id), eq(assets.name, name))).get()\n      return row ? { record: row.record, data: Buffer.from(row.data) } : null\n    },\n\n    async loadSettings(user) {\n      return (await db.select({ json: settings.json }).from(settings).where(eq(settings.userId, settingsKey(user))).get())?.json ?? null\n    },\n    async storeSettings(user, value) {\n      await db.insert(settings).values({ userId: settingsKey(user), json: value })\n        .onConflictDoUpdate({ target: settings.userId, set: { json: value } }).run()\n    },\n\n    async putDocument(id, content) {\n      const row = { content, version: randomUUID(), updatedAt: new Date().toISOString() }\n      await db.insert(documents).values({ id, ...row }).onConflictDoUpdate({ target: documents.id, set: row }).run()\n    },\n    async deleteDocument(id) {\n      await db.delete(documents).where(eq(documents.id, id)).run()\n      await db.delete(states).where(eq(states.id, id)).run()\n      await db.delete(assets).where(eq(assets.id, id)).run()\n    },\n    async listDocumentIds() {\n      return (await db.select({ id: documents.id }).from(documents).orderBy(documents.id).all()).map(row => row.id)\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"drizzle.js","names":[],"sources":["../../src/adapters/drizzle.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto'\nimport type { JSONContent } from '@tiptap/core'\nimport type { AssetRecord } from '../features/media/schema'\nimport { and, eq, sql } from 'drizzle-orm'\nimport { type BaseSQLiteDatabase, blob, primaryKey, sqliteTable, text } from 'drizzle-orm/sqlite-core'\nimport { type AdapterHooks, bytesOf, directoryOf, identityOf, settingsKey, type StoredPorts } from './shared'\n\nconst EDITOR_TABLES = {\n  documents: sqliteTable('editor_documents', {\n    id: text('id').primaryKey(),\n    content: text('content', { mode: 'json' }).$type<JSONContent>().notNull(),\n    version: text('version').notNull(),\n    updatedAt: text('updated_at').notNull(),\n  }),\n  states: sqliteTable('editor_states', {\n    id: text('id').primaryKey(),\n    state: blob('state', { mode: 'buffer' }).notNull(),\n  }),\n  settings: sqliteTable('editor_settings', {\n    userId: text('user_id').primaryKey(),\n    json: text('json', { mode: 'json' }).$type<unknown>().notNull(),\n  }),\n  assets: sqliteTable('editor_assets', {\n    id: text('id').notNull(),\n    name: text('name').notNull(),\n    record: text('record', { mode: 'json' }).$type<AssetRecord>().notNull(),\n    data: blob('data', { mode: 'buffer' }).notNull(),\n  }, table => [primaryKey({ columns: [table.id, table.name] })]),\n}\n\nexport type EditorTables = typeof EDITOR_TABLES\n\n/**\n * The tables of the editor's storage in a SQLite database (`bun:sqlite`, better-sqlite3, libsql, D1):\n *\n *     editor_documents(id PK, content json, version text, updated_at text)   TipTap JSON + opaque content version\n *     editor_states(id PK, state blob)                                        the collab server's state bytes\n *     editor_settings(user_id PK, json json)                                  per-user editor settings\n *     editor_assets(id, name, record json, data blob; PK (id, name))          uploaded files\n *\n * Call it from the host's drizzle schema (so `drizzle-kit` migrates the tables) or use `bootstrapEditorTables` in a\n * host that creates its tables with `CREATE TABLE IF NOT EXISTS`.\n */\nexport const editorTables = (): EditorTables => EDITOR_TABLES\n\n/** Any drizzle SQLite database, sync (`bun:sqlite`, better-sqlite3) or async (libsql, D1). */\nexport type EditorDb = BaseSQLiteDatabase<'sync' | 'async', unknown, Record<string, unknown>>\n\n/** `CREATE TABLE IF NOT EXISTS` for the tables of `editorTables()`, for hosts without migrations. */\nexport async function bootstrapEditorTables(db: EditorDb): Promise<void> {\n  await db.run(sql`CREATE TABLE IF NOT EXISTS editor_documents (id text PRIMARY KEY NOT NULL, content text NOT NULL, version text NOT NULL, updated_at text NOT NULL)`)\n  await db.run(sql`CREATE TABLE IF NOT EXISTS editor_states (id text PRIMARY KEY NOT NULL, state blob NOT NULL)`)\n  await db.run(sql`CREATE TABLE IF NOT EXISTS editor_settings (user_id text PRIMARY KEY NOT NULL, json text NOT NULL)`)\n  await db.run(sql`CREATE TABLE IF NOT EXISTS editor_assets (id text NOT NULL, name text NOT NULL, record text NOT NULL, data blob NOT NULL, PRIMARY KEY (id, name))`)\n}\n\nexport interface DrizzleAdapterOptions extends AdapterHooks {\n  db: EditorDb\n  tables: EditorTables\n}\n\n/**\n * The editor's adapter on drizzle tables. Every write to a document's content (`storeContent`, `putDocument`) stores a\n * fresh random `version`, which `contentVersion` returns: a document changed by any other writer keeps its row's\n * version only if that writer left it alone, so hosts that edit `editor_documents` themselves must go through\n * `putDocument` (or set `version` to anything new). `storeContent` only updates existing rows: create documents with\n * `putDocument`. Single-statement operations only (no transaction), so the adapter runs on sync and async drivers;\n * `deleteDocument` removes content first, so a concurrent `storeContent` finds nothing to update. No theme library.\n */\nexport function createDrizzleAdapter({ db, tables, ...hooks }: DrizzleAdapterOptions): StoredPorts {\n  const { documents, states, settings, assets } = tables\n\n  const documentContent = async (id: string) => (await db.select({ content: documents.content }).from(documents).where(eq(documents.id, id)).get())?.content ?? null\n\n  return {\n    identity: identityOf(hooks),\n    directory: directoryOf(hooks),\n\n    documents: {\n      loadContent: documentContent,\n      async storeContent(id, content) {\n        await db.update(documents).set({ content, version: randomUUID(), updatedAt: new Date().toISOString() }).where(eq(documents.id, id)).run()\n      },\n      async contentVersion(id) {\n        return (await db.select({ version: documents.version }).from(documents).where(eq(documents.id, id)).get())?.version ?? null\n      },\n      async listContents() {\n        return db.select({ id: documents.id, content: documents.content }).from(documents).orderBy(documents.id).all()\n      },\n\n      async putDocument(id, content) {\n        const row = { content, version: randomUUID(), updatedAt: new Date().toISOString() }\n        await db.insert(documents).values({ id, ...row }).onConflictDoUpdate({ target: documents.id, set: row }).run()\n      },\n      async deleteDocument(id) {\n        await db.delete(documents).where(eq(documents.id, id)).run()\n        await db.delete(states).where(eq(states.id, id)).run()\n        await db.delete(assets).where(eq(assets.id, id)).run()\n      },\n      async listDocumentIds() {\n        return (await db.select({ id: documents.id }).from(documents).orderBy(documents.id).all()).map(row => row.id)\n      },\n    },\n\n    collabState: {\n      async loadState(id) {\n        const row = await db.select({ state: states.state }).from(states).where(eq(states.id, id)).get()\n        return row ? bytesOf(row.state) : null\n      },\n      async storeState(id, state) {\n        const data = Buffer.from(state)\n        await db.insert(states).values({ id, state: data }).onConflictDoUpdate({ target: states.id, set: { state: data } }).run()\n      },\n      async removeState(id) {\n        await db.delete(states).where(eq(states.id, id)).run()\n      },\n    },\n\n    assets: {\n      async storeAsset(id, { data, ...record }) {\n        await db.insert(assets).values({ id, name: record.name, record, data })\n          .onConflictDoUpdate({ target: [assets.id, assets.name], set: { record, data } }).run()\n      },\n      async loadAsset(id, name) {\n        const row = await db.select({ record: assets.record, data: assets.data }).from(assets).where(and(eq(assets.id, id), eq(assets.name, name))).get()\n        return row ? { record: row.record, data: Buffer.from(row.data) } : null\n      },\n    },\n\n    settings: {\n      async loadSettings(user) {\n        return (await db.select({ json: settings.json }).from(settings).where(eq(settings.userId, settingsKey(user))).get())?.json ?? null\n      },\n      async storeSettings(user, value) {\n        await db.insert(settings).values({ userId: settingsKey(user), json: value })\n          .onConflictDoUpdate({ target: settings.userId, set: { json: value } }).run()\n      },\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/adapters/forge.d.ts

@@ -1,4 +1,4 @@
-import { EditorAdapter } from "../server/adapter.js";
+import { AssetStore, CollabStateStore, EditorPorts, Identity, SettingsStore, ThemeStore } from "../server/ports.js";
 import "../server/index.js";
 import { AdapterHooks } from "./shared.js";
 import { MarkdownDiagnostic, MarkdownPolicy } from "../markdown/policy.js";
@@ -22,19 +22,24 @@ export interface ForgeContent {
   /** Ids of all documents, for `listContents` (the tag index). Omitted: `listContents` is empty. */
   list?(): Promise<string[]>;
 }
-/** What the adapter delegates to a storage adapter that has no use for Markdown: Yjs state, assets, settings, themes (`createJsonAdapter` or `createDrizzleAdapter` fit). */
-export type ForgeState = Pick<EditorAdapter, 'loadState' | 'storeState' | 'removeState' | 'storeAsset' | 'loadAsset'> & Partial<Pick<EditorAdapter, 'loadSettings' | 'storeSettings' | 'listThemes' | 'loadTheme' | 'storeTheme' | 'removeTheme'>>;
+/** What the adapter delegates to a storage adapter that has no use for Markdown: the `collabState`, `assets`, `settings` and `themes` ports (the result of `createJsonAdapter` or `createDrizzleAdapter` fits). */
+export interface ForgeState {
+  collabState: CollabStateStore;
+  assets: AssetStore;
+  settings?: SettingsStore;
+  themes?: ThemeStore;
+}
 export interface ForgeAdapterOptions extends Omit<AdapterHooks, 'authenticate'> {
   content: ForgeContent;
   state: ForgeState;
   /**
    * The complete TipTap extension list of the Markdown conversion, e.g. `[...advancedSchemaExtensions(), MermaidBlock]`:
-   * nodes and marks with their Markdown handlers. Host nodes also go to the collaboration schema through `schemaExtensions`
-   * (which lists only the additions to `advancedSchemaExtensions()`).
+   * nodes and marks with their Markdown handlers. Host nodes also go to the collaboration schema through the server's
+   * `schema` option (`() => [...advancedSchemaExtensions(), MermaidBlock]`).
    */
   schema: AnyExtension[];
   /** The host's session check; there is no default for a host that owns its Markdown files. */
-  authenticate: EditorAdapter['authenticate'];
+  authenticate: Identity['authenticate'];
   /** Markdown policy of the conversion (raw HTML, data URLs); the default drops both. */
   policy?: MarkdownPolicy;
   /** Called with the diagnostics of every load that produced some (dropped HTML or URLs, unknown fences kept verbatim). */
@@ -53,6 +58,6 @@ export interface ForgeAdapterOptions extends Omit<AdapterHooks, 'authenticate'>
  *
  * Yjs state, assets and settings are `state`'s. The converter is one headless editor per adapter, built on first use.
  */
-export declare function createForgeAdapter(options: ForgeAdapterOptions): EditorAdapter;
+export declare function createForgeAdapter(options: ForgeAdapterOptions): EditorPorts;
 //#endregion
 //# sourceMappingURL=forge.d.ts.map