@okrapdf/cli 0.4.6 → 0.5.0

package/dist/lib/backends/do.js

@@ -0,0 +1,340 @@
+/**
+ * DO backend — talks to agent-session Durable Object worker.
+ *
+ * Extracted from commands/search.ts; provides the Backend interface
+ * so commands never call fetch directly.
+ */
+// ─── Low-level fetch ─────────────────────────────────────────────────────────
+const DEFAULT_WORKER_URL = 'https://agent-session.steventsao.workers.dev';
+function normalizeUrl(url) {
+    return url.replace(/\/+$/, '');
+}
+export function getWorkerUrl() {
+    const url = process.env.DOCUMENT_AGENT_URL || process.env.OKRA_DOCUMENT_AGENT_URL || DEFAULT_WORKER_URL;
+    return normalizeUrl(url);
+}
+export function authHeaders() {
+    const h = {};
+    if (process.env.DOCUMENT_AGENT_SHARED_SECRET) {
+        h['x-document-agent-secret'] = process.env.DOCUMENT_AGENT_SHARED_SECRET;
+    }
+    if (process.env.DOCUMENT_AGENT_WORKER_SECRET) {
+        h['X-Worker-Secret'] = process.env.DOCUMENT_AGENT_WORKER_SECRET;
+    }
+    const authToken = process.env.DOCUMENT_AGENT_AUTH_TOKEN || process.env.DOCUMENT_AGENT_WS_TOKEN;
+    if (authToken) {
+        h.Authorization = authToken.startsWith('Bearer ') ? authToken : `Bearer ${authToken}`;
+    }
+    return h;
+}
+export async function workerFetch(path) {
+    const res = await fetch(`${getWorkerUrl()}${path}`, { headers: authHeaders() });
+    if (!res.ok)
+        throw new Error(`Worker ${res.status}: ${path}`);
+    return (await res.json());
+}
+export function isWorkerStatusError(error, status) {
+    if (!(error instanceof Error))
+        return false;
+    return error.message.includes(`Worker ${status}:`);
+}
+function buildDocRouteCandidates() {
+    const mode = process.env.DOCUMENT_AGENT_DOC_ROUTE?.toLowerCase();
+    if (mode === 'document')
+        return ['document'];
+    if (mode === 'task')
+        return ['task'];
+    if (process.env.DOCUMENT_AGENT_SHARED_SECRET) {
+        return ['document', 'task'];
+    }
+    return ['task', 'document'];
+}
+/** Fetch scoped to a specific document. */
+export async function workerDocFetch(docId, path) {
+    const encodedDocId = encodeURIComponent(docId);
+    const candidates = buildDocRouteCandidates();
+    let lastError;
+    for (const route of candidates) {
+        try {
+            return await workerFetch(`/${route}/${encodedDocId}${path}`);
+        }
+        catch (error) {
+            lastError = error;
+            if (isWorkerStatusError(error, 400)
+                || isWorkerStatusError(error, 401)
+                || isWorkerStatusError(error, 403)
+                || isWorkerStatusError(error, 404)) {
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error('Worker request failed');
+}
+async function docFetch(docId, path) {
+    return workerDocFetch(docId, path);
+}
+export function fallbackLedgerFromStatus(status) {
+    const totalPages = Math.max(0, status.pagesTotal || 0);
+    const completedPages = Math.max(0, Math.min(totalPages, status.pagesCompleted || 0));
+    const ledger = [];
+    for (let page = 1; page <= totalPages; page++) {
+        let pageStatus = 'pending';
+        if (page <= completedPages || status.phase === 'complete') {
+            pageStatus = 'completed';
+        }
+        else if (page === completedPages + 1 && status.phase !== 'pending') {
+            pageStatus = 'running';
+        }
+        ledger.push({
+            page_number: page,
+            status: pageStatus,
+            pass: pageStatus === 'completed' ? 1 : 0,
+            vendor: status.activeVendor,
+        });
+    }
+    return { ledger };
+}
+// ─── Adapter: nodes → entities ───────────────────────────────────────────────
+const NODE_TYPE_MAP = {
+    table: 'table',
+    figure: 'figure',
+    footnote: 'footnote',
+    summary: 'summary',
+    signature: 'signature',
+};
+function nodeBbox(n) {
+    if (n.bbox_x != null && n.bbox_y != null && n.bbox_w != null && n.bbox_h != null) {
+        return { x: n.bbox_x, y: n.bbox_y, width: n.bbox_w, height: n.bbox_h };
+    }
+    return undefined;
+}
+function nodeSchema(n) {
+    if (!n.metadata)
+        return undefined;
+    try {
+        const meta = JSON.parse(n.metadata);
+        if (Array.isArray(meta.schema))
+            return meta.schema;
+    }
+    catch { /* ignore */ }
+    return undefined;
+}
+async function fetchAllNodes(docId) {
+    const pageSize = 500;
+    let offset = 0;
+    const allNodes = [];
+    while (true) {
+        const resp = await docFetch(docId, `/nodes?limit=${pageSize}&offset=${offset}`);
+        const pageNodes = Array.isArray(resp.nodes) ? resp.nodes : [];
+        allNodes.push(...pageNodes);
+        const total = typeof resp.total === 'number' ? resp.total : undefined;
+        const limit = typeof resp.limit === 'number' && resp.limit > 0 ? resp.limit : pageSize;
+        if (pageNodes.length === 0)
+            break;
+        if (total !== undefined && allNodes.length >= total)
+            break;
+        if (total === undefined && pageNodes.length < limit)
+            break;
+        offset += limit;
+    }
+    return allNodes;
+}
+export function adaptNodes(docId, nodes, typeFilter) {
+    const counts = { tables: 0, figures: 0, footnotes: 0, summaries: 0, signatures: 0 };
+    const entities = [];
+    for (const n of nodes) {
+        const mapped = NODE_TYPE_MAP[n.type];
+        if (!mapped)
+            continue;
+        // Count all entity-type nodes
+        const countKey = `${mapped}s`;
+        if (countKey in counts)
+            counts[countKey]++;
+        // Filter if requested
+        if (typeFilter && typeFilter !== 'all') {
+            const singular = typeFilter.replace(/s$/, '');
+            if (n.type !== singular)
+                continue;
+        }
+        entities.push({
+            id: n.id,
+            type: mapped,
+            title: n.label,
+            page: n.page_number ?? 0,
+            bbox: nodeBbox(n),
+            schema: nodeSchema(n),
+        });
+    }
+    return {
+        jobId: docId,
+        entities,
+        counts,
+        extractionStatus: 'completed',
+        totalPages: undefined,
+    };
+}
+// ─── Adapter: status → verification tree ─────────────────────────────────────
+export function adaptStatusToVerificationTree(docId, status, ledger) {
+    const pages = ledger.ledger.map((entry) => {
+        let pageStatus = 'pending';
+        if (entry.status === 'completed')
+            pageStatus = 'complete';
+        else if (entry.status === 'failed')
+            pageStatus = 'flagged';
+        else if (entry.status === 'running' || entry.status === 'retrying')
+            pageStatus = 'partial';
+        const isComplete = entry.status === 'completed';
+        const isFailed = entry.status === 'failed';
+        return {
+            page: entry.page_number,
+            status: pageStatus,
+            total: 1,
+            verified: isComplete ? 1 : 0,
+            pending: (!isComplete && !isFailed) ? 1 : 0,
+            flagged: isFailed ? 1 : 0,
+            rejected: 0,
+            avgConfidence: isComplete ? 1.0 : 0,
+            hasOcr: entry.pass >= 1,
+            ocrLineCount: 0,
+            hasCoverageGaps: false,
+            uncoveredCount: 0,
+            resolution: null,
+            classification: null,
+            isStale: false,
+        };
+    });
+    const summary = {
+        complete: pages.filter((p) => p.status === 'complete').length,
+        partial: pages.filter((p) => p.status === 'partial').length,
+        flagged: pages.filter((p) => p.status === 'flagged').length,
+        pending: pages.filter((p) => p.status === 'pending').length,
+        empty: 0,
+        gap: 0,
+        resolved: 0,
+        stale: 0,
+    };
+    return {
+        jobId: docId,
+        documentId: status.documentId,
+        totalPages: status.pagesTotal,
+        summary,
+        pages,
+    };
+}
+// ─── Adapter: page → PageContent ─────────────────────────────────────────────
+export function adaptPageContent(docId, pageNum, doPage) {
+    return {
+        jobId: docId,
+        pageNum,
+        content: doPage.content,
+        version: 1,
+        blocks: doPage.blocks.map((b) => ({
+            text: b.text,
+            bbox: b.bbox
+                ? { x: b.bbox.x, y: b.bbox.y, width: b.bbox.w, height: b.bbox.h }
+                : undefined,
+            confidence: b.confidence,
+        })),
+        dimension: null,
+    };
+}
+// ─── Adapter: mutations → history ────────────────────────────────────────────
+export function adaptMutations(resp) {
+    return {
+        history: resp.mutations.map((m) => ({
+            id: m.id,
+            action: m.action,
+            pageNumber: m.page_number,
+            entityId: m.entity_id,
+            entityType: m.entity_type,
+            previousState: m.previous_state,
+            newState: m.new_state,
+            triggeredBy: m.triggered_by,
+            createdAt: m.created_at,
+        })),
+    };
+}
+// ─── Adapter: nodes → JobResults (read/results) ─────────────────────────────
+export function adaptNodesToResults(docId, status, pages) {
+    const tables = [];
+    const pageResults = [];
+    for (const p of pages) {
+        pageResults.push({
+            page_number: p.page,
+            text: p.content,
+            entities: [],
+        });
+        for (const e of p.entities) {
+            if (e.type === 'table') {
+                // We don't have markdown from page endpoint, just record it
+                tables.push({
+                    id: e.id,
+                    page_number: p.page,
+                    content_markdown: '', // Tables need separate fetch from nodes
+                    confidence: null,
+                });
+            }
+        }
+    }
+    return {
+        job_id: docId,
+        filename: status.fileName || docId,
+        total_pages: status.pagesTotal,
+        pages: pageResults,
+        tables,
+    };
+}
+// ─── Backend implementation ──────────────────────────────────────────────────
+export function createDOBackend() {
+    return {
+        async entities(docId, type) {
+            const nodes = await fetchAllNodes(docId);
+            return adaptNodes(docId, nodes, type);
+        },
+        async counts(docId) {
+            const nodes = await fetchAllNodes(docId);
+            return adaptNodes(docId, nodes);
+        },
+        async verificationTree(docId) {
+            const status = await docFetch(docId, '/status');
+            let ledger;
+            try {
+                ledger = await docFetch(docId, '/ledger');
+            }
+            catch (error) {
+                if (isWorkerStatusError(error, 404)) {
+                    ledger = fallbackLedgerFromStatus(status);
+                }
+                else {
+                    throw error;
+                }
+            }
+            return adaptStatusToVerificationTree(docId, status, ledger);
+        },
+        async pageContent(docId, pageNum) {
+            const page = await docFetch(docId, `/page/${pageNum}`);
+            return adaptPageContent(docId, pageNum, page);
+        },
+        async history(docId, limit = 20) {
+            const resp = await docFetch(docId, `/mutations?limit=${limit}`);
+            return adaptMutations(resp);
+        },
+        async read(docId) {
+            const status = await docFetch(docId, '/status');
+            const total = status.pagesTotal || 0;
+            // Fetch all pages in parallel
+            const pagePromises = [];
+            for (let i = 1; i <= total; i++) {
+                pagePromises.push(docFetch(docId, `/page/${i}`));
+            }
+            const pages = await Promise.all(pagePromises);
+            return adaptNodesToResults(docId, status, pages);
+        },
+        async results(docId) {
+            // Same as read for DO backend
+            return this.read(docId);
+        },
+    };
+}
+//# sourceMappingURL=do.js.map

package/dist/lib/backends/do.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"do.js","sourceRoot":"","sources":["../../../src/lib/backends/do.ts"],"names":[],"mappings":"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"}

package/dist/lib/backends/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Backend selector — DO only.
+ */
+import type { Backend } from './types.js';
+export declare function getBackend(): Backend;
+export { type Backend } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/backends/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/lib/backends/index.js

@@ -0,0 +1,8 @@
+/**
+ * Backend selector — DO only.
+ */
+import { createDOBackend } from './do.js';
+export function getBackend() {
+    return createDOBackend();
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,UAAU,UAAU;IACxB,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC"}

package/dist/lib/backends/okrapdf.d.ts

@@ -0,0 +1,9 @@
+/**
+ * OkraPDF REST backend — thin wrappers around existing client.ts helpers.
+ *
+ * This is the legacy path: commands that don't have a DO equivalent
+ * (or when DOCUMENT_AGENT_URL isn't set) use this backend.
+ */
+import type { Backend } from './types.js';
+export declare function createOkraPdfBackend(): Backend;
+//# sourceMappingURL=okrapdf.d.ts.map

package/dist/lib/backends/okrapdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okrapdf.d.ts","sourceRoot":"","sources":["../../../src/lib/backends/okrapdf.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,OAAO,EAMR,MAAM,YAAY,CAAC;AAsFpB,wBAAgB,oBAAoB,IAAI,OAAO,CA6C9C"}

package/dist/lib/backends/okrapdf.js

@@ -0,0 +1,50 @@
+/**
+ * OkraPDF REST backend — thin wrappers around existing client.ts helpers.
+ *
+ * This is the legacy path: commands that don't have a DO equivalent
+ * (or when DOCUMENT_AGENT_URL isn't set) use this backend.
+ */
+import { get } from '../client.js';
+export function createOkraPdfBackend() {
+    return {
+        async entities(docId, type) {
+            const params = {};
+            if (type)
+                params.type = type;
+            return get(`api/ocr/jobs/${docId}/entities`, params);
+        },
+        async counts(docId) {
+            return get(`api/ocr/jobs/${docId}/entities`);
+        },
+        async verificationTree(docId) {
+            return get(`api/ocr/jobs/${docId}/verification-tree`);
+        },
+        async pageContent(docId, pageNum) {
+            return get(`api/ocr/jobs/${docId}/pages/${pageNum}`);
+        },
+        async history(docId, limit = 20, page) {
+            const params = { limit: String(limit) };
+            if (page)
+                params.page = String(page);
+            return get(`api/ocr/jobs/${docId}/history`, params);
+        },
+        async read(docId) {
+            const api = await get(`api/v1/jobs/${docId}/results`);
+            return {
+                job_id: api.job_id,
+                filename: api.filename,
+                total_pages: api.total_pages,
+                tables: api.results?.tables || [],
+                pages: (api.results?.text || []).map((t) => ({
+                    page_number: t.page,
+                    text: t.content,
+                    entities: [],
+                })),
+            };
+        },
+        async results(docId) {
+            return this.read(docId);
+        },
+    };
+}
+//# sourceMappingURL=okrapdf.js.map

package/dist/lib/backends/okrapdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"okrapdf.js","sourceRoot":"","sources":["../../../src/lib/backends/okrapdf.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AA8FnC,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI;YACxB,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,IAAI,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;YAC7B,OAAO,GAAG,CAAuB,gBAAgB,KAAK,WAAW,EAAE,MAAM,CAAmC,CAAC;QAC/G,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAK;YAChB,OAAO,GAAG,CAAuB,gBAAgB,KAAK,WAAW,CAAmC,CAAC;QACvG,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,KAAK;YAC1B,OAAO,GAAG,CAAuB,gBAAgB,KAAK,oBAAoB,CAAqC,CAAC;QAClH,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO;YAC9B,OAAO,GAAG,CAAkB,gBAAgB,KAAK,UAAU,OAAO,EAAE,CAAgC,CAAC;QACvG,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,IAAK;YACpC,MAAM,MAAM,GAA2B,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,IAAI,IAAI;gBAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO,GAAG,CAAqC,gBAAgB,KAAK,UAAU,EAAE,MAAM,CAAC,CAAC;QAC1F,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAK;YACd,MAAM,GAAG,GAAG,MAAM,GAAG,CAAoB,eAAe,KAAK,UAAU,CAAC,CAAC;YACzE,OAAO;gBACL,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE;gBACjC,KAAK,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC3C,WAAW,EAAE,CAAC,CAAC,IAAI;oBACnB,IAAI,EAAE,CAAC,CAAC,OAAO;oBACf,QAAQ,EAAE,EAAE;iBACb,CAAC,CAAC;aACwB,CAAC;QAChC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/backends/types.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Shared backend types — DO response shapes and backend interface.
+ *
+ * Commands call Backend methods; they never call fetch directly.
+ */
+export interface DOStatusResponse {
+    documentId: string;
+    phase: string;
+    fileName: string;
+    pagesTotal: number;
+    pagesCompleted?: number;
+    totalNodes: number;
+    verifiedNodes: number;
+    activeVendor: string;
+}
+export interface DONode {
+    id: string;
+    type: string;
+    label: string | null;
+    value: string | null;
+    page_number: number | null;
+    status: string;
+    bbox_x?: number | null;
+    bbox_y?: number | null;
+    bbox_w?: number | null;
+    bbox_h?: number | null;
+    metadata?: string | null;
+}
+export interface DONodesResponse {
+    nodes: DONode[];
+    total?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface DOLedgerEntry {
+    page_number: number;
+    status: string;
+    pass: number;
+    vendor?: string;
+}
+export interface DOLedgerResponse {
+    ledger: DOLedgerEntry[];
+}
+export interface DOPageBlock {
+    text: string;
+    bbox?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    confidence?: number;
+}
+export interface DOPageEntity {
+    id: string;
+    type: string;
+    label: string | null;
+}
+export interface DOPageResponse {
+    page: number;
+    content: string;
+    blocks: DOPageBlock[];
+    entities: DOPageEntity[];
+}
+export interface DOMutation {
+    id: string;
+    action: string;
+    page_number: number | null;
+    entity_id: string | null;
+    entity_type: string | null;
+    previous_state: unknown;
+    new_state: unknown;
+    triggered_by: string;
+    created_at: string;
+}
+export interface DOMutationsResponse {
+    mutations: DOMutation[];
+}
+export interface EntityBbox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface BackendEntity {
+    id: string;
+    type: 'table' | 'figure' | 'footnote' | 'summary' | 'signature';
+    title: string | null;
+    page: number;
+    schema?: string[];
+    isComplete?: boolean;
+    bbox?: EntityBbox;
+}
+export interface BackendEntitiesResult {
+    jobId: string;
+    entities: BackendEntity[];
+    counts: {
+        tables: number;
+        figures: number;
+        footnotes: number;
+        summaries: number;
+        signatures: number;
+    };
+    extractionStatus: string;
+    totalPages?: number;
+}
+export interface BackendPageStatus {
+    page: number;
+    status: string;
+    total: number;
+    verified: number;
+    pending: number;
+    flagged: number;
+    rejected: number;
+    avgConfidence: number;
+    hasOcr: boolean;
+    ocrLineCount: number;
+    hasCoverageGaps: boolean;
+    uncoveredCount: number;
+    resolution: string | null;
+    classification: string | null;
+    isStale: boolean;
+}
+export interface BackendVerificationTree {
+    jobId: string;
+    documentId: string;
+    totalPages: number;
+    summary: {
+        complete: number;
+        partial: number;
+        flagged: number;
+        pending: number;
+        empty: number;
+        gap: number;
+        resolved: number;
+        stale: number;
+    };
+    pages: BackendPageStatus[];
+}
+export interface BackendPageContent {
+    jobId: string;
+    pageNum: number;
+    content: string;
+    version: number;
+    blocks?: Array<{
+        text: string;
+        bbox?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        confidence?: number;
+    }>;
+    dimension?: {
+        width: number;
+        height: number;
+    } | null;
+}
+export interface BackendHistoryEntry {
+    id: string;
+    action: string;
+    pageNumber: number | null;
+    entityId: string | null;
+    entityType: string | null;
+    previousState: unknown;
+    newState: unknown;
+    triggeredBy: string;
+    createdAt: string;
+}
+export interface BackendJobResults {
+    job_id: string;
+    filename: string;
+    total_pages: number;
+    pages: Array<{
+        page_number: number;
+        text: string;
+        entities: unknown[];
+    }>;
+    tables: Array<{
+        id: string;
+        page_number: number;
+        content_markdown: string;
+        confidence: number | null;
+    }>;
+}
+export interface Backend {
+    /** List entities with optional type filter */
+    entities(docId: string, type?: string): Promise<BackendEntitiesResult>;
+    /** Element counts */
+    counts(docId: string): Promise<BackendEntitiesResult>;
+    /** Verification tree (status + pages) */
+    verificationTree(docId: string): Promise<BackendVerificationTree>;
+    /** Single page content */
+    pageContent(docId: string, pageNum: number): Promise<BackendPageContent>;
+    /** Mutation/audit history */
+    history(docId: string, limit?: number, page?: number): Promise<{
+        history: BackendHistoryEntry[];
+    }>;
+    /** Full document read (all pages) */
+    read(docId: string): Promise<BackendJobResults>;
+    /** Job results (same as read but from results endpoint) */
+    results(docId: string): Promise<BackendJobResults>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/backends/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/backends/types.ts"],"names":[],"mappings":"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"}