okrapdf 0.8.0

package/dist/types-DEYgGUnH.d.ts

@@ -0,0 +1,329 @@
+import { ZodType } from 'zod';
+
+type JsonSchema = Record<string, unknown>;
+type StructuredOutputErrorCode = 'SCHEMA_VALIDATION_FAILED' | 'EXTRACTION_FAILED' | 'TIMEOUT' | 'DOCUMENT_NOT_FOUND';
+type RuntimeErrorCode = StructuredOutputErrorCode | 'INVALID_REQUEST' | 'UNAUTHORIZED' | 'HTTP_ERROR' | 'INVALID_RESPONSE';
+interface OkraClientOptions {
+    /** 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;
+}
+interface UploadRedactPiiOptions {
+    preset?: string;
+    patterns?: string[];
+    includeNames?: boolean;
+    includeAddresses?: boolean;
+    customPatterns?: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+}
+interface UploadRedactOptions {
+    pii?: UploadRedactPiiOptions;
+    publicFieldAllowlist?: string[];
+    [key: string]: unknown;
+}
+interface UploadOptions {
+    /** Provide your own document ID. Default: auto-generated `doc-*`. */
+    documentId?: string;
+    /** Optional filename hint for binary uploads. */
+    fileName?: string;
+    /** Processing capability hints forwarded to the worker. */
+    capabilities?: Record<string, unknown>;
+    /** Document visibility. 'private' (default) requires auth; 'public' auto-publishes on completion. */
+    visibility?: 'public' | 'private';
+    /** BYOK vendor keys passed through to extraction (e.g. { llamaparse: 'llx-...' }). Stateless — never stored. */
+    vendorKeys?: Record<string, string>;
+    /** OpenRedact policy forwarded to upload and enforced at read/query/completion surfaces. */
+    redact?: UploadRedactOptions;
+}
+type UploadInput = string | ArrayBuffer | Uint8Array | Blob;
+interface DocumentStatus {
+    phase: string;
+    pagesTotal?: number;
+    pagesCompleted?: number;
+    totalNodes?: number;
+    verifiedNodes?: number;
+    failedNodes?: number;
+    pendingNodes?: number;
+    [key: string]: unknown;
+}
+interface WaitOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+}
+interface StructuredOutputMeta {
+    confidence: number;
+    model: string;
+    durationMs: number;
+    citations?: Array<{
+        page: number;
+        text: string;
+    }>;
+}
+type StructuredSchema<T> = JsonSchema | ZodType<T>;
+interface PageBlock {
+    text: string;
+    bbox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    confidence?: number;
+}
+interface PageEntity {
+    id: string;
+    type: string;
+    label: string | null;
+}
+interface Page {
+    page: number;
+    content: string;
+    blocks: PageBlock[];
+    entities: PageEntity[];
+}
+interface Entity {
+    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;
+}
+interface EntitiesResponse {
+    nodes: Entity[];
+    total?: number;
+    limit?: number;
+    offset?: number;
+}
+interface QueryResult {
+    rows: Record<string, unknown>[];
+    columns: string[];
+}
+type CompletionEvent = {
+    type: 'text_delta';
+    text: string;
+} | {
+    type: 'tool_result';
+    name: string;
+    result: unknown;
+} | {
+    type: 'done';
+    answer: string;
+    costUsd?: number;
+    sources?: Array<{
+        page: number;
+        snippet: string;
+    }>;
+} | {
+    type: 'error';
+    message: string;
+};
+interface CompletionOptions {
+    stream?: boolean;
+    model?: string;
+    signal?: AbortSignal;
+}
+interface GenerateOptions {
+    schema?: StructuredSchema<unknown>;
+    model?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+interface GenerateResult<T = undefined> {
+    answer: string;
+    sources?: Array<{
+        page: number;
+        snippet: string;
+    }>;
+    costUsd?: number;
+    /** Present when schema is provided. */
+    data?: T;
+    /** Present when schema is provided. */
+    meta?: StructuredOutputMeta;
+}
+interface SessionCreateOptions {
+    /** Wait for extraction to complete before returning the session handle. Default: true */
+    wait?: boolean;
+    /** Default model used by prompt()/stream() unless overridden per call. */
+    model?: string;
+    /** Upload options used when source is URL/path/file (not an existing doc ID). */
+    upload?: UploadOptions;
+    /** Wait options used when `wait` is enabled. */
+    waitOptions?: WaitOptions;
+}
+interface SessionAttachOptions {
+    /** Default model used by prompt()/stream() unless overridden per call. */
+    model?: string;
+}
+interface SessionState {
+    id: string;
+    model?: string;
+    modelEndpoint: string;
+}
+interface OkraSession {
+    readonly id: string;
+    readonly modelEndpoint: string;
+    readonly model?: string;
+    state(): SessionState;
+    setModel(model: string): Promise<void>;
+    status(signal?: AbortSignal): Promise<DocumentStatus>;
+    wait(options?: WaitOptions): Promise<DocumentStatus>;
+    pages(options?: {
+        range?: string;
+        signal?: AbortSignal;
+    }): Promise<Page[]>;
+    page(pageNumber: number, signal?: AbortSignal): Promise<Page>;
+    entities(options?: {
+        type?: string;
+        limit?: number;
+        offset?: number;
+        signal?: AbortSignal;
+    }): Promise<EntitiesResponse>;
+    downloadUrl(): string;
+    query(sql: string, signal?: AbortSignal): Promise<QueryResult>;
+    publish(signal?: AbortSignal): Promise<PublishResult>;
+    shareLink(options?: ShareLinkOptions): Promise<ShareLinkResult>;
+    prompt(query: string, options?: GenerateOptions & {
+        schema?: undefined;
+    }): Promise<GenerateResult>;
+    prompt<T>(query: string, options: GenerateOptions & {
+        schema: StructuredSchema<T>;
+    }): Promise<GenerateResult<T>>;
+    stream(query: string, options?: CompletionOptions): AsyncGenerator<CompletionEvent>;
+}
+interface PublishResult {
+    published: boolean;
+    documentId: string;
+    version: string;
+    publicUrl: string;
+    /** Immutable public URL: https://api.okrapdf.com/v1/documents/{id} */
+    url: string;
+    hash: string;
+    slug: string;
+    canonicalPath: string;
+}
+interface ShareLinkOptions {
+    /** Link role: 'viewer' (redacted/PDF access), 'admin' (full access), or 'ask' (public completion). */
+    role?: 'viewer' | 'ask' | 'admin';
+    label?: string;
+    expiresInMs?: number;
+    maxViews?: number;
+    signal?: AbortSignal;
+}
+interface ShareLinkLinks {
+    markdown: string | null;
+    pdf: string | null;
+    completion: string | null;
+}
+interface ShareLinkCapabilities {
+    canViewPdf: boolean;
+}
+interface ShareLinkResult {
+    documentId: string;
+    token: string;
+    tokenHint: string;
+    links: ShareLinkLinks;
+    capabilities: ShareLinkCapabilities;
+    role: string;
+    expiresAt: number;
+    maxViews: number | null;
+}
+interface DeploymentCreateOptions {
+    documentId?: string;
+    collectionId?: string;
+    guestAccess?: 'none' | 'read' | 'ask';
+    dataSource?: 'live' | 'snapshot';
+    chatPersistence?: 'persisted' | 'ephemeral';
+}
+interface DeploymentResult {
+    deploymentId: string;
+    completionUrl: string;
+    statusUrl: string;
+}
+interface DeploymentStatus {
+    deploymentId: string;
+    phase: string;
+    guestCount?: number;
+    eventCounter?: number;
+    [key: string]: unknown;
+}
+interface DeploymentCompletionOptions {
+    prompt: string;
+    guestId?: string;
+    model?: string;
+}
+interface DeploymentCompletionResult {
+    answer: string;
+    model?: string;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        costUsd?: number;
+    };
+    toolCalls?: unknown[];
+    guestId?: string;
+    taskRunId?: string;
+    cached?: boolean;
+}
+interface DeploymentTokenCreateOptions {
+    role: 'ask' | 'viewer' | 'admin';
+    maxUses?: number;
+    expiresInMs?: number;
+}
+interface DeploymentToken {
+    token: string;
+    tokenHint: string;
+    role: string;
+    maxUses?: number;
+    expiresAt?: number | null;
+}
+interface DeploymentTokenListResult {
+    tokens: Array<{
+        token_hint: string;
+        role: string;
+        current_uses: number;
+        max_uses: number | null;
+        revoked_at: number | null;
+        [key: string]: unknown;
+    }>;
+}
+interface DeploymentTokenRevokeResult {
+    revoked: boolean;
+    tokenHint: string;
+}
+interface UrlBuilderOptions {
+    format?: 'json' | 'csv' | 'html' | 'markdown' | 'png';
+    include?: string[];
+    /** Provider transformation — changes extraction source, e.g. 'llamaparse', 'googleocr'. */
+    provider?: string;
+}
+interface DocUrlOptions {
+    /**
+     * Original source filename used to build friendly artifact URLs, e.g.
+     * /.../invoice.json
+     */
+    fileName?: string;
+    /**
+     * Default provider transformation applied to all URLs from this builder.
+     * Cloudinary-style: `/t_llamaparse/pages/1.md` vs `/t_googleocr/pages/1.json`
+     */
+    provider?: string;
+    /**
+     * Default image placeholder type when page image is not yet available.
+     * Inserts `/d_{type}/` segment. e.g. 'shimmer' → `/d_shimmer/pages/1/image.png`
+     */
+    defaultImage?: string;
+}
+
+export type { ShareLinkLinks as A, StructuredOutputMeta as B, CompletionOptions as C, DocUrlOptions as D, EntitiesResponse as E, UploadRedactOptions as F, GenerateOptions as G, UploadRedactPiiOptions as H, JsonSchema as J, OkraSession as O, Page as P, QueryResult as Q, RuntimeErrorCode as R, SessionCreateOptions as S, UrlBuilderOptions as U, WaitOptions as W, UploadInput as a, SessionAttachOptions as b, DeploymentCreateOptions as c, DeploymentResult as d, DeploymentStatus as e, DeploymentCompletionOptions as f, DeploymentCompletionResult as g, DeploymentTokenCreateOptions as h, DeploymentToken as i, DeploymentTokenListResult as j, DeploymentTokenRevokeResult as k, OkraClientOptions as l, UploadOptions as m, DocumentStatus as n, CompletionEvent as o, GenerateResult as p, StructuredSchema as q, PublishResult as r, ShareLinkOptions as s, ShareLinkResult as t, StructuredOutputErrorCode as u, Entity as v, PageBlock as w, PageEntity as x, SessionState as y, ShareLinkCapabilities as z };

