orakle 0.0.2 → 0.1.1

package/README.md

@@ -1,3 +1,149 @@
 # orakle
 
-Under development client SDK for [orakle.xyz](https://orakle.xyz).
+TypeScript SDK for [orakle.xyz](https://orakle.xyz) — AI-powered pricing intelligence.
+
+Submits pricing jobs and streams results over SSE. No polling required. Works in Node.js 18+ and modern browsers.
+
+## Install
+
+```sh
+npm install orakle
+```
+
+## Quick Start
+
+```ts
+import { OrakleClient } from "orakle";
+
+const client = new OrakleClient({ apiKey: "orakle_..." });
+
+// Natural language query
+const result = await client.priceCheck({
+  request_type: "nl",
+  query: "iPhone 15 Pro 256GB unlocked mint condition",
+});
+
+console.log(result.fused_distribution.quantiles);
+// { "0.1": 780, "0.25": 820, "0.5": 870, "0.75": 920, "0.9": 960 }
+```
+
+## Structured Query
+
+```ts
+const result = await client.priceCheck({
+  request_type: "structured",
+  product: {
+    category: "smartphone",
+    make: "Apple",
+    model: "iPhone 15 Pro",
+    storage: "256GB",
+    condition: "mint",
+    carrier_lock: "unlocked",
+  },
+  geography: "US",
+});
+```
+
+## Streaming Progress
+
+Track pipeline stages as they happen:
+
+```ts
+// Callback-based
+const result = await client.priceCheck(
+  { request_type: "nl", query: "MacBook Air M3 16GB" },
+  {
+    onProgress: (event) => {
+      console.log(`[${event.stage}] ${event.message}`);
+      // [analyzing] Parsing product attributes...
+      // [price_lookup] Fetching market data...
+      // [planning] Generating scenario forecasts...
+      // [dispatching] Running pricing agents...
+      // [fusing] Combining modality outputs...
+    },
+  },
+);
+
+// Iterator-based — full control over each event
+for await (const event of client.priceCheckStream({
+  request_type: "nl",
+  query: "PS5 Disc Edition",
+})) {
+  if (event.event_type === "stage") {
+    console.log(event.stage, event.message);
+  }
+  if (event.event_type === "completed") {
+    console.log("Result:", event.result);
+  }
+  if (event.event_type === "failed") {
+    console.error("Failed:", event.error);
+  }
+}
+```
+
+## Configuration
+
+```ts
+const client = new OrakleClient({
+  apiKey: "orakle_...",       // Required
+  timeout: 300_000,           // Default: 180_000 (3 min), minimum: 180_000
+});
+```
+
+Per-request options:
+
+```ts
+const controller = new AbortController();
+
+const result = await client.priceCheck(
+  { request_type: "nl", query: "..." },
+  {
+    timeout: 30_000,             // Override client timeout
+    signal: controller.signal,   // AbortController support
+    onProgress: (e) => {},       // Stage progress callback
+  },
+);
+```
+
+## Error Handling
+
+```ts
+import {
+  OrakleApiError,
+  OrakleTimeoutError,
+  OrakleConnectionError,
+} from "orakle";
+
+try {
+  await client.priceCheck({ request_type: "nl", query: "..." });
+} catch (err) {
+  if (err instanceof OrakleApiError) {
+    console.error(err.code, err.status, err.message);
+    // "rate_limited", 429, "Rate limit exceeded"
+  }
+  if (err instanceof OrakleTimeoutError) {
+    console.error(`Timed out after ${err.timeoutMs}ms`);
+  }
+  if (err instanceof OrakleConnectionError) {
+    console.error("Network error:", err.message);
+  }
+}
+```
+
+Error codes: `invalid_request`, `auth_required`, `rate_limited`, `job_not_found`, `insufficient_data`, `internal_error`, `service_unavailable`.
+
+## Result Shape
+
+```ts
+interface PriceCheckResult {
+  product_profile: ProductProfile;
+  fused_distribution: PriceDistribution;
+  scenario_forecast?: ScenarioForecast | null;
+}
+```
+
+`fused_distribution.quantiles` contains percentile price points (p10, p25, p50, p75, p90). `scenario_forecast` includes probability-weighted price scenarios when available.
+
+## License
+
+Apache-2.0

package/dist/index.cjs

@@ -24,7 +24,9 @@ __export(index_exports, {
   OrakleClient: () => OrakleClient,
   OrakleConnectionError: () => OrakleConnectionError,
   OrakleError: () => OrakleError,
-  OrakleTimeoutError: () => OrakleTimeoutError
+  OrakleTimeoutError: () => OrakleTimeoutError,
+  SSEHttpError: () => SSEHttpError,
+  createSSEStream: () => createSSEStream
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -108,7 +110,9 @@ var parseSSEBody = async function* (body, signal) {
   let currentData = [];
   const readOrAbort = () => {
     if (signal?.aborted) {
-      return Promise.reject(signal.reason ?? new DOMException("Aborted", "AbortError"));
+      return Promise.reject(
+        signal.reason ?? new DOMException("Aborted", "AbortError")
+      );
     }
     return new Promise((resolve, reject) => {
       const onAbort = () => {
@@ -236,14 +240,18 @@ var SSEHttpError = class extends Error {
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.orakle.xyz";
 var DEFAULT_TIMEOUT_MS = 18e4;
+var MIN_TIMEOUT_MS = 18e4;
 var OrakleClient = class {
   apiKey;
-  baseUrl;
   timeout;
+  baseUrl;
   constructor(config) {
     this.apiKey = config.apiKey;
+    this.timeout = Math.max(
+      config.timeout ?? DEFAULT_TIMEOUT_MS,
+      MIN_TIMEOUT_MS
+    );
     this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
-    this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
   }
   /**
    * Submit a pricing job and wait for the result.
@@ -251,7 +259,10 @@ var OrakleClient = class {
    * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.
    */
   async priceCheck(params, options) {
-    const timeoutMs = options?.timeout ?? this.timeout;
+    const timeoutMs = Math.max(
+      options?.timeout ?? this.timeout,
+      MIN_TIMEOUT_MS
+    );
     const controller = new AbortController();
     const externalSignal = options?.signal;
     const onExternalAbort = () => controller.abort();
@@ -274,13 +285,18 @@ var OrakleClient = class {
           case "stage":
             options?.onProgress?.(event);
             break;
+          case "partial":
+            options?.onPartial?.(event);
+            break;
           case "completed":
             return event.result;
           case "failed":
             throw new OrakleError(event.error);
         }
       }
-      throw new OrakleError("SSE stream ended without a completed or failed event");
+      throw new OrakleError(
+        "SSE stream ended without a completed or failed event"
+      );
     } catch (err) {
       throw this.normalizeError(err);
     } finally {
@@ -294,7 +310,10 @@ var OrakleClient = class {
    * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.
    */
   async *priceCheckStream(params, options) {
-    const timeoutMs = options?.timeout ?? this.timeout;
+    const timeoutMs = Math.max(
+      options?.timeout ?? this.timeout,
+      MIN_TIMEOUT_MS
+    );
     const controller = new AbortController();
     const externalSignal = options?.signal;
     const onExternalAbort = () => controller.abort();
@@ -315,6 +334,8 @@ var OrakleClient = class {
         if (!event) continue;
         if (event.event_type === "stage") {
           options?.onProgress?.(event);
+        } else if (event.event_type === "partial") {
+          options?.onPartial?.(event);
         }
         yield event;
         if (event.event_type === "completed" || event.event_type === "failed") {
@@ -347,10 +368,7 @@ var OrakleClient = class {
       if (err instanceof DOMException && err.name === "AbortError") {
         throw err;
       }
-      throw new OrakleConnectionError(
-        "Failed to connect to Orakle API",
-        err
-      );
+      throw new OrakleConnectionError("Failed to connect to Orakle API", err);
     }
     if (!response.ok) {
       throw await this.buildApiError(response);
@@ -369,6 +387,8 @@ var OrakleClient = class {
       switch (eventType) {
         case "stage":
           return { ...parsed, event_type: "stage" };
+        case "partial":
+          return { ...parsed, event_type: "partial" };
         case "completed":
           return { ...parsed, event_type: "completed" };
         case "failed":
@@ -435,6 +455,8 @@ var OrakleClient = class {
   OrakleClient,
   OrakleConnectionError,
   OrakleError,
-  OrakleTimeoutError
+  OrakleTimeoutError,
+  SSEHttpError,
+  createSSEStream
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["// Client\nexport { OrakleClient } from \"./client.js\";\n\n// Errors\nexport {\n  OrakleError,\n  OrakleApiError,\n  OrakleTimeoutError,\n  OrakleConnectionError,\n} from \"./errors.js\";\n\n// Types\nexport type {\n  OrakleConfig,\n  JobStatus,\n  PipelineStage,\n  ErrorCode,\n  Geography,\n  ProductProfile,\n  DistributionComponent,\n  PriceDistribution,\n  ScenarioSource,\n  Scenario,\n  ScenarioForecast,\n  NLJobRequest,\n  StructuredJobRequest,\n  JobRequest,\n  PriceCheckResult,\n  JobSubmitResponse,\n  StageEvent,\n  CompletedEvent,\n  FailedEvent,\n  JobEvent,\n  PriceCheckOptions,\n  ApiErrorBody,\n} from \"./types.js\";\n","import type { ErrorCode } from \"./types.js\";\n\n/**\n * Base error for all Orakle SDK errors.\n */\nexport class OrakleError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"OrakleError\";\n  }\n}\n\n/**\n * HTTP API error with status code and typed error code.\n */\nexport class OrakleApiError extends OrakleError {\n  readonly status: number;\n  readonly code: ErrorCode;\n\n  constructor(message: string, status: number, code: ErrorCode) {\n    super(message);\n    this.name = \"OrakleApiError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\n/**\n * Timeout error — request or SSE stream exceeded the configured timeout.\n */\nexport class OrakleTimeoutError extends OrakleError {\n  readonly timeoutMs: number;\n\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${timeoutMs}ms`);\n    this.name = \"OrakleTimeoutError\";\n    this.timeoutMs = timeoutMs;\n  }\n}\n\n/**\n * Connection error — network failure, DNS resolution failure, etc.\n */\nexport class OrakleConnectionError extends OrakleError {\n  readonly cause?: unknown;\n\n  constructor(message: string, cause?: unknown) {\n    super(message);\n    this.name = \"OrakleConnectionError\";\n    this.cause = cause;\n  }\n}\n","/**\n * SSE parser using fetch + ReadableStream.\n *\n * Cannot use browser EventSource — it doesn't support custom headers\n * (needed for X-Orakle-API-Key). This is the same approach used by\n * the OpenAI SDK. Works in browsers and Node.js 18+ (native fetch).\n */\n\nimport { OrakleConnectionError } from \"./errors.js\";\nimport type { SSEFrame } from \"./types.js\";\n\ninterface SSEOptions {\n  url: string;\n  headers: Record<string, string>;\n  signal?: AbortSignal;\n  lastEventId?: string;\n  onRetry?: (retryMs: number) => void;\n}\n\n/**\n * Parse a `text/event-stream` response into SSE frames.\n *\n * Yields `{ event, id, data }` for each complete SSE event block.\n * Handles multi-line `data:` fields (joined with newlines).\n * Supports reconnection via `Last-Event-Id` header.\n */\nexport const createSSEStream = async function* (\n  options: SSEOptions,\n): AsyncGenerator<SSEFrame> {\n  const { url, headers, signal, lastEventId } = options;\n\n  const requestHeaders: Record<string, string> = {\n    ...headers,\n    Accept: \"text/event-stream\",\n    \"Cache-Control\": \"no-cache\",\n  };\n\n  if (lastEventId) {\n    requestHeaders[\"Last-Event-Id\"] = lastEventId;\n  }\n\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"GET\",\n      headers: requestHeaders,\n      signal,\n    });\n  } catch (err: unknown) {\n    if (err instanceof DOMException && err.name === \"AbortError\") {\n      throw err;\n    }\n    throw new OrakleConnectionError(\n      `Failed to connect to SSE stream: ${url}`,\n      err,\n    );\n  }\n\n  if (!response.ok) {\n    // Let the caller handle HTTP error responses\n    const body = await response.text();\n    throw new SSEHttpError(response.status, body);\n  }\n\n  const body = response.body;\n  if (!body) {\n    throw new OrakleConnectionError(\"Response body is null\");\n  }\n\n  yield* parseSSEBody(body, signal);\n};\n\n/**\n * Internal: parse a ReadableStream<Uint8Array> as SSE.\n */\nconst parseSSEBody = async function* (\n  body: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n): AsyncGenerator<SSEFrame> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n\n  let buffer = \"\";\n  let currentEvent = \"\";\n  let currentId = \"\";\n  let currentData: string[] = [];\n\n  type ReadResult = Awaited<ReturnType<typeof reader.read>>;\n\n  /** Race reader.read() against the abort signal. */\n  const readOrAbort = (): Promise<ReadResult> => {\n    if (signal?.aborted) {\n      return Promise.reject(signal.reason ?? new DOMException(\"Aborted\", \"AbortError\"));\n    }\n    return new Promise<ReadResult>((resolve, reject) => {\n      const onAbort = () => {\n        reject(signal?.reason ?? new DOMException(\"Aborted\", \"AbortError\"));\n      };\n      signal?.addEventListener(\"abort\", onAbort, { once: true });\n      reader.read().then(\n        (result) => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          resolve(result);\n        },\n        (err: unknown) => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          reject(err);\n        },\n      );\n    });\n  };\n\n  try {\n    while (true) {\n      if (signal?.aborted) {\n        break;\n      }\n\n      const { done, value } = await readOrAbort();\n      if (done) break;\n\n      buffer += decoder.decode(value, { stream: true });\n\n      const lines = buffer.split(\"\\n\");\n      // Keep the last partial line in the buffer\n      buffer = lines.pop() ?? \"\";\n\n      for (const line of lines) {\n        if (line === \"\") {\n          // Empty line = end of event block\n          if (currentData.length > 0) {\n            yield {\n              event: currentEvent ?? \"message\",\n              id: currentId,\n              data: currentData.join(\"\\n\"),\n            };\n          }\n          // Reset for next event\n          currentEvent = \"\";\n          currentId = \"\";\n          currentData = [];\n          continue;\n        }\n\n        // SSE comment — ignore (keepalive)\n        if (line.startsWith(\":\")) {\n          continue;\n        }\n\n        const colonIdx = line.indexOf(\":\");\n        if (colonIdx === -1) {\n          // Field with no value\n          continue;\n        }\n\n        const field = line.slice(0, colonIdx);\n        // Value starts after \": \" (space after colon is optional per spec)\n        let value_ = line.slice(colonIdx + 1);\n        if (value_.startsWith(\" \")) {\n          value_ = value_.slice(1);\n        }\n\n        switch (field) {\n          case \"event\":\n            currentEvent = value_;\n            break;\n          case \"id\":\n            currentId = value_;\n            break;\n          case \"data\":\n            currentData.push(value_);\n            break;\n          case \"retry\":\n            // Optional retry field — notify caller\n            break;\n        }\n      }\n    }\n\n    // Flush any remaining event in buffer\n    if (buffer !== \"\") {\n      const lines = buffer.split(\"\\n\");\n      for (const line of lines) {\n        if (line === \"\" && currentData.length > 0) {\n          yield {\n            event: currentEvent ?? \"message\",\n            id: currentId,\n            data: currentData.join(\"\\n\"),\n          };\n          currentEvent = \"\";\n          currentId = \"\";\n          currentData = [];\n          continue;\n        }\n        if (line.startsWith(\":\") || line === \"\") continue;\n        const colonIdx = line.indexOf(\":\");\n        if (colonIdx === -1) continue;\n        const field = line.slice(0, colonIdx);\n        let value_ = line.slice(colonIdx + 1);\n        if (value_.startsWith(\" \")) value_ = value_.slice(1);\n        switch (field) {\n          case \"event\":\n            currentEvent = value_;\n            break;\n          case \"id\":\n            currentId = value_;\n            break;\n          case \"data\":\n            currentData.push(value_);\n            break;\n        }\n      }\n      if (currentData.length > 0) {\n        yield {\n          event: currentEvent ?? \"message\",\n          id: currentId,\n          data: currentData.join(\"\\n\"),\n        };\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n};\n\n/**\n * Internal error used to communicate HTTP status from the SSE fetch.\n * The client layer catches this and maps it to OrakleApiError.\n */\nexport class SSEHttpError extends Error {\n  readonly status: number;\n  readonly body: string;\n\n  constructor(status: number, body: string) {\n    super(`SSE request failed with status ${status}`);\n    this.name = \"SSEHttpError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n","/**\n * OrakleClient — main entry point for the Orakle TypeScript SDK.\n *\n * Usage:\n *   const client = new OrakleClient({ apiKey: \"...\" });\n *   const result = await client.priceCheck({ query: \"iPhone 15 Pro 256GB\" });\n */\n\nimport {\n  OrakleApiError,\n  OrakleConnectionError,\n  OrakleError,\n  OrakleTimeoutError,\n} from \"./errors.js\";\nimport { SSEHttpError, createSSEStream } from \"./sse.js\";\nimport type {\n  ApiErrorBody,\n  CompletedEvent,\n  ErrorCode,\n  FailedEvent,\n  JobEvent,\n  JobRequest,\n  JobSubmitResponse,\n  OrakleConfig,\n  PriceCheckOptions,\n  PriceCheckResult,\n  StageEvent,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.orakle.xyz\";\nconst DEFAULT_TIMEOUT_MS = 180_000;\n\nexport class OrakleClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(config: OrakleConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;\n  }\n\n  /**\n   * Submit a pricing job and wait for the result.\n   *\n   * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.\n   */\n  async priceCheck(\n    params: JobRequest,\n    options?: PriceCheckOptions,\n  ): Promise<PriceCheckResult> {\n    const timeoutMs = options?.timeout ?? this.timeout;\n    const controller = new AbortController();\n\n    // Link external signal to our internal controller\n    const externalSignal = options?.signal;\n    const onExternalAbort = () => controller.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n\n    const timer = setTimeout(() => {\n      controller.abort(new OrakleTimeoutError(timeoutMs));\n    }, timeoutMs);\n\n    try {\n      const job = await this.submitJob(params, controller.signal);\n      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;\n\n      const stream = createSSEStream({\n        url: streamUrl,\n        headers: this.defaultHeaders(),\n        signal: controller.signal,\n      });\n\n      for await (const frame of stream) {\n        const event = this.parseJobEvent(frame.event, frame.data);\n        if (!event) continue;\n\n        switch (event.event_type) {\n          case \"stage\":\n            options?.onProgress?.(event);\n            break;\n          case \"completed\":\n            return event.result;\n          case \"failed\":\n            throw new OrakleError(event.error);\n        }\n      }\n\n      // Stream ended without a terminal event\n      throw new OrakleError(\"SSE stream ended without a completed or failed event\");\n    } catch (err: unknown) {\n      throw this.normalizeError(err);\n    } finally {\n      clearTimeout(timer);\n      externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n  }\n\n  /**\n   * Submit a pricing job and return an async iterable of all events.\n   *\n   * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.\n   */\n  async *priceCheckStream(\n    params: JobRequest,\n    options?: PriceCheckOptions,\n  ): AsyncGenerator<JobEvent> {\n    const timeoutMs = options?.timeout ?? this.timeout;\n    const controller = new AbortController();\n\n    const externalSignal = options?.signal;\n    const onExternalAbort = () => controller.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n\n    const timer = setTimeout(() => {\n      controller.abort(new OrakleTimeoutError(timeoutMs));\n    }, timeoutMs);\n\n    try {\n      const job = await this.submitJob(params, controller.signal);\n      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;\n\n      const stream = createSSEStream({\n        url: streamUrl,\n        headers: this.defaultHeaders(),\n        signal: controller.signal,\n      });\n\n      for await (const frame of stream) {\n        const event = this.parseJobEvent(frame.event, frame.data);\n        if (!event) continue;\n\n        if (event.event_type === \"stage\") {\n          options?.onProgress?.(event);\n        }\n\n        yield event;\n\n        // Terminal events end the stream\n        if (event.event_type === \"completed\" || event.event_type === \"failed\") {\n          return;\n        }\n      }\n    } catch (err: unknown) {\n      throw this.normalizeError(err);\n    } finally {\n      clearTimeout(timer);\n      externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private helpers\n  // ---------------------------------------------------------------------------\n\n  private async submitJob(\n    params: JobRequest,\n    signal: AbortSignal,\n  ): Promise<JobSubmitResponse> {\n    let response: Response;\n    try {\n      response = await fetch(`${this.baseUrl}/v1/jobs`, {\n        method: \"POST\",\n        headers: {\n          ...this.defaultHeaders(),\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(params),\n        signal,\n      });\n    } catch (err: unknown) {\n      if (err instanceof DOMException && err.name === \"AbortError\") {\n        throw err;\n      }\n      throw new OrakleConnectionError(\n        \"Failed to connect to Orakle API\",\n        err,\n      );\n    }\n\n    if (!response.ok) {\n      throw await this.buildApiError(response);\n    }\n\n    return (await response.json()) as JobSubmitResponse;\n  }\n\n  private defaultHeaders(): Record<string, string> {\n    return {\n      \"X-Orakle-API-Key\": this.apiKey,\n    };\n  }\n\n  private parseJobEvent(eventType: string, data: string): JobEvent | undefined {\n    try {\n      const parsed: unknown = JSON.parse(data);\n      if (typeof parsed !== \"object\" || parsed === null) return undefined;\n\n      switch (eventType) {\n        case \"stage\":\n          return { ...parsed, event_type: \"stage\" } as StageEvent;\n        case \"completed\":\n          return { ...parsed, event_type: \"completed\" } as CompletedEvent;\n        case \"failed\":\n          return { ...parsed, event_type: \"failed\" } as FailedEvent;\n        default:\n          return undefined;\n      }\n    } catch {\n      return undefined;\n    }\n  }\n\n  private async buildApiError(response: Response): Promise<OrakleApiError> {\n    let body: ApiErrorBody | undefined;\n    try {\n      body = (await response.json()) as ApiErrorBody;\n    } catch {\n      // Response body is not JSON\n    }\n\n    const code: ErrorCode = body?.code ?? this.httpStatusToErrorCode(response.status);\n    const message = body?.message ?? `API request failed with status ${response.status}`;\n\n    return new OrakleApiError(message, response.status, code);\n  }\n\n  private httpStatusToErrorCode(status: number): ErrorCode {\n    switch (status) {\n      case 400:\n        return \"invalid_request\";\n      case 401:\n        return \"auth_required\";\n      case 429:\n        return \"rate_limited\";\n      case 404:\n        return \"job_not_found\";\n      case 503:\n        return \"service_unavailable\";\n      default:\n        return \"internal_error\";\n    }\n  }\n\n  private normalizeError(err: unknown): Error {\n    if (err instanceof OrakleError) {\n      return err;\n    }\n\n    if (err instanceof SSEHttpError) {\n      let body: ApiErrorBody | undefined;\n      try {\n        body = JSON.parse(err.body) as ApiErrorBody;\n      } catch {\n        // Not JSON\n      }\n      const code = body?.code ?? this.httpStatusToErrorCode(err.status);\n      const message = body?.message ?? `API request failed with status ${err.status}`;\n      return new OrakleApiError(message, err.status, code);\n    }\n\n    // AbortError from timeout\n    if (err instanceof DOMException && err.name === \"AbortError\") {\n      // Check if our timeout caused the abort\n      return new OrakleTimeoutError(this.timeout);\n    }\n\n    if (err instanceof Error) {\n      return new OrakleConnectionError(err.message, err);\n    }\n\n    return new OrakleConnectionError(String(err));\n  }\n}\n"],"mappings":"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","names":["body"]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["// Client\nexport { OrakleClient } from \"./client.js\";\n// Errors\nexport {\n  OrakleApiError,\n  OrakleConnectionError,\n  OrakleError,\n  OrakleTimeoutError,\n} from \"./errors.js\";\n// SSE primitives — exposed so server-side proxies (e.g. a Next.js route\n// handler that re-emits a sanitized event stream to the browser) can\n// consume the same parser the client uses, without re-implementing it.\nexport { createSSEStream, SSEHttpError } from \"./sse.js\";\n\n// Types\nexport type {\n  ApiErrorBody,\n  AttributeCorrection,\n  CompletedEvent,\n  DistributionComponent,\n  ErrorCode,\n  FailedEvent,\n  ForecastPoint,\n  Geography,\n  JobEvent,\n  JobRequest,\n  JobStatus,\n  JobSubmitResponse,\n  NLJobRequest,\n  OrakleConfig,\n  PartialEvent,\n  PipelineStage,\n  PriceCheckOptions,\n  PriceCheckResult,\n  PriceDistribution,\n  ProductProfile,\n  Scenario,\n  ScenarioForecast,\n  ScenarioSource,\n  SSEFrame,\n  StageEvent,\n  StructuredJobRequest,\n  ValueDriver,\n} from \"./types.js\";\n","import type { ErrorCode } from \"./types.js\";\n\n/**\n * Base error for all Orakle SDK errors.\n */\nexport class OrakleError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"OrakleError\";\n  }\n}\n\n/**\n * HTTP API error with status code and typed error code.\n */\nexport class OrakleApiError extends OrakleError {\n  readonly status: number;\n  readonly code: ErrorCode;\n\n  constructor(message: string, status: number, code: ErrorCode) {\n    super(message);\n    this.name = \"OrakleApiError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\n/**\n * Timeout error — request or SSE stream exceeded the configured timeout.\n */\nexport class OrakleTimeoutError extends OrakleError {\n  readonly timeoutMs: number;\n\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${timeoutMs}ms`);\n    this.name = \"OrakleTimeoutError\";\n    this.timeoutMs = timeoutMs;\n  }\n}\n\n/**\n * Connection error — network failure, DNS resolution failure, etc.\n */\nexport class OrakleConnectionError extends OrakleError {\n  readonly cause?: unknown;\n\n  constructor(message: string, cause?: unknown) {\n    super(message);\n    this.name = \"OrakleConnectionError\";\n    this.cause = cause;\n  }\n}\n","/**\n * SSE parser using fetch + ReadableStream.\n *\n * Cannot use browser EventSource — it doesn't support custom headers\n * (needed for X-Orakle-API-Key). This is the same approach used by\n * the OpenAI SDK. Works in browsers and Node.js 18+ (native fetch).\n */\n\nimport { OrakleConnectionError } from \"./errors.js\";\nimport type { SSEFrame } from \"./types.js\";\n\ninterface SSEOptions {\n  url: string;\n  headers: Record<string, string>;\n  signal?: AbortSignal;\n  lastEventId?: string;\n  onRetry?: (retryMs: number) => void;\n}\n\n/**\n * Parse a `text/event-stream` response into SSE frames.\n *\n * Yields `{ event, id, data }` for each complete SSE event block.\n * Handles multi-line `data:` fields (joined with newlines).\n * Supports reconnection via `Last-Event-Id` header.\n */\nexport const createSSEStream = async function* (\n  options: SSEOptions,\n): AsyncGenerator<SSEFrame> {\n  const { url, headers, signal, lastEventId } = options;\n\n  const requestHeaders: Record<string, string> = {\n    ...headers,\n    Accept: \"text/event-stream\",\n    \"Cache-Control\": \"no-cache\",\n  };\n\n  if (lastEventId) {\n    requestHeaders[\"Last-Event-Id\"] = lastEventId;\n  }\n\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"GET\",\n      headers: requestHeaders,\n      signal,\n    });\n  } catch (err: unknown) {\n    if (err instanceof DOMException && err.name === \"AbortError\") {\n      throw err;\n    }\n    throw new OrakleConnectionError(\n      `Failed to connect to SSE stream: ${url}`,\n      err,\n    );\n  }\n\n  if (!response.ok) {\n    // Let the caller handle HTTP error responses\n    const body = await response.text();\n    throw new SSEHttpError(response.status, body);\n  }\n\n  const body = response.body;\n  if (!body) {\n    throw new OrakleConnectionError(\"Response body is null\");\n  }\n\n  yield* parseSSEBody(body, signal);\n};\n\n/**\n * Internal: parse a ReadableStream<Uint8Array> as SSE.\n */\nconst parseSSEBody = async function* (\n  body: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n): AsyncGenerator<SSEFrame> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n\n  let buffer = \"\";\n  let currentEvent = \"\";\n  let currentId = \"\";\n  let currentData: string[] = [];\n\n  type ReadResult = Awaited<ReturnType<typeof reader.read>>;\n\n  /** Race reader.read() against the abort signal. */\n  const readOrAbort = (): Promise<ReadResult> => {\n    if (signal?.aborted) {\n      return Promise.reject(\n        signal.reason ?? new DOMException(\"Aborted\", \"AbortError\"),\n      );\n    }\n    return new Promise<ReadResult>((resolve, reject) => {\n      const onAbort = () => {\n        reject(signal?.reason ?? new DOMException(\"Aborted\", \"AbortError\"));\n      };\n      signal?.addEventListener(\"abort\", onAbort, { once: true });\n      reader.read().then(\n        (result) => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          resolve(result);\n        },\n        (err: unknown) => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          reject(err);\n        },\n      );\n    });\n  };\n\n  try {\n    while (true) {\n      if (signal?.aborted) {\n        break;\n      }\n\n      const { done, value } = await readOrAbort();\n      if (done) break;\n\n      buffer += decoder.decode(value, { stream: true });\n\n      const lines = buffer.split(\"\\n\");\n      // Keep the last partial line in the buffer\n      buffer = lines.pop() ?? \"\";\n\n      for (const line of lines) {\n        if (line === \"\") {\n          // Empty line = end of event block\n          if (currentData.length > 0) {\n            yield {\n              event: currentEvent ?? \"message\",\n              id: currentId,\n              data: currentData.join(\"\\n\"),\n            };\n          }\n          // Reset for next event\n          currentEvent = \"\";\n          currentId = \"\";\n          currentData = [];\n          continue;\n        }\n\n        // SSE comment — ignore (keepalive)\n        if (line.startsWith(\":\")) {\n          continue;\n        }\n\n        const colonIdx = line.indexOf(\":\");\n        if (colonIdx === -1) {\n          // Field with no value\n          continue;\n        }\n\n        const field = line.slice(0, colonIdx);\n        // Value starts after \": \" (space after colon is optional per spec)\n        let value_ = line.slice(colonIdx + 1);\n        if (value_.startsWith(\" \")) {\n          value_ = value_.slice(1);\n        }\n\n        switch (field) {\n          case \"event\":\n            currentEvent = value_;\n            break;\n          case \"id\":\n            currentId = value_;\n            break;\n          case \"data\":\n            currentData.push(value_);\n            break;\n          case \"retry\":\n            // Optional retry field — notify caller\n            break;\n        }\n      }\n    }\n\n    // Flush any remaining event in buffer\n    if (buffer !== \"\") {\n      const lines = buffer.split(\"\\n\");\n      for (const line of lines) {\n        if (line === \"\" && currentData.length > 0) {\n          yield {\n            event: currentEvent ?? \"message\",\n            id: currentId,\n            data: currentData.join(\"\\n\"),\n          };\n          currentEvent = \"\";\n          currentId = \"\";\n          currentData = [];\n          continue;\n        }\n        if (line.startsWith(\":\") || line === \"\") continue;\n        const colonIdx = line.indexOf(\":\");\n        if (colonIdx === -1) continue;\n        const field = line.slice(0, colonIdx);\n        let value_ = line.slice(colonIdx + 1);\n        if (value_.startsWith(\" \")) value_ = value_.slice(1);\n        switch (field) {\n          case \"event\":\n            currentEvent = value_;\n            break;\n          case \"id\":\n            currentId = value_;\n            break;\n          case \"data\":\n            currentData.push(value_);\n            break;\n        }\n      }\n      if (currentData.length > 0) {\n        yield {\n          event: currentEvent ?? \"message\",\n          id: currentId,\n          data: currentData.join(\"\\n\"),\n        };\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n};\n\n/**\n * Internal error used to communicate HTTP status from the SSE fetch.\n * The client layer catches this and maps it to OrakleApiError.\n */\nexport class SSEHttpError extends Error {\n  readonly status: number;\n  readonly body: string;\n\n  constructor(status: number, body: string) {\n    super(`SSE request failed with status ${status}`);\n    this.name = \"SSEHttpError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n","/**\n * OrakleClient — main entry point for the Orakle TypeScript SDK.\n *\n * Usage:\n *   const client = new OrakleClient({ apiKey: \"...\" });\n *   const result = await client.priceCheck({ query: \"iPhone 15 Pro 256GB\" });\n */\n\nimport {\n  OrakleApiError,\n  OrakleConnectionError,\n  OrakleError,\n  OrakleTimeoutError,\n} from \"./errors.js\";\nimport { createSSEStream, SSEHttpError } from \"./sse.js\";\nimport type {\n  ApiErrorBody,\n  CompletedEvent,\n  ErrorCode,\n  FailedEvent,\n  JobEvent,\n  JobRequest,\n  JobSubmitResponse,\n  OrakleConfig,\n  PartialEvent,\n  PriceCheckOptions,\n  PriceCheckResult,\n  StageEvent,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.orakle.xyz\";\nconst DEFAULT_TIMEOUT_MS = 180_000;\nconst MIN_TIMEOUT_MS = 180_000;\n\nexport class OrakleClient {\n  private readonly apiKey: string;\n  private readonly timeout: number;\n  private readonly baseUrl: string;\n\n  constructor(config: OrakleConfig) {\n    this.apiKey = config.apiKey;\n    this.timeout = Math.max(\n      config.timeout ?? DEFAULT_TIMEOUT_MS,\n      MIN_TIMEOUT_MS,\n    );\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n  }\n\n  /**\n   * Submit a pricing job and wait for the result.\n   *\n   * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.\n   */\n  async priceCheck(\n    params: JobRequest,\n    options?: PriceCheckOptions,\n  ): Promise<PriceCheckResult> {\n    const timeoutMs = Math.max(\n      options?.timeout ?? this.timeout,\n      MIN_TIMEOUT_MS,\n    );\n    const controller = new AbortController();\n\n    // Link external signal to our internal controller\n    const externalSignal = options?.signal;\n    const onExternalAbort = () => controller.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n\n    const timer = setTimeout(() => {\n      controller.abort(new OrakleTimeoutError(timeoutMs));\n    }, timeoutMs);\n\n    try {\n      const job = await this.submitJob(params, controller.signal);\n      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;\n\n      const stream = createSSEStream({\n        url: streamUrl,\n        headers: this.defaultHeaders(),\n        signal: controller.signal,\n      });\n\n      for await (const frame of stream) {\n        const event = this.parseJobEvent(frame.event, frame.data);\n        if (!event) continue;\n\n        switch (event.event_type) {\n          case \"stage\":\n            options?.onProgress?.(event);\n            break;\n          case \"partial\":\n            options?.onPartial?.(event);\n            break;\n          case \"completed\":\n            return event.result;\n          case \"failed\":\n            throw new OrakleError(event.error);\n        }\n      }\n\n      // Stream ended without a terminal event\n      throw new OrakleError(\n        \"SSE stream ended without a completed or failed event\",\n      );\n    } catch (err: unknown) {\n      throw this.normalizeError(err);\n    } finally {\n      clearTimeout(timer);\n      externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n  }\n\n  /**\n   * Submit a pricing job and return an async iterable of all events.\n   *\n   * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.\n   */\n  async *priceCheckStream(\n    params: JobRequest,\n    options?: PriceCheckOptions,\n  ): AsyncGenerator<JobEvent> {\n    const timeoutMs = Math.max(\n      options?.timeout ?? this.timeout,\n      MIN_TIMEOUT_MS,\n    );\n    const controller = new AbortController();\n\n    const externalSignal = options?.signal;\n    const onExternalAbort = () => controller.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n\n    const timer = setTimeout(() => {\n      controller.abort(new OrakleTimeoutError(timeoutMs));\n    }, timeoutMs);\n\n    try {\n      const job = await this.submitJob(params, controller.signal);\n      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;\n\n      const stream = createSSEStream({\n        url: streamUrl,\n        headers: this.defaultHeaders(),\n        signal: controller.signal,\n      });\n\n      for await (const frame of stream) {\n        const event = this.parseJobEvent(frame.event, frame.data);\n        if (!event) continue;\n\n        if (event.event_type === \"stage\") {\n          options?.onProgress?.(event);\n        } else if (event.event_type === \"partial\") {\n          options?.onPartial?.(event);\n        }\n\n        yield event;\n\n        // Terminal events end the stream\n        if (event.event_type === \"completed\" || event.event_type === \"failed\") {\n          return;\n        }\n      }\n    } catch (err: unknown) {\n      throw this.normalizeError(err);\n    } finally {\n      clearTimeout(timer);\n      externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private helpers\n  // ---------------------------------------------------------------------------\n\n  private async submitJob(\n    params: JobRequest,\n    signal: AbortSignal,\n  ): Promise<JobSubmitResponse> {\n    let response: Response;\n    try {\n      response = await fetch(`${this.baseUrl}/v1/jobs`, {\n        method: \"POST\",\n        headers: {\n          ...this.defaultHeaders(),\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(params),\n        signal,\n      });\n    } catch (err: unknown) {\n      if (err instanceof DOMException && err.name === \"AbortError\") {\n        throw err;\n      }\n      throw new OrakleConnectionError(\"Failed to connect to Orakle API\", err);\n    }\n\n    if (!response.ok) {\n      throw await this.buildApiError(response);\n    }\n\n    return (await response.json()) as JobSubmitResponse;\n  }\n\n  private defaultHeaders(): Record<string, string> {\n    return {\n      \"X-Orakle-API-Key\": this.apiKey,\n    };\n  }\n\n  private parseJobEvent(eventType: string, data: string): JobEvent | undefined {\n    try {\n      const parsed: unknown = JSON.parse(data);\n      if (typeof parsed !== \"object\" || parsed === null) return undefined;\n\n      switch (eventType) {\n        case \"stage\":\n          return { ...parsed, event_type: \"stage\" } as StageEvent;\n        case \"partial\":\n          return { ...parsed, event_type: \"partial\" } as PartialEvent;\n        case \"completed\":\n          return { ...parsed, event_type: \"completed\" } as CompletedEvent;\n        case \"failed\":\n          return { ...parsed, event_type: \"failed\" } as FailedEvent;\n        default:\n          return undefined;\n      }\n    } catch {\n      return undefined;\n    }\n  }\n\n  private async buildApiError(response: Response): Promise<OrakleApiError> {\n    let body: ApiErrorBody | undefined;\n    try {\n      body = (await response.json()) as ApiErrorBody;\n    } catch {\n      // Response body is not JSON\n    }\n\n    const code: ErrorCode =\n      body?.code ?? this.httpStatusToErrorCode(response.status);\n    const message =\n      body?.message ?? `API request failed with status ${response.status}`;\n\n    return new OrakleApiError(message, response.status, code);\n  }\n\n  private httpStatusToErrorCode(status: number): ErrorCode {\n    switch (status) {\n      case 400:\n        return \"invalid_request\";\n      case 401:\n        return \"auth_required\";\n      case 429:\n        return \"rate_limited\";\n      case 404:\n        return \"job_not_found\";\n      case 503:\n        return \"service_unavailable\";\n      default:\n        return \"internal_error\";\n    }\n  }\n\n  private normalizeError(err: unknown): Error {\n    if (err instanceof OrakleError) {\n      return err;\n    }\n\n    if (err instanceof SSEHttpError) {\n      let body: ApiErrorBody | undefined;\n      try {\n        body = JSON.parse(err.body) as ApiErrorBody;\n      } catch {\n        // Not JSON\n      }\n      const code = body?.code ?? this.httpStatusToErrorCode(err.status);\n      const message =\n        body?.message ?? `API request failed with status ${err.status}`;\n      return new OrakleApiError(message, err.status, code);\n    }\n\n    // AbortError from timeout\n    if (err instanceof DOMException && err.name === \"AbortError\") {\n      // Check if our timeout caused the abort\n      return new OrakleTimeoutError(this.timeout);\n    }\n\n    if (err instanceof Error) {\n      return new OrakleConnectionError(err.message, err);\n    }\n\n    return new OrakleConnectionError(String(err));\n  }\n}\n"],"mappings":"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","names":["body"]}

package/dist/index.d.cts

@@ -3,25 +3,36 @@
  */
 interface OrakleConfig {
     apiKey: string;
-    baseUrl?: string;
     timeout?: number;
+    /** Override the API base URL. Defaults to https://api.orakle.xyz. */
+    baseUrl?: string;
 }
 type JobStatus = "pending" | "processing" | "completed" | "failed";
 type PipelineStage = "analyzing" | "price_lookup" | "planning" | "dispatching" | "fusing";
 type ErrorCode = "invalid_request" | "auth_required" | "rate_limited" | "job_not_found" | "insufficient_data" | "internal_error" | "service_unavailable";
 type Geography = "US" | "GB" | "CA" | "AU" | "AE";
+interface AttributeCorrection {
+    key: string;
+    original: string;
+    corrected: string;
+    reason: string;
+}
+interface ValueDriver {
+    /** Snake_case attribute key matching an entry in `attributes`. */
+    key: string;
+    /** Attribute value as it appears in `attributes`. */
+    value: string;
+}
 interface ProductProfile {
     category: string;
     make: string;
     model: string;
-    storage?: string | null;
     condition?: string | null;
-    carrier?: string | null;
-    carrier_lock?: string | null;
-    color?: string | null;
+    attributes?: Record<string, string>;
+    corrections?: AttributeCorrection[];
     geography?: Geography;
     region?: string | null;
-    key_value_drivers?: string[];
+    value_drivers?: ValueDriver[];
     missing_attributes?: string[];
 }
 interface DistributionComponent {
@@ -52,6 +63,13 @@ interface ScenarioForecast {
     base_price: number;
     weighted_expected_price: number;
 }
+interface ForecastPoint {
+    date: string;
+    segment: "historical" | "forecast";
+    price: number;
+    p10?: number;
+    p90?: number;
+}
 interface NLJobRequest {
     request_type: "nl";
     query: string;
@@ -69,11 +87,14 @@ interface PriceCheckResult {
     product_profile: ProductProfile;
     fused_distribution: PriceDistribution;
     scenario_forecast?: ScenarioForecast | null;
+    forecast_series?: ForecastPoint[];
+    forecast_narrative?: string;
 }
 interface JobSubmitResponse {
     job_id: string;
     status: JobStatus;
     poll_url: string;
+    stream_url: string;
     estimated_seconds: number;
 }
 interface StageEvent {
@@ -83,6 +104,18 @@ interface StageEvent {
     message: string;
     timestamp: string;
 }
+interface PartialEvent {
+    event_type: "partial";
+    job_id: string;
+    /**
+     * Subset of PriceCheckResult that the orchestrator emits before the
+     * full job completes. Today this is `{ product_profile }` after the
+     * Analyzing stage; future stages may add `fused_distribution` etc.
+     */
+    result: Partial<PriceCheckResult>;
+    message?: string;
+    timestamp: string;
+}
 interface CompletedEvent {
     event_type: "completed";
     job_id: string;
@@ -97,11 +130,24 @@ interface FailedEvent {
     message?: string;
     timestamp: string;
 }
-type JobEvent = StageEvent | CompletedEvent | FailedEvent;
+type JobEvent = StageEvent | PartialEvent | CompletedEvent | FailedEvent;
+interface SSEFrame {
+    event: string;
+    id: string;
+    data: string;
+}
 interface PriceCheckOptions {
     signal?: AbortSignal;
     timeout?: number;
     onProgress?: (event: StageEvent) => void;
+    /**
+     * Fires once with the analyzed product profile (and any other early
+     * fields) the moment the Analyzing stage finishes — well before the
+     * full result is ready. Use this to populate UI placeholders so users
+     * see the parsed query immediately. The shape is a partial
+     * PriceCheckResult; today it carries `{ product_profile }`.
+     */
+    onPartial?: (event: PartialEvent) => void;
 }
 interface ApiErrorBody {
     code: ErrorCode;
@@ -119,8 +165,8 @@ interface ApiErrorBody {
 
 declare class OrakleClient {
     private readonly apiKey;
-    private readonly baseUrl;
     private readonly timeout;
+    private readonly baseUrl;
     constructor(config: OrakleConfig);
     /**
      * Submit a pricing job and wait for the result.
@@ -171,4 +217,37 @@ declare class OrakleConnectionError extends OrakleError {
     constructor(message: string, cause?: unknown);
 }
 
-export { type ApiErrorBody, type CompletedEvent, type DistributionComponent, type ErrorCode, type FailedEvent, type Geography, type JobEvent, type JobRequest, type JobStatus, type JobSubmitResponse, type NLJobRequest, OrakleApiError, OrakleClient, type OrakleConfig, OrakleConnectionError, OrakleError, OrakleTimeoutError, type PipelineStage, type PriceCheckOptions, type PriceCheckResult, type PriceDistribution, type ProductProfile, type Scenario, type ScenarioForecast, type ScenarioSource, type StageEvent, type StructuredJobRequest };
+/**
+ * SSE parser using fetch + ReadableStream.
+ *
+ * Cannot use browser EventSource — it doesn't support custom headers
+ * (needed for X-Orakle-API-Key). This is the same approach used by
+ * the OpenAI SDK. Works in browsers and Node.js 18+ (native fetch).
+ */
+
+interface SSEOptions {
+    url: string;
+    headers: Record<string, string>;
+    signal?: AbortSignal;
+    lastEventId?: string;
+    onRetry?: (retryMs: number) => void;
+}
+/**
+ * Parse a `text/event-stream` response into SSE frames.
+ *
+ * Yields `{ event, id, data }` for each complete SSE event block.
+ * Handles multi-line `data:` fields (joined with newlines).
+ * Supports reconnection via `Last-Event-Id` header.
+ */
+declare const createSSEStream: (options: SSEOptions) => AsyncGenerator<SSEFrame>;
+/**
+ * Internal error used to communicate HTTP status from the SSE fetch.
+ * The client layer catches this and maps it to OrakleApiError.
+ */
+declare class SSEHttpError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+
+export { type ApiErrorBody, type AttributeCorrection, type CompletedEvent, type DistributionComponent, type ErrorCode, type FailedEvent, type ForecastPoint, type Geography, type JobEvent, type JobRequest, type JobStatus, type JobSubmitResponse, type NLJobRequest, OrakleApiError, OrakleClient, type OrakleConfig, OrakleConnectionError, OrakleError, OrakleTimeoutError, type PartialEvent, type PipelineStage, type PriceCheckOptions, type PriceCheckResult, type PriceDistribution, type ProductProfile, type SSEFrame, SSEHttpError, type Scenario, type ScenarioForecast, type ScenarioSource, type StageEvent, type StructuredJobRequest, type ValueDriver, createSSEStream };

package/dist/index.d.ts

@@ -3,25 +3,36 @@
  */
 interface OrakleConfig {
     apiKey: string;
-    baseUrl?: string;
     timeout?: number;
+    /** Override the API base URL. Defaults to https://api.orakle.xyz. */
+    baseUrl?: string;
 }
 type JobStatus = "pending" | "processing" | "completed" | "failed";
 type PipelineStage = "analyzing" | "price_lookup" | "planning" | "dispatching" | "fusing";
 type ErrorCode = "invalid_request" | "auth_required" | "rate_limited" | "job_not_found" | "insufficient_data" | "internal_error" | "service_unavailable";
 type Geography = "US" | "GB" | "CA" | "AU" | "AE";
+interface AttributeCorrection {
+    key: string;
+    original: string;
+    corrected: string;
+    reason: string;
+}
+interface ValueDriver {
+    /** Snake_case attribute key matching an entry in `attributes`. */
+    key: string;
+    /** Attribute value as it appears in `attributes`. */
+    value: string;
+}
 interface ProductProfile {
     category: string;
     make: string;
     model: string;
-    storage?: string | null;
     condition?: string | null;
-    carrier?: string | null;
-    carrier_lock?: string | null;
-    color?: string | null;
+    attributes?: Record<string, string>;
+    corrections?: AttributeCorrection[];
     geography?: Geography;
     region?: string | null;
-    key_value_drivers?: string[];
+    value_drivers?: ValueDriver[];
     missing_attributes?: string[];
 }
 interface DistributionComponent {
@@ -52,6 +63,13 @@ interface ScenarioForecast {
     base_price: number;
     weighted_expected_price: number;
 }
+interface ForecastPoint {
+    date: string;
+    segment: "historical" | "forecast";
+    price: number;
+    p10?: number;
+    p90?: number;
+}
 interface NLJobRequest {
     request_type: "nl";
     query: string;
@@ -69,11 +87,14 @@ interface PriceCheckResult {
     product_profile: ProductProfile;
     fused_distribution: PriceDistribution;
     scenario_forecast?: ScenarioForecast | null;
+    forecast_series?: ForecastPoint[];
+    forecast_narrative?: string;
 }
 interface JobSubmitResponse {
     job_id: string;
     status: JobStatus;
     poll_url: string;
+    stream_url: string;
     estimated_seconds: number;
 }
 interface StageEvent {
@@ -83,6 +104,18 @@ interface StageEvent {
     message: string;
     timestamp: string;
 }
+interface PartialEvent {
+    event_type: "partial";
+    job_id: string;
+    /**
+     * Subset of PriceCheckResult that the orchestrator emits before the
+     * full job completes. Today this is `{ product_profile }` after the
+     * Analyzing stage; future stages may add `fused_distribution` etc.
+     */
+    result: Partial<PriceCheckResult>;
+    message?: string;
+    timestamp: string;
+}
 interface CompletedEvent {
     event_type: "completed";
     job_id: string;
@@ -97,11 +130,24 @@ interface FailedEvent {
     message?: string;
     timestamp: string;
 }
-type JobEvent = StageEvent | CompletedEvent | FailedEvent;
+type JobEvent = StageEvent | PartialEvent | CompletedEvent | FailedEvent;
+interface SSEFrame {
+    event: string;
+    id: string;
+    data: string;
+}
 interface PriceCheckOptions {
     signal?: AbortSignal;
     timeout?: number;
     onProgress?: (event: StageEvent) => void;
+    /**
+     * Fires once with the analyzed product profile (and any other early
+     * fields) the moment the Analyzing stage finishes — well before the
+     * full result is ready. Use this to populate UI placeholders so users
+     * see the parsed query immediately. The shape is a partial
+     * PriceCheckResult; today it carries `{ product_profile }`.
+     */
+    onPartial?: (event: PartialEvent) => void;
 }
 interface ApiErrorBody {
     code: ErrorCode;
@@ -119,8 +165,8 @@ interface ApiErrorBody {
 
 declare class OrakleClient {
     private readonly apiKey;
-    private readonly baseUrl;
     private readonly timeout;
+    private readonly baseUrl;
     constructor(config: OrakleConfig);
     /**
      * Submit a pricing job and wait for the result.
@@ -171,4 +217,37 @@ declare class OrakleConnectionError extends OrakleError {
     constructor(message: string, cause?: unknown);
 }
 
-export { type ApiErrorBody, type CompletedEvent, type DistributionComponent, type ErrorCode, type FailedEvent, type Geography, type JobEvent, type JobRequest, type JobStatus, type JobSubmitResponse, type NLJobRequest, OrakleApiError, OrakleClient, type OrakleConfig, OrakleConnectionError, OrakleError, OrakleTimeoutError, type PipelineStage, type PriceCheckOptions, type PriceCheckResult, type PriceDistribution, type ProductProfile, type Scenario, type ScenarioForecast, type ScenarioSource, type StageEvent, type StructuredJobRequest };
+/**
+ * SSE parser using fetch + ReadableStream.
+ *
+ * Cannot use browser EventSource — it doesn't support custom headers
+ * (needed for X-Orakle-API-Key). This is the same approach used by
+ * the OpenAI SDK. Works in browsers and Node.js 18+ (native fetch).
+ */
+
+interface SSEOptions {
+    url: string;
+    headers: Record<string, string>;
+    signal?: AbortSignal;
+    lastEventId?: string;
+    onRetry?: (retryMs: number) => void;
+}
+/**
+ * Parse a `text/event-stream` response into SSE frames.
+ *
+ * Yields `{ event, id, data }` for each complete SSE event block.
+ * Handles multi-line `data:` fields (joined with newlines).
+ * Supports reconnection via `Last-Event-Id` header.
+ */
+declare const createSSEStream: (options: SSEOptions) => AsyncGenerator<SSEFrame>;
+/**
+ * Internal error used to communicate HTTP status from the SSE fetch.
+ * The client layer catches this and maps it to OrakleApiError.
+ */
+declare class SSEHttpError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+
+export { type ApiErrorBody, type AttributeCorrection, type CompletedEvent, type DistributionComponent, type ErrorCode, type FailedEvent, type ForecastPoint, type Geography, type JobEvent, type JobRequest, type JobStatus, type JobSubmitResponse, type NLJobRequest, OrakleApiError, OrakleClient, type OrakleConfig, OrakleConnectionError, OrakleError, OrakleTimeoutError, type PartialEvent, type PipelineStage, type PriceCheckOptions, type PriceCheckResult, type PriceDistribution, type ProductProfile, type SSEFrame, SSEHttpError, type Scenario, type ScenarioForecast, type ScenarioSource, type StageEvent, type StructuredJobRequest, type ValueDriver, createSSEStream };

package/dist/index.js

@@ -78,7 +78,9 @@ var parseSSEBody = async function* (body, signal) {
   let currentData = [];
   const readOrAbort = () => {
     if (signal?.aborted) {
-      return Promise.reject(signal.reason ?? new DOMException("Aborted", "AbortError"));
+      return Promise.reject(
+        signal.reason ?? new DOMException("Aborted", "AbortError")
+      );
     }
     return new Promise((resolve, reject) => {
       const onAbort = () => {
@@ -206,14 +208,18 @@ var SSEHttpError = class extends Error {
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.orakle.xyz";
 var DEFAULT_TIMEOUT_MS = 18e4;
+var MIN_TIMEOUT_MS = 18e4;
 var OrakleClient = class {
   apiKey;
-  baseUrl;
   timeout;
+  baseUrl;
   constructor(config) {
     this.apiKey = config.apiKey;
+    this.timeout = Math.max(
+      config.timeout ?? DEFAULT_TIMEOUT_MS,
+      MIN_TIMEOUT_MS
+    );
     this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
-    this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
   }
   /**
    * Submit a pricing job and wait for the result.
@@ -221,7 +227,10 @@ var OrakleClient = class {
    * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.
    */
   async priceCheck(params, options) {
-    const timeoutMs = options?.timeout ?? this.timeout;
+    const timeoutMs = Math.max(
+      options?.timeout ?? this.timeout,
+      MIN_TIMEOUT_MS
+    );
     const controller = new AbortController();
     const externalSignal = options?.signal;
     const onExternalAbort = () => controller.abort();
@@ -244,13 +253,18 @@ var OrakleClient = class {
           case "stage":
             options?.onProgress?.(event);
             break;
+          case "partial":
+            options?.onPartial?.(event);
+            break;
           case "completed":
             return event.result;
           case "failed":
             throw new OrakleError(event.error);
         }
       }
-      throw new OrakleError("SSE stream ended without a completed or failed event");
+      throw new OrakleError(
+        "SSE stream ended without a completed or failed event"
+      );
     } catch (err) {
       throw this.normalizeError(err);
     } finally {
@@ -264,7 +278,10 @@ var OrakleClient = class {
    * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.
    */
   async *priceCheckStream(params, options) {
-    const timeoutMs = options?.timeout ?? this.timeout;
+    const timeoutMs = Math.max(
+      options?.timeout ?? this.timeout,
+      MIN_TIMEOUT_MS
+    );
     const controller = new AbortController();
     const externalSignal = options?.signal;
     const onExternalAbort = () => controller.abort();
@@ -285,6 +302,8 @@ var OrakleClient = class {
         if (!event) continue;
         if (event.event_type === "stage") {
           options?.onProgress?.(event);
+        } else if (event.event_type === "partial") {
+          options?.onPartial?.(event);
         }
         yield event;
         if (event.event_type === "completed" || event.event_type === "failed") {
@@ -317,10 +336,7 @@ var OrakleClient = class {
       if (err instanceof DOMException && err.name === "AbortError") {
         throw err;
       }
-      throw new OrakleConnectionError(
-        "Failed to connect to Orakle API",
-        err
-      );
+      throw new OrakleConnectionError("Failed to connect to Orakle API", err);
     }
     if (!response.ok) {
       throw await this.buildApiError(response);
@@ -339,6 +355,8 @@ var OrakleClient = class {
       switch (eventType) {
         case "stage":
           return { ...parsed, event_type: "stage" };
+        case "partial":
+          return { ...parsed, event_type: "partial" };
         case "completed":
           return { ...parsed, event_type: "completed" };
         case "failed":
@@ -404,6 +422,8 @@ export {
   OrakleClient,
   OrakleConnectionError,
   OrakleError,
-  OrakleTimeoutError
+  OrakleTimeoutError,
+  SSEHttpError,
+  createSSEStream
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["import type { ErrorCode } from \"./types.js\";\n\n/**\n * Base error for all Orakle SDK errors.\n */\nexport class OrakleError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"OrakleError\";\n  }\n}\n\n/**\n * HTTP API error with status code and typed error code.\n */\nexport class OrakleApiError extends OrakleError {\n  readonly status: number;\n  readonly code: ErrorCode;\n\n  constructor(message: string, status: number, code: ErrorCode) {\n    super(message);\n    this.name = \"OrakleApiError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\n/**\n * Timeout error — request or SSE stream exceeded the configured timeout.\n */\nexport class OrakleTimeoutError extends OrakleError {\n  readonly timeoutMs: number;\n\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${timeoutMs}ms`);\n    this.name = \"OrakleTimeoutError\";\n    this.timeoutMs = timeoutMs;\n  }\n}\n\n/**\n * Connection error — network failure, DNS resolution failure, etc.\n */\nexport class OrakleConnectionError extends OrakleError {\n  readonly cause?: unknown;\n\n  constructor(message: string, cause?: unknown) {\n    super(message);\n    this.name = \"OrakleConnectionError\";\n    this.cause = cause;\n  }\n}\n","/**\n * SSE parser using fetch + ReadableStream.\n *\n * Cannot use browser EventSource — it doesn't support custom headers\n * (needed for X-Orakle-API-Key). This is the same approach used by\n * the OpenAI SDK. Works in browsers and Node.js 18+ (native fetch).\n */\n\nimport { OrakleConnectionError } from \"./errors.js\";\nimport type { SSEFrame } from \"./types.js\";\n\ninterface SSEOptions {\n  url: string;\n  headers: Record<string, string>;\n  signal?: AbortSignal;\n  lastEventId?: string;\n  onRetry?: (retryMs: number) => void;\n}\n\n/**\n * Parse a `text/event-stream` response into SSE frames.\n *\n * Yields `{ event, id, data }` for each complete SSE event block.\n * Handles multi-line `data:` fields (joined with newlines).\n * Supports reconnection via `Last-Event-Id` header.\n */\nexport const createSSEStream = async function* (\n  options: SSEOptions,\n): AsyncGenerator<SSEFrame> {\n  const { url, headers, signal, lastEventId } = options;\n\n  const requestHeaders: Record<string, string> = {\n    ...headers,\n    Accept: \"text/event-stream\",\n    \"Cache-Control\": \"no-cache\",\n  };\n\n  if (lastEventId) {\n    requestHeaders[\"Last-Event-Id\"] = lastEventId;\n  }\n\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"GET\",\n      headers: requestHeaders,\n      signal,\n    });\n  } catch (err: unknown) {\n    if (err instanceof DOMException && err.name === \"AbortError\") {\n      throw err;\n    }\n    throw new OrakleConnectionError(\n      `Failed to connect to SSE stream: ${url}`,\n      err,\n    );\n  }\n\n  if (!response.ok) {\n    // Let the caller handle HTTP error responses\n    const body = await response.text();\n    throw new SSEHttpError(response.status, body);\n  }\n\n  const body = response.body;\n  if (!body) {\n    throw new OrakleConnectionError(\"Response body is null\");\n  }\n\n  yield* parseSSEBody(body, signal);\n};\n\n/**\n * Internal: parse a ReadableStream<Uint8Array> as SSE.\n */\nconst parseSSEBody = async function* (\n  body: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n): AsyncGenerator<SSEFrame> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n\n  let buffer = \"\";\n  let currentEvent = \"\";\n  let currentId = \"\";\n  let currentData: string[] = [];\n\n  type ReadResult = Awaited<ReturnType<typeof reader.read>>;\n\n  /** Race reader.read() against the abort signal. */\n  const readOrAbort = (): Promise<ReadResult> => {\n    if (signal?.aborted) {\n      return Promise.reject(signal.reason ?? new DOMException(\"Aborted\", \"AbortError\"));\n    }\n    return new Promise<ReadResult>((resolve, reject) => {\n      const onAbort = () => {\n        reject(signal?.reason ?? new DOMException(\"Aborted\", \"AbortError\"));\n      };\n      signal?.addEventListener(\"abort\", onAbort, { once: true });\n      reader.read().then(\n        (result) => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          resolve(result);\n        },\n        (err: unknown) => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          reject(err);\n        },\n      );\n    });\n  };\n\n  try {\n    while (true) {\n      if (signal?.aborted) {\n        break;\n      }\n\n      const { done, value } = await readOrAbort();\n      if (done) break;\n\n      buffer += decoder.decode(value, { stream: true });\n\n      const lines = buffer.split(\"\\n\");\n      // Keep the last partial line in the buffer\n      buffer = lines.pop() ?? \"\";\n\n      for (const line of lines) {\n        if (line === \"\") {\n          // Empty line = end of event block\n          if (currentData.length > 0) {\n            yield {\n              event: currentEvent ?? \"message\",\n              id: currentId,\n              data: currentData.join(\"\\n\"),\n            };\n          }\n          // Reset for next event\n          currentEvent = \"\";\n          currentId = \"\";\n          currentData = [];\n          continue;\n        }\n\n        // SSE comment — ignore (keepalive)\n        if (line.startsWith(\":\")) {\n          continue;\n        }\n\n        const colonIdx = line.indexOf(\":\");\n        if (colonIdx === -1) {\n          // Field with no value\n          continue;\n        }\n\n        const field = line.slice(0, colonIdx);\n        // Value starts after \": \" (space after colon is optional per spec)\n        let value_ = line.slice(colonIdx + 1);\n        if (value_.startsWith(\" \")) {\n          value_ = value_.slice(1);\n        }\n\n        switch (field) {\n          case \"event\":\n            currentEvent = value_;\n            break;\n          case \"id\":\n            currentId = value_;\n            break;\n          case \"data\":\n            currentData.push(value_);\n            break;\n          case \"retry\":\n            // Optional retry field — notify caller\n            break;\n        }\n      }\n    }\n\n    // Flush any remaining event in buffer\n    if (buffer !== \"\") {\n      const lines = buffer.split(\"\\n\");\n      for (const line of lines) {\n        if (line === \"\" && currentData.length > 0) {\n          yield {\n            event: currentEvent ?? \"message\",\n            id: currentId,\n            data: currentData.join(\"\\n\"),\n          };\n          currentEvent = \"\";\n          currentId = \"\";\n          currentData = [];\n          continue;\n        }\n        if (line.startsWith(\":\") || line === \"\") continue;\n        const colonIdx = line.indexOf(\":\");\n        if (colonIdx === -1) continue;\n        const field = line.slice(0, colonIdx);\n        let value_ = line.slice(colonIdx + 1);\n        if (value_.startsWith(\" \")) value_ = value_.slice(1);\n        switch (field) {\n          case \"event\":\n            currentEvent = value_;\n            break;\n          case \"id\":\n            currentId = value_;\n            break;\n          case \"data\":\n            currentData.push(value_);\n            break;\n        }\n      }\n      if (currentData.length > 0) {\n        yield {\n          event: currentEvent ?? \"message\",\n          id: currentId,\n          data: currentData.join(\"\\n\"),\n        };\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n};\n\n/**\n * Internal error used to communicate HTTP status from the SSE fetch.\n * The client layer catches this and maps it to OrakleApiError.\n */\nexport class SSEHttpError extends Error {\n  readonly status: number;\n  readonly body: string;\n\n  constructor(status: number, body: string) {\n    super(`SSE request failed with status ${status}`);\n    this.name = \"SSEHttpError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n","/**\n * OrakleClient — main entry point for the Orakle TypeScript SDK.\n *\n * Usage:\n *   const client = new OrakleClient({ apiKey: \"...\" });\n *   const result = await client.priceCheck({ query: \"iPhone 15 Pro 256GB\" });\n */\n\nimport {\n  OrakleApiError,\n  OrakleConnectionError,\n  OrakleError,\n  OrakleTimeoutError,\n} from \"./errors.js\";\nimport { SSEHttpError, createSSEStream } from \"./sse.js\";\nimport type {\n  ApiErrorBody,\n  CompletedEvent,\n  ErrorCode,\n  FailedEvent,\n  JobEvent,\n  JobRequest,\n  JobSubmitResponse,\n  OrakleConfig,\n  PriceCheckOptions,\n  PriceCheckResult,\n  StageEvent,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.orakle.xyz\";\nconst DEFAULT_TIMEOUT_MS = 180_000;\n\nexport class OrakleClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly timeout: number;\n\n  constructor(config: OrakleConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;\n  }\n\n  /**\n   * Submit a pricing job and wait for the result.\n   *\n   * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.\n   */\n  async priceCheck(\n    params: JobRequest,\n    options?: PriceCheckOptions,\n  ): Promise<PriceCheckResult> {\n    const timeoutMs = options?.timeout ?? this.timeout;\n    const controller = new AbortController();\n\n    // Link external signal to our internal controller\n    const externalSignal = options?.signal;\n    const onExternalAbort = () => controller.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n\n    const timer = setTimeout(() => {\n      controller.abort(new OrakleTimeoutError(timeoutMs));\n    }, timeoutMs);\n\n    try {\n      const job = await this.submitJob(params, controller.signal);\n      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;\n\n      const stream = createSSEStream({\n        url: streamUrl,\n        headers: this.defaultHeaders(),\n        signal: controller.signal,\n      });\n\n      for await (const frame of stream) {\n        const event = this.parseJobEvent(frame.event, frame.data);\n        if (!event) continue;\n\n        switch (event.event_type) {\n          case \"stage\":\n            options?.onProgress?.(event);\n            break;\n          case \"completed\":\n            return event.result;\n          case \"failed\":\n            throw new OrakleError(event.error);\n        }\n      }\n\n      // Stream ended without a terminal event\n      throw new OrakleError(\"SSE stream ended without a completed or failed event\");\n    } catch (err: unknown) {\n      throw this.normalizeError(err);\n    } finally {\n      clearTimeout(timer);\n      externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n  }\n\n  /**\n   * Submit a pricing job and return an async iterable of all events.\n   *\n   * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.\n   */\n  async *priceCheckStream(\n    params: JobRequest,\n    options?: PriceCheckOptions,\n  ): AsyncGenerator<JobEvent> {\n    const timeoutMs = options?.timeout ?? this.timeout;\n    const controller = new AbortController();\n\n    const externalSignal = options?.signal;\n    const onExternalAbort = () => controller.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n\n    const timer = setTimeout(() => {\n      controller.abort(new OrakleTimeoutError(timeoutMs));\n    }, timeoutMs);\n\n    try {\n      const job = await this.submitJob(params, controller.signal);\n      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;\n\n      const stream = createSSEStream({\n        url: streamUrl,\n        headers: this.defaultHeaders(),\n        signal: controller.signal,\n      });\n\n      for await (const frame of stream) {\n        const event = this.parseJobEvent(frame.event, frame.data);\n        if (!event) continue;\n\n        if (event.event_type === \"stage\") {\n          options?.onProgress?.(event);\n        }\n\n        yield event;\n\n        // Terminal events end the stream\n        if (event.event_type === \"completed\" || event.event_type === \"failed\") {\n          return;\n        }\n      }\n    } catch (err: unknown) {\n      throw this.normalizeError(err);\n    } finally {\n      clearTimeout(timer);\n      externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private helpers\n  // ---------------------------------------------------------------------------\n\n  private async submitJob(\n    params: JobRequest,\n    signal: AbortSignal,\n  ): Promise<JobSubmitResponse> {\n    let response: Response;\n    try {\n      response = await fetch(`${this.baseUrl}/v1/jobs`, {\n        method: \"POST\",\n        headers: {\n          ...this.defaultHeaders(),\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(params),\n        signal,\n      });\n    } catch (err: unknown) {\n      if (err instanceof DOMException && err.name === \"AbortError\") {\n        throw err;\n      }\n      throw new OrakleConnectionError(\n        \"Failed to connect to Orakle API\",\n        err,\n      );\n    }\n\n    if (!response.ok) {\n      throw await this.buildApiError(response);\n    }\n\n    return (await response.json()) as JobSubmitResponse;\n  }\n\n  private defaultHeaders(): Record<string, string> {\n    return {\n      \"X-Orakle-API-Key\": this.apiKey,\n    };\n  }\n\n  private parseJobEvent(eventType: string, data: string): JobEvent | undefined {\n    try {\n      const parsed: unknown = JSON.parse(data);\n      if (typeof parsed !== \"object\" || parsed === null) return undefined;\n\n      switch (eventType) {\n        case \"stage\":\n          return { ...parsed, event_type: \"stage\" } as StageEvent;\n        case \"completed\":\n          return { ...parsed, event_type: \"completed\" } as CompletedEvent;\n        case \"failed\":\n          return { ...parsed, event_type: \"failed\" } as FailedEvent;\n        default:\n          return undefined;\n      }\n    } catch {\n      return undefined;\n    }\n  }\n\n  private async buildApiError(response: Response): Promise<OrakleApiError> {\n    let body: ApiErrorBody | undefined;\n    try {\n      body = (await response.json()) as ApiErrorBody;\n    } catch {\n      // Response body is not JSON\n    }\n\n    const code: ErrorCode = body?.code ?? this.httpStatusToErrorCode(response.status);\n    const message = body?.message ?? `API request failed with status ${response.status}`;\n\n    return new OrakleApiError(message, response.status, code);\n  }\n\n  private httpStatusToErrorCode(status: number): ErrorCode {\n    switch (status) {\n      case 400:\n        return \"invalid_request\";\n      case 401:\n        return \"auth_required\";\n      case 429:\n        return \"rate_limited\";\n      case 404:\n        return \"job_not_found\";\n      case 503:\n        return \"service_unavailable\";\n      default:\n        return \"internal_error\";\n    }\n  }\n\n  private normalizeError(err: unknown): Error {\n    if (err instanceof OrakleError) {\n      return err;\n    }\n\n    if (err instanceof SSEHttpError) {\n      let body: ApiErrorBody | undefined;\n      try {\n        body = JSON.parse(err.body) as ApiErrorBody;\n      } catch {\n        // Not JSON\n      }\n      const code = body?.code ?? this.httpStatusToErrorCode(err.status);\n      const message = body?.message ?? `API request failed with status ${err.status}`;\n      return new OrakleApiError(message, err.status, code);\n    }\n\n    // AbortError from timeout\n    if (err instanceof DOMException && err.name === \"AbortError\") {\n      // Check if our timeout caused the abort\n      return new OrakleTimeoutError(this.timeout);\n    }\n\n    if (err instanceof Error) {\n      return new OrakleConnectionError(err.message, err);\n    }\n\n    return new OrakleConnectionError(String(err));\n  }\n}\n"],"mappings":"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","names":["body"]}
+{"version":3,"sources":["../src/errors.ts","../src/sse.ts","../src/client.ts"],"sourcesContent":["import type { ErrorCode } from \"./types.js\";\n\n/**\n * Base error for all Orakle SDK errors.\n */\nexport class OrakleError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"OrakleError\";\n  }\n}\n\n/**\n * HTTP API error with status code and typed error code.\n */\nexport class OrakleApiError extends OrakleError {\n  readonly status: number;\n  readonly code: ErrorCode;\n\n  constructor(message: string, status: number, code: ErrorCode) {\n    super(message);\n    this.name = \"OrakleApiError\";\n    this.status = status;\n    this.code = code;\n  }\n}\n\n/**\n * Timeout error — request or SSE stream exceeded the configured timeout.\n */\nexport class OrakleTimeoutError extends OrakleError {\n  readonly timeoutMs: number;\n\n  constructor(timeoutMs: number) {\n    super(`Request timed out after ${timeoutMs}ms`);\n    this.name = \"OrakleTimeoutError\";\n    this.timeoutMs = timeoutMs;\n  }\n}\n\n/**\n * Connection error — network failure, DNS resolution failure, etc.\n */\nexport class OrakleConnectionError extends OrakleError {\n  readonly cause?: unknown;\n\n  constructor(message: string, cause?: unknown) {\n    super(message);\n    this.name = \"OrakleConnectionError\";\n    this.cause = cause;\n  }\n}\n","/**\n * SSE parser using fetch + ReadableStream.\n *\n * Cannot use browser EventSource — it doesn't support custom headers\n * (needed for X-Orakle-API-Key). This is the same approach used by\n * the OpenAI SDK. Works in browsers and Node.js 18+ (native fetch).\n */\n\nimport { OrakleConnectionError } from \"./errors.js\";\nimport type { SSEFrame } from \"./types.js\";\n\ninterface SSEOptions {\n  url: string;\n  headers: Record<string, string>;\n  signal?: AbortSignal;\n  lastEventId?: string;\n  onRetry?: (retryMs: number) => void;\n}\n\n/**\n * Parse a `text/event-stream` response into SSE frames.\n *\n * Yields `{ event, id, data }` for each complete SSE event block.\n * Handles multi-line `data:` fields (joined with newlines).\n * Supports reconnection via `Last-Event-Id` header.\n */\nexport const createSSEStream = async function* (\n  options: SSEOptions,\n): AsyncGenerator<SSEFrame> {\n  const { url, headers, signal, lastEventId } = options;\n\n  const requestHeaders: Record<string, string> = {\n    ...headers,\n    Accept: \"text/event-stream\",\n    \"Cache-Control\": \"no-cache\",\n  };\n\n  if (lastEventId) {\n    requestHeaders[\"Last-Event-Id\"] = lastEventId;\n  }\n\n  let response: Response;\n  try {\n    response = await fetch(url, {\n      method: \"GET\",\n      headers: requestHeaders,\n      signal,\n    });\n  } catch (err: unknown) {\n    if (err instanceof DOMException && err.name === \"AbortError\") {\n      throw err;\n    }\n    throw new OrakleConnectionError(\n      `Failed to connect to SSE stream: ${url}`,\n      err,\n    );\n  }\n\n  if (!response.ok) {\n    // Let the caller handle HTTP error responses\n    const body = await response.text();\n    throw new SSEHttpError(response.status, body);\n  }\n\n  const body = response.body;\n  if (!body) {\n    throw new OrakleConnectionError(\"Response body is null\");\n  }\n\n  yield* parseSSEBody(body, signal);\n};\n\n/**\n * Internal: parse a ReadableStream<Uint8Array> as SSE.\n */\nconst parseSSEBody = async function* (\n  body: ReadableStream<Uint8Array>,\n  signal?: AbortSignal,\n): AsyncGenerator<SSEFrame> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n\n  let buffer = \"\";\n  let currentEvent = \"\";\n  let currentId = \"\";\n  let currentData: string[] = [];\n\n  type ReadResult = Awaited<ReturnType<typeof reader.read>>;\n\n  /** Race reader.read() against the abort signal. */\n  const readOrAbort = (): Promise<ReadResult> => {\n    if (signal?.aborted) {\n      return Promise.reject(\n        signal.reason ?? new DOMException(\"Aborted\", \"AbortError\"),\n      );\n    }\n    return new Promise<ReadResult>((resolve, reject) => {\n      const onAbort = () => {\n        reject(signal?.reason ?? new DOMException(\"Aborted\", \"AbortError\"));\n      };\n      signal?.addEventListener(\"abort\", onAbort, { once: true });\n      reader.read().then(\n        (result) => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          resolve(result);\n        },\n        (err: unknown) => {\n          signal?.removeEventListener(\"abort\", onAbort);\n          reject(err);\n        },\n      );\n    });\n  };\n\n  try {\n    while (true) {\n      if (signal?.aborted) {\n        break;\n      }\n\n      const { done, value } = await readOrAbort();\n      if (done) break;\n\n      buffer += decoder.decode(value, { stream: true });\n\n      const lines = buffer.split(\"\\n\");\n      // Keep the last partial line in the buffer\n      buffer = lines.pop() ?? \"\";\n\n      for (const line of lines) {\n        if (line === \"\") {\n          // Empty line = end of event block\n          if (currentData.length > 0) {\n            yield {\n              event: currentEvent ?? \"message\",\n              id: currentId,\n              data: currentData.join(\"\\n\"),\n            };\n          }\n          // Reset for next event\n          currentEvent = \"\";\n          currentId = \"\";\n          currentData = [];\n          continue;\n        }\n\n        // SSE comment — ignore (keepalive)\n        if (line.startsWith(\":\")) {\n          continue;\n        }\n\n        const colonIdx = line.indexOf(\":\");\n        if (colonIdx === -1) {\n          // Field with no value\n          continue;\n        }\n\n        const field = line.slice(0, colonIdx);\n        // Value starts after \": \" (space after colon is optional per spec)\n        let value_ = line.slice(colonIdx + 1);\n        if (value_.startsWith(\" \")) {\n          value_ = value_.slice(1);\n        }\n\n        switch (field) {\n          case \"event\":\n            currentEvent = value_;\n            break;\n          case \"id\":\n            currentId = value_;\n            break;\n          case \"data\":\n            currentData.push(value_);\n            break;\n          case \"retry\":\n            // Optional retry field — notify caller\n            break;\n        }\n      }\n    }\n\n    // Flush any remaining event in buffer\n    if (buffer !== \"\") {\n      const lines = buffer.split(\"\\n\");\n      for (const line of lines) {\n        if (line === \"\" && currentData.length > 0) {\n          yield {\n            event: currentEvent ?? \"message\",\n            id: currentId,\n            data: currentData.join(\"\\n\"),\n          };\n          currentEvent = \"\";\n          currentId = \"\";\n          currentData = [];\n          continue;\n        }\n        if (line.startsWith(\":\") || line === \"\") continue;\n        const colonIdx = line.indexOf(\":\");\n        if (colonIdx === -1) continue;\n        const field = line.slice(0, colonIdx);\n        let value_ = line.slice(colonIdx + 1);\n        if (value_.startsWith(\" \")) value_ = value_.slice(1);\n        switch (field) {\n          case \"event\":\n            currentEvent = value_;\n            break;\n          case \"id\":\n            currentId = value_;\n            break;\n          case \"data\":\n            currentData.push(value_);\n            break;\n        }\n      }\n      if (currentData.length > 0) {\n        yield {\n          event: currentEvent ?? \"message\",\n          id: currentId,\n          data: currentData.join(\"\\n\"),\n        };\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n};\n\n/**\n * Internal error used to communicate HTTP status from the SSE fetch.\n * The client layer catches this and maps it to OrakleApiError.\n */\nexport class SSEHttpError extends Error {\n  readonly status: number;\n  readonly body: string;\n\n  constructor(status: number, body: string) {\n    super(`SSE request failed with status ${status}`);\n    this.name = \"SSEHttpError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n","/**\n * OrakleClient — main entry point for the Orakle TypeScript SDK.\n *\n * Usage:\n *   const client = new OrakleClient({ apiKey: \"...\" });\n *   const result = await client.priceCheck({ query: \"iPhone 15 Pro 256GB\" });\n */\n\nimport {\n  OrakleApiError,\n  OrakleConnectionError,\n  OrakleError,\n  OrakleTimeoutError,\n} from \"./errors.js\";\nimport { createSSEStream, SSEHttpError } from \"./sse.js\";\nimport type {\n  ApiErrorBody,\n  CompletedEvent,\n  ErrorCode,\n  FailedEvent,\n  JobEvent,\n  JobRequest,\n  JobSubmitResponse,\n  OrakleConfig,\n  PartialEvent,\n  PriceCheckOptions,\n  PriceCheckResult,\n  StageEvent,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.orakle.xyz\";\nconst DEFAULT_TIMEOUT_MS = 180_000;\nconst MIN_TIMEOUT_MS = 180_000;\n\nexport class OrakleClient {\n  private readonly apiKey: string;\n  private readonly timeout: number;\n  private readonly baseUrl: string;\n\n  constructor(config: OrakleConfig) {\n    this.apiKey = config.apiKey;\n    this.timeout = Math.max(\n      config.timeout ?? DEFAULT_TIMEOUT_MS,\n      MIN_TIMEOUT_MS,\n    );\n    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n  }\n\n  /**\n   * Submit a pricing job and wait for the result.\n   *\n   * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.\n   */\n  async priceCheck(\n    params: JobRequest,\n    options?: PriceCheckOptions,\n  ): Promise<PriceCheckResult> {\n    const timeoutMs = Math.max(\n      options?.timeout ?? this.timeout,\n      MIN_TIMEOUT_MS,\n    );\n    const controller = new AbortController();\n\n    // Link external signal to our internal controller\n    const externalSignal = options?.signal;\n    const onExternalAbort = () => controller.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n\n    const timer = setTimeout(() => {\n      controller.abort(new OrakleTimeoutError(timeoutMs));\n    }, timeoutMs);\n\n    try {\n      const job = await this.submitJob(params, controller.signal);\n      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;\n\n      const stream = createSSEStream({\n        url: streamUrl,\n        headers: this.defaultHeaders(),\n        signal: controller.signal,\n      });\n\n      for await (const frame of stream) {\n        const event = this.parseJobEvent(frame.event, frame.data);\n        if (!event) continue;\n\n        switch (event.event_type) {\n          case \"stage\":\n            options?.onProgress?.(event);\n            break;\n          case \"partial\":\n            options?.onPartial?.(event);\n            break;\n          case \"completed\":\n            return event.result;\n          case \"failed\":\n            throw new OrakleError(event.error);\n        }\n      }\n\n      // Stream ended without a terminal event\n      throw new OrakleError(\n        \"SSE stream ended without a completed or failed event\",\n      );\n    } catch (err: unknown) {\n      throw this.normalizeError(err);\n    } finally {\n      clearTimeout(timer);\n      externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n  }\n\n  /**\n   * Submit a pricing job and return an async iterable of all events.\n   *\n   * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.\n   */\n  async *priceCheckStream(\n    params: JobRequest,\n    options?: PriceCheckOptions,\n  ): AsyncGenerator<JobEvent> {\n    const timeoutMs = Math.max(\n      options?.timeout ?? this.timeout,\n      MIN_TIMEOUT_MS,\n    );\n    const controller = new AbortController();\n\n    const externalSignal = options?.signal;\n    const onExternalAbort = () => controller.abort();\n    externalSignal?.addEventListener(\"abort\", onExternalAbort, { once: true });\n\n    const timer = setTimeout(() => {\n      controller.abort(new OrakleTimeoutError(timeoutMs));\n    }, timeoutMs);\n\n    try {\n      const job = await this.submitJob(params, controller.signal);\n      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;\n\n      const stream = createSSEStream({\n        url: streamUrl,\n        headers: this.defaultHeaders(),\n        signal: controller.signal,\n      });\n\n      for await (const frame of stream) {\n        const event = this.parseJobEvent(frame.event, frame.data);\n        if (!event) continue;\n\n        if (event.event_type === \"stage\") {\n          options?.onProgress?.(event);\n        } else if (event.event_type === \"partial\") {\n          options?.onPartial?.(event);\n        }\n\n        yield event;\n\n        // Terminal events end the stream\n        if (event.event_type === \"completed\" || event.event_type === \"failed\") {\n          return;\n        }\n      }\n    } catch (err: unknown) {\n      throw this.normalizeError(err);\n    } finally {\n      clearTimeout(timer);\n      externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Private helpers\n  // ---------------------------------------------------------------------------\n\n  private async submitJob(\n    params: JobRequest,\n    signal: AbortSignal,\n  ): Promise<JobSubmitResponse> {\n    let response: Response;\n    try {\n      response = await fetch(`${this.baseUrl}/v1/jobs`, {\n        method: \"POST\",\n        headers: {\n          ...this.defaultHeaders(),\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(params),\n        signal,\n      });\n    } catch (err: unknown) {\n      if (err instanceof DOMException && err.name === \"AbortError\") {\n        throw err;\n      }\n      throw new OrakleConnectionError(\"Failed to connect to Orakle API\", err);\n    }\n\n    if (!response.ok) {\n      throw await this.buildApiError(response);\n    }\n\n    return (await response.json()) as JobSubmitResponse;\n  }\n\n  private defaultHeaders(): Record<string, string> {\n    return {\n      \"X-Orakle-API-Key\": this.apiKey,\n    };\n  }\n\n  private parseJobEvent(eventType: string, data: string): JobEvent | undefined {\n    try {\n      const parsed: unknown = JSON.parse(data);\n      if (typeof parsed !== \"object\" || parsed === null) return undefined;\n\n      switch (eventType) {\n        case \"stage\":\n          return { ...parsed, event_type: \"stage\" } as StageEvent;\n        case \"partial\":\n          return { ...parsed, event_type: \"partial\" } as PartialEvent;\n        case \"completed\":\n          return { ...parsed, event_type: \"completed\" } as CompletedEvent;\n        case \"failed\":\n          return { ...parsed, event_type: \"failed\" } as FailedEvent;\n        default:\n          return undefined;\n      }\n    } catch {\n      return undefined;\n    }\n  }\n\n  private async buildApiError(response: Response): Promise<OrakleApiError> {\n    let body: ApiErrorBody | undefined;\n    try {\n      body = (await response.json()) as ApiErrorBody;\n    } catch {\n      // Response body is not JSON\n    }\n\n    const code: ErrorCode =\n      body?.code ?? this.httpStatusToErrorCode(response.status);\n    const message =\n      body?.message ?? `API request failed with status ${response.status}`;\n\n    return new OrakleApiError(message, response.status, code);\n  }\n\n  private httpStatusToErrorCode(status: number): ErrorCode {\n    switch (status) {\n      case 400:\n        return \"invalid_request\";\n      case 401:\n        return \"auth_required\";\n      case 429:\n        return \"rate_limited\";\n      case 404:\n        return \"job_not_found\";\n      case 503:\n        return \"service_unavailable\";\n      default:\n        return \"internal_error\";\n    }\n  }\n\n  private normalizeError(err: unknown): Error {\n    if (err instanceof OrakleError) {\n      return err;\n    }\n\n    if (err instanceof SSEHttpError) {\n      let body: ApiErrorBody | undefined;\n      try {\n        body = JSON.parse(err.body) as ApiErrorBody;\n      } catch {\n        // Not JSON\n      }\n      const code = body?.code ?? this.httpStatusToErrorCode(err.status);\n      const message =\n        body?.message ?? `API request failed with status ${err.status}`;\n      return new OrakleApiError(message, err.status, code);\n    }\n\n    // AbortError from timeout\n    if (err instanceof DOMException && err.name === \"AbortError\") {\n      // Check if our timeout caused the abort\n      return new OrakleTimeoutError(this.timeout);\n    }\n\n    if (err instanceof Error) {\n      return new OrakleConnectionError(err.message, err);\n    }\n\n    return new OrakleConnectionError(String(err));\n  }\n}\n"],"mappings":"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","names":["body"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orakle",
-  "version": "0.0.2",
+  "version": "0.1.1",
   "description": "Client SDK for orakle.xyz",
   "license": "Apache-2.0",
   "type": "module",
@@ -28,7 +28,7 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
+    "@biomejs/biome": "2.4.12",
     "@types/node": "^22.15.3",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
@@ -36,7 +36,7 @@
   },
   "scripts": {
     "build": "tsup",
-    "typecheck": "tsc --noEmit",
+    "check": "tsc --noEmit && biome check",
     "test": "vitest run",
     "test:watch": "vitest"
   }