@ecsplico/editor 2.1.2 → 3.1.0

package/dist/server/collab.js.map

@@ -1 +1 @@
-{"version":3,"file":"collab.js","names":[],"sources":["../../src/server/collab.ts"],"sourcesContent":["import { type Configuration, Hocuspocus, type WebSocketLike } from '@hocuspocus/server'\nimport { type AnyExtension, getSchema, type JSONContent } from '@tiptap/core'\nimport type { Schema } from '@tiptap/pm/model'\nimport { prosemirrorToYDoc, prosemirrorToYXmlFragment, yDocToProsemirrorJSON, yXmlFragmentToProsemirror } from '@tiptap/y-tiptap'\nimport * as Y from 'yjs'\nimport { assignBlockIds, EMPTY_EDITOR_CONTENT } from '../core/schema'\nimport { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from '../features/composites/schema'\nimport { advancedSchemaExtensions } from '../schema/advanced'\nimport type { EditorAdapter } from './adapter'\nimport { decodeCollabState, encodeCollabState, isStateStale } from './collab-state'\n\n/** Y.XmlFragment the TipTap Collaboration extension binds to (its default `field`). */\nexport const COLLAB_FIELD = 'default'\n\n/** Close code of a connection whose client could not be authenticated (Hocuspocus' `Unauthorized`, HTTP 401 in websocket terms). */\nconst UNAUTHORIZED = { code: 4401, reason: 'Unauthorized' }\n\n/** Context key under which `handleConnection` hands the connection's socket closer to the `onAuthenticate` hook. */\nconst REJECT = Symbol('collab.reject')\n\nexport interface CollabServerOptions {\n  /** Storage and identity of the editor backend. */\n  adapter: EditorAdapter\n  /** Extensions of host-defined nodes and marks appended to `advancedSchemaExtensions()`; defaults to `adapter.schemaExtensions`. */\n  schemaExtensions?: () => AnyExtension[]\n  /** Per-document access and content versioning; each defaults to the adapter's method of the same name. */\n  hooks?: {\n    authorize?: NonNullable<EditorAdapter['authorize']>\n    contentVersion?: NonNullable<EditorAdapter['contentVersion']>\n  }\n  /** Further Hocuspocus configuration (`debounce`, `timeout`, `quiet`, …); the editor's hooks win over equally named ones. */\n  configuration?: Partial<Configuration>\n}\n\n/** One served websocket connection: feed it the socket's messages and its close event. */\nexport interface CollabConnection {\n  handleMessage(data: Uint8Array): void\n  handleClose(event?: CloseEvent): void\n}\n\nexport interface CollabServer {\n  /**\n   * The Hocuspocus instance of this server. The Yjs state (via the adapter's `loadState`/`storeState`) is the source of\n   * truth for content, the host's JSON content (via the adapter) is a mirror kept up to date on every store.\n   */\n  hocuspocus: Hocuspocus\n  /** Schema of the collab server: `advancedSchemaExtensions()` plus the host's extensions, built on first use. */\n  schema(): Schema\n  /**\n   * Serves one websocket connection (any transport: crossws, `ws`, Bun, Deno). The user is authenticated in Hocuspocus'\n   * `onAuthenticate` from the upgrade request's headers and the client's token, unless the transport already knows it\n   * and passes it as `context.user`. Wire `handleMessage` and `handleClose` of the returned connection to the socket's events.\n   */\n  handleConnection(socket: WebSocketLike, request: Request, context?: { user?: object }): CollabConnection\n  /** Tell connected clients the document is gone, disconnect them and drop the Yjs state. Call before removing the JSON. */\n  forgetDocument(id: string): Promise<void>\n  /** Current content of a document that is open in Hocuspocus (unsaved edits included), `null` when nobody has it open. */\n  liveContent(id: string): JSONContent | null\n  /**\n   * The host rewrote the content behind the editor's back (an agent wrote the file): merge it into the open document now,\n   * as a diff-update connected clients see as an ordinary edit. Without this the merge waits for the document's next store.\n   * No-op when nobody has the document open or the content version is unchanged; needs the adapter's `contentVersion`.\n   */\n  contentChanged(id: string): Promise<void>\n  /** Open collaboration connections and loaded documents of this server. */\n  stats(): { connections: number, documents: number }\n  /** Disconnect every client, write pending stores and wait until all documents are unloaded. The server accepts no connection afterwards. */\n  close(): Promise<void>\n}\n\n/** ProseMirror document of stored JSON content: legacy nodes migrated, empty content replaced by the empty document, block IDs assigned. */\nfunction contentNode(schema: Schema, loaded: JSONContent) {\n  const content = migrateLegacyContent(loaded)\n  const node = schema.nodeFromJSON(content.type === 'doc' && content.content?.length ? content : EMPTY_EDITOR_CONTENT)\n  return assignBlockIds(node) ?? node\n}\n\n/** Hocuspocus answers a thrown error's `reason` as permission-denied. */\nconst denied = (message: string, reason: string) => Object.assign(new Error(message), { reason })\n\n/**\n * The editor's collaboration server, independent of any web framework: Hocuspocus with the editor's hooks (seeding from\n * the adapter's JSON, versioned state, block-ID backfill, debounced `storeContent`/`storeState`) over `adapter`.\n * `/nuxt` mounts one in Nitro; any Node/Bun/Deno process can serve `handleConnection` on its own websocket transport.\n */\nexport function createCollabServer(options: CollabServerOptions): CollabServer {\n  const { adapter } = options\n  const authorize = (user: object, id: string) => options.hooks?.authorize ? options.hooks.authorize(user, id) : adapter.authorize?.(user, id)\n  const contentVersion = (id: string) => options.hooks?.contentVersion ? options.hooks.contentVersion(id) : adapter.contentVersion?.(id)\n\n  let schema: Schema | undefined\n  const collabSchema = () => schema ??= getSchema([...advancedSchemaExtensions(), ...((options.schemaExtensions ?? adapter.schemaExtensions?.bind(adapter))?.() ?? [])])\n\n  /** Loaded documents deleted via `forgetDocument`; a store still pending for them must not write their Yjs state back. */\n  const forgotten = new Set<string>()\n  /** `contentVersion` the loaded document's content mirror had when it was last read or written; only tracked for adapters with `contentVersion`. */\n  const loadedVersions = new Map<string, string | null>()\n  /** Resolvers of `close()` waiting for the last document to unload. */\n  const idle: (() => void)[] = []\n  let closed = false\n\n  /** Merges content rewritten behind the editor's back into the open document and stores its state against `version`. */\n  async function mergeRewrite(id: string, document: Y.Doc, version: string | null): Promise<void> {\n    const rewritten = await adapter.loadContent(id)\n    if (!rewritten) return // removed meanwhile: nothing to merge, nothing to mirror\n    // A diff-update: unchanged blocks keep their Yjs items, so connected clients see an ordinary edit and need no reload.\n    prosemirrorToYXmlFragment(contentNode(collabSchema(), rewritten), document.getXmlFragment(COLLAB_FIELD))\n    loadedVersions.set(id, version)\n    await adapter.storeState(id, encodeCollabState({ version, update: Y.encodeStateAsUpdate(document) }))\n  }\n\n  /** Stored state of a document, `null` when there is none usable: it was written against another content version and is removed. */\n  async function loadCurrentState(id: string, liveVersion: string | null | undefined): Promise<Uint8Array | null> {\n    const payload = await adapter.loadState(id)\n    if (!payload) return null\n    const { version, update } = decodeCollabState(payload)\n    if (isStateStale(version, liveVersion)) {\n      await adapter.removeState(id)\n      return null\n    }\n    return update\n  }\n\n  const hocuspocus = new Hocuspocus({\n    ...options.configuration,\n    async onAuthenticate({ context, token, requestHeaders, documentName, connectionConfig }) {\n      // The transport may know the user already; otherwise it comes from the upgrade request's headers or the client's token.\n      let user = context.user as object | null | undefined\n      if (!user) user = await adapter.authenticate({ headers: requestHeaders, ...(token && { token }) })\n      if (!user) {\n        // After the permission-denied answer Hocuspocus sends: close the socket, so a client without credentials does not linger.\n        const socketCloser = context[REJECT] as (() => void) | undefined\n        socketCloser?.()\n        throw denied('Unauthorized', 'unauthorized')\n      }\n      const access = await authorize(user, documentName)\n      // `undefined`: no authorize hook, every authenticated user may edit. `null`: rejected; the thrown error's `reason` is answered as permission-denied.\n      if (access === null) throw denied('Forbidden', 'forbidden')\n      if (access?.readOnly) connectionConfig.readOnly = true\n      return { user }\n    },\n    async onLoadDocument({ documentName }) {\n      const currentSchema = collabSchema()\n      // Read before the content: a change in between leaves an older version on the state, which only costs a re-seed.\n      const version = await contentVersion(documentName)\n      const stored = await loadCurrentState(documentName, version)\n      if (version !== undefined) loadedVersions.set(documentName, version)\n      const persist = (doc: Y.Doc) => adapter.storeState(documentName, encodeCollabState({ version: version ?? null, update: Y.encodeStateAsUpdate(doc) }))\n      if (stored) {\n        // Decoded into a scratch doc: Hocuspocus only gets it once it is known to be current.\n        const doc = new Y.Doc()\n        Y.applyUpdate(doc, stored)\n        const fragment = doc.getXmlFragment(COLLAB_FIELD)\n        // State from before the composite family holds node names the schema no longer knows (any depth): drop it and\n        // reseed below from the migrated JSON mirror, which also rewrites the stored state.\n        const legacy = !fragment.createTreeWalker(node => node instanceof Y.XmlElement && node.nodeName === LEGACY_COMPOSITE_NODE).next().done\n        if (!legacy) {\n          // Blocks without an ID (state from before block IDs): assign them here, before any client syncs, so clients\n          // never backfill concurrently. The diff-update only sets attributes; the content keeps its Yjs items.\n          const withIds = assignBlockIds(yXmlFragmentToProsemirror(currentSchema, fragment))\n          if (withIds) {\n            prosemirrorToYXmlFragment(withIds, fragment)\n            // Persist right away: a backfill after a restart would assign other IDs than clients already hold.\n            await persist(doc)\n          }\n          return doc\n        }\n      }\n      const loaded = await adapter.loadContent(documentName)\n      if (!loaded) throw new Error('Dokument nicht gefunden') // Hocuspocus closes the connection\n      // No usable Yjs state (new, legacy, stale or restored document): seed it from the stored JSON, with block IDs.\n      const seeded = prosemirrorToYDoc(contentNode(currentSchema, loaded), COLLAB_FIELD)\n      // Persist right away: re-seeding later would create new Yjs items that duplicate what clients still hold.\n      await persist(seeded)\n      return seeded\n    },\n    async onStoreDocument({ documentName, document }) {\n      if (forgotten.has(documentName)) return\n      const tracked = loadedVersions.get(documentName)\n      const current = tracked === undefined ? undefined : await contentVersion(documentName)\n      if (current !== undefined && current !== tracked) {\n        // The content was rewritten behind the editor's back: writing the Yjs content back would clobber the rewrite.\n        // Merge the rewrite into the open document instead and store the state against the new version.\n        await mergeRewrite(documentName, document, current)\n        return\n      }\n      await adapter.storeContent(documentName, yDocToProsemirrorJSON(document, COLLAB_FIELD))\n      // After the content: the write itself moves the version, and the state must carry the one it matches.\n      const version = await contentVersion(documentName)\n      if (version !== undefined) loadedVersions.set(documentName, version)\n      await adapter.storeState(documentName, encodeCollabState({ version: version ?? null, update: Y.encodeStateAsUpdate(document) }))\n    },\n    async afterUnloadDocument({ documentName }) {\n      forgotten.delete(documentName)\n      loadedVersions.delete(documentName)\n      if (hocuspocus.getDocumentsCount() === 0) idle.splice(0).forEach(resolve => resolve())\n    },\n  })\n\n  return {\n    hocuspocus,\n    schema: collabSchema,\n    handleConnection(socket, request, context = {}) {\n      if (closed) throw new Error('tiptap-editor: der Collab-Server ist geschlossen')\n      // Deferred: Hocuspocus answers permission-denied first, then the socket closes.\n      const reject = () => void setTimeout(() => socket.close(UNAUTHORIZED.code, UNAUTHORIZED.reason), 0)\n      return hocuspocus.handleConnection(socket, request, { ...context, [REJECT]: reject })\n    },\n    async forgetDocument(id) {\n      const doc = hocuspocus.documents.get(id)\n      if (doc) {\n        forgotten.add(id)\n        doc.broadcastStateless('deleted')\n        hocuspocus.closeConnections(id)\n      }\n      await adapter.removeState(id)\n    },\n    liveContent(id) {\n      const doc = hocuspocus.documents.get(id)\n      return doc ? yDocToProsemirrorJSON(doc, COLLAB_FIELD) as JSONContent : null\n    },\n    async contentChanged(id) {\n      const doc = hocuspocus.documents.get(id)\n      if (!doc || forgotten.has(id)) return\n      const tracked = loadedVersions.get(id)\n      if (tracked === undefined) return // no `contentVersion`: a rewrite cannot be told from the server's own writes\n      const current = await contentVersion(id)\n      if (current === undefined || current === tracked) return\n      await mergeRewrite(id, doc, current)\n    },\n    stats: () => ({ connections: hocuspocus.getConnectionsCount(), documents: hocuspocus.getDocumentsCount() }),\n    async close() {\n      closed = true\n      if (hocuspocus.getDocumentsCount() === 0) return\n      await new Promise<void>((resolve) => {\n        idle.push(resolve)\n        hocuspocus.closeConnections()\n        hocuspocus.flushPendingStores()\n      })\n    },\n  }\n}\n\nexport type { WebSocketLike }\n"],"mappings":"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"}
+{"version":3,"file":"collab.js","names":[],"sources":["../../src/server/collab.ts"],"sourcesContent":["import { type Configuration, Hocuspocus, type WebSocketLike } from '@hocuspocus/server'\nimport { type AnyExtension, getSchema, type JSONContent } from '@tiptap/core'\nimport type { Schema } from '@tiptap/pm/model'\nimport { prosemirrorToYDoc, prosemirrorToYXmlFragment, yDocToProsemirrorJSON, yXmlFragmentToProsemirror } from '@tiptap/y-tiptap'\nimport * as Y from 'yjs'\nimport { assignBlockIds, EMPTY_EDITOR_CONTENT } from '../core/schema'\nimport { LEGACY_COMPOSITE_NODE, migrateLegacyContent } from '../features/composites/schema'\nimport { advancedSchemaExtensions } from '../schema/advanced'\nimport { decodeCollabState, encodeCollabState, isStateStale } from './collab-state'\nimport type { CollabStateStore, DocumentStore, EditorPorts, Identity } from './ports'\n\n/** Y.XmlFragment the TipTap Collaboration extension binds to (its default `field`). */\nexport const COLLAB_FIELD = 'default'\n\n/** Close code of a connection whose client could not be authenticated (Hocuspocus' `Unauthorized`, HTTP 401 in websocket terms). */\nconst UNAUTHORIZED = { code: 4401, reason: 'Unauthorized' }\n\n/** Context key under which `handleConnection` hands the connection's socket closer to the `onAuthenticate` hook. */\nconst REJECT = Symbol('collab.reject')\n\nexport interface CollabServerOptions {\n  /** Identity, documents and Yjs state of the editor backend; `collabState` is required. */\n  ports: EditorPorts\n  /** TipTap extensions of the collaboration schema; default `advancedSchemaExtensions()`. Host-defined nodes and marks: `() => [...advancedSchemaExtensions(), HostNode]` (Vue-free node files only, no node views). */\n  schema?: () => AnyExtension[]\n  /** Per-document access and content versioning; each defaults to the port's method of the same name. */\n  hooks?: {\n    authorize?: NonNullable<Identity['authorize']>\n    contentVersion?: NonNullable<DocumentStore['contentVersion']>\n  }\n  /** Further Hocuspocus configuration (`debounce`, `timeout`, `quiet`, …); the editor's hooks win over equally named ones. */\n  configuration?: Partial<Configuration>\n}\n\n/** One served websocket connection: feed it the socket's messages and its close event. */\nexport interface CollabConnection {\n  handleMessage(data: Uint8Array): void\n  handleClose(event?: CloseEvent): void\n}\n\nexport interface CollabServer {\n  /**\n   * The Hocuspocus instance of this server. The Yjs state (via the `collabState` port's `loadState`/`storeState`) is the\n   * source of truth for content, the host's JSON content (via the `documents` port) is a mirror kept up to date on every store.\n   */\n  hocuspocus: Hocuspocus\n  /** Schema of the collab server: `options.schema()` (default `advancedSchemaExtensions()`), built on first use. */\n  schema(): Schema\n  /**\n   * Serves one websocket connection (any transport: crossws, `ws`, Bun, Deno). The user is authenticated in Hocuspocus'\n   * `onAuthenticate` from the upgrade request's headers and the client's token, unless the transport already knows it\n   * and passes it as `context.user`. Wire `handleMessage` and `handleClose` of the returned connection to the socket's events.\n   */\n  handleConnection(socket: WebSocketLike, request: Request, context?: { user?: object }): CollabConnection\n  /** Tell connected clients the document is gone, disconnect them and drop the Yjs state. Call before removing the JSON. */\n  forgetDocument(id: string): Promise<void>\n  /** Current content of a document that is open in Hocuspocus (unsaved edits included), `null` when nobody has it open. */\n  liveContent(id: string): JSONContent | null\n  /**\n   * The host rewrote the content behind the editor's back (an agent wrote the file): merge it into the open document now,\n   * as a diff-update connected clients see as an ordinary edit. Without this the merge waits for the document's next store.\n   * No-op when nobody has the document open or the content version is unchanged; needs the documents port's `contentVersion`.\n   */\n  contentChanged(id: string): Promise<void>\n  /** Open collaboration connections and loaded documents of this server. */\n  stats(): { connections: number, documents: number }\n  /** Disconnect every client, write pending stores and wait until all documents are unloaded. The server accepts no connection afterwards. */\n  close(): Promise<void>\n}\n\n/** ProseMirror document of stored JSON content: legacy nodes migrated, empty content replaced by the empty document, block IDs assigned. */\nfunction contentNode(schema: Schema, loaded: JSONContent) {\n  const content = migrateLegacyContent(loaded)\n  const node = schema.nodeFromJSON(content.type === 'doc' && content.content?.length ? content : EMPTY_EDITOR_CONTENT)\n  return assignBlockIds(node) ?? node\n}\n\n/** Whether a `document` Baustein of the stored Yjs content still carries the flat `meta.transcript` that `migrateLegacyContent` turns into a `rendition` child. */\nfunction hasFlatTranscript(fragment: Y.XmlFragment): boolean {\n  return !fragment.createTreeWalker((node) => {\n    if (!(node instanceof Y.XmlElement) || node.nodeName !== 'composite' || node.getAttribute('kind') !== 'document') return false\n    const meta: unknown = node.getAttribute('meta')\n    return typeof meta === 'object' && meta !== null && 'transcript' in meta && typeof meta.transcript === 'string'\n  }).next().done\n}\n\n/** Hocuspocus answers a thrown error's `reason` as permission-denied. */\nconst denied = (message: string, reason: string) => Object.assign(new Error(message), { reason })\n\n/** The `collabState` port; the collaboration server cannot run without it. */\nfunction collabStateOf(ports: EditorPorts): CollabStateStore {\n  if (!ports.collabState) throw new Error('@ecsplico/editor: collaboration needs the collabState port')\n  return ports.collabState\n}\n\n/**\n * The editor's collaboration server, independent of any web framework: Hocuspocus with the editor's hooks (seeding from\n * the stored JSON, versioned state, block-ID backfill, debounced `storeContent`/`storeState`) over `options.ports`.\n * `/nuxt` mounts one in Nitro; any Node/Bun/Deno process can serve `handleConnection` on its own websocket transport.\n */\nexport function createCollabServer(options: CollabServerOptions): CollabServer {\n  const { identity, documents } = options.ports\n  const state = collabStateOf(options.ports)\n  const authorize = (user: object, id: string) => options.hooks?.authorize ? options.hooks.authorize(user, id) : identity.authorize?.(user, id)\n  const contentVersion = (id: string) => options.hooks?.contentVersion ? options.hooks.contentVersion(id) : documents.contentVersion?.(id)\n\n  let schema: Schema | undefined\n  const collabSchema = () => schema ??= getSchema((options.schema ?? advancedSchemaExtensions)())\n\n  /** Loaded documents deleted via `forgetDocument`; a store still pending for them must not write their Yjs state back. */\n  const forgotten = new Set<string>()\n  /** `contentVersion` the loaded document's content mirror had when it was last read or written; only tracked for documents ports with `contentVersion`. */\n  const loadedVersions = new Map<string, string | null>()\n  /** Resolvers of `close()` waiting for the last document to unload. */\n  const idle: (() => void)[] = []\n  let closed = false\n\n  /** Merges content rewritten behind the editor's back into the open document and stores its state against `version`. */\n  async function mergeRewrite(id: string, document: Y.Doc, version: string | null): Promise<void> {\n    const rewritten = await documents.loadContent(id)\n    if (!rewritten) return // removed meanwhile: nothing to merge, nothing to mirror\n    // A diff-update: unchanged blocks keep their Yjs items, so connected clients see an ordinary edit and need no reload.\n    prosemirrorToYXmlFragment(contentNode(collabSchema(), rewritten), document.getXmlFragment(COLLAB_FIELD))\n    loadedVersions.set(id, version)\n    await state.storeState(id, encodeCollabState({ version, update: Y.encodeStateAsUpdate(document) }))\n  }\n\n  /** Stored state of a document, `null` when there is none usable: it was written against another content version and is removed. */\n  async function loadCurrentState(id: string, liveVersion: string | null | undefined): Promise<Uint8Array | null> {\n    const payload = await state.loadState(id)\n    if (!payload) return null\n    const { version, update } = decodeCollabState(payload)\n    if (isStateStale(version, liveVersion)) {\n      await state.removeState(id)\n      return null\n    }\n    return update\n  }\n\n  const hocuspocus = new Hocuspocus({\n    ...options.configuration,\n    async onAuthenticate({ context, token, requestHeaders, documentName, connectionConfig }) {\n      // The transport may know the user already; otherwise it comes from the upgrade request's headers or the client's token.\n      let user = context.user as object | null | undefined\n      if (!user) user = await identity.authenticate({ headers: requestHeaders, ...(token && { token }) })\n      if (!user) {\n        // After the permission-denied answer Hocuspocus sends: close the socket, so a client without credentials does not linger.\n        const socketCloser = context[REJECT] as (() => void) | undefined\n        socketCloser?.()\n        throw denied('Unauthorized', 'unauthorized')\n      }\n      const access = await authorize(user, documentName)\n      // `undefined`: no authorize hook, every authenticated user may edit. `null`: rejected; the thrown error's `reason` is answered as permission-denied.\n      if (access === null) throw denied('Forbidden', 'forbidden')\n      if (access?.readOnly) connectionConfig.readOnly = true\n      return { user }\n    },\n    async onLoadDocument({ documentName }) {\n      const currentSchema = collabSchema()\n      // Read before the content: a change in between leaves an older version on the state, which only costs a re-seed.\n      const version = await contentVersion(documentName)\n      const stored = await loadCurrentState(documentName, version)\n      if (version !== undefined) loadedVersions.set(documentName, version)\n      const persist = (doc: Y.Doc) => state.storeState(documentName, encodeCollabState({ version: version ?? null, update: Y.encodeStateAsUpdate(doc) }))\n      if (stored) {\n        // Decoded into a scratch doc: Hocuspocus only gets it once it is known to be current.\n        const doc = new Y.Doc()\n        Y.applyUpdate(doc, stored)\n        const fragment = doc.getXmlFragment(COLLAB_FIELD)\n        // State from before the composite family holds node names the schema no longer knows (any depth): drop it and\n        // reseed below from the migrated JSON mirror, which also rewrites the stored state.\n        const legacy = !fragment.createTreeWalker(node => node instanceof Y.XmlElement && node.nodeName === LEGACY_COMPOSITE_NODE).next().done\n        if (!legacy) {\n          // Blocks without an ID (state from before block IDs) and a `document` Baustein's flat `meta.transcript` (it\n          // became a `rendition` child): migrate here, before any client syncs, so clients never backfill concurrently.\n          // The diff-update keeps the Yjs items of everything that did not change.\n          const current = yXmlFragmentToProsemirror(currentSchema, fragment)\n          const migrated = hasFlatTranscript(fragment) ? currentSchema.nodeFromJSON(migrateLegacyContent(current.toJSON())) : current\n          const withIds = assignBlockIds(migrated) ?? (migrated === current ? null : migrated)\n          if (withIds) {\n            prosemirrorToYXmlFragment(withIds, fragment)\n            // Persist right away: a backfill after a restart would assign other IDs than clients already hold.\n            await persist(doc)\n          }\n          return doc\n        }\n      }\n      const loaded = await documents.loadContent(documentName)\n      if (!loaded) throw new Error('Dokument nicht gefunden') // Hocuspocus closes the connection\n      // No usable Yjs state (new, legacy, stale or restored document): seed it from the stored JSON, with block IDs.\n      const seeded = prosemirrorToYDoc(contentNode(currentSchema, loaded), COLLAB_FIELD)\n      // Persist right away: re-seeding later would create new Yjs items that duplicate what clients still hold.\n      await persist(seeded)\n      return seeded\n    },\n    async onStoreDocument({ documentName, document }) {\n      if (forgotten.has(documentName)) return\n      const tracked = loadedVersions.get(documentName)\n      const current = tracked === undefined ? undefined : await contentVersion(documentName)\n      if (current !== undefined && current !== tracked) {\n        // The content was rewritten behind the editor's back: writing the Yjs content back would clobber the rewrite.\n        // Merge the rewrite into the open document instead and store the state against the new version.\n        await mergeRewrite(documentName, document, current)\n        return\n      }\n      await documents.storeContent(documentName, yDocToProsemirrorJSON(document, COLLAB_FIELD))\n      // After the content: the write itself moves the version, and the state must carry the one it matches.\n      const version = await contentVersion(documentName)\n      if (version !== undefined) loadedVersions.set(documentName, version)\n      await state.storeState(documentName, encodeCollabState({ version: version ?? null, update: Y.encodeStateAsUpdate(document) }))\n    },\n    async afterUnloadDocument({ documentName }) {\n      forgotten.delete(documentName)\n      loadedVersions.delete(documentName)\n      if (hocuspocus.getDocumentsCount() === 0) idle.splice(0).forEach(resolve => resolve())\n    },\n  })\n\n  return {\n    hocuspocus,\n    schema: collabSchema,\n    handleConnection(socket, request, context = {}) {\n      if (closed) throw new Error('tiptap-editor: der Collab-Server ist geschlossen')\n      // Deferred: Hocuspocus answers permission-denied first, then the socket closes.\n      const reject = () => void setTimeout(() => socket.close(UNAUTHORIZED.code, UNAUTHORIZED.reason), 0)\n      return hocuspocus.handleConnection(socket, request, { ...context, [REJECT]: reject })\n    },\n    async forgetDocument(id) {\n      const doc = hocuspocus.documents.get(id)\n      if (doc) {\n        forgotten.add(id)\n        doc.broadcastStateless('deleted')\n        hocuspocus.closeConnections(id)\n      }\n      await state.removeState(id)\n    },\n    liveContent(id) {\n      const doc = hocuspocus.documents.get(id)\n      return doc ? yDocToProsemirrorJSON(doc, COLLAB_FIELD) as JSONContent : null\n    },\n    async contentChanged(id) {\n      const doc = hocuspocus.documents.get(id)\n      if (!doc || forgotten.has(id)) return\n      const tracked = loadedVersions.get(id)\n      if (tracked === undefined) return // no `contentVersion`: a rewrite cannot be told from the server's own writes\n      const current = await contentVersion(id)\n      if (current === undefined || current === tracked) return\n      await mergeRewrite(id, doc, current)\n    },\n    stats: () => ({ connections: hocuspocus.getConnectionsCount(), documents: hocuspocus.getDocumentsCount() }),\n    async close() {\n      closed = true\n      if (hocuspocus.getDocumentsCount() === 0) return\n      await new Promise<void>((resolve) => {\n        idle.push(resolve)\n        hocuspocus.closeConnections()\n        hocuspocus.flushPendingStores()\n      })\n    },\n  }\n}\n\nexport type { WebSocketLike }\n"],"mappings":"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"}

