@sintaksdev/sdk 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# @sintaksdev/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+TypeScript client for the [sintaks.dev](https://sintaks.dev) OpenAI-compatible AI API gateway. Top up in IDR via QRIS/iPaymu, call chat and image models, and pay per request. Zero runtime dependencies (Node >= 18, global `fetch`).
+
+## Install
+
+```bash
+pnpm add @sintaksdev/sdk
+# or
+npm install @sintaksdev/sdk
+```
+
+## Usage
+
+```ts
+import { Sintaks } from "@sintaksdev/sdk";
+
+const client = new Sintaks({ apiKey: "sk-..." });
+
+// Non-streaming chat
+const resp = await client.chat.completions.create({
+  model: "claude-sonnet-5-5",
+  messages: [{ role: "user", content: "Halo!" }],
+});
+console.log(resp.choices[0]?.message.content);
+
+// Streaming
+const stream = await client.chat.completions.create({
+  model: "claude-sonnet-5-5",
+  messages: [{ role: "user", content: "Halo!" }],
+  stream: true,
+});
+for await (const chunk of stream) {
+  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
+}
+
+// Image generation
+const images = await client.images.generate({
+  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` 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" });
+```
+
+## Errors
+
+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) {
+    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}`);
+  }
+}
+```
+
+## Development & publishing
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm build          # tsup → dist/ (ESM + CJS + types)
+pnpm pack           # inspect the publish tarball
+npm login           # one-time auth for your npm account
+npm publish         # requires an account with access to the @sintaksdev scope
+```
+
+`prepublishOnly` runs the build automatically, so `npm publish` ships fresh `dist/`. Publish to a different registry (e.g. GitHub Packages, Verdaccio) with `npm publish --registry <url>`.

package/dist/index.cjs

