@codefionn/llmleaf-client 0.1.2

package/README.md

@@ -0,0 +1,173 @@
+# @codefionn/llmleaf-client
+
+Official TypeScript / JavaScript client for the [llmleaf](../../) LLM proxy.
+
+The wire is **OpenAI/OpenRouter-shaped JSON over HTTP** (see [`../SPEC.md`](../SPEC.md)),
+not protobuf-binary. The [proto](../proto/llmleaf/v1/llmleaf.proto) is the typed source of
+truth; the `protobuf-es` codegen artifact is committed under [`src/gen`](src/gen) and a
+hand-written `fetch`-based transport maps the public model to/from the wire JSON.
+
+Zero runtime dependencies beyond the `@bufbuild/protobuf` runtime (used for the generated
+enum/descriptor types). Works in Node 20+, Deno, Bun and browsers — anywhere a global
+`fetch` / `ReadableStream` / `FormData` / `Blob` exists.
+
+## Install
+
+```sh
+npm install @codefionn/llmleaf-client
+```
+
+## Quickstart
+
+```ts
+import { LlmleafClient, Role } from "@codefionn/llmleaf-client";
+
+const client = new LlmleafClient({
+  baseUrl: "https://gateway.example.com",
+  apiKey: process.env.LLMLEAF_API_KEY!,
+  timeoutMs: 30_000,        // optional per-request timeout (0/omitted = no timeout)
+  adminToken: "…",          // optional; enables admin-only fields
+  // fetch: customFetch,    // optional; defaults to the global fetch
+});
+
+// Non-streaming chat
+const res = await client.chat({
+  model: "gpt-4o-mini",
+  messages: [{ role: Role.USER, content: "Say hi." }],
+});
+console.log(res.choices[0]?.message.content);
+
+// Streaming chat — async iterable of ChatCompletionChunk, stops at `data: [DONE]`
+for await (const chunk of client.chatStream({
+  model: "gpt-4o-mini",
+  messages: [{ role: Role.USER, content: "Count to 5." }],
+})) {
+  process.stdout.write(chunk.choices[0]?.delta.content ?? "");
+}
+```
+
+### Every endpoint
+
+```ts
+await client.chat(req);                       // POST /v1/chat/completions
+client.chatStream(req);                        // POST /v1/chat/completions (stream:true)
+await client.embeddings(req);                  // POST /v1/embeddings (base64 decoded to floats)
+await client.listModels({ type: "llm" });      // GET  /v1/models  (admin:true adds endpoints)
+await client.speech(req);                       // POST /v1/audio/speech -> { bytes, contentType }
+await client.voices("tts-1");                   // GET  /v1/audio/voices
+await client.transcribe(file, req);             // POST /v1/audio/transcriptions (multipart)
+await client.createBatch(req);                  // POST /v1/batches
+await client.getBatch(id);                      // GET  /v1/batches/{id}
+await client.cancelBatch(id);                   // POST /v1/batches/{id}/cancel
+client.batchResults(id);                        // GET  /v1/batches/{id}/results (async iterable)
+```
+
+Speech returns the raw audio bytes plus the server's content type:
+
+```ts
+const { bytes, contentType } = await client.speech({
+  model: "tts-1", input: "hello", voice: "alloy", responseFormat: "mp3",
+});
+```
+
+Transcription takes the audio as a `Blob`/`Uint8Array`/`ArrayBuffer` + filename:
+
+```ts
+const tr = await client.transcribe(
+  { data: audioBytes, filename: "audio.mp3", contentType: "audio/mpeg" },
+  { model: "whisper-1", responseFormat: "json" },
+);
+// json / verbose_json -> structured TranscriptionResponse
+// text / srt / vtt     -> plain text in tr.text
+```
+
+### Free-form JSON fields
+
+`ChatRequest.extra`, `FunctionDef.parameters`, `ResponseFormat.jsonSchema`,
+`EmbeddingRequest.extra`, `SpeechRequest.extra` and `ModelEntry.defaultParameters` are
+**raw JSON strings** — you pass a `JSON.stringify(...)`d object, the transport splices the
+parsed value into the wire body (and `extra` keys are merged at the top level). On decode,
+sub-objects are captured back as raw JSON strings.
+
+```ts
+await client.chat({
+  model: "gpt-4o-mini",
+  messages: [{ role: Role.USER, content: "hi" }],
+  responseFormat: { type: "json_schema", jsonSchema: JSON.stringify({ type: "object" }) },
+  extra: JSON.stringify({ provider: { order: ["openai"] } }),
+});
+```
+
+### Errors
+
+Any non-2xx response throws a typed `ApiError`:
+
+```ts
+import { ApiError } from "@codefionn/llmleaf-client";
+
+try {
+  await client.chat(/* … */);
+} catch (e) {
+  if (e instanceof ApiError) {
+    console.error(e.status, e.message, e.code); // 403 "model not allowed" "blocked"
+  }
+}
+```
+
+Status codes: 400 bad request · 401 missing/invalid key · 403 blocked or model-not-allowed
+· 404 no route for model · 429 key suspended · 502 all upstreams failed.
+
+## Example
+
+[`examples/basic.ts`](examples/basic.ts) runs non-streaming chat, streaming chat and a model
+list. It reads `LLMLEAF_BASE_URL` / `LLMLEAF_API_KEY` (and optional `LLMLEAF_MODEL`):
+
+```sh
+LLMLEAF_BASE_URL=https://gateway.example.com LLMLEAF_API_KEY=sk-… npx tsx examples/basic.ts
+```
+
+## Regenerate the typed model from the proto
+
+The proto is the source of truth. The generated file (`src/gen/llmleaf/v1/llmleaf_pb.ts`)
+is committed; regenerate it after the proto changes:
+
+```sh
+npm install      # fetch the @bufbuild/protoc-gen-es plugin into node_modules/.bin
+npm run gen      # runs scripts/gen.sh
+```
+
+`scripts/gen.sh` invokes:
+
+```sh
+protoc --plugin=protoc-gen-es=./node_modules/.bin/protoc-gen-es \
+  --es_out=src/gen --es_opt=target=ts \
+  --proto_path=../proto ../proto/llmleaf/v1/llmleaf.proto
+```
+
+**Toolchain:** `protoc` (libprotoc 35) on `PATH`, plus `@bufbuild/protoc-gen-es`
+(devDependency — run `npm install` first). From the repo root, `make gen-ts` delegates here.
+
+## Scripts
+
+| Command            | What it does                                              |
+|--------------------|----------------------------------------------------------|
+| `npm run gen`      | Regenerate `src/gen` from the proto.                     |
+| `npm run typecheck`| `tsc --noEmit` over `src` + `examples`.                  |
+| `npm run build`    | Emit ESM + `.d.ts` to `dist/` (library only, Node-free). |
+| `npm run example`  | Run `examples/basic.ts` with `tsx`.                      |
+
+## Caveats (honest)
+
+- **Wire mapping is hand-written.** protobuf-es's own JSON codec emits camelCase keys and
+  `SCREAMING_CASE` enum names, which do **not** match the OpenAI wire (snake_case keys +
+  lowercase tokens like `"assistant"`). So the public surface is plain TS interfaces and
+  [`src/wire.ts`](src/wire.ts) does the mapping; the generated descriptors stay available
+  under the `gen` export for advanced reflection use.
+- **Decoders are lenient.** Responses are parsed defensively (missing/extra fields tolerated,
+  the server is authoritative); they do not strictly validate every field.
+- **No retries / backoff.** One request per call. Wrap calls yourself if you need retries.
+- **Streaming needs a `ReadableStream` body.** Some exotic `fetch` polyfills buffer the whole
+  response; use a streaming-capable fetch for `chatStream` / `batchResults`.
+- **Realtime WebSocket is out of scope** for all llmleaf SDKs (per the repo README).
+- **Node < 18** has no global `fetch`/`FormData`; pass a `fetch` implementation and run on
+  Node 20+ for `FormData`/`Blob` in transcriptions.