package/dist/url.d.ts

@@ -0,0 +1,48 @@
+import { D as DocUrlOptions, U as UrlBuilderOptions } from './types-DEYgGUnH.js';
+import 'zod';
+
+interface PgPage {
+    png: () => string;
+    md: () => string;
+    json: () => string;
+}
+interface PgProxy {
+    [index: number]: PgPage;
+}
+interface DocumentUrl {
+    /** Base document URL */
+    url: (opts?: UrlBuilderOptions) => string;
+    /** Thumbnail image URL (pg_1.png) */
+    thumbnail: {
+        url: () => string;
+    };
+    /** Page access: d.pg[1].png(), d.pg[1].md(), d.pg[1].json() */
+    pg: PgProxy;
+    /** Entity-level access */
+    entities: EntitiesProxy;
+}
+interface EntitiesProxy {
+    tables: EntityCollectionProxy;
+    figures: EntityCollectionProxy;
+}
+interface EntityCollectionProxy {
+    [index: number]: {
+        url: (opts?: {
+            format?: 'json' | 'csv' | 'html';
+        }) => string;
+    };
+    url: (opts?: UrlBuilderOptions) => string;
+}
+/**
+ * Build-time URL builder — Cloudinary for documents.
+ *
+ * ```tsx
+ * import { doc } from 'okrapdf';
+ * const d = doc('doc_7fK3x');
+ * <Image src={d.thumbnail.url()} />
+ * <a href={d.entities.tables[0].url({ format: 'csv' })}>CSV</a>
+ * ```
+ */
+declare function doc(documentId: string, baseUrlOrOptions?: string | DocUrlOptions, maybeOptions?: DocUrlOptions): DocumentUrl;
+
+export { doc };

