@dvina/sdk 3.3.124

package/dist/chunk-UELAE75E.cjs

@@ -0,0 +1,408 @@
+'use strict';
+
+var chunkKV5SP7RP_cjs = require('./chunk-KV5SP7RP.cjs');
+
+// src/inference/errors.ts
+var DvinaInferenceError = class extends chunkKV5SP7RP_cjs.DvinaError {
+  /** HTTP status code from the server */
+  status;
+  /** OpenAI-compatible error type (e.g. 'invalid_request_error') */
+  type;
+  /** Machine-readable error code (e.g. 'model_not_found') */
+  code;
+  constructor(message, status, type, code, cause) {
+    super(message, cause);
+    this.name = "DvinaInferenceError";
+    this.status = status;
+    this.type = type;
+    this.code = code;
+  }
+};
+var DvinaRateLimitError = class extends DvinaInferenceError {
+  /** Retry-After header value in seconds, if provided by the server */
+  retryAfter;
+  constructor(message, retryAfter, cause) {
+    super(message, 429, "rate_limit_error", "rate_limit_exceeded", cause);
+    this.name = "DvinaRateLimitError";
+    this.retryAfter = retryAfter;
+  }
+};
+var DvinaQuotaError = class extends DvinaInferenceError {
+  constructor(message = "Token quota exceeded", cause) {
+    super(message, 403, "insufficient_quota", "token_limit_reached", cause);
+    this.name = "DvinaQuotaError";
+  }
+};
+var DvinaInferenceAuthError = class extends DvinaInferenceError {
+  constructor(message = "Inference authentication failed", status = 401, cause) {
+    super(message, status, "authentication_error", "unauthorized", cause);
+    this.name = "DvinaInferenceAuthError";
+  }
+};
+var DvinaStreamError = class extends DvinaInferenceError {
+  constructor(message, cause) {
+    super(message, 0, "stream_error", "stream_interrupted", cause);
+    this.name = "DvinaStreamError";
+  }
+};
+var DvinaContextLengthError = class extends DvinaInferenceError {
+  constructor(message = "Context length exceeded", cause) {
+    super(message, 400, "invalid_request_error", "context_length_exceeded", cause);
+    this.name = "DvinaContextLengthError";
+  }
+};
+var DvinaTimeoutError = class extends DvinaInferenceError {
+  constructor(message = "Request timed out", cause) {
+    super(message, 400, "timeout_error", "request_timeout", cause);
+    this.name = "DvinaTimeoutError";
+  }
+};
+var DvinaProviderUnavailableError = class extends DvinaInferenceError {
+  constructor(message = "Provider unavailable", cause) {
+    super(message, 502, "gateway_error", "provider_unavailable", cause);
+    this.name = "DvinaProviderUnavailableError";
+  }
+};
+var DvinaProviderError = class extends DvinaInferenceError {
+  constructor(message = "Provider error", status = 502, cause) {
+    super(message, status, "api_error", "provider_error", cause);
+    this.name = "DvinaProviderError";
+  }
+};
+var DvinaDeploymentError = class extends DvinaInferenceError {
+  constructor(message = "Deployment not found", cause) {
+    super(message, 502, "invalid_request_error", "deployment_not_found", cause);
+    this.name = "DvinaDeploymentError";
+  }
+};
+var DvinaUnsupportedModelError = class extends DvinaInferenceError {
+  constructor(message = "Unsupported model", cause) {
+    super(message, 400, "invalid_request_error", "unsupported_model", cause);
+    this.name = "DvinaUnsupportedModelError";
+  }
+};
+
+// src/inference/stream.ts
+async function* parseSSEStream(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        if (buffer.trim()) {
+          const chunk = parseDataLine(buffer.trim());
+          if (chunk !== void 0) {
+            yield chunk;
+          }
+        }
+        break;
+      }
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split(/\r?\n/);
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        if (line === "") continue;
+        if (line.startsWith(":")) continue;
+        if (line.startsWith("data: ")) {
+          const data = line.slice(6);
+          if (data === "[DONE]") {
+            return;
+          }
+          try {
+            const parsed = JSON.parse(data);
+            yield parsed;
+          } catch {
+          }
+        }
+        if (line.startsWith("event: error")) {
+        }
+      }
+    }
+  } catch (error) {
+    throw new DvinaStreamError(
+      `SSE stream interrupted: ${error instanceof Error ? error.message : String(error)}`,
+      error instanceof Error ? error : void 0
+    );
+  } finally {
+    reader.releaseLock();
+  }
+}
+function parseDataLine(line) {
+  if (!line.startsWith("data: ")) return void 0;
+  const data = line.slice(6);
+  if (data === "[DONE]") return void 0;
+  try {
+    return JSON.parse(data);
+  } catch {
+    return void 0;
+  }
+}
+var ChatCompletionStream = class {
+  _chunks = [];
+  _source;
+  _consumed = false;
+  constructor(source) {
+    this._source = source;
+  }
+  async *[Symbol.asyncIterator]() {
+    if (this._consumed) {
+      for (const chunk of this._chunks) {
+        yield chunk;
+      }
+      return;
+    }
+    this._consumed = true;
+    for await (const chunk of this._source) {
+      this._chunks.push(chunk);
+      yield chunk;
+    }
+  }
+  /**
+   * Concatenate all content deltas into a single string.
+   * Must be called after the stream has been fully consumed.
+   */
+  getText() {
+    const parts = [];
+    for (const chunk of this._chunks) {
+      const content = chunk.choices[0]?.delta?.content;
+      if (content) {
+        parts.push(content);
+      }
+    }
+    return parts.join("");
+  }
+  /**
+   * Get the token usage from the final chunk (if the server included it).
+   * Must be called after the stream has been fully consumed.
+   */
+  getUsage() {
+    for (let i = this._chunks.length - 1; i >= 0; i--) {
+      if (this._chunks[i].usage) {
+        return this._chunks[i].usage;
+      }
+    }
+    return void 0;
+  }
+  /**
+   * Get the collected chunks array.
+   * Must be called after the stream has been fully consumed.
+   */
+  getChunks() {
+    return this._chunks;
+  }
+};
+
+// src/inference/client.ts
+var DEFAULT_TIMEOUT_MS = 12e4;
+async function throwForStatus(response) {
+  let errorBody;
+  try {
+    errorBody = await response.json();
+  } catch {
+  }
+  const message = errorBody?.error?.message ?? `HTTP ${response.status}: ${response.statusText}`;
+  const type = errorBody?.error?.type ?? "api_error";
+  const code = errorBody?.error?.code ?? "unknown";
+  if (response.status === 401 || response.status === 403) {
+    if (code === "token_limit_reached" || type === "insufficient_quota") {
+      throw new DvinaQuotaError(message);
+    }
+    throw new DvinaInferenceAuthError(message, response.status);
+  }
+  if (response.status === 429) {
+    const retryAfterHeader = response.headers.get("retry-after");
+    const retryAfter = retryAfterHeader ? parseInt(retryAfterHeader, 10) : void 0;
+    throw new DvinaRateLimitError(message, Number.isNaN(retryAfter) ? void 0 : retryAfter);
+  }
+  switch (code) {
+    case "context_length_exceeded":
+      throw new DvinaContextLengthError(message);
+    case "request_timeout":
+      throw new DvinaTimeoutError(message);
+    case "provider_unavailable":
+      throw new DvinaProviderUnavailableError(message);
+    case "provider_error":
+      throw new DvinaProviderError(message, response.status);
+    case "deployment_not_found":
+      throw new DvinaDeploymentError(message);
+    case "unsupported_model":
+      throw new DvinaUnsupportedModelError(message);
+  }
+  throw new DvinaInferenceError(message, response.status, type, code);
+}
+function createInferenceClientInternal(baseUrl, getToken, options) {
+  return buildInferenceClient(baseUrl, getToken, options?.headers, options?.timeout);
+}
+function createInferenceClient(options) {
+  const baseUrl = options.baseUrl.replace(/\/+$/, "");
+  let getToken;
+  if (options.getToken) {
+    getToken = options.getToken;
+  } else if (options.token) {
+    const staticToken = options.token;
+    getToken = async () => staticToken;
+  } else {
+    throw new Error("InferenceClientOptions must provide either `token` or `getToken`.");
+  }
+  return buildInferenceClient(baseUrl, getToken, options.headers, options.timeout);
+}
+function buildInferenceClient(baseUrl, getToken, customHeaders, timeout) {
+  const timeoutMs = timeout ?? DEFAULT_TIMEOUT_MS;
+  const headers = customHeaders ?? {};
+  async function buildRequestHeaders() {
+    const token = await getToken();
+    return {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`,
+      ...headers
+    };
+  }
+  async function request(method, path, body) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const reqHeaders = await buildRequestHeaders();
+      const response = await fetch(`${baseUrl}${path}`, {
+        method,
+        headers: reqHeaders,
+        body: body !== void 0 ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        await throwForStatus(response);
+      }
+      return await response.json();
+    } catch (error) {
+      if (error instanceof DvinaInferenceError) throw error;
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new DvinaInferenceError(
+          `Request timed out after ${timeoutMs}ms`,
+          0,
+          "timeout_error",
+          "request_timeout"
+        );
+      }
+      throw new DvinaInferenceError(
+        `Network error: ${error instanceof Error ? error.message : String(error)}`,
+        0,
+        "network_error",
+        "connection_failed",
+        error instanceof Error ? error : void 0
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  async function requestStream(path, body) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const reqHeaders = await buildRequestHeaders();
+      const response = await fetch(`${baseUrl}${path}`, {
+        method: "POST",
+        headers: reqHeaders,
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+      clearTimeout(timer);
+      if (!response.ok) {
+        await throwForStatus(response);
+      }
+      if (!response.body) {
+        throw new DvinaStreamError("Response body is null \u2014 streaming not supported in this environment");
+      }
+      return response.body;
+    } catch (error) {
+      clearTimeout(timer);
+      if (error instanceof DvinaInferenceError) throw error;
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new DvinaInferenceError(
+          `Stream connection timed out after ${timeoutMs}ms`,
+          0,
+          "timeout_error",
+          "request_timeout"
+        );
+      }
+      throw new DvinaInferenceError(
+        `Network error: ${error instanceof Error ? error.message : String(error)}`,
+        0,
+        "network_error",
+        "connection_failed",
+        error instanceof Error ? error : void 0
+      );
+    }
+  }
+  const completions = {
+    async create(req) {
+      return request("POST", "/chat/completions", {
+        ...req,
+        stream: false
+      });
+    },
+    async stream(req) {
+      const body = await requestStream("/chat/completions", {
+        ...req,
+        stream: true
+      });
+      const source = parseSSEStream(body);
+      return new ChatCompletionStream(source);
+    }
+  };
+  const chat = { completions };
+  const responses = {
+    async create(req) {
+      return request("POST", "/responses", {
+        ...req,
+        stream: false
+      });
+    },
+    async stream(req) {
+      const body = await requestStream("/responses", {
+        ...req,
+        stream: true
+      });
+      return {
+        [Symbol.asyncIterator]() {
+          return parseSSEStream(body);
+        }
+      };
+    }
+  };
+  const models = {
+    async list() {
+      return request("GET", "/models");
+    },
+    async get(modelId) {
+      return request("GET", `/models/${encodeURIComponent(modelId)}`);
+    }
+  };
+  async function health() {
+    return request("GET", "/health");
+  }
+  return {
+    chat,
+    responses,
+    models,
+    health
+  };
+}
+
+exports.ChatCompletionStream = ChatCompletionStream;
+exports.DvinaContextLengthError = DvinaContextLengthError;
+exports.DvinaDeploymentError = DvinaDeploymentError;
+exports.DvinaInferenceAuthError = DvinaInferenceAuthError;
+exports.DvinaInferenceError = DvinaInferenceError;
+exports.DvinaProviderError = DvinaProviderError;
+exports.DvinaProviderUnavailableError = DvinaProviderUnavailableError;
+exports.DvinaQuotaError = DvinaQuotaError;
+exports.DvinaRateLimitError = DvinaRateLimitError;
+exports.DvinaStreamError = DvinaStreamError;
+exports.DvinaTimeoutError = DvinaTimeoutError;
+exports.DvinaUnsupportedModelError = DvinaUnsupportedModelError;
+exports.createInferenceClient = createInferenceClient;
+exports.createInferenceClientInternal = createInferenceClientInternal;
+exports.parseSSEStream = parseSSEStream;
+//# sourceMappingURL=chunk-UELAE75E.cjs.map
+//# sourceMappingURL=chunk-UELAE75E.cjs.map

package/dist/chunk-UELAE75E.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/inference/errors.ts","../src/inference/stream.ts","../src/inference/client.ts"],"names":["DvinaError"],"mappings":"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","file":"chunk-UELAE75E.cjs","sourcesContent":["import { DvinaError } from '../error.js';\n\n/**\n * Base error class for inference API errors.\n * Contains the OpenAI-compatible error shape returned by the server.\n */\nexport class DvinaInferenceError extends DvinaError {\n\t/** HTTP status code from the server */\n\tpublic readonly status: number;\n\t/** OpenAI-compatible error type (e.g. 'invalid_request_error') */\n\tpublic readonly type: string;\n\t/** Machine-readable error code (e.g. 'model_not_found') */\n\tpublic readonly code: string;\n\n\tconstructor(message: string, status: number, type: string, code: string, cause?: Error) {\n\t\tsuper(message, cause);\n\t\tthis.name = 'DvinaInferenceError';\n\t\tthis.status = status;\n\t\tthis.type = type;\n\t\tthis.code = code;\n\t}\n}\n\n/**\n * Error thrown when the inference API returns 429 (rate limited).\n */\nexport class DvinaRateLimitError extends DvinaInferenceError {\n\t/** Retry-After header value in seconds, if provided by the server */\n\tpublic readonly retryAfter?: number;\n\n\tconstructor(message: string, retryAfter?: number, cause?: Error) {\n\t\tsuper(message, 429, 'rate_limit_error', 'rate_limit_exceeded', cause);\n\t\tthis.name = 'DvinaRateLimitError';\n\t\tthis.retryAfter = retryAfter;\n\t}\n}\n\n/**\n * Error thrown when the workspace token quota is exceeded (403 with code 'token_limit_reached').\n */\nexport class DvinaQuotaError extends DvinaInferenceError {\n\tconstructor(message = 'Token quota exceeded', cause?: Error) {\n\t\tsuper(message, 403, 'insufficient_quota', 'token_limit_reached', cause);\n\t\tthis.name = 'DvinaQuotaError';\n\t}\n}\n\n/**\n * Error thrown when inference API authentication fails (401/403).\n */\nexport class DvinaInferenceAuthError extends DvinaInferenceError {\n\tconstructor(message = 'Inference authentication failed', status = 401, cause?: Error) {\n\t\tsuper(message, status, 'authentication_error', 'unauthorized', cause);\n\t\tthis.name = 'DvinaInferenceAuthError';\n\t}\n}\n\n/**\n * Error thrown during an SSE stream when the connection drops or a mid-stream error occurs.\n */\nexport class DvinaStreamError extends DvinaInferenceError {\n\tconstructor(message: string, cause?: Error) {\n\t\tsuper(message, 0, 'stream_error', 'stream_interrupted', cause);\n\t\tthis.name = 'DvinaStreamError';\n\t}\n}\n\n/**\n * Error thrown when the prompt exceeds the model's context window (400, code 'context_length_exceeded').\n */\nexport class DvinaContextLengthError extends DvinaInferenceError {\n\tconstructor(message = 'Context length exceeded', cause?: Error) {\n\t\tsuper(message, 400, 'invalid_request_error', 'context_length_exceeded', cause);\n\t\tthis.name = 'DvinaContextLengthError';\n\t}\n}\n\n/**\n * Error thrown when the inference request times out (400, code 'request_timeout').\n */\nexport class DvinaTimeoutError extends DvinaInferenceError {\n\tconstructor(message = 'Request timed out', cause?: Error) {\n\t\tsuper(message, 400, 'timeout_error', 'request_timeout', cause);\n\t\tthis.name = 'DvinaTimeoutError';\n\t}\n}\n\n/**\n * Error thrown when the upstream provider is unreachable (502, code 'provider_unavailable').\n */\nexport class DvinaProviderUnavailableError extends DvinaInferenceError {\n\tconstructor(message = 'Provider unavailable', cause?: Error) {\n\t\tsuper(message, 502, 'gateway_error', 'provider_unavailable', cause);\n\t\tthis.name = 'DvinaProviderUnavailableError';\n\t}\n}\n\n/**\n * Error thrown when the upstream provider returns an error (502/400, code 'provider_error').\n */\nexport class DvinaProviderError extends DvinaInferenceError {\n\tconstructor(message = 'Provider error', status = 502, cause?: Error) {\n\t\tsuper(message, status, 'api_error', 'provider_error', cause);\n\t\tthis.name = 'DvinaProviderError';\n\t}\n}\n\n/**\n * Error thrown when a requested deployment is not found (502, code 'deployment_not_found').\n */\nexport class DvinaDeploymentError extends DvinaInferenceError {\n\tconstructor(message = 'Deployment not found', cause?: Error) {\n\t\tsuper(message, 502, 'invalid_request_error', 'deployment_not_found', cause);\n\t\tthis.name = 'DvinaDeploymentError';\n\t}\n}\n\n/**\n * Error thrown when a requested model is not supported (400, code 'unsupported_model').\n */\nexport class DvinaUnsupportedModelError extends DvinaInferenceError {\n\tconstructor(message = 'Unsupported model', cause?: Error) {\n\t\tsuper(message, 400, 'invalid_request_error', 'unsupported_model', cause);\n\t\tthis.name = 'DvinaUnsupportedModelError';\n\t}\n}\n","import { DvinaStreamError } from './errors.js';\nimport type { ChatCompletionChunk } from './types.js';\n\n/**\n * Parse a Server-Sent Events response body into an async iterable of typed chunks.\n *\n * Handles:\n * - Chunked network reads (buffer splitting across `data:` boundaries)\n * - `\\r\\n` and `\\n` line endings\n * - `data: [DONE]` termination signal\n * - Mid-stream errors (yields what it can, then throws)\n *\n * @param body - A ReadableStream<Uint8Array> from a fetch response\n * @returns An async iterable of parsed SSE data objects\n */\nexport async function* parseSSEStream<T = ChatCompletionChunk>(\n\tbody: ReadableStream<Uint8Array>,\n): AsyncGenerator<T, void, undefined> {\n\tconst reader = body.getReader();\n\tconst decoder = new TextDecoder();\n\tlet buffer = '';\n\n\ttry {\n\t\twhile (true) {\n\t\t\tconst { done, value } = await reader.read();\n\n\t\t\tif (done) {\n\t\t\t\t// Process any remaining buffer content before exiting\n\t\t\t\tif (buffer.trim()) {\n\t\t\t\t\tconst chunk = parseDataLine<T>(buffer.trim());\n\t\t\t\t\tif (chunk !== undefined) {\n\t\t\t\t\t\tyield chunk;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tbuffer += decoder.decode(value, { stream: true });\n\n\t\t\t// SSE events are separated by double newlines\n\t\t\tconst lines = buffer.split(/\\r?\\n/);\n\n\t\t\t// Keep the last incomplete line in the buffer\n\t\t\tbuffer = lines.pop() ?? '';\n\n\t\t\tfor (const line of lines) {\n\t\t\t\tif (line === '') continue;\n\t\t\t\tif (line.startsWith(':')) continue; // SSE comment\n\n\t\t\t\tif (line.startsWith('data: ')) {\n\t\t\t\t\tconst data = line.slice(6);\n\n\t\t\t\t\tif (data === '[DONE]') {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst parsed = JSON.parse(data) as T;\n\t\t\t\t\t\tyield parsed;\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Malformed JSON line — skip rather than crash the whole stream\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// Handle `event: error` style SSE events (used by Responses API)\n\t\t\t\tif (line.startsWith('event: error')) {\n\t\t\t\t\t// The next data line will contain the error payload.\n\t\t\t\t\t// We'll catch it in the next iteration of the data parsing.\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t} catch (error) {\n\t\tthrow new DvinaStreamError(\n\t\t\t`SSE stream interrupted: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t} finally {\n\t\treader.releaseLock();\n\t}\n}\n\n/**\n * Try to parse a single `data: ...` line value. Returns undefined for non-data or [DONE].\n */\nfunction parseDataLine<T>(line: string): T | undefined {\n\tif (!line.startsWith('data: ')) return undefined;\n\tconst data = line.slice(6);\n\tif (data === '[DONE]') return undefined;\n\ttry {\n\t\treturn JSON.parse(data) as T;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n/**\n * A chat completion stream that also aggregates the full response for convenience.\n *\n * Implements `AsyncIterable<ChatCompletionChunk>` for chunk-by-chunk processing,\n * and provides helper methods to extract the final assembled text and usage.\n *\n * @example\n * ```typescript\n * const stream = await client.chat.completions.stream({ ... });\n *\n * // Option 1: Iterate chunk by chunk\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk.choices[0]?.delta?.content ?? '');\n * }\n *\n * // Option 2: Get aggregated result after iteration\n * const text = stream.getText();\n * const usage = stream.getUsage();\n * ```\n */\nexport class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {\n\tprivate readonly _chunks: ChatCompletionChunk[] = [];\n\tprivate readonly _source: AsyncGenerator<ChatCompletionChunk, void, undefined>;\n\tprivate _consumed = false;\n\n\tconstructor(source: AsyncGenerator<ChatCompletionChunk, void, undefined>) {\n\t\tthis._source = source;\n\t}\n\n\tasync *[Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk> {\n\t\tif (this._consumed) {\n\t\t\t// Allow re-iteration over cached chunks\n\t\t\tfor (const chunk of this._chunks) {\n\t\t\t\tyield chunk;\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tthis._consumed = true;\n\t\tfor await (const chunk of this._source) {\n\t\t\tthis._chunks.push(chunk);\n\t\t\tyield chunk;\n\t\t}\n\t}\n\n\t/**\n\t * Concatenate all content deltas into a single string.\n\t * Must be called after the stream has been fully consumed.\n\t */\n\tgetText(): string {\n\t\tconst parts: string[] = [];\n\t\tfor (const chunk of this._chunks) {\n\t\t\tconst content = chunk.choices[0]?.delta?.content;\n\t\t\tif (content) {\n\t\t\t\tparts.push(content);\n\t\t\t}\n\t\t}\n\t\treturn parts.join('');\n\t}\n\n\t/**\n\t * Get the token usage from the final chunk (if the server included it).\n\t * Must be called after the stream has been fully consumed.\n\t */\n\tgetUsage(): { prompt_tokens: number; completion_tokens: number; total_tokens: number } | undefined {\n\t\t// Usage is typically in the last chunk\n\t\tfor (let i = this._chunks.length - 1; i >= 0; i--) {\n\t\t\tif (this._chunks[i].usage) {\n\t\t\t\treturn this._chunks[i].usage;\n\t\t\t}\n\t\t}\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Get the collected chunks array.\n\t * Must be called after the stream has been fully consumed.\n\t */\n\tgetChunks(): readonly ChatCompletionChunk[] {\n\t\treturn this._chunks;\n\t}\n}\n","import {\n\tDvinaInferenceError,\n\tDvinaInferenceAuthError,\n\tDvinaRateLimitError,\n\tDvinaQuotaError,\n\tDvinaStreamError,\n\tDvinaContextLengthError,\n\tDvinaTimeoutError,\n\tDvinaProviderUnavailableError,\n\tDvinaProviderError,\n\tDvinaDeploymentError,\n\tDvinaUnsupportedModelError,\n} from './errors.js';\nimport { parseSSEStream, ChatCompletionStream } from './stream.js';\nimport type {\n\tInferenceClientOptions,\n\tChatCompletionRequest,\n\tChatCompletionStreamRequest,\n\tChatCompletionResponse,\n\tChatCompletionChunk,\n\tResponsesRequest,\n\tResponsesStreamRequest,\n\tModelListResponse,\n\tModel,\n\tHealthResponse,\n\tInferenceErrorResponse,\n} from './types.js';\n\n// ─── Constants ───────────────────────────────────────────────────────────────\n\nconst DEFAULT_TIMEOUT_MS = 120_000;\n\n// ─── Error handling ──────────────────────────────────────────────────────────\n\n/**\n * Parse the response body into an OpenAI-compatible error and throw the appropriate typed error.\n */\nasync function throwForStatus(response: Response): Promise<never> {\n\tlet errorBody: InferenceErrorResponse | undefined;\n\n\ttry {\n\t\terrorBody = (await response.json()) as InferenceErrorResponse;\n\t} catch {\n\t\t// Body is not JSON — fall through to generic error\n\t}\n\n\tconst message = errorBody?.error?.message ?? `HTTP ${response.status}: ${response.statusText}`;\n\tconst type = errorBody?.error?.type ?? 'api_error';\n\tconst code = errorBody?.error?.code ?? 'unknown';\n\n\t// Auth errors (401, 403)\n\tif (response.status === 401 || response.status === 403) {\n\t\t// Quota exceeded is a special 403\n\t\tif (code === 'token_limit_reached' || type === 'insufficient_quota') {\n\t\t\tthrow new DvinaQuotaError(message);\n\t\t}\n\t\tthrow new DvinaInferenceAuthError(message, response.status);\n\t}\n\n\t// Rate limit (429)\n\tif (response.status === 429) {\n\t\tconst retryAfterHeader = response.headers.get('retry-after');\n\t\tconst retryAfter = retryAfterHeader ? parseInt(retryAfterHeader, 10) : undefined;\n\t\tthrow new DvinaRateLimitError(message, Number.isNaN(retryAfter) ? undefined : retryAfter);\n\t}\n\n\t// Specific error codes → typed subclasses\n\tswitch (code) {\n\t\tcase 'context_length_exceeded':\n\t\t\tthrow new DvinaContextLengthError(message);\n\t\tcase 'request_timeout':\n\t\t\tthrow new DvinaTimeoutError(message);\n\t\tcase 'provider_unavailable':\n\t\t\tthrow new DvinaProviderUnavailableError(message);\n\t\tcase 'provider_error':\n\t\t\tthrow new DvinaProviderError(message, response.status);\n\t\tcase 'deployment_not_found':\n\t\t\tthrow new DvinaDeploymentError(message);\n\t\tcase 'unsupported_model':\n\t\t\tthrow new DvinaUnsupportedModelError(message);\n\t}\n\n\tthrow new DvinaInferenceError(message, response.status, type, code);\n}\n\n// ─── Inference Client Interfaces ─────────────────────────────────────────────\n\n/**\n * Namespaced chat completions API.\n *\n * @example\n * ```typescript\n * // Non-streaming\n * const response = await sdk.inference.chat.completions.create({\n *   model: 'claude-sonnet-4-6',\n *   messages: [{ role: 'user', content: 'Hello!' }],\n * });\n *\n * // Streaming\n * const stream = await sdk.inference.chat.completions.stream({\n *   model: 'claude-sonnet-4-6',\n *   messages: [{ role: 'user', content: 'Hello!' }],\n * });\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk.choices[0]?.delta?.content ?? '');\n * }\n * ```\n */\nexport interface ChatCompletions {\n\t/** Create a non-streaming chat completion. */\n\tcreate(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;\n\t/** Create a streaming chat completion. Returns an async iterable of chunks. */\n\tstream(request: Omit<ChatCompletionStreamRequest, 'stream'>): Promise<ChatCompletionStream>;\n}\n\nexport interface Chat {\n\tcompletions: ChatCompletions;\n}\n\n/**\n * Namespaced responses API.\n *\n * @example\n * ```typescript\n * // Non-streaming\n * const response = await sdk.inference.responses.create({\n *   model: 'gpt-5.2',\n *   input: 'Hello!',\n * });\n *\n * // Streaming\n * const stream = await sdk.inference.responses.stream({\n *   model: 'gpt-5.2',\n *   input: 'Hello!',\n * });\n * for await (const event of stream) {\n *   console.log(event);\n * }\n * ```\n */\nexport interface Responses {\n\t/** Create a non-streaming response. */\n\tcreate(request: ResponsesRequest): Promise<unknown>;\n\t/** Create a streaming response. Returns a raw async iterable of SSE events. */\n\tstream(request: Omit<ResponsesStreamRequest, 'stream'>): Promise<AsyncIterable<unknown>>;\n}\n\n/**\n * Namespaced models API.\n */\nexport interface Models {\n\t/** List all available models. */\n\tlist(): Promise<ModelListResponse>;\n\t/** Get a single model by ID. */\n\tget(modelId: string): Promise<Model>;\n}\n\n/**\n * The Dvina Inference client.\n *\n * Provides a typed interface to the `/inference/v1` REST API with full\n * SSE streaming support. Follows the OpenAI client naming conventions\n * (`sdk.inference.chat.completions`, `sdk.inference.responses`, `sdk.inference.models`).\n *\n * @example\n * ```typescript\n * const sdk = new DvinaSdk({ token: 'your-jwt-token' });\n *\n * // Chat completion\n * const response = await sdk.inference.chat.completions.create({\n *   model: 'claude-sonnet-4-6',\n *   messages: [{ role: 'user', content: 'Hello!' }],\n * });\n *\n * // Streaming\n * const stream = await sdk.inference.chat.completions.stream({\n *   model: 'claude-sonnet-4-6',\n *   messages: [{ role: 'user', content: 'Tell me a story' }],\n * });\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk.choices[0]?.delta?.content ?? '');\n * }\n * ```\n */\nexport interface InferenceClient {\n\tchat: Chat;\n\tresponses: Responses;\n\tmodels: Models;\n\t/** Check the health of the inference API. */\n\thealth(): Promise<HealthResponse>;\n}\n\n// ─── Internal factory (used by createDvinaClient) ────────────────────────────\n\n/**\n * Create an inference client using pre-resolved baseUrl and getToken from the SDK.\n * This is the internal factory called by `createDvinaClient` — it does NOT resolve\n * token/options itself, it receives them from the parent SDK client.\n *\n * @internal\n */\nexport function createInferenceClientInternal(\n\tbaseUrl: string,\n\tgetToken: (options?: { forceRefresh?: boolean }) => Promise<string>,\n\toptions?: { headers?: Record<string, string>; timeout?: number },\n): InferenceClient {\n\treturn buildInferenceClient(baseUrl, getToken, options?.headers, options?.timeout);\n}\n\n// ─── Public standalone factory ───────────────────────────────────────────────\n\n/**\n * Create a standalone Dvina Inference client.\n *\n * Use this when you need inference without the full GraphQL SDK.\n * For most cases, prefer `sdk.inference` which shares auth with the SDK.\n *\n * @param options - Client configuration (base URL, auth, headers, timeout)\n * @returns A fully configured inference client\n *\n * @example\n * ```typescript\n * import { createInferenceClient } from '@dvina/sdk/inference';\n *\n * const client = createInferenceClient({\n *   baseUrl: 'https://api.dvina.ai/inference/v1',\n *   token: 'your-jwt-token',\n * });\n *\n * const response = await client.chat.completions.create({\n *   model: 'claude-sonnet-4-6',\n *   messages: [{ role: 'user', content: 'Hello!' }],\n * });\n * ```\n */\nexport function createInferenceClient(options: InferenceClientOptions): InferenceClient {\n\tconst baseUrl = options.baseUrl.replace(/\\/+$/, '');\n\n\tlet getToken: (opts?: { forceRefresh?: boolean }) => Promise<string>;\n\tif (options.getToken) {\n\t\tgetToken = options.getToken;\n\t} else if (options.token) {\n\t\tconst staticToken = options.token;\n\t\tgetToken = async () => staticToken;\n\t} else {\n\t\tthrow new Error('InferenceClientOptions must provide either `token` or `getToken`.');\n\t}\n\n\treturn buildInferenceClient(baseUrl, getToken, options.headers, options.timeout);\n}\n\n// ─── Shared builder ──────────────────────────────────────────────────────────\n\nfunction buildInferenceClient(\n\tbaseUrl: string,\n\tgetToken: (options?: { forceRefresh?: boolean }) => Promise<string>,\n\tcustomHeaders?: Record<string, string>,\n\ttimeout?: number,\n): InferenceClient {\n\tconst timeoutMs = timeout ?? DEFAULT_TIMEOUT_MS;\n\tconst headers = customHeaders ?? {};\n\n\t// ── Shared fetch helper ──────────────────────────────────────────────\n\n\tasync function buildRequestHeaders(): Promise<Record<string, string>> {\n\t\tconst token = await getToken();\n\t\treturn {\n\t\t\t'Content-Type': 'application/json',\n\t\t\tAuthorization: `Bearer ${token}`,\n\t\t\t...headers,\n\t\t};\n\t}\n\n\tasync function request<T>(method: string, path: string, body?: unknown): Promise<T> {\n\t\tconst controller = new AbortController();\n\t\tconst timer = setTimeout(() => controller.abort(), timeoutMs);\n\n\t\ttry {\n\t\t\tconst reqHeaders = await buildRequestHeaders();\n\t\t\tconst response = await fetch(`${baseUrl}${path}`, {\n\t\t\t\tmethod,\n\t\t\t\theaders: reqHeaders,\n\t\t\t\tbody: body !== undefined ? JSON.stringify(body) : undefined,\n\t\t\t\tsignal: controller.signal,\n\t\t\t});\n\n\t\t\tif (!response.ok) {\n\t\t\t\tawait throwForStatus(response);\n\t\t\t}\n\n\t\t\treturn (await response.json()) as T;\n\t\t} catch (error) {\n\t\t\tif (error instanceof DvinaInferenceError) throw error;\n\t\t\tif (error instanceof Error && error.name === 'AbortError') {\n\t\t\t\tthrow new DvinaInferenceError(\n\t\t\t\t\t`Request timed out after ${timeoutMs}ms`,\n\t\t\t\t\t0,\n\t\t\t\t\t'timeout_error',\n\t\t\t\t\t'request_timeout',\n\t\t\t\t);\n\t\t\t}\n\t\t\tthrow new DvinaInferenceError(\n\t\t\t\t`Network error: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t0,\n\t\t\t\t'network_error',\n\t\t\t\t'connection_failed',\n\t\t\t\terror instanceof Error ? error : undefined,\n\t\t\t);\n\t\t} finally {\n\t\t\tclearTimeout(timer);\n\t\t}\n\t}\n\n\tasync function requestStream(path: string, body: unknown): Promise<ReadableStream<Uint8Array>> {\n\t\tconst controller = new AbortController();\n\t\tconst timer = setTimeout(() => controller.abort(), timeoutMs);\n\n\t\ttry {\n\t\t\tconst reqHeaders = await buildRequestHeaders();\n\t\t\tconst response = await fetch(`${baseUrl}${path}`, {\n\t\t\t\tmethod: 'POST',\n\t\t\t\theaders: reqHeaders,\n\t\t\t\tbody: JSON.stringify(body),\n\t\t\t\tsignal: controller.signal,\n\t\t\t});\n\n\t\t\t// Clear the timeout — the stream itself may take longer than the initial timeout.\n\t\t\t// The timeout only applies to the initial connection, not the full stream duration.\n\t\t\tclearTimeout(timer);\n\n\t\t\tif (!response.ok) {\n\t\t\t\tawait throwForStatus(response);\n\t\t\t}\n\n\t\t\tif (!response.body) {\n\t\t\t\tthrow new DvinaStreamError('Response body is null — streaming not supported in this environment');\n\t\t\t}\n\n\t\t\treturn response.body;\n\t\t} catch (error) {\n\t\t\tclearTimeout(timer);\n\t\t\tif (error instanceof DvinaInferenceError) throw error;\n\t\t\tif (error instanceof Error && error.name === 'AbortError') {\n\t\t\t\tthrow new DvinaInferenceError(\n\t\t\t\t\t`Stream connection timed out after ${timeoutMs}ms`,\n\t\t\t\t\t0,\n\t\t\t\t\t'timeout_error',\n\t\t\t\t\t'request_timeout',\n\t\t\t\t);\n\t\t\t}\n\t\t\tthrow new DvinaInferenceError(\n\t\t\t\t`Network error: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t0,\n\t\t\t\t'network_error',\n\t\t\t\t'connection_failed',\n\t\t\t\terror instanceof Error ? error : undefined,\n\t\t\t);\n\t\t}\n\t}\n\n\t// ── Chat Completions ─────────────────────────────────────────────────\n\n\tconst completions: ChatCompletions = {\n\t\tasync create(req: ChatCompletionRequest): Promise<ChatCompletionResponse> {\n\t\t\treturn request<ChatCompletionResponse>('POST', '/chat/completions', {\n\t\t\t\t...req,\n\t\t\t\tstream: false,\n\t\t\t});\n\t\t},\n\n\t\tasync stream(req: Omit<ChatCompletionStreamRequest, 'stream'>): Promise<ChatCompletionStream> {\n\t\t\tconst body = await requestStream('/chat/completions', {\n\t\t\t\t...req,\n\t\t\t\tstream: true,\n\t\t\t});\n\n\t\t\tconst source = parseSSEStream<ChatCompletionChunk>(body);\n\t\t\treturn new ChatCompletionStream(source);\n\t\t},\n\t};\n\n\tconst chat: Chat = { completions };\n\n\t// ── Responses ────────────────────────────────────────────────────────\n\n\tconst responses: Responses = {\n\t\tasync create(req: ResponsesRequest): Promise<unknown> {\n\t\t\treturn request<unknown>('POST', '/responses', {\n\t\t\t\t...req,\n\t\t\t\tstream: false,\n\t\t\t});\n\t\t},\n\n\t\tasync stream(req: Omit<ResponsesStreamRequest, 'stream'>): Promise<AsyncIterable<unknown>> {\n\t\t\tconst body = await requestStream('/responses', {\n\t\t\t\t...req,\n\t\t\t\tstream: true,\n\t\t\t});\n\n\t\t\t// Responses API uses a different SSE event format than chat completions.\n\t\t\t// We parse it as generic unknown objects so the consumer can handle the format.\n\t\t\treturn {\n\t\t\t\t[Symbol.asyncIterator]() {\n\t\t\t\t\treturn parseSSEStream<unknown>(body);\n\t\t\t\t},\n\t\t\t};\n\t\t},\n\t};\n\n\t// ── Models ───────────────────────────────────────────────────────────\n\n\tconst models: Models = {\n\t\tasync list(): Promise<ModelListResponse> {\n\t\t\treturn request<ModelListResponse>('GET', '/models');\n\t\t},\n\n\t\tasync get(modelId: string): Promise<Model> {\n\t\t\treturn request<Model>('GET', `/models/${encodeURIComponent(modelId)}`);\n\t\t},\n\t};\n\n\t// ── Health ───────────────────────────────────────────────────────────\n\n\tasync function health(): Promise<HealthResponse> {\n\t\treturn request<HealthResponse>('GET', '/health');\n\t}\n\n\treturn {\n\t\tchat,\n\t\tresponses,\n\t\tmodels,\n\t\thealth,\n\t};\n}\n"]}

package/dist/client-9Rwj21T9.d.cts

@@ -0,0 +1,77 @@
+import { D as DvinaError } from './error-CsVoUTY8.cjs';
+import { a as DvinaRequest, b as DvinaSubscribe } from './types-2RotD0Ab.cjs';
+import { S as SyncEngine } from './sync-engine-DVKQO-1-.cjs';
+import { I as InferenceClient } from './client-CLhQragb.cjs';
+import { BillingClient } from './billing/index.cjs';
+
+interface DvinaSdkBaseOptions {
+    /** Base URL without protocol (e.g. 'api.dvina.ai' or 'localhost:4000'). Default: 'api.dvina.ai' */
+    baseUrl?: string;
+    /**
+     * Override the billing API base URL.
+     * Accepts either a bare host (e.g. 'billing.dvina.ai') or a full URL with protocol
+     * (e.g. 'http://dvina-billing:3010'). When a protocol is included, it is used as-is.
+     * By default, derived from `baseUrl` by replacing the leading `api.` with `billing.`
+     * (e.g. 'api.dvina.ai' → 'billing.dvina.ai').
+     */
+    billingUrl?: string;
+    /** Preferred language for API responses. Static string or reactive callback. */
+    language?: string | (() => string);
+    /**
+     * Global error callback invoked for every terminal SDK error (after all
+     * retries and token refreshes have been exhausted).
+     *
+     * Receives typed error subclasses — use `instanceof` to branch:
+     * - `DvinaPlanRestrictionError` — plan/billing limit exceeded (check `restrictionCode`)
+     * - `DvinaTokenLimitError` — session token limit reached
+     * - `DvinaNotFoundError` — resource not found
+     * - `DvinaAuthenticationError` — authentication permanently failed
+     * - `DvinaNetworkError` — network/HTTP failure
+     * - `DvinaGraphQLError` — other GraphQL errors
+     */
+    onError?: (error: DvinaError) => void;
+}
+interface DvinaSdkTokenOptions extends DvinaSdkBaseOptions {
+    /** Static auth token. Use for scripts, CLI tools, and tests. */
+    token: string;
+    getToken?: never;
+}
+interface DvinaSdkCallbackOptions extends DvinaSdkBaseOptions {
+    /**
+     * Async callback that returns an auth token.
+     * When called with `{ forceRefresh: true }`, the callback must bypass any
+     * cache and obtain a brand-new token (e.g. via Auth0's silent refresh).
+     */
+    getToken: (options?: {
+        forceRefresh?: boolean;
+    }) => Promise<string>;
+    token?: never;
+}
+type DvinaSdkOptions = DvinaSdkTokenOptions | DvinaSdkCallbackOptions;
+interface DvinaClientResult {
+    syncEngine: SyncEngine;
+    /** Request function that routes through SyncEngine (normalize + Dexie write). Used by model classes for compat. */
+    request: DvinaRequest;
+    /** Subscribe function that routes through WebSocket transport for GraphQL subscriptions. */
+    subscribe: DvinaSubscribe;
+    getToken: (options?: {
+        forceRefresh?: boolean;
+    }) => Promise<string>;
+    /** Terminate the WebSocket connection (call on logout / SDK teardown). */
+    terminateWs: () => void;
+    /** Close and remove the cached IndexedDB database (call on logout / workspace switch / SDK teardown). */
+    closeDb: () => Promise<void>;
+    /** Inference client for the /inference/v1 REST API (chat completions, responses, models). */
+    inference: InferenceClient;
+    /** Billing client for the Dvina Billing GraphQL API (plans, subscriptions, seats, sessions). */
+    billing: BillingClient;
+    /** The resolved base URL (e.g. 'api.dvina.ai'). Used by models to resolve relative asset paths. */
+    baseUrl: string;
+}
+/**
+ * Create a fully configured Dvina client with SyncEngine, HTTP transport, and WS transport.
+ * Called by the DvinaSdk constructor (generated code).
+ */
+declare function createDvinaClient(options: DvinaSdkOptions): DvinaClientResult;
+
+export { type DvinaSdkOptions as D, type DvinaSdkBaseOptions as a, type DvinaSdkCallbackOptions as b, type DvinaSdkTokenOptions as c, createDvinaClient as d };

package/dist/client-Bskq7sc_.d.ts

@@ -0,0 +1,77 @@
+import { D as DvinaError } from './error-CsVoUTY8.js';
+import { a as DvinaRequest, b as DvinaSubscribe } from './types-2RotD0Ab.js';
+import { S as SyncEngine } from './sync-engine-cLwTqdjv.js';
+import { I as InferenceClient } from './client-CLhQragb.js';
+import { BillingClient } from './billing/index.js';
+
+interface DvinaSdkBaseOptions {
+    /** Base URL without protocol (e.g. 'api.dvina.ai' or 'localhost:4000'). Default: 'api.dvina.ai' */
+    baseUrl?: string;
+    /**
+     * Override the billing API base URL.
+     * Accepts either a bare host (e.g. 'billing.dvina.ai') or a full URL with protocol
+     * (e.g. 'http://dvina-billing:3010'). When a protocol is included, it is used as-is.
+     * By default, derived from `baseUrl` by replacing the leading `api.` with `billing.`
+     * (e.g. 'api.dvina.ai' → 'billing.dvina.ai').
+     */
+    billingUrl?: string;
+    /** Preferred language for API responses. Static string or reactive callback. */
+    language?: string | (() => string);
+    /**
+     * Global error callback invoked for every terminal SDK error (after all
+     * retries and token refreshes have been exhausted).
+     *
+     * Receives typed error subclasses — use `instanceof` to branch:
+     * - `DvinaPlanRestrictionError` — plan/billing limit exceeded (check `restrictionCode`)
+     * - `DvinaTokenLimitError` — session token limit reached
+     * - `DvinaNotFoundError` — resource not found
+     * - `DvinaAuthenticationError` — authentication permanently failed
+     * - `DvinaNetworkError` — network/HTTP failure
+     * - `DvinaGraphQLError` — other GraphQL errors
+     */
+    onError?: (error: DvinaError) => void;
+}
+interface DvinaSdkTokenOptions extends DvinaSdkBaseOptions {
+    /** Static auth token. Use for scripts, CLI tools, and tests. */
+    token: string;
+    getToken?: never;
+}
+interface DvinaSdkCallbackOptions extends DvinaSdkBaseOptions {
+    /**
+     * Async callback that returns an auth token.
+     * When called with `{ forceRefresh: true }`, the callback must bypass any
+     * cache and obtain a brand-new token (e.g. via Auth0's silent refresh).
+     */
+    getToken: (options?: {
+        forceRefresh?: boolean;
+    }) => Promise<string>;
+    token?: never;
+}
+type DvinaSdkOptions = DvinaSdkTokenOptions | DvinaSdkCallbackOptions;
+interface DvinaClientResult {
+    syncEngine: SyncEngine;
+    /** Request function that routes through SyncEngine (normalize + Dexie write). Used by model classes for compat. */
+    request: DvinaRequest;
+    /** Subscribe function that routes through WebSocket transport for GraphQL subscriptions. */
+    subscribe: DvinaSubscribe;
+    getToken: (options?: {
+        forceRefresh?: boolean;
+    }) => Promise<string>;
+    /** Terminate the WebSocket connection (call on logout / SDK teardown). */
+    terminateWs: () => void;
+    /** Close and remove the cached IndexedDB database (call on logout / workspace switch / SDK teardown). */
+    closeDb: () => Promise<void>;
+    /** Inference client for the /inference/v1 REST API (chat completions, responses, models). */
+    inference: InferenceClient;
+    /** Billing client for the Dvina Billing GraphQL API (plans, subscriptions, seats, sessions). */
+    billing: BillingClient;
+    /** The resolved base URL (e.g. 'api.dvina.ai'). Used by models to resolve relative asset paths. */
+    baseUrl: string;
+}
+/**
+ * Create a fully configured Dvina client with SyncEngine, HTTP transport, and WS transport.
+ * Called by the DvinaSdk constructor (generated code).
+ */
+declare function createDvinaClient(options: DvinaSdkOptions): DvinaClientResult;
+
+export { type DvinaSdkOptions as D, type DvinaSdkBaseOptions as a, type DvinaSdkCallbackOptions as b, type DvinaSdkTokenOptions as c, createDvinaClient as d };