okrapdf 0.9.1 → 0.10.0

package/dist/{types-C7IWrjwl.d.ts → types-DpLY63Cg.d.ts}

@@ -317,7 +317,39 @@ interface CollectionQueryStream<T = undefined> extends AsyncIterable<CollectionQ
     /** Expose the underlying NDJSON body as a ReadableStream (for proxying). */
     toReadableStream(): ReadableStream<Uint8Array>;
 }
+/** A document summary inside a collection listing. */
+interface CollectionDocument {
+    id: string;
+    file_name: string;
+    phase: string;
+    pages_total: number;
+    total_nodes: number;
+    added_at: string;
+    source: string;
+}
+/** Full collection metadata returned by `client.collections.get()`. */
+interface Collection {
+    id: string;
+    name: string;
+    description: string | null;
+    document_count: number;
+    visibility: 'public' | 'private';
+    user_id: string;
+    created_at: string;
+    documents: CollectionDocument[];
+}
+/** Summary row returned by `client.collections.list()`. */
+interface CollectionSummary {
+    id: string;
+    name: string;
+    description: string | null;
+    document_count: number;
+}
 interface OkraCollections {
+    /** List all collections for the authenticated user. */
+    list(signal?: AbortSignal): Promise<CollectionSummary[]>;
+    /** Get a single collection with its documents. */
+    get(collectionId: string, signal?: AbortSignal): Promise<Collection>;
     /** Unstructured fan-out — each doc answers independently via NDJSON stream. */
     query(collectionId: string, prompt: string, options?: CollectionQueryOptions): CollectionQueryStream;
     /** Structured fan-out — each doc extracts typed data matching the schema. */
@@ -337,11 +369,35 @@ interface OkraCollections {
         schema: StructuredSchema<T>;
     }): Promise<GenerateResult<T>>;
 }
+/** Delivery transform options for image resizing/processing (maps to CF Image Resizing). */
+interface DeliveryTransform {
+    w?: number;
+    h?: number;
+    dpr?: number;
+    q?: number;
+    f?: 'auto' | 'webp' | 'avif' | 'jpeg' | 'png';
+    md?: 'copyright' | 'keep' | 'none';
+    c?: 'scale-down' | 'contain' | 'cover' | 'crop' | 'pad' | 'squeeze';
+    g?: 'auto' | 'face' | 'left' | 'right' | 'top' | 'bottom' | 'center';
+    zm?: number;
+    bl?: number;
+    sh?: number;
+    br?: number;
+    co?: number;
+    sa?: number;
+    r?: number;
+    fl?: 'h' | 'v' | 'hv';
+    bg?: string;
+    anim?: boolean;
+    seg?: 'foreground';
+}
 interface UrlBuilderOptions {
     format?: 'json' | 'csv' | 'html' | 'markdown' | 'png';
     include?: string[];
     /** Provider transformation — changes extraction source, e.g. 'llamaparse', 'googleocr'. */
     provider?: string;
+    /** Delivery transform for image resizing/processing. */
+    transform?: DeliveryTransform;
 }
 interface DocUrlOptions {
     /**
@@ -364,6 +420,8 @@ interface DocUrlOptions {
      * 'shimmer' | 'auto' | 'color:hex'. Inserts `/d_{placeholder}/` segment.
      */
     placeholder?: string;
+    /** Output schema name — inserts `/o_{schema}/` segment. */
+    output?: string;
 }
 
-export type { UploadRedactPiiOptions as A, CompletionOptions as C, DocUrlOptions as D, EntitiesResponse as E, GenerateOptions as G, 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, OkraClientOptions as c, UploadOptions as d, DocumentStatus as e, CompletionEvent as f, GenerateResult as g, StructuredSchema as h, PublishResult as i, ShareLinkOptions as j, ShareLinkResult as k, SessionState as l, StructuredOutputErrorCode as m, CollectionQueryEvent as n, CollectionQueryOptions as o, CollectionQueryResult as p, CollectionQueryStream as q, DocumentAnswer as r, Entity as s, OkraCollections as t, PageBlock as u, PageEntity as v, ShareLinkCapabilities as w, ShareLinkLinks as x, StructuredOutputMeta as y, UploadRedactOptions as z };
+export type { ShareLinkCapabilities as A, ShareLinkLinks as B, CollectionSummary as C, DocUrlOptions as D, EntitiesResponse as E, StructuredOutputMeta as F, GenerateOptions as G, UploadRedactOptions as H, UploadRedactPiiOptions as I, JsonSchema as J, OkraSession as O, Page as P, QueryResult as Q, RuntimeErrorCode as R, SessionCreateOptions as S, UrlBuilderOptions as U, WaitOptions as W, DeliveryTransform as a, UploadInput as b, SessionAttachOptions as c, Collection as d, OkraClientOptions as e, UploadOptions as f, DocumentStatus as g, CompletionOptions as h, CompletionEvent as i, GenerateResult as j, StructuredSchema as k, PublishResult as l, ShareLinkOptions as m, ShareLinkResult as n, SessionState as o, StructuredOutputErrorCode as p, CollectionDocument as q, CollectionQueryEvent as r, CollectionQueryOptions as s, CollectionQueryResult as t, CollectionQueryStream as u, DocumentAnswer as v, Entity as w, OkraCollections as x, PageBlock as y, PageEntity as z };

package/dist/url.d.ts