package/dist/server/crossref.js

@@ -0,0 +1,78 @@
+//#region src/server/crossref.ts
+/** A DOI as the body of the extract route may carry it. */
+const DOI_PATTERN = /^10\.\d{4,9}\/\S+$/;
+const DOI_IN_TEXT = /10\.\d{4,9}\/[^\s"<>]+/;
+/** The first DOI in `text`, without the punctuation that ends a sentence or closes a bracket; `null` when there is none. */
+function doiIn(text) {
+	const match = DOI_IN_TEXT.exec(text);
+	return match ? match[0].replace(/[.,;:)\]}]+$/, "") : null;
+}
+const CSL_TYPE_OF_CROSSREF = {
+	"journal-article": "article-journal",
+	"book": "book",
+	"monograph": "book",
+	"edited-book": "book",
+	"book-chapter": "chapter",
+	"proceedings-article": "paper-conference",
+	"dissertation": "thesis",
+	"report": "report",
+	"dataset": "dataset"
+};
+const namesOf = (people) => {
+	const names = (people ?? []).flatMap((person) => {
+		if (person.family || person.given) return [{
+			...person.family && { family: person.family },
+			...person.given && { given: person.given }
+		}];
+		return person.name ? [{ literal: person.name }] : [];
+	});
+	return names.length ? names : void 0;
+};
+/** The CSL-JSON item of a Crossref `message`, plus the work's title. Absent or empty fields are left out. */
+function cslFromCrossref(work) {
+	const year = work.issued?.["date-parts"]?.[0]?.[0];
+	const abstract = work.abstract?.replace(/<[^>]+>/g, "").trim();
+	return {
+		type: CSL_TYPE_OF_CROSSREF[work.type ?? ""] ?? "article",
+		...work.title?.[0] && { title: work.title[0] },
+		...namesOf(work.author) && { author: namesOf(work.author) },
+		...namesOf(work.editor) && { editor: namesOf(work.editor) },
+		...typeof year === "number" && { issued: { "date-parts": [[year]] } },
+		...work["container-title"]?.[0] && { "container-title": work["container-title"][0] },
+		...work.volume && { volume: work.volume },
+		...work.issue && { issue: work.issue },
+		...work.page && { page: work.page },
+		...work.publisher && { publisher: work.publisher },
+		...work["publisher-location"] && { "publisher-place": work["publisher-location"] },
+		...work.DOI && { DOI: work.DOI },
+		...work.ISBN?.[0] && { ISBN: work.ISBN[0] },
+		...work.URL && { URL: work.URL },
+		...abstract && { abstract },
+		...work.language && { language: work.language }
+	};
+}
+const TIMEOUT_MS = 1e4;
+/**
+* The Crossref record of `doi`; `null` when Crossref does not know it, answers with an error or cannot be reached
+* (offline, timeout): the caller falls back to model extraction.
+*/
+async function fetchCrossref(doi, signal) {
+	try {
+		const response = await fetch(`https://api.crossref.org/works/${encodeURIComponent(doi)}`, {
+			headers: {
+				"User-Agent": "ecsplico-editor",
+				"Accept": "application/json"
+			},
+			signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(TIMEOUT_MS)]) : AbortSignal.timeout(TIMEOUT_MS)
+		});
+		if (!response.ok) return null;
+		const body = await response.json();
+		return body.message ? cslFromCrossref(body.message) : null;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { DOI_PATTERN, cslFromCrossref, doiIn, fetchCrossref };
+
+//# sourceMappingURL=crossref.js.map

