@lax-wp/editor 0.4.13 → 0.4.15-beta.0

package/dist/api/documentVersions.d.ts

@@ -0,0 +1,519 @@
+/**
+ * Document version-control API module (git-store).
+ *
+ * Nine routes, registered in internal/git-store/lib/api/handler.go and
+ * forwarded by cmd/server/main.go as `/v1/documents` + `/v1/documents/*`:
+ *
+ *   POST /v1/documents                              createDocument
+ *   GET  /v1/documents/{docId}                      getDocument
+ *   POST /v1/documents/{docId}/commits              commitVersion
+ *   GET  /v1/documents/{docId}/commits              getHistory
+ *   GET  /v1/documents/{docId}/versions/{commitId}  getVersion
+ *   GET  /v1/documents/{docId}/diff/{from}/{to}     getDiff
+ *   POST /v1/documents/{docId}/rollback             rollbackDocument
+ *   POST /v1/documents/{docId}/analyze              triggerDocumentAnalysis
+ *   GET  /v1/documents/{docId}/annotations          getAnnotations
+ *
+ * Shapes derived from the Go handlers + internal/git-store/lib/types/types.go
+ * and confirmed against live 200s from a local server. Two envelopes, which is
+ * why the schemas below are split:
+ *
+ *   success → {"data": {...}, "meta": {"requestId": "..."}}
+ *   error   → {"code": "...", "message": "...", "trace_id"?: "..."}   (FLAT)
+ *
+ * The error envelope is `clmerrors.Envelope` (api/response.go) — flat, NOT the
+ * nested {"error":{...}} some older services used. `DocumentVersionsApiError`
+ * exposes `.code` so callers can match on stable codes (NOT_FOUND,
+ * INVALID_JSON, NO_CHANGES, PATCH_INTEGRITY, CONFLICT, …).
+ *
+ * Mirrors `versions.ts` / `audit.ts` conventions: module-level mutable config
+ * merged with Vite env defaults, zod + `.passthrough()` at the boundary.
+ */
+import { z } from "zod";
+export interface DocumentVersionsApiConfig {
+    baseUrl?: string;
+    workspaceId?: string;
+}
+/** Configure once from the consumer (App.tsx / lax-web-portal). */
+export declare const configureDocumentVersionsApi: (next: DocumentVersionsApiConfig) => void;
+export declare class DocumentVersionsApiError extends Error {
+    readonly status?: number;
+    /** Stable `code` from the flat error envelope, when the body carried one. */
+    readonly code?: string;
+    constructor(message: string, status?: number, code?: string);
+}
+/** A ProseMirror/Tiptap node. `content` recurses; Go omits empty fields. */
+export interface ProseMirrorNode {
+    type: string;
+    text?: string;
+    marks?: {
+        type: string;
+        attrs?: unknown;
+    }[];
+    attrs?: unknown;
+    content?: ProseMirrorNode[];
+}
+/** `types.Document` — `content` is a bare slice, so it serializes as null when empty. */
+export declare const proseMirrorDocumentSchema: z.ZodObject<{
+    type: z.ZodString;
+    content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodString;
+    content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodString;
+    content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ProseMirrorDocument = z.infer<typeof proseMirrorDocumentSchema>;
+/** `types.PatchStats`. */
+declare const patchStatsSchema: z.ZodObject<{
+    inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type PatchStats = z.infer<typeof patchStatsSchema>;
+/**
+ * `types.Commit`. `timestamp` is epoch MILLISECONDS. `tags` serializes as null
+ * (bare slice, no omitempty). `parentId` is absent on the first commit.
+ *
+ * `author` is a DISPLAY NAME resolved at commit time — an IdP rename changes
+ * how old commits read. `author_id` (snake_case on the wire, `omitempty`) is
+ * the STABLE canonical identity (Keycloak sub; `insecure-dev-user` in dev)
+ * recorded alongside it; absent on commits made before it existed.
+ */
+declare const commitSchema: z.ZodObject<{
+    id: z.ZodString;
+    docId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    parentId: z.ZodOptional<z.ZodString>;
+    patchId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    blobId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    author_id: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    docId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    parentId: z.ZodOptional<z.ZodString>;
+    patchId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    blobId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    author_id: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    docId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    parentId: z.ZodOptional<z.ZodString>;
+    patchId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    blobId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    author_id: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type DocumentCommit = z.infer<typeof commitSchema>;
+/** `types.Hunk`. See documentDiff.ts for the lineNo side-of-the-diff rules. */
+export declare const hunkOpSchema: z.ZodEnum<["INSERT", "DELETE", "REPLACE"]>;
+export type HunkOp = z.infer<typeof hunkOpSchema>;
+declare const hunkSchema: z.ZodObject<{
+    op: z.ZodEnum<["INSERT", "DELETE", "REPLACE"]>;
+    lineNo: z.ZodNumber;
+    oldId: z.ZodOptional<z.ZodString>;
+    newId: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    op: z.ZodEnum<["INSERT", "DELETE", "REPLACE"]>;
+    lineNo: z.ZodNumber;
+    oldId: z.ZodOptional<z.ZodString>;
+    newId: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    op: z.ZodEnum<["INSERT", "DELETE", "REPLACE"]>;
+    lineNo: z.ZodNumber;
+    oldId: z.ZodOptional<z.ZodString>;
+    newId: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type DiffHunk = z.infer<typeof hunkSchema>;
+/** `types.AIAnnotation`. */
+declare const annotationSchema: z.ZodObject<{
+    id: z.ZodString;
+    docId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    commitId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    cleanId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    analyzerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    address: z.ZodOptional<z.ZodObject<{
+        lineNo: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        from: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        to: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        lineNo: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        from: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        to: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        lineNo: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        from: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        to: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    mark: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        attrs: z.ZodOptional<z.ZodUnknown>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodString;
+        attrs: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodString;
+        attrs: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    confidence: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    createdAt: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    docId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    commitId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    cleanId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    analyzerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    address: z.ZodOptional<z.ZodObject<{
+        lineNo: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        from: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        to: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        lineNo: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        from: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        to: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        lineNo: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        from: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        to: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    mark: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        attrs: z.ZodOptional<z.ZodUnknown>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodString;
+        attrs: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodString;
+        attrs: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    confidence: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    createdAt: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    docId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    commitId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    cleanId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    analyzerId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    address: z.ZodOptional<z.ZodObject<{
+        lineNo: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        from: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        to: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        lineNo: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        from: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        to: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        lineNo: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        from: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        to: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    mark: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        attrs: z.ZodOptional<z.ZodUnknown>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodString;
+        attrs: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodString;
+        attrs: z.ZodOptional<z.ZodUnknown>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    confidence: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    createdAt: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type DocumentAnnotation = z.infer<typeof annotationSchema>;
+/**
+ * The value `authorOrAnonymous` (handler.go) writes when the request context
+ * carries no identity.
+ *
+ * Commits made while git-store was mounted on a bare router — no identity
+ * middleware, so no request ever carried one — all recorded this. Those rows
+ * are still in the store, so documents whose history predates the attribution
+ * fix will keep showing up here. New commits carry the real caller.
+ */
+export declare const UNATTRIBUTED_AUTHOR = "anonymous";
+export interface CommitAuthor {
+    /** What to render. */
+    label: string;
+    /** False when the stored value names nobody who can be held to the change. */
+    attributed: boolean;
+}
+/**
+ * Version history exists to answer "who changed this, and when". A commit
+ * recorded as "anonymous" (or with no author at all) cannot answer the first
+ * half, so the UI says so rather than printing a name nobody can be held to.
+ */
+export declare const describeCommitAuthor: (author: string | undefined) => CommitAuthor;
+declare const createDocumentSchema: z.ZodObject<{
+    commitId: z.ZodString;
+    docId: z.ZodString;
+    stats: z.ZodObject<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    commitId: z.ZodString;
+    docId: z.ZodString;
+    stats: z.ZodObject<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    commitId: z.ZodString;
+    docId: z.ZodString;
+    stats: z.ZodObject<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CreateDocumentResult = z.infer<typeof createDocumentSchema>;
+/**
+ * POST /v1/documents → 201. Body is the bare ProseMirror document (NOT
+ * wrapped). The first commit's id doubles as the document id.
+ */
+export declare const createDocument: (document: ProseMirrorDocument) => Promise<CreateDocumentResult>;
+declare const getDocumentSchema: z.ZodObject<{
+    document: z.ZodObject<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    commitId: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    document: z.ZodObject<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    commitId: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    document: z.ZodObject<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodType<ProseMirrorNode, z.ZodTypeDef, ProseMirrorNode>, "many">>>;
+    }, z.ZodTypeAny, "passthrough">>;
+    commitId: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export type GetDocumentResult = z.infer<typeof getDocumentSchema>;
+/** GET /v1/documents/{docId} → the document at HEAD, plus the head commit id. */
+export declare const getDocument: (docId: string) => Promise<GetDocumentResult>;
+declare const commitVersionSchema: z.ZodObject<{
+    commitId: z.ZodString;
+    stats: z.ZodObject<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    commitId: z.ZodString;
+    stats: z.ZodObject<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    commitId: z.ZodString;
+    stats: z.ZodObject<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inserted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        deleted: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        replaced: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        unchanged: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        changedBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type CommitVersionResult = z.infer<typeof commitVersionSchema>;
+/**
+ * POST /v1/documents/{docId}/commits → 201. Committing an unchanged document
+ * is a 409 NO_CHANGES.
+ */
+export declare const commitVersion: (docId: string, document: ProseMirrorDocument, message: string) => Promise<CommitVersionResult>;
+export interface GetHistoryOptions {
+    /** Server default 20, clamped to 100. Non-positive values are a 400. */
+    limit?: number;
+    /** Cursor: the commit id to page after. */
+    after?: string;
+}
+/**
+ * GET /v1/documents/{docId}/commits → the commit log, newest first.
+ *
+ * NOTE: an unknown docId is NOT a 404 here — it returns 200 with an empty
+ * list, so "no history" and "no such document" are indistinguishable on this
+ * route alone.
+ */
+export declare const getHistory: (docId: string, options?: GetHistoryOptions) => Promise<DocumentCommit[]>;
+/** GET /v1/documents/{docId}/versions/{commitId} → that version's document. */
+export declare const getVersion: (docId: string, commitId: string) => Promise<ProseMirrorDocument>;
+/**
+ * GET /v1/documents/{docId}/diff/{from}/{to} → structural hunks only. The
+ * server sends line-node hashes, never text; documentDiff.ts aligns the hunks
+ * against both versions' documents to produce renderable rows.
+ */
+export declare const getDiff: (docId: string, from: string, to: string) => Promise<DiffHunk[]>;
+/**
+ * POST /v1/documents/{docId}/rollback → the id of the NEW commit.
+ *
+ * Rollback is a FORWARD commit ("rollback to {id}") that restores the target
+ * blob over the current head. History is never rewritten — the commits being
+ * rolled back stay in the log. What changes is the document content at HEAD.
+ */
+export declare const rollbackDocument: (docId: string, toCommitId: string) => Promise<string>;
+/**
+ * The code POST .../analyze returns (501) when the server has no analyzers
+ * configured. On such a server the route never queues work, so a caller that
+ * sees this must not report analysis as started.
+ */
+export declare const ANALYSIS_UNAVAILABLE = "ANALYSIS_UNAVAILABLE";
+/**
+ * POST /v1/documents/{docId}/analyze → 202 {"status":"triggered"} when the
+ * server has analyzers, otherwise **501 with code ANALYSIS_UNAVAILABLE**
+ * (thrown as a DocumentVersionsApiError — check `.code`).
+ *
+ * The server previously answered a flat 202 whether or not anything could run;
+ * it now refuses honestly. Servers in this configuration register no analyzers
+ * at all, so annotations stay empty and no amount of calling this changes that.
+ *
+ * Kept here so the route has a typed client. It is deliberately NOT wired to a
+ * button in DocumentVersionHistory: an affordance whose only possible outcome
+ * is a 501 promises work that cannot happen.
+ */
+export declare const triggerDocumentAnalysis: (docId: string) => Promise<string>;
+/**
+ * GET /v1/documents/{docId}/annotations → AI annotations for the CURRENT HEAD
+ * only (the service resolves head, then reads by that commit). Empty until an
+ * analyzer is actually wired — see `triggerDocumentAnalysis`.
+ */
+export declare const getAnnotations: (docId: string) => Promise<DocumentAnnotation[]>;
+export {};