@ecsplico/editor 2.1.2 → 3.0.0

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":"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"}

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

package/dist/adapters/forge.js

@@ -1,17 +1,10 @@
+import { directoryOf, identityOf } from "./shared.js";
 import { DocumentMarkdown } from "../core/document-markdown.js";
 import { hasFatalDiagnostics } from "../markdown/policy.js";
 import { contentToMarkdown, markdownToContent } from "../markdown/document.js";
 import { joinFrontmatter, splitFrontmatter } from "../markdown/frontmatter.js";
 import { Editor } from "@tiptap/core";
 //#region src/adapters/forge.ts
-const OPTIONAL_STATE = [
-	"loadSettings",
-	"storeSettings",
-	"listThemes",
-	"loadTheme",
-	"storeTheme",
-	"removeTheme"
-];
 /**
 * The editor's adapter over the host's Markdown files (concept documents, vault pages). The host keeps owning the
 * files, their locations, change notifications and access rules and passes them in as functions; this adapter does the
@@ -26,7 +19,7 @@ const OPTIONAL_STATE = [
 * Yjs state, assets and settings are `state`'s. The converter is one headless editor per adapter, built on first use.
 */
 function createForgeAdapter(options) {
-	const { content, state, schema, policy, onDiagnostics, authenticate, authorize, schemaExtensions, users } = options;
+	const { content, state, schema, policy, onDiagnostics, authenticate, authorize } = options;
 	let converter;
 	const editor = () => converter ??= new Editor({
 		content: {
@@ -35,7 +28,6 @@ function createForgeAdapter(options) {
 		},
 		extensions: [DocumentMarkdown, ...schema]
 	});
-	const optionalState = Object.fromEntries(OPTIONAL_STATE.filter((method) => state[method]).map((method) => [method, (...args) => state[method].apply(state, args)]));
 	function parse(id, file) {
 		const { content: json, diagnostics } = markdownToContent(editor(), splitFrontmatter(file.markdown).body, policy ? { policy } : {});
 		if (diagnostics.length) onDiagnostics?.(id, diagnostics);
@@ -46,43 +38,44 @@ function createForgeAdapter(options) {
 		return json;
 	}
 	return {
-		authenticate: (request) => authenticate(request),
-		listUsers: async () => await users?.() ?? [],
-		...authorize && { authorize: (user, id) => authorize(user, id) },
-		...schemaExtensions && { schemaExtensions: () => schemaExtensions() },
-		async loadContent(id) {
-			const file = await content.read(id);
-			return file && parse(id, file);
-		},
-		async storeContent(id, json) {
-			const current = await content.read(id);
-			if (!current) return;
-			const instance = editor();
-			instance.commands.setContent(json, { emitUpdate: false });
-			const body = contentToMarkdown(instance);
-			const markdown = joinFrontmatter(splitFrontmatter(current.markdown).frontmatter, body && `${body}\n`);
-			if (markdown === current.markdown) return;
-			await content.write(id, markdown);
-			await content.onWritten?.(id);
-		},
-		async contentVersion(id) {
-			return (await content.read(id))?.version ?? null;
-		},
-		async listContents() {
-			return (await Promise.all((await content.list?.() ?? []).map(async (id) => {
+		identity: identityOf({
+			authenticate,
+			authorize
+		}),
+		directory: directoryOf(options),
+		documents: {
+			async loadContent(id) {
 				const file = await content.read(id);
-				return file && {
-					id,
-					content: parse(id, file)
-				};
-			}))).filter((entry) => entry !== null);
+				return file && parse(id, file);
+			},
+			async storeContent(id, json) {
+				const current = await content.read(id);
+				if (!current) return;
+				const instance = editor();
+				instance.commands.setContent(json, { emitUpdate: false });
+				const body = contentToMarkdown(instance);
+				const markdown = joinFrontmatter(splitFrontmatter(current.markdown).frontmatter, body && `${body}\n`);
+				if (markdown === current.markdown) return;
+				await content.write(id, markdown);
+				await content.onWritten?.(id);
+			},
+			async contentVersion(id) {
+				return (await content.read(id))?.version ?? null;
+			},
+			async listContents() {
+				return (await Promise.all((await content.list?.() ?? []).map(async (id) => {
+					const file = await content.read(id);
+					return file && {
+						id,
+						content: parse(id, file)
+					};
+				}))).filter((entry) => entry !== null);
+			}
 		},
-		loadState: (id) => state.loadState(id),
-		storeState: (id, bytes) => state.storeState(id, bytes),
-		removeState: (id) => state.removeState(id),
-		storeAsset: (id, asset) => state.storeAsset(id, asset),
-		loadAsset: (id, name) => state.loadAsset(id, name),
-		...optionalState
+		collabState: state.collabState,
+		assets: state.assets,
+		...state.settings && { settings: state.settings },
+		...state.themes && { themes: state.themes }
 	};
 }
 //#endregion