@okrapdf/runtime 0.1.0

package/README.md

@@ -0,0 +1,34 @@
+# @okrapdf/runtime
+
+Minimal OkraPDF runtime client:
+
+- `upload()`
+- `status()`
+- `wait()`
+- `structuredOutput()`
+
+```ts
+import { OkraPDF } from '@okrapdf/runtime';
+import { z } from 'zod';
+
+const okra = new OkraPDF({
+  baseUrl: 'https://agent-session.steventsao.workers.dev',
+  apiKey: process.env.OKRA_API_KEY,
+});
+
+const doc = await okra.upload('https://example.com/invoice.pdf');
+await okra.wait(doc.id);
+
+const InvoiceSchema = z.object({
+  vendor: z.string(),
+  invoiceNumber: z.string(),
+  total: z.number(),
+});
+
+const result = await okra.structuredOutput(doc.id, InvoiceSchema, {
+  query: 'Extract invoice fields',
+});
+
+console.log(result.data.vendor);
+```
+

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+import type { DocumentStatus, OkraPDFOptions, StructuredOutputOptions, StructuredOutputResult, StructuredSchema, UploadOptions, UploadResult, WaitOptions } from './types.js';
+export declare class OkraPDF {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly sharedSecret?;
+    private readonly fetchImpl;
+    constructor(options: OkraPDFOptions);
+    upload(input: string | ArrayBuffer | Uint8Array, options?: UploadOptions): Promise<UploadResult>;
+    status(documentId: string, signal?: AbortSignal): Promise<DocumentStatus>;
+    wait(documentId: string, options?: WaitOptions): Promise<DocumentStatus>;
+    structuredOutput<T>(documentId: string, schema: StructuredSchema<T>, options: StructuredOutputOptions): Promise<StructuredOutputResult<T>>;
+    structuredOutputMany<T>(documentIds: string[], schema: StructuredSchema<T>, options: StructuredOutputOptions): Promise<Array<StructuredOutputResult<T>>>;
+    private authHeaders;
+    private requestJson;
+    private parseBody;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EAGd,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AA6EpB,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAExC,OAAO,EAAE,cAAc;IAe7B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAkDpG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAOzE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAmC5E,gBAAgB,CAAC,CAAC,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAoC/B,oBAAoB,CAAC,CAAC,EAC1B,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;IAI5C,OAAO,CAAC,WAAW;YAML,WAAW;IA4CzB,OAAO,CAAC,SAAS;CASlB"}

package/dist/client.js

@@ -0,0 +1,212 @@
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+import { z } from 'zod';
+import { OkraRuntimeError, StructuredOutputError } from './errors.js';
+const DEFAULT_BASE_URL = 'https://api.okrapdf.com';
+const DEFAULT_WAIT_TIMEOUT_MS = 5 * 60_000;
+const DEFAULT_WAIT_POLL_MS = 1_500;
+const COMPLETE_PHASES = new Set(['complete', 'awaiting_review']);
+const TERMINAL_ERROR_PHASES = new Set(['error']);
+const STRUCTURED_CODES = new Set([
+    'SCHEMA_VALIDATION_FAILED',
+    'EXTRACTION_FAILED',
+    'TIMEOUT',
+    'DOCUMENT_NOT_FOUND',
+]);
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isHttpUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, '');
+}
+function makeDocId() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return `ocr-${crypto.randomUUID().replace(/-/g, '').slice(0, 20)}`;
+    }
+    const rand = Math.random().toString(36).slice(2, 22);
+    return `ocr-${rand}`;
+}
+function toUint8Array(input) {
+    if (input instanceof Uint8Array)
+        return input;
+    return new Uint8Array(input);
+}
+function normalizeSchema(schema) {
+    const maybeZod = schema;
+    const hasSafeParse = typeof maybeZod.safeParse === 'function';
+    if (hasSafeParse) {
+        return {
+            jsonSchema: z.toJSONSchema(maybeZod, { target: 'draft-2020-12' }),
+            parser: maybeZod,
+        };
+    }
+    return { jsonSchema: schema };
+}
+function isStructuredCode(code) {
+    return !!code && STRUCTURED_CODES.has(code);
+}
+export class OkraPDF {
+    baseUrl;
+    apiKey;
+    sharedSecret;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = normalizeBaseUrl(options.baseUrl || DEFAULT_BASE_URL);
+        this.apiKey = options.apiKey;
+        this.sharedSecret = options.sharedSecret;
+        this.fetchImpl = options.fetch || globalThis.fetch;
+        if (!this.apiKey && !this.sharedSecret) {
+            throw new OkraRuntimeError('UNAUTHORIZED', 'OkraPDF requires either apiKey or sharedSecret', 401);
+        }
+    }
+    async upload(input, options = {}) {
+        const documentId = options.documentId || makeDocId();
+        const path = `/document/${encodeURIComponent(documentId)}`;
+        if (typeof input === 'string' && isHttpUrl(input)) {
+            const response = await this.requestJson(`${path}/upload-url`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    url: input,
+                    capabilities: options.capabilities,
+                }),
+            });
+            return {
+                id: documentId,
+                url: `${this.baseUrl}${path}`,
+                status: response.phase || 'uploading',
+            };
+        }
+        let bytes;
+        let fileName = options.fileName || 'document.pdf';
+        if (typeof input === 'string') {
+            bytes = await readFile(input);
+            if (!options.fileName)
+                fileName = basename(input);
+        }
+        else {
+            bytes = toUint8Array(input);
+        }
+        const headers = {
+            'Content-Type': 'application/pdf',
+            'X-File-Name': fileName,
+        };
+        if (options.capabilities) {
+            headers['X-Capabilities'] = JSON.stringify(options.capabilities);
+        }
+        const response = await this.requestJson(`${path}/upload`, {
+            method: 'POST',
+            headers,
+            body: bytes,
+        });
+        return {
+            id: documentId,
+            url: `${this.baseUrl}${path}`,
+            status: response.phase || 'uploading',
+        };
+    }
+    async status(documentId, signal) {
+        return this.requestJson(`/document/${encodeURIComponent(documentId)}/status`, { method: 'GET', signal });
+    }
+    async wait(documentId, options = {}) {
+        const startedAt = Date.now();
+        const timeoutMs = options.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
+        const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_WAIT_POLL_MS;
+        while (true) {
+            if (options.signal?.aborted) {
+                throw new OkraRuntimeError('TIMEOUT', 'Wait aborted', 499);
+            }
+            const current = await this.status(documentId, options.signal);
+            if (COMPLETE_PHASES.has(current.phase))
+                return current;
+            if (TERMINAL_ERROR_PHASES.has(current.phase)) {
+                throw new OkraRuntimeError('EXTRACTION_FAILED', `Document entered terminal error phase (${current.phase})`, 500, current);
+            }
+            const elapsed = Date.now() - startedAt;
+            if (elapsed >= timeoutMs) {
+                throw new OkraRuntimeError('TIMEOUT', `Timed out waiting for document ${documentId} after ${timeoutMs}ms`, 504, current);
+            }
+            await sleep(pollIntervalMs);
+        }
+    }
+    async structuredOutput(documentId, schema, options) {
+        if (!options?.query || options.query.trim() === '') {
+            throw new OkraRuntimeError('INVALID_REQUEST', 'structuredOutput requires a non-empty query', 400);
+        }
+        const normalized = normalizeSchema(schema);
+        const body = await this.requestJson(`/document/${encodeURIComponent(documentId)}/structured-output`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                query: options.query,
+                schema: normalized.jsonSchema,
+                ...(options.timeoutMs ? { timeoutMs: options.timeoutMs } : {}),
+            }),
+            signal: options.signal,
+        });
+        if (normalized.parser) {
+            const parsed = normalized.parser.safeParse(body.data);
+            if (!parsed.success) {
+                throw new StructuredOutputError('SCHEMA_VALIDATION_FAILED', 'Client-side schema validation failed for structured output response', 422, parsed.error.issues);
+            }
+            return { data: parsed.data, meta: body.meta };
+        }
+        return body;
+    }
+    async structuredOutputMany(documentIds, schema, options) {
+        return Promise.all(documentIds.map((id) => this.structuredOutput(id, schema, options)));
+    }
+    authHeaders() {
+        if (this.apiKey)
+            return { Authorization: `Bearer ${this.apiKey}` };
+        if (this.sharedSecret)
+            return { 'x-document-agent-secret': this.sharedSecret };
+        return {};
+    }
+    async requestJson(path, init) {
+        const headers = new Headers(init.headers);
+        for (const [key, value] of Object.entries(this.authHeaders())) {
+            if (!headers.has(key))
+                headers.set(key, value);
+        }
+        let response;
+        try {
+            response = await this.fetchImpl(`${this.baseUrl}${path}`, { ...init, headers });
+        }
+        catch (err) {
+            throw new OkraRuntimeError('HTTP_ERROR', err instanceof Error ? err.message : String(err), 502);
+        }
+        const text = await response.text();
+        const parsed = this.parseBody(text);
+        if (!response.ok) {
+            const envelope = parsed;
+            const code = envelope?.code;
+            const message = envelope?.message || envelope?.error || `Request failed with status ${response.status}`;
+            const details = envelope?.details ?? parsed ?? text;
+            if (isStructuredCode(code)) {
+                throw new StructuredOutputError(code, message, response.status, details);
+            }
+            const runtimeCode = response.status === 401 ? 'UNAUTHORIZED' : 'HTTP_ERROR';
+            throw new OkraRuntimeError(runtimeCode, message, response.status, details);
+        }
+        if (parsed === null) {
+            throw new OkraRuntimeError('INVALID_RESPONSE', `Expected JSON response for ${path}`, response.status, text);
+        }
+        return parsed;
+    }
+    parseBody(text) {
+        const trimmed = text.trim();
+        if (!trimmed)
+            return null;
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+import type { RuntimeErrorCode, StructuredOutputErrorCode } from './types.js';
+export declare class OkraRuntimeError extends Error {
+    readonly code: RuntimeErrorCode;
+    readonly status: number;
+    readonly details?: unknown;
+    constructor(code: RuntimeErrorCode, message: string, status?: number, details?: unknown);
+}
+export declare class StructuredOutputError extends OkraRuntimeError {
+    readonly code: StructuredOutputErrorCode;
+    constructor(code: StructuredOutputErrorCode, message: string, status: number, details?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE9E,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAOrF;AAED,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;gBAE7B,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAKhG"}

package/dist/errors.js

@@ -0,0 +1,21 @@
+export class OkraRuntimeError extends Error {
+    code;
+    status;
+    details;
+    constructor(code, message, status = 500, details) {
+        super(message);
+        this.name = 'OkraRuntimeError';
+        this.code = code;
+        this.status = status;
+        this.details = details;
+    }
+}
+export class StructuredOutputError extends OkraRuntimeError {
+    code;
+    constructor(code, message, status, details) {
+        super(code, message, status, details);
+        this.name = 'StructuredOutputError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAmB;IACvB,MAAM,CAAS;IACf,OAAO,CAAW;IAE3B,YAAY,IAAsB,EAAE,OAAe,EAAE,MAAM,GAAG,GAAG,EAAE,OAAiB;QAClF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;IAChD,IAAI,CAA4B;IAEzC,YAAY,IAA+B,EAAE,OAAe,EAAE,MAAc,EAAE,OAAiB;QAC7F,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { OkraPDF } from './client.js';
+export { OkraRuntimeError, StructuredOutputError } from './errors.js';
+export type { JsonSchema, RuntimeErrorCode, StructuredOutputErrorCode, OkraPDFOptions, UploadOptions, UploadResult, DocumentStatus, WaitOptions, StructuredOutputMeta, StructuredOutputOptions, StructuredOutputResult, StructuredSchema, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { OkraPDF } from './client.js';
+export { OkraRuntimeError, StructuredOutputError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+import type { ZodType } from 'zod';
+export type JsonSchema = Record<string, unknown>;
+export type StructuredOutputErrorCode = 'SCHEMA_VALIDATION_FAILED' | 'EXTRACTION_FAILED' | 'TIMEOUT' | 'DOCUMENT_NOT_FOUND';
+export type RuntimeErrorCode = StructuredOutputErrorCode | 'INVALID_REQUEST' | 'UNAUTHORIZED' | 'HTTP_ERROR' | 'INVALID_RESPONSE';
+export interface OkraPDFOptions {
+    /** Hosted default points at api.okrapdf.com. */
+    baseUrl?: string;
+    /** Bearer API key (okra_...). */
+    apiKey?: string;
+    /** Alternative auth header for private deployments. */
+    sharedSecret?: string;
+    /** Inject custom fetch implementation for tests or runtime overrides. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface UploadOptions {
+    /** Provide your own document ID. Default: auto-generated `ocr-*`. */
+    documentId?: string;
+    /** Optional filename hint for binary uploads. */
+    fileName?: string;
+    /** Processing capability hints forwarded to the worker. */
+    capabilities?: Record<string, unknown>;
+}
+export interface UploadResult {
+    id: string;
+    url: string;
+    status: string;
+}
+export interface DocumentStatus {
+    phase: string;
+    pagesTotal?: number;
+    pagesCompleted?: number;
+    totalNodes?: number;
+    verifiedNodes?: number;
+    failedNodes?: number;
+    pendingNodes?: number;
+    [key: string]: unknown;
+}
+export interface WaitOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+}
+export interface StructuredOutputMeta {
+    confidence: number;
+    model: string;
+    durationMs: number;
+    citations?: Array<{
+        page: number;
+        text: string;
+    }>;
+}
+export interface StructuredOutputResult<T> {
+    data: T;
+    meta: StructuredOutputMeta;
+}
+export interface StructuredOutputOptions {
+    /** Natural-language extraction request. */
+    query: string;
+    /** Optional timeout forwarded to the worker. */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export type StructuredSchema<T> = JsonSchema | ZodType<T>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,MAAM,yBAAyB,GACjC,0BAA0B,GAC1B,mBAAmB,GACnB,SAAS,GACT,oBAAoB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GACxB,yBAAyB,GACzB,iBAAiB,GACjB,cAAc,GACd,YAAY,GACZ,kBAAkB,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,oBAAoB,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@okrapdf/runtime",
+  "version": "0.1.0",
+  "description": "Tiny runtime client for upload, status, wait, and structured output",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}