package/dist/url.js

@@ -0,0 +1,7 @@
+import {
+  doc
+} from "./chunk-C6ZT7DKX.js";
+export {
+  doc
+};
+//# sourceMappingURL=url.js.map

package/dist/url.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/worker.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @okrapdf/runtime/worker — self-host subpath export.
+ *
+ * Re-export the DocumentAgent DO class and a request handler
+ * for self-hosted deployments.
+ *
+ * Usage:
+ * ```ts
+ * // worker.ts
+ * import { handleRequest } from '@okrapdf/runtime/worker';
+ * import { DocumentAgent } from './document-agent';
+ *
+ * export { DocumentAgent };
+ * export default { fetch: handleRequest({ DOCUMENT_AGENT: env.DOCUMENT_AGENT }) };
+ * ```
+ *
+ * ```toml
+ * # wrangler.toml
+ * [durable_objects]
+ * bindings = [{ name = "DOCUMENT_AGENT", class_name = "DocumentAgent" }]
+ * ```
+ */
+interface DurableObjectBinding {
+    idFromName(name: string): {
+        toString(): string;
+    };
+    get(id: {
+        toString(): string;
+    }): {
+        fetch(request: Request): Promise<Response>;
+    };
+}
+interface WorkerEnv {
+    DOCUMENT_AGENT: DurableObjectBinding;
+    DOCUMENT_AGENT_SHARED_SECRET?: string;
+    [key: string]: unknown;
+}
+/**
+ * Minimal request router that forwards /document/:id/* and /v1/documents/:id/*
+ * to the corresponding Durable Object.
+ */
+declare function handleRequest(env: WorkerEnv): (request: Request) => Promise<Response>;
+
+export { type DurableObjectBinding, type WorkerEnv, handleRequest };