@@ -1,16 +1,25 @@
-import { D as DocUrlOptions, U as UrlBuilderOptions } from './types-C7IWrjwl.js';
+import { D as DocUrlOptions, U as UrlBuilderOptions, a as DeliveryTransform } from './types-DpLY63Cg.js';
 import 'zod';
 
 interface PgPage {
     png: (opts?: {
         placeholder?: string;
+        transform?: DeliveryTransform;
+    }) => string;
+    md: (opts?: {
+        transform?: DeliveryTransform;
+    }) => string;
+    json: (opts?: {
+        transform?: DeliveryTransform;
     }) => string;
-    md: () => string;
-    json: () => string;
 }
 interface PgPageRange {
-    md: () => string;
-    json: () => string;
+    md: (opts?: {
+        transform?: DeliveryTransform;
+    }) => string;
+    json: (opts?: {
+        transform?: DeliveryTransform;
+    }) => string;
 }
 interface PgProxy {
     [index: number]: PgPage;
@@ -22,7 +31,9 @@ interface DocumentUrl {
     url: (opts?: UrlBuilderOptions) => string;
     /** Thumbnail image URL (pg_1.png) */
     thumbnail: {
-        url: () => string;
+        url: (opts?: {
+            transform?: DeliveryTransform;
+        }) => string;
     };
     /** Full document markdown */
     full: {
@@ -34,6 +45,8 @@ interface DocumentUrl {
     pg: PgProxy;
     /** Entity-level access */
     entities: EntitiesProxy;
+    /** Output schema — returns a new DocumentUrl scoped to o_{schema} */
+    output: (schema: string) => DocumentUrl;
 }
 interface EntitiesProxy {
     tables: EntityCollectionProxy;

package/dist/url.js

@@ -1,6 +1,6 @@
 import {
   doc
-} from "./chunk-5NINKIAC.js";
+} from "./chunk-QKII53VN.js";
 export {
   doc
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okrapdf",
-  "version": "0.9.1",
+  "version": "0.10.0",
   "description": "OkraPDF — upload a PDF, get an API. Runtime client, React hooks, and CLI.",
   "type": "module",
   "exports": {
@@ -75,7 +75,7 @@
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"
   },
-  "license": "UNLICENSED",
+  "license": "MIT",
   "publishConfig": {
     "access": "public"
   }

package/dist/chunk-4RJBVZJL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import { z, type ZodType } from 'zod';\nimport { OkraRuntimeError, StructuredOutputError } from './errors';\nimport type {\n  OkraClientOptions,\n  CompletionEvent,\n  CompletionOptions,\n  DocumentStatus,\n  EntitiesResponse,\n  GenerateOptions,\n  GenerateResult,\n  JsonSchema,\n  Page,\n  PublishResult,\n  QueryResult,\n  RuntimeErrorCode,\n  ShareLinkOptions,\n  ShareLinkResult,\n  SessionAttachOptions,\n  SessionCreateOptions,\n  SessionState,\n  OkraSession,\n  StructuredOutputErrorCode,\n  StructuredSchema,\n  UploadInput,\n  UploadOptions,\n  WaitOptions,\n} from './types';\n\nconst DEFAULT_BASE_URL = 'https://api.okrapdf.com';\nconst DEFAULT_WAIT_TIMEOUT_MS = 5 * 60_000;\nconst DEFAULT_WAIT_POLL_MS = 1_500;\nconst COMPLETE_PHASES = new Set(['complete', 'awaiting_review']);\nconst TERMINAL_ERROR_PHASES = new Set(['error']);\nconst STRUCTURED_CODES = new Set<StructuredOutputErrorCode>([\n  'SCHEMA_VALIDATION_FAILED',\n  'EXTRACTION_FAILED',\n  'TIMEOUT',\n  'DOCUMENT_NOT_FOUND',\n]);\nconst NODE_FS_PROMISES_SPECIFIER = `node:${'fs/promises'}`;\nconst NODE_PATH_SPECIFIER = `node:${'path'}`;\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction isHttpUrl(value: string): boolean {\n  return /^https?:\\/\\//i.test(value);\n}\n\nfunction isDocumentId(value: string): boolean {\n  return /^(?:ocr|doc)-[A-Za-z0-9_-]+$/.test(value);\n}\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n  return baseUrl.replace(/\\/+$/, '');\n}\n\nfunction makeDocId(): string {\n  if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n    return `doc-${crypto.randomUUID().replace(/-/g, '').slice(0, 20)}`;\n  }\n  const rand = Math.random().toString(36).slice(2, 22);\n  return `doc-${rand}`;\n}\n\nfunction toUint8Array(input: ArrayBuffer | Uint8Array): Uint8Array {\n  if (input instanceof Uint8Array) return input;\n  return new Uint8Array(input);\n}\n\ninterface NodeFsModule {\n  readFile(path: string): Promise<ArrayBuffer | Uint8Array>;\n}\n\ninterface NodePathModule {\n  basename(path: string): string;\n}\n\ninterface NamedBlob extends Blob {\n  name?: string;\n}\n\nfunction isBlobLike(input: unknown): input is Blob {\n  if (typeof Blob !== 'undefined' && input instanceof Blob) return true;\n  return !!input\n    && typeof input === 'object'\n    && typeof (input as { arrayBuffer?: unknown }).arrayBuffer === 'function';\n}\n\nfunction inferBlobName(input: Blob, fallback: string): string {\n  const named = input as NamedBlob;\n  if (typeof named.name === 'string' && named.name.trim() !== '') {\n    return named.name;\n  }\n  return fallback;\n}\n\nasync function readLocalFileFromNode(inputPath: string): Promise<{ bytes: Uint8Array; fileName: string }> {\n  try {\n    const [fsModule, pathModule] = await Promise.all([\n      import(NODE_FS_PROMISES_SPECIFIER) as Promise<NodeFsModule>,\n      import(NODE_PATH_SPECIFIER) as Promise<NodePathModule>,\n    ]);\n    const raw = await fsModule.readFile(inputPath);\n    return {\n      bytes: toUint8Array(raw),\n      fileName: pathModule.basename(inputPath),\n    };\n  } catch (error) {\n    throw new OkraRuntimeError(\n      'INVALID_REQUEST',\n      'Local file path uploads are only supported in Node.js. In browser runtimes, pass File/Blob, ArrayBuffer, Uint8Array, or URL.',\n      400,\n      error,\n    );\n  }\n}\n\ninterface StructuredErrorEnvelope {\n  code?: string;\n  message?: string;\n  details?: unknown;\n  error?: string;\n}\n\ninterface NormalizedSchema<T> {\n  jsonSchema: JsonSchema;\n  parser?: ZodType<T>;\n}\n\nfunction normalizeSchema<T>(schema: StructuredSchema<T>): NormalizedSchema<T> {\n  const maybeZod = schema as ZodType<T>;\n  const hasSafeParse = typeof (maybeZod as { safeParse?: unknown }).safeParse === 'function';\n  if (hasSafeParse) {\n    return {\n      jsonSchema: z.toJSONSchema(maybeZod, { target: 'draft-2020-12' }) as JsonSchema,\n      parser: maybeZod,\n    };\n  }\n  return { jsonSchema: schema as JsonSchema };\n}\n\nfunction isStructuredCode(code: string | undefined): code is StructuredOutputErrorCode {\n  return !!code && STRUCTURED_CODES.has(code as StructuredOutputErrorCode);\n}\n\n// ─── Session Handle ──────────────────────────────────────────────────────────\n\nclass OkraSessionHandle implements OkraSession {\n  readonly id: string;\n  readonly modelEndpoint: string;\n  #model?: string;\n  #client: OkraClient;\n\n  constructor(client: OkraClient, documentId: string, model?: string) {\n    this.#client = client;\n    this.id = documentId;\n    this.modelEndpoint = client.modelEndpoint(documentId);\n    this.#model = model;\n  }\n\n  get model(): string | undefined {\n    return this.#model;\n  }\n\n  state(): SessionState {\n    return {\n      id: this.id,\n      model: this.#model,\n      modelEndpoint: this.modelEndpoint,\n    };\n  }\n\n  async setModel(model: string): Promise<void> {\n    const normalized = model.trim();\n    if (!normalized) {\n      throw new OkraRuntimeError('INVALID_REQUEST', 'session.setModel requires a non-empty model', 400);\n    }\n    this.#model = normalized;\n  }\n\n  status(signal?: AbortSignal): Promise<DocumentStatus> {\n    return this.#client.status(this.id, signal);\n  }\n\n  wait(options?: WaitOptions): Promise<DocumentStatus> {\n    return this.#client.wait(this.id, options);\n  }\n\n  pages(options?: { range?: string; signal?: AbortSignal }): Promise<Page[]> {\n    return this.#client.pages(this.id, options);\n  }\n\n  page(pageNumber: number, signal?: AbortSignal): Promise<Page> {\n    return this.#client.page(this.id, pageNumber, signal);\n  }\n\n  entities(options?: { type?: string; limit?: number; offset?: number; signal?: AbortSignal }): Promise<EntitiesResponse> {\n    return this.#client.entities(this.id, options);\n  }\n\n  downloadUrl(): string {\n    return this.#client.downloadUrl(this.id);\n  }\n\n  query(sql: string, signal?: AbortSignal): Promise<QueryResult> {\n    return this.#client.query(this.id, sql, signal);\n  }\n\n  publish(signal?: AbortSignal): Promise<PublishResult> {\n    return this.#client.publish(this.id, signal);\n  }\n\n  shareLink(options?: ShareLinkOptions): Promise<ShareLinkResult> {\n    return this.#client.shareLink(this.id, options);\n  }\n\n  prompt(\n    query: string,\n    options?: GenerateOptions & { schema?: undefined },\n  ): Promise<GenerateResult>;\n  prompt<T>(\n    query: string,\n    options: GenerateOptions & { schema: StructuredSchema<T> },\n  ): Promise<GenerateResult<T>>;\n  prompt<T = undefined>(\n    query: string,\n    options?: GenerateOptions,\n  ): Promise<GenerateResult<T>> {\n    const model = options?.model ?? this.#model;\n    const merged = model ? { ...options, model } : options;\n    if (merged?.schema !== undefined) {\n      return this.#client.generate(\n        this.id,\n        query,\n        merged as GenerateOptions & { schema: StructuredSchema<unknown> },\n      ) as Promise<GenerateResult<T>>;\n    }\n    return this.#client.generate(\n      this.id,\n      query,\n      merged as GenerateOptions & { schema?: undefined },\n    ) as Promise<GenerateResult<T>>;\n  }\n\n  stream(\n    query: string,\n    options?: CompletionOptions,\n  ): AsyncGenerator<CompletionEvent> {\n    const model = options?.model ?? this.#model;\n    const merged = model ? { ...options, model } : options;\n    return this.#client.stream(this.id, query, merged);\n  }\n}\n\n// ─── Client ──────────────────────────────────────────────────────────────────\n\nexport class OkraClient {\n  private readonly baseUrl: string;\n  private readonly apiKey?: string;\n  private readonly sharedSecret?: string;\n  private readonly fetchImpl: typeof globalThis.fetch;\n  readonly sessions: {\n    create: (sourceOrDocId: UploadInput, options?: SessionCreateOptions) => Promise<OkraSession>;\n    from: (documentId: string, options?: SessionAttachOptions) => OkraSession;\n  };\n  constructor(options: OkraClientOptions) {\n    this.baseUrl = normalizeBaseUrl(options.baseUrl || DEFAULT_BASE_URL);\n    this.apiKey = options.apiKey;\n    this.sharedSecret = options.sharedSecret;\n    this.fetchImpl = options.fetch || globalThis.fetch.bind(globalThis);\n\n    if (!this.apiKey && !this.sharedSecret) {\n      throw new OkraRuntimeError(\n        'UNAUTHORIZED',\n        'OkraClient requires either apiKey or sharedSecret',\n        401,\n      );\n    }\n\n    if (\n      typeof globalThis !== 'undefined' && 'window' in globalThis\n      && this.apiKey\n      && !this.apiKey.startsWith('okra_pk_')\n    ) {\n      console.warn(\n        '[OkraPDF] Secret API key detected in browser. Use a publishable key (okra_pk_...) for client-side usage. ' +\n        'See https://docs.okrapdf.dev/api-keys#publishable-keys',\n      );\n    }\n\n    this.sessions = {\n      create: async (sourceOrDocId, sessionOptions = {}) => {\n        let documentId: string;\n        if (typeof sourceOrDocId === 'string' && isDocumentId(sourceOrDocId.trim())) {\n          documentId = sourceOrDocId.trim();\n        } else {\n          const session = await this.upload(sourceOrDocId, sessionOptions.upload);\n          documentId = session.id;\n        }\n\n        const session = this.sessions.from(documentId, { model: sessionOptions.model });\n        if (sessionOptions.wait ?? true) {\n          await session.wait(sessionOptions.waitOptions);\n        }\n        return session;\n      },\n      from: (documentId, sessionOptions = {}) => {\n        const normalized = documentId.trim();\n        if (!normalized) {\n          throw new OkraRuntimeError(\n            'INVALID_REQUEST',\n            'sessions.from requires a non-empty documentId',\n            400,\n          );\n        }\n\n        return new OkraSessionHandle(\n          this,\n          normalized,\n          sessionOptions.model?.trim() || undefined,\n        );\n      },\n    };\n  }\n\n  // ─── Upload ──────────────────────────────────────────────────────────────\n\n  async upload(input: UploadInput, options: UploadOptions = {}): Promise<OkraSession> {\n    const documentId = options.documentId || makeDocId();\n    const path = `/document/${encodeURIComponent(documentId)}`;\n    const visibility = options.visibility || 'private';\n\n    if (typeof input === 'string' && isHttpUrl(input)) {\n      const urlHeaders: Record<string, string> = { 'Content-Type': 'application/json' };\n      if (options.vendorKeys) {\n        urlHeaders['X-Vendor-Keys'] = JSON.stringify(options.vendorKeys);\n      }\n      await this.requestJson<{ phase?: string }>(`${path}/upload-url`, {\n        method: 'POST',\n        headers: urlHeaders,\n        body: JSON.stringify({\n          url: input,\n          capabilities: options.capabilities,\n          visibility,\n          redact: options.redact,\n        }),\n      });\n      return this.sessions.from(documentId);\n    }\n\n    let bytes: Uint8Array;\n    let fileName = options.fileName || 'document.pdf';\n    if (typeof input === 'string') {\n      const local = await readLocalFileFromNode(input);\n      bytes = local.bytes;\n      if (!options.fileName) fileName = local.fileName;\n    } else if (isBlobLike(input)) {\n      bytes = toUint8Array(await input.arrayBuffer());\n      if (!options.fileName) {\n        fileName = inferBlobName(input, fileName);\n      }\n    } else {\n      bytes = toUint8Array(input);\n    }\n\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/pdf',\n      'X-File-Name': fileName,\n    };\n    if (options.capabilities) {\n      headers['X-Capabilities'] = JSON.stringify(options.capabilities);\n    }\n    if (options.vendorKeys) {\n      headers['X-Vendor-Keys'] = JSON.stringify(options.vendorKeys);\n    }\n    if (options.redact) {\n      headers['X-Redact'] = JSON.stringify(options.redact);\n    }\n    if (visibility === 'public') {\n      headers['X-Visibility'] = 'public';\n    }\n\n    await this.requestJson<{ phase?: string }>(`${path}/upload`, {\n      method: 'POST',\n      headers,\n      body: bytes as unknown as BodyInit,\n    });\n\n    return this.sessions.from(documentId);\n  }\n\n  // ─── Status / Wait ───────────────────────────────────────────────────────\n\n  async status(documentId: string, signal?: AbortSignal): Promise<DocumentStatus> {\n    return this.requestJson<DocumentStatus>(\n      `/document/${encodeURIComponent(documentId)}/status`,\n      { method: 'GET', signal },\n    );\n  }\n\n  async wait(documentId: string, options: WaitOptions = {}): Promise<DocumentStatus> {\n    const startedAt = Date.now();\n    const timeoutMs = options.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;\n    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_WAIT_POLL_MS;\n\n    while (true) {\n      if (options.signal?.aborted) {\n        throw new OkraRuntimeError('TIMEOUT', 'Wait aborted', 499);\n      }\n\n      const current = await this.status(documentId, options.signal);\n      if (COMPLETE_PHASES.has(current.phase)) {\n        return current;\n      }\n      if (TERMINAL_ERROR_PHASES.has(current.phase)) {\n        throw new OkraRuntimeError(\n          'EXTRACTION_FAILED',\n          `Document entered terminal error phase (${current.phase})`,\n          500,\n          current,\n        );\n      }\n\n      const elapsed = Date.now() - startedAt;\n      if (elapsed >= timeoutMs) {\n        throw new OkraRuntimeError(\n          'TIMEOUT',\n          `Timed out waiting for document ${documentId} after ${timeoutMs}ms`,\n          504,\n          current,\n        );\n      }\n\n      await sleep(pollIntervalMs);\n    }\n  }\n\n  // ─── Pages ───────────────────────────────────────────────────────────────\n\n  async pages(documentId: string, options?: { range?: string; signal?: AbortSignal }): Promise<Page[]> {\n    const params = options?.range ? `?range=${encodeURIComponent(options.range)}` : '';\n    return this.requestJson<Page[]>(\n      `/document/${encodeURIComponent(documentId)}/pages${params}`,\n      { method: 'GET', signal: options?.signal },\n    );\n  }\n\n  async page(documentId: string, pageNumber: number, signal?: AbortSignal): Promise<Page> {\n    return this.requestJson<Page>(\n      `/document/${encodeURIComponent(documentId)}/page/${pageNumber}`,\n      { method: 'GET', signal },\n    );\n  }\n\n  // ─── Download ──────────────────────────────────────────────────────────\n\n  downloadUrl(documentId: string): string {\n    return `${this.baseUrl}/document/${encodeURIComponent(documentId)}/download`;\n  }\n\n  // ─── Entities ────────────────────────────────────────────────────────────\n\n  async entities(\n    documentId: string,\n    options?: { type?: string; limit?: number; offset?: number; signal?: AbortSignal },\n  ): Promise<EntitiesResponse> {\n    const params = new URLSearchParams();\n    if (options?.type) params.set('type', options.type);\n    if (options?.limit) params.set('limit', String(options.limit));\n    if (options?.offset) params.set('offset', String(options.offset));\n    const qs = params.toString();\n    return this.requestJson<EntitiesResponse>(\n      `/document/${encodeURIComponent(documentId)}/nodes${qs ? `?${qs}` : ''}`,\n      { method: 'GET', signal: options?.signal },\n    );\n  }\n\n  // ─── Query (SQL) ─────────────────────────────────────────────────────────\n\n  async query(documentId: string, sql: string, signal?: AbortSignal): Promise<QueryResult> {\n    return this.requestJson<QueryResult>(\n      `/document/${encodeURIComponent(documentId)}/query?select=${encodeURIComponent(sql)}`,\n      { method: 'GET', signal },\n    );\n  }\n\n  // ─── Stream (streaming completion via OpenAI SSE) ────────────────────────\n\n  async *stream(\n    documentId: string,\n    query: string,\n    options?: CompletionOptions,\n  ): AsyncGenerator<CompletionEvent> {\n    const response = await this.rawRequest(\n      `/document/${encodeURIComponent(documentId)}/chat/completions`,\n      {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          messages: [{ role: 'user', content: query }],\n          stream: options?.stream !== false,\n          ...(options?.model ? { model: options.model } : {}),\n        }),\n        signal: options?.signal,\n      },\n    );\n\n    if (!response.ok) {\n      const text = await response.text();\n      throw new OkraRuntimeError('HTTP_ERROR', `Completion failed: ${text}`, response.status);\n    }\n\n    if (!response.body) {\n      throw new OkraRuntimeError('INVALID_RESPONSE', 'No response body for completion stream', 500);\n    }\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = '';\n    let fullText = '';\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split('\\n');\n        buffer = lines.pop() || '';\n\n        for (const line of lines) {\n          const trimmed = line.trim();\n          if (!trimmed || trimmed === 'data: [DONE]') continue;\n          if (!trimmed.startsWith('data: ')) continue;\n          const json = trimmed.slice(6);\n          try {\n            const chunk = JSON.parse(json) as {\n              choices?: Array<{ delta?: { content?: string }; finish_reason?: string | null }>;\n              usage?: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number };\n              error?: { message?: string };\n            };\n\n            if (chunk.error) {\n              yield { type: 'error', message: chunk.error.message || 'Stream error' };\n              continue;\n            }\n\n            const delta = chunk.choices?.[0]?.delta?.content;\n            if (delta) {\n              fullText += delta;\n              yield { type: 'text_delta', text: delta };\n            }\n\n            if (chunk.choices?.[0]?.finish_reason === 'stop') {\n              yield { type: 'done', answer: fullText };\n            }\n          } catch {\n            // skip malformed lines\n          }\n        }\n      }\n    } finally {\n      reader.releaseLock();\n    }\n  }\n\n  // ─── Generate (non-streaming AI) ─────────────────────────────────────────\n\n  async generate(\n    documentId: string,\n    query: string,\n    options?: GenerateOptions & { schema?: undefined },\n  ): Promise<GenerateResult>;\n  async generate<T>(\n    documentId: string,\n    query: string,\n    options: GenerateOptions & { schema: StructuredSchema<T> },\n  ): Promise<GenerateResult<T>>;\n  async generate<T = undefined>(\n    documentId: string,\n    query: string,\n    options?: GenerateOptions,\n  ): Promise<GenerateResult<T>> {\n    if (options?.schema) {\n      return this.generateStructured<T>(documentId, query, options);\n    }\n\n    const result = await this.requestJson<{\n      id: string;\n      choices: Array<{ message: { content: string } }>;\n      usage?: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number };\n    }>(\n      `/document/${encodeURIComponent(documentId)}/chat/completions`,\n      {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          messages: [{ role: 'user', content: query }],\n          ...(options?.model ? { model: options.model } : {}),\n        }),\n        signal: options?.signal,\n      },\n    );\n\n    return {\n      answer: result.choices?.[0]?.message?.content || '',\n    };\n  }\n\n  private async generateStructured<T>(\n    documentId: string,\n    query: string,\n    options: GenerateOptions,\n  ): Promise<GenerateResult<T>> {\n    if (!query || query.trim() === '') {\n      throw new OkraRuntimeError('INVALID_REQUEST', 'generate with schema requires a non-empty query', 400);\n    }\n\n    const normalized = normalizeSchema(options.schema as StructuredSchema<T>);\n    const result = await this.requestJson<{\n      id: string;\n      choices: Array<{ message: { content: string } }>;\n      usage?: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number };\n    }>(\n      `/document/${encodeURIComponent(documentId)}/chat/completions`,\n      {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          messages: [{ role: 'user', content: query }],\n          response_format: {\n            type: 'json_schema',\n            json_schema: { name: 'result', schema: normalized.jsonSchema },\n          },\n          ...(options.model ? { model: options.model } : {}),\n        }),\n        signal: options.signal,\n      },\n    );\n\n    const raw = result.choices?.[0]?.message?.content;\n    if (!raw) {\n      throw new OkraRuntimeError('INVALID_RESPONSE', 'No content in structured output response', 500);\n    }\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      throw new OkraRuntimeError('INVALID_RESPONSE', 'Structured output response is not valid JSON', 500);\n    }\n\n    let data: T;\n    if (normalized.parser) {\n      const zodResult = normalized.parser.safeParse(parsed);\n      if (!zodResult.success) {\n        throw new StructuredOutputError(\n          'SCHEMA_VALIDATION_FAILED',\n          'Client-side schema validation failed for structured output response',\n          422,\n          zodResult.error.issues,\n        );\n      }\n      data = zodResult.data;\n    } else {\n      data = parsed as T;\n    }\n\n    return {\n      answer: '',\n      data,\n    };\n  }\n\n  // ─── Model Endpoint ──────────────────────────────────────────────────────\n\n  modelEndpoint(documentId: string): string {\n    return `${this.baseUrl}/v1/documents/${encodeURIComponent(documentId)}`;\n  }\n\n  // ─── Publish / Share ────────────────────────────────────────────────────\n\n  async publish(documentId: string, signal?: AbortSignal): Promise<PublishResult> {\n    const result = await this.requestJson<Omit<PublishResult, 'url'>>(\n      `/document/${encodeURIComponent(documentId)}/publish`,\n      { method: 'POST', signal },\n    );\n    return {\n      ...result,\n      url: `${this.baseUrl}/v1/documents/${encodeURIComponent(documentId)}`,\n    };\n  }\n\n  async shareLink(documentId: string, options?: ShareLinkOptions): Promise<ShareLinkResult> {\n    return this.requestJson<ShareLinkResult>(\n      `/document/${encodeURIComponent(documentId)}/share-link`,\n      {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({\n          role: options?.role,\n          label: options?.label,\n          expiresInMs: options?.expiresInMs,\n          maxViews: options?.maxViews,\n        }),\n        signal: options?.signal,\n      },\n    );\n  }\n\n  // ─── Public HTTP ─────────────────────────────────────────────────────────\n\n  async request<T>(path: string, init: RequestInit = {}): Promise<T> {\n    return this.requestJson<T>(path, init);\n  }\n\n  get url(): string {\n    return this.baseUrl;\n  }\n\n  // ─── Internal HTTP ───────────────────────────────────────────────────────\n\n  private authHeaders(): Record<string, string> {\n    if (this.apiKey) return { Authorization: `Bearer ${this.apiKey}` };\n    if (this.sharedSecret) return { 'x-document-agent-secret': this.sharedSecret };\n    return {};\n  }\n\n  private async rawRequest(path: string, init: RequestInit): Promise<Response> {\n    const headers = new Headers(init.headers);\n    for (const [key, value] of Object.entries(this.authHeaders())) {\n      if (!headers.has(key)) headers.set(key, value);\n    }\n\n    try {\n      return await this.fetchImpl(`${this.baseUrl}${path}`, { ...init, headers });\n    } catch (err) {\n      throw new OkraRuntimeError(\n        'HTTP_ERROR',\n        err instanceof Error ? err.message : String(err),\n        502,\n      );\n    }\n  }\n\n  private async requestJson<T>(path: string, init: RequestInit): Promise<T> {\n    const response = await this.rawRequest(path, init);\n    const text = await response.text();\n    const parsed = this.parseBody(text);\n\n    if (!response.ok) {\n      const envelope = parsed as StructuredErrorEnvelope | null;\n      const code = envelope?.code;\n      const message = envelope?.message || envelope?.error || `Request failed with status ${response.status}`;\n      const details = envelope?.details ?? parsed ?? text;\n      if (isStructuredCode(code)) {\n        throw new StructuredOutputError(code, message, response.status, details);\n      }\n      const runtimeCode: RuntimeErrorCode = response.status === 401 ? 'UNAUTHORIZED' : 'HTTP_ERROR';\n      throw new OkraRuntimeError(runtimeCode, message, response.status, details);\n    }\n\n    if (parsed === null) {\n      throw new OkraRuntimeError(\n        'INVALID_RESPONSE',\n        `Expected JSON response for ${path}`,\n        response.status,\n        text,\n      );\n    }\n\n    return parsed as T;\n  }\n\n  private parseBody(text: string): unknown | null {\n    const trimmed = text.trim();\n    if (!trimmed) return null;\n    try {\n      return JSON.parse(trimmed);\n    } catch {\n      return null;\n    }\n  }\n}\n"],"mappings":"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","names":["session"]}

package/dist/chunk-5NINKIAC.js

@@ -1,139 +0,0 @@
-// src/url.ts
-var DEFAULT_BASE_URL = "https://api.okrapdf.com";
-var FORMAT_TO_EXT = {
-  json: "json",
-  csv: "csv",
-  html: "html",
-  markdown: "md",
-  png: "png"
-};
-function slugifyFileStem(fileName) {
-  const leaf = fileName.split("/").pop() || fileName;
-  const noExt = leaf.replace(/\.[A-Za-z0-9]{1,8}$/, "");
-  const slug = noExt.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48);
-  return slug || "document";
-}
-function extensionFor(format, fallback) {
-  if (!format) return fallback;
-  const lower = format.toLowerCase();
-  if (lower === "markdown") return "md";
-  return FORMAT_TO_EXT[lower] || lower;
-}
-function doc(documentId, baseUrlOrOptions = DEFAULT_BASE_URL, maybeOptions = {}) {
-  const baseUrl = typeof baseUrlOrOptions === "string" ? baseUrlOrOptions : DEFAULT_BASE_URL;
-  const options = typeof baseUrlOrOptions === "string" ? maybeOptions : baseUrlOrOptions;
-  const base = baseUrl.replace(/\/+$/, "");
-  const defaultProvider = options.provider;
-  const defaultImage = options.placeholder || options.defaultImage;
-  const providerSegment = (p) => {
-    const provider = p || defaultProvider;
-    return provider ? `/t_${provider}` : "";
-  };
-  const defaultImageSegment = (override) => {
-    const img = override || defaultImage;
-    return img ? `/d_${img}` : "";
-  };
-  const docBase = `${base}/v1/documents/${encodeURIComponent(documentId)}`;
-  const artifactBase = options.fileName ? slugifyFileStem(options.fileName) : "document";
-  const withArtifact = (path, ext, qs = "") => `${path}/${artifactBase}.${ext}${qs}`;
-  const withProvider = (path, provider) => {
-    const seg = providerSegment(provider) + defaultImageSegment();
-    if (!seg) return path;
-    return path.replace(docBase, `${docBase}${seg}`);
-  };
-  const formatParams = (opts) => {
-    const params = new URLSearchParams();
-    if (opts?.format) params.set("format", opts.format);
-    if (opts?.include?.length) params.set("include", opts.include.join(","));
-    const qs = params.toString();
-    return qs ? `?${qs}` : "";
-  };
-  const makeEntityCollection = (type) => {
-    return new Proxy({}, {
-      get(_target, prop) {
-        if (prop === "url") {
-          return (opts) => withProvider(
-            withArtifact(
-              `${docBase}/entities/${type}`,
-              extensionFor(opts?.format, "json"),
-              formatParams(opts)
-            ),
-            opts?.provider
-          );
-        }
-        const index = typeof prop === "string" ? parseInt(prop, 10) : NaN;
-        if (!isNaN(index)) {
-          return {
-            url: (opts) => {
-              const params = opts?.format ? `?format=${opts.format}` : "";
-              return withProvider(
-                withArtifact(
-                  `${docBase}/entities/${type}/${index}`,
-                  extensionFor(opts?.format, "json"),
-                  params
-                ),
-                opts?.provider
-              );
-            }
-          };
-        }
-        return void 0;
-      }
-    });
-  };
-  const pgUrl = (segment, ext, placeholderOverride) => {
-    const imgSeg = defaultImageSegment(placeholderOverride);
-    const provSeg = providerSegment();
-    const seg = provSeg + imgSeg;
-    const flatPath = `${docBase}/pg_${segment}.${ext}`;
-    if (!seg) return flatPath;
-    return flatPath.replace(docBase, `${docBase}${seg}`);
-  };
-  const makePgPage = (pageNum) => ({
-    png: (opts) => pgUrl(String(pageNum), "png", opts?.placeholder),
-    md: () => pgUrl(String(pageNum), "md"),
-    json: () => pgUrl(String(pageNum), "json")
-  });
-  const makePgRange = (segment) => ({
-    md: () => pgUrl(segment, "md"),
-    json: () => pgUrl(segment, "json")
-  });
-  const pg = new Proxy({}, {
-    get(_target, prop) {
-      if (prop === "range") {
-        return (start, end) => makePgRange(`${start}-${end}`);
-      }
-      if (prop === "list") {
-        return (...pages) => makePgRange(pages.join(","));
-      }
-      const pageNum = typeof prop === "string" ? parseInt(prop, 10) : NaN;
-      if (!isNaN(pageNum)) {
-        return makePgPage(pageNum);
-      }
-      return void 0;
-    }
-  });
-  return {
-    url: (opts) => withProvider(
-      withArtifact(docBase, extensionFor(opts?.format, "json"), formatParams(opts)),
-      opts?.provider
-    ),
-    thumbnail: {
-      url: () => pgUrl("1", "png")
-    },
-    full: {
-      md: () => `${docBase}/full.md`
-    },
-    download: () => `${base}/document/${encodeURIComponent(documentId)}/download`,
-    pg,
-    entities: {
-      tables: makeEntityCollection("tables"),
-      figures: makeEntityCollection("figures")
-    }
-  };
-}
-
-export {
-  doc
-};
-//# sourceMappingURL=chunk-5NINKIAC.js.map

package/dist/chunk-5NINKIAC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/url.ts"],"sourcesContent":["import type { DocUrlOptions, UrlBuilderOptions } from './types';\n\nconst DEFAULT_BASE_URL = 'https://api.okrapdf.com';\n\ninterface PgPage {\n  png: (opts?: { placeholder?: string }) => string;\n  md: () => string;\n  json: () => string;\n}\n\ninterface PgPageRange {\n  md: () => string;\n  json: () => string;\n}\n\ninterface PgProxy {\n  [index: number]: PgPage;\n  range: (start: number, end: number) => PgPageRange;\n  list: (...pages: number[]) => PgPageRange;\n}\n\ninterface DocumentUrl {\n  /** Base document URL */\n  url: (opts?: UrlBuilderOptions) => string;\n  /** Thumbnail image URL (pg_1.png) */\n  thumbnail: { url: () => string };\n  /** Full document markdown */\n  full: { md: () => string };\n  /** Original PDF download (auth required) */\n  download: () => string;\n  /** Page access: d.pg[1].png(), d.pg[1].md(), d.pg[1].json() */\n  pg: PgProxy;\n  /** Entity-level access */\n  entities: EntitiesProxy;\n}\n\ninterface EntitiesProxy {\n  tables: EntityCollectionProxy;\n  figures: EntityCollectionProxy;\n}\n\ninterface EntityCollectionProxy {\n  [index: number]: {\n    url: (opts?: { format?: 'json' | 'csv' | 'html' }) => string;\n  };\n  url: (opts?: UrlBuilderOptions) => string;\n}\n\nconst FORMAT_TO_EXT: Record<NonNullable<UrlBuilderOptions['format']>, string> = {\n  json: 'json',\n  csv: 'csv',\n  html: 'html',\n  markdown: 'md',\n  png: 'png',\n};\n\nfunction slugifyFileStem(fileName: string): string {\n  const leaf = fileName.split('/').pop() || fileName;\n  const noExt = leaf.replace(/\\.[A-Za-z0-9]{1,8}$/, '');\n  const slug = noExt\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 48);\n  return slug || 'document';\n}\n\nfunction extensionFor(format: string | undefined, fallback: string): string {\n  if (!format) return fallback;\n  const lower = format.toLowerCase();\n  if (lower === 'markdown') return 'md';\n  return FORMAT_TO_EXT[lower as keyof typeof FORMAT_TO_EXT] || lower;\n}\n\n/**\n * Build-time URL builder — Cloudinary for documents.\n *\n * ```tsx\n * import { doc } from 'okrapdf';\n * const d = doc('doc_7fK3x');\n * <Image src={d.thumbnail.url()} />\n * <a href={d.entities.tables[0].url({ format: 'csv' })}>CSV</a>\n * ```\n */\nexport function doc(\n  documentId: string,\n  baseUrlOrOptions: string | DocUrlOptions = DEFAULT_BASE_URL,\n  maybeOptions: DocUrlOptions = {},\n): DocumentUrl {\n  const baseUrl = typeof baseUrlOrOptions === 'string' ? baseUrlOrOptions : DEFAULT_BASE_URL;\n  const options = typeof baseUrlOrOptions === 'string' ? maybeOptions : baseUrlOrOptions;\n\n  const base = baseUrl.replace(/\\/+$/, '');\n  const defaultProvider = options.provider;\n  const defaultImage = options.placeholder || options.defaultImage;\n  const providerSegment = (p?: string) => {\n    const provider = p || defaultProvider;\n    return provider ? `/t_${provider}` : '';\n  };\n  const defaultImageSegment = (override?: string) => {\n    const img = override || defaultImage;\n    return img ? `/d_${img}` : '';\n  };\n  const docBase = `${base}/v1/documents/${encodeURIComponent(documentId)}`;\n  const artifactBase = options.fileName\n    ? slugifyFileStem(options.fileName)\n    : 'document';\n\n  const withArtifact = (path: string, ext: string, qs: string = '') =>\n    `${path}/${artifactBase}.${ext}${qs}`;\n\n  const withProvider = (path: string, provider?: string) => {\n    const seg = providerSegment(provider) + defaultImageSegment();\n    if (!seg) return path;\n    return path.replace(docBase, `${docBase}${seg}`);\n  };\n\n  const formatParams = (opts?: UrlBuilderOptions) => {\n    const params = new URLSearchParams();\n    if (opts?.format) params.set('format', opts.format);\n    if (opts?.include?.length) params.set('include', opts.include.join(','));\n    const qs = params.toString();\n    return qs ? `?${qs}` : '';\n  };\n\n  const makeEntityCollection = (type: string): EntityCollectionProxy => {\n    return new Proxy({} as EntityCollectionProxy, {\n      get(_target, prop) {\n        if (prop === 'url') {\n          return (opts?: UrlBuilderOptions) =>\n            withProvider(\n              withArtifact(\n                `${docBase}/entities/${type}`,\n                extensionFor(opts?.format, 'json'),\n                formatParams(opts),\n              ),\n              opts?.provider,\n            );\n        }\n        const index = typeof prop === 'string' ? parseInt(prop, 10) : NaN;\n        if (!isNaN(index)) {\n          return {\n            url: (opts?: { format?: string; provider?: string }) => {\n              const params = opts?.format ? `?format=${opts.format}` : '';\n              return withProvider(\n                withArtifact(\n                  `${docBase}/entities/${type}/${index}`,\n                  extensionFor(opts?.format, 'json'),\n                  params,\n                ),\n                opts?.provider,\n              );\n            },\n          };\n        }\n        return undefined;\n      },\n    });\n  };\n\n  // Build a flat pg URL: .../pg_1.png (no artifact suffix)\n  const pgUrl = (segment: string, ext: string, placeholderOverride?: string) => {\n    const imgSeg = defaultImageSegment(placeholderOverride);\n    const provSeg = providerSegment();\n    const seg = provSeg + imgSeg;\n    const flatPath = `${docBase}/pg_${segment}.${ext}`;\n    if (!seg) return flatPath;\n    return flatPath.replace(docBase, `${docBase}${seg}`);\n  };\n\n  const makePgPage = (pageNum: number): PgPage => ({\n    png: (opts?: { placeholder?: string }) => pgUrl(String(pageNum), 'png', opts?.placeholder),\n    md: () => pgUrl(String(pageNum), 'md'),\n    json: () => pgUrl(String(pageNum), 'json'),\n  });\n\n  const makePgRange = (segment: string): PgPageRange => ({\n    md: () => pgUrl(segment, 'md'),\n    json: () => pgUrl(segment, 'json'),\n  });\n\n  const pg: PgProxy = new Proxy({} as PgProxy, {\n    get(_target, prop) {\n      if (prop === 'range') {\n        return (start: number, end: number) => makePgRange(`${start}-${end}`);\n      }\n      if (prop === 'list') {\n        return (...pages: number[]) => makePgRange(pages.join(','));\n      }\n      const pageNum = typeof prop === 'string' ? parseInt(prop, 10) : NaN;\n      if (!isNaN(pageNum)) {\n        return makePgPage(pageNum);\n      }\n      return undefined;\n    },\n  });\n\n  return {\n    url: (opts?: UrlBuilderOptions) =>\n      withProvider(\n        withArtifact(docBase, extensionFor(opts?.format, 'json'), formatParams(opts)),\n        opts?.provider,\n      ),\n    thumbnail: {\n      url: () => pgUrl('1', 'png'),\n    },\n    full: {\n      md: () => `${docBase}/full.md`,\n    },\n    download: () => `${base}/document/${encodeURIComponent(documentId)}/download`,\n    pg,\n    entities: {\n      tables: makeEntityCollection('tables'),\n      figures: makeEntityCollection('figures'),\n    },\n  };\n}\n"],"mappings":"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","names":[]}