package/dist/client.d.ts

@@ -0,0 +1,73 @@
+import type { ChatRequest, ChatResponse, ChatCompletionChunk, EmbeddingRequest, EmbeddingResponse, SpeechRequest, SpeechResult, VoicesResponse, TranscriptionRequest, TranscriptionResponse, ListModelsResponse, ListModelsOptions, BatchCreateRequest, BatchHandle, BatchResultLine } from "./types.js";
+/** The subset of the WHATWG `fetch` signature this client uses. */
+export type FetchLike = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export interface LlmleafClientOptions {
+    /** Gateway base URL, e.g. "https://gateway.example.com". */
+    baseUrl: string;
+    /** API key sent as `Authorization: Bearer <apiKey>`. */
+    apiKey: string;
+    /** Per-request timeout in milliseconds. 0 / omitted disables the timeout. */
+    timeoutMs?: number;
+    /** Optional admin token; sent as `x-admin-token` when an endpoint opts in. */
+    adminToken?: string;
+    /** Inject a custom fetch (defaults to the global `fetch`). */
+    fetch?: FetchLike;
+}
+/** Audio file input for transcriptions: bytes + a filename. */
+export interface TranscriptionFile {
+    /** A Blob/File, or raw bytes. */
+    data: Blob | Uint8Array | ArrayBuffer;
+    /** Filename for the multipart part (e.g. "audio.mp3"). */
+    filename: string;
+    /** Optional content type when `data` is not already a Blob. */
+    contentType?: string;
+}
+export declare class LlmleafClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    private readonly adminToken?;
+    private readonly fetchImpl;
+    constructor(options: LlmleafClientOptions);
+    private url;
+    private headers;
+    /** Issue a request with the configured timeout; returns the raw Response. */
+    private send;
+    /** Send a JSON request and return the parsed JSON body, or throw ApiError. */
+    private sendJson;
+    /** POST /v1/chat/completions (non-streaming). */
+    chat(req: ChatRequest): Promise<ChatResponse>;
+    /**
+     * POST /v1/chat/completions with `stream:true`. Returns an async iterable of
+     * {@link ChatCompletionChunk}; stops at the `data: [DONE]` sentinel.
+     */
+    chatStream(req: ChatRequest): AsyncGenerator<ChatCompletionChunk, void, unknown>;
+    /** POST /v1/embeddings. Base64 embeddings are decoded to float arrays. */
+    embeddings(req: EmbeddingRequest): Promise<EmbeddingResponse>;
+    /** GET /v1/models. Pass `admin:true` to include per-model `endpoints`. */
+    listModels(opts?: ListModelsOptions): Promise<ListModelsResponse>;
+    /** POST /v1/audio/speech. Returns the raw audio bytes + Content-Type. */
+    speech(req: SpeechRequest): Promise<SpeechResult>;
+    /** GET /v1/audio/voices?model=<id>. */
+    voices(model: string): Promise<VoicesResponse>;
+    /**
+     * POST /v1/audio/transcriptions (multipart/form-data).
+     *
+     * For `responseFormat` json/verbose_json the structured
+     * {@link TranscriptionResponse} is returned; for text/srt/vtt the response is a
+     * plain-text body and the returned object carries it in `.text` (other fields empty).
+     */
+    transcribe(file: TranscriptionFile, req: TranscriptionRequest): Promise<TranscriptionResponse>;
+    /** POST /v1/batches. */
+    createBatch(req: BatchCreateRequest): Promise<BatchHandle>;
+    /** GET /v1/batches/{id}. */
+    getBatch(id: string): Promise<BatchHandle>;
+    /** POST /v1/batches/{id}/cancel. */
+    cancelBatch(id: string): Promise<BatchHandle>;
+    /**
+     * GET /v1/batches/{id}/results — an async iterable of {@link BatchResultLine}
+     * (one per NDJSON line).
+     */
+    batchResults(id: string): AsyncGenerator<BatchResultLine, void, unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,GAAG,GAAG,EACnB,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,IAAI,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,OAAO,EAAE,oBAAoB;IAqBzC,OAAO,CAAC,GAAG;IAaX,OAAO,CAAC,OAAO;IAMf,6EAA6E;YAC/D,IAAI;IAalB,8EAA8E;YAChE,QAAQ;IAkBtB,iDAAiD;IAC3C,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAMnD;;;OAGG;IACI,UAAU,CACf,GAAG,EAAE,WAAW,GACf,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,OAAO,CAAC;IAuBrD,0EAA0E;IACpE,UAAU,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUnE,0EAA0E;IACpE,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuB3E,yEAAyE;IACnE,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBvD,uCAAuC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAOpD;;;;;;OAMG;IACG,UAAU,CACd,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,qBAAqB,CAAC;IAoCjC,wBAAwB;IAClB,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAMhE,4BAA4B;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAShD,oCAAoC;IAC9B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASnD;;;OAGG;IACI,YAAY,CACjB,EAAE,EAAE,MAAM,GACT,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,OAAO,CAAC;CAWlD"}