package/dist/server/crossref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossref.js","names":[],"sources":["../../src/server/crossref.ts"],"sourcesContent":["import type { CslItem, CslName, CslType } from '../core/backend-types'\n\n// Bibliographic data by DOI from the Crossref REST API (`https://api.crossref.org/works/<doi>`), as a CSL-JSON item.\n\n/** A DOI as the body of the extract route may carry it. */\nexport const DOI_PATTERN = /^10\\.\\d{4,9}\\/\\S+$/\n\nconst DOI_IN_TEXT = /10\\.\\d{4,9}\\/[^\\s\"<>]+/\n\n/** The first DOI in `text`, without the punctuation that ends a sentence or closes a bracket; `null` when there is none. */\nexport function doiIn(text: string): string | null {\n  const match = DOI_IN_TEXT.exec(text)\n  return match ? match[0].replace(/[.,;:)\\]}]+$/, '') : null\n}\n\nconst CSL_TYPE_OF_CROSSREF: Record<string, CslType> = {\n  'journal-article': 'article-journal',\n  'book': 'book',\n  'monograph': 'book',\n  'edited-book': 'book',\n  'book-chapter': 'chapter',\n  'proceedings-article': 'paper-conference',\n  'dissertation': 'thesis',\n  'report': 'report',\n  'dataset': 'dataset',\n}\n\ninterface CrossrefPerson { family?: string, given?: string, name?: string }\ninterface CrossrefWork {\n  'type'?: string\n  'title'?: string[]\n  'container-title'?: string[]\n  'author'?: CrossrefPerson[]\n  'editor'?: CrossrefPerson[]\n  'issued'?: { 'date-parts'?: (number | null)[][] }\n  'volume'?: string\n  'issue'?: string\n  'page'?: string\n  'publisher'?: string\n  'publisher-location'?: string\n  'DOI'?: string\n  'ISBN'?: string[]\n  'URL'?: string\n  'abstract'?: string\n  'language'?: string\n}\n\nconst namesOf = (people: CrossrefPerson[] | undefined): CslName[] | undefined => {\n  const names = (people ?? []).flatMap((person): CslName[] => {\n    if (person.family || person.given) return [{ ...(person.family && { family: person.family }), ...(person.given && { given: person.given }) }]\n    return person.name ? [{ literal: person.name }] : []\n  })\n  return names.length ? names : undefined\n}\n\n/** The CSL-JSON item of a Crossref `message`, plus the work's title. Absent or empty fields are left out. */\nexport function cslFromCrossref(work: CrossrefWork): CslItem & { title?: string } {\n  const year = work.issued?.['date-parts']?.[0]?.[0]\n  const abstract = work.abstract?.replace(/<[^>]+>/g, '').trim()\n  const item: CslItem & { title?: string } = {\n    type: CSL_TYPE_OF_CROSSREF[work.type ?? ''] ?? 'article',\n    ...(work.title?.[0] && { title: work.title[0] }),\n    ...(namesOf(work.author) && { author: namesOf(work.author) }),\n    ...(namesOf(work.editor) && { editor: namesOf(work.editor) }),\n    ...(typeof year === 'number' && { issued: { 'date-parts': [[year]] } }),\n    ...(work['container-title']?.[0] && { 'container-title': work['container-title'][0] }),\n    ...(work.volume && { volume: work.volume }),\n    ...(work.issue && { issue: work.issue }),\n    ...(work.page && { page: work.page }),\n    ...(work.publisher && { publisher: work.publisher }),\n    ...(work['publisher-location'] && { 'publisher-place': work['publisher-location'] }),\n    ...(work.DOI && { DOI: work.DOI }),\n    ...(work.ISBN?.[0] && { ISBN: work.ISBN[0] }),\n    ...(work.URL && { URL: work.URL }),\n    ...(abstract && { abstract }),\n    ...(work.language && { language: work.language }),\n  }\n  return item\n}\n\nconst TIMEOUT_MS = 10_000\n\n/**\n * The Crossref record of `doi`; `null` when Crossref does not know it, answers with an error or cannot be reached\n * (offline, timeout): the caller falls back to model extraction.\n */\nexport async function fetchCrossref(doi: string, signal?: AbortSignal): Promise<(CslItem & { title?: string }) | null> {\n  try {\n    const response = await fetch(`https://api.crossref.org/works/${encodeURIComponent(doi)}`, {\n      headers: { 'User-Agent': 'ecsplico-editor', 'Accept': 'application/json' },\n      signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(TIMEOUT_MS)]) : AbortSignal.timeout(TIMEOUT_MS),\n    })\n    if (!response.ok) return null\n    const body = await response.json() as { message?: CrossrefWork }\n    return body.message ? cslFromCrossref(body.message) : null\n  }\n  catch {\n    return null\n  }\n}\n"],"mappings":";;AAKA,MAAa,cAAc;AAE3B,MAAM,cAAc;;AAGpB,SAAgB,MAAM,MAA6B;CACjD,MAAM,QAAQ,YAAY,KAAK,IAAI;CACnC,OAAO,QAAQ,MAAM,EAAE,CAAC,QAAQ,gBAAgB,EAAE,IAAI;AACxD;AAEA,MAAM,uBAAgD;CACpD,mBAAmB;CACnB,QAAQ;CACR,aAAa;CACb,eAAe;CACf,gBAAgB;CAChB,uBAAuB;CACvB,gBAAgB;CAChB,UAAU;CACV,WAAW;AACb;AAsBA,MAAM,WAAW,WAAgE;CAC/E,MAAM,SAAS,UAAU,CAAC,EAAA,CAAG,SAAS,WAAsB;EAC1D,IAAI,OAAO,UAAU,OAAO,OAAO,OAAO,CAAC;GAAE,GAAI,OAAO,UAAU,EAAE,QAAQ,OAAO,OAAO;GAAI,GAAI,OAAO,SAAS,EAAE,OAAO,OAAO,MAAM;EAAG,CAAC;EAC5I,OAAO,OAAO,OAAO,CAAC,EAAE,SAAS,OAAO,KAAK,CAAC,IAAI,CAAC;CACrD,CAAC;CACD,OAAO,MAAM,SAAS,QAAQ,KAAA;AAChC;;AAGA,SAAgB,gBAAgB,MAAkD;CAChF,MAAM,OAAO,KAAK,SAAS,aAAa,GAAG,EAAE,GAAG;CAChD,MAAM,WAAW,KAAK,UAAU,QAAQ,YAAY,EAAE,CAAC,CAAC,KAAK;CAmB7D,OAAO;EAjBL,MAAM,qBAAqB,KAAK,QAAQ,OAAO;EAC/C,GAAI,KAAK,QAAQ,MAAM,EAAE,OAAO,KAAK,MAAM,GAAG;EAC9C,GAAI,QAAQ,KAAK,MAAM,KAAK,EAAE,QAAQ,QAAQ,KAAK,MAAM,EAAE;EAC3D,GAAI,QAAQ,KAAK,MAAM,KAAK,EAAE,QAAQ,QAAQ,KAAK,MAAM,EAAE;EAC3D,GAAI,OAAO,SAAS,YAAY,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE;EACrE,GAAI,KAAK,kBAAkB,GAAG,MAAM,EAAE,mBAAmB,KAAK,kBAAkB,CAAC,GAAG;EACpF,GAAI,KAAK,UAAU,EAAE,QAAQ,KAAK,OAAO;EACzC,GAAI,KAAK,SAAS,EAAE,OAAO,KAAK,MAAM;EACtC,GAAI,KAAK,QAAQ,EAAE,MAAM,KAAK,KAAK;EACnC,GAAI,KAAK,aAAa,EAAE,WAAW,KAAK,UAAU;EAClD,GAAI,KAAK,yBAAyB,EAAE,mBAAmB,KAAK,sBAAsB;EAClF,GAAI,KAAK,OAAO,EAAE,KAAK,KAAK,IAAI;EAChC,GAAI,KAAK,OAAO,MAAM,EAAE,MAAM,KAAK,KAAK,GAAG;EAC3C,GAAI,KAAK,OAAO,EAAE,KAAK,KAAK,IAAI;EAChC,GAAI,YAAY,EAAE,SAAS;EAC3B,GAAI,KAAK,YAAY,EAAE,UAAU,KAAK,SAAS;CAEvC;AACZ;AAEA,MAAM,aAAa;;;;;AAMnB,eAAsB,cAAc,KAAa,QAAsE;CACrH,IAAI;EACF,MAAM,WAAW,MAAM,MAAM,kCAAkC,mBAAmB,GAAG,KAAK;GACxF,SAAS;IAAE,cAAc;IAAmB,UAAU;GAAmB;GACzE,QAAQ,SAAS,YAAY,IAAI,CAAC,QAAQ,YAAY,QAAQ,UAAU,CAAC,CAAC,IAAI,YAAY,QAAQ,UAAU;EAC9G,CAAC;EACD,IAAI,CAAC,SAAS,IAAI,OAAO;EACzB,MAAM,OAAO,MAAM,SAAS,KAAK;EACjC,OAAO,KAAK,UAAU,gBAAgB,KAAK,OAAO,IAAI;CACxD,QACM;EACJ,OAAO;CACT;AACF"}

