@ecsplico/editor 3.6.0 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 4.0.0 - 2026-10-21
+
+### Added
+
+- Block vocabulary: `BlockType`, `BlockTypeAi`, `defaultBlockTypes`, `blockTypeOf`, `acceptsChild` (`/composites`, `/composites/schema`; code in `features/composites/block-types.ts`), `PropertyDefinition` and `derivedChildrenOf` (`/core`), `ModelRole` / `MODEL_ROLES` (stored as `ai.roles`, see Changed, "Persisted names (settings)"), `ModelPresetConfig` (`/config`, `/server`), `AccessControl` and `DocumentContentStore` of the server ports (`/server`). The former names are listed under Removed.
+- `blockTypes` option: `compositeFeature({ blockTypes })`, `compositeSchemaExtensions({ blockTypes })`, `composeEditor({ blockTypes })`, the `blockTypes` prop of `AdvancedEditor` and `ComposedSurface`.
+- `contentTemplate` on a Block type's `ai` brief and as the AI wire field `block.contentTemplate` (client and server of the AI endpoints ship in the same package).
+- Block capabilities (`@ecsplico/editor/core`): `EditorFeature.blockCapabilities` declares `BlockCapability` descriptors (`id`, `appliesTo(node, { blockTypeId })`, optional `storage` description); `defineEditor` merges them and rejects a duplicate id, also against the built-in `container` (nodes declaring `editorBlockContainer`) and `title` (first child is chrome). `capabilitiesAt(editor, pos)` / `capabilitiesOf(editor, node)` answer which capabilities a block has, memoised per node type and Block type id (`attrs.blockType`), so predicates read only the node type and `blockTypeId`. A capability describes and never installs schema; abilities stay the permission mechanism. `BlockAction.requires` lists capability ids the block must have; `blockActionsFor` hides the action otherwise and `blockActionsOf` throws when an action requires an id no Feature declares. `EditorPreset.capabilities` is the merged `CapabilityIndex`.
+- Block types as data: `BlockType` is `id`, presentation (`label`, `icon`, `titlePlaceholder`, `descriptionPlaceholder`, `chrome`) and `capabilities: { id, config? }[]` (`BlockTypeData` / `BlockTypeCapability` in `@ecsplico/editor/core`). The former switches move into capability entries: `fields` → `properties` (`{ definitions }`), `source` → `source` (`{ media }`), `accepts` → `container` (`{ accepts }`), `ai` → `ai-brief`, plus the new `basket` and `bibliography` entries. Accessors: `propertiesOf`, `sourceMediaOf`, `aiBriefOf`, `acceptsOf`, `blockTypeConfigOf` (`/composites`, `/composites/schema`).
+- The composites feature declares the `properties`, `source`, `bibliography`, `basket`, `ai-brief` and `references` capabilities through `blockCapabilities`; core only has `container` and `title`. `BlockCapability` gains `configSchema` (zod, validates the config a Block type gives) and `read(node, ctx)` (the contents or value in a block: the source child, the basket id, the bibliography record); `appliesTo` stays type-level and memoised per node type and Block type id. `CapabilityContext` gains `blockTypeOf(node)` and `configOf(node, capability)`. New exports (`@ecsplico/editor/core`): `capabilityConfigOf`, `capabilityDataOf`, `blockTypeIdOf`, `listsCapability`, `createCapabilityRegistry`, `validateBlockTypes`, `EditorFeature.blockTypes`, `BlockAction.blockTypes` (type-specific actions only). An editor checks every Block type when it is created: an unknown capability id or an invalid config throws.
+- Derive methods (`@ecsplico/editor/core`): `EditorFeature.deriveMethods` contributes `DeriveMethod` entries (`id`, `label`, `icon`, `ability?`, `order?`, `placement?`, `requires` capability ids on the original, `available(ctx)` for backend flags and per-block conditions, `run` or `menu`). `defineEditor` merges them into `preset.deriveMethods` (`DeriveRegistry`) and rejects a duplicate id, a method with neither or both of `run` and `menu`, and a `requires` entry no feature declares; `blockActionsOf` turns every method into a block action (`deriveActionsOf`), `deriveMethodsAt(editor, ctx, pos)` lists the methods that can run on a block. New `derived` capability (declared by the composites feature; a block has it when `meta.derivation` is present, so `BlockCapability.perNode` lets a capability decide per node instead of per node type) and the memoised reverse index `derivationIndexOf(doc)` / `derivedOf(doc, pos)` / `derivationOriginOf(doc, pos, documentId?)`, computed from block IDs per document node; the original stores no back-pointer.
+- Block types from a JSON file (`@ecsplico/editor/composites`, `/composites/schema`): `parseBlockTypes(input, { registry? })` reads a `BlockType[]` (the file's text or its parsed value) and checks every entry against the capability registry (unknown capability, capability listed twice, invalid `config` per the capability's `configSchema`, duplicate id); it throws one `BlockTypeJsonError` that names the Block type, the capability and the path for every problem (`issues` carries them as data). `mergeBlockTypes(base, extra)` layers the file over `defaultBlockTypes(t)`; the result goes to the existing `blockTypes` option. `examples/vue-two-pane` defines the Block type „Idee“ only in `shared/block-types.json`.
+- Block types on the server: `installEditorServer({ blockTypes })` (`EditorServerOptions.blockTypes`), `AiHandlerContext.blockTypes` and `setEditorPorts(ports, { blockTypes })` (Nuxt) give the server the host's Block types. `POST /api/ai/chat` then describes them to the model and ignores the `blockTypes` of the request; without them it behaves as before. `aiBlockTypesOf(blockTypes)` (`/composites`, `/composites/schema`) builds the chat's Block type list for the editor's `aiContext` and the server alike.
+- One Property definition for every Block (`PropertyDefinition`, `PROPERTY_TYPES` in `@ecsplico/editor/core`; `BlockType`'s `properties` config, the inspector, `AiContextBlockType.fields` and the server's chat schema use it). The `properties` capability applies to any node with a `meta` attribute whose Block type lists it. New helpers `carriesProperties(node)`, `blockPropertiesAt(editor, $pos, blockTypes)`, `propertyHostOf(doc, target)`, `blockPropertiesOf`, `setBlockProperty(editor, target, key, value)` and `metaWithProperty` (`/composites`); `CompositeInspectorState` gains `properties` (the Block properties at the caret) and the Vue `useCompositeInspector` a `properties` ref.
+- The Block inspector shows a Block properties section for any block that has the `properties` capability (heading „Blockeigenschaften“ / "Block properties"), driven by the definitions of its Block type; `CompositeInspector` and `CompositeFieldEditor` write through `setBlockProperty`. Storage, Markdown fences, copy/paste and the Yjs state are unchanged.
+- The Block inspector shows the Derivation of every Derived block, whatever its Block type, with the source-missing state („Quelle fehlt“ / "Source missing"); a Block type that also has a `derivation` Property definition shows it once (`CompositeInspectorState.derivation`, `InspectorDerivation`).
+- The `container` config gains `root: true`: the document tree takes the Block type that sets it as the type of its document rows (`isRootBlockType`, `/composites`); the built-in Document type sets it, and no code looks the type up by its id any more.
+- `capabilityIssues(registry, type)` (`/core`) is the one validator of a Block type's capabilities: `validateBlockTypes` throws on its issues and `parseBlockTypes` collects them. The wording of the unknown, duplicate and invalid-config messages changed.
+- Documentation: the guides [Block capabilities and actions](https://skaile-ai.github.io/skaile-editor/guides/block-capabilities), [Block types in code and JSON](https://skaile-ai.github.io/skaile-editor/guides/block-types), [Derive methods and the Derivation index](https://skaile-ai.github.io/skaile-editor/guides/derive-methods) and [Block properties](https://skaile-ai.github.io/skaile-editor/guides/block-properties), and the reference pages Block capability contract, Block type contract and Derive method contract. Their code samples come from `docs/snippets`, which `bun run check:docs-snippets` keeps in sync.
+- `BlockAction.target?: 'block' | 'typedBlock'` (`/core`, default `'block'`): on the toolbar surface an action with `target: 'typedBlock'` is checked against and runs with the Typed block around the selected block (the block itself when it is one), so its split, merge, export, bibliography and focus actions stay on the toolbar while the caret is in a paragraph inside the Typed block; with no Typed block around, the action is absent. `blockActionsFor` evaluates `ability`, `requires`, `blockTypes` and `isVisible` against that Typed block and passes its `node` and `pos` in the context; the hover bar ignores the field, and the bar still docks at the selected block. `typedBlockAround(editor, target)` (`/block-ui`) finds the Typed block. The composites feature's eight Typed-block actions declare `target: 'typedBlock'`.
+
+### Fixed
+
+- The workspace tag list (`GET /api/editor/tags`) again offers the tags of stored documents that still use the old persisted names; it reads them through the old-name migration.
+
+### Changed
+
+- Inspector, details popover, table, tree, outline and the AI brief read capabilities instead of Block type fields. The Basket menu and stripe need the `basket` capability, the BibTeX export action the `bibliography` capability, the Block properties the `properties` capability; a host Block type that relied on the former defaults must list them (migration guide, "Block types as data").
+- Block actions decide by `requires` (BibTeX export, source replacement, AI fill, readable rendition, literature lookup) instead of node-name and Block-type-name checks.
+- The Focus block action (`composite-focus`) is gated by `requires: ['container']` instead of a node-name check; it still appears only on Typed blocks.
+- The built-in Folder and Document Block types declare `accepts: 'all'` themselves (in their `container` config); the id-keyed default is gone. A Block type without `accepts`, and a type id a list does not define, accepts no nested Typed blocks (`acceptsChild`); a host list that defines its own `folder` or `document` type must set `accepts` on it.
+- Derivation lives in core: `Derivation`, `derivationOf`, `derivedChildrenOf`, `derivationState` and `DERIVATION_KEY` moved from `features/composites/derivation.ts` to `core/derivation.ts` (import them from `@ecsplico/editor/core`; the Source-media helpers `sourceOf`, `bodyMarkdown` and `SourceBlock` stay in `features/composites/source.ts`). **`derivationState` signature changed**: it takes `(doc, derivedPos, bodyHash, documentId?)` and finds the original itself (was `(composite, derived, bodyHash, kinds, documentId?)`), and its `source` field is `'found' | 'missing' | 'foreign'` (was `foreign: boolean`). A Derived block whose original was deleted or is gone from the document stays and shows „Quelle fehlt“ / „Source missing“ in the chrome row, the details card, the Block inspector and the Block outline (`OutlineNode.sourceMissing`, `TreeItem.sourceMissing`).
+- The block actions `composite-fill`, `composite-summarize`, `composite-derive`, `bibliography-fetch`, `rendition-create` and `rendition-regenerate` are generated from derive methods; ids, labels, order and abilities are unchanged. `rendition-regenerate` now requires the `derived` capability instead of `container` and `title`.
+- The Document Block type is plain configuration; no code tests the type id `document` any more. New capabilities of the composites feature: `export` (the block action „Exportieren“, `document-export`, is `requires: ['export']` instead of `blockTypes: ['document']`; the built-in Document type lists it, a host type may too) and `import` (config `{ media?: SourceMedia[] }`: the imported-file wrapping of `composite-media` and "Datei importieren" use the type whose `import` takes the file's media, by default `recording` for audio/video, `figure` for images and `document` as the catch-all; the tree's "Datei importieren" entry is offered below Typed blocks whose type accepts such a type). New helpers `importTypeOf`, `acceptsImport` (`/composites`, `/composites/schema`). A host Block type list that wrapped files by the ids `document`/`recording`/`figure` must list `import` on them. The server's legacy migration of the flat `meta.transcript` keys on that property (`hasFlatTranscript`), not on the Block type; stored documents open as before.
+- Block UI addresses the outer block: with the caret or pointer inside a list item or a blockquote paragraph, the hover bar, the toolbar block actions (`selectedBlockOf`) and the drag handle act on the whole list or quote, because list items are not Blocks of their own. The rule is the outermost block below the nearest block container (`doc` or a Container block such as a Typed block); new framework-free resolvers `outerBlocksAt($pos)`, `outerBlockAt($pos)` and the drag-handle rule `outerBlockRule` (`@ecsplico/editor/block-ui`). Nested paragraphs keep their block IDs. `handleLeftOf` no longer takes a node; `gutterShiftOf` is removed.
+- UI labels in the agreed vocabulary. English: „Building block“ → „Typed block“, „Kind“ → „Block type“ (inspector, table, filter, icon setting, default type), the rendition type → „Readable rendition“, „Darstellung“ → „Theme“ with „Default appearance“, the inspector's document section → „Document facts“, the structure setting → „Structure mode“ / „Flat mode“, „Baustein“ in reference chips → „block“. German: Baustein → Block (palette group „Typisierte Blöcke“), Bausteinart / Art → Blocktyp; Korb and Lesefassung stay. Message keys are unchanged.
+- The library, the reference app, the examples and the docs use only the new names. The tree command `createBausteinFolder` is now `createFolderBlock` (`TreeCommand`, `@ecsplico/editor/tree`); a host executor that switches on the command type must use the new string. German demo and error strings that said Baustein now say Block or Dokument (`Keine gültige Dokumentdatei`).
+- **Persisted names (documents).** The node `composite` is stored as `typedBlock`, its chrome nodes `compositeTitle`/`compositeDescription`/`compositeTags` as `typedBlockTitle`/`typedBlockDescription`/`typedBlockTags`, and the attribute `kind` of a Typed block and of `opaqueFence` as `blockType` (block IDs, `meta` and the `::: <Block type id>` Markdown fences are unchanged). HTML: `section[data-type="typedBlock"][data-block-type]`; the old `data-type="composite"` / `data-kind` markup and the legacy `section` markup still parse. `BlockTransfer.kind` is `BlockTransfer.blockType` (an old drag payload is read). The editor's node storage is `editor.storage.typedBlock` (was `composite`); the `ConvertTarget` of a Typed block is `{ type: 'typedBlock', blockType }` (id `typedBlock:<id>`); `data-kind-tone` is `data-block-type-tone`. Everything stored before loads through one migration (`migratePersistedNames` in `core/schema/persisted-names.ts`, run by `migrateLegacyContent`, `defineEditor` ahead of any contributed `migrateContent`, the server's `contentNode` and, for Yjs state, by `onLoadDocument` before any client syncs); old names are read, never written; the Yjs migration is idempotent and keeps block IDs and content ([migration guide](https://skaile-ai.github.io/skaile-editor/guides/migration), "Persisted names").
+- **Persisted names (settings).** Settings version 2: `ai.slots` is `ai.roles`, `blocks.defaultKind` is `blocks.defaultBlockType`, `blocks.kindIcon` is `blocks.blockTypeIcon`, and the `blocks.structure` value `'composite'` is `'structured'` (`STRUCTURE_MODES = ['flat', 'structured']`). Saved settings (server store, `localStorage`) migrate on load through `migrateEditorSettings` and are rewritten once. `KIND_ICON_VISIBILITIES` / `KindIconVisibility` are `BLOCK_TYPE_ICON_VISIBILITIES` / `BlockTypeIconVisibility` (`/settings`). Host config: `ai.slots` is `ai.roles` (`EditorConfig`, `publicConfig`, `serverConfig`, `DirectAiOptions`); this needs a code change, there is no migration. `GET /api/ai/models` answers `{ presets, roles }` (was `slots`); client and server ship in the same package.
+- The rename of old persisted names always runs: `defineEditor` applies it ahead of any contributed `migrateContent`, so a host hook receives current names and can no longer drop it.
+- Further vocabulary renames (migration guide, "Block vocabulary"): `aiKindsOf` → `aiBlockTypesOf`, `derivableKindsOf` → `derivableBlockTypesOf`, `AiContextKind` → `AiContextBlockType`, `AiContext.kinds` / `ChatBlockModel.kinds` / the AI chat request field `kinds` → `blockTypes`, `ConvertTarget.kind` → `blockType`, `BlockProperties.fields` → `definitions`, the settings tab prop `kinds` → `blockTypes`, CSS `--sk-kind-tone` / `--sk-kind-tone-mix` → `--sk-block-type-tone` / `--sk-block-type-tone-mix`. One helper each for a Block type's capabilities: `listsCapability(type, id)` and `blockTypeConfigOf(type, id)` in `/core` (replacing `listsBlockTypeCapability` and the `(ctx, node, id)` form); `configOf` and `capabilityConfigOf` return `undefined` when absent (was `null`). `BlockTypeSpec` is gone; use `BlockType`.
+- The Derivation helpers and `PropertyDefinition` are exported only from `@ecsplico/editor/core` (no longer re-exported from `/composites` and `/composites/schema`).
+
+### Removed
+
+**Breaking.** The deprecated aliases and the remaining old names are gone; migrate to the new names ([migration guide](https://skaile-ai.github.io/skaile-editor/guides/migration), "Block vocabulary"). Persisted names are covered under Changed ("Persisted names").
+
+| Removed | Use | Entry |
+|---|---|---|
+| `CompositeKind`, `CompositeKindAi`, `CompositeMetaField` | `BlockType`, `BlockTypeAi`, `PropertyDefinition` | `/composites`, `/composites/schema`; `PropertyDefinition` from `/core` |
+| `CompositeKind.nestedAfterContent` (3.6.0) | `nestedAfterContent` in the Block type's `container` config (`{ id: 'container', config: { accepts, nestedAfterContent: true } }`; `nestedAfterContentOf(type)`) | `/composites`, `/composites/schema` |
+| `defaultCompositeKinds`, `fallbackCompositeKinds`, `compositeKind`, `kindAccepts` | `defaultBlockTypes`, `fallbackBlockTypes`, `blockTypeOf`, `acceptsChild` | `/composites`, `/composites/schema` |
+| `compositeKindsOf(editor)` | `blockTypesOf(editor)` | `/composites`, `/composites/schema` |
+| `setCompositeKind(kind, pos?)` (editor command) | `changeBlockType(blockTypeId, pos?)` (not `setBlockType`: ProseMirror uses that name for node-type changes) | editor commands |
+| `CompositeKindCount`, `CompositeKindOption`, `ChatCompositeKind` | `BlockTypeCount`, `BlockTypeOption`, `ChatBlockType` | `/composites`, `/ai` |
+| `renditionsOf` | `derivedChildrenOf` | `/core` |
+| `compositeMetaWith`, `setCompositeMetaField` | `metaWithProperty`, `setBlockProperty` | `/composites` |
+| the `kinds` and `compositeKinds` options (`compositeFeature`, `compositeSchemaExtensions`, `composeEditor`, `AdvancedEditor`, `ComposedSurface`) | `blockTypes` | |
+| `skeleton` in the `ai-brief` config and `BlockTypeAi`; the AI wire field `block.skeleton` (`AI_LIMITS.block.skeleton`, the server schema) | `contentTemplate` | `/composites`, `/ai`, `/server` |
+| `ModelSlot`, `MODEL_SLOTS`, `MODEL_SLOT_KEYS` | `ModelRole`, `MODEL_ROLES`, `MODEL_ROLE_KEYS` | `/settings` |
+| `PresetConfig` | `ModelPresetConfig` | `/config`, `/server` |
+| `Identity`, `DocumentStore` (server ports) | `AccessControl`, `DocumentContentStore` | `/server` |
+
+The Document tree's own `DocumentStore` (`/tree`) keeps its name.
+
 ## 3.6.0 - 2026-10-21
 
 ### Added

package/dist/adapters/direct-ai.d.ts

@@ -1,7 +1,7 @@
-import { ModelSlot } from "../settings/values.js";
+import { ModelRole } from "../settings/values.js";
 import { EditorBackend } from "../core/backend.js";
 //#region src/adapters/direct-ai.d.ts
-/** A model the browser calls directly: `endpoint` is the OpenAI-compatible base URL (`<endpoint>/chat/completions` is called), like `PresetConfig.endpoint`. */
+/** A model the browser calls directly: `endpoint` is the OpenAI-compatible base URL (`<endpoint>/chat/completions` is called), like `ModelPresetConfig.endpoint`. */
 export interface DirectAiPreset {
   label: string;
   /** Base URL, e.g. `https://openrouter.ai/api/v1`. */
@@ -13,8 +13,8 @@ export interface DirectAiPreset {
 export interface DirectAiOptions {
   /** The models the editor offers, keyed by preset id. At least one. */
   presets: Record<string, DirectAiPreset>;
-  /** Default preset per model slot, answered by `models()`; the first preset for unset slots. */
-  slots?: Partial<Record<ModelSlot, string>>;
+  /** Default preset per Model role, answered by `models()`; the first preset for unset roles. */
+  roles?: Partial<Record<ModelRole, string>>;
   /** Usernames offered to tasks with `needsUsers` (`@` mentions); none by default. */
   users?: () => Promise<string[]> | string[];
   /** The `fetch` the model calls go through (default: the platform's). */

package/dist/adapters/direct-ai.js

@@ -1,6 +1,6 @@
 import { BackendError } from "../core/backend.js";
 import { completeBodySchema, runCompletion } from "../features/ai/protocol/complete.js";
-import { MODEL_SLOTS } from "../settings/values.js";
+import { MODEL_ROLES } from "../settings/values.js";
 import { AI_TASKS } from "../features/ai/protocol/tasks.js";
 import { generateBodySchema, generateProblem, runGenerate } from "../features/ai/protocol/generate.js";
 import { TranscriptCleanupUnreadableError, runTranscriptCleanup, transcriptCleanupRequestSchema } from "../integrations/transcript-ai/protocol.js";
@@ -120,7 +120,7 @@ function createDirectAi(options) {
 				model,
 				source: "preset"
 			})),
-			slots: Object.fromEntries(MODEL_SLOTS.map((slot) => [slot, options.slots?.[slot] ?? ids[0]]))
+			roles: Object.fromEntries(MODEL_ROLES.map((role) => [role, options.roles?.[role] ?? ids[0]]))
 		}),
 		complete: async (body, signal) => {
 			const { before, model } = parseBody(completeBodySchema, body);

package/dist/adapters/direct-ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"direct-ai.js","names":[],"sources":["../../src/adapters/direct-ai.ts"],"sourcesContent":["// i18n-ignore-file: error messages of the browser-direct AI transport (German whatever the editor's language)\nimport type { z } from 'zod'\nimport { BackendError, type EditorBackend } from '../core/backend'\nimport type { ModelProfile, ModelRef } from '../core/backend-types'\nimport { completeBodySchema, runCompletion } from '../features/ai/protocol/complete'\nimport { type ChatMessage, type ChatStream, generateBodySchema, generateProblem, runGenerate } from '../features/ai/protocol/generate'\nimport { AI_TASKS } from '../features/ai/protocol/tasks'\nimport { runTranscriptCleanup, TranscriptCleanupUnreadableError, transcriptCleanupRequestSchema } from '../integrations/transcript-ai/protocol'\nimport { MODEL_SLOTS, type ModelSlot } from '../settings/values'\n\n// The browser-direct adapter of `EditorBackend['ai']`: the model calls of `generate`, `complete`, `models` and\n// `transcriptCleanup` go from the page straight to an OpenAI-compatible chat-completions endpoint, with no `/api/ai`\n// route in between. It runs the same protocol modules the server handlers run (`runGenerate`, `runCompletion`,\n// `runTranscriptCleanup`), so prompts, limits and results are identical. What it cannot do without a server (the\n// document chat's tool calls, `extract`'s transcription and OCR) answers 501.\n\n/** A model the browser calls directly: `endpoint` is the OpenAI-compatible base URL (`<endpoint>/chat/completions` is called), like `PresetConfig.endpoint`. */\nexport interface DirectAiPreset {\n  label: string\n  /** Base URL, e.g. `https://openrouter.ai/api/v1`. */\n  endpoint: string\n  model: string\n  /** Sent as `Authorization: Bearer …`. It is part of the page, so anyone who can open the page can read it. */\n  apiKey?: string\n}\n\nexport interface DirectAiOptions {\n  /** The models the editor offers, keyed by preset id. At least one. */\n  presets: Record<string, DirectAiPreset>\n  /** Default preset per model slot, answered by `models()`; the first preset for unset slots. */\n  slots?: Partial<Record<ModelSlot, string>>\n  /** Usernames offered to tasks with `needsUsers` (`@` mentions); none by default. */\n  users?: () => Promise<string[]> | string[]\n  /** The `fetch` the model calls go through (default: the platform's). */\n  fetch?: typeof fetch\n}\n\n/** The most characters of an upstream error body that go into the error message. */\nconst MAX_ERROR_DETAIL = 300\n\n/** Parses `body` with `schema`; a mismatch is a 400 like the server's validation error. */\nfunction parseBody<S extends z.ZodType>(schema: S, body: unknown): z.infer<S> {\n  const parsed = schema.safeParse(body)\n  if (parsed.success) return parsed.data\n  const [issue] = parsed.error.issues\n  throw new BackendError(`Ungültige Anfrage${issue ? `: ${[...issue.path, issue.message].join(' ')}` : ''}`, 400, { cause: parsed.error })\n}\n\n/** The `data:` payloads of an SSE body, in order; stops at the end of the body. */\nasync function* sseData(body: ReadableStream<Uint8Array>): AsyncGenerator<string> {\n  const reader = body.getReader()\n  const decoder = new TextDecoder()\n  let buffer = ''\n  try {\n    while (true) {\n      const { value, done } = await reader.read()\n      if (done) break\n      buffer += decoder.decode(value, { stream: true })\n      let newline = buffer.indexOf('\\n')\n      while (newline !== -1) {\n        const line = buffer.slice(0, newline).replace(/\\r$/, '')\n        buffer = buffer.slice(newline + 1)\n        if (line.startsWith('data:')) yield line.slice(5).trim()\n        newline = buffer.indexOf('\\n')\n      }\n    }\n    const rest = (buffer + decoder.decode()).trim()\n    if (rest.startsWith('data:')) yield rest.slice(5).trim()\n  }\n  finally {\n    await reader.cancel().catch(() => undefined)\n  }\n}\n\n/** One chunk of a chat-completions stream: the text delta, or a provider error sent in the stream. */\ninterface CompletionChunk { choices?: { delta?: { content?: unknown } }[], error?: { message?: unknown } | string }\n\n/**\n * Streams the text deltas of a chat completion from `<endpoint>/chat/completions`. A refused request (non-2xx, or the\n * endpoint unreachable) throws a `BackendError` before anything is yielded, with the upstream status (502 when there\n * was none); an error inside the stream throws a plain `Error`.\n */\nasync function* streamChat(send: typeof fetch, { endpoint, model, apiKey }: { endpoint: string, model: string, apiKey?: string }, messages: ChatMessage[], signal: AbortSignal): AsyncGenerator<string> {\n  let response: Response\n  try {\n    response = await send(`${endpoint.replace(/\\/+$/, '')}/chat/completions`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', 'Accept': 'text/event-stream', ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}) },\n      body: JSON.stringify({ model, messages, stream: true }),\n      signal,\n    })\n  }\n  catch (error) {\n    if (signal.aborted) throw error\n    throw new BackendError(`KI-Endpunkt nicht erreichbar: ${error instanceof Error ? error.message : String(error)}`.slice(0, 500), 502, { cause: error })\n  }\n  if (!response.ok) {\n    const detail = (await response.text().catch(() => '')).slice(0, MAX_ERROR_DETAIL)\n    throw new BackendError(`KI-Endpunkt: ${[response.status, detail || response.statusText].filter(Boolean).join(' ')}`, response.status)\n  }\n  if (!response.body) throw new BackendError('KI-Endpunkt: leere Antwort', 502)\n\n  for await (const data of sseData(response.body)) {\n    if (data === '[DONE]') return\n    let chunk: CompletionChunk | null\n    try {\n      chunk = JSON.parse(data) as CompletionChunk | null\n    }\n    catch {\n      continue\n    }\n    if (typeof chunk !== 'object' || chunk === null) continue\n    if (chunk.error) {\n      const message = typeof chunk.error === 'string' ? chunk.error : chunk.error.message\n      throw new Error(typeof message === 'string' && message ? message : 'KI-Endpunkt: Fehler im Stream')\n    }\n    const text = chunk.choices?.[0]?.delta?.content\n    if (typeof text === 'string' && text) yield text\n  }\n}\n\n/**\n * An `EditorBackend['ai']` that calls OpenAI-compatible chat-completion endpoints from the browser: `models`,\n * `complete`, `stream('generate')` and `transcriptCleanup`, with the protocol modules the server handlers use.\n * `stream('chat')` and `extract` need a server (tool calls, transcription, OCR) and fail with `BackendError` 501; a\n * host that needs them takes `ai` from `createHttpBackend()` instead.\n *\n * The keys in `presets` are part of the page: whoever can open it can read them, and the per-user rate limit of the\n * server routes does not apply. Use it for local models, tokens the user brings or scoped keys, and keep keys that\n * must stay secret behind the server routes. Combine it with the memory backend:\n * `{ ...createMemoryBackend(), ai: createDirectAi({ presets }) }`.\n */\nexport function createDirectAi(options: DirectAiOptions): NonNullable<EditorBackend['ai']> {\n  const ids = Object.keys(options.presets)\n  if (!ids.length) throw new Error('createDirectAi: presets is empty')\n  const send = options.fetch ?? fetch\n\n  const resolve = (ref: ModelRef) => {\n    if (!('preset' in ref)) return ref\n    const preset = Object.hasOwn(options.presets, ref.preset) ? options.presets[ref.preset] : undefined\n    if (!preset) throw new BackendError('Unbekanntes Modell-Preset', 400)\n    return preset\n  }\n  const chatOn = (ref: ModelRef): ChatStream => {\n    const model = resolve(ref)\n    return (messages, signal) => streamChat(send, model, messages, signal)\n  }\n\n  return {\n    models: () => Promise.resolve({\n      presets: Object.entries(options.presets).map(([id, { label, endpoint, model }]): ModelProfile => ({ id, label, endpoint, model, source: 'preset' })),\n      slots: Object.fromEntries(MODEL_SLOTS.map(slot => [slot, options.slots?.[slot] ?? ids[0]!])) as Record<ModelSlot, string>,\n    }),\n\n    complete: async (body, signal) => {\n      const { before, model } = parseBody(completeBodySchema, body)\n      return { text: await runCompletion(before, chatOn(model), signal) }\n    },\n\n    async* stream(path, body, signal) {\n      if (path === 'chat') throw new BackendError('Chat braucht einen Server (direct-ai)', 501)\n      const { task: taskId, model, ...input } = parseBody(generateBodySchema, body)\n      const stream = chatOn(model)\n      const task = AI_TASKS[taskId]\n      const problem = generateProblem(task, input)\n      if (problem) throw new BackendError(problem, 400)\n      const users = task.needsUsers ? await options.users?.() : undefined\n\n      // `runGenerate` turns a failed model call into an `error` event; a refused request (before the first delta) is\n      // rejected instead, like the server's non-2xx answer, so the caller can tell it from a failing stream.\n      let refused: BackendError | undefined\n      let started = false\n      const guarded: ChatStream = async function* (messages, streamSignal) {\n        try {\n          for await (const text of stream(messages, streamSignal)) {\n            started = true\n            yield text\n          }\n        }\n        catch (error) {\n          if (!started && error instanceof BackendError) refused = error\n          throw error\n        }\n      }\n      for await (const event of runGenerate(task, input, users, guarded, signal)) {\n        if (refused && !signal.aborted) throw refused\n        yield event\n      }\n    },\n\n    transcriptCleanup: async (body, signal) => {\n      const { segments, model } = parseBody(transcriptCleanupRequestSchema, body)\n      try {\n        return await runTranscriptCleanup(segments, chatOn(model), signal)\n      }\n      catch (error) {\n        throw error instanceof TranscriptCleanupUnreadableError ? new BackendError(error.message, 502, { cause: error }) : error\n      }\n    },\n\n    extract: () => Promise.reject(new BackendError('Extraktion braucht einen Server (direct-ai)', 501)),\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"direct-ai.js","names":[],"sources":["../../src/adapters/direct-ai.ts"],"sourcesContent":["// i18n-ignore-file: error messages of the browser-direct AI transport (German whatever the editor's language)\nimport type { z } from 'zod'\nimport { BackendError, type EditorBackend } from '../core/backend'\nimport type { ModelProfile, ModelRef } from '../core/backend-types'\nimport { completeBodySchema, runCompletion } from '../features/ai/protocol/complete'\nimport { type ChatMessage, type ChatStream, generateBodySchema, generateProblem, runGenerate } from '../features/ai/protocol/generate'\nimport { AI_TASKS } from '../features/ai/protocol/tasks'\nimport { runTranscriptCleanup, TranscriptCleanupUnreadableError, transcriptCleanupRequestSchema } from '../integrations/transcript-ai/protocol'\nimport { MODEL_ROLES, type ModelRole } from '../settings/values'\n\n// The browser-direct adapter of `EditorBackend['ai']`: the model calls of `generate`, `complete`, `models` and\n// `transcriptCleanup` go from the page straight to an OpenAI-compatible chat-completions endpoint, with no `/api/ai`\n// route in between. It runs the same protocol modules the server handlers run (`runGenerate`, `runCompletion`,\n// `runTranscriptCleanup`), so prompts, limits and results are identical. What it cannot do without a server (the\n// document chat's tool calls, `extract`'s transcription and OCR) answers 501.\n\n/** A model the browser calls directly: `endpoint` is the OpenAI-compatible base URL (`<endpoint>/chat/completions` is called), like `ModelPresetConfig.endpoint`. */\nexport interface DirectAiPreset {\n  label: string\n  /** Base URL, e.g. `https://openrouter.ai/api/v1`. */\n  endpoint: string\n  model: string\n  /** Sent as `Authorization: Bearer …`. It is part of the page, so anyone who can open the page can read it. */\n  apiKey?: string\n}\n\nexport interface DirectAiOptions {\n  /** The models the editor offers, keyed by preset id. At least one. */\n  presets: Record<string, DirectAiPreset>\n  /** Default preset per Model role, answered by `models()`; the first preset for unset roles. */\n  roles?: Partial<Record<ModelRole, string>>\n  /** Usernames offered to tasks with `needsUsers` (`@` mentions); none by default. */\n  users?: () => Promise<string[]> | string[]\n  /** The `fetch` the model calls go through (default: the platform's). */\n  fetch?: typeof fetch\n}\n\n/** The most characters of an upstream error body that go into the error message. */\nconst MAX_ERROR_DETAIL = 300\n\n/** Parses `body` with `schema`; a mismatch is a 400 like the server's validation error. */\nfunction parseBody<S extends z.ZodType>(schema: S, body: unknown): z.infer<S> {\n  const parsed = schema.safeParse(body)\n  if (parsed.success) return parsed.data\n  const [issue] = parsed.error.issues\n  throw new BackendError(`Ungültige Anfrage${issue ? `: ${[...issue.path, issue.message].join(' ')}` : ''}`, 400, { cause: parsed.error })\n}\n\n/** The `data:` payloads of an SSE body, in order; stops at the end of the body. */\nasync function* sseData(body: ReadableStream<Uint8Array>): AsyncGenerator<string> {\n  const reader = body.getReader()\n  const decoder = new TextDecoder()\n  let buffer = ''\n  try {\n    while (true) {\n      const { value, done } = await reader.read()\n      if (done) break\n      buffer += decoder.decode(value, { stream: true })\n      let newline = buffer.indexOf('\\n')\n      while (newline !== -1) {\n        const line = buffer.slice(0, newline).replace(/\\r$/, '')\n        buffer = buffer.slice(newline + 1)\n        if (line.startsWith('data:')) yield line.slice(5).trim()\n        newline = buffer.indexOf('\\n')\n      }\n    }\n    const rest = (buffer + decoder.decode()).trim()\n    if (rest.startsWith('data:')) yield rest.slice(5).trim()\n  }\n  finally {\n    await reader.cancel().catch(() => undefined)\n  }\n}\n\n/** One chunk of a chat-completions stream: the text delta, or a provider error sent in the stream. */\ninterface CompletionChunk { choices?: { delta?: { content?: unknown } }[], error?: { message?: unknown } | string }\n\n/**\n * Streams the text deltas of a chat completion from `<endpoint>/chat/completions`. A refused request (non-2xx, or the\n * endpoint unreachable) throws a `BackendError` before anything is yielded, with the upstream status (502 when there\n * was none); an error inside the stream throws a plain `Error`.\n */\nasync function* streamChat(send: typeof fetch, { endpoint, model, apiKey }: { endpoint: string, model: string, apiKey?: string }, messages: ChatMessage[], signal: AbortSignal): AsyncGenerator<string> {\n  let response: Response\n  try {\n    response = await send(`${endpoint.replace(/\\/+$/, '')}/chat/completions`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', 'Accept': 'text/event-stream', ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}) },\n      body: JSON.stringify({ model, messages, stream: true }),\n      signal,\n    })\n  }\n  catch (error) {\n    if (signal.aborted) throw error\n    throw new BackendError(`KI-Endpunkt nicht erreichbar: ${error instanceof Error ? error.message : String(error)}`.slice(0, 500), 502, { cause: error })\n  }\n  if (!response.ok) {\n    const detail = (await response.text().catch(() => '')).slice(0, MAX_ERROR_DETAIL)\n    throw new BackendError(`KI-Endpunkt: ${[response.status, detail || response.statusText].filter(Boolean).join(' ')}`, response.status)\n  }\n  if (!response.body) throw new BackendError('KI-Endpunkt: leere Antwort', 502)\n\n  for await (const data of sseData(response.body)) {\n    if (data === '[DONE]') return\n    let chunk: CompletionChunk | null\n    try {\n      chunk = JSON.parse(data) as CompletionChunk | null\n    }\n    catch {\n      continue\n    }\n    if (typeof chunk !== 'object' || chunk === null) continue\n    if (chunk.error) {\n      const message = typeof chunk.error === 'string' ? chunk.error : chunk.error.message\n      throw new Error(typeof message === 'string' && message ? message : 'KI-Endpunkt: Fehler im Stream')\n    }\n    const text = chunk.choices?.[0]?.delta?.content\n    if (typeof text === 'string' && text) yield text\n  }\n}\n\n/**\n * An `EditorBackend['ai']` that calls OpenAI-compatible chat-completion endpoints from the browser: `models`,\n * `complete`, `stream('generate')` and `transcriptCleanup`, with the protocol modules the server handlers use.\n * `stream('chat')` and `extract` need a server (tool calls, transcription, OCR) and fail with `BackendError` 501; a\n * host that needs them takes `ai` from `createHttpBackend()` instead.\n *\n * The keys in `presets` are part of the page: whoever can open it can read them, and the per-user rate limit of the\n * server routes does not apply. Use it for local models, tokens the user brings or scoped keys, and keep keys that\n * must stay secret behind the server routes. Combine it with the memory backend:\n * `{ ...createMemoryBackend(), ai: createDirectAi({ presets }) }`.\n */\nexport function createDirectAi(options: DirectAiOptions): NonNullable<EditorBackend['ai']> {\n  const ids = Object.keys(options.presets)\n  if (!ids.length) throw new Error('createDirectAi: presets is empty')\n  const send = options.fetch ?? fetch\n\n  const resolve = (ref: ModelRef) => {\n    if (!('preset' in ref)) return ref\n    const preset = Object.hasOwn(options.presets, ref.preset) ? options.presets[ref.preset] : undefined\n    if (!preset) throw new BackendError('Unbekanntes Modell-Preset', 400)\n    return preset\n  }\n  const chatOn = (ref: ModelRef): ChatStream => {\n    const model = resolve(ref)\n    return (messages, signal) => streamChat(send, model, messages, signal)\n  }\n\n  return {\n    models: () => Promise.resolve({\n      presets: Object.entries(options.presets).map(([id, { label, endpoint, model }]): ModelProfile => ({ id, label, endpoint, model, source: 'preset' })),\n      roles: Object.fromEntries(MODEL_ROLES.map(role => [role, options.roles?.[role] ?? ids[0]!])) as Record<ModelRole, string>,\n    }),\n\n    complete: async (body, signal) => {\n      const { before, model } = parseBody(completeBodySchema, body)\n      return { text: await runCompletion(before, chatOn(model), signal) }\n    },\n\n    async* stream(path, body, signal) {\n      if (path === 'chat') throw new BackendError('Chat braucht einen Server (direct-ai)', 501)\n      const { task: taskId, model, ...input } = parseBody(generateBodySchema, body)\n      const stream = chatOn(model)\n      const task = AI_TASKS[taskId]\n      const problem = generateProblem(task, input)\n      if (problem) throw new BackendError(problem, 400)\n      const users = task.needsUsers ? await options.users?.() : undefined\n\n      // `runGenerate` turns a failed model call into an `error` event; a refused request (before the first delta) is\n      // rejected instead, like the server's non-2xx answer, so the caller can tell it from a failing stream.\n      let refused: BackendError | undefined\n      let started = false\n      const guarded: ChatStream = async function* (messages, streamSignal) {\n        try {\n          for await (const text of stream(messages, streamSignal)) {\n            started = true\n            yield text\n          }\n        }\n        catch (error) {\n          if (!started && error instanceof BackendError) refused = error\n          throw error\n        }\n      }\n      for await (const event of runGenerate(task, input, users, guarded, signal)) {\n        if (refused && !signal.aborted) throw refused\n        yield event\n      }\n    },\n\n    transcriptCleanup: async (body, signal) => {\n      const { segments, model } = parseBody(transcriptCleanupRequestSchema, body)\n      try {\n        return await runTranscriptCleanup(segments, chatOn(model), signal)\n      }\n      catch (error) {\n        throw error instanceof TranscriptCleanupUnreadableError ? new BackendError(error.message, 502, { cause: error }) : error\n      }\n    },\n\n    extract: () => Promise.reject(new BackendError('Extraktion braucht einen Server (direct-ai)', 501)),\n  }\n}\n"],"mappings":";;;;;;;;AAsCA,MAAM,mBAAmB;;AAGzB,SAAS,UAA+B,QAAW,MAA2B;CAC5E,MAAM,SAAS,OAAO,UAAU,IAAI;CACpC,IAAI,OAAO,SAAS,OAAO,OAAO;CAClC,MAAM,CAAC,SAAS,OAAO,MAAM;CAC7B,MAAM,IAAI,aAAa,oBAAoB,QAAQ,KAAK,CAAC,GAAG,MAAM,MAAM,MAAM,OAAO,CAAC,CAAC,KAAK,GAAG,MAAM,MAAM,KAAK,EAAE,OAAO,OAAO,MAAM,CAAC;AACzI;;AAGA,gBAAgB,QAAQ,MAA0D;CAChF,MAAM,SAAS,KAAK,UAAU;CAC9B,MAAM,UAAU,IAAI,YAAY;CAChC,IAAI,SAAS;CACb,IAAI;EACF,OAAO,MAAM;GACX,MAAM,EAAE,OAAO,SAAS,MAAM,OAAO,KAAK;GAC1C,IAAI,MAAM;GACV,UAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;GAChD,IAAI,UAAU,OAAO,QAAQ,IAAI;GACjC,OAAO,YAAY,IAAI;IACrB,MAAM,OAAO,OAAO,MAAM,GAAG,OAAO,CAAC,CAAC,QAAQ,OAAO,EAAE;IACvD,SAAS,OAAO,MAAM,UAAU,CAAC;IACjC,IAAI,KAAK,WAAW,OAAO,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK;IACvD,UAAU,OAAO,QAAQ,IAAI;GAC/B;EACF;EACA,MAAM,QAAQ,SAAS,QAAQ,OAAO,EAAA,CAAG,KAAK;EAC9C,IAAI,KAAK,WAAW,OAAO,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK;CACzD,UACQ;EACN,MAAM,OAAO,OAAO,CAAC,CAAC,YAAY,KAAA,CAAS;CAC7C;AACF;;;;;;AAUA,gBAAgB,WAAW,MAAoB,EAAE,UAAU,OAAO,UAAgE,UAAyB,QAA6C;CACtM,IAAI;CACJ,IAAI;EACF,WAAW,MAAM,KAAK,GAAG,SAAS,QAAQ,QAAQ,EAAE,EAAE,oBAAoB;GACxE,QAAQ;GACR,SAAS;IAAE,gBAAgB;IAAoB,UAAU;IAAqB,GAAI,SAAS,EAAE,eAAe,UAAU,SAAS,IAAI,CAAC;GAAG;GACvI,MAAM,KAAK,UAAU;IAAE;IAAO;IAAU,QAAQ;GAAK,CAAC;GACtD;EACF,CAAC;CACH,SACO,OAAO;EACZ,IAAI,OAAO,SAAS,MAAM;EAC1B,MAAM,IAAI,aAAa,iCAAiC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,IAAI,MAAM,GAAG,GAAG,GAAG,KAAK,EAAE,OAAO,MAAM,CAAC;CACvJ;CACA,IAAI,CAAC,SAAS,IAAI;EAChB,MAAM,UAAU,MAAM,SAAS,KAAK,CAAC,CAAC,YAAY,EAAE,EAAA,CAAG,MAAM,GAAG,gBAAgB;EAChF,MAAM,IAAI,aAAa,gBAAgB,CAAC,SAAS,QAAQ,UAAU,SAAS,UAAU,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG,KAAK,SAAS,MAAM;CACtI;CACA,IAAI,CAAC,SAAS,MAAM,MAAM,IAAI,aAAa,8BAA8B,GAAG;CAE5E,WAAW,MAAM,QAAQ,QAAQ,SAAS,IAAI,GAAG;EAC/C,IAAI,SAAS,UAAU;EACvB,IAAI;EACJ,IAAI;GACF,QAAQ,KAAK,MAAM,IAAI;EACzB,QACM;GACJ;EACF;EACA,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EACjD,IAAI,MAAM,OAAO;GACf,MAAM,UAAU,OAAO,MAAM,UAAU,WAAW,MAAM,QAAQ,MAAM,MAAM;GAC5E,MAAM,IAAI,MAAM,OAAO,YAAY,YAAY,UAAU,UAAU,+BAA+B;EACpG;EACA,MAAM,OAAO,MAAM,UAAU,EAAE,EAAE,OAAO;EACxC,IAAI,OAAO,SAAS,YAAY,MAAM,MAAM;CAC9C;AACF;;;;;;;;;;;;AAaA,SAAgB,eAAe,SAA4D;CACzF,MAAM,MAAM,OAAO,KAAK,QAAQ,OAAO;CACvC,IAAI,CAAC,IAAI,QAAQ,MAAM,IAAI,MAAM,kCAAkC;CACnE,MAAM,OAAO,QAAQ,SAAS;CAE9B,MAAM,WAAW,QAAkB;EACjC,IAAI,EAAE,YAAY,MAAM,OAAO;EAC/B,MAAM,SAAS,OAAO,OAAO,QAAQ,SAAS,IAAI,MAAM,IAAI,QAAQ,QAAQ,IAAI,UAAU,KAAA;EAC1F,IAAI,CAAC,QAAQ,MAAM,IAAI,aAAa,6BAA6B,GAAG;EACpE,OAAO;CACT;CACA,MAAM,UAAU,QAA8B;EAC5C,MAAM,QAAQ,QAAQ,GAAG;EACzB,QAAQ,UAAU,WAAW,WAAW,MAAM,OAAO,UAAU,MAAM;CACvE;CAEA,OAAO;EACL,cAAc,QAAQ,QAAQ;GAC5B,SAAS,OAAO,QAAQ,QAAQ,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,UAAU,cAA4B;IAAE;IAAI;IAAO;IAAU;IAAO,QAAQ;GAAS,EAAE;GACnJ,OAAO,OAAO,YAAY,YAAY,KAAI,SAAQ,CAAC,MAAM,QAAQ,QAAQ,SAAS,IAAI,EAAG,CAAC,CAAC;EAC7F,CAAC;EAED,UAAU,OAAO,MAAM,WAAW;GAChC,MAAM,EAAE,QAAQ,UAAU,UAAU,oBAAoB,IAAI;GAC5D,OAAO,EAAE,MAAM,MAAM,cAAc,QAAQ,OAAO,KAAK,GAAG,MAAM,EAAE;EACpE;EAEA,OAAO,OAAO,MAAM,MAAM,QAAQ;GAChC,IAAI,SAAS,QAAQ,MAAM,IAAI,aAAa,yCAAyC,GAAG;GACxF,MAAM,EAAE,MAAM,QAAQ,OAAO,GAAG,UAAU,UAAU,oBAAoB,IAAI;GAC5E,MAAM,SAAS,OAAO,KAAK;GAC3B,MAAM,OAAO,SAAS;GACtB,MAAM,UAAU,gBAAgB,MAAM,KAAK;GAC3C,IAAI,SAAS,MAAM,IAAI,aAAa,SAAS,GAAG;GAChD,MAAM,QAAQ,KAAK,aAAa,MAAM,QAAQ,QAAQ,IAAI,KAAA;GAI1D,IAAI;GACJ,IAAI,UAAU;GACd,MAAM,UAAsB,iBAAiB,UAAU,cAAc;IACnE,IAAI;KACF,WAAW,MAAM,QAAQ,OAAO,UAAU,YAAY,GAAG;MACvD,UAAU;MACV,MAAM;KACR;IACF,SACO,OAAO;KACZ,IAAI,CAAC,WAAW,iBAAiB,cAAc,UAAU;KACzD,MAAM;IACR;GACF;GACA,WAAW,MAAM,SAAS,YAAY,MAAM,OAAO,OAAO,SAAS,MAAM,GAAG;IAC1E,IAAI,WAAW,CAAC,OAAO,SAAS,MAAM;IACtC,MAAM;GACR;EACF;EAEA,mBAAmB,OAAO,MAAM,WAAW;GACzC,MAAM,EAAE,UAAU,UAAU,UAAU,gCAAgC,IAAI;GAC1E,IAAI;IACF,OAAO,MAAM,qBAAqB,UAAU,OAAO,KAAK,GAAG,MAAM;GACnE,SACO,OAAO;IACZ,MAAM,iBAAiB,mCAAmC,IAAI,aAAa,MAAM,SAAS,KAAK,EAAE,OAAO,MAAM,CAAC,IAAI;GACrH;EACF;EAEA,eAAe,QAAQ,OAAO,IAAI,aAAa,+CAA+C,GAAG,CAAC;CACpG;AACF"}

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

@@ -7,7 +7,7 @@ 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.
+   * Live collaboration: `true`, or `{ token }` for the token the collaboration server's `AccessControl.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`.
    */

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

@@ -1 +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"}
+{"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 `AccessControl.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/forge.d.ts

@@ -1,4 +1,4 @@
-import { AssetStore, CollabStateStore, EditorPorts, Identity, SettingsStore, ThemeStore } from "../server/ports.js";
+import { AccessControl, AssetStore, CollabStateStore, EditorPorts, SettingsStore, ThemeStore } from "../server/ports.js";
 import "../server/index.js";
 import { AdapterHooks } from "./shared.js";
 import { MarkdownDiagnostic, MarkdownPolicy } from "../markdown/policy.js";
@@ -39,7 +39,7 @@ export interface ForgeAdapterOptions extends Omit<AdapterHooks, 'authenticate'>
    */
   schema: AnyExtension[];
   /** The host's session check; there is no default for a host that owns its Markdown files. */
-  authenticate: Identity['authenticate'];
+  authenticate: AccessControl['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). */

package/dist/adapters/forge.js.map

@@ -1 +1 @@
-{"version":3,"file":"forge.js","names":[],"sources":["../../src/adapters/forge.ts"],"sourcesContent":["import { type AnyExtension, Editor } from '@tiptap/core'\nimport { DocumentMarkdown } from '../core'\nimport { contentToMarkdown, hasFatalDiagnostics, joinFrontmatter, type MarkdownDiagnostic, type MarkdownPolicy, markdownToContent, splitFrontmatter } from '../markdown'\nimport type { CollabStateStore, AssetStore, EditorPorts, Identity, SettingsStore, ThemeStore } from '../server'\nimport { type AdapterHooks, directoryOf, identityOf } from './shared'\n\n/** A Markdown file of the host, as the host stores it: the whole text with its frontmatter, and an opaque version of that file. */\nexport interface ForgeFile {\n  markdown: string\n  /** Changes whenever the file's content changes (mtime and size, a hash, a revision); no NUL character. Becomes `contentVersion`. */\n  version: string\n}\n\n/** Where the host keeps its Markdown documents. The adapter never touches a file system itself. */\nexport interface ForgeContent {\n  /** The file behind a document id, `null` = it does not exist. */\n  read(id: string): Promise<ForgeFile | null>\n  /** Writes the file (frontmatter included). Only called for documents that exist. */\n  write(id: string, markdown: string): Promise<void>\n  /** Called after every `write` the adapter made (change notifications, indexes). */\n  onWritten?(id: string): void | Promise<void>\n  /** Ids of all documents, for `listContents` (the tag index). Omitted: `listContents` is empty. */\n  list?(): Promise<string[]>\n}\n\n/** 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). */\nexport interface ForgeState {\n  collabState: CollabStateStore\n  assets: AssetStore\n  settings?: SettingsStore\n  themes?: ThemeStore\n}\n\nexport interface ForgeAdapterOptions extends Omit<AdapterHooks, 'authenticate'> {\n  content: ForgeContent\n  state: ForgeState\n  /**\n   * The complete TipTap extension list of the Markdown conversion, e.g. `[...advancedSchemaExtensions(), MermaidBlock]`:\n   * nodes and marks with their Markdown handlers. Host nodes also go to the collaboration schema through the server's\n   * `schema` option (`() => [...advancedSchemaExtensions(), MermaidBlock]`).\n   */\n  schema: AnyExtension[]\n  /** The host's session check; there is no default for a host that owns its Markdown files. */\n  authenticate: Identity['authenticate']\n  /** Markdown policy of the conversion (raw HTML, data URLs); the default drops both. */\n  policy?: MarkdownPolicy\n  /** Called with the diagnostics of every load that produced some (dropped HTML or URLs, unknown fences kept verbatim). */\n  onDiagnostics?(id: string, diagnostics: MarkdownDiagnostic[]): void\n}\n\n/**\n * The editor's adapter over the host's Markdown files (concept documents, vault pages). The host keeps owning the\n * files, their locations, change notifications and access rules and passes them in as functions; this adapter does the\n * Markdown ↔ TipTap JSON conversion and the contract:\n *\n * - `loadContent` splits off the frontmatter and parses the body (`markdownToContent`); a body the conversion could not\n *   keep intact (unclosed fence, malformed fence metadata) is refused with an error instead of loaded lossy.\n * - `storeContent` re-reads the file, keeps its current frontmatter verbatim, writes the serialized body and calls\n *   `onWritten`. A file that is gone is not recreated, and an unchanged result is not rewritten.\n * - `contentVersion` is the file's own version, read after the write so it reflects what the editor stored.\n *\n * Yjs state, assets and settings are `state`'s. The converter is one headless editor per adapter, built on first use.\n */\nexport function createForgeAdapter(options: ForgeAdapterOptions): EditorPorts {\n  const { content, state, schema, policy, onDiagnostics, authenticate, authorize } = options\n\n  let converter: Editor | undefined\n  // No `window` is needed as long as the editor starts from JSON content, not an HTML string.\n  const editor = () => converter ??= new Editor({ content: { type: 'doc', content: [{ type: 'paragraph' }] }, extensions: [DocumentMarkdown, ...schema] })\n\n  function parse(id: string, file: ForgeFile) {\n    const { content: json, diagnostics } = markdownToContent(editor(), splitFrontmatter(file.markdown).body, policy ? { policy } : {})\n    if (diagnostics.length) onDiagnostics?.(id, diagnostics)\n    if (hasFatalDiagnostics(diagnostics)) {\n      const problems = diagnostics.filter(diagnostic => diagnostic.severity === 'error').map(diagnostic => diagnostic.message)\n      throw new Error(`@ecsplico/editor: document \"${id}\" cannot be converted without losing content: ${problems.join(' ')}`)\n    }\n    return json\n  }\n\n  return {\n    identity: identityOf({ authenticate, authorize }),\n    directory: directoryOf(options),\n\n    documents: {\n      async loadContent(id) {\n        const file = await content.read(id)\n        return file && parse(id, file)\n      },\n      async storeContent(id, json) {\n        const current = await content.read(id)\n        if (!current) return // deleted while a store was pending\n        const instance = editor()\n        instance.commands.setContent(json, { emitUpdate: false })\n        const body = contentToMarkdown(instance)\n        const markdown = joinFrontmatter(splitFrontmatter(current.markdown).frontmatter, body && `${body}\\n`)\n        if (markdown === current.markdown) return\n        await content.write(id, markdown)\n        await content.onWritten?.(id)\n      },\n      async contentVersion(id) {\n        return (await content.read(id))?.version ?? null\n      },\n      async listContents() {\n        const entries = await Promise.all((await content.list?.() ?? []).map(async (id) => {\n          const file = await content.read(id)\n          return file && { id, content: parse(id, file) }\n        }))\n        return entries.filter((entry): entry is NonNullable<typeof entry> => entry !== null)\n      },\n    },\n\n    collabState: state.collabState,\n    assets: state.assets,\n    // Present only when `state` has them: the routes and the settings client test for the ports.\n    ...(state.settings && { settings: state.settings }),\n    ...(state.themes && { themes: state.themes }),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA+DA,SAAgB,mBAAmB,SAA2C;CAC5E,MAAM,EAAE,SAAS,OAAO,QAAQ,QAAQ,eAAe,cAAc,cAAc;CAEnF,IAAI;CAEJ,MAAM,eAAe,cAAc,IAAI,OAAO;EAAE,SAAS;GAAE,MAAM;GAAO,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC;EAAE;EAAG,YAAY,CAAC,kBAAkB,GAAG,MAAM;CAAE,CAAC;CAEvJ,SAAS,MAAM,IAAY,MAAiB;EAC1C,MAAM,EAAE,SAAS,MAAM,gBAAgB,kBAAkB,OAAO,GAAG,iBAAiB,KAAK,QAAQ,CAAC,CAAC,MAAM,SAAS,EAAE,OAAO,IAAI,CAAC,CAAC;EACjI,IAAI,YAAY,QAAQ,gBAAgB,IAAI,WAAW;EACvD,IAAI,oBAAoB,WAAW,GAAG;GACpC,MAAM,WAAW,YAAY,QAAO,eAAc,WAAW,aAAa,OAAO,CAAC,CAAC,KAAI,eAAc,WAAW,OAAO;GACvH,MAAM,IAAI,MAAM,+BAA+B,GAAG,gDAAgD,SAAS,KAAK,GAAG,GAAG;EACxH;EACA,OAAO;CACT;CAEA,OAAO;EACL,UAAU,WAAW;GAAE;GAAc;EAAU,CAAC;EAChD,WAAW,YAAY,OAAO;EAE9B,WAAW;GACT,MAAM,YAAY,IAAI;IACpB,MAAM,OAAO,MAAM,QAAQ,KAAK,EAAE;IAClC,OAAO,QAAQ,MAAM,IAAI,IAAI;GAC/B;GACA,MAAM,aAAa,IAAI,MAAM;IAC3B,MAAM,UAAU,MAAM,QAAQ,KAAK,EAAE;IACrC,IAAI,CAAC,SAAS;IACd,MAAM,WAAW,OAAO;IACxB,SAAS,SAAS,WAAW,MAAM,EAAE,YAAY,MAAM,CAAC;IACxD,MAAM,OAAO,kBAAkB,QAAQ;IACvC,MAAM,WAAW,gBAAgB,iBAAiB,QAAQ,QAAQ,CAAC,CAAC,aAAa,QAAQ,GAAG,KAAK,GAAG;IACpG,IAAI,aAAa,QAAQ,UAAU;IACnC,MAAM,QAAQ,MAAM,IAAI,QAAQ;IAChC,MAAM,QAAQ,YAAY,EAAE;GAC9B;GACA,MAAM,eAAe,IAAI;IACvB,QAAQ,MAAM,QAAQ,KAAK,EAAE,EAAA,EAAI,WAAW;GAC9C;GACA,MAAM,eAAe;IAKnB,QAAO,MAJe,QAAQ,KAAK,MAAM,QAAQ,OAAO,KAAK,CAAC,EAAA,CAAG,IAAI,OAAO,OAAO;KACjF,MAAM,OAAO,MAAM,QAAQ,KAAK,EAAE;KAClC,OAAO,QAAQ;MAAE;MAAI,SAAS,MAAM,IAAI,IAAI;KAAE;IAChD,CAAC,CAAC,EAAA,CACa,QAAQ,UAA8C,UAAU,IAAI;GACrF;EACF;EAEA,aAAa,MAAM;EACnB,QAAQ,MAAM;EAEd,GAAI,MAAM,YAAY,EAAE,UAAU,MAAM,SAAS;EACjD,GAAI,MAAM,UAAU,EAAE,QAAQ,MAAM,OAAO;CAC7C;AACF"}
+{"version":3,"file":"forge.js","names":[],"sources":["../../src/adapters/forge.ts"],"sourcesContent":["import { type AnyExtension, Editor } from '@tiptap/core'\nimport { DocumentMarkdown } from '../core'\nimport { contentToMarkdown, hasFatalDiagnostics, joinFrontmatter, type MarkdownDiagnostic, type MarkdownPolicy, markdownToContent, splitFrontmatter } from '../markdown'\nimport type { AccessControl, CollabStateStore, AssetStore, EditorPorts, SettingsStore, ThemeStore } from '../server'\nimport { type AdapterHooks, directoryOf, identityOf } from './shared'\n\n/** A Markdown file of the host, as the host stores it: the whole text with its frontmatter, and an opaque version of that file. */\nexport interface ForgeFile {\n  markdown: string\n  /** Changes whenever the file's content changes (mtime and size, a hash, a revision); no NUL character. Becomes `contentVersion`. */\n  version: string\n}\n\n/** Where the host keeps its Markdown documents. The adapter never touches a file system itself. */\nexport interface ForgeContent {\n  /** The file behind a document id, `null` = it does not exist. */\n  read(id: string): Promise<ForgeFile | null>\n  /** Writes the file (frontmatter included). Only called for documents that exist. */\n  write(id: string, markdown: string): Promise<void>\n  /** Called after every `write` the adapter made (change notifications, indexes). */\n  onWritten?(id: string): void | Promise<void>\n  /** Ids of all documents, for `listContents` (the tag index). Omitted: `listContents` is empty. */\n  list?(): Promise<string[]>\n}\n\n/** 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). */\nexport interface ForgeState {\n  collabState: CollabStateStore\n  assets: AssetStore\n  settings?: SettingsStore\n  themes?: ThemeStore\n}\n\nexport interface ForgeAdapterOptions extends Omit<AdapterHooks, 'authenticate'> {\n  content: ForgeContent\n  state: ForgeState\n  /**\n   * The complete TipTap extension list of the Markdown conversion, e.g. `[...advancedSchemaExtensions(), MermaidBlock]`:\n   * nodes and marks with their Markdown handlers. Host nodes also go to the collaboration schema through the server's\n   * `schema` option (`() => [...advancedSchemaExtensions(), MermaidBlock]`).\n   */\n  schema: AnyExtension[]\n  /** The host's session check; there is no default for a host that owns its Markdown files. */\n  authenticate: AccessControl['authenticate']\n  /** Markdown policy of the conversion (raw HTML, data URLs); the default drops both. */\n  policy?: MarkdownPolicy\n  /** Called with the diagnostics of every load that produced some (dropped HTML or URLs, unknown fences kept verbatim). */\n  onDiagnostics?(id: string, diagnostics: MarkdownDiagnostic[]): void\n}\n\n/**\n * The editor's adapter over the host's Markdown files (concept documents, vault pages). The host keeps owning the\n * files, their locations, change notifications and access rules and passes them in as functions; this adapter does the\n * Markdown ↔ TipTap JSON conversion and the contract:\n *\n * - `loadContent` splits off the frontmatter and parses the body (`markdownToContent`); a body the conversion could not\n *   keep intact (unclosed fence, malformed fence metadata) is refused with an error instead of loaded lossy.\n * - `storeContent` re-reads the file, keeps its current frontmatter verbatim, writes the serialized body and calls\n *   `onWritten`. A file that is gone is not recreated, and an unchanged result is not rewritten.\n * - `contentVersion` is the file's own version, read after the write so it reflects what the editor stored.\n *\n * Yjs state, assets and settings are `state`'s. The converter is one headless editor per adapter, built on first use.\n */\nexport function createForgeAdapter(options: ForgeAdapterOptions): EditorPorts {\n  const { content, state, schema, policy, onDiagnostics, authenticate, authorize } = options\n\n  let converter: Editor | undefined\n  // No `window` is needed as long as the editor starts from JSON content, not an HTML string.\n  const editor = () => converter ??= new Editor({ content: { type: 'doc', content: [{ type: 'paragraph' }] }, extensions: [DocumentMarkdown, ...schema] })\n\n  function parse(id: string, file: ForgeFile) {\n    const { content: json, diagnostics } = markdownToContent(editor(), splitFrontmatter(file.markdown).body, policy ? { policy } : {})\n    if (diagnostics.length) onDiagnostics?.(id, diagnostics)\n    if (hasFatalDiagnostics(diagnostics)) {\n      const problems = diagnostics.filter(diagnostic => diagnostic.severity === 'error').map(diagnostic => diagnostic.message)\n      throw new Error(`@ecsplico/editor: document \"${id}\" cannot be converted without losing content: ${problems.join(' ')}`)\n    }\n    return json\n  }\n\n  return {\n    identity: identityOf({ authenticate, authorize }),\n    directory: directoryOf(options),\n\n    documents: {\n      async loadContent(id) {\n        const file = await content.read(id)\n        return file && parse(id, file)\n      },\n      async storeContent(id, json) {\n        const current = await content.read(id)\n        if (!current) return // deleted while a store was pending\n        const instance = editor()\n        instance.commands.setContent(json, { emitUpdate: false })\n        const body = contentToMarkdown(instance)\n        const markdown = joinFrontmatter(splitFrontmatter(current.markdown).frontmatter, body && `${body}\\n`)\n        if (markdown === current.markdown) return\n        await content.write(id, markdown)\n        await content.onWritten?.(id)\n      },\n      async contentVersion(id) {\n        return (await content.read(id))?.version ?? null\n      },\n      async listContents() {\n        const entries = await Promise.all((await content.list?.() ?? []).map(async (id) => {\n          const file = await content.read(id)\n          return file && { id, content: parse(id, file) }\n        }))\n        return entries.filter((entry): entry is NonNullable<typeof entry> => entry !== null)\n      },\n    },\n\n    collabState: state.collabState,\n    assets: state.assets,\n    // Present only when `state` has them: the routes and the settings client test for the ports.\n    ...(state.settings && { settings: state.settings }),\n    ...(state.themes && { themes: state.themes }),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA+DA,SAAgB,mBAAmB,SAA2C;CAC5E,MAAM,EAAE,SAAS,OAAO,QAAQ,QAAQ,eAAe,cAAc,cAAc;CAEnF,IAAI;CAEJ,MAAM,eAAe,cAAc,IAAI,OAAO;EAAE,SAAS;GAAE,MAAM;GAAO,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC;EAAE;EAAG,YAAY,CAAC,kBAAkB,GAAG,MAAM;CAAE,CAAC;CAEvJ,SAAS,MAAM,IAAY,MAAiB;EAC1C,MAAM,EAAE,SAAS,MAAM,gBAAgB,kBAAkB,OAAO,GAAG,iBAAiB,KAAK,QAAQ,CAAC,CAAC,MAAM,SAAS,EAAE,OAAO,IAAI,CAAC,CAAC;EACjI,IAAI,YAAY,QAAQ,gBAAgB,IAAI,WAAW;EACvD,IAAI,oBAAoB,WAAW,GAAG;GACpC,MAAM,WAAW,YAAY,QAAO,eAAc,WAAW,aAAa,OAAO,CAAC,CAAC,KAAI,eAAc,WAAW,OAAO;GACvH,MAAM,IAAI,MAAM,+BAA+B,GAAG,gDAAgD,SAAS,KAAK,GAAG,GAAG;EACxH;EACA,OAAO;CACT;CAEA,OAAO;EACL,UAAU,WAAW;GAAE;GAAc;EAAU,CAAC;EAChD,WAAW,YAAY,OAAO;EAE9B,WAAW;GACT,MAAM,YAAY,IAAI;IACpB,MAAM,OAAO,MAAM,QAAQ,KAAK,EAAE;IAClC,OAAO,QAAQ,MAAM,IAAI,IAAI;GAC/B;GACA,MAAM,aAAa,IAAI,MAAM;IAC3B,MAAM,UAAU,MAAM,QAAQ,KAAK,EAAE;IACrC,IAAI,CAAC,SAAS;IACd,MAAM,WAAW,OAAO;IACxB,SAAS,SAAS,WAAW,MAAM,EAAE,YAAY,MAAM,CAAC;IACxD,MAAM,OAAO,kBAAkB,QAAQ;IACvC,MAAM,WAAW,gBAAgB,iBAAiB,QAAQ,QAAQ,CAAC,CAAC,aAAa,QAAQ,GAAG,KAAK,GAAG;IACpG,IAAI,aAAa,QAAQ,UAAU;IACnC,MAAM,QAAQ,MAAM,IAAI,QAAQ;IAChC,MAAM,QAAQ,YAAY,EAAE;GAC9B;GACA,MAAM,eAAe,IAAI;IACvB,QAAQ,MAAM,QAAQ,KAAK,EAAE,EAAA,EAAI,WAAW;GAC9C;GACA,MAAM,eAAe;IAKnB,QAAO,MAJe,QAAQ,KAAK,MAAM,QAAQ,OAAO,KAAK,CAAC,EAAA,CAAG,IAAI,OAAO,OAAO;KACjF,MAAM,OAAO,MAAM,QAAQ,KAAK,EAAE;KAClC,OAAO,QAAQ;MAAE;MAAI,SAAS,MAAM,IAAI,IAAI;KAAE;IAChD,CAAC,CAAC,EAAA,CACa,QAAQ,UAA8C,UAAU,IAAI;GACrF;EACF;EAEA,aAAa,MAAM;EACnB,QAAQ,MAAM;EAEd,GAAI,MAAM,YAAY,EAAE,UAAU,MAAM,SAAS;EACjD,GAAI,MAAM,UAAU,EAAE,QAAQ,MAAM,OAAO;CAC7C;AACF"}

package/dist/adapters/nitro.d.ts

@@ -1,6 +1,8 @@
 import { AiModels, AiModelsConfig } from "../server/ai.js";
 import { EditorPorts } from "../server/ports.js";
 import { CollabServer, CollabServerOptions } from "../server/collab.js";
+import { BlockType } from "../features/composites/block-types.js";
+import "../features/composites/schema.js";
 import { RateLimiterOptions } from "../server/rate-limit.js";
 import "../server/index.js";
 import { RouteDef } from "../server/routes.js";
@@ -15,12 +17,12 @@ export interface NitroHost {
   };
 }
 export interface EditorServerOptions {
-  /** Identity, storage and everything else the backend serves, one port per capability: a route is mounted only when its port is present. A documents port that also manages documents (`json`, `drizzle`) lets `PUT /api/editor/documents/:id` create them; the `comments` port mounts the comments endpoint, `models` the host's language models. */
+  /** Access control, storage and everything else the backend serves, one port per capability: a route is mounted only when its port is present. A documents port that also manages documents (`json`, `drizzle`) lets `PUT /api/editor/documents/:id` create them; the `comments` port mounts the comments endpoint, `models` the host's language models. */
   ports: EditorPorts;
   /**
    * The collaboration websocket (`/collab/:id`). Schema, hooks and Hocuspocus configuration of `createCollabServer`;
    * `{}` takes everything from the ports (the `collabState` port is required). `false` mounts no websocket (documents then only load and save over HTTP).
-   * `authenticateUpgrade`: authenticate the upgrade request itself (`Identity.authenticate` with its headers; cookies,
+   * `authenticateUpgrade`: authenticate the upgrade request itself (`AccessControl.authenticate` with its headers; cookies,
    * not the provider's `token`) and refuse it with HTTP 401, instead of closing an unauthenticated socket with 4401
    * after the upgrade; the user then travels with the connection and is not authenticated a second time.
    * Needs `experimental: { websocket: true }` in the Nitro config.
@@ -29,7 +31,7 @@ export interface EditorServerOptions {
     authenticateUpgrade?: boolean;
   }) | false;
   /**
-   * Mounts the AI endpoints (`/api/ai/*`): presets, shared key, transcription, slots of `createAiModels`; `languageModel`
+   * Mounts the AI endpoints (`/api/ai/*`): presets, shared key, transcription, model roles of `createAiModels`; `languageModel`
    * and `listModels` default to those of the `models` port. Omitted: no AI routes.
    */
   ai?: Partial<AiModelsConfig>;
@@ -39,6 +41,12 @@ export interface EditorServerOptions {
   routes?: (routes: readonly RouteDef[]) => readonly RouteDef[];
   /** The collaboration schema (see `CollabServerOptions.schema`); default `advancedSchemaExtensions()`, host nodes: `() => [...advancedSchemaExtensions(), Callout]`. */
   schema?: () => AnyExtension[];
+  /**
+   * The host's Block types (the list its editors get through the `blockTypes` option, e.g. `mergeBlockTypes(defaultBlockTypes(t), parseBlockTypes(file))`),
+   * so the server resolves them without the client repeating them. The AI chat (`POST /api/ai/chat`) describes these to the model and ignores the
+   * `blockTypes` in the request. Omitted: the chat takes the `blockTypes` the client sends. The collaboration schema does not need them (Block types are storage, not schema).
+   */
+  blockTypes?: readonly BlockType[];
 }
 export interface EditorServer {
   ports: EditorPorts;

package/dist/adapters/nitro.js

@@ -75,7 +75,8 @@ function installEditorServer(nitroApp, options) {
 	const aiContext = models && limiter && {
 		...context,
 		ai: models,
-		limiter
+		limiter,
+		...options.blockTypes && { blockTypes: options.blockTypes }
 	};
 	const mounted = serverRoutesOf(ports, { ai: aiContext !== void 0 });
 	for (const route of options.routes ? options.routes(mounted) : mounted) {
@@ -86,6 +87,7 @@ function installEditorServer(nitroApp, options) {
 	const release = adoptEditorServer({
 		ports,
 		schema,
+		blockTypes: options.blockTypes,
 		collab,
 		models,
 		limiter

package/dist/adapters/nitro.js.map

@@ -1 +1 @@
-{"version":3,"file":"nitro.js","names":[],"sources":["../../src/adapters/nitro.ts"],"sourcesContent":["import type { AnyExtension } from '@tiptap/core'\nimport { type AiModels, type AiModelsConfig, type CollabConnection, type CollabServer, type CollabServerOptions, createAiModels, createCollabServer, createRateLimiter, type EditorPorts, type RateLimiter, type RateLimiterOptions } from '../server'\nimport { defineEditorConfig } from '../config'\nimport { routeOf } from '../server/h3'\nimport type { AiHandlerContext, HandlerContext } from '../server/handlers'\nimport { adoptEditorServer } from '../server/host'\nimport { type RouteDef, serverRoutesOf } from '../server/routes'\nimport { defineWebSocketHandler, type Router } from 'h3'\nimport { COLLAB_PATH } from '../core/api-routes'\n\n// The editor backend on a Nitro app: the routes the ports can serve (`serverRoutesOf`: settings, users, tags, assets,\n// themes, documents, comments, the optional AI endpoints) and the collaboration websocket, registered in one call from a\n// Nitro plugin. One installer serves both hosts: a plain Nitro app (nitropack 2) calls it from its own plugin, the\n// Nuxt module (`@ecsplico/editor/nuxt`) from its server plugin. Both end in the same `@ecsplico/editor/server/handlers`.\n\n/** The part of a Nitro app this entry uses; `nitroApp` of a Nitro plugin fits. */\nexport interface NitroHost {\n  router: Pick<Router, 'add' | 'use'>\n  hooks: { hook(name: 'close', listener: () => void | Promise<void>): unknown }\n}\n\n/** The route type of the table `EditorServerOptions.routes` filters. */\nexport type { RouteDef }\n\nexport interface EditorServerOptions {\n  /** Identity, storage and everything else the backend serves, one port per capability: a route is mounted only when its port is present. A documents port that also manages documents (`json`, `drizzle`) lets `PUT /api/editor/documents/:id` create them; the `comments` port mounts the comments endpoint, `models` the host's language models. */\n  ports: EditorPorts\n  /**\n   * The collaboration websocket (`/collab/:id`). Schema, hooks and Hocuspocus configuration of `createCollabServer`;\n   * `{}` takes everything from the ports (the `collabState` port is required). `false` mounts no websocket (documents then only load and save over HTTP).\n   * `authenticateUpgrade`: authenticate the upgrade request itself (`Identity.authenticate` with its headers; cookies,\n   * not the provider's `token`) and refuse it with HTTP 401, instead of closing an unauthenticated socket with 4401\n   * after the upgrade; the user then travels with the connection and is not authenticated a second time.\n   * Needs `experimental: { websocket: true }` in the Nitro config.\n   */\n  collab: (Omit<CollabServerOptions, 'ports'> & { authenticateUpgrade?: boolean }) | false\n  /**\n   * Mounts the AI endpoints (`/api/ai/*`): presets, shared key, transcription, slots of `createAiModels`; `languageModel`\n   * and `listModels` default to those of the `models` port. Omitted: no AI routes.\n   */\n  ai?: Partial<AiModelsConfig>\n  /** Per-user limit of the AI endpoints; default: that of `defineEditorConfig` (30 requests per minute). */\n  rateLimit?: RateLimiterOptions\n  /** Filters or reorders the routes before they are mounted (a host that serves `/api/editor/assets/*` itself drops them); default: all. Receives what `serverRoutesOf(ports, { ai })` returns, so a route of an absent port, or an AI route without the `ai` option, is not in it. */\n  routes?: (routes: readonly RouteDef[]) => readonly RouteDef[]\n  /** The collaboration schema (see `CollabServerOptions.schema`); default `advancedSchemaExtensions()`, host nodes: `() => [...advancedSchemaExtensions(), Callout]`. */\n  schema?: () => AnyExtension[]\n}\n\nexport interface EditorServer {\n  ports: EditorPorts\n  /** The collaboration server, `undefined` with `collab: false`. */\n  collab: CollabServer | undefined\n  /** The AI models, `undefined` without `ai`. */\n  models: AiModels | undefined\n  /** Writes pending collaboration stores and disconnects every client. Nitro's `close` hook calls it. */\n  close(): Promise<void>\n}\n\ntype CollabPeer = { _hocuspocus?: CollabConnection }\n\n// Same crossws wiring as Hocuspocus' own Server; the document name comes from the provider's `name`. By default the user\n// is authenticated in Hocuspocus' `onAuthenticate` (cookie headers of the upgrade request or the provider's `token`), so\n// the upgrade always succeeds and an unauthenticated socket is closed with 4401 afterwards. With `authenticateUpgrade` the\n// upgrade request itself is authenticated (headers only) and refused with HTTP 401.\nconst collabRoute = (collab: CollabServer, ports: EditorPorts, authenticateUpgrade: boolean) => defineWebSocketHandler({\n  async upgrade(request) {\n    if (!authenticateUpgrade) return\n    const user = await ports.identity.authenticate({ headers: request.headers })\n    // No body: crossws' node adapter writes the response headers percent-encoded, which would mangle an automatic `content-type`.\n    if (!user) return new Response(null, { status: 401, statusText: 'Unauthorized' })\n    // crossws creates the context before it calls the hook (its type is optional only for other callers); `open` reads it as `peer.context`.\n    request.context!.user = user\n  },\n  open(peer) {\n    const user = peer.context.user as object | undefined\n    ;(peer as unknown as CollabPeer)._hocuspocus = collab.handleConnection(peer.websocket as unknown as Parameters<CollabServer['handleConnection']>[0], peer.request as Request, user && { user })\n  },\n  message(peer, message) {\n    ;(peer as unknown as CollabPeer)._hocuspocus?.handleMessage(message.uint8Array())\n  },\n  close(peer, details) {\n    ;(peer as unknown as CollabPeer)._hocuspocus?.handleClose({ code: details.code ?? 1000, reason: details.reason ?? '' } as CloseEvent)\n  },\n  error(peer, error) {\n    console.error('[collab]', peer.id, error)\n  },\n})\n\n/**\n * Wires the editor backend into `nitroApp` (call it from a Nitro plugin):\n *\n *     /api/editor/{capabilities,settings,users,tags,assets/…,themes/…}   the editor's own endpoints, each with its port; `capabilities` lists what is served\n *     /api/editor/documents/:id                              GET/PUT a document's TipTap JSON (what `useEditorDocument` uses)\n *     /api/editor/comments/:id                               GET/POST comments, with `ports.comments`\n *     /api/ai/{models,chat,complete,generate,extract,transcript-cleanup}   with `ai`\n *     /collab/:id                                            the collaboration websocket, unless `collab: false`\n *\n * Every route authenticates through `ports.identity.authenticate`. The collaboration server is closed with Nitro's `close`\n * hook. The installed server is also the process-wide one of `@ecsplico/editor/server` (`useCollabServer`, `useAiModels`,\n * `liveContent`, …) until it closes. The paths are the ones the editor's client (`createHttpBackend`) calls.\n */\nexport function installEditorServer(nitroApp: NitroHost, options: EditorServerOptions): EditorServer {\n  const { ports, schema } = options\n  const { authenticateUpgrade = false, ...collabOptions }: Exclude<EditorServerOptions['collab'], false> = options.collab || {}\n  const collab = options.collab === false ? undefined : createCollabServer({ ports, ...(schema && { schema }), ...collabOptions })\n  const provider = ports.models\n  const models = options.ai && createAiModels({\n    presets: {},\n    languageModel: provider?.languageModel && ((ref, user) => provider.languageModel!(ref, user)),\n    listModels: provider?.listModels && (user => provider.listModels!(user)),\n    ...options.ai,\n  })\n  const limiter: RateLimiter | undefined = models && createRateLimiter(options.rateLimit ?? defineEditorConfig().ai.rateLimit)\n\n  const context: HandlerContext = { ports, ...(collab && { collab }), served: { ai: models !== undefined, collaboration: collab !== undefined } }\n  const aiContext: AiHandlerContext | undefined = models && limiter && { ...context, ai: models, limiter }\n  const mounted = serverRoutesOf(ports, { ai: aiContext !== undefined })\n  for (const route of options.routes ? options.routes(mounted) : mounted) {\n    // `serverRoutesOf` returns the AI routes only with `ai`, so `aiContext` is set for them.\n    const handler = route.port === 'ai' ? routeOf(aiContext!, route.handler) : routeOf(context, route.handler)\n    nitroApp.router.add(route.path, handler, route.method)\n  }\n  // No method: the websocket upgrade resolves its handler by path only.\n  if (collab) nitroApp.router.use(`${COLLAB_PATH}/:id`, collabRoute(collab, ports, authenticateUpgrade))\n\n  const release = adoptEditorServer({ ports, schema, collab, models, limiter })\n  const server: EditorServer = {\n    ports,\n    collab,\n    models,\n    async close() {\n      await collab?.close()\n      release()\n    },\n  }\n  nitroApp.hooks.hook('close', () => server.close())\n  return server\n}\n"],"mappings":";;;;;;;;;;AAiEA,MAAM,eAAe,QAAsB,OAAoB,wBAAiC,uBAAuB;CACrH,MAAM,QAAQ,SAAS;EACrB,IAAI,CAAC,qBAAqB;EAC1B,MAAM,OAAO,MAAM,MAAM,SAAS,aAAa,EAAE,SAAS,QAAQ,QAAQ,CAAC;EAE3E,IAAI,CAAC,MAAM,OAAO,IAAI,SAAS,MAAM;GAAE,QAAQ;GAAK,YAAY;EAAe,CAAC;EAEhF,QAAQ,QAAS,OAAO;CAC1B;CACA,KAAK,MAAM;EACT,MAAM,OAAO,KAAK,QAAQ;EACzB,KAAgC,cAAc,OAAO,iBAAiB,KAAK,WAAyE,KAAK,SAAoB,QAAQ,EAAE,KAAK,CAAC;CAChM;CACA,QAAQ,MAAM,SAAS;EACpB,KAAgC,aAAa,cAAc,QAAQ,WAAW,CAAC;CAClF;CACA,MAAM,MAAM,SAAS;EAClB,KAAgC,aAAa,YAAY;GAAE,MAAM,QAAQ,QAAQ;GAAM,QAAQ,QAAQ,UAAU;EAAG,CAAe;CACtI;CACA,MAAM,MAAM,OAAO;EACjB,QAAQ,MAAM,YAAY,KAAK,IAAI,KAAK;CAC1C;AACF,CAAC;;;;;;;;;;;;;;AAeD,SAAgB,oBAAoB,UAAqB,SAA4C;CACnG,MAAM,EAAE,OAAO,WAAW;CAC1B,MAAM,EAAE,sBAAsB,OAAO,GAAG,kBAAiE,QAAQ,UAAU,CAAC;CAC5H,MAAM,SAAS,QAAQ,WAAW,QAAQ,KAAA,IAAY,mBAAmB;EAAE;EAAO,GAAI,UAAU,EAAE,OAAO;EAAI,GAAG;CAAc,CAAC;CAC/H,MAAM,WAAW,MAAM;CACvB,MAAM,SAAS,QAAQ,MAAM,eAAe;EAC1C,SAAS,CAAC;EACV,eAAe,UAAU,mBAAmB,KAAK,SAAS,SAAS,cAAe,KAAK,IAAI;EAC3F,YAAY,UAAU,gBAAe,SAAQ,SAAS,WAAY,IAAI;EACtE,GAAG,QAAQ;CACb,CAAC;CACD,MAAM,UAAmC,UAAU,kBAAkB,QAAQ,aAAa,mBAAmB,CAAC,CAAC,GAAG,SAAS;CAE3H,MAAM,UAA0B;EAAE;EAAO,GAAI,UAAU,EAAE,OAAO;EAAI,QAAQ;GAAE,IAAI,WAAW,KAAA;GAAW,eAAe,WAAW,KAAA;EAAU;CAAE;CAC9I,MAAM,YAA0C,UAAU,WAAW;EAAE,GAAG;EAAS,IAAI;EAAQ;CAAQ;CACvG,MAAM,UAAU,eAAe,OAAO,EAAE,IAAI,cAAc,KAAA,EAAU,CAAC;CACrE,KAAK,MAAM,SAAS,QAAQ,SAAS,QAAQ,OAAO,OAAO,IAAI,SAAS;EAEtE,MAAM,UAAU,MAAM,SAAS,OAAO,QAAQ,WAAY,MAAM,OAAO,IAAI,QAAQ,SAAS,MAAM,OAAO;EACzG,SAAS,OAAO,IAAI,MAAM,MAAM,SAAS,MAAM,MAAM;CACvD;CAEA,IAAI,QAAQ,SAAS,OAAO,IAAI,GAAG,YAAY,OAAO,YAAY,QAAQ,OAAO,mBAAmB,CAAC;CAErG,MAAM,UAAU,kBAAkB;EAAE;EAAO;EAAQ;EAAQ;EAAQ;CAAQ,CAAC;CAC5E,MAAM,SAAuB;EAC3B;EACA;EACA;EACA,MAAM,QAAQ;GACZ,MAAM,QAAQ,MAAM;GACpB,QAAQ;EACV;CACF;CACA,SAAS,MAAM,KAAK,eAAe,OAAO,MAAM,CAAC;CACjD,OAAO;AACT"}
+{"version":3,"file":"nitro.js","names":[],"sources":["../../src/adapters/nitro.ts"],"sourcesContent":["import type { AnyExtension } from '@tiptap/core'\nimport type { BlockType } from '../features/composites/schema'\nimport { type AiModels, type AiModelsConfig, type CollabConnection, type CollabServer, type CollabServerOptions, createAiModels, createCollabServer, createRateLimiter, type EditorPorts, type RateLimiter, type RateLimiterOptions } from '../server'\nimport { defineEditorConfig } from '../config'\nimport { routeOf } from '../server/h3'\nimport type { AiHandlerContext, HandlerContext } from '../server/handlers'\nimport { adoptEditorServer } from '../server/host'\nimport { type RouteDef, serverRoutesOf } from '../server/routes'\nimport { defineWebSocketHandler, type Router } from 'h3'\nimport { COLLAB_PATH } from '../core/api-routes'\n\n// The editor backend on a Nitro app: the routes the ports can serve (`serverRoutesOf`: settings, users, tags, assets,\n// themes, documents, comments, the optional AI endpoints) and the collaboration websocket, registered in one call from a\n// Nitro plugin. One installer serves both hosts: a plain Nitro app (nitropack 2) calls it from its own plugin, the\n// Nuxt module (`@ecsplico/editor/nuxt`) from its server plugin. Both end in the same `@ecsplico/editor/server/handlers`.\n\n/** The part of a Nitro app this entry uses; `nitroApp` of a Nitro plugin fits. */\nexport interface NitroHost {\n  router: Pick<Router, 'add' | 'use'>\n  hooks: { hook(name: 'close', listener: () => void | Promise<void>): unknown }\n}\n\n/** The route type of the table `EditorServerOptions.routes` filters. */\nexport type { RouteDef }\n\nexport interface EditorServerOptions {\n  /** Access control, storage and everything else the backend serves, one port per capability: a route is mounted only when its port is present. A documents port that also manages documents (`json`, `drizzle`) lets `PUT /api/editor/documents/:id` create them; the `comments` port mounts the comments endpoint, `models` the host's language models. */\n  ports: EditorPorts\n  /**\n   * The collaboration websocket (`/collab/:id`). Schema, hooks and Hocuspocus configuration of `createCollabServer`;\n   * `{}` takes everything from the ports (the `collabState` port is required). `false` mounts no websocket (documents then only load and save over HTTP).\n   * `authenticateUpgrade`: authenticate the upgrade request itself (`AccessControl.authenticate` with its headers; cookies,\n   * not the provider's `token`) and refuse it with HTTP 401, instead of closing an unauthenticated socket with 4401\n   * after the upgrade; the user then travels with the connection and is not authenticated a second time.\n   * Needs `experimental: { websocket: true }` in the Nitro config.\n   */\n  collab: (Omit<CollabServerOptions, 'ports'> & { authenticateUpgrade?: boolean }) | false\n  /**\n   * Mounts the AI endpoints (`/api/ai/*`): presets, shared key, transcription, model roles of `createAiModels`; `languageModel`\n   * and `listModels` default to those of the `models` port. Omitted: no AI routes.\n   */\n  ai?: Partial<AiModelsConfig>\n  /** Per-user limit of the AI endpoints; default: that of `defineEditorConfig` (30 requests per minute). */\n  rateLimit?: RateLimiterOptions\n  /** Filters or reorders the routes before they are mounted (a host that serves `/api/editor/assets/*` itself drops them); default: all. Receives what `serverRoutesOf(ports, { ai })` returns, so a route of an absent port, or an AI route without the `ai` option, is not in it. */\n  routes?: (routes: readonly RouteDef[]) => readonly RouteDef[]\n  /** The collaboration schema (see `CollabServerOptions.schema`); default `advancedSchemaExtensions()`, host nodes: `() => [...advancedSchemaExtensions(), Callout]`. */\n  schema?: () => AnyExtension[]\n  /**\n   * The host's Block types (the list its editors get through the `blockTypes` option, e.g. `mergeBlockTypes(defaultBlockTypes(t), parseBlockTypes(file))`),\n   * so the server resolves them without the client repeating them. The AI chat (`POST /api/ai/chat`) describes these to the model and ignores the\n   * `blockTypes` in the request. Omitted: the chat takes the `blockTypes` the client sends. The collaboration schema does not need them (Block types are storage, not schema).\n   */\n  blockTypes?: readonly BlockType[]\n}\n\nexport interface EditorServer {\n  ports: EditorPorts\n  /** The collaboration server, `undefined` with `collab: false`. */\n  collab: CollabServer | undefined\n  /** The AI models, `undefined` without `ai`. */\n  models: AiModels | undefined\n  /** Writes pending collaboration stores and disconnects every client. Nitro's `close` hook calls it. */\n  close(): Promise<void>\n}\n\ntype CollabPeer = { _hocuspocus?: CollabConnection }\n\n// Same crossws wiring as Hocuspocus' own Server; the document name comes from the provider's `name`. By default the user\n// is authenticated in Hocuspocus' `onAuthenticate` (cookie headers of the upgrade request or the provider's `token`), so\n// the upgrade always succeeds and an unauthenticated socket is closed with 4401 afterwards. With `authenticateUpgrade` the\n// upgrade request itself is authenticated (headers only) and refused with HTTP 401.\nconst collabRoute = (collab: CollabServer, ports: EditorPorts, authenticateUpgrade: boolean) => defineWebSocketHandler({\n  async upgrade(request) {\n    if (!authenticateUpgrade) return\n    const user = await ports.identity.authenticate({ headers: request.headers })\n    // No body: crossws' node adapter writes the response headers percent-encoded, which would mangle an automatic `content-type`.\n    if (!user) return new Response(null, { status: 401, statusText: 'Unauthorized' })\n    // crossws creates the context before it calls the hook (its type is optional only for other callers); `open` reads it as `peer.context`.\n    request.context!.user = user\n  },\n  open(peer) {\n    const user = peer.context.user as object | undefined\n    ;(peer as unknown as CollabPeer)._hocuspocus = collab.handleConnection(peer.websocket as unknown as Parameters<CollabServer['handleConnection']>[0], peer.request as Request, user && { user })\n  },\n  message(peer, message) {\n    ;(peer as unknown as CollabPeer)._hocuspocus?.handleMessage(message.uint8Array())\n  },\n  close(peer, details) {\n    ;(peer as unknown as CollabPeer)._hocuspocus?.handleClose({ code: details.code ?? 1000, reason: details.reason ?? '' } as CloseEvent)\n  },\n  error(peer, error) {\n    console.error('[collab]', peer.id, error)\n  },\n})\n\n/**\n * Wires the editor backend into `nitroApp` (call it from a Nitro plugin):\n *\n *     /api/editor/{capabilities,settings,users,tags,assets/…,themes/…}   the editor's own endpoints, each with its port; `capabilities` lists what is served\n *     /api/editor/documents/:id                              GET/PUT a document's TipTap JSON (what `useEditorDocument` uses)\n *     /api/editor/comments/:id                               GET/POST comments, with `ports.comments`\n *     /api/ai/{models,chat,complete,generate,extract,transcript-cleanup}   with `ai`\n *     /collab/:id                                            the collaboration websocket, unless `collab: false`\n *\n * Every route authenticates through `ports.identity.authenticate`. The collaboration server is closed with Nitro's `close`\n * hook. The installed server is also the process-wide one of `@ecsplico/editor/server` (`useCollabServer`, `useAiModels`,\n * `liveContent`, …) until it closes. The paths are the ones the editor's client (`createHttpBackend`) calls.\n */\nexport function installEditorServer(nitroApp: NitroHost, options: EditorServerOptions): EditorServer {\n  const { ports, schema } = options\n  const { authenticateUpgrade = false, ...collabOptions }: Exclude<EditorServerOptions['collab'], false> = options.collab || {}\n  const collab = options.collab === false ? undefined : createCollabServer({ ports, ...(schema && { schema }), ...collabOptions })\n  const provider = ports.models\n  const models = options.ai && createAiModels({\n    presets: {},\n    languageModel: provider?.languageModel && ((ref, user) => provider.languageModel!(ref, user)),\n    listModels: provider?.listModels && (user => provider.listModels!(user)),\n    ...options.ai,\n  })\n  const limiter: RateLimiter | undefined = models && createRateLimiter(options.rateLimit ?? defineEditorConfig().ai.rateLimit)\n\n  const context: HandlerContext = { ports, ...(collab && { collab }), served: { ai: models !== undefined, collaboration: collab !== undefined } }\n  const aiContext: AiHandlerContext | undefined = models && limiter && { ...context, ai: models, limiter, ...(options.blockTypes && { blockTypes: options.blockTypes }) }\n  const mounted = serverRoutesOf(ports, { ai: aiContext !== undefined })\n  for (const route of options.routes ? options.routes(mounted) : mounted) {\n    // `serverRoutesOf` returns the AI routes only with `ai`, so `aiContext` is set for them.\n    const handler = route.port === 'ai' ? routeOf(aiContext!, route.handler) : routeOf(context, route.handler)\n    nitroApp.router.add(route.path, handler, route.method)\n  }\n  // No method: the websocket upgrade resolves its handler by path only.\n  if (collab) nitroApp.router.use(`${COLLAB_PATH}/:id`, collabRoute(collab, ports, authenticateUpgrade))\n\n  const release = adoptEditorServer({ ports, schema, blockTypes: options.blockTypes, collab, models, limiter })\n  const server: EditorServer = {\n    ports,\n    collab,\n    models,\n    async close() {\n      await collab?.close()\n      release()\n    },\n  }\n  nitroApp.hooks.hook('close', () => server.close())\n  return server\n}\n"],"mappings":";;;;;;;;;;AAwEA,MAAM,eAAe,QAAsB,OAAoB,wBAAiC,uBAAuB;CACrH,MAAM,QAAQ,SAAS;EACrB,IAAI,CAAC,qBAAqB;EAC1B,MAAM,OAAO,MAAM,MAAM,SAAS,aAAa,EAAE,SAAS,QAAQ,QAAQ,CAAC;EAE3E,IAAI,CAAC,MAAM,OAAO,IAAI,SAAS,MAAM;GAAE,QAAQ;GAAK,YAAY;EAAe,CAAC;EAEhF,QAAQ,QAAS,OAAO;CAC1B;CACA,KAAK,MAAM;EACT,MAAM,OAAO,KAAK,QAAQ;EACzB,KAAgC,cAAc,OAAO,iBAAiB,KAAK,WAAyE,KAAK,SAAoB,QAAQ,EAAE,KAAK,CAAC;CAChM;CACA,QAAQ,MAAM,SAAS;EACpB,KAAgC,aAAa,cAAc,QAAQ,WAAW,CAAC;CAClF;CACA,MAAM,MAAM,SAAS;EAClB,KAAgC,aAAa,YAAY;GAAE,MAAM,QAAQ,QAAQ;GAAM,QAAQ,QAAQ,UAAU;EAAG,CAAe;CACtI;CACA,MAAM,MAAM,OAAO;EACjB,QAAQ,MAAM,YAAY,KAAK,IAAI,KAAK;CAC1C;AACF,CAAC;;;;;;;;;;;;;;AAeD,SAAgB,oBAAoB,UAAqB,SAA4C;CACnG,MAAM,EAAE,OAAO,WAAW;CAC1B,MAAM,EAAE,sBAAsB,OAAO,GAAG,kBAAiE,QAAQ,UAAU,CAAC;CAC5H,MAAM,SAAS,QAAQ,WAAW,QAAQ,KAAA,IAAY,mBAAmB;EAAE;EAAO,GAAI,UAAU,EAAE,OAAO;EAAI,GAAG;CAAc,CAAC;CAC/H,MAAM,WAAW,MAAM;CACvB,MAAM,SAAS,QAAQ,MAAM,eAAe;EAC1C,SAAS,CAAC;EACV,eAAe,UAAU,mBAAmB,KAAK,SAAS,SAAS,cAAe,KAAK,IAAI;EAC3F,YAAY,UAAU,gBAAe,SAAQ,SAAS,WAAY,IAAI;EACtE,GAAG,QAAQ;CACb,CAAC;CACD,MAAM,UAAmC,UAAU,kBAAkB,QAAQ,aAAa,mBAAmB,CAAC,CAAC,GAAG,SAAS;CAE3H,MAAM,UAA0B;EAAE;EAAO,GAAI,UAAU,EAAE,OAAO;EAAI,QAAQ;GAAE,IAAI,WAAW,KAAA;GAAW,eAAe,WAAW,KAAA;EAAU;CAAE;CAC9I,MAAM,YAA0C,UAAU,WAAW;EAAE,GAAG;EAAS,IAAI;EAAQ;EAAS,GAAI,QAAQ,cAAc,EAAE,YAAY,QAAQ,WAAW;CAAG;CACtK,MAAM,UAAU,eAAe,OAAO,EAAE,IAAI,cAAc,KAAA,EAAU,CAAC;CACrE,KAAK,MAAM,SAAS,QAAQ,SAAS,QAAQ,OAAO,OAAO,IAAI,SAAS;EAEtE,MAAM,UAAU,MAAM,SAAS,OAAO,QAAQ,WAAY,MAAM,OAAO,IAAI,QAAQ,SAAS,MAAM,OAAO;EACzG,SAAS,OAAO,IAAI,MAAM,MAAM,SAAS,MAAM,MAAM;CACvD;CAEA,IAAI,QAAQ,SAAS,OAAO,IAAI,GAAG,YAAY,OAAO,YAAY,QAAQ,OAAO,mBAAmB,CAAC;CAErG,MAAM,UAAU,kBAAkB;EAAE;EAAO;EAAQ,YAAY,QAAQ;EAAY;EAAQ;EAAQ;CAAQ,CAAC;CAC5G,MAAM,SAAuB;EAC3B;EACA;EACA;EACA,MAAM,QAAQ;GACZ,MAAM,QAAQ,MAAM;GACpB,QAAQ;EACV;CACF;CACA,SAAS,MAAM,KAAK,eAAe,OAAO,MAAM,CAAC;CACjD,OAAO;AACT"}

package/dist/adapters/shared.d.ts

@@ -1,6 +1,6 @@
 import { MentionUser } from "../core/backend-types.js";
 import "../features/mentions/schema.js";
-import { AssetStore, CollabStateStore, Directory, DocumentAdmin, DocumentStore, EditorPorts, Identity, SettingsStore } from "../server/ports.js";
+import { AccessControl, AssetStore, CollabStateStore, Directory, DocumentAdmin, DocumentContentStore, EditorPorts, SettingsStore } from "../server/ports.js";
 import "../server/index.js";
 //#region src/adapters/shared.d.ts
 /**
@@ -9,19 +9,19 @@ import "../server/index.js";
  */
 export interface AdapterHooks {
   /**
-   * The user behind a request, `null` = not authenticated (see `Identity.authenticate`). Default: an anonymous
+   * The user behind a request, `null` = not authenticated (see `AccessControl.authenticate`). Default: an anonymous
    * development user outside `NODE_ENV=production`, `null` (everyone refused) in production, so a deployment never
    * serves documents to the world by omission.
    */
-  authenticate?: Identity['authenticate'];
-  /** Per-document access for the collaboration websocket (see `Identity.authorize`). Omitted: every authenticated user edits every document. */
-  authorize?: Identity['authorize'];
+  authenticate?: AccessControl['authenticate'];
+  /** Per-document access for the collaboration websocket (see `AccessControl.authorize`). Omitted: every authenticated user edits every document. */
+  authorize?: AccessControl['authorize'];
   /** Users that can be `@`-mentioned (`GET /api/editor/users`); no credentials. Default: none. */
   users?: () => MentionUser[] | Promise<MentionUser[]>;
 }
 /** The ports of an adapter that stores documents itself (`json`, `drizzle`): the contract including versioning, settings and document management. */
 export interface StoredPorts extends EditorPorts {
-  documents: DocumentStore & DocumentAdmin & Required<Pick<DocumentStore, 'contentVersion'>>;
+  documents: DocumentContentStore & DocumentAdmin & Required<Pick<DocumentContentStore, 'contentVersion'>>;
   collabState: CollabStateStore;
   directory: Directory;
   assets: AssetStore;

package/dist/adapters/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","names":[],"sources":["../../src/adapters/shared.ts"],"sourcesContent":["import type { MentionUser } from '../features/mentions/schema'\nimport type { AssetStore, CollabStateStore, Directory, DocumentAdmin, DocumentStore, EditorPorts, Identity, SettingsStore } from '../server'\n\n/**\n * The identity half of every adapter in this package: who the user is, which documents they may open and who can be\n * `@`-mentioned. Storage is the adapter's own business.\n */\nexport interface AdapterHooks {\n  /**\n   * The user behind a request, `null` = not authenticated (see `Identity.authenticate`). Default: an anonymous\n   * development user outside `NODE_ENV=production`, `null` (everyone refused) in production, so a deployment never\n   * serves documents to the world by omission.\n   */\n  authenticate?: Identity['authenticate']\n  /** Per-document access for the collaboration websocket (see `Identity.authorize`). Omitted: every authenticated user edits every document. */\n  authorize?: Identity['authorize']\n  /** Users that can be `@`-mentioned (`GET /api/editor/users`); no credentials. Default: none. */\n  users?: () => MentionUser[] | Promise<MentionUser[]>\n}\n\n/** The ports of an adapter that stores documents itself (`json`, `drizzle`): the contract including versioning, settings and document management. */\nexport interface StoredPorts extends EditorPorts {\n  documents: DocumentStore & DocumentAdmin & Required<Pick<DocumentStore, 'contentVersion'>>\n  collabState: CollabStateStore\n  directory: Directory\n  assets: AssetStore\n  settings: SettingsStore\n}\n\nconst DEV_USER = { id: 'dev', username: 'dev', color: '#6366f1' } as const\n\nconst authenticateDefault: Identity['authenticate'] = async () => process.env.NODE_ENV === 'production' ? null : { ...DEV_USER }\n\n/** The `identity` port of `hooks`; `authorize` is only present when given (the collab server and the document routes test for it). */\nexport function identityOf(hooks: Pick<AdapterHooks, 'authenticate' | 'authorize'>): Identity {\n  const { authenticate = authenticateDefault, authorize } = hooks\n  return {\n    authenticate: request => authenticate(request),\n    ...(authorize && { authorize: (user: object, id: string) => authorize(user, id) }),\n  }\n}\n\n/** The `directory` port of the `users` hook. */\nexport function directoryOf({ users }: Pick<AdapterHooks, 'users'>): Directory {\n  return { listUsers: async () => (await users?.()) ?? [] }\n}\n\n/** The key per-user settings are stored under: the user's `id`, else its `username`. */\nexport function settingsKey(user: object): string {\n  const { id, username } = user as { id?: unknown, username?: unknown }\n  for (const candidate of [id, username]) {\n    if (typeof candidate === 'string' && candidate !== '') return candidate\n    if (typeof candidate === 'number') return String(candidate)\n  }\n  throw new TypeError('@ecsplico/editor: the authenticated user has neither an `id` nor a `username`, so its settings have no key')\n}\n\n/** An independent copy of the bytes (a driver's `Buffer` may view a larger pool), as the plain `Uint8Array` the port contract names. */\nexport const bytesOf = (data: Uint8Array): Uint8Array => new Uint8Array(data)\n"],"mappings":";AA6BA,MAAM,WAAW;CAAE,IAAI;CAAO,UAAU;CAAO,OAAO;AAAU;AAEhE,MAAM,sBAAgD,YAAY,QAAQ,IAAI,aAAa,eAAe,OAAO,EAAE,GAAG,SAAS;;AAG/H,SAAgB,WAAW,OAAmE;CAC5F,MAAM,EAAE,eAAe,qBAAqB,cAAc;CAC1D,OAAO;EACL,eAAc,YAAW,aAAa,OAAO;EAC7C,GAAI,aAAa,EAAE,YAAY,MAAc,OAAe,UAAU,MAAM,EAAE,EAAE;CAClF;AACF;;AAGA,SAAgB,YAAY,EAAE,SAAiD;CAC7E,OAAO,EAAE,WAAW,YAAa,MAAM,QAAQ,KAAM,CAAC,EAAE;AAC1D;;AAGA,SAAgB,YAAY,MAAsB;CAChD,MAAM,EAAE,IAAI,aAAa;CACzB,KAAK,MAAM,aAAa,CAAC,IAAI,QAAQ,GAAG;EACtC,IAAI,OAAO,cAAc,YAAY,cAAc,IAAI,OAAO;EAC9D,IAAI,OAAO,cAAc,UAAU,OAAO,OAAO,SAAS;CAC5D;CACA,MAAM,IAAI,UAAU,4GAA4G;AAClI;;AAGA,MAAa,WAAW,SAAiC,IAAI,WAAW,IAAI"}
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/adapters/shared.ts"],"sourcesContent":["import type { MentionUser } from '../features/mentions/schema'\nimport type { AccessControl, AssetStore, CollabStateStore, Directory, DocumentAdmin, DocumentContentStore, EditorPorts, SettingsStore } from '../server'\n\n/**\n * The identity half of every adapter in this package: who the user is, which documents they may open and who can be\n * `@`-mentioned. Storage is the adapter's own business.\n */\nexport interface AdapterHooks {\n  /**\n   * The user behind a request, `null` = not authenticated (see `AccessControl.authenticate`). Default: an anonymous\n   * development user outside `NODE_ENV=production`, `null` (everyone refused) in production, so a deployment never\n   * serves documents to the world by omission.\n   */\n  authenticate?: AccessControl['authenticate']\n  /** Per-document access for the collaboration websocket (see `AccessControl.authorize`). Omitted: every authenticated user edits every document. */\n  authorize?: AccessControl['authorize']\n  /** Users that can be `@`-mentioned (`GET /api/editor/users`); no credentials. Default: none. */\n  users?: () => MentionUser[] | Promise<MentionUser[]>\n}\n\n/** The ports of an adapter that stores documents itself (`json`, `drizzle`): the contract including versioning, settings and document management. */\nexport interface StoredPorts extends EditorPorts {\n  documents: DocumentContentStore & DocumentAdmin & Required<Pick<DocumentContentStore, 'contentVersion'>>\n  collabState: CollabStateStore\n  directory: Directory\n  assets: AssetStore\n  settings: SettingsStore\n}\n\nconst DEV_USER = { id: 'dev', username: 'dev', color: '#6366f1' } as const\n\nconst authenticateDefault: AccessControl['authenticate'] = async () => process.env.NODE_ENV === 'production' ? null : { ...DEV_USER }\n\n/** The `identity` port of `hooks`; `authorize` is only present when given (the collab server and the document routes test for it). */\nexport function identityOf(hooks: Pick<AdapterHooks, 'authenticate' | 'authorize'>): AccessControl {\n  const { authenticate = authenticateDefault, authorize } = hooks\n  return {\n    authenticate: request => authenticate(request),\n    ...(authorize && { authorize: (user: object, id: string) => authorize(user, id) }),\n  }\n}\n\n/** The `directory` port of the `users` hook. */\nexport function directoryOf({ users }: Pick<AdapterHooks, 'users'>): Directory {\n  return { listUsers: async () => (await users?.()) ?? [] }\n}\n\n/** The key per-user settings are stored under: the user's `id`, else its `username`. */\nexport function settingsKey(user: object): string {\n  const { id, username } = user as { id?: unknown, username?: unknown }\n  for (const candidate of [id, username]) {\n    if (typeof candidate === 'string' && candidate !== '') return candidate\n    if (typeof candidate === 'number') return String(candidate)\n  }\n  throw new TypeError('@ecsplico/editor: the authenticated user has neither an `id` nor a `username`, so its settings have no key')\n}\n\n/** An independent copy of the bytes (a driver's `Buffer` may view a larger pool), as the plain `Uint8Array` the port contract names. */\nexport const bytesOf = (data: Uint8Array): Uint8Array => new Uint8Array(data)\n"],"mappings":";AA6BA,MAAM,WAAW;CAAE,IAAI;CAAO,UAAU;CAAO,OAAO;AAAU;AAEhE,MAAM,sBAAqD,YAAY,QAAQ,IAAI,aAAa,eAAe,OAAO,EAAE,GAAG,SAAS;;AAGpI,SAAgB,WAAW,OAAwE;CACjG,MAAM,EAAE,eAAe,qBAAqB,cAAc;CAC1D,OAAO;EACL,eAAc,YAAW,aAAa,OAAO;EAC7C,GAAI,aAAa,EAAE,YAAY,MAAc,OAAe,UAAU,MAAM,EAAE,EAAE;CAClF;AACF;;AAGA,SAAgB,YAAY,EAAE,SAAiD;CAC7E,OAAO,EAAE,WAAW,YAAa,MAAM,QAAQ,KAAM,CAAC,EAAE;AAC1D;;AAGA,SAAgB,YAAY,MAAsB;CAChD,MAAM,EAAE,IAAI,aAAa;CACzB,KAAK,MAAM,aAAa,CAAC,IAAI,QAAQ,GAAG;EACtC,IAAI,OAAO,cAAc,YAAY,cAAc,IAAI,OAAO;EAC9D,IAAI,OAAO,cAAc,UAAU,OAAO,OAAO,SAAS;CAC5D;CACA,MAAM,IAAI,UAAU,4GAA4G;AAClI;;AAGA,MAAa,WAAW,SAAiC,IAAI,WAAW,IAAI"}

package/dist/config/index.d.ts

@@ -1,9 +1,9 @@
 import { Locale, Messages } from "../i18n/index.js";
-import { ModelSlot } from "../settings/values.js";
+import { ModelRole } from "../settings/values.js";
 import "../settings/index.js";
 //#region src/config/index.d.ts
-/** Server-defined model preset (any OpenAI-compatible chat completions endpoint); its key falls back to the shared `apiKey`. */
-export interface PresetConfig {
+/** Server-defined Model preset (any OpenAI-compatible chat completions endpoint); its key falls back to the shared `apiKey`. The `preset` field of a model reference names one by id. */
+export interface ModelPresetConfig {
   label: string;
   endpoint: string;
   model: string;
@@ -34,18 +34,18 @@ export interface EditorConfig {
      * the preset id in upper snake case, e.g. `flashLite` → `FLASH_LITE`, or `NUXT_TIPTAP_EDITOR_AI_API_KEY`). Preset ids
      * must be camelCase so the env names map onto them. Presets named like a default (`sonnet`, `flashLite`) override its fields.
      */
-    presets: Record<string, PresetConfig>;
+    presets: Record<string, ModelPresetConfig>;
     /** Shared key of presets without their own. Default `''` (so the env variable has a key to override). */
     apiKey: string;
-    /** Default preset per slot; users may override in settings. The `complete` model must support assistant prefill. */
-    slots: Record<ModelSlot, string>;
+    /** Default preset per model role; users may override in settings (`ai.roles`). The `complete` model must support assistant prefill. */
+    roles: Record<ModelRole, string>;
     /** Per-user limit shared by all AI endpoints: at most `max` requests per sliding `windowMs`. */
     rateLimit: {
       max: number;
       windowMs: number;
     };
     /**
-     * Speech-to-text for audio/video Bausteine: an OpenAI-compatible `<endpoint>/audio/transcriptions` or Deepgram
+     * Speech-to-text for audio/video Typed blocks: an OpenAI-compatible `<endpoint>/audio/transcriptions` or Deepgram
      * (`provider: 'deepgram'`; OpenRouter presets provide neither). Absent = the action and the endpoint are off.
      * The key comes from env only (Nuxt: `NUXT_TIPTAP_EDITOR_AI_TRANSCRIPTION_API_KEY`).
      */
@@ -53,7 +53,7 @@ export interface EditorConfig {
   };
   collab: {
     /**
-     * Authenticate the `/collab/:id` websocket upgrade itself (`Identity.authenticate` with the upgrade request's
+     * Authenticate the `/collab/:id` websocket upgrade itself (`AccessControl.authenticate` with the upgrade request's
      * headers) and refuse it with HTTP 401 for an unknown user. Default `false`: the upgrade always succeeds, the user
      * is authenticated afterwards from the headers or the provider's `token`, and an unauthenticated socket is closed
      * with code 4401. Enable only when every client authenticates by cookie/headers: a client that sends its identity
@@ -67,18 +67,18 @@ type DeepPartial<T> = T extends object ? { [K in keyof T]?: DeepPartial<T[K]>; }
 /** What a host writes: every key optional, `undefined` (an unset env variable) means the default. */
 export type EditorConfigInput = DeepPartial<EditorConfig>;
 /**
- * Applies every default once: locale `'de'`, the OpenRouter presets `sonnet` and `flashLite` with the slots that use
+ * Applies every default once: locale `'de'`, the OpenRouter presets `sonnet` and `flashLite` with the model roles that use
  * them, 30 AI requests per user and minute, no upgrade authentication. Every preset and the transcription get an empty
  * `apiKey` unless one is given, so an environment variable has a key to override.
  */
 export declare function defineEditorConfig(input?: EditorConfigInput): EditorConfig;
-/** What the browser may see: the language and the default model slots, never a key. */
+/** What the browser may see: the language and the default model roles, never a key. */
 export interface EditorPublicConfig {
   locale: Locale;
   messages?: Partial<Messages>;
-  /** Inert AI configuration: default preset per slot before the models list has answered, and whether transcription is on. */
+  /** Inert AI configuration: default preset per model role before the models list has answered, and whether transcription is on. */
   ai: {
-    slots: Record<ModelSlot, string>;
+    roles: Record<ModelRole, string>;
     transcription: boolean;
   };
 }
@@ -86,9 +86,9 @@ export declare function publicConfig(config: EditorConfig): EditorPublicConfig;
 /** What the server needs, secrets included: the shape `installEditorServer` takes for `ai`, `rateLimit` and `collab`. */
 export interface EditorServerConfig {
   ai: {
-    presets: Record<string, PresetConfig>;
+    presets: Record<string, ModelPresetConfig>;
     apiKey: string;
-    slots: Record<ModelSlot, string>;
+    roles: Record<ModelRole, string>;
     transcription?: TranscriptionConfig;
   };
   rateLimit: {