nadir-sdk 0.1.0

package/README.md

@@ -0,0 +1,94 @@
+# Nadir Node.js SDK
+
+Official Node.js/TypeScript client for the [Nadir](https://getnadir.dev) LLM router — intelligent model routing that cuts API costs 30-60%.
+
+## Installation
+
+```bash
+npm install nadir-sdk
+```
+
+## Quick Start
+
+```typescript
+import { NadirClient } from "nadir-sdk";
+
+const client = new NadirClient({ apiKey: "ndr_..." });
+
+// Chat completion — Nadir picks the optimal model
+const response = await client.chat.completions.create({
+  messages: [{ role: "user", content: "What is 2+2?" }],
+});
+console.log(response.choices[0].message?.content);
+
+// See which model was selected and why
+console.log(response.nadir_metadata?.tier);             // "simple"
+console.log(response.nadir_metadata?.selected_model);   // "gpt-4o-mini"
+console.log(response.nadir_metadata?.complexity_score);  // 0.12
+```
+
+## Streaming
+
+```typescript
+const stream = await client.chat.completions.create({
+  messages: [{ role: "user", content: "Tell me a story" }],
+  stream: true,
+});
+
+for await (const chunk of stream) {
+  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
+}
+```
+
+## Model Recommendation (no LLM call)
+
+```typescript
+const rec = await client.recommend({
+  prompt: "Explain quantum entanglement in detail",
+});
+console.log(rec);
+```
+
+## Advanced: Fallback & Routing Control
+
+```typescript
+const response = await client.chat.completions.create({
+  messages: [{ role: "user", content: "Complex analysis..." }],
+  route: "fallback",                              // enable auto-fallback
+  fallback_models: ["claude-sonnet-4-20250514", "gpt-4o"],  // explicit fallback chain
+  layers: { routing: true, optimize: true },        // per-request feature toggles
+  reasoning: { effort: "high" },                   // reasoning token support
+});
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `NADIR_API_KEY` | API key (fallback if not passed to constructor) | — |
+| `NADIR_BASE_URL` | API base URL | `https://api.getnadir.dev` |
+
+## OpenAI Drop-in Compatibility
+
+Nadir's API is OpenAI-compatible. You can also use the OpenAI SDK directly:
+
+```typescript
+import OpenAI from "openai";
+
+const client = new OpenAI({
+  baseURL: "https://api.getnadir.dev/v1",
+  apiKey: "ndr_...",
+});
+
+const response = await client.chat.completions.create({
+  model: "auto",
+  messages: [{ role: "user", content: "Hello" }],
+});
+```
+
+The Nadir SDK adds typed access to routing metadata, recommendations, smart export, and clustering that the OpenAI SDK can't reach.
+
+## Requirements
+
+- Node.js >= 18 (uses native `fetch`)
+- Zero runtime dependencies

package/dist/index.cjs

@@ -0,0 +1,337 @@
+"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, {
+  APIError: () => APIError,
+  AuthenticationError: () => AuthenticationError,
+  ConnectionError: () => ConnectionError,
+  NadirClient: () => NadirClient,
+  NadirError: () => NadirError,
+  RateLimitError: () => RateLimitError,
+  Stream: () => Stream
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var NadirError = class extends Error {
+  status;
+  body;
+  errorType;
+  constructor(message, options = {}) {
+    super(message);
+    this.name = "NadirError";
+    this.status = options.status ?? 0;
+    this.body = options.body;
+    this.errorType = options.errorType;
+  }
+};
+var AuthenticationError = class extends NadirError {
+  constructor(message, body) {
+    super(message, { status: 401, body });
+    this.name = "AuthenticationError";
+  }
+};
+var RateLimitError = class extends NadirError {
+  retryAfter;
+  constructor(message, options = {}) {
+    super(message, { status: 429, body: options.body });
+    this.name = "RateLimitError";
+    this.retryAfter = options.retryAfter;
+  }
+};
+var APIError = class extends NadirError {
+  constructor(message, status, body) {
+    super(message, { status, body });
+    this.name = "APIError";
+  }
+};
+var ConnectionError = class extends NadirError {
+  constructor(message) {
+    super(message, { status: 0 });
+    this.name = "ConnectionError";
+  }
+};
+
+// src/streaming.ts
+var Stream = class {
+  reader;
+  decoder = new TextDecoder();
+  buffer = "";
+  done = false;
+  parse;
+  constructor(body, parse) {
+    this.reader = body.getReader();
+    this.parse = parse;
+  }
+  async *[Symbol.asyncIterator]() {
+    try {
+      while (!this.done) {
+        const { value, done } = await this.reader.read();
+        if (done) {
+          this.done = true;
+          yield* this.processBuffer(true);
+          break;
+        }
+        this.buffer += this.decoder.decode(value, { stream: true });
+        yield* this.processBuffer(false);
+      }
+    } finally {
+      this.reader.releaseLock();
+    }
+  }
+  *processBuffer(flush) {
+    const lines = this.buffer.split("\n");
+    if (!flush) {
+      this.buffer = lines.pop() ?? "";
+    } else {
+      this.buffer = "";
+    }
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed || !trimmed.startsWith("data: ")) {
+        continue;
+      }
+      const payload = trimmed.slice(6);
+      if (payload === "[DONE]") {
+        this.done = true;
+        return;
+      }
+      try {
+        const data = JSON.parse(payload);
+        yield this.parse(data);
+      } catch {
+      }
+    }
+  }
+};
+function parseChatCompletionChunk(data) {
+  return data;
+}
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.getnadir.dev";
+var SDK_VERSION = "0.1.0";
+var Completions = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async create(params) {
+    if (params.stream) {
+      const response = await this.client._rawRequest(
+        "POST",
+        "/v1/chat/completions",
+        params
+      );
+      if (!response.body) {
+        throw new ConnectionError("Response body is null \u2014 streaming not supported");
+      }
+      return new Stream(
+        response.body,
+        parseChatCompletionChunk
+      );
+    }
+    return this.client._request(
+      "POST",
+      "/v1/chat/completions",
+      params
+    );
+  }
+};
+var Chat = class {
+  completions;
+  constructor(client) {
+    this.completions = new Completions(client);
+  }
+};
+var SmartExport = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async status() {
+    return this.client._request("GET", "/v1/smart-export/status");
+  }
+  async train(clusterId, options = {}) {
+    return this.client._request(
+      "POST",
+      `/v1/smart-export/clusters/${clusterId}/train`,
+      { base_model: options.baseModel ?? "gpt-4o-mini" }
+    );
+  }
+  async exportData(clusterId, options = {}) {
+    return this.client._request(
+      "POST",
+      `/v1/smart-export/clusters/${clusterId}/export`,
+      { format: options.format ?? "jsonl" }
+    );
+  }
+  async listJobs() {
+    return this.client._request("GET", "/v1/smart-export/jobs");
+  }
+  async getJob(jobId) {
+    return this.client._request("GET", `/v1/smart-export/jobs/${jobId}`);
+  }
+  async cancelJob(jobId) {
+    return this.client._request("DELETE", `/v1/smart-export/jobs/${jobId}`);
+  }
+};
+var Clustering = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async classify(prompt) {
+    return this.client._request("POST", "/v1/clustering/classify", { prompt });
+  }
+  async listClusters() {
+    return this.client._request("GET", "/v1/clustering/clusters");
+  }
+  async createCluster(params) {
+    return this.client._request("POST", "/v1/clustering/clusters", params);
+  }
+};
+var Organizations = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async list() {
+    return this.client._request("GET", "/v1/organizations");
+  }
+  async create(params) {
+    return this.client._request("POST", "/v1/organizations", params);
+  }
+  async get(orgId) {
+    return this.client._request("GET", `/v1/organizations/${orgId}`);
+  }
+};
+var NadirClient = class {
+  apiKey;
+  baseURL;
+  timeout;
+  /** OpenAI-compatible chat completions namespace. */
+  chat;
+  /** Smart Export / distillation endpoints. */
+  smartExport;
+  /** Prompt clustering endpoints. */
+  clustering;
+  /** Organization management endpoints. */
+  organizations;
+  constructor(options = {}) {
+    this.apiKey = options.apiKey ?? (typeof process !== "undefined" ? process.env.NADIR_API_KEY ?? "" : "");
+    this.baseURL = (options.baseURL ?? (typeof process !== "undefined" ? process.env.NADIR_BASE_URL ?? DEFAULT_BASE_URL : DEFAULT_BASE_URL)).replace(/\/+$/, "");
+    this.timeout = options.timeout ?? 12e4;
+    this.chat = new Chat(this);
+    this.smartExport = new SmartExport(this);
+    this.clustering = new Clustering(this);
+    this.organizations = new Organizations(this);
+  }
+  // ── Convenience methods ─────────────────────────────────────────
+  /** Get a model recommendation without making an LLM call. */
+  async recommend(params) {
+    return this._request("POST", "/v1/public/recommendation", params);
+  }
+  /** List available models. */
+  async listModels() {
+    return this._request("GET", "/v1/models");
+  }
+  /** List user presets. */
+  async listPresets() {
+    return this._request("GET", "/v1/user/presets");
+  }
+  /** Check API health. */
+  async health() {
+    return this._request("GET", "/health");
+  }
+  // ── HTTP internals (public for namespace classes) ───────────────
+  /** @internal */
+  async _request(method, path, body) {
+    const response = await this._rawRequest(method, path, body);
+    return await response.json();
+  }
+  /** @internal — returns the raw Response (for streaming). */
+  async _rawRequest(method, path, body) {
+    const url = `${this.baseURL}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      "X-API-Key": this.apiKey,
+      "User-Agent": `nadir-node/${SDK_VERSION}`
+    };
+    let response;
+    try {
+      response = await fetch(url, {
+        method,
+        headers,
+        body: body != null ? JSON.stringify(body) : void 0,
+        signal: AbortSignal.timeout(this.timeout)
+      });
+    } catch (err) {
+      if (err instanceof Error && err.name === "TimeoutError") {
+        throw new ConnectionError(
+          `Request timed out after ${this.timeout}ms: ${method} ${path}`
+        );
+      }
+      throw new ConnectionError(
+        `Failed to connect to ${this.baseURL}: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+    if (response.ok) {
+      return response;
+    }
+    let errorBody;
+    let detail = "";
+    try {
+      errorBody = await response.json();
+      if (typeof errorBody === "object" && errorBody !== null) {
+        const obj = errorBody;
+        detail = obj.detail ?? obj.error?.message ?? "";
+      }
+    } catch {
+      detail = await response.text().catch(() => "");
+    }
+    if (!detail) {
+      detail = `HTTP ${response.status}`;
+    }
+    if (response.status === 401) {
+      throw new AuthenticationError(detail, errorBody);
+    }
+    if (response.status === 429) {
+      const retryAfter = response.headers.get("retry-after");
+      throw new RateLimitError(detail, {
+        body: errorBody,
+        retryAfter: retryAfter ? parseFloat(retryAfter) : void 0
+      });
+    }
+    throw new APIError(detail, response.status, errorBody);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  APIError,
+  AuthenticationError,
+  ConnectionError,
+  NadirClient,
+  NadirError,
+  RateLimitError,
+  Stream
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/streaming.ts","../src/client.ts"],"sourcesContent":["export { NadirClient } from \"./client.js\";\nexport type { NadirClientOptions } from \"./client.js\";\n\nexport { Stream } from \"./streaming.js\";\n\nexport {\n  NadirError,\n  AuthenticationError,\n  RateLimitError,\n  APIError,\n  ConnectionError,\n} from \"./errors.js\";\n\nexport type {\n  ChatMessage,\n  ChatCompletionCreateParams,\n  ReasoningConfig,\n  ProviderPreferences,\n  ChatCompletion,\n  ChatCompletionChunk,\n  Choice,\n  Message,\n  Usage,\n  NadirMetadata,\n  CreateClusterParams,\n  CreateOrganizationParams,\n  RecommendParams,\n} from \"./types.js\";\n","/** Base error for all Nadir API errors. */\nexport class NadirError extends Error {\n  readonly status: number;\n  readonly body: unknown;\n  readonly errorType: string | undefined;\n\n  constructor(\n    message: string,\n    options: { status?: number; body?: unknown; errorType?: string } = {},\n  ) {\n    super(message);\n    this.name = \"NadirError\";\n    this.status = options.status ?? 0;\n    this.body = options.body;\n    this.errorType = options.errorType;\n  }\n}\n\n/** Raised on 401 Unauthorized — invalid or missing API key. */\nexport class AuthenticationError extends NadirError {\n  constructor(message: string, body?: unknown) {\n    super(message, { status: 401, body });\n    this.name = \"AuthenticationError\";\n  }\n}\n\n/** Raised on 429 Too Many Requests. */\nexport class RateLimitError extends NadirError {\n  readonly retryAfter: number | undefined;\n\n  constructor(\n    message: string,\n    options: { body?: unknown; retryAfter?: number } = {},\n  ) {\n    super(message, { status: 429, body: options.body });\n    this.name = \"RateLimitError\";\n    this.retryAfter = options.retryAfter;\n  }\n}\n\n/** Raised on server errors (4xx/5xx) not covered by a more specific class. */\nexport class APIError extends NadirError {\n  constructor(message: string, status: number, body?: unknown) {\n    super(message, { status, body });\n    this.name = \"APIError\";\n  }\n}\n\n/** Raised when the SDK cannot reach the Nadir API. */\nexport class ConnectionError extends NadirError {\n  constructor(message: string) {\n    super(message, { status: 0 });\n    this.name = \"ConnectionError\";\n  }\n}\n","import type { ChatCompletionChunk } from \"./types.js\";\n\n/**\n * Async iterable wrapper around an SSE response stream.\n *\n * Usage:\n * ```ts\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk.choices[0]?.delta?.content ?? \"\");\n * }\n * ```\n */\nexport class Stream<T> implements AsyncIterable<T> {\n  private reader: ReadableStreamDefaultReader<Uint8Array>;\n  private decoder = new TextDecoder();\n  private buffer = \"\";\n  private done = false;\n  private parse: (data: unknown) => T;\n\n  constructor(\n    body: ReadableStream<Uint8Array>,\n    parse: (data: unknown) => T,\n  ) {\n    this.reader = body.getReader();\n    this.parse = parse;\n  }\n\n  async *[Symbol.asyncIterator](): AsyncIterator<T> {\n    try {\n      while (!this.done) {\n        const { value, done } = await this.reader.read();\n        if (done) {\n          this.done = true;\n          // Process any remaining buffer\n          yield* this.processBuffer(true);\n          break;\n        }\n\n        this.buffer += this.decoder.decode(value, { stream: true });\n        yield* this.processBuffer(false);\n      }\n    } finally {\n      this.reader.releaseLock();\n    }\n  }\n\n  private *processBuffer(flush: boolean): Generator<T> {\n    const lines = this.buffer.split(\"\\n\");\n\n    // Keep the last incomplete line in the buffer (unless flushing)\n    if (!flush) {\n      this.buffer = lines.pop() ?? \"\";\n    } else {\n      this.buffer = \"\";\n    }\n\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed || !trimmed.startsWith(\"data: \")) {\n        continue;\n      }\n      const payload = trimmed.slice(6);\n      if (payload === \"[DONE]\") {\n        this.done = true;\n        return;\n      }\n      try {\n        const data = JSON.parse(payload);\n        yield this.parse(data);\n      } catch {\n        // Skip malformed JSON lines\n      }\n    }\n  }\n}\n\n/** Identity parser for ChatCompletionChunk (the API returns the correct shape). */\nexport function parseChatCompletionChunk(data: unknown): ChatCompletionChunk {\n  return data as ChatCompletionChunk;\n}\n","/**\n * Nadir Node.js SDK — OpenAI-compatible client for the Nadir LLM router.\n *\n * @example\n * ```ts\n * import { NadirClient } from \"nadir-sdk\";\n *\n * const client = new NadirClient({ apiKey: \"ndr_...\" });\n *\n * // Chat completion — Nadir picks the optimal model\n * const response = await client.chat.completions.create({\n *   messages: [{ role: \"user\", content: \"Hello!\" }],\n * });\n * console.log(response.choices[0].message?.content);\n *\n * // Streaming\n * const stream = await client.chat.completions.create({\n *   messages: [{ role: \"user\", content: \"Tell me a story\" }],\n *   stream: true,\n * });\n * for await (const chunk of stream) {\n *   process.stdout.write(chunk.choices[0]?.delta?.content ?? \"\");\n * }\n * ```\n */\n\nimport {\n  APIError,\n  AuthenticationError,\n  ConnectionError,\n  RateLimitError,\n} from \"./errors.js\";\nimport { Stream, parseChatCompletionChunk } from \"./streaming.js\";\nimport type {\n  ChatCompletion,\n  ChatCompletionChunk,\n  ChatCompletionCreateParams,\n  CreateClusterParams,\n  CreateOrganizationParams,\n  RecommendParams,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.getnadir.dev\";\nconst SDK_VERSION = \"0.1.0\";\n\n// ---------------------------------------------------------------------------\n// Client options\n// ---------------------------------------------------------------------------\n\nexport interface NadirClientOptions {\n  /** Nadir API key (`ndr_...`). Falls back to `NADIR_API_KEY` env var. */\n  apiKey?: string;\n  /** API base URL. Falls back to `NADIR_BASE_URL` env var. */\n  baseURL?: string;\n  /** Request timeout in milliseconds (default 120_000). */\n  timeout?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Namespace classes\n// ---------------------------------------------------------------------------\n\nclass Completions {\n  constructor(private client: NadirClient) {}\n\n  /** Create a chat completion (non-streaming). */\n  async create(\n    params: ChatCompletionCreateParams & { stream?: false },\n  ): Promise<ChatCompletion>;\n  /** Create a streaming chat completion. */\n  async create(\n    params: ChatCompletionCreateParams & { stream: true },\n  ): Promise<Stream<ChatCompletionChunk>>;\n  /** Create a chat completion (overload resolution). */\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletion | Stream<ChatCompletionChunk>>;\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletion | Stream<ChatCompletionChunk>> {\n    if (params.stream) {\n      const response = await this.client._rawRequest(\n        \"POST\",\n        \"/v1/chat/completions\",\n        params,\n      );\n\n      if (!response.body) {\n        throw new ConnectionError(\"Response body is null — streaming not supported\");\n      }\n\n      return new Stream<ChatCompletionChunk>(\n        response.body,\n        parseChatCompletionChunk,\n      );\n    }\n\n    return this.client._request<ChatCompletion>(\n      \"POST\",\n      \"/v1/chat/completions\",\n      params,\n    );\n  }\n}\n\nclass Chat {\n  readonly completions: Completions;\n  constructor(client: NadirClient) {\n    this.completions = new Completions(client);\n  }\n}\n\nclass SmartExport {\n  constructor(private client: NadirClient) {}\n\n  async status(): Promise<Record<string, unknown>> {\n    return this.client._request(\"GET\", \"/v1/smart-export/status\");\n  }\n\n  async train(\n    clusterId: string,\n    options: { baseModel?: string } = {},\n  ): Promise<Record<string, unknown>> {\n    return this.client._request(\n      \"POST\",\n      `/v1/smart-export/clusters/${clusterId}/train`,\n      { base_model: options.baseModel ?? \"gpt-4o-mini\" },\n    );\n  }\n\n  async exportData(\n    clusterId: string,\n    options: { format?: string } = {},\n  ): Promise<Record<string, unknown>> {\n    return this.client._request(\n      \"POST\",\n      `/v1/smart-export/clusters/${clusterId}/export`,\n      { format: options.format ?? \"jsonl\" },\n    );\n  }\n\n  async listJobs(): Promise<Record<string, unknown>> {\n    return this.client._request(\"GET\", \"/v1/smart-export/jobs\");\n  }\n\n  async getJob(jobId: string): Promise<Record<string, unknown>> {\n    return this.client._request(\"GET\", `/v1/smart-export/jobs/${jobId}`);\n  }\n\n  async cancelJob(jobId: string): Promise<Record<string, unknown>> {\n    return this.client._request(\"DELETE\", `/v1/smart-export/jobs/${jobId}`);\n  }\n}\n\nclass Clustering {\n  constructor(private client: NadirClient) {}\n\n  async classify(prompt: string): Promise<Record<string, unknown>> {\n    return this.client._request(\"POST\", \"/v1/clustering/classify\", { prompt });\n  }\n\n  async listClusters(): Promise<Record<string, unknown>> {\n    return this.client._request(\"GET\", \"/v1/clustering/clusters\");\n  }\n\n  async createCluster(params: CreateClusterParams): Promise<Record<string, unknown>> {\n    return this.client._request(\"POST\", \"/v1/clustering/clusters\", params);\n  }\n}\n\nclass Organizations {\n  constructor(private client: NadirClient) {}\n\n  async list(): Promise<Record<string, unknown>> {\n    return this.client._request(\"GET\", \"/v1/organizations\");\n  }\n\n  async create(params: CreateOrganizationParams): Promise<Record<string, unknown>> {\n    return this.client._request(\"POST\", \"/v1/organizations\", params);\n  }\n\n  async get(orgId: string): Promise<Record<string, unknown>> {\n    return this.client._request(\"GET\", `/v1/organizations/${orgId}`);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Main client\n// ---------------------------------------------------------------------------\n\nexport class NadirClient {\n  private readonly apiKey: string;\n  private readonly baseURL: string;\n  private readonly timeout: number;\n\n  /** OpenAI-compatible chat completions namespace. */\n  readonly chat: Chat;\n  /** Smart Export / distillation endpoints. */\n  readonly smartExport: SmartExport;\n  /** Prompt clustering endpoints. */\n  readonly clustering: Clustering;\n  /** Organization management endpoints. */\n  readonly organizations: Organizations;\n\n  constructor(options: NadirClientOptions = {}) {\n    this.apiKey =\n      options.apiKey ??\n      (typeof process !== \"undefined\" ? process.env.NADIR_API_KEY ?? \"\" : \"\");\n    this.baseURL = (\n      options.baseURL ??\n      (typeof process !== \"undefined\"\n        ? process.env.NADIR_BASE_URL ?? DEFAULT_BASE_URL\n        : DEFAULT_BASE_URL)\n    ).replace(/\\/+$/, \"\");\n    this.timeout = options.timeout ?? 120_000;\n\n    this.chat = new Chat(this);\n    this.smartExport = new SmartExport(this);\n    this.clustering = new Clustering(this);\n    this.organizations = new Organizations(this);\n  }\n\n  // ── Convenience methods ─────────────────────────────────────────\n\n  /** Get a model recommendation without making an LLM call. */\n  async recommend(params: RecommendParams): Promise<Record<string, unknown>> {\n    return this._request(\"POST\", \"/v1/public/recommendation\", params);\n  }\n\n  /** List available models. */\n  async listModels(): Promise<Record<string, unknown>> {\n    return this._request(\"GET\", \"/v1/models\");\n  }\n\n  /** List user presets. */\n  async listPresets(): Promise<Record<string, unknown>> {\n    return this._request(\"GET\", \"/v1/user/presets\");\n  }\n\n  /** Check API health. */\n  async health(): Promise<Record<string, unknown>> {\n    return this._request(\"GET\", \"/health\");\n  }\n\n  // ── HTTP internals (public for namespace classes) ───────────────\n\n  /** @internal */\n  async _request<T = Record<string, unknown>>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<T> {\n    const response = await this._rawRequest(method, path, body);\n    return (await response.json()) as T;\n  }\n\n  /** @internal — returns the raw Response (for streaming). */\n  async _rawRequest(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<Response> {\n    const url = `${this.baseURL}${path}`;\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      \"X-API-Key\": this.apiKey,\n      \"User-Agent\": `nadir-node/${SDK_VERSION}`,\n    };\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method,\n        headers,\n        body: body != null ? JSON.stringify(body) : undefined,\n        signal: AbortSignal.timeout(this.timeout),\n      });\n    } catch (err: unknown) {\n      if (err instanceof Error && err.name === \"TimeoutError\") {\n        throw new ConnectionError(\n          `Request timed out after ${this.timeout}ms: ${method} ${path}`,\n        );\n      }\n      throw new ConnectionError(\n        `Failed to connect to ${this.baseURL}: ${err instanceof Error ? err.message : String(err)}`,\n      );\n    }\n\n    if (response.ok) {\n      return response;\n    }\n\n    // Parse error body\n    let errorBody: unknown;\n    let detail = \"\";\n    try {\n      errorBody = await response.json();\n      if (typeof errorBody === \"object\" && errorBody !== null) {\n        const obj = errorBody as Record<string, unknown>;\n        detail =\n          (obj.detail as string) ??\n          ((obj.error as Record<string, unknown>)?.message as string) ??\n          \"\";\n      }\n    } catch {\n      detail = await response.text().catch(() => \"\");\n    }\n\n    if (!detail) {\n      detail = `HTTP ${response.status}`;\n    }\n\n    if (response.status === 401) {\n      throw new AuthenticationError(detail, errorBody);\n    }\n    if (response.status === 429) {\n      const retryAfter = response.headers.get(\"retry-after\");\n      throw new RateLimitError(detail, {\n        body: errorBody,\n        retryAfter: retryAfter ? parseFloat(retryAfter) : undefined,\n      });\n    }\n    throw new APIError(detail, response.status, errorBody);\n  }\n}\n"],"mappings":"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","names":[]}