orakle 0.0.1 → 0.0.2

package/dist/index.cjs

@@ -0,0 +1,440 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  OrakleApiError: () => OrakleApiError,
+  OrakleClient: () => OrakleClient,
+  OrakleConnectionError: () => OrakleConnectionError,
+  OrakleError: () => OrakleError,
+  OrakleTimeoutError: () => OrakleTimeoutError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var OrakleError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "OrakleError";
+  }
+};
+var OrakleApiError = class extends OrakleError {
+  status;
+  code;
+  constructor(message, status, code) {
+    super(message);
+    this.name = "OrakleApiError";
+    this.status = status;
+    this.code = code;
+  }
+};
+var OrakleTimeoutError = class extends OrakleError {
+  timeoutMs;
+  constructor(timeoutMs) {
+    super(`Request timed out after ${timeoutMs}ms`);
+    this.name = "OrakleTimeoutError";
+    this.timeoutMs = timeoutMs;
+  }
+};
+var OrakleConnectionError = class extends OrakleError {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "OrakleConnectionError";
+    this.cause = cause;
+  }
+};
+
+// src/sse.ts
+var createSSEStream = async function* (options) {
+  const { url, headers, signal, lastEventId } = options;
+  const requestHeaders = {
+    ...headers,
+    Accept: "text/event-stream",
+    "Cache-Control": "no-cache"
+  };
+  if (lastEventId) {
+    requestHeaders["Last-Event-Id"] = lastEventId;
+  }
+  let response;
+  try {
+    response = await fetch(url, {
+      method: "GET",
+      headers: requestHeaders,
+      signal
+    });
+  } catch (err) {
+    if (err instanceof DOMException && err.name === "AbortError") {
+      throw err;
+    }
+    throw new OrakleConnectionError(
+      `Failed to connect to SSE stream: ${url}`,
+      err
+    );
+  }
+  if (!response.ok) {
+    const body2 = await response.text();
+    throw new SSEHttpError(response.status, body2);
+  }
+  const body = response.body;
+  if (!body) {
+    throw new OrakleConnectionError("Response body is null");
+  }
+  yield* parseSSEBody(body, signal);
+};
+var parseSSEBody = async function* (body, signal) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let currentEvent = "";
+  let currentId = "";
+  let currentData = [];
+  const readOrAbort = () => {
+    if (signal?.aborted) {
+      return Promise.reject(signal.reason ?? new DOMException("Aborted", "AbortError"));
+    }
+    return new Promise((resolve, reject) => {
+      const onAbort = () => {
+        reject(signal?.reason ?? new DOMException("Aborted", "AbortError"));
+      };
+      signal?.addEventListener("abort", onAbort, { once: true });
+      reader.read().then(
+        (result) => {
+          signal?.removeEventListener("abort", onAbort);
+          resolve(result);
+        },
+        (err) => {
+          signal?.removeEventListener("abort", onAbort);
+          reject(err);
+        }
+      );
+    });
+  };
+  try {
+    while (true) {
+      if (signal?.aborted) {
+        break;
+      }
+      const { done, value } = await readOrAbort();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        if (line === "") {
+          if (currentData.length > 0) {
+            yield {
+              event: currentEvent ?? "message",
+              id: currentId,
+              data: currentData.join("\n")
+            };
+          }
+          currentEvent = "";
+          currentId = "";
+          currentData = [];
+          continue;
+        }
+        if (line.startsWith(":")) {
+          continue;
+        }
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1) {
+          continue;
+        }
+        const field = line.slice(0, colonIdx);
+        let value_ = line.slice(colonIdx + 1);
+        if (value_.startsWith(" ")) {
+          value_ = value_.slice(1);
+        }
+        switch (field) {
+          case "event":
+            currentEvent = value_;
+            break;
+          case "id":
+            currentId = value_;
+            break;
+          case "data":
+            currentData.push(value_);
+            break;
+          case "retry":
+            break;
+        }
+      }
+    }
+    if (buffer !== "") {
+      const lines = buffer.split("\n");
+      for (const line of lines) {
+        if (line === "" && currentData.length > 0) {
+          yield {
+            event: currentEvent ?? "message",
+            id: currentId,
+            data: currentData.join("\n")
+          };
+          currentEvent = "";
+          currentId = "";
+          currentData = [];
+          continue;
+        }
+        if (line.startsWith(":") || line === "") continue;
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1) continue;
+        const field = line.slice(0, colonIdx);
+        let value_ = line.slice(colonIdx + 1);
+        if (value_.startsWith(" ")) value_ = value_.slice(1);
+        switch (field) {
+          case "event":
+            currentEvent = value_;
+            break;
+          case "id":
+            currentId = value_;
+            break;
+          case "data":
+            currentData.push(value_);
+            break;
+        }
+      }
+      if (currentData.length > 0) {
+        yield {
+          event: currentEvent ?? "message",
+          id: currentId,
+          data: currentData.join("\n")
+        };
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+};
+var SSEHttpError = class extends Error {
+  status;
+  body;
+  constructor(status, body) {
+    super(`SSE request failed with status ${status}`);
+    this.name = "SSEHttpError";
+    this.status = status;
+    this.body = body;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.orakle.xyz";
+var DEFAULT_TIMEOUT_MS = 18e4;
+var OrakleClient = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
+  }
+  /**
+   * Submit a pricing job and wait for the result.
+   *
+   * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.
+   */
+  async priceCheck(params, options) {
+    const timeoutMs = options?.timeout ?? this.timeout;
+    const controller = new AbortController();
+    const externalSignal = options?.signal;
+    const onExternalAbort = () => controller.abort();
+    externalSignal?.addEventListener("abort", onExternalAbort, { once: true });
+    const timer = setTimeout(() => {
+      controller.abort(new OrakleTimeoutError(timeoutMs));
+    }, timeoutMs);
+    try {
+      const job = await this.submitJob(params, controller.signal);
+      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;
+      const stream = createSSEStream({
+        url: streamUrl,
+        headers: this.defaultHeaders(),
+        signal: controller.signal
+      });
+      for await (const frame of stream) {
+        const event = this.parseJobEvent(frame.event, frame.data);
+        if (!event) continue;
+        switch (event.event_type) {
+          case "stage":
+            options?.onProgress?.(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");
+    } catch (err) {
+      throw this.normalizeError(err);
+    } finally {
+      clearTimeout(timer);
+      externalSignal?.removeEventListener("abort", onExternalAbort);
+    }
+  }
+  /**
+   * Submit a pricing job and return an async iterable of all events.
+   *
+   * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.
+   */
+  async *priceCheckStream(params, options) {
+    const timeoutMs = options?.timeout ?? this.timeout;
+    const controller = new AbortController();
+    const externalSignal = options?.signal;
+    const onExternalAbort = () => controller.abort();
+    externalSignal?.addEventListener("abort", onExternalAbort, { once: true });
+    const timer = setTimeout(() => {
+      controller.abort(new OrakleTimeoutError(timeoutMs));
+    }, timeoutMs);
+    try {
+      const job = await this.submitJob(params, controller.signal);
+      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;
+      const stream = createSSEStream({
+        url: streamUrl,
+        headers: this.defaultHeaders(),
+        signal: controller.signal
+      });
+      for await (const frame of stream) {
+        const event = this.parseJobEvent(frame.event, frame.data);
+        if (!event) continue;
+        if (event.event_type === "stage") {
+          options?.onProgress?.(event);
+        }
+        yield event;
+        if (event.event_type === "completed" || event.event_type === "failed") {
+          return;
+        }
+      }
+    } catch (err) {
+      throw this.normalizeError(err);
+    } finally {
+      clearTimeout(timer);
+      externalSignal?.removeEventListener("abort", onExternalAbort);
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Private helpers
+  // ---------------------------------------------------------------------------
+  async submitJob(params, signal) {
+    let response;
+    try {
+      response = await fetch(`${this.baseUrl}/v1/jobs`, {
+        method: "POST",
+        headers: {
+          ...this.defaultHeaders(),
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(params),
+        signal
+      });
+    } catch (err) {
+      if (err instanceof DOMException && err.name === "AbortError") {
+        throw err;
+      }
+      throw new OrakleConnectionError(
+        "Failed to connect to Orakle API",
+        err
+      );
+    }
+    if (!response.ok) {
+      throw await this.buildApiError(response);
+    }
+    return await response.json();
+  }
+  defaultHeaders() {
+    return {
+      "X-Orakle-API-Key": this.apiKey
+    };
+  }
+  parseJobEvent(eventType, data) {
+    try {
+      const parsed = JSON.parse(data);
+      if (typeof parsed !== "object" || parsed === null) return void 0;
+      switch (eventType) {
+        case "stage":
+          return { ...parsed, event_type: "stage" };
+        case "completed":
+          return { ...parsed, event_type: "completed" };
+        case "failed":
+          return { ...parsed, event_type: "failed" };
+        default:
+          return void 0;
+      }
+    } catch {
+      return void 0;
+    }
+  }
+  async buildApiError(response) {
+    let body;
+    try {
+      body = await response.json();
+    } catch {
+    }
+    const code = body?.code ?? this.httpStatusToErrorCode(response.status);
+    const message = body?.message ?? `API request failed with status ${response.status}`;
+    return new OrakleApiError(message, response.status, code);
+  }
+  httpStatusToErrorCode(status) {
+    switch (status) {
+      case 400:
+        return "invalid_request";
+      case 401:
+        return "auth_required";
+      case 429:
+        return "rate_limited";
+      case 404:
+        return "job_not_found";
+      case 503:
+        return "service_unavailable";
+      default:
+        return "internal_error";
+    }
+  }
+  normalizeError(err) {
+    if (err instanceof OrakleError) {
+      return err;
+    }
+    if (err instanceof SSEHttpError) {
+      let body;
+      try {
+        body = JSON.parse(err.body);
+      } catch {
+      }
+      const code = body?.code ?? this.httpStatusToErrorCode(err.status);
+      const message = body?.message ?? `API request failed with status ${err.status}`;
+      return new OrakleApiError(message, err.status, code);
+    }
+    if (err instanceof DOMException && err.name === "AbortError") {
+      return new OrakleTimeoutError(this.timeout);
+    }
+    if (err instanceof Error) {
+      return new OrakleConnectionError(err.message, err);
+    }
+    return new OrakleConnectionError(String(err));
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OrakleApiError,
+  OrakleClient,
+  OrakleConnectionError,
+  OrakleError,
+  OrakleTimeoutError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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"]}

package/dist/index.d.cts

@@ -0,0 +1,174 @@
+/**
+ * Type definitions mirroring the Orakle backend models.
+ */
+interface OrakleConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+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 ProductProfile {
+    category: string;
+    make: string;
+    model: string;
+    storage?: string | null;
+    condition?: string | null;
+    carrier?: string | null;
+    carrier_lock?: string | null;
+    color?: string | null;
+    geography?: Geography;
+    region?: string | null;
+    key_value_drivers?: string[];
+    missing_attributes?: string[];
+}
+interface DistributionComponent {
+    weight: number;
+    mean: number;
+    std_dev: number;
+    label?: string | null;
+}
+interface PriceDistribution {
+    quantiles: Record<string, number>;
+    components?: DistributionComponent[] | null;
+    currency?: string;
+}
+interface ScenarioSource {
+    platform: string;
+    contract_id?: string | null;
+    url?: string | null;
+}
+interface Scenario {
+    name: string;
+    description: string;
+    probability: number;
+    price_impact: number;
+    sources?: ScenarioSource[];
+}
+interface ScenarioForecast {
+    scenarios: Scenario[];
+    base_price: number;
+    weighted_expected_price: number;
+}
+interface NLJobRequest {
+    request_type: "nl";
+    query: string;
+    geography?: Geography;
+    webhook_url?: string | null;
+}
+interface StructuredJobRequest {
+    request_type: "structured";
+    product: ProductProfile;
+    geography?: Geography;
+    webhook_url?: string | null;
+}
+type JobRequest = NLJobRequest | StructuredJobRequest;
+interface PriceCheckResult {
+    product_profile: ProductProfile;
+    fused_distribution: PriceDistribution;
+    scenario_forecast?: ScenarioForecast | null;
+}
+interface JobSubmitResponse {
+    job_id: string;
+    status: JobStatus;
+    poll_url: string;
+    estimated_seconds: number;
+}
+interface StageEvent {
+    event_type: "stage";
+    job_id: string;
+    stage: PipelineStage;
+    message: string;
+    timestamp: string;
+}
+interface CompletedEvent {
+    event_type: "completed";
+    job_id: string;
+    result: PriceCheckResult;
+    message?: string;
+    timestamp: string;
+}
+interface FailedEvent {
+    event_type: "failed";
+    job_id: string;
+    error: string;
+    message?: string;
+    timestamp: string;
+}
+type JobEvent = StageEvent | CompletedEvent | FailedEvent;
+interface PriceCheckOptions {
+    signal?: AbortSignal;
+    timeout?: number;
+    onProgress?: (event: StageEvent) => void;
+}
+interface ApiErrorBody {
+    code: ErrorCode;
+    message: string;
+    status: number;
+}
+
+/**
+ * OrakleClient — main entry point for the Orakle TypeScript SDK.
+ *
+ * Usage:
+ *   const client = new OrakleClient({ apiKey: "..." });
+ *   const result = await client.priceCheck({ query: "iPhone 15 Pro 256GB" });
+ */
+
+declare class OrakleClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(config: OrakleConfig);
+    /**
+     * Submit a pricing job and wait for the result.
+     *
+     * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.
+     */
+    priceCheck(params: JobRequest, options?: PriceCheckOptions): Promise<PriceCheckResult>;
+    /**
+     * Submit a pricing job and return an async iterable of all events.
+     *
+     * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.
+     */
+    priceCheckStream(params: JobRequest, options?: PriceCheckOptions): AsyncGenerator<JobEvent>;
+    private submitJob;
+    private defaultHeaders;
+    private parseJobEvent;
+    private buildApiError;
+    private httpStatusToErrorCode;
+    private normalizeError;
+}
+
+/**
+ * Base error for all Orakle SDK errors.
+ */
+declare class OrakleError extends Error {
+    constructor(message: string);
+}
+/**
+ * HTTP API error with status code and typed error code.
+ */
+declare class OrakleApiError extends OrakleError {
+    readonly status: number;
+    readonly code: ErrorCode;
+    constructor(message: string, status: number, code: ErrorCode);
+}
+/**
+ * Timeout error — request or SSE stream exceeded the configured timeout.
+ */
+declare class OrakleTimeoutError extends OrakleError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/**
+ * Connection error — network failure, DNS resolution failure, etc.
+ */
+declare class OrakleConnectionError extends OrakleError {
+    readonly cause?: unknown;
+    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 };

package/dist/index.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Type definitions mirroring the Orakle backend models.
+ */
+interface OrakleConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+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 ProductProfile {
+    category: string;
+    make: string;
+    model: string;
+    storage?: string | null;
+    condition?: string | null;
+    carrier?: string | null;
+    carrier_lock?: string | null;
+    color?: string | null;
+    geography?: Geography;
+    region?: string | null;
+    key_value_drivers?: string[];
+    missing_attributes?: string[];
+}
+interface DistributionComponent {
+    weight: number;
+    mean: number;
+    std_dev: number;
+    label?: string | null;
+}
+interface PriceDistribution {
+    quantiles: Record<string, number>;
+    components?: DistributionComponent[] | null;
+    currency?: string;
+}
+interface ScenarioSource {
+    platform: string;
+    contract_id?: string | null;
+    url?: string | null;
+}
+interface Scenario {
+    name: string;
+    description: string;
+    probability: number;
+    price_impact: number;
+    sources?: ScenarioSource[];
+}
+interface ScenarioForecast {
+    scenarios: Scenario[];
+    base_price: number;
+    weighted_expected_price: number;
+}
+interface NLJobRequest {
+    request_type: "nl";
+    query: string;
+    geography?: Geography;
+    webhook_url?: string | null;
+}
+interface StructuredJobRequest {
+    request_type: "structured";
+    product: ProductProfile;
+    geography?: Geography;
+    webhook_url?: string | null;
+}
+type JobRequest = NLJobRequest | StructuredJobRequest;
+interface PriceCheckResult {
+    product_profile: ProductProfile;
+    fused_distribution: PriceDistribution;
+    scenario_forecast?: ScenarioForecast | null;
+}
+interface JobSubmitResponse {
+    job_id: string;
+    status: JobStatus;
+    poll_url: string;
+    estimated_seconds: number;
+}
+interface StageEvent {
+    event_type: "stage";
+    job_id: string;
+    stage: PipelineStage;
+    message: string;
+    timestamp: string;
+}
+interface CompletedEvent {
+    event_type: "completed";
+    job_id: string;
+    result: PriceCheckResult;
+    message?: string;
+    timestamp: string;
+}
+interface FailedEvent {
+    event_type: "failed";
+    job_id: string;
+    error: string;
+    message?: string;
+    timestamp: string;
+}
+type JobEvent = StageEvent | CompletedEvent | FailedEvent;
+interface PriceCheckOptions {
+    signal?: AbortSignal;
+    timeout?: number;
+    onProgress?: (event: StageEvent) => void;
+}
+interface ApiErrorBody {
+    code: ErrorCode;
+    message: string;
+    status: number;
+}
+
+/**
+ * OrakleClient — main entry point for the Orakle TypeScript SDK.
+ *
+ * Usage:
+ *   const client = new OrakleClient({ apiKey: "..." });
+ *   const result = await client.priceCheck({ query: "iPhone 15 Pro 256GB" });
+ */
+
+declare class OrakleClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeout;
+    constructor(config: OrakleConfig);
+    /**
+     * Submit a pricing job and wait for the result.
+     *
+     * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.
+     */
+    priceCheck(params: JobRequest, options?: PriceCheckOptions): Promise<PriceCheckResult>;
+    /**
+     * Submit a pricing job and return an async iterable of all events.
+     *
+     * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.
+     */
+    priceCheckStream(params: JobRequest, options?: PriceCheckOptions): AsyncGenerator<JobEvent>;
+    private submitJob;
+    private defaultHeaders;
+    private parseJobEvent;
+    private buildApiError;
+    private httpStatusToErrorCode;
+    private normalizeError;
+}
+
+/**
+ * Base error for all Orakle SDK errors.
+ */
+declare class OrakleError extends Error {
+    constructor(message: string);
+}
+/**
+ * HTTP API error with status code and typed error code.
+ */
+declare class OrakleApiError extends OrakleError {
+    readonly status: number;
+    readonly code: ErrorCode;
+    constructor(message: string, status: number, code: ErrorCode);
+}
+/**
+ * Timeout error — request or SSE stream exceeded the configured timeout.
+ */
+declare class OrakleTimeoutError extends OrakleError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/**
+ * Connection error — network failure, DNS resolution failure, etc.
+ */
+declare class OrakleConnectionError extends OrakleError {
+    readonly cause?: unknown;
+    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 };

package/dist/index.js

@@ -0,0 +1,409 @@
+// src/errors.ts
+var OrakleError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "OrakleError";
+  }
+};
+var OrakleApiError = class extends OrakleError {
+  status;
+  code;
+  constructor(message, status, code) {
+    super(message);
+    this.name = "OrakleApiError";
+    this.status = status;
+    this.code = code;
+  }
+};
+var OrakleTimeoutError = class extends OrakleError {
+  timeoutMs;
+  constructor(timeoutMs) {
+    super(`Request timed out after ${timeoutMs}ms`);
+    this.name = "OrakleTimeoutError";
+    this.timeoutMs = timeoutMs;
+  }
+};
+var OrakleConnectionError = class extends OrakleError {
+  cause;
+  constructor(message, cause) {
+    super(message);
+    this.name = "OrakleConnectionError";
+    this.cause = cause;
+  }
+};
+
+// src/sse.ts
+var createSSEStream = async function* (options) {
+  const { url, headers, signal, lastEventId } = options;
+  const requestHeaders = {
+    ...headers,
+    Accept: "text/event-stream",
+    "Cache-Control": "no-cache"
+  };
+  if (lastEventId) {
+    requestHeaders["Last-Event-Id"] = lastEventId;
+  }
+  let response;
+  try {
+    response = await fetch(url, {
+      method: "GET",
+      headers: requestHeaders,
+      signal
+    });
+  } catch (err) {
+    if (err instanceof DOMException && err.name === "AbortError") {
+      throw err;
+    }
+    throw new OrakleConnectionError(
+      `Failed to connect to SSE stream: ${url}`,
+      err
+    );
+  }
+  if (!response.ok) {
+    const body2 = await response.text();
+    throw new SSEHttpError(response.status, body2);
+  }
+  const body = response.body;
+  if (!body) {
+    throw new OrakleConnectionError("Response body is null");
+  }
+  yield* parseSSEBody(body, signal);
+};
+var parseSSEBody = async function* (body, signal) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let currentEvent = "";
+  let currentId = "";
+  let currentData = [];
+  const readOrAbort = () => {
+    if (signal?.aborted) {
+      return Promise.reject(signal.reason ?? new DOMException("Aborted", "AbortError"));
+    }
+    return new Promise((resolve, reject) => {
+      const onAbort = () => {
+        reject(signal?.reason ?? new DOMException("Aborted", "AbortError"));
+      };
+      signal?.addEventListener("abort", onAbort, { once: true });
+      reader.read().then(
+        (result) => {
+          signal?.removeEventListener("abort", onAbort);
+          resolve(result);
+        },
+        (err) => {
+          signal?.removeEventListener("abort", onAbort);
+          reject(err);
+        }
+      );
+    });
+  };
+  try {
+    while (true) {
+      if (signal?.aborted) {
+        break;
+      }
+      const { done, value } = await readOrAbort();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        if (line === "") {
+          if (currentData.length > 0) {
+            yield {
+              event: currentEvent ?? "message",
+              id: currentId,
+              data: currentData.join("\n")
+            };
+          }
+          currentEvent = "";
+          currentId = "";
+          currentData = [];
+          continue;
+        }
+        if (line.startsWith(":")) {
+          continue;
+        }
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1) {
+          continue;
+        }
+        const field = line.slice(0, colonIdx);
+        let value_ = line.slice(colonIdx + 1);
+        if (value_.startsWith(" ")) {
+          value_ = value_.slice(1);
+        }
+        switch (field) {
+          case "event":
+            currentEvent = value_;
+            break;
+          case "id":
+            currentId = value_;
+            break;
+          case "data":
+            currentData.push(value_);
+            break;
+          case "retry":
+            break;
+        }
+      }
+    }
+    if (buffer !== "") {
+      const lines = buffer.split("\n");
+      for (const line of lines) {
+        if (line === "" && currentData.length > 0) {
+          yield {
+            event: currentEvent ?? "message",
+            id: currentId,
+            data: currentData.join("\n")
+          };
+          currentEvent = "";
+          currentId = "";
+          currentData = [];
+          continue;
+        }
+        if (line.startsWith(":") || line === "") continue;
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1) continue;
+        const field = line.slice(0, colonIdx);
+        let value_ = line.slice(colonIdx + 1);
+        if (value_.startsWith(" ")) value_ = value_.slice(1);
+        switch (field) {
+          case "event":
+            currentEvent = value_;
+            break;
+          case "id":
+            currentId = value_;
+            break;
+          case "data":
+            currentData.push(value_);
+            break;
+        }
+      }
+      if (currentData.length > 0) {
+        yield {
+          event: currentEvent ?? "message",
+          id: currentId,
+          data: currentData.join("\n")
+        };
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+};
+var SSEHttpError = class extends Error {
+  status;
+  body;
+  constructor(status, body) {
+    super(`SSE request failed with status ${status}`);
+    this.name = "SSEHttpError";
+    this.status = status;
+    this.body = body;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.orakle.xyz";
+var DEFAULT_TIMEOUT_MS = 18e4;
+var OrakleClient = class {
+  apiKey;
+  baseUrl;
+  timeout;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
+  }
+  /**
+   * Submit a pricing job and wait for the result.
+   *
+   * Internally: POST /v1/jobs -> open SSE stream -> resolve on completed, reject on failed.
+   */
+  async priceCheck(params, options) {
+    const timeoutMs = options?.timeout ?? this.timeout;
+    const controller = new AbortController();
+    const externalSignal = options?.signal;
+    const onExternalAbort = () => controller.abort();
+    externalSignal?.addEventListener("abort", onExternalAbort, { once: true });
+    const timer = setTimeout(() => {
+      controller.abort(new OrakleTimeoutError(timeoutMs));
+    }, timeoutMs);
+    try {
+      const job = await this.submitJob(params, controller.signal);
+      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;
+      const stream = createSSEStream({
+        url: streamUrl,
+        headers: this.defaultHeaders(),
+        signal: controller.signal
+      });
+      for await (const frame of stream) {
+        const event = this.parseJobEvent(frame.event, frame.data);
+        if (!event) continue;
+        switch (event.event_type) {
+          case "stage":
+            options?.onProgress?.(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");
+    } catch (err) {
+      throw this.normalizeError(err);
+    } finally {
+      clearTimeout(timer);
+      externalSignal?.removeEventListener("abort", onExternalAbort);
+    }
+  }
+  /**
+   * Submit a pricing job and return an async iterable of all events.
+   *
+   * Yields StageEvent and CompletedEvent/FailedEvent as they arrive.
+   */
+  async *priceCheckStream(params, options) {
+    const timeoutMs = options?.timeout ?? this.timeout;
+    const controller = new AbortController();
+    const externalSignal = options?.signal;
+    const onExternalAbort = () => controller.abort();
+    externalSignal?.addEventListener("abort", onExternalAbort, { once: true });
+    const timer = setTimeout(() => {
+      controller.abort(new OrakleTimeoutError(timeoutMs));
+    }, timeoutMs);
+    try {
+      const job = await this.submitJob(params, controller.signal);
+      const streamUrl = `${this.baseUrl}/v1/jobs/${job.job_id}/stream`;
+      const stream = createSSEStream({
+        url: streamUrl,
+        headers: this.defaultHeaders(),
+        signal: controller.signal
+      });
+      for await (const frame of stream) {
+        const event = this.parseJobEvent(frame.event, frame.data);
+        if (!event) continue;
+        if (event.event_type === "stage") {
+          options?.onProgress?.(event);
+        }
+        yield event;
+        if (event.event_type === "completed" || event.event_type === "failed") {
+          return;
+        }
+      }
+    } catch (err) {
+      throw this.normalizeError(err);
+    } finally {
+      clearTimeout(timer);
+      externalSignal?.removeEventListener("abort", onExternalAbort);
+    }
+  }
+  // ---------------------------------------------------------------------------
+  // Private helpers
+  // ---------------------------------------------------------------------------
+  async submitJob(params, signal) {
+    let response;
+    try {
+      response = await fetch(`${this.baseUrl}/v1/jobs`, {
+        method: "POST",
+        headers: {
+          ...this.defaultHeaders(),
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(params),
+        signal
+      });
+    } catch (err) {
+      if (err instanceof DOMException && err.name === "AbortError") {
+        throw err;
+      }
+      throw new OrakleConnectionError(
+        "Failed to connect to Orakle API",
+        err
+      );
+    }
+    if (!response.ok) {
+      throw await this.buildApiError(response);
+    }
+    return await response.json();
+  }
+  defaultHeaders() {
+    return {
+      "X-Orakle-API-Key": this.apiKey
+    };
+  }
+  parseJobEvent(eventType, data) {
+    try {
+      const parsed = JSON.parse(data);
+      if (typeof parsed !== "object" || parsed === null) return void 0;
+      switch (eventType) {
+        case "stage":
+          return { ...parsed, event_type: "stage" };
+        case "completed":
+          return { ...parsed, event_type: "completed" };
+        case "failed":
+          return { ...parsed, event_type: "failed" };
+        default:
+          return void 0;
+      }
+    } catch {
+      return void 0;
+    }
+  }
+  async buildApiError(response) {
+    let body;
+    try {
+      body = await response.json();
+    } catch {
+    }
+    const code = body?.code ?? this.httpStatusToErrorCode(response.status);
+    const message = body?.message ?? `API request failed with status ${response.status}`;
+    return new OrakleApiError(message, response.status, code);
+  }
+  httpStatusToErrorCode(status) {
+    switch (status) {
+      case 400:
+        return "invalid_request";
+      case 401:
+        return "auth_required";
+      case 429:
+        return "rate_limited";
+      case 404:
+        return "job_not_found";
+      case 503:
+        return "service_unavailable";
+      default:
+        return "internal_error";
+    }
+  }
+  normalizeError(err) {
+    if (err instanceof OrakleError) {
+      return err;
+    }
+    if (err instanceof SSEHttpError) {
+      let body;
+      try {
+        body = JSON.parse(err.body);
+      } catch {
+      }
+      const code = body?.code ?? this.httpStatusToErrorCode(err.status);
+      const message = body?.message ?? `API request failed with status ${err.status}`;
+      return new OrakleApiError(message, err.status, code);
+    }
+    if (err instanceof DOMException && err.name === "AbortError") {
+      return new OrakleTimeoutError(this.timeout);
+    }
+    if (err instanceof Error) {
+      return new OrakleConnectionError(err.message, err);
+    }
+    return new OrakleConnectionError(String(err));
+  }
+};
+export {
+  OrakleApiError,
+  OrakleClient,
+  OrakleConnectionError,
+  OrakleError,
+  OrakleTimeoutError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "orakle",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Client SDK for orakle.xyz",
-  "license": "Apache-2.0"
-}
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^22.15.3",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}