package/dist/server/errors.d.ts

@@ -2,7 +2,7 @@
 /**
  * A request the server answers with an HTTP status: the handlers and the model utilities throw it instead of a
  * framework error, so they run in any Node server. A transport maps `statusCode`/`statusMessage` (and `headers`, e.g.
- * `Retry-After` of a 429) onto its response; the Nuxt routes hand it to Nitro's `createError`.
+ * `Retry-After` of a 429) onto its response; `server/h3.ts` hands it to Nitro's `createError`.
  */
 export declare class HttpError extends Error {
   readonly statusCode: number;

package/dist/server/errors.js

@@ -2,7 +2,7 @@
 /**
 * A request the server answers with an HTTP status: the handlers and the model utilities throw it instead of a
 * framework error, so they run in any Node server. A transport maps `statusCode`/`statusMessage` (and `headers`, e.g.
-* `Retry-After` of a 429) onto its response; the Nuxt routes hand it to Nitro's `createError`.
+* `Retry-After` of a 429) onto its response; `server/h3.ts` hands it to Nitro's `createError`.
 */
 var HttpError = class extends Error {
 	statusCode;

package/dist/server/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/server/errors.ts"],"sourcesContent":["/**\n * A request the server answers with an HTTP status: the handlers and the model utilities throw it instead of a\n * framework error, so they run in any Node server. A transport maps `statusCode`/`statusMessage` (and `headers`, e.g.\n * `Retry-After` of a 429) onto its response; the Nuxt routes hand it to Nitro's `createError`.\n */\nexport class HttpError extends Error {\n  readonly statusCode: number\n  readonly statusMessage: string\n  /** Response headers the answer needs (`Retry-After`). */\n  readonly headers: Readonly<Record<string, string>>\n  /** Machine-readable detail (the validation issues of a 400). */\n  readonly data: unknown\n\n  constructor(statusCode: number, statusMessage: string, headers: Record<string, string> = {}, data?: unknown) {\n    super(statusMessage)\n    this.name = 'HttpError'\n    this.statusCode = statusCode\n    this.statusMessage = statusMessage\n    this.headers = headers\n    this.data = data\n  }\n}\n"],"mappings":";;;;;;AAKA,IAAa,YAAb,cAA+B,MAAM;CACnC;CACA;;CAEA;;CAEA;CAEA,YAAY,YAAoB,eAAuB,UAAkC,CAAC,GAAG,MAAgB;EAC3G,MAAM,aAAa;EACnB,KAAK,OAAO;EACZ,KAAK,aAAa;EAClB,KAAK,gBAAgB;EACrB,KAAK,UAAU;EACf,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/server/errors.ts"],"sourcesContent":["/**\n * A request the server answers with an HTTP status: the handlers and the model utilities throw it instead of a\n * framework error, so they run in any Node server. A transport maps `statusCode`/`statusMessage` (and `headers`, e.g.\n * `Retry-After` of a 429) onto its response; `server/h3.ts` hands it to Nitro's `createError`.\n */\nexport class HttpError extends Error {\n  readonly statusCode: number\n  readonly statusMessage: string\n  /** Response headers the answer needs (`Retry-After`). */\n  readonly headers: Readonly<Record<string, string>>\n  /** Machine-readable detail (the validation issues of a 400). */\n  readonly data: unknown\n\n  constructor(statusCode: number, statusMessage: string, headers: Record<string, string> = {}, data?: unknown) {\n    super(statusMessage)\n    this.name = 'HttpError'\n    this.statusCode = statusCode\n    this.statusMessage = statusMessage\n    this.headers = headers\n    this.data = data\n  }\n}\n"],"mappings":";;;;;;AAKA,IAAa,YAAb,cAA+B,MAAM;CACnC;CACA;;CAEA;;CAEA;CAEA,YAAY,YAAoB,eAAuB,UAAkC,CAAC,GAAG,MAAgB;EAC3G,MAAM,aAAa;EACnB,KAAK,OAAO;EACZ,KAAK,aAAa;EAClB,KAAK,gBAAgB;EACrB,KAAK,UAAU;EACf,KAAK,OAAO;CACd;AACF"}

package/dist/server/extract.js

@@ -0,0 +1,308 @@
+import { HttpError } from "./errors.js";
+import { upstreamError } from "./ai.js";
+import { CSL_TYPES } from "../core/backend-types.js";
+import { doiIn, fetchCrossref } from "./crossref.js";
+import { z } from "zod";
+import { Output, generateText } from "ai";
+//#region src/server/extract.ts
+/** Largest asset sent to speech-to-text (the limit of OpenAI's `/audio/transcriptions`; applied to every provider, since the asset is held in memory). */
+const MAX_TRANSCRIBE_BYTES = 26214400;
+/** Resolution of the page images sent to the OCR model. */
+const OCR_SCALE = 1.5;
+const OCR_CONCURRENCY = 2;
+const BIBLIOGRAPHY_TEXT_LIMIT = 12e3;
+const OCR_PROMPT = "Lies den gesamten Text dieser Seite aus dem Bild und gib ihn als Markdown wieder: Überschriften als Markdown-Überschriften, Absätze durch Leerzeilen getrennt, Listen als Aufzählung, Tabellen als Markdown-Tabelle. Behalte die Lesereihenfolge bei, lass Kopf-, Fußzeilen und Seitenzahlen weg und füge nichts hinzu. Antworte nur mit dem Text der Seite, ohne Einleitung und ohne Codeblock. Enthält die Seite keinen Text, antworte mit einer leeren Antwort.";
+const DESCRIBE_PROMPT = "Beschreibe dieses Bild sachlich in 1 bis 3 Absätzen auf Deutsch: was zu sehen ist (Motiv, Aufbau, Diagramme mit ihren Werten), jeden lesbaren Text im Bild wörtlich und den erkennbaren Zusammenhang. Erfinde nichts, was nicht zu sehen ist. Antworte nur mit der Beschreibung.";
+const BIB_PROMPT = "Ermittle die bibliographischen Angaben des Werks aus dem folgenden Text seiner ersten Seiten (Titelseite, Kopfzeile, Impressum, Zitierhinweis). Gib nur Angaben an, die im Text stehen; lass alles Unbekannte weg. Namen als Familienname und Vorname getrennt, `year` ist das Erscheinungsjahr, `type` die passende CSL-Art (Zeitschriftenartikel: article-journal, Buch: book, Beitrag in Sammelband: chapter, Konferenzbeitrag: paper-conference, Abschlussarbeit: thesis, Bericht: report, sonst article).";
+/** A page of the PDF could not be rendered to an image (no `@napi-rs/canvas`, or rendering failed): OCR is unavailable. */
+var RasterError = class extends Error {};
+/** `text` with a wrapping Markdown code fence removed (models often fence their answer). */
+function unfenced(text) {
+	const match = /^```(?:markdown|md)?\s*\n([\s\S]*?)\n?```\s*$/i.exec(text.trim());
+	return (match ? match[1] : text).trim();
+}
+/** Runs a model call: its failures become the 502 of `upstreamError`; an abort of `signal` passes through unchanged. */
+async function modelCall(signal, run) {
+	try {
+		return await run();
+	} catch (error) {
+		if (error instanceof HttpError || signal?.aborted) throw error;
+		throw upstreamError(error);
+	}
+}
+/** The pages as one Markdown text: `<!-- page N -->` marks the start of every page after the first. */
+function joinPages(pages) {
+	return pages.map((text, index) => index === 0 ? text : `<!-- page ${index + 1} -->\n\n${text}`).join("\n\n");
+}
+/** Timed segments out of a provider's list: entries without text or numeric `start`/`end` are skipped. */
+function timedSegments(list, textKey) {
+	if (!Array.isArray(list)) return [];
+	return list.flatMap((entry) => {
+		if (!entry || typeof entry !== "object") return [];
+		const { start, end } = entry;
+		const raw = entry[textKey];
+		const text = typeof raw === "string" ? raw.trim() : "";
+		return text && typeof start === "number" && typeof end === "number" ? [{
+			start,
+			end,
+			text
+		}] : [];
+	});
+}
+function transcriptionResult(segments, text) {
+	if (segments.length) return {
+		markdown: segments.map((segment) => segment.text).join("\n\n"),
+		segments
+	};
+	return { markdown: typeof text === "string" ? text.trim() : "" };
+}
+/**
+* The provider's request: OpenAI-compatible `<endpoint>/audio/transcriptions` as multipart with segment timestamps
+* (`verbose_json`), or Deepgram's `<endpoint>/listen` with the raw bytes and utterances.
+*/
+function transcriptionRequest(config, asset) {
+	const endpoint = config.endpoint.replace(/\/+$/, "");
+	if (config.provider === "deepgram") {
+		const query = new URLSearchParams({
+			model: config.model,
+			smart_format: "true",
+			utterances: "true"
+		});
+		if (config.language) query.set("language", config.language);
+		else query.set("detect_language", "true");
+		return {
+			url: `${endpoint}/listen?${query}`,
+			init: {
+				method: "POST",
+				headers: {
+					"Content-Type": asset.record.mimeType,
+					...config.apiKey && { Authorization: `Token ${config.apiKey}` }
+				},
+				body: new Uint8Array(asset.data)
+			}
+		};
+	}
+	const form = new FormData();
+	form.append("file", new Blob([new Uint8Array(asset.data)], { type: asset.record.mimeType }), asset.record.filename);
+	form.append("model", config.model);
+	form.append("response_format", "verbose_json");
+	form.append("timestamp_granularities[]", "segment");
+	if (config.language) form.append("language", config.language);
+	return {
+		url: `${endpoint}/audio/transcriptions`,
+		init: {
+			method: "POST",
+			headers: config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : void 0,
+			body: form
+		}
+	};
+}
+/** The provider's answer as text plus timed segments; an OpenAI-compatible endpoint may answer in plain text. */
+function transcriptionResponse(config, raw) {
+	let body = null;
+	try {
+		const parsed = JSON.parse(raw);
+		if (parsed && typeof parsed === "object") body = parsed;
+	} catch {}
+	if (config.provider === "deepgram") {
+		const results = body?.results ?? {};
+		return transcriptionResult(timedSegments(results.utterances, "transcript"), results.channels?.[0]?.alternatives?.[0]?.transcript);
+	}
+	if (!body) return { markdown: raw };
+	return transcriptionResult(timedSegments(body.segments, "text"), body.text);
+}
+/**
+* Speech-to-text through the configured provider (`TranscriptionConfig.provider`) with segment timestamps. An
+* answer without segments yields the text only. Unreachable endpoint and non-2xx answers are 502.
+*/
+async function transcribe(config, asset, signal) {
+	const { url, init } = transcriptionRequest(config, asset);
+	let response;
+	try {
+		response = await fetch(url, {
+			...init,
+			signal
+		});
+	} catch (err) {
+		if (signal?.aborted) throw err;
+		throw new HttpError(502, `Transkriptions-Endpunkt: ${err instanceof Error ? err.message : String(err)}`);
+	}
+	if (!response.ok) throw new HttpError(502, `Transkriptions-Endpunkt: ${response.status} ${response.statusText}`.trim());
+	return transcriptionResponse(config, (await response.text()).trim());
+}
+/** The text layer of the first `count` pages, one string per page. An abort of `signal` stops between pages. */
+async function pdfPagesText(pdf, count, signal) {
+	const pages = [];
+	for (let page = 1; page <= count; page++) {
+		signal?.throwIfAborted();
+		pages.push(await pdf.pageText(page));
+	}
+	return pages;
+}
+/** True when the pages' text layer is too thin to be a real one: fewer than `MIN_TEXT_CHARS_PER_PAGE` characters per page on average. */
+function isScanned(pages) {
+	return pages.reduce((sum, text) => sum + text.length, 0) / Math.max(1, pages.length) < 50;
+}
+/**
+* OCR of the first `count` pages through a vision-capable model: each page is rendered to a PNG and sent as an image
+* part; two pages run at a time. `resolveModel` is called after page 1 rendered, so a server that cannot render never
+* needs a model. A rendering failure throws `RasterError`, a model failure the 502 of `upstreamError`.
+*/
+async function ocrPages(pdf, count, resolveModel, signal) {
+	const render = async (page) => {
+		try {
+			return await pdf.pagePng(page, OCR_SCALE);
+		} catch (error) {
+			throw new RasterError(error instanceof Error ? error.message : String(error), { cause: error });
+		}
+	};
+	const first = await render(1);
+	const model = await resolveModel();
+	const pages = Array.from({ length: count }, () => "");
+	let next = 0;
+	let failed = false;
+	const worker = async () => {
+		while (!failed && next < count) {
+			signal?.throwIfAborted();
+			const index = next++;
+			try {
+				const png = index === 0 ? first : await render(index + 1);
+				const result = await modelCall(signal, () => generateText({
+					model,
+					abortSignal: signal,
+					messages: [{
+						role: "user",
+						content: [{
+							type: "text",
+							text: OCR_PROMPT
+						}, {
+							type: "file",
+							data: png,
+							mediaType: "image/png"
+						}]
+					}]
+				}));
+				pages[index] = unfenced(result.text);
+			} catch (error) {
+				failed = true;
+				throw error;
+			}
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(OCR_CONCURRENCY, count) }, worker));
+	return pages;
+}
+/** A German description of the image `data` (content, text in the image, context) through a vision-capable model. */
+async function describeImage(model, data, mimeType, signal) {
+	return unfenced((await modelCall(signal, () => generateText({
+		model,
+		abortSignal: signal,
+		messages: [{
+			role: "user",
+			content: [{
+				type: "text",
+				text: DESCRIBE_PROMPT
+			}, {
+				type: "file",
+				data,
+				mediaType: mimeType
+			}]
+		}]
+	}))).text);
+}
+const nameSchema = z.object({
+	family: z.string().optional(),
+	given: z.string().optional(),
+	literal: z.string().optional()
+});
+const bibliographySchema = z.object({
+	title: z.string().optional(),
+	type: z.enum(CSL_TYPES),
+	author: z.array(nameSchema).optional(),
+	year: z.number().int().optional(),
+	"container-title": z.string().optional(),
+	volume: z.string().optional(),
+	issue: z.string().optional(),
+	page: z.string().optional(),
+	publisher: z.string().optional(),
+	"publisher-place": z.string().optional(),
+	DOI: z.string().optional(),
+	ISBN: z.string().optional(),
+	URL: z.string().optional(),
+	abstract: z.string().optional(),
+	language: z.string().optional()
+});
+const STRING_FIELDS = [
+	"container-title",
+	"volume",
+	"issue",
+	"page",
+	"publisher",
+	"publisher-place",
+	"DOI",
+	"ISBN",
+	"URL",
+	"abstract",
+	"language"
+];
+/** The CSL item of the model's answer: empty strings and nameless authors dropped, `year` as `issued`. */
+function cslFromModel(answer) {
+	const author = (answer.author ?? []).flatMap((name) => {
+		const clean = {
+			...name.family?.trim() && { family: name.family.trim() },
+			...name.given?.trim() && { given: name.given.trim() },
+			...name.literal?.trim() && { literal: name.literal.trim() }
+		};
+		return Object.keys(clean).length ? [clean] : [];
+	});
+	const item = { type: answer.type };
+	if (answer.title?.trim()) item.title = answer.title.trim();
+	if (author.length) item.author = author;
+	if (answer.year) item.issued = { "date-parts": [[answer.year]] };
+	for (const key of STRING_FIELDS) {
+		const value = answer[key]?.trim();
+		if (value) item[key] = value;
+	}
+	return item;
+}
+/**
+* Bibliographic data of a work: from Crossref by `doi` (given, else the first DOI in `text`), else — no DOI, Crossref
+* unreachable or without the record — extracted from `text` (the first pages) by the model. Falling back after a
+* Crossref attempt adds the warning `crossref-unavailable`. 422 when nothing can be found.
+*/
+async function extractBibliography(options) {
+	const { signal } = options;
+	const doi = options.doi ?? doiIn(options.text);
+	const warnings = [];
+	if (doi) {
+		const item = await fetchCrossref(doi, signal);
+		if (item) return {
+			bib: item,
+			warnings
+		};
+		warnings.push("crossref-unavailable");
+	}
+	const text = options.text.trim().slice(0, BIBLIOGRAPHY_TEXT_LIMIT);
+	if (!text) throw new HttpError(422, doi ? "Literaturangaben nicht verfügbar: Crossref nicht erreichbar und kein Text zum Auswerten" : "Keine Literaturangaben gefunden");
+	const model = await options.resolveModel();
+	const bib = cslFromModel((await modelCall(signal, () => generateText({
+		model,
+		abortSignal: signal,
+		output: Output.object({ schema: bibliographySchema }),
+		messages: [{
+			role: "user",
+			content: `${BIB_PROMPT}\n\n${text}`
+		}]
+	}))).output);
+	if (doi && !bib.DOI) bib.DOI = doi;
+	return {
+		bib,
+		warnings
+	};
+}
+/** The text the bibliography is read from: the first pages of the document. */
+const bibliographyText = (pages) => pages.slice(0, 2).join("\n\n");
+//#endregion
+export { MAX_TRANSCRIBE_BYTES, RasterError, bibliographyText, describeImage, extractBibliography, isScanned, joinPages, ocrPages, pdfPagesText, transcribe };
+
+//# sourceMappingURL=extract.js.map

package/dist/server/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","names":[],"sources":["../../src/server/extract.ts"],"sourcesContent":["import { generateText, type LanguageModel, Output } from 'ai'\nimport { z } from 'zod'\nimport { CSL_TYPES, type CslItem, type CslName } from '../core/backend-types'\nimport type { TranscriptionConfig } from '../config'\nimport type { AssetRecord } from '../features/media/assets'\nimport { upstreamError } from './ai'\nimport { doiIn, fetchCrossref } from './crossref'\nimport { HttpError } from './errors'\nimport type { PdfFile } from './pdf'\n\n// The extraction methods behind `POST /api/ai/extract` (`extractPost`): transcription, PDF text and OCR, image\n// description and bibliographic data. Each takes the asset's bytes and returns Markdown (or a CSL item).\n\n/** Largest asset sent to speech-to-text (the limit of OpenAI's `/audio/transcriptions`; applied to every provider, since the asset is held in memory). */\nexport const MAX_TRANSCRIBE_BYTES = 25 * 1024 * 1024\n\n/** Pages whose text layer averages fewer characters than this count as scanned: `auto` then reads them with OCR. */\nexport const MIN_TEXT_CHARS_PER_PAGE = 50\n/** Resolution of the page images sent to the OCR model. */\nconst OCR_SCALE = 1.5\nconst OCR_CONCURRENCY = 2\n/** OCR makes one vision-model call per page: it reads at most this many pages (`ocr-truncated` warns about the rest), whatever `maxPages` allows. */\nexport const MAX_OCR_PAGES = 50\n\n/** The first pages of a PDF are where its DOI and bibliographic data are looked for; the model gets at most `BIBLIOGRAPHY_TEXT_LIMIT` characters of them. */\nexport const BIBLIOGRAPHY_PAGES = 2\nconst BIBLIOGRAPHY_TEXT_LIMIT = 12000\n\n// i18n-ignore-start: model-facing prompts (German prompt text, not UI)\nconst OCR_PROMPT = 'Lies den gesamten Text dieser Seite aus dem Bild und gib ihn als Markdown wieder: Überschriften als Markdown-Überschriften, Absätze durch Leerzeilen getrennt, Listen als Aufzählung, Tabellen als Markdown-Tabelle. Behalte die Lesereihenfolge bei, lass Kopf-, Fußzeilen und Seitenzahlen weg und füge nichts hinzu. Antworte nur mit dem Text der Seite, ohne Einleitung und ohne Codeblock. Enthält die Seite keinen Text, antworte mit einer leeren Antwort.'\nconst DESCRIBE_PROMPT = 'Beschreibe dieses Bild sachlich in 1 bis 3 Absätzen auf Deutsch: was zu sehen ist (Motiv, Aufbau, Diagramme mit ihren Werten), jeden lesbaren Text im Bild wörtlich und den erkennbaren Zusammenhang. Erfinde nichts, was nicht zu sehen ist. Antworte nur mit der Beschreibung.'\nconst BIB_PROMPT = 'Ermittle die bibliographischen Angaben des Werks aus dem folgenden Text seiner ersten Seiten (Titelseite, Kopfzeile, Impressum, Zitierhinweis). Gib nur Angaben an, die im Text stehen; lass alles Unbekannte weg. Namen als Familienname und Vorname getrennt, `year` ist das Erscheinungsjahr, `type` die passende CSL-Art (Zeitschriftenartikel: article-journal, Buch: book, Beitrag in Sammelband: chapter, Konferenzbeitrag: paper-conference, Abschlussarbeit: thesis, Bericht: report, sonst article).'\n// i18n-ignore-end\n\n/** A page of the PDF could not be rendered to an image (no `@napi-rs/canvas`, or rendering failed): OCR is unavailable. */\nexport class RasterError extends Error {}\n\n/** `text` with a wrapping Markdown code fence removed (models often fence their answer). */\nfunction unfenced(text: string): string {\n  const match = /^```(?:markdown|md)?\\s*\\n([\\s\\S]*?)\\n?```\\s*$/i.exec(text.trim())\n  return (match ? match[1]! : text).trim()\n}\n\n/** Runs a model call: its failures become the 502 of `upstreamError`; an abort of `signal` passes through unchanged. */\nasync function modelCall<T>(signal: AbortSignal | undefined, run: () => Promise<T>): Promise<T> {\n  try {\n    return await run()\n  }\n  catch (error) {\n    if (error instanceof HttpError || signal?.aborted) throw error\n    throw upstreamError(error)\n  }\n}\n\n/** The pages as one Markdown text: `<!-- page N -->` marks the start of every page after the first. */\nexport function joinPages(pages: readonly string[]): string {\n  return pages.map((text, index) => index === 0 ? text : `<!-- page ${index + 1} -->\\n\\n${text}`).join('\\n\\n')\n}\n\nexport interface TranscriptionResult { markdown: string, segments?: { start: number, end: number, text: string }[] }\n\ntype Segment = NonNullable<TranscriptionResult['segments']>[number]\n\n/** Timed segments out of a provider's list: entries without text or numeric `start`/`end` are skipped. */\nfunction timedSegments(list: unknown, textKey: 'text' | 'transcript'): Segment[] {\n  if (!Array.isArray(list)) return []\n  return list.flatMap((entry: unknown) => {\n    if (!entry || typeof entry !== 'object') return []\n    const { start, end } = entry as { start?: unknown, end?: unknown }\n    const raw: unknown = (entry as Record<string, unknown>)[textKey]\n    const text = typeof raw === 'string' ? raw.trim() : ''\n    return text && typeof start === 'number' && typeof end === 'number' ? [{ start, end, text }] : []\n  })\n}\n\nfunction transcriptionResult(segments: Segment[], text: unknown): TranscriptionResult {\n  if (segments.length) return { markdown: segments.map(segment => segment.text).join('\\n\\n'), segments }\n  return { markdown: typeof text === 'string' ? text.trim() : '' }\n}\n\n/**\n * The provider's request: OpenAI-compatible `<endpoint>/audio/transcriptions` as multipart with segment timestamps\n * (`verbose_json`), or Deepgram's `<endpoint>/listen` with the raw bytes and utterances.\n */\nfunction transcriptionRequest(config: TranscriptionConfig, asset: { record: AssetRecord, data: Uint8Array }): { url: string, init: RequestInit } {\n  const endpoint = config.endpoint.replace(/\\/+$/, '')\n  if (config.provider === 'deepgram') {\n    const query = new URLSearchParams({ model: config.model, smart_format: 'true', utterances: 'true' })\n    if (config.language) query.set('language', config.language)\n    else query.set('detect_language', 'true')\n    return {\n      url: `${endpoint}/listen?${query}`,\n      init: {\n        method: 'POST',\n        headers: { 'Content-Type': asset.record.mimeType, ...(config.apiKey && { Authorization: `Token ${config.apiKey}` }) },\n        body: new Uint8Array(asset.data),\n      },\n    }\n  }\n  const form = new FormData()\n  form.append('file', new Blob([new Uint8Array(asset.data)], { type: asset.record.mimeType }), asset.record.filename)\n  form.append('model', config.model)\n  form.append('response_format', 'verbose_json')\n  form.append('timestamp_granularities[]', 'segment')\n  if (config.language) form.append('language', config.language)\n  return {\n    url: `${endpoint}/audio/transcriptions`,\n    init: { method: 'POST', headers: config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : undefined, body: form },\n  }\n}\n\n/** The provider's answer as text plus timed segments; an OpenAI-compatible endpoint may answer in plain text. */\nfunction transcriptionResponse(config: TranscriptionConfig, raw: string): TranscriptionResult {\n  let body: Record<string, unknown> | null = null\n  try {\n    const parsed: unknown = JSON.parse(raw)\n    if (parsed && typeof parsed === 'object') body = parsed as Record<string, unknown>\n  }\n  catch {\n    // plain text answer\n  }\n  if (config.provider === 'deepgram') {\n    // { results: { utterances: [{ start, end, transcript }], channels: [{ alternatives: [{ transcript }] }] } }\n    const results = (body?.results ?? {}) as { utterances?: unknown, channels?: { alternatives?: { transcript?: unknown }[] }[] }\n    return transcriptionResult(timedSegments(results.utterances, 'transcript'), results.channels?.[0]?.alternatives?.[0]?.transcript)\n  }\n  if (!body) return { markdown: raw }\n  return transcriptionResult(timedSegments(body.segments, 'text'), body.text)\n}\n\n/**\n * Speech-to-text through the configured provider (`TranscriptionConfig.provider`) with segment timestamps. An\n * answer without segments yields the text only. Unreachable endpoint and non-2xx answers are 502.\n */\nexport async function transcribe(config: TranscriptionConfig, asset: { record: AssetRecord, data: Uint8Array }, signal: AbortSignal | undefined): Promise<TranscriptionResult> {\n  const { url, init } = transcriptionRequest(config, asset)\n  let response: Response\n  try {\n    response = await fetch(url, { ...init, signal })\n  }\n  catch (err) {\n    if (signal?.aborted) throw err\n    throw new HttpError(502, `Transkriptions-Endpunkt: ${err instanceof Error ? err.message : String(err)}`)\n  }\n  if (!response.ok) throw new HttpError(502, `Transkriptions-Endpunkt: ${response.status} ${response.statusText}`.trim())\n  return transcriptionResponse(config, (await response.text()).trim())\n}\n\n/** The text layer of the first `count` pages, one string per page. An abort of `signal` stops between pages. */\nexport async function pdfPagesText(pdf: PdfFile, count: number, signal?: AbortSignal): Promise<string[]> {\n  const pages: string[] = []\n  for (let page = 1; page <= count; page++) {\n    signal?.throwIfAborted()\n    pages.push(await pdf.pageText(page))\n  }\n  return pages\n}\n\n/** True when the pages' text layer is too thin to be a real one: fewer than `MIN_TEXT_CHARS_PER_PAGE` characters per page on average. */\nexport function isScanned(pages: readonly string[]): boolean {\n  return pages.reduce((sum, text) => sum + text.length, 0) / Math.max(1, pages.length) < MIN_TEXT_CHARS_PER_PAGE\n}\n\n/**\n * OCR of the first `count` pages through a vision-capable model: each page is rendered to a PNG and sent as an image\n * part; two pages run at a time. `resolveModel` is called after page 1 rendered, so a server that cannot render never\n * needs a model. A rendering failure throws `RasterError`, a model failure the 502 of `upstreamError`.\n */\nexport async function ocrPages(pdf: PdfFile, count: number, resolveModel: () => Promise<LanguageModel>, signal: AbortSignal | undefined): Promise<string[]> {\n  const render = async (page: number): Promise<Uint8Array> => {\n    try {\n      return await pdf.pagePng(page, OCR_SCALE)\n    }\n    catch (error) {\n      throw new RasterError(error instanceof Error ? error.message : String(error), { cause: error })\n    }\n  }\n  const first = await render(1)\n  const model = await resolveModel()\n\n  const pages: string[] = Array.from({ length: count }, () => '')\n  let next = 0\n  let failed = false\n  const worker = async () => {\n    while (!failed && next < count) {\n      signal?.throwIfAborted()\n      const index = next++\n      try {\n        const png = index === 0 ? first : await render(index + 1)\n        const result = await modelCall(signal, () => generateText({\n          model,\n          abortSignal: signal,\n          // A `file` part with an image media type: the `image` part type is deprecated in AI SDK 7.\n          messages: [{ role: 'user', content: [{ type: 'text', text: OCR_PROMPT }, { type: 'file', data: png, mediaType: 'image/png' }] }],\n        }))\n        pages[index] = unfenced(result.text)\n      }\n      catch (error) {\n        failed = true\n        throw error\n      }\n    }\n  }\n  await Promise.all(Array.from({ length: Math.min(OCR_CONCURRENCY, count) }, worker))\n  return pages\n}\n\n/** A German description of the image `data` (content, text in the image, context) through a vision-capable model. */\nexport async function describeImage(model: LanguageModel, data: Uint8Array, mimeType: string, signal: AbortSignal | undefined): Promise<string> {\n  const result = await modelCall(signal, () => generateText({\n    model,\n    abortSignal: signal,\n    messages: [{ role: 'user', content: [{ type: 'text', text: DESCRIBE_PROMPT }, { type: 'file', data, mediaType: mimeType }] }],\n  }))\n  return unfenced(result.text)\n}\n\nconst nameSchema = z.object({ family: z.string().optional(), given: z.string().optional(), literal: z.string().optional() })\nconst bibliographySchema = z.object({\n  title: z.string().optional(),\n  type: z.enum(CSL_TYPES),\n  author: z.array(nameSchema).optional(),\n  year: z.number().int().optional(),\n  'container-title': z.string().optional(),\n  volume: z.string().optional(),\n  issue: z.string().optional(),\n  page: z.string().optional(),\n  publisher: z.string().optional(),\n  'publisher-place': z.string().optional(),\n  DOI: z.string().optional(),\n  ISBN: z.string().optional(),\n  URL: z.string().optional(),\n  abstract: z.string().optional(),\n  language: z.string().optional(),\n})\n\nconst STRING_FIELDS = ['container-title', 'volume', 'issue', 'page', 'publisher', 'publisher-place', 'DOI', 'ISBN', 'URL', 'abstract', 'language'] as const\n\n/** The CSL item of the model's answer: empty strings and nameless authors dropped, `year` as `issued`. */\nfunction cslFromModel(answer: z.infer<typeof bibliographySchema>): CslItem & { title?: string } {\n  const author = (answer.author ?? []).flatMap((name): CslName[] => {\n    const clean: CslName = { ...(name.family?.trim() && { family: name.family.trim() }), ...(name.given?.trim() && { given: name.given.trim() }), ...(name.literal?.trim() && { literal: name.literal.trim() }) }\n    return Object.keys(clean).length ? [clean] : []\n  })\n  const item: CslItem & { title?: string } = { type: answer.type as CslItem['type'] }\n  if (answer.title?.trim()) item.title = answer.title.trim()\n  if (author.length) item.author = author\n  if (answer.year) item.issued = { 'date-parts': [[answer.year]] }\n  for (const key of STRING_FIELDS) {\n    const value = answer[key]?.trim()\n    if (value) item[key] = value\n  }\n  return item\n}\n\n/**\n * Bibliographic data of a work: from Crossref by `doi` (given, else the first DOI in `text`), else — no DOI, Crossref\n * unreachable or without the record — extracted from `text` (the first pages) by the model. Falling back after a\n * Crossref attempt adds the warning `crossref-unavailable`. 422 when nothing can be found.\n */\nexport async function extractBibliography(options: { doi?: string, text: string, resolveModel: () => Promise<LanguageModel>, signal: AbortSignal | undefined }): Promise<{ bib: CslItem & { title?: string }, warnings: string[] }> {\n  const { signal } = options\n  const doi = options.doi ?? doiIn(options.text)\n  const warnings: string[] = []\n  if (doi) {\n    const item = await fetchCrossref(doi, signal)\n    if (item) return { bib: item, warnings }\n    warnings.push('crossref-unavailable')\n  }\n\n  const text = options.text.trim().slice(0, BIBLIOGRAPHY_TEXT_LIMIT)\n  if (!text) throw new HttpError(422, doi ? 'Literaturangaben nicht verfügbar: Crossref nicht erreichbar und kein Text zum Auswerten' : 'Keine Literaturangaben gefunden')\n  const model = await options.resolveModel()\n  const result = await modelCall(signal, () => generateText({\n    model,\n    abortSignal: signal,\n    output: Output.object({ schema: bibliographySchema }),\n    messages: [{ role: 'user', content: `${BIB_PROMPT}\\n\\n${text}` }],\n  }))\n  const bib = cslFromModel(result.output)\n  if (doi && !bib.DOI) bib.DOI = doi\n  return { bib, warnings }\n}\n\n/** The text the bibliography is read from: the first pages of the document. */\nexport const bibliographyText = (pages: readonly string[]): string => pages.slice(0, BIBLIOGRAPHY_PAGES).join('\\n\\n')\n"],"mappings":"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"}

package/dist/server/h3.d.ts

@@ -0,0 +1,8 @@
+import { HandlerRequest, HandlerResponse } from "./handlers/context.js";
+import "./handlers/index.js";
+import "h3";
+//#region src/server/h3.d.ts
+/** A route handler of `@ecsplico/editor/server/handlers`, over the context `C` its route needs. */
+export type RouteHandler<C> = (ctx: C, request: HandlerRequest) => Promise<HandlerResponse>;
+//#endregion
+//# sourceMappingURL=h3.d.ts.map

package/dist/{nuxt/runtime/server/utils/editor-route.js → server/h3.js}

@@ -1,7 +1,6 @@
-import { HttpError } from "../../../../server/errors.js";
-import { useAiModels, useCollabServer, useEditorAdapter, useRateLimiter } from "../../../../server/host.js";
+import { HttpError } from "./errors.js";
 import { createError, defineEventHandler, getQuery, getRouterParams, readBody, readFormData, setResponseHeaders, setResponseStatus } from "h3";
-//#region src/nuxt/runtime/server/utils/editor-route.ts
+//#region src/server/h3.ts
 /** The `HandlerRequest` of a Nitro event. `signal` aborts when the client goes away. */
 function requestOf(event) {
 	const abort = new AbortController();
@@ -15,26 +14,19 @@ function requestOf(event) {
 		signal: abort.signal
 	};
 }
-/**
-* An API route that parses the Nitro event into a `HandlerRequest`, calls `handler` of `@ecsplico/editor/server/handlers`
-* with the adapter, AI models, rate limiter and collaboration server of this process, and sends the `HandlerResponse`.
-*/
-function defineEditorRoute(handler) {
+/** An event handler that runs `handler` with `ctx` and sends its `HandlerResponse`; an `HttpError` becomes Nitro's error response. */
+function routeOf(ctx, handler) {
 	return defineEventHandler(async (event) => {
 		let response;
 		try {
-			response = await handler({
-				adapter: useEditorAdapter(),
-				ai: useAiModels(),
-				limiter: useRateLimiter(),
-				collab: useCollabServer()
-			}, requestOf(event));
+			response = await handler(ctx, requestOf(event));
 		} catch (error) {
 			if (!(error instanceof HttpError)) throw error;
 			setResponseHeaders(event, error.headers);
 			throw createError({
 				statusCode: error.statusCode,
 				statusMessage: error.statusMessage,
+				message: error.statusMessage,
 				data: error.data
 			});
 		}
@@ -44,6 +36,6 @@ function defineEditorRoute(handler) {
 	});
 }
 //#endregion
-export { defineEditorRoute };
+export { requestOf, routeOf };
 
-//# sourceMappingURL=editor-route.js.map
+//# sourceMappingURL=h3.js.map