package/dist/client.js

@@ -0,0 +1,259 @@
+// LlmleafClient — the fetch-based HTTP transport. One method per SPEC.md endpoint.
+//
+// Runtime-agnostic: relies only on global fetch / Request / Response / FormData /
+// Blob / AbortController, all present in Node 20+, Deno, Bun and browsers. A custom
+// fetch can be injected (testing, proxies, custom agents).
+import { ApiError, apiErrorFromResponse } from "./error.js";
+import { parseSseData, parseNdjson } from "./stream.js";
+import { encodeChatRequest, decodeChatResponse, decodeChatCompletionChunk, encodeEmbeddingRequest, decodeEmbeddingResponse, encodeSpeechRequest, decodeVoicesResponse, decodeTranscriptionResponse, decodeListModelsResponse, encodeBatchCreateRequest, decodeBatchHandle, decodeBatchResultLine, } from "./wire.js";
+const SPEECH_CONTENT_TYPES = {
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    opus: "audio/ogg",
+    aac: "audio/aac",
+    flac: "audio/flac",
+    pcm: "audio/pcm",
+};
+export class LlmleafClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    adminToken;
+    fetchImpl;
+    constructor(options) {
+        if (!options.baseUrl)
+            throw new TypeError("LlmleafClient: baseUrl is required");
+        if (!options.apiKey)
+            throw new TypeError("LlmleafClient: apiKey is required");
+        // Strip a single trailing slash so path joins are predictable.
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.apiKey = options.apiKey;
+        this.timeoutMs = options.timeoutMs ?? 0;
+        this.adminToken = options.adminToken;
+        const f = options.fetch ?? globalThis.fetch;
+        if (!f) {
+            throw new TypeError("LlmleafClient: no global fetch available; pass `fetch` in the options (Node <18, or a non-fetch runtime).");
+        }
+        this.fetchImpl = f;
+    }
+    // -------------------------------------------------------------------------
+    // Internal request plumbing
+    // -------------------------------------------------------------------------
+    url(path, query) {
+        let u = this.baseUrl + path;
+        if (query) {
+            const params = new URLSearchParams();
+            for (const [k, v] of Object.entries(query)) {
+                if (v !== undefined)
+                    params.set(k, v);
+            }
+            const qs = params.toString();
+            if (qs)
+                u += "?" + qs;
+        }
+        return u;
+    }
+    headers(extra) {
+        const h = new Headers({ authorization: `Bearer ${this.apiKey}` });
+        if (extra)
+            for (const [k, v] of Object.entries(extra))
+                h.set(k, v);
+        return h;
+    }
+    /** Issue a request with the configured timeout; returns the raw Response. */
+    async send(url, init) {
+        if (this.timeoutMs <= 0) {
+            return this.fetchImpl(url, init);
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            return await this.fetchImpl(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** Send a JSON request and return the parsed JSON body, or throw ApiError. */
+    async sendJson(url, body, headers) {
+        const res = await this.send(url, {
+            method: "POST",
+            headers: this.headers({ "content-type": "application/json", ...headers }),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw await apiErrorFromResponse(res);
+        return res.json();
+    }
+    // -------------------------------------------------------------------------
+    // Chat completions
+    // -------------------------------------------------------------------------
+    /** POST /v1/chat/completions (non-streaming). */
+    async chat(req) {
+        const body = encodeChatRequest(req, false);
+        const json = await this.sendJson(this.url("/v1/chat/completions"), body);
+        return decodeChatResponse(json);
+    }
+    /**
+     * POST /v1/chat/completions with `stream:true`. Returns an async iterable of
+     * {@link ChatCompletionChunk}; stops at the `data: [DONE]` sentinel.
+     */
+    async *chatStream(req) {
+        const body = encodeChatRequest(req, true);
+        const res = await this.send(this.url("/v1/chat/completions"), {
+            method: "POST",
+            headers: this.headers({
+                "content-type": "application/json",
+                accept: "text/event-stream",
+            }),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw await apiErrorFromResponse(res);
+        if (!res.body) {
+            throw new ApiError(res.status, "streaming response had no body");
+        }
+        for await (const payload of parseSseData(res.body)) {
+            yield decodeChatCompletionChunk(JSON.parse(payload));
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Embeddings
+    // -------------------------------------------------------------------------
+    /** POST /v1/embeddings. Base64 embeddings are decoded to float arrays. */
+    async embeddings(req) {
+        const body = encodeEmbeddingRequest(req);
+        const json = await this.sendJson(this.url("/v1/embeddings"), body);
+        return decodeEmbeddingResponse(json);
+    }
+    // -------------------------------------------------------------------------
+    // Model catalog
+    // -------------------------------------------------------------------------
+    /** GET /v1/models. Pass `admin:true` to include per-model `endpoints`. */
+    async listModels(opts = {}) {
+        const headers = {};
+        if (opts.admin) {
+            if (!this.adminToken) {
+                throw new TypeError("listModels({ admin:true }) requires an adminToken in the client options");
+            }
+            headers["x-admin-token"] = this.adminToken;
+        }
+        const url = this.url("/v1/models", { type: opts.type, search: opts.search });
+        const res = await this.send(url, {
+            method: "GET",
+            headers: this.headers(headers),
+        });
+        if (!res.ok)
+            throw await apiErrorFromResponse(res);
+        return decodeListModelsResponse(await res.json());
+    }
+    // -------------------------------------------------------------------------
+    // Audio
+    // -------------------------------------------------------------------------
+    /** POST /v1/audio/speech. Returns the raw audio bytes + Content-Type. */
+    async speech(req) {
+        const body = encodeSpeechRequest(req);
+        const res = await this.send(this.url("/v1/audio/speech"), {
+            method: "POST",
+            headers: this.headers({ "content-type": "application/json" }),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw await apiErrorFromResponse(res);
+        const buf = await res.arrayBuffer();
+        const contentType = res.headers.get("content-type") ??
+            (req.responseFormat ? SPEECH_CONTENT_TYPES[req.responseFormat] : undefined) ??
+            "application/octet-stream";
+        return { bytes: new Uint8Array(buf), contentType };
+    }
+    /** GET /v1/audio/voices?model=<id>. */
+    async voices(model) {
+        const url = this.url("/v1/audio/voices", { model });
+        const res = await this.send(url, { method: "GET", headers: this.headers() });
+        if (!res.ok)
+            throw await apiErrorFromResponse(res);
+        return decodeVoicesResponse(await res.json());
+    }
+    /**
+     * POST /v1/audio/transcriptions (multipart/form-data).
+     *
+     * For `responseFormat` json/verbose_json the structured
+     * {@link TranscriptionResponse} is returned; for text/srt/vtt the response is a
+     * plain-text body and the returned object carries it in `.text` (other fields empty).
+     */
+    async transcribe(file, req) {
+        const form = new FormData();
+        const blob = file.data instanceof Blob
+            ? file.data
+            : new Blob([file.data instanceof Uint8Array ? bytesToArrayBuffer(file.data) : file.data], file.contentType ? { type: file.contentType } : undefined);
+        form.set("file", blob, file.filename);
+        form.set("model", req.model);
+        if (req.language !== undefined)
+            form.set("language", req.language);
+        if (req.prompt !== undefined)
+            form.set("prompt", req.prompt);
+        if (req.responseFormat !== undefined)
+            form.set("response_format", req.responseFormat);
+        if (req.temperature !== undefined)
+            form.set("temperature", String(req.temperature));
+        // Do NOT set content-type: the runtime sets it with the multipart boundary.
+        const res = await this.send(this.url("/v1/audio/transcriptions"), {
+            method: "POST",
+            headers: this.headers(),
+            body: form,
+        });
+        if (!res.ok)
+            throw await apiErrorFromResponse(res);
+        const ct = res.headers.get("content-type") ?? "";
+        if (ct.includes("application/json")) {
+            return decodeTranscriptionResponse(await res.json());
+        }
+        // text / srt / vtt: a plain-text body. Surface it directly in `.text`.
+        return { text: await res.text() };
+    }
+    // -------------------------------------------------------------------------
+    // Batches
+    // -------------------------------------------------------------------------
+    /** POST /v1/batches. */
+    async createBatch(req) {
+        const body = encodeBatchCreateRequest(req);
+        const json = await this.sendJson(this.url("/v1/batches"), body);
+        return decodeBatchHandle(json);
+    }
+    /** GET /v1/batches/{id}. */
+    async getBatch(id) {
+        const res = await this.send(this.url(`/v1/batches/${encodeURIComponent(id)}`), {
+            method: "GET",
+            headers: this.headers(),
+        });
+        if (!res.ok)
+            throw await apiErrorFromResponse(res);
+        return decodeBatchHandle(await res.json());
+    }
+    /** POST /v1/batches/{id}/cancel. */
+    async cancelBatch(id) {
+        const res = await this.send(this.url(`/v1/batches/${encodeURIComponent(id)}/cancel`), { method: "POST", headers: this.headers() });
+        if (!res.ok)
+            throw await apiErrorFromResponse(res);
+        return decodeBatchHandle(await res.json());
+    }
+    /**
+     * GET /v1/batches/{id}/results — an async iterable of {@link BatchResultLine}
+     * (one per NDJSON line).
+     */
+    async *batchResults(id) {
+        const res = await this.send(this.url(`/v1/batches/${encodeURIComponent(id)}/results`), { method: "GET", headers: this.headers({ accept: "application/x-ndjson" }) });
+        if (!res.ok)
+            throw await apiErrorFromResponse(res);
+        if (!res.body)
+            throw new ApiError(res.status, "batch results had no body");
+        for await (const line of parseNdjson(res.body)) {
+            yield decodeBatchResultLine(line);
+        }
+    }
+}
+/** Copy a Uint8Array's bytes into a fresh ArrayBuffer (handles non-zero byteOffset). */
+function bytesToArrayBuffer(bytes) {
+    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/enums.d.ts

@@ -0,0 +1,21 @@
+import { Role, FinishReason, BatchStatus } from "./gen/llmleaf/v1/llmleaf_pb.js";
+export { Role, FinishReason, BatchStatus };
+/** A TS numeric enum object: name<->value reverse-mappable at runtime. */
+type NumericEnum = Record<string, string | number>;
+/**
+ * Encode an enum value to its wire token, or `undefined` for the unspecified zero
+ * value (which means "field absent on the wire").
+ */
+export declare function enumToWire<E extends number>(enumObj: NumericEnum, value: E | undefined): string | undefined;
+/**
+ * Decode a wire token back into the enum value. An absent/empty token, or a token
+ * that matches no member, maps to the unspecified zero value (0).
+ */
+export declare function enumFromWire<E extends number>(enumObj: NumericEnum, token: string | null | undefined): E;
+export declare const roleToWire: (v: Role | undefined) => string | undefined;
+export declare const roleFromWire: (t: string | null | undefined) => Role;
+export declare const finishReasonToWire: (v: FinishReason | undefined) => string | undefined;
+export declare const finishReasonFromWire: (t: string | null | undefined) => FinishReason;
+export declare const batchStatusToWire: (v: BatchStatus | undefined) => string | undefined;
+export declare const batchStatusFromWire: (t: string | null | undefined) => BatchStatus;
+//# sourceMappingURL=enums.d.ts.map

package/dist/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AAE3C,0EAA0E;AAC1E,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAQnD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,CAAC,GAAG,SAAS,GACnB,MAAM,GAAG,SAAS,CAMpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,CAAC,CAQH;AAID,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,SACL,CAAC;AACtD,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,IACL,CAAC;AAExD,eAAO,MAAM,kBAAkB,GAAI,GAAG,YAAY,GAAG,SAAS,KAAG,MAAM,GAAG,SACL,CAAC;AACtE,eAAO,MAAM,oBAAoB,GAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,YACG,CAAC;AAExE,eAAO,MAAM,iBAAiB,GAAI,GAAG,WAAW,GAAG,SAAS,KAAG,MAAM,GAAG,SACL,CAAC;AACpE,eAAO,MAAM,mBAAmB,GAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,WACE,CAAC"}

package/dist/enums.js

@@ -0,0 +1,56 @@
+// Enum <-> wire-token mapping (SPEC.md "Enum ⇄ wire mapping").
+//
+// Every closed-set enum maps to its wire token by LOWERCASING the value name:
+//   TOOL_CALLS -> "tool_calls", ASSISTANT -> "assistant", IN_PROGRESS -> "in_progress".
+// The `*_UNSPECIFIED` zero value <-> field absent on the wire (undefined here).
+//
+// The generated protobuf-es file emits these as TypeScript string-keyed numeric enums
+// (e.g. `Role.ASSISTANT`). A TS numeric enum is bidirectional at runtime: indexing by
+// the numeric value yields the member NAME, which is exactly the proto value name. We
+// reuse that to derive the wire token mechanically — one helper pair for every enum,
+// no per-enum hand mapping (SPEC.md).
+import { Role, FinishReason, BatchStatus } from "./gen/llmleaf/v1/llmleaf_pb.js";
+export { Role, FinishReason, BatchStatus };
+function unspecifiedName(e) {
+    // The zero value is the `*_UNSPECIFIED` member; its name is what 0 maps to.
+    const name = e[0];
+    return typeof name === "string" ? name : undefined;
+}
+/**
+ * Encode an enum value to its wire token, or `undefined` for the unspecified zero
+ * value (which means "field absent on the wire").
+ */
+export function enumToWire(enumObj, value) {
+    if (value === undefined)
+        return undefined;
+    const name = enumObj[value];
+    if (typeof name !== "string")
+        return undefined;
+    if (name === unspecifiedName(enumObj))
+        return undefined;
+    return name.toLowerCase();
+}
+/**
+ * Decode a wire token back into the enum value. An absent/empty token, or a token
+ * that matches no member, maps to the unspecified zero value (0).
+ */
+export function enumFromWire(enumObj, token) {
+    if (token === null || token === undefined || token === "")
+        return 0;
+    const want = token.toLowerCase();
+    for (const [name, value] of Object.entries(enumObj)) {
+        if (typeof value !== "number")
+            continue;
+        if (name.toLowerCase() === want)
+            return value;
+    }
+    return 0;
+}
+// Convenience typed wrappers for the three enums on the surface.
+export const roleToWire = (v) => enumToWire(Role, v);
+export const roleFromWire = (t) => enumFromWire(Role, t);
+export const finishReasonToWire = (v) => enumToWire(FinishReason, v);
+export const finishReasonFromWire = (t) => enumFromWire(FinishReason, t);
+export const batchStatusToWire = (v) => enumToWire(BatchStatus, v);
+export const batchStatusFromWire = (t) => enumFromWire(BatchStatus, t);
+//# sourceMappingURL=enums.js.map

package/dist/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,8EAA8E;AAC9E,wFAAwF;AACxF,gFAAgF;AAChF,EAAE;AACF,sFAAsF;AACtF,sFAAsF;AACtF,sFAAsF;AACtF,qFAAqF;AACrF,sCAAsC;AAEtC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AAK3C,SAAS,eAAe,CAAC,CAAc;IACrC,4EAA4E;IAC5E,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClB,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,OAAoB,EACpB,KAAoB;IAEpB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAe,CAAC,CAAC;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,IAAI,KAAK,eAAe,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACxD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAoB,EACpB,KAAgC;IAEhC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,CAAM,CAAC;IACzE,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QACxC,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI;YAAE,OAAO,KAAU,CAAC;IACrD,CAAC;IACD,OAAO,CAAM,CAAC;AAChB,CAAC;AAED,iEAAiE;AAEjE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAmB,EAAsB,EAAE,CACpE,UAAU,CAAO,IAA8B,EAAE,CAAC,CAAC,CAAC;AACtD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAA4B,EAAQ,EAAE,CACjE,YAAY,CAAO,IAA8B,EAAE,CAAC,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAA2B,EAAsB,EAAE,CACpF,UAAU,CAAe,YAAsC,EAAE,CAAC,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAA4B,EAAgB,EAAE,CACjF,YAAY,CAAe,YAAsC,EAAE,CAAC,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAA0B,EAAsB,EAAE,CAClF,UAAU,CAAc,WAAqC,EAAE,CAAC,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAA4B,EAAe,EAAE,CAC/E,YAAY,CAAc,WAAqC,EAAE,CAAC,CAAC,CAAC"}

package/dist/error.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Thrown for any non-2xx HTTP response from the gateway.
+ *
+ * Status codes (SPEC.md): 400 bad request · 401 missing/invalid key ·
+ * 403 blocked or model-not-allowed · 404 no route for model ·
+ * 429 key suspended (limiter) · 502 all upstreams failed.
+ */
+export declare class ApiError extends Error {
+    readonly status: number;
+    /** present on some dialects; absent on the llmleaf core envelope. */
+    readonly type?: string;
+    readonly code?: string;
+    constructor(status: number, message: string, opts?: {
+        type?: string;
+        code?: string;
+    });
+}
+/**
+ * Build an {@link ApiError} from a non-2xx response. Reads the body once. Falls back
+ * to the HTTP status text when the body is missing or not the expected envelope.
+ */
+export declare function apiErrorFromResponse(res: Response): Promise<ApiError>;
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAGrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;CAU1C;AAQD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4B3E"}