package/dist/worker.js

@@ -0,0 +1,82 @@
+// src/worker.ts
+var DATA_URL_ALIAS_RE = /\/[a-z0-9][a-z0-9._-]*\.(json|html|md|markdown|pdf|png|csv|txt)$/i;
+var DATA_URL_MARKER_ALIAS_RE = /\/_\/[^/]*\.(json|html|md|markdown|pdf|png|csv|txt)$/i;
+var CANONICAL_PAGE_IMAGE_EXT_RE = /\/pages\/(\d+)\/image\.(png|jpg|jpeg|webp)$/i;
+var CANONICAL_PAGE_MARKDOWN_EXT_RE = /\/pages\/(\d+)\/markdown\.(md|markdown)$/i;
+var PAGE_IMAGE_ALIAS_RE = /\/pages\/(\d+)\/[^/]+\.(png|jpg|jpeg|webp)$/i;
+var PAGE_MARKDOWN_ALIAS_RE = /\/pages\/(\d+)\/[^/]+\.(md|markdown)$/i;
+var PAGE_MARKDOWN_NESTED_ALIAS_RE = /\/pages\/(\d+)\/markdown\/(?:_\/)?[^/]+\.(md|markdown)$/i;
+var PROVIDER_SEGMENT_RE = /^t_[a-z0-9][a-z0-9._-]*$/i;
+var DEFAULT_IMAGE_SEGMENT_RE = /^d_[a-z0-9][a-z0-9._:-]*$/i;
+function normalizeDataAliasPath(pathname, method) {
+  if (method !== "GET" && method !== "HEAD") return pathname;
+  if (PAGE_IMAGE_ALIAS_RE.test(pathname)) {
+    return pathname.replace(PAGE_IMAGE_ALIAS_RE, "/pages/$1/image");
+  }
+  if (CANONICAL_PAGE_IMAGE_EXT_RE.test(pathname)) {
+    return pathname.replace(CANONICAL_PAGE_IMAGE_EXT_RE, "/pages/$1/image");
+  }
+  if (PAGE_MARKDOWN_NESTED_ALIAS_RE.test(pathname)) {
+    return pathname.replace(PAGE_MARKDOWN_NESTED_ALIAS_RE, "/pages/$1/markdown");
+  }
+  if (CANONICAL_PAGE_MARKDOWN_EXT_RE.test(pathname)) {
+    return pathname.replace(CANONICAL_PAGE_MARKDOWN_EXT_RE, "/pages/$1/markdown");
+  }
+  if (PAGE_MARKDOWN_ALIAS_RE.test(pathname)) {
+    return pathname.replace(PAGE_MARKDOWN_ALIAS_RE, "/pages/$1/markdown");
+  }
+  if (DATA_URL_MARKER_ALIAS_RE.test(pathname)) {
+    return pathname.replace(DATA_URL_MARKER_ALIAS_RE, "");
+  }
+  if (!DATA_URL_ALIAS_RE.test(pathname)) return pathname;
+  return pathname.replace(DATA_URL_ALIAS_RE, "");
+}
+function normalizeTransformSegments(subpath) {
+  const parts = subpath.split("/");
+  let defaultImage;
+  const filtered = [parts[0]];
+  for (let i = 1; i < parts.length; i++) {
+    if (PROVIDER_SEGMENT_RE.test(parts[i])) continue;
+    if (DEFAULT_IMAGE_SEGMENT_RE.test(parts[i])) {
+      defaultImage = parts[i].slice(2);
+      continue;
+    }
+    filtered.push(parts[i]);
+  }
+  const normalized = filtered.join("/");
+  return {
+    subpath: normalized === "/" ? "" : normalized,
+    defaultImage
+  };
+}
+function handleRequest(env) {
+  return async (request) => {
+    const normalizedUrl = new URL(request.url);
+    normalizedUrl.pathname = normalizeDataAliasPath(normalizedUrl.pathname, request.method);
+    const url = normalizedUrl;
+    const path = url.pathname;
+    const docMatch = path.match(/^\/(?:document|v1\/documents)\/([^/]+)(\/.*)?$/);
+    if (!docMatch) {
+      return new Response(JSON.stringify({ error: "Not found" }), {
+        status: 404,
+        headers: { "Content-Type": "application/json" }
+      });
+    }
+    const documentId = decodeURIComponent(docMatch[1]);
+    const rawSubpath = docMatch[2] || "";
+    const { subpath: cleanSubpath, defaultImage } = normalizeTransformSegments(rawSubpath);
+    const subpath = cleanSubpath || "/status";
+    const doId = env.DOCUMENT_AGENT.idFromName(documentId);
+    const stub = env.DOCUMENT_AGENT.get(doId);
+    const doUrl = new URL(url.toString());
+    doUrl.pathname = `/document/${documentId}${subpath}`;
+    const headers = defaultImage ? new Headers(request.headers) : void 0;
+    if (headers && defaultImage) headers.set("X-Okra-Default", defaultImage);
+    const doRequest = headers ? new Request(doUrl.toString(), { method: request.method, headers, body: request.body }) : new Request(doUrl.toString(), request);
+    return stub.fetch(doRequest);
+  };
+}
+export {
+  handleRequest
+};
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/worker.ts"],"sourcesContent":["/**\n * @okrapdf/runtime/worker — self-host subpath export.\n *\n * Re-export the DocumentAgent DO class and a request handler\n * for self-hosted deployments.\n *\n * Usage:\n * ```ts\n * // worker.ts\n * import { handleRequest } from '@okrapdf/runtime/worker';\n * import { DocumentAgent } from './document-agent';\n *\n * export { DocumentAgent };\n * export default { fetch: handleRequest({ DOCUMENT_AGENT: env.DOCUMENT_AGENT }) };\n * ```\n *\n * ```toml\n * # wrangler.toml\n * [durable_objects]\n * bindings = [{ name = \"DOCUMENT_AGENT\", class_name = \"DocumentAgent\" }]\n * ```\n */\n\nexport interface DurableObjectBinding {\n  idFromName(name: string): { toString(): string };\n  get(id: { toString(): string }): { fetch(request: Request): Promise<Response> };\n}\n\nexport interface WorkerEnv {\n  DOCUMENT_AGENT: DurableObjectBinding;\n  DOCUMENT_AGENT_SHARED_SECRET?: string;\n  [key: string]: unknown;\n}\n\n// Strip trailing artifact filenames from URLs (e.g. /report.png, /document.md).\n// Matches both plain format and legacy suffix format for backward compat.\nconst DATA_URL_ALIAS_RE = /\\/[a-z0-9][a-z0-9._-]*\\.(json|html|md|markdown|pdf|png|csv|txt)$/i;\nconst DATA_URL_MARKER_ALIAS_RE = /\\/_\\/[^/]*\\.(json|html|md|markdown|pdf|png|csv|txt)$/i;\nconst CANONICAL_PAGE_IMAGE_EXT_RE = /\\/pages\\/(\\d+)\\/image\\.(png|jpg|jpeg|webp)$/i;\nconst CANONICAL_PAGE_MARKDOWN_EXT_RE = /\\/pages\\/(\\d+)\\/markdown\\.(md|markdown)$/i;\nconst PAGE_IMAGE_ALIAS_RE = /\\/pages\\/(\\d+)\\/[^/]+\\.(png|jpg|jpeg|webp)$/i;\nconst PAGE_MARKDOWN_ALIAS_RE = /\\/pages\\/(\\d+)\\/[^/]+\\.(md|markdown)$/i;\nconst PAGE_MARKDOWN_NESTED_ALIAS_RE = /\\/pages\\/(\\d+)\\/markdown\\/(?:_\\/)?[^/]+\\.(md|markdown)$/i;\nconst PROVIDER_SEGMENT_RE = /^t_[a-z0-9][a-z0-9._-]*$/i;\nconst DEFAULT_IMAGE_SEGMENT_RE = /^d_[a-z0-9][a-z0-9._:-]*$/i;\n\nfunction normalizeDataAliasPath(pathname: string, method: string): string {\n  if (method !== 'GET' && method !== 'HEAD') return pathname;\n  if (PAGE_IMAGE_ALIAS_RE.test(pathname)) {\n    return pathname.replace(PAGE_IMAGE_ALIAS_RE, '/pages/$1/image');\n  }\n  if (CANONICAL_PAGE_IMAGE_EXT_RE.test(pathname)) {\n    return pathname.replace(CANONICAL_PAGE_IMAGE_EXT_RE, '/pages/$1/image');\n  }\n  if (PAGE_MARKDOWN_NESTED_ALIAS_RE.test(pathname)) {\n    return pathname.replace(PAGE_MARKDOWN_NESTED_ALIAS_RE, '/pages/$1/markdown');\n  }\n  if (CANONICAL_PAGE_MARKDOWN_EXT_RE.test(pathname)) {\n    return pathname.replace(CANONICAL_PAGE_MARKDOWN_EXT_RE, '/pages/$1/markdown');\n  }\n  if (PAGE_MARKDOWN_ALIAS_RE.test(pathname)) {\n    return pathname.replace(PAGE_MARKDOWN_ALIAS_RE, '/pages/$1/markdown');\n  }\n  if (DATA_URL_MARKER_ALIAS_RE.test(pathname)) {\n    return pathname.replace(DATA_URL_MARKER_ALIAS_RE, '');\n  }\n  if (!DATA_URL_ALIAS_RE.test(pathname)) return pathname;\n  return pathname.replace(DATA_URL_ALIAS_RE, '');\n}\n\nfunction normalizeTransformSegments(subpath: string): { subpath: string; defaultImage?: string } {\n  const parts = subpath.split('/');\n  let defaultImage: string | undefined;\n\n  // Strip t_ (provider) and d_ (default image) segments from the path\n  const filtered: string[] = [parts[0]]; // keep leading empty string\n  for (let i = 1; i < parts.length; i++) {\n    if (PROVIDER_SEGMENT_RE.test(parts[i])) continue;\n    if (DEFAULT_IMAGE_SEGMENT_RE.test(parts[i])) {\n      defaultImage = parts[i].slice(2); // strip \"d_\" prefix\n      continue;\n    }\n    filtered.push(parts[i]);\n  }\n\n  const normalized = filtered.join('/');\n  return {\n    subpath: normalized === '/' ? '' : normalized,\n    defaultImage,\n  };\n}\n\n/**\n * Minimal request router that forwards /document/:id/* and /v1/documents/:id/*\n * to the corresponding Durable Object.\n */\nexport function handleRequest(env: WorkerEnv): (request: Request) => Promise<Response> {\n  return async (request: Request) => {\n    const normalizedUrl = new URL(request.url);\n    normalizedUrl.pathname = normalizeDataAliasPath(normalizedUrl.pathname, request.method);\n    const url = normalizedUrl;\n    const path = url.pathname;\n\n    // Match /document/:id/* or /v1/documents/:id/*\n    const docMatch = path.match(/^\\/(?:document|v1\\/documents)\\/([^/]+)(\\/.*)?$/);\n    if (!docMatch) {\n      return new Response(JSON.stringify({ error: 'Not found' }), {\n        status: 404,\n        headers: { 'Content-Type': 'application/json' },\n      });\n    }\n\n    const documentId = decodeURIComponent(docMatch[1]);\n    const rawSubpath = docMatch[2] || '';\n    const { subpath: cleanSubpath, defaultImage } = normalizeTransformSegments(rawSubpath);\n    const subpath = cleanSubpath || '/status';\n\n    const doId = env.DOCUMENT_AGENT.idFromName(documentId);\n    const stub = env.DOCUMENT_AGENT.get(doId);\n\n    // Forward to DO with the subpath\n    const doUrl = new URL(url.toString());\n    doUrl.pathname = `/document/${documentId}${subpath}`;\n\n    // Pass d_ value as header so DO can serve placeholder on R2 miss\n    const headers = defaultImage ? new Headers(request.headers) : undefined;\n    if (headers && defaultImage) headers.set('X-Okra-Default', defaultImage);\n    const doRequest = headers\n      ? new Request(doUrl.toString(), { method: request.method, headers, body: request.body })\n      : new Request(doUrl.toString(), request);\n\n    return stub.fetch(doRequest);\n  };\n}\n"],"mappings":";AAoCA,IAAM,oBAAoB;AAC1B,IAAM,2BAA2B;AACjC,IAAM,8BAA8B;AACpC,IAAM,iCAAiC;AACvC,IAAM,sBAAsB;AAC5B,IAAM,yBAAyB;AAC/B,IAAM,gCAAgC;AACtC,IAAM,sBAAsB;AAC5B,IAAM,2BAA2B;AAEjC,SAAS,uBAAuB,UAAkB,QAAwB;AACxE,MAAI,WAAW,SAAS,WAAW,OAAQ,QAAO;AAClD,MAAI,oBAAoB,KAAK,QAAQ,GAAG;AACtC,WAAO,SAAS,QAAQ,qBAAqB,iBAAiB;AAAA,EAChE;AACA,MAAI,4BAA4B,KAAK,QAAQ,GAAG;AAC9C,WAAO,SAAS,QAAQ,6BAA6B,iBAAiB;AAAA,EACxE;AACA,MAAI,8BAA8B,KAAK,QAAQ,GAAG;AAChD,WAAO,SAAS,QAAQ,+BAA+B,oBAAoB;AAAA,EAC7E;AACA,MAAI,+BAA+B,KAAK,QAAQ,GAAG;AACjD,WAAO,SAAS,QAAQ,gCAAgC,oBAAoB;AAAA,EAC9E;AACA,MAAI,uBAAuB,KAAK,QAAQ,GAAG;AACzC,WAAO,SAAS,QAAQ,wBAAwB,oBAAoB;AAAA,EACtE;AACA,MAAI,yBAAyB,KAAK,QAAQ,GAAG;AAC3C,WAAO,SAAS,QAAQ,0BAA0B,EAAE;AAAA,EACtD;AACA,MAAI,CAAC,kBAAkB,KAAK,QAAQ,EAAG,QAAO;AAC9C,SAAO,SAAS,QAAQ,mBAAmB,EAAE;AAC/C;AAEA,SAAS,2BAA2B,SAA6D;AAC/F,QAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,MAAI;AAGJ,QAAM,WAAqB,CAAC,MAAM,CAAC,CAAC;AACpC,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,QAAI,oBAAoB,KAAK,MAAM,CAAC,CAAC,EAAG;AACxC,QAAI,yBAAyB,KAAK,MAAM,CAAC,CAAC,GAAG;AAC3C,qBAAe,MAAM,CAAC,EAAE,MAAM,CAAC;AAC/B;AAAA,IACF;AACA,aAAS,KAAK,MAAM,CAAC,CAAC;AAAA,EACxB;AAEA,QAAM,aAAa,SAAS,KAAK,GAAG;AACpC,SAAO;AAAA,IACL,SAAS,eAAe,MAAM,KAAK;AAAA,IACnC;AAAA,EACF;AACF;AAMO,SAAS,cAAc,KAAyD;AACrF,SAAO,OAAO,YAAqB;AACjC,UAAM,gBAAgB,IAAI,IAAI,QAAQ,GAAG;AACzC,kBAAc,WAAW,uBAAuB,cAAc,UAAU,QAAQ,MAAM;AACtF,UAAM,MAAM;AACZ,UAAM,OAAO,IAAI;AAGjB,UAAM,WAAW,KAAK,MAAM,gDAAgD;AAC5E,QAAI,CAAC,UAAU;AACb,aAAO,IAAI,SAAS,KAAK,UAAU,EAAE,OAAO,YAAY,CAAC,GAAG;AAAA,QAC1D,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAChD,CAAC;AAAA,IACH;AAEA,UAAM,aAAa,mBAAmB,SAAS,CAAC,CAAC;AACjD,UAAM,aAAa,SAAS,CAAC,KAAK;AAClC,UAAM,EAAE,SAAS,cAAc,aAAa,IAAI,2BAA2B,UAAU;AACrF,UAAM,UAAU,gBAAgB;AAEhC,UAAM,OAAO,IAAI,eAAe,WAAW,UAAU;AACrD,UAAM,OAAO,IAAI,eAAe,IAAI,IAAI;AAGxC,UAAM,QAAQ,IAAI,IAAI,IAAI,SAAS,CAAC;AACpC,UAAM,WAAW,aAAa,UAAU,GAAG,OAAO;AAGlD,UAAM,UAAU,eAAe,IAAI,QAAQ,QAAQ,OAAO,IAAI;AAC9D,QAAI,WAAW,aAAc,SAAQ,IAAI,kBAAkB,YAAY;AACvE,UAAM,YAAY,UACd,IAAI,QAAQ,MAAM,SAAS,GAAG,EAAE,QAAQ,QAAQ,QAAQ,SAAS,MAAM,QAAQ,KAAK,CAAC,IACrF,IAAI,QAAQ,MAAM,SAAS,GAAG,OAAO;AAEzC,WAAO,KAAK,MAAM,SAAS;AAAA,EAC7B;AACF;","names":[]}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "okrapdf",
+  "version": "0.8.0",
+  "description": "OkraPDF — upload a PDF, get an API. Runtime client, React hooks, and CLI.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./doc": {
+      "import": {
+        "types": "./dist/url.d.ts",
+        "default": "./dist/url.js"
+      }
+    },
+    "./browser": {
+      "import": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.js"
+      }
+    },
+    "./worker": {
+      "import": {
+        "types": "./dist/worker.d.ts",
+        "default": "./dist/worker.js"
+      }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
+      }
+    },
+    "./cli": {
+      "import": {
+        "types": "./dist/cli/index.d.ts",
+        "default": "./dist/cli/index.js"
+      }
+    }
+  },
+  "bin": {
+    "okra": "./dist/cli/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "ws": "^8.19.0",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "@types/react": "^18.2.0",
+    "@types/ws": "^8.18.1",
+    "react": "^18.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  }
+}