@sintaksdev/sdk 0.1.0 → 1.1.0

package/README.md

@@ -36,13 +36,18 @@ for await (const chunk of stream) {
 
 // Image generation
 const images = await client.images.generate({
-  model: "flux-schnell",
   prompt: "A futuristic Jakarta skyline at dusk",
 });
 console.log(images.data[0]?.url);
+
+// List active models
+const models = await client.models.list();
+console.log(models.data.map((m) => m.id));
 ```
 
-`model` defaults to `claude-sonnet-5-5` when omitted. Point at another environment with `baseURL`:
+`model` defaults to `claude-sonnet-5-5` for chat and `stable-image-core` for
+images when omitted. Streaming requests ask for `stream_options.include_usage`,
+so the final chunk carries `usage`. Point at another environment with `baseURL`:
 
 ```ts
 const client = new Sintaks({ apiKey: "sk-...", baseURL: "http://localhost:8080" });
@@ -50,14 +55,16 @@ const client = new Sintaks({ apiKey: "sk-...", baseURL: "http://localhost:8080"
 
 ## Errors
 
-Failures throw `SintaksError` with `status`, `type`, `code`, and `requestId` (the gateway `X-Request-ID`, useful for support).
+Failures throw `SintaksError` with `status`, `type`, `code`, and `requestId` (the gateway `X-Request-ID`, useful for support). Convenience getters map the gateway's status semantics:
 
 ```ts
 try {
   await client.chat.completions.create({ messages: [{ role: "user", content: "x" }] });
 } catch (err) {
-  if (err instanceof SintaksError && err.status === 402) {
-    console.error("insufficient balance, top up first");
+  if (err instanceof SintaksError) {
+    if (err.isUnauthorized) console.error("invalid or revoked api key");
+    if (err.isInsufficientCredits) console.error("insufficient balance, top up first");
+    if (err.isRetryable) console.error(`retry after ${err.requestId}`);
   }
 }
 ```

package/dist/index.cjs

@@ -22,6 +22,8 @@ var index_exports = {};
 __export(index_exports, {
   DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
   DEFAULT_CHAT_MODEL: () => DEFAULT_CHAT_MODEL,
+  DEFAULT_EMBEDDING_MODEL: () => DEFAULT_EMBEDDING_MODEL,
+  DEFAULT_IMAGE_MODEL: () => DEFAULT_IMAGE_MODEL,
   Sintaks: () => Sintaks,
   SintaksError: () => SintaksError,
   default: () => index_default
@@ -29,6 +31,8 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var DEFAULT_BASE_URL = "https://api.sintaks.dev";
 var DEFAULT_CHAT_MODEL = "claude-sonnet-5-5";
+var DEFAULT_IMAGE_MODEL = "stable-image-core";
+var DEFAULT_EMBEDDING_MODEL = "qwen3-embedding-0-6b";
 var SintaksError = class extends Error {
   status;
   type;
@@ -42,12 +46,30 @@ var SintaksError = class extends Error {
     this.code = opts.code ?? null;
     this.requestId = opts.requestId ?? null;
   }
+  /** True for missing, malformed, revoked, or invalid API keys (401). */
+  get isUnauthorized() {
+    return this.status === 401;
+  }
+  /** True when the account balance can't cover the request (402). Top up first. */
+  get isInsufficientCredits() {
+    return this.status === 402;
+  }
+  /** True for upstream throttling (429). */
+  get isRateLimited() {
+    return this.status === 429;
+  }
+  /** True for errors worth retrying with backoff: 429, 503, 504. */
+  get isRetryable() {
+    return this.status === 429 || this.status === 503 || this.status === 504;
+  }
 };
 var Sintaks = class {
   apiKey;
   baseURL;
   chat;
   images;
+  embeddings;
+  models;
   /** @internal */
   fetchFn;
   /** @internal */
@@ -60,6 +82,8 @@ var Sintaks = class {
     this.extraHeaders = options.headers ?? {};
     this.chat = new ChatResource(this);
     this.images = new ImagesResource(this);
+    this.embeddings = new EmbeddingsResource(this);
+    this.models = new ModelsResource(this);
   }
   async request(method, path, body) {
     const res = await this.fetchFn(`${this.baseURL}${path}`, {
@@ -110,7 +134,11 @@ var ChatResource = class {
         Accept: "text/event-stream",
         ...this.client.extraHeaders
       },
-      body: JSON.stringify({ ...params, model: params.model ?? DEFAULT_CHAT_MODEL })
+      body: JSON.stringify({
+        ...params,
+        model: params.model ?? DEFAULT_CHAT_MODEL,
+        stream_options: { include_usage: true }
+      })
     });
     if (!res.ok || !res.body) {
       let envelope = {};
@@ -160,7 +188,32 @@ var ImagesResource = class {
   }
   client;
   async generate(params) {
-    return this.client.request("POST", "/v1/images/generations", params);
+    return this.client.request("POST", "/v1/images/generations", {
+      ...params,
+      model: params.model ?? DEFAULT_IMAGE_MODEL
+    });
+  }
+};
+var ModelsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Lists the active models served by the gateway (GET /v1/models). */
+  async list() {
+    return this.client.request("GET", "/v1/models");
+  }
+};
+var EmbeddingsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async create(params) {
+    return this.client.request("POST", "/v1/embeddings", {
+      ...params,
+      model: params.model ?? DEFAULT_EMBEDDING_MODEL
+    });
   }
 };
 var index_default = Sintaks;
@@ -168,6 +221,8 @@ var index_default = Sintaks;
 0 && (module.exports = {
   DEFAULT_BASE_URL,
   DEFAULT_CHAT_MODEL,
+  DEFAULT_EMBEDDING_MODEL,
+  DEFAULT_IMAGE_MODEL,
   Sintaks,
   SintaksError
 });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @sintaksdev/sdk — TypeScript client for the sintaks.dev OpenAI-compatible\n * AI API gateway. Zero runtime dependencies; requires Node >= 18 (global fetch).\n */\n\nexport const DEFAULT_BASE_URL = \"https://api.sintaks.dev\";\nexport const DEFAULT_CHAT_MODEL = \"claude-sonnet-5-5\";\n\n/* ------------------------------------------------------------------ */\n/* Types (OpenAI-compatible shapes)                                    */\n/* ------------------------------------------------------------------ */\n\nexport interface ChatMessage {\n  role: \"system\" | \"user\" | \"assistant\" | \"tool\";\n  content: string;\n  name?: string;\n}\n\nexport interface ChatCompletionCreateParams {\n  model?: string;\n  messages: ChatMessage[];\n  stream?: boolean;\n  temperature?: number;\n  top_p?: number;\n  max_tokens?: number;\n  stop?: string | string[];\n  [key: string]: unknown;\n}\n\nexport interface ChatCompletion {\n  id: string;\n  object: \"chat.completion\";\n  created: number;\n  model: string;\n  choices: {\n    index: number;\n    message: ChatMessage;\n    finish_reason: string | null;\n  }[];\n  usage?: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n  };\n}\n\nexport interface ChatCompletionChunk {\n  id: string;\n  object: \"chat.completion.chunk\";\n  created: number;\n  model: string;\n  choices: {\n    index: number;\n    delta: { role?: string; content?: string | null };\n    finish_reason: string | null;\n  }[];\n}\n\nexport interface ImageGenerationParams {\n  model?: string;\n  prompt: string;\n  n?: number;\n  size?: string;\n  [key: string]: unknown;\n}\n\nexport interface GeneratedImage {\n  url?: string;\n  b64_json?: string;\n}\n\nexport interface ImageGenerationResult {\n  created: number;\n  data: GeneratedImage[];\n}\n\nexport interface ErrorEnvelope {\n  error?: {\n    message?: string;\n    type?: string;\n    param?: string | null;\n    code?: string | null;\n  };\n}\n\n/* ------------------------------------------------------------------ */\n/* Error                                                               */\n/* ------------------------------------------------------------------ */\n\nexport class SintaksError extends Error {\n  readonly status: number;\n  readonly type: string | undefined;\n  readonly code: string | null;\n  readonly requestId: string | null;\n\n  constructor(\n    status: number,\n    message: string,\n    opts: { type?: string; code?: string | null; requestId?: string | null } = {},\n  ) {\n    super(message);\n    this.name = \"SintaksError\";\n    this.status = status;\n    this.type = opts.type;\n    this.code = opts.code ?? null;\n    this.requestId = opts.requestId ?? null;\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Client                                                              */\n/* ------------------------------------------------------------------ */\n\nexport interface SintaksOptions {\n  apiKey: string;\n  baseURL?: string;\n  fetch?: typeof fetch;\n  headers?: Record<string, string>;\n}\n\nexport class Sintaks {\n  readonly apiKey: string;\n  readonly baseURL: string;\n  readonly chat: ChatResource;\n  readonly images: ImagesResource;\n\n  /** @internal */\n  readonly fetchFn: typeof fetch;\n  /** @internal */\n  readonly extraHeaders: Record<string, string>;\n\n  constructor(options: SintaksOptions) {\n    if (!options.apiKey) throw new Error(\"Sintaks: apiKey is required\");\n    this.apiKey = options.apiKey;\n    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.fetchFn = options.fetch ?? fetch;\n    this.extraHeaders = options.headers ?? {};\n    this.chat = new ChatResource(this);\n    this.images = new ImagesResource(this);\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const res = await this.fetchFn(`${this.baseURL}${path}`, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        ...this.extraHeaders,\n      },\n      body: body === undefined ? undefined : JSON.stringify(body),\n    });\n\n    if (!res.ok) {\n      let envelope: ErrorEnvelope = {};\n      try {\n        envelope = (await res.json()) as ErrorEnvelope;\n      } catch {\n        // non-JSON error body; fall through with defaults\n      }\n      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {\n        type: envelope.error?.type,\n        code: envelope.error?.code,\n        requestId: res.headers.get(\"x-request-id\"),\n      });\n    }\n    return (await res.json()) as T;\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Chat                                                                */\n/* ------------------------------------------------------------------ */\n\nclass ChatResource {\n  readonly completions = this;\n\n  constructor(private client: Sintaks) {}\n\n  async create(params: ChatCompletionCreateParams): Promise<ChatCompletion>;\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<AsyncIterable<ChatCompletionChunk>>;\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletion | AsyncIterable<ChatCompletionChunk>> {\n    if (params.stream) {\n      return this.createStream(params as ChatCompletionCreateParams & { stream: true });\n    }\n    return this.client.request<ChatCompletion>(\"POST\", \"/v1/chat/completions\", {\n      ...params,\n      model: params.model ?? DEFAULT_CHAT_MODEL,\n    });\n  }\n\n  private async createStream(\n    params: ChatCompletionCreateParams & { stream: true },\n  ): Promise<AsyncIterable<ChatCompletionChunk>> {\n    const res = await this.client.fetchFn(`${this.client.baseURL}/v1/chat/completions`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.client.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        Accept: \"text/event-stream\",\n        ...this.client.extraHeaders,\n      },\n      body: JSON.stringify({ ...params, model: params.model ?? DEFAULT_CHAT_MODEL }),\n    });\n\n    if (!res.ok || !res.body) {\n      let envelope: ErrorEnvelope = {};\n      try {\n        envelope = (await res.json()) as ErrorEnvelope;\n      } catch {\n        // ignore\n      }\n      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {\n        type: envelope.error?.type,\n        code: envelope.error?.code,\n        requestId: res.headers.get(\"x-request-id\"),\n      });\n    }\n\n    return parseSSE<ChatCompletionChunk>(res.body);\n  }\n}\n\n/** Minimal SSE parser for OpenAI-style `data:` events. */\nasync function* parseSSE<T>(body: ReadableStream<Uint8Array>): AsyncIterable<T> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      buffer += decoder.decode(value, { stream: true });\n\n      let boundary: number;\n      while ((boundary = buffer.indexOf(\"\\n\\n\")) !== -1) {\n        const chunk = buffer.slice(0, boundary);\n        buffer = buffer.slice(boundary + 2);\n        const dataLine = chunk\n          .split(\"\\n\")\n          .find((line) => line.startsWith(\"data:\"));\n        if (!dataLine) continue;\n        const payload = dataLine.slice(5).trim();\n        if (payload === \"[DONE]\") return;\n        try {\n          yield JSON.parse(payload) as T;\n        } catch {\n          // skip malformed event\n        }\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Images                                                              */\n/* ------------------------------------------------------------------ */\n\nclass ImagesResource {\n  constructor(private client: Sintaks) {}\n\n  async generate(params: ImageGenerationParams): Promise<ImageGenerationResult> {\n    return this.client.request<ImageGenerationResult>(\"POST\", \"/v1/images/generations\", params);\n  }\n}\n\nexport default Sintaks;"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKO,IAAM,mBAAmB;AACzB,IAAM,qBAAqB;AAmF3B,IAAM,eAAN,cAA2B,MAAM;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAET,YACE,QACA,SACA,OAA2E,CAAC,GAC5E;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,OAAO,KAAK;AACjB,SAAK,OAAO,KAAK,QAAQ;AACzB,SAAK,YAAY,KAAK,aAAa;AAAA,EACrC;AACF;AAaO,IAAM,UAAN,MAAc;AAAA,EACV;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAGA;AAAA;AAAA,EAEA;AAAA,EAET,YAAY,SAAyB;AACnC,QAAI,CAAC,QAAQ,OAAQ,OAAM,IAAI,MAAM,6BAA6B;AAClE,SAAK,SAAS,QAAQ;AACtB,SAAK,WAAW,QAAQ,WAAW,kBAAkB,QAAQ,QAAQ,EAAE;AACvE,SAAK,UAAU,QAAQ,SAAS;AAChC,SAAK,eAAe,QAAQ,WAAW,CAAC;AACxC,SAAK,OAAO,IAAI,aAAa,IAAI;AACjC,SAAK,SAAS,IAAI,eAAe,IAAI;AAAA,EACvC;AAAA,EAEA,MAAM,QAAW,QAAgB,MAAc,MAA4B;AACzE,UAAM,MAAM,MAAM,KAAK,QAAQ,GAAG,KAAK,OAAO,GAAG,IAAI,IAAI;AAAA,MACvD;AAAA,MACA,SAAS;AAAA,QACP,eAAe,UAAU,KAAK,MAAM;AAAA,QACpC,gBAAgB;AAAA,QAChB,GAAG,KAAK;AAAA,MACV;AAAA,MACA,MAAM,SAAS,SAAY,SAAY,KAAK,UAAU,IAAI;AAAA,IAC5D,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,UAAI,WAA0B,CAAC;AAC/B,UAAI;AACF,mBAAY,MAAM,IAAI,KAAK;AAAA,MAC7B,QAAQ;AAAA,MAER;AACA,YAAM,IAAI,aAAa,IAAI,QAAQ,SAAS,OAAO,WAAW,uBAAuB,IAAI,MAAM,IAAI;AAAA,QACjG,MAAM,SAAS,OAAO;AAAA,QACtB,MAAM,SAAS,OAAO;AAAA,QACtB,WAAW,IAAI,QAAQ,IAAI,cAAc;AAAA,MAC3C,CAAC;AAAA,IACH;AACA,WAAQ,MAAM,IAAI,KAAK;AAAA,EACzB;AACF;AAMA,IAAM,eAAN,MAAmB;AAAA,EAGjB,YAAoB,QAAiB;AAAjB;AAAA,EAAkB;AAAA,EAAlB;AAAA,EAFX,cAAc;AAAA,EAMvB,MAAM,OACJ,QAC8D;AAC9D,QAAI,OAAO,QAAQ;AACjB,aAAO,KAAK,aAAa,MAAuD;AAAA,IAClF;AACA,WAAO,KAAK,OAAO,QAAwB,QAAQ,wBAAwB;AAAA,MACzE,GAAG;AAAA,MACH,OAAO,OAAO,SAAS;AAAA,IACzB,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,aACZ,QAC6C;AAC7C,UAAM,MAAM,MAAM,KAAK,OAAO,QAAQ,GAAG,KAAK,OAAO,OAAO,wBAAwB;AAAA,MAClF,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,eAAe,UAAU,KAAK,OAAO,MAAM;AAAA,QAC3C,gBAAgB;AAAA,QAChB,QAAQ;AAAA,QACR,GAAG,KAAK,OAAO;AAAA,MACjB;AAAA,MACA,MAAM,KAAK,UAAU,EAAE,GAAG,QAAQ,OAAO,OAAO,SAAS,mBAAmB,CAAC;AAAA,IAC/E,CAAC;AAED,QAAI,CAAC,IAAI,MAAM,CAAC,IAAI,MAAM;AACxB,UAAI,WAA0B,CAAC;AAC/B,UAAI;AACF,mBAAY,MAAM,IAAI,KAAK;AAAA,MAC7B,QAAQ;AAAA,MAER;AACA,YAAM,IAAI,aAAa,IAAI,QAAQ,SAAS,OAAO,WAAW,uBAAuB,IAAI,MAAM,IAAI;AAAA,QACjG,MAAM,SAAS,OAAO;AAAA,QACtB,MAAM,SAAS,OAAO;AAAA,QACtB,WAAW,IAAI,QAAQ,IAAI,cAAc;AAAA,MAC3C,CAAC;AAAA,IACH;AAEA,WAAO,SAA8B,IAAI,IAAI;AAAA,EAC/C;AACF;AAGA,gBAAgB,SAAY,MAAoD;AAC9E,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,UAAU,IAAI,YAAY;AAChC,MAAI,SAAS;AAEb,MAAI;AACF,WAAO,MAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,UAAI,KAAM;AACV,gBAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;AAEhD,UAAI;AACJ,cAAQ,WAAW,OAAO,QAAQ,MAAM,OAAO,IAAI;AACjD,cAAM,QAAQ,OAAO,MAAM,GAAG,QAAQ;AACtC,iBAAS,OAAO,MAAM,WAAW,CAAC;AAClC,cAAM,WAAW,MACd,MAAM,IAAI,EACV,KAAK,CAAC,SAAS,KAAK,WAAW,OAAO,CAAC;AAC1C,YAAI,CAAC,SAAU;AACf,cAAM,UAAU,SAAS,MAAM,CAAC,EAAE,KAAK;AACvC,YAAI,YAAY,SAAU;AAC1B,YAAI;AACF,gBAAM,KAAK,MAAM,OAAO;AAAA,QAC1B,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF;AAAA,EACF,UAAE;AACA,WAAO,YAAY;AAAA,EACrB;AACF;AAMA,IAAM,iBAAN,MAAqB;AAAA,EACnB,YAAoB,QAAiB;AAAjB;AAAA,EAAkB;AAAA,EAAlB;AAAA,EAEpB,MAAM,SAAS,QAA+D;AAC5E,WAAO,KAAK,OAAO,QAA+B,QAAQ,0BAA0B,MAAM;AAAA,EAC5F;AACF;AAEA,IAAO,gBAAQ;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @sintaksdev/sdk — TypeScript client for the sintaks.dev OpenAI-compatible\n * AI API gateway. Zero runtime dependencies; requires Node >= 18 (global fetch).\n */\n\nexport const DEFAULT_BASE_URL = \"https://api.sintaks.dev\";\nexport const DEFAULT_CHAT_MODEL = \"claude-sonnet-5-5\";\nexport const DEFAULT_IMAGE_MODEL = \"stable-image-core\";\nexport const DEFAULT_EMBEDDING_MODEL = \"qwen3-embedding-0-6b\";\n\n/* ------------------------------------------------------------------ */\n/* Types (OpenAI-compatible shapes)                                    */\n/* ------------------------------------------------------------------ */\n\nexport type MessageContentPart = { type: \"text\"; text: string };\n\nexport interface ChatMessage {\n  role: \"system\" | \"developer\" | \"user\" | \"assistant\" | \"tool\";\n  content: string | MessageContentPart[];\n  name?: string;\n}\n\nexport interface ChatCompletionCreateParams {\n  model?: string;\n  messages: ChatMessage[];\n  stream?: boolean;\n  stream_options?: { include_usage?: boolean };\n  temperature?: number;\n  top_p?: number;\n  max_tokens?: number;\n  max_completion_tokens?: number;\n  stop?: string | string[];\n  [key: string]: unknown;\n}\n\nexport interface Usage {\n  prompt_tokens: number;\n  completion_tokens: number;\n  total_tokens: number;\n}\n\nexport interface ChatCompletion {\n  id: string;\n  object: \"chat.completion\";\n  created: number;\n  model: string;\n  choices: {\n    index: number;\n    message: ChatMessage;\n    finish_reason: string | null;\n  }[];\n  usage?: Usage;\n}\n\nexport interface ChatCompletionChunk {\n  id: string;\n  object: \"chat.completion.chunk\";\n  created: number;\n  model: string;\n  choices: {\n    index: number;\n    delta: { role?: string; content?: string | null };\n    finish_reason: string | null;\n  }[];\n  usage?: Usage;\n}\n\nexport interface Model {\n  id: string;\n  object: \"model\";\n  created: number;\n  owned_by: string;\n}\n\nexport interface ModelList {\n  object: \"list\";\n  data: Model[];\n}\n\nexport interface ImageGenerationParams {\n  model?: string;\n  prompt: string;\n  n?: number;\n  size?: string;\n  [key: string]: unknown;\n}\n\nexport interface GeneratedImage {\n  url?: string;\n  b64_json?: string;\n}\n\nexport interface ImageGenerationResult {\n  created: number;\n  data: GeneratedImage[];\n}\n\nexport interface EmbeddingCreateParams {\n  model?: string;\n  input: string | string[];\n  encoding_format?: \"float\";\n  dimensions?: number;\n  [key: string]: unknown;\n}\n\nexport interface EmbeddingObject {\n  object: \"embedding\";\n  index: number;\n  embedding: number[];\n}\n\nexport interface EmbeddingResponse {\n  object: \"list\";\n  data: EmbeddingObject[];\n  model: string;\n  usage?: {\n    prompt_tokens: number;\n    total_tokens: number;\n  };\n}\n\nexport interface ErrorEnvelope {\n  error?: {\n    message?: string;\n    type?: string;\n    param?: string | null;\n    code?: string | null;\n  };\n}\n\n/* ------------------------------------------------------------------ */\n/* Error                                                               */\n/* ------------------------------------------------------------------ */\n\nexport class SintaksError extends Error {\n  readonly status: number;\n  readonly type: string | undefined;\n  readonly code: string | null;\n  readonly requestId: string | null;\n\n  constructor(\n    status: number,\n    message: string,\n    opts: { type?: string; code?: string | null; requestId?: string | null } = {},\n  ) {\n    super(message);\n    this.name = \"SintaksError\";\n    this.status = status;\n    this.type = opts.type;\n    this.code = opts.code ?? null;\n    this.requestId = opts.requestId ?? null;\n  }\n\n  /** True for missing, malformed, revoked, or invalid API keys (401). */\n  get isUnauthorized(): boolean {\n    return this.status === 401;\n  }\n\n  /** True when the account balance can't cover the request (402). Top up first. */\n  get isInsufficientCredits(): boolean {\n    return this.status === 402;\n  }\n\n  /** True for upstream throttling (429). */\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n\n  /** True for errors worth retrying with backoff: 429, 503, 504. */\n  get isRetryable(): boolean {\n    return this.status === 429 || this.status === 503 || this.status === 504;\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Client                                                              */\n/* ------------------------------------------------------------------ */\n\nexport interface SintaksOptions {\n  apiKey: string;\n  baseURL?: string;\n  fetch?: typeof fetch;\n  headers?: Record<string, string>;\n}\n\nexport class Sintaks {\n  readonly apiKey: string;\n  readonly baseURL: string;\n  readonly chat: ChatResource;\n  readonly images: ImagesResource;\n  readonly embeddings: EmbeddingsResource;\n  readonly models: ModelsResource;\n\n  /** @internal */\n  readonly fetchFn: typeof fetch;\n  /** @internal */\n  readonly extraHeaders: Record<string, string>;\n\n  constructor(options: SintaksOptions) {\n    if (!options.apiKey) throw new Error(\"Sintaks: apiKey is required\");\n    this.apiKey = options.apiKey;\n    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.fetchFn = options.fetch ?? fetch;\n    this.extraHeaders = options.headers ?? {};\n    this.chat = new ChatResource(this);\n    this.images = new ImagesResource(this);\n    this.embeddings = new EmbeddingsResource(this);\n    this.models = new ModelsResource(this);\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const res = await this.fetchFn(`${this.baseURL}${path}`, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        ...this.extraHeaders,\n      },\n      body: body === undefined ? undefined : JSON.stringify(body),\n    });\n\n    if (!res.ok) {\n      let envelope: ErrorEnvelope = {};\n      try {\n        envelope = (await res.json()) as ErrorEnvelope;\n      } catch {\n        // non-JSON error body; fall through with defaults\n      }\n      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {\n        type: envelope.error?.type,\n        code: envelope.error?.code,\n        requestId: res.headers.get(\"x-request-id\"),\n      });\n    }\n    return (await res.json()) as T;\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Chat                                                                */\n/* ------------------------------------------------------------------ */\n\nclass ChatResource {\n  readonly completions = this;\n\n  constructor(private client: Sintaks) {}\n\n  async create(params: ChatCompletionCreateParams): Promise<ChatCompletion>;\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<AsyncIterable<ChatCompletionChunk>>;\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletion | AsyncIterable<ChatCompletionChunk>> {\n    if (params.stream) {\n      return this.createStream(params as ChatCompletionCreateParams & { stream: true });\n    }\n    return this.client.request<ChatCompletion>(\"POST\", \"/v1/chat/completions\", {\n      ...params,\n      model: params.model ?? DEFAULT_CHAT_MODEL,\n    });\n  }\n\n  private async createStream(\n    params: ChatCompletionCreateParams & { stream: true },\n  ): Promise<AsyncIterable<ChatCompletionChunk>> {\n    const res = await this.client.fetchFn(`${this.client.baseURL}/v1/chat/completions`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.client.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        Accept: \"text/event-stream\",\n        ...this.client.extraHeaders,\n      },\n      body: JSON.stringify({\n        ...params,\n        model: params.model ?? DEFAULT_CHAT_MODEL,\n        stream_options: { include_usage: true },\n      }),\n    });\n\n    if (!res.ok || !res.body) {\n      let envelope: ErrorEnvelope = {};\n      try {\n        envelope = (await res.json()) as ErrorEnvelope;\n      } catch {\n        // ignore\n      }\n      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {\n        type: envelope.error?.type,\n        code: envelope.error?.code,\n        requestId: res.headers.get(\"x-request-id\"),\n      });\n    }\n\n    return parseSSE<ChatCompletionChunk>(res.body);\n  }\n}\n\n/** Minimal SSE parser for OpenAI-style `data:` events. */\nasync function* parseSSE<T>(body: ReadableStream<Uint8Array>): AsyncIterable<T> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      buffer += decoder.decode(value, { stream: true });\n\n      let boundary: number;\n      while ((boundary = buffer.indexOf(\"\\n\\n\")) !== -1) {\n        const chunk = buffer.slice(0, boundary);\n        buffer = buffer.slice(boundary + 2);\n        const dataLine = chunk\n          .split(\"\\n\")\n          .find((line) => line.startsWith(\"data:\"));\n        if (!dataLine) continue;\n        const payload = dataLine.slice(5).trim();\n        if (payload === \"[DONE]\") return;\n        try {\n          yield JSON.parse(payload) as T;\n        } catch {\n          // skip malformed event\n        }\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Images                                                              */\n/* ------------------------------------------------------------------ */\n\nclass ImagesResource {\n  constructor(private client: Sintaks) {}\n\n  async generate(params: ImageGenerationParams): Promise<ImageGenerationResult> {\n    return this.client.request<ImageGenerationResult>(\"POST\", \"/v1/images/generations\", {\n      ...params,\n      model: params.model ?? DEFAULT_IMAGE_MODEL,\n    });\n  }\n}\n\nclass ModelsResource {\n  constructor(private client: Sintaks) {}\n\n  /** Lists the active models served by the gateway (GET /v1/models). */\n  async list(): Promise<ModelList> {\n    return this.client.request<ModelList>(\"GET\", \"/v1/models\");\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Embeddings                                                          */\n/* ------------------------------------------------------------------ */\n\nclass EmbeddingsResource {\n  constructor(private client: Sintaks) {}\n\n  async create(params: EmbeddingCreateParams): Promise<EmbeddingResponse> {\n    return this.client.request<EmbeddingResponse>(\"POST\", \"/v1/embeddings\", {\n      ...params,\n      model: params.model ?? DEFAULT_EMBEDDING_MODEL,\n    });\n  }\n}\n\nexport default Sintaks;"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -4,21 +4,36 @@
  */
 declare const DEFAULT_BASE_URL = "https://api.sintaks.dev";
 declare const DEFAULT_CHAT_MODEL = "claude-sonnet-5-5";
+declare const DEFAULT_IMAGE_MODEL = "stable-image-core";
+declare const DEFAULT_EMBEDDING_MODEL = "qwen3-embedding-0-6b";
+type MessageContentPart = {
+    type: "text";
+    text: string;
+};
 interface ChatMessage {
-    role: "system" | "user" | "assistant" | "tool";
-    content: string;
+    role: "system" | "developer" | "user" | "assistant" | "tool";
+    content: string | MessageContentPart[];
     name?: string;
 }
 interface ChatCompletionCreateParams {
     model?: string;
     messages: ChatMessage[];
     stream?: boolean;
+    stream_options?: {
+        include_usage?: boolean;
+    };
     temperature?: number;
     top_p?: number;
     max_tokens?: number;
+    max_completion_tokens?: number;
     stop?: string | string[];
     [key: string]: unknown;
 }
+interface Usage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
 interface ChatCompletion {
     id: string;
     object: "chat.completion";
@@ -29,11 +44,7 @@ interface ChatCompletion {
         message: ChatMessage;
         finish_reason: string | null;
     }[];
-    usage?: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
+    usage?: Usage;
 }
 interface ChatCompletionChunk {
     id: string;
@@ -48,6 +59,17 @@ interface ChatCompletionChunk {
         };
         finish_reason: string | null;
     }[];
+    usage?: Usage;
+}
+interface Model {
+    id: string;
+    object: "model";
+    created: number;
+    owned_by: string;
+}
+interface ModelList {
+    object: "list";
+    data: Model[];
 }
 interface ImageGenerationParams {
     model?: string;
@@ -64,6 +86,27 @@ interface ImageGenerationResult {
     created: number;
     data: GeneratedImage[];
 }
+interface EmbeddingCreateParams {
+    model?: string;
+    input: string | string[];
+    encoding_format?: "float";
+    dimensions?: number;
+    [key: string]: unknown;
+}
+interface EmbeddingObject {
+    object: "embedding";
+    index: number;
+    embedding: number[];
+}
+interface EmbeddingResponse {
+    object: "list";
+    data: EmbeddingObject[];
+    model: string;
+    usage?: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
 interface ErrorEnvelope {
     error?: {
         message?: string;
@@ -82,6 +125,14 @@ declare class SintaksError extends Error {
         code?: string | null;
         requestId?: string | null;
     });
+    /** True for missing, malformed, revoked, or invalid API keys (401). */
+    get isUnauthorized(): boolean;
+    /** True when the account balance can't cover the request (402). Top up first. */
+    get isInsufficientCredits(): boolean;
+    /** True for upstream throttling (429). */
+    get isRateLimited(): boolean;
+    /** True for errors worth retrying with backoff: 429, 503, 504. */
+    get isRetryable(): boolean;
 }
 interface SintaksOptions {
     apiKey: string;
@@ -94,6 +145,8 @@ declare class Sintaks {
     readonly baseURL: string;
     readonly chat: ChatResource;
     readonly images: ImagesResource;
+    readonly embeddings: EmbeddingsResource;
+    readonly models: ModelsResource;
     /** @internal */
     readonly fetchFn: typeof fetch;
     /** @internal */
@@ -116,5 +169,16 @@ declare class ImagesResource {
     constructor(client: Sintaks);
     generate(params: ImageGenerationParams): Promise<ImageGenerationResult>;
 }
+declare class ModelsResource {
+    private client;
+    constructor(client: Sintaks);
+    /** Lists the active models served by the gateway (GET /v1/models). */
+    list(): Promise<ModelList>;
+}
+declare class EmbeddingsResource {
+    private client;
+    constructor(client: Sintaks);
+    create(params: EmbeddingCreateParams): Promise<EmbeddingResponse>;
+}
 
-export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, DEFAULT_BASE_URL, DEFAULT_CHAT_MODEL, type ErrorEnvelope, type GeneratedImage, type ImageGenerationParams, type ImageGenerationResult, Sintaks, SintaksError, type SintaksOptions, Sintaks as default };
+export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, DEFAULT_BASE_URL, DEFAULT_CHAT_MODEL, DEFAULT_EMBEDDING_MODEL, DEFAULT_IMAGE_MODEL, type EmbeddingCreateParams, type EmbeddingObject, type EmbeddingResponse, type ErrorEnvelope, type GeneratedImage, type ImageGenerationParams, type ImageGenerationResult, type MessageContentPart, type Model, type ModelList, Sintaks, SintaksError, type SintaksOptions, type Usage, Sintaks as default };

package/dist/index.d.ts

@@ -4,21 +4,36 @@
  */
 declare const DEFAULT_BASE_URL = "https://api.sintaks.dev";
 declare const DEFAULT_CHAT_MODEL = "claude-sonnet-5-5";
+declare const DEFAULT_IMAGE_MODEL = "stable-image-core";
+declare const DEFAULT_EMBEDDING_MODEL = "qwen3-embedding-0-6b";
+type MessageContentPart = {
+    type: "text";
+    text: string;
+};
 interface ChatMessage {
-    role: "system" | "user" | "assistant" | "tool";
-    content: string;
+    role: "system" | "developer" | "user" | "assistant" | "tool";
+    content: string | MessageContentPart[];
     name?: string;
 }
 interface ChatCompletionCreateParams {
     model?: string;
     messages: ChatMessage[];
     stream?: boolean;
+    stream_options?: {
+        include_usage?: boolean;
+    };
     temperature?: number;
     top_p?: number;
     max_tokens?: number;
+    max_completion_tokens?: number;
     stop?: string | string[];
     [key: string]: unknown;
 }
+interface Usage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
 interface ChatCompletion {
     id: string;
     object: "chat.completion";
@@ -29,11 +44,7 @@ interface ChatCompletion {
         message: ChatMessage;
         finish_reason: string | null;
     }[];
-    usage?: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
+    usage?: Usage;
 }
 interface ChatCompletionChunk {
     id: string;
@@ -48,6 +59,17 @@ interface ChatCompletionChunk {
         };
         finish_reason: string | null;
     }[];
+    usage?: Usage;
+}
+interface Model {
+    id: string;
+    object: "model";
+    created: number;
+    owned_by: string;
+}
+interface ModelList {
+    object: "list";
+    data: Model[];
 }
 interface ImageGenerationParams {
     model?: string;
@@ -64,6 +86,27 @@ interface ImageGenerationResult {
     created: number;
     data: GeneratedImage[];
 }
+interface EmbeddingCreateParams {
+    model?: string;
+    input: string | string[];
+    encoding_format?: "float";
+    dimensions?: number;
+    [key: string]: unknown;
+}
+interface EmbeddingObject {
+    object: "embedding";
+    index: number;
+    embedding: number[];
+}
+interface EmbeddingResponse {
+    object: "list";
+    data: EmbeddingObject[];
+    model: string;
+    usage?: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
 interface ErrorEnvelope {
     error?: {
         message?: string;
@@ -82,6 +125,14 @@ declare class SintaksError extends Error {
         code?: string | null;
         requestId?: string | null;
     });
+    /** True for missing, malformed, revoked, or invalid API keys (401). */
+    get isUnauthorized(): boolean;
+    /** True when the account balance can't cover the request (402). Top up first. */
+    get isInsufficientCredits(): boolean;
+    /** True for upstream throttling (429). */
+    get isRateLimited(): boolean;
+    /** True for errors worth retrying with backoff: 429, 503, 504. */
+    get isRetryable(): boolean;
 }
 interface SintaksOptions {
     apiKey: string;
@@ -94,6 +145,8 @@ declare class Sintaks {
     readonly baseURL: string;
     readonly chat: ChatResource;
     readonly images: ImagesResource;
+    readonly embeddings: EmbeddingsResource;
+    readonly models: ModelsResource;
     /** @internal */
     readonly fetchFn: typeof fetch;
     /** @internal */
@@ -116,5 +169,16 @@ declare class ImagesResource {
     constructor(client: Sintaks);
     generate(params: ImageGenerationParams): Promise<ImageGenerationResult>;
 }
+declare class ModelsResource {
+    private client;
+    constructor(client: Sintaks);
+    /** Lists the active models served by the gateway (GET /v1/models). */
+    list(): Promise<ModelList>;
+}
+declare class EmbeddingsResource {
+    private client;
+    constructor(client: Sintaks);
+    create(params: EmbeddingCreateParams): Promise<EmbeddingResponse>;
+}
 
-export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, DEFAULT_BASE_URL, DEFAULT_CHAT_MODEL, type ErrorEnvelope, type GeneratedImage, type ImageGenerationParams, type ImageGenerationResult, Sintaks, SintaksError, type SintaksOptions, Sintaks as default };
+export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, DEFAULT_BASE_URL, DEFAULT_CHAT_MODEL, DEFAULT_EMBEDDING_MODEL, DEFAULT_IMAGE_MODEL, type EmbeddingCreateParams, type EmbeddingObject, type EmbeddingResponse, type ErrorEnvelope, type GeneratedImage, type ImageGenerationParams, type ImageGenerationResult, type MessageContentPart, type Model, type ModelList, Sintaks, SintaksError, type SintaksOptions, type Usage, Sintaks as default };

package/dist/index.js

@@ -1,6 +1,8 @@
 // src/index.ts
 var DEFAULT_BASE_URL = "https://api.sintaks.dev";
 var DEFAULT_CHAT_MODEL = "claude-sonnet-5-5";
+var DEFAULT_IMAGE_MODEL = "stable-image-core";
+var DEFAULT_EMBEDDING_MODEL = "qwen3-embedding-0-6b";
 var SintaksError = class extends Error {
   status;
   type;
@@ -14,12 +16,30 @@ var SintaksError = class extends Error {
     this.code = opts.code ?? null;
     this.requestId = opts.requestId ?? null;
   }
+  /** True for missing, malformed, revoked, or invalid API keys (401). */
+  get isUnauthorized() {
+    return this.status === 401;
+  }
+  /** True when the account balance can't cover the request (402). Top up first. */
+  get isInsufficientCredits() {
+    return this.status === 402;
+  }
+  /** True for upstream throttling (429). */
+  get isRateLimited() {
+    return this.status === 429;
+  }
+  /** True for errors worth retrying with backoff: 429, 503, 504. */
+  get isRetryable() {
+    return this.status === 429 || this.status === 503 || this.status === 504;
+  }
 };
 var Sintaks = class {
   apiKey;
   baseURL;
   chat;
   images;
+  embeddings;
+  models;
   /** @internal */
   fetchFn;
   /** @internal */
@@ -32,6 +52,8 @@ var Sintaks = class {
     this.extraHeaders = options.headers ?? {};
     this.chat = new ChatResource(this);
     this.images = new ImagesResource(this);
+    this.embeddings = new EmbeddingsResource(this);
+    this.models = new ModelsResource(this);
   }
   async request(method, path, body) {
     const res = await this.fetchFn(`${this.baseURL}${path}`, {
@@ -82,7 +104,11 @@ var ChatResource = class {
         Accept: "text/event-stream",
         ...this.client.extraHeaders
       },
-      body: JSON.stringify({ ...params, model: params.model ?? DEFAULT_CHAT_MODEL })
+      body: JSON.stringify({
+        ...params,
+        model: params.model ?? DEFAULT_CHAT_MODEL,
+        stream_options: { include_usage: true }
+      })
     });
     if (!res.ok || !res.body) {
       let envelope = {};
@@ -132,13 +158,40 @@ var ImagesResource = class {
   }
   client;
   async generate(params) {
-    return this.client.request("POST", "/v1/images/generations", params);
+    return this.client.request("POST", "/v1/images/generations", {
+      ...params,
+      model: params.model ?? DEFAULT_IMAGE_MODEL
+    });
+  }
+};
+var ModelsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Lists the active models served by the gateway (GET /v1/models). */
+  async list() {
+    return this.client.request("GET", "/v1/models");
+  }
+};
+var EmbeddingsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async create(params) {
+    return this.client.request("POST", "/v1/embeddings", {
+      ...params,
+      model: params.model ?? DEFAULT_EMBEDDING_MODEL
+    });
   }
 };
 var index_default = Sintaks;
 export {
   DEFAULT_BASE_URL,
   DEFAULT_CHAT_MODEL,
+  DEFAULT_EMBEDDING_MODEL,
+  DEFAULT_IMAGE_MODEL,
   Sintaks,
   SintaksError,
   index_default as default

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @sintaksdev/sdk — TypeScript client for the sintaks.dev OpenAI-compatible\n * AI API gateway. Zero runtime dependencies; requires Node >= 18 (global fetch).\n */\n\nexport const DEFAULT_BASE_URL = \"https://api.sintaks.dev\";\nexport const DEFAULT_CHAT_MODEL = \"claude-sonnet-5-5\";\n\n/* ------------------------------------------------------------------ */\n/* Types (OpenAI-compatible shapes)                                    */\n/* ------------------------------------------------------------------ */\n\nexport interface ChatMessage {\n  role: \"system\" | \"user\" | \"assistant\" | \"tool\";\n  content: string;\n  name?: string;\n}\n\nexport interface ChatCompletionCreateParams {\n  model?: string;\n  messages: ChatMessage[];\n  stream?: boolean;\n  temperature?: number;\n  top_p?: number;\n  max_tokens?: number;\n  stop?: string | string[];\n  [key: string]: unknown;\n}\n\nexport interface ChatCompletion {\n  id: string;\n  object: \"chat.completion\";\n  created: number;\n  model: string;\n  choices: {\n    index: number;\n    message: ChatMessage;\n    finish_reason: string | null;\n  }[];\n  usage?: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n  };\n}\n\nexport interface ChatCompletionChunk {\n  id: string;\n  object: \"chat.completion.chunk\";\n  created: number;\n  model: string;\n  choices: {\n    index: number;\n    delta: { role?: string; content?: string | null };\n    finish_reason: string | null;\n  }[];\n}\n\nexport interface ImageGenerationParams {\n  model?: string;\n  prompt: string;\n  n?: number;\n  size?: string;\n  [key: string]: unknown;\n}\n\nexport interface GeneratedImage {\n  url?: string;\n  b64_json?: string;\n}\n\nexport interface ImageGenerationResult {\n  created: number;\n  data: GeneratedImage[];\n}\n\nexport interface ErrorEnvelope {\n  error?: {\n    message?: string;\n    type?: string;\n    param?: string | null;\n    code?: string | null;\n  };\n}\n\n/* ------------------------------------------------------------------ */\n/* Error                                                               */\n/* ------------------------------------------------------------------ */\n\nexport class SintaksError extends Error {\n  readonly status: number;\n  readonly type: string | undefined;\n  readonly code: string | null;\n  readonly requestId: string | null;\n\n  constructor(\n    status: number,\n    message: string,\n    opts: { type?: string; code?: string | null; requestId?: string | null } = {},\n  ) {\n    super(message);\n    this.name = \"SintaksError\";\n    this.status = status;\n    this.type = opts.type;\n    this.code = opts.code ?? null;\n    this.requestId = opts.requestId ?? null;\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Client                                                              */\n/* ------------------------------------------------------------------ */\n\nexport interface SintaksOptions {\n  apiKey: string;\n  baseURL?: string;\n  fetch?: typeof fetch;\n  headers?: Record<string, string>;\n}\n\nexport class Sintaks {\n  readonly apiKey: string;\n  readonly baseURL: string;\n  readonly chat: ChatResource;\n  readonly images: ImagesResource;\n\n  /** @internal */\n  readonly fetchFn: typeof fetch;\n  /** @internal */\n  readonly extraHeaders: Record<string, string>;\n\n  constructor(options: SintaksOptions) {\n    if (!options.apiKey) throw new Error(\"Sintaks: apiKey is required\");\n    this.apiKey = options.apiKey;\n    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.fetchFn = options.fetch ?? fetch;\n    this.extraHeaders = options.headers ?? {};\n    this.chat = new ChatResource(this);\n    this.images = new ImagesResource(this);\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const res = await this.fetchFn(`${this.baseURL}${path}`, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        ...this.extraHeaders,\n      },\n      body: body === undefined ? undefined : JSON.stringify(body),\n    });\n\n    if (!res.ok) {\n      let envelope: ErrorEnvelope = {};\n      try {\n        envelope = (await res.json()) as ErrorEnvelope;\n      } catch {\n        // non-JSON error body; fall through with defaults\n      }\n      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {\n        type: envelope.error?.type,\n        code: envelope.error?.code,\n        requestId: res.headers.get(\"x-request-id\"),\n      });\n    }\n    return (await res.json()) as T;\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Chat                                                                */\n/* ------------------------------------------------------------------ */\n\nclass ChatResource {\n  readonly completions = this;\n\n  constructor(private client: Sintaks) {}\n\n  async create(params: ChatCompletionCreateParams): Promise<ChatCompletion>;\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<AsyncIterable<ChatCompletionChunk>>;\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletion | AsyncIterable<ChatCompletionChunk>> {\n    if (params.stream) {\n      return this.createStream(params as ChatCompletionCreateParams & { stream: true });\n    }\n    return this.client.request<ChatCompletion>(\"POST\", \"/v1/chat/completions\", {\n      ...params,\n      model: params.model ?? DEFAULT_CHAT_MODEL,\n    });\n  }\n\n  private async createStream(\n    params: ChatCompletionCreateParams & { stream: true },\n  ): Promise<AsyncIterable<ChatCompletionChunk>> {\n    const res = await this.client.fetchFn(`${this.client.baseURL}/v1/chat/completions`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.client.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        Accept: \"text/event-stream\",\n        ...this.client.extraHeaders,\n      },\n      body: JSON.stringify({ ...params, model: params.model ?? DEFAULT_CHAT_MODEL }),\n    });\n\n    if (!res.ok || !res.body) {\n      let envelope: ErrorEnvelope = {};\n      try {\n        envelope = (await res.json()) as ErrorEnvelope;\n      } catch {\n        // ignore\n      }\n      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {\n        type: envelope.error?.type,\n        code: envelope.error?.code,\n        requestId: res.headers.get(\"x-request-id\"),\n      });\n    }\n\n    return parseSSE<ChatCompletionChunk>(res.body);\n  }\n}\n\n/** Minimal SSE parser for OpenAI-style `data:` events. */\nasync function* parseSSE<T>(body: ReadableStream<Uint8Array>): AsyncIterable<T> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      buffer += decoder.decode(value, { stream: true });\n\n      let boundary: number;\n      while ((boundary = buffer.indexOf(\"\\n\\n\")) !== -1) {\n        const chunk = buffer.slice(0, boundary);\n        buffer = buffer.slice(boundary + 2);\n        const dataLine = chunk\n          .split(\"\\n\")\n          .find((line) => line.startsWith(\"data:\"));\n        if (!dataLine) continue;\n        const payload = dataLine.slice(5).trim();\n        if (payload === \"[DONE]\") return;\n        try {\n          yield JSON.parse(payload) as T;\n        } catch {\n          // skip malformed event\n        }\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Images                                                              */\n/* ------------------------------------------------------------------ */\n\nclass ImagesResource {\n  constructor(private client: Sintaks) {}\n\n  async generate(params: ImageGenerationParams): Promise<ImageGenerationResult> {\n    return this.client.request<ImageGenerationResult>(\"POST\", \"/v1/images/generations\", params);\n  }\n}\n\nexport default Sintaks;"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @sintaksdev/sdk — TypeScript client for the sintaks.dev OpenAI-compatible\n * AI API gateway. Zero runtime dependencies; requires Node >= 18 (global fetch).\n */\n\nexport const DEFAULT_BASE_URL = \"https://api.sintaks.dev\";\nexport const DEFAULT_CHAT_MODEL = \"claude-sonnet-5-5\";\nexport const DEFAULT_IMAGE_MODEL = \"stable-image-core\";\nexport const DEFAULT_EMBEDDING_MODEL = \"qwen3-embedding-0-6b\";\n\n/* ------------------------------------------------------------------ */\n/* Types (OpenAI-compatible shapes)                                    */\n/* ------------------------------------------------------------------ */\n\nexport type MessageContentPart = { type: \"text\"; text: string };\n\nexport interface ChatMessage {\n  role: \"system\" | \"developer\" | \"user\" | \"assistant\" | \"tool\";\n  content: string | MessageContentPart[];\n  name?: string;\n}\n\nexport interface ChatCompletionCreateParams {\n  model?: string;\n  messages: ChatMessage[];\n  stream?: boolean;\n  stream_options?: { include_usage?: boolean };\n  temperature?: number;\n  top_p?: number;\n  max_tokens?: number;\n  max_completion_tokens?: number;\n  stop?: string | string[];\n  [key: string]: unknown;\n}\n\nexport interface Usage {\n  prompt_tokens: number;\n  completion_tokens: number;\n  total_tokens: number;\n}\n\nexport interface ChatCompletion {\n  id: string;\n  object: \"chat.completion\";\n  created: number;\n  model: string;\n  choices: {\n    index: number;\n    message: ChatMessage;\n    finish_reason: string | null;\n  }[];\n  usage?: Usage;\n}\n\nexport interface ChatCompletionChunk {\n  id: string;\n  object: \"chat.completion.chunk\";\n  created: number;\n  model: string;\n  choices: {\n    index: number;\n    delta: { role?: string; content?: string | null };\n    finish_reason: string | null;\n  }[];\n  usage?: Usage;\n}\n\nexport interface Model {\n  id: string;\n  object: \"model\";\n  created: number;\n  owned_by: string;\n}\n\nexport interface ModelList {\n  object: \"list\";\n  data: Model[];\n}\n\nexport interface ImageGenerationParams {\n  model?: string;\n  prompt: string;\n  n?: number;\n  size?: string;\n  [key: string]: unknown;\n}\n\nexport interface GeneratedImage {\n  url?: string;\n  b64_json?: string;\n}\n\nexport interface ImageGenerationResult {\n  created: number;\n  data: GeneratedImage[];\n}\n\nexport interface EmbeddingCreateParams {\n  model?: string;\n  input: string | string[];\n  encoding_format?: \"float\";\n  dimensions?: number;\n  [key: string]: unknown;\n}\n\nexport interface EmbeddingObject {\n  object: \"embedding\";\n  index: number;\n  embedding: number[];\n}\n\nexport interface EmbeddingResponse {\n  object: \"list\";\n  data: EmbeddingObject[];\n  model: string;\n  usage?: {\n    prompt_tokens: number;\n    total_tokens: number;\n  };\n}\n\nexport interface ErrorEnvelope {\n  error?: {\n    message?: string;\n    type?: string;\n    param?: string | null;\n    code?: string | null;\n  };\n}\n\n/* ------------------------------------------------------------------ */\n/* Error                                                               */\n/* ------------------------------------------------------------------ */\n\nexport class SintaksError extends Error {\n  readonly status: number;\n  readonly type: string | undefined;\n  readonly code: string | null;\n  readonly requestId: string | null;\n\n  constructor(\n    status: number,\n    message: string,\n    opts: { type?: string; code?: string | null; requestId?: string | null } = {},\n  ) {\n    super(message);\n    this.name = \"SintaksError\";\n    this.status = status;\n    this.type = opts.type;\n    this.code = opts.code ?? null;\n    this.requestId = opts.requestId ?? null;\n  }\n\n  /** True for missing, malformed, revoked, or invalid API keys (401). */\n  get isUnauthorized(): boolean {\n    return this.status === 401;\n  }\n\n  /** True when the account balance can't cover the request (402). Top up first. */\n  get isInsufficientCredits(): boolean {\n    return this.status === 402;\n  }\n\n  /** True for upstream throttling (429). */\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n\n  /** True for errors worth retrying with backoff: 429, 503, 504. */\n  get isRetryable(): boolean {\n    return this.status === 429 || this.status === 503 || this.status === 504;\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Client                                                              */\n/* ------------------------------------------------------------------ */\n\nexport interface SintaksOptions {\n  apiKey: string;\n  baseURL?: string;\n  fetch?: typeof fetch;\n  headers?: Record<string, string>;\n}\n\nexport class Sintaks {\n  readonly apiKey: string;\n  readonly baseURL: string;\n  readonly chat: ChatResource;\n  readonly images: ImagesResource;\n  readonly embeddings: EmbeddingsResource;\n  readonly models: ModelsResource;\n\n  /** @internal */\n  readonly fetchFn: typeof fetch;\n  /** @internal */\n  readonly extraHeaders: Record<string, string>;\n\n  constructor(options: SintaksOptions) {\n    if (!options.apiKey) throw new Error(\"Sintaks: apiKey is required\");\n    this.apiKey = options.apiKey;\n    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.fetchFn = options.fetch ?? fetch;\n    this.extraHeaders = options.headers ?? {};\n    this.chat = new ChatResource(this);\n    this.images = new ImagesResource(this);\n    this.embeddings = new EmbeddingsResource(this);\n    this.models = new ModelsResource(this);\n  }\n\n  async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const res = await this.fetchFn(`${this.baseURL}${path}`, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        ...this.extraHeaders,\n      },\n      body: body === undefined ? undefined : JSON.stringify(body),\n    });\n\n    if (!res.ok) {\n      let envelope: ErrorEnvelope = {};\n      try {\n        envelope = (await res.json()) as ErrorEnvelope;\n      } catch {\n        // non-JSON error body; fall through with defaults\n      }\n      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {\n        type: envelope.error?.type,\n        code: envelope.error?.code,\n        requestId: res.headers.get(\"x-request-id\"),\n      });\n    }\n    return (await res.json()) as T;\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Chat                                                                */\n/* ------------------------------------------------------------------ */\n\nclass ChatResource {\n  readonly completions = this;\n\n  constructor(private client: Sintaks) {}\n\n  async create(params: ChatCompletionCreateParams): Promise<ChatCompletion>;\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<AsyncIterable<ChatCompletionChunk>>;\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletion | AsyncIterable<ChatCompletionChunk>> {\n    if (params.stream) {\n      return this.createStream(params as ChatCompletionCreateParams & { stream: true });\n    }\n    return this.client.request<ChatCompletion>(\"POST\", \"/v1/chat/completions\", {\n      ...params,\n      model: params.model ?? DEFAULT_CHAT_MODEL,\n    });\n  }\n\n  private async createStream(\n    params: ChatCompletionCreateParams & { stream: true },\n  ): Promise<AsyncIterable<ChatCompletionChunk>> {\n    const res = await this.client.fetchFn(`${this.client.baseURL}/v1/chat/completions`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${this.client.apiKey}`,\n        \"Content-Type\": \"application/json\",\n        Accept: \"text/event-stream\",\n        ...this.client.extraHeaders,\n      },\n      body: JSON.stringify({\n        ...params,\n        model: params.model ?? DEFAULT_CHAT_MODEL,\n        stream_options: { include_usage: true },\n      }),\n    });\n\n    if (!res.ok || !res.body) {\n      let envelope: ErrorEnvelope = {};\n      try {\n        envelope = (await res.json()) as ErrorEnvelope;\n      } catch {\n        // ignore\n      }\n      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {\n        type: envelope.error?.type,\n        code: envelope.error?.code,\n        requestId: res.headers.get(\"x-request-id\"),\n      });\n    }\n\n    return parseSSE<ChatCompletionChunk>(res.body);\n  }\n}\n\n/** Minimal SSE parser for OpenAI-style `data:` events. */\nasync function* parseSSE<T>(body: ReadableStream<Uint8Array>): AsyncIterable<T> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      buffer += decoder.decode(value, { stream: true });\n\n      let boundary: number;\n      while ((boundary = buffer.indexOf(\"\\n\\n\")) !== -1) {\n        const chunk = buffer.slice(0, boundary);\n        buffer = buffer.slice(boundary + 2);\n        const dataLine = chunk\n          .split(\"\\n\")\n          .find((line) => line.startsWith(\"data:\"));\n        if (!dataLine) continue;\n        const payload = dataLine.slice(5).trim();\n        if (payload === \"[DONE]\") return;\n        try {\n          yield JSON.parse(payload) as T;\n        } catch {\n          // skip malformed event\n        }\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Images                                                              */\n/* ------------------------------------------------------------------ */\n\nclass ImagesResource {\n  constructor(private client: Sintaks) {}\n\n  async generate(params: ImageGenerationParams): Promise<ImageGenerationResult> {\n    return this.client.request<ImageGenerationResult>(\"POST\", \"/v1/images/generations\", {\n      ...params,\n      model: params.model ?? DEFAULT_IMAGE_MODEL,\n    });\n  }\n}\n\nclass ModelsResource {\n  constructor(private client: Sintaks) {}\n\n  /** Lists the active models served by the gateway (GET /v1/models). */\n  async list(): Promise<ModelList> {\n    return this.client.request<ModelList>(\"GET\", \"/v1/models\");\n  }\n}\n\n/* ------------------------------------------------------------------ */\n/* Embeddings                                                          */\n/* ------------------------------------------------------------------ */\n\nclass EmbeddingsResource {\n  constructor(private client: Sintaks) {}\n\n  async create(params: EmbeddingCreateParams): Promise<EmbeddingResponse> {\n    return this.client.request<EmbeddingResponse>(\"POST\", \"/v1/embeddings\", {\n      ...params,\n      model: params.model ?? DEFAULT_EMBEDDING_MODEL,\n    });\n  }\n}\n\nexport default Sintaks;"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sintaksdev/sdk",
-  "version": "0.1.0",
+  "version": "1.1.0",
   "description": "TypeScript client for the sintaks.dev OpenAI-compatible AI API gateway. Top up in IDR, call chat and image models, pay per request.",
   "license": "MIT",
   "type": "module",