@@ -0,0 +1,212 @@
+"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, {
+  DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
+  DEFAULT_CHAT_MODEL: () => DEFAULT_CHAT_MODEL,
+  DEFAULT_IMAGE_MODEL: () => DEFAULT_IMAGE_MODEL,
+  Sintaks: () => Sintaks,
+  SintaksError: () => SintaksError,
+  default: () => index_default
+});
+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 SintaksError = class extends Error {
+  status;
+  type;
+  code;
+  requestId;
+  constructor(status, message, opts = {}) {
+    super(message);
+    this.name = "SintaksError";
+    this.status = status;
+    this.type = opts.type;
+    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;
+  models;
+  /** @internal */
+  fetchFn;
+  /** @internal */
+  extraHeaders;
+  constructor(options) {
+    if (!options.apiKey) throw new Error("Sintaks: apiKey is required");
+    this.apiKey = options.apiKey;
+    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.fetchFn = options.fetch ?? fetch;
+    this.extraHeaders = options.headers ?? {};
+    this.chat = new ChatResource(this);
+    this.images = new ImagesResource(this);
+    this.models = new ModelsResource(this);
+  }
+  async request(method, path, body) {
+    const res = await this.fetchFn(`${this.baseURL}${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        ...this.extraHeaders
+      },
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    if (!res.ok) {
+      let envelope = {};
+      try {
+        envelope = await res.json();
+      } catch {
+      }
+      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {
+        type: envelope.error?.type,
+        code: envelope.error?.code,
+        requestId: res.headers.get("x-request-id")
+      });
+    }
+    return await res.json();
+  }
+};
+var ChatResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  completions = this;
+  async create(params) {
+    if (params.stream) {
+      return this.createStream(params);
+    }
+    return this.client.request("POST", "/v1/chat/completions", {
+      ...params,
+      model: params.model ?? DEFAULT_CHAT_MODEL
+    });
+  }
+  async createStream(params) {
+    const res = await this.client.fetchFn(`${this.client.baseURL}/v1/chat/completions`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.client.apiKey}`,
+        "Content-Type": "application/json",
+        Accept: "text/event-stream",
+        ...this.client.extraHeaders
+      },
+      body: JSON.stringify({
+        ...params,
+        model: params.model ?? DEFAULT_CHAT_MODEL,
+        stream_options: { include_usage: true }
+      })
+    });
+    if (!res.ok || !res.body) {
+      let envelope = {};
+      try {
+        envelope = await res.json();
+      } catch {
+      }
+      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {
+        type: envelope.error?.type,
+        code: envelope.error?.code,
+        requestId: res.headers.get("x-request-id")
+      });
+    }
+    return parseSSE(res.body);
+  }
+};
+async function* parseSSE(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      let boundary;
+      while ((boundary = buffer.indexOf("\n\n")) !== -1) {
+        const chunk = buffer.slice(0, boundary);
+        buffer = buffer.slice(boundary + 2);
+        const dataLine = chunk.split("\n").find((line) => line.startsWith("data:"));
+        if (!dataLine) continue;
+        const payload = dataLine.slice(5).trim();
+        if (payload === "[DONE]") return;
+        try {
+          yield JSON.parse(payload);
+        } catch {
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+var ImagesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async generate(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 index_default = Sintaks;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_BASE_URL,
+  DEFAULT_CHAT_MODEL,
+  DEFAULT_IMAGE_MODEL,
+  Sintaks,
+  SintaksError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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\";\nexport const DEFAULT_IMAGE_MODEL = \"stable-image-core\";\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 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 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.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\nexport default Sintaks;"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,156 @@
+/**
+ * @sintaksdev/sdk — TypeScript client for the sintaks.dev OpenAI-compatible
+ * AI API gateway. Zero runtime dependencies; requires Node >= 18 (global fetch).
+ */
+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";
+type MessageContentPart = {
+    type: "text";
+    text: string;
+};
+interface ChatMessage {
+    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";
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        message: ChatMessage;
+        finish_reason: string | null;
+    }[];
+    usage?: Usage;
+}
+interface ChatCompletionChunk {
+    id: string;
+    object: "chat.completion.chunk";
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        delta: {
+            role?: string;
+            content?: string | null;
+        };
+        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;
+    prompt: string;
+    n?: number;
+    size?: string;
+    [key: string]: unknown;
+}
+interface GeneratedImage {
+    url?: string;
+    b64_json?: string;
+}
+interface ImageGenerationResult {
+    created: number;
+    data: GeneratedImage[];
+}
+interface ErrorEnvelope {
+    error?: {
+        message?: string;
+        type?: string;
+        param?: string | null;
+        code?: string | null;
+    };
+}
+declare class SintaksError extends Error {
+    readonly status: number;
+    readonly type: string | undefined;
+    readonly code: string | null;
+    readonly requestId: string | null;
+    constructor(status: number, message: string, opts?: {
+        type?: string;
+        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;
+    baseURL?: string;
+    fetch?: typeof fetch;
+    headers?: Record<string, string>;
+}
+declare class Sintaks {
+    readonly apiKey: string;
+    readonly baseURL: string;
+    readonly chat: ChatResource;
+    readonly images: ImagesResource;
+    readonly models: ModelsResource;
+    /** @internal */
+    readonly fetchFn: typeof fetch;
+    /** @internal */
+    readonly extraHeaders: Record<string, string>;
+    constructor(options: SintaksOptions);
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+}
+declare class ChatResource {
+    private client;
+    readonly completions: this;
+    constructor(client: Sintaks);
+    create(params: ChatCompletionCreateParams): Promise<ChatCompletion>;
+    create(params: ChatCompletionCreateParams & {
+        stream: true;
+    }): Promise<AsyncIterable<ChatCompletionChunk>>;
+    private createStream;
+}
+declare class ImagesResource {
+    private client;
+    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>;
+}
+
+export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, DEFAULT_BASE_URL, DEFAULT_CHAT_MODEL, DEFAULT_IMAGE_MODEL, 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

@@ -0,0 +1,156 @@
+/**
+ * @sintaksdev/sdk — TypeScript client for the sintaks.dev OpenAI-compatible
+ * AI API gateway. Zero runtime dependencies; requires Node >= 18 (global fetch).
+ */
+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";
+type MessageContentPart = {
+    type: "text";
+    text: string;
+};
+interface ChatMessage {
+    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";
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        message: ChatMessage;
+        finish_reason: string | null;
+    }[];
+    usage?: Usage;
+}
+interface ChatCompletionChunk {
+    id: string;
+    object: "chat.completion.chunk";
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        delta: {
+            role?: string;
+            content?: string | null;
+        };
+        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;
+    prompt: string;
+    n?: number;
+    size?: string;
+    [key: string]: unknown;
+}
+interface GeneratedImage {
+    url?: string;
+    b64_json?: string;
+}
+interface ImageGenerationResult {
+    created: number;
+    data: GeneratedImage[];
+}
+interface ErrorEnvelope {
+    error?: {
+        message?: string;
+        type?: string;
+        param?: string | null;
+        code?: string | null;
+    };
+}
+declare class SintaksError extends Error {
+    readonly status: number;
+    readonly type: string | undefined;
+    readonly code: string | null;
+    readonly requestId: string | null;
+    constructor(status: number, message: string, opts?: {
+        type?: string;
+        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;
+    baseURL?: string;
+    fetch?: typeof fetch;
+    headers?: Record<string, string>;
+}
+declare class Sintaks {
+    readonly apiKey: string;
+    readonly baseURL: string;
+    readonly chat: ChatResource;
+    readonly images: ImagesResource;
+    readonly models: ModelsResource;
+    /** @internal */
+    readonly fetchFn: typeof fetch;
+    /** @internal */
+    readonly extraHeaders: Record<string, string>;
+    constructor(options: SintaksOptions);
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+}
+declare class ChatResource {
+    private client;
+    readonly completions: this;
+    constructor(client: Sintaks);
+    create(params: ChatCompletionCreateParams): Promise<ChatCompletion>;
+    create(params: ChatCompletionCreateParams & {
+        stream: true;
+    }): Promise<AsyncIterable<ChatCompletionChunk>>;
+    private createStream;
+}
+declare class ImagesResource {
+    private client;
+    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>;
+}
+
+export { type ChatCompletion, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatMessage, DEFAULT_BASE_URL, DEFAULT_CHAT_MODEL, DEFAULT_IMAGE_MODEL, 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

@@ -0,0 +1,183 @@
+// 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 SintaksError = class extends Error {
+  status;
+  type;
+  code;
+  requestId;
+  constructor(status, message, opts = {}) {
+    super(message);
+    this.name = "SintaksError";
+    this.status = status;
+    this.type = opts.type;
+    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;
+  models;
+  /** @internal */
+  fetchFn;
+  /** @internal */
+  extraHeaders;
+  constructor(options) {
+    if (!options.apiKey) throw new Error("Sintaks: apiKey is required");
+    this.apiKey = options.apiKey;
+    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.fetchFn = options.fetch ?? fetch;
+    this.extraHeaders = options.headers ?? {};
+    this.chat = new ChatResource(this);
+    this.images = new ImagesResource(this);
+    this.models = new ModelsResource(this);
+  }
+  async request(method, path, body) {
+    const res = await this.fetchFn(`${this.baseURL}${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        ...this.extraHeaders
+      },
+      body: body === void 0 ? void 0 : JSON.stringify(body)
+    });
+    if (!res.ok) {
+      let envelope = {};
+      try {
+        envelope = await res.json();
+      } catch {
+      }
+      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {
+        type: envelope.error?.type,
+        code: envelope.error?.code,
+        requestId: res.headers.get("x-request-id")
+      });
+    }
+    return await res.json();
+  }
+};
+var ChatResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  completions = this;
+  async create(params) {
+    if (params.stream) {
+      return this.createStream(params);
+    }
+    return this.client.request("POST", "/v1/chat/completions", {
+      ...params,
+      model: params.model ?? DEFAULT_CHAT_MODEL
+    });
+  }
+  async createStream(params) {
+    const res = await this.client.fetchFn(`${this.client.baseURL}/v1/chat/completions`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.client.apiKey}`,
+        "Content-Type": "application/json",
+        Accept: "text/event-stream",
+        ...this.client.extraHeaders
+      },
+      body: JSON.stringify({
+        ...params,
+        model: params.model ?? DEFAULT_CHAT_MODEL,
+        stream_options: { include_usage: true }
+      })
+    });
+    if (!res.ok || !res.body) {
+      let envelope = {};
+      try {
+        envelope = await res.json();
+      } catch {
+      }
+      throw new SintaksError(res.status, envelope.error?.message ?? `request failed with ${res.status}`, {
+        type: envelope.error?.type,
+        code: envelope.error?.code,
+        requestId: res.headers.get("x-request-id")
+      });
+    }
+    return parseSSE(res.body);
+  }
+};
+async function* parseSSE(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      let boundary;
+      while ((boundary = buffer.indexOf("\n\n")) !== -1) {
+        const chunk = buffer.slice(0, boundary);
+        buffer = buffer.slice(boundary + 2);
+        const dataLine = chunk.split("\n").find((line) => line.startsWith("data:"));
+        if (!dataLine) continue;
+        const payload = dataLine.slice(5).trim();
+        if (payload === "[DONE]") return;
+        try {
+          yield JSON.parse(payload);
+        } catch {
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+var ImagesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async generate(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 index_default = Sintaks;
+export {
+  DEFAULT_BASE_URL,
+  DEFAULT_CHAT_MODEL,
+  DEFAULT_IMAGE_MODEL,
+  Sintaks,
+  SintaksError,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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\";\nexport const DEFAULT_IMAGE_MODEL = \"stable-image-core\";\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 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 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.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\nexport default Sintaks;"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@sintaksdev/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.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",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "openai",
+    "sintaks",
+    "ai",
+    "api",
+    "llm",
+    "indonesia",
+    "qris"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rendies/sintaks-dev-sdk-js.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.29.3",
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}