@patternzones/koine-sdk 1.1.6 → 2.0.0

package/README.md

@@ -22,14 +22,15 @@ npm install @patternzones/koine-sdk
 ## Quick Start
 
 ```typescript
-import { generateText, KoineConfig } from '@patternzones/koine-sdk';
+import { createKoine } from '@patternzones/koine-sdk';
 
-const config: KoineConfig = {
+const koine = createKoine({
   baseUrl: 'http://localhost:3100',
   authKey: 'your-api-key',
-};
+  timeout: 300000, // 5 minutes
+});
 
-const result = await generateText(config, {
+const result = await koine.generateText({
   prompt: 'Hello, how are you?',
 });
 
@@ -39,32 +40,40 @@ console.log(result.text);
 ## Features
 
 - **Text Generation** — `generateText()` for simple prompts
-- **Streaming** — `streamText()` with async iterators
+- **Streaming** — `streamText()` with ReadableStream (async iterable)
 - **Structured Output** — `generateObject()` with Zod schema validation
+- **Cancellation** — AbortSignal support for all requests
 - **Type Safety** — Full TypeScript types for all requests and responses
-- **Error Handling** — `KoineError` class with status codes
+- **Error Handling** — `KoineError` class with typed error codes
 
 ## API
 
-### Functions
+### Client Factory
+
+```typescript
+const koine = createKoine(config);
+```
+
+Creates a client instance with the given configuration. The config is validated once at creation time.
+
+### Methods
 
-| Function | Description |
-|----------|-------------|
-| `generateText(config, request)` | Generate text from a prompt |
-| `streamText(config, request)` | Stream text via Server-Sent Events |
-| `generateObject(config, request)` | Extract structured data using a Zod schema |
+| Method | Description |
+|--------|-------------|
+| `koine.generateText(options)` | Generate text from a prompt |
+| `koine.streamText(options)` | Stream text via Server-Sent Events |
+| `koine.generateObject(options)` | Extract structured data using a Zod schema |
 
 ### Types
 
 | Type | Description |
 |------|-------------|
 | `KoineConfig` | Client configuration (baseUrl, authKey, timeout, model) |
-| `GenerateTextRequest` | Text generation request options |
-| `GenerateTextResponse` | Text generation response with usage stats |
-| `GenerateObjectRequest` | Object extraction request with Zod schema |
-| `GenerateObjectResponse` | Object extraction response |
-| `KoineStreamResult` | Streaming result with async iterators |
-| `KoineError` | Error class with status and code |
+| `KoineClient` | Client interface returned by `createKoine()` |
+| `KoineUsage` | Token usage stats (inputTokens, outputTokens, totalTokens) |
+| `KoineStreamResult` | Streaming result with ReadableStream and promises |
+| `KoineError` | Error class with typed `code` property |
+| `KoineErrorCode` | Union type of all possible error codes |
 
 ## Documentation
 
@@ -78,13 +87,14 @@ See the [SDK Guide](https://github.com/pattern-zones-co/koine/blob/main/docs/sdk
 
 ## Examples
 
-Runnable examples are available in [docs/examples/typescript/](https://github.com/pattern-zones-co/koine/tree/main/docs/examples/typescript):
+Runnable examples are available in the [`examples/`](https://github.com/pattern-zones-co/koine/tree/main/packages/sdks/typescript/examples) directory. Run from the SDK directory using the npm scripts (which load `.env` from the project root):
 
 ```bash
-bun run docs/examples/typescript/hello.ts          # Basic text generation
-bun run docs/examples/typescript/extract-recipe.ts # Structured output with Zod
-bun run docs/examples/typescript/stream.ts         # Real-time streaming
-bun run docs/examples/typescript/conversation.ts   # Multi-turn sessions
+cd packages/sdks/typescript
+bun run example:hello        # Basic text generation
+bun run example:recipe       # Structured output with Zod
+bun run example:stream       # Real-time streaming
+bun run example:conversation # Multi-turn sessions
 ```
 
 ## License

package/dist/client.d.ts

@@ -1,39 +1,62 @@
-import type { z } from "zod";
-import type { KoineConfig, KoineStreamResult, KoineUsage } from "./types.js";
+import { type GenerateObjectOptions, type GenerateObjectResult, generateObject } from "./object.js";
+import { type StreamTextOptions, streamText } from "./stream/index.js";
+import { type GenerateTextOptions, type GenerateTextResult, generateText } from "./text.js";
+import type { KoineConfig, KoineStreamResult } from "./types.js";
+export { generateText, streamText, generateObject };
+export type { GenerateTextOptions, GenerateTextResult, StreamTextOptions, GenerateObjectOptions, GenerateObjectResult, };
 /**
- * Generates plain text response from Koine gateway service.
+ * Koine client interface returned by createKoine.
  */
-export declare function generateText(config: KoineConfig, options: {
-    system?: string;
-    prompt: string;
-    sessionId?: string;
-}): Promise<{
-    text: string;
-    usage: KoineUsage;
-    sessionId: string;
-}>;
+export interface KoineClient {
+    /**
+     * Generates plain text response from Koine gateway service.
+     *
+     * @param options - Request options
+     * @returns Object containing response text, usage stats, and session ID
+     * @throws {KoineError} When the request fails or returns invalid response
+     */
+    generateText(options: GenerateTextOptions): Promise<GenerateTextResult>;
+    /**
+     * Streams text response from Koine gateway service.
+     *
+     * @param options - Request options
+     * @returns KoineStreamResult with textStream and promises for sessionId, usage, text
+     * @throws {KoineError} When connection fails or stream encounters an error
+     */
+    streamText(options: StreamTextOptions): Promise<KoineStreamResult>;
+    /**
+     * Generates structured JSON response from Koine gateway service.
+     *
+     * @typeParam T - The type of the expected response object, inferred from schema
+     * @param options - Request options including Zod schema
+     * @returns Object containing validated response, raw text, usage, and sessionId
+     * @throws {KoineError} With code 'VALIDATION_ERROR' if response doesn't match schema
+     */
+    generateObject<T>(options: GenerateObjectOptions<T>): Promise<GenerateObjectResult<T>>;
+}
 /**
- * Streams text response from Koine gateway service.
- * Returns a ReadableStream of text chunks that can be consumed as they arrive.
+ * Creates a Koine client instance with the given configuration.
+ *
+ * @param config - Client configuration including baseUrl, authKey, and timeout
+ * @returns KoineClient with generateText, streamText, and generateObject methods
+ * @throws {KoineError} With code 'INVALID_CONFIG' if config is invalid
+ *
+ * @example
+ * ```typescript
+ * import { createKoine } from '@patternzones/koine-sdk';
+ *
+ * const koine = createKoine({
+ *   baseUrl: 'http://localhost:3100',
+ *   authKey: 'your-api-key',
+ *   timeout: 300000,
+ * });
+ *
+ * const result = await koine.generateText({
+ *   prompt: 'Hello, how are you?',
+ * });
+ *
+ * console.log(result.text);
+ * ```
  */
-export declare function streamText(config: KoineConfig, options: {
-    system?: string;
-    prompt: string;
-    sessionId?: string;
-}): Promise<KoineStreamResult>;
-/**
- * Generates structured JSON response from Koine gateway service.
- * Converts Zod schema to JSON Schema for the gateway service.
- */
-export declare function generateObject<T>(config: KoineConfig, options: {
-    system?: string;
-    prompt: string;
-    schema: z.ZodSchema<T>;
-    sessionId?: string;
-}): Promise<{
-    object: T;
-    rawText: string;
-    usage: KoineUsage;
-    sessionId: string;
-}>;
+export declare function createKoine(config: KoineConfig): KoineClient;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAIX,WAAW,EACX,iBAAiB,EACjB,UAAU,EAIV,MAAM,YAAY,CAAC;AAcpB;;GAEG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GACC,OAAO,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC,CAsCD;AAkED;;;GAGG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GACC,OAAO,CAAC,iBAAiB,CAAC,CAiK5B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACrC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GACC,OAAO,CAAC;IACV,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC,CAwDD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,cAAc,EACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACN,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,YAAY,EACZ,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AACpD,YAAY,EACX,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACpB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAExE;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEnE;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,EACf,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAU5D"}

package/dist/client.js

@@ -1,286 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateText = generateText;
-exports.streamText = streamText;
-exports.generateObject = generateObject;
-const zod_to_json_schema_1 = require("zod-to-json-schema");
-const errors_js_1 = require("./errors.js");
+exports.generateObject = exports.streamText = exports.generateText = void 0;
+exports.createKoine = createKoine;
+// Import and re-export functions from the new modules
+const http_js_1 = require("./http.js");
+const object_js_1 = require("./object.js");
+Object.defineProperty(exports, "generateObject", { enumerable: true, get: function () { return object_js_1.generateObject; } });
+const index_js_1 = require("./stream/index.js");
+Object.defineProperty(exports, "streamText", { enumerable: true, get: function () { return index_js_1.streamText; } });
+const text_js_1 = require("./text.js");
+Object.defineProperty(exports, "generateText", { enumerable: true, get: function () { return text_js_1.generateText; } });
 /**
- * Safely parses JSON from a response, handling non-JSON bodies gracefully.
+ * Creates a Koine client instance with the given configuration.
+ *
+ * @param config - Client configuration including baseUrl, authKey, and timeout
+ * @returns KoineClient with generateText, streamText, and generateObject methods
+ * @throws {KoineError} With code 'INVALID_CONFIG' if config is invalid
+ *
+ * @example
+ * ```typescript
+ * import { createKoine } from '@patternzones/koine-sdk';
+ *
+ * const koine = createKoine({
+ *   baseUrl: 'http://localhost:3100',
+ *   authKey: 'your-api-key',
+ *   timeout: 300000,
+ * });
+ *
+ * const result = await koine.generateText({
+ *   prompt: 'Hello, how are you?',
+ * });
+ *
+ * console.log(result.text);
+ * ```
  */
-async function safeJsonParse(response) {
-    const text = await response.text();
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Generates plain text response from Koine gateway service.
- */
-async function generateText(config, options) {
-    const response = await fetch(`${config.baseUrl}/generate-text`, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${config.authKey}`,
-        },
-        body: JSON.stringify({
-            system: options.system,
-            prompt: options.prompt,
-            sessionId: options.sessionId,
-            model: config.model,
-        }),
-        signal: AbortSignal.timeout(config.timeout),
-    });
-    if (!response.ok) {
-        const errorBody = await safeJsonParse(response);
-        throw new errors_js_1.KoineError(errorBody?.error || `HTTP ${response.status} ${response.statusText}`, errorBody?.code || "HTTP_ERROR", errorBody?.rawText);
-    }
-    const result = await safeJsonParse(response);
-    if (!result) {
-        throw new errors_js_1.KoineError("Invalid response from Koine gateway: expected JSON", "INVALID_RESPONSE");
-    }
-    return {
-        text: result.text,
-        usage: result.usage,
-        sessionId: result.sessionId,
-    };
-}
-/**
- * Parses SSE events from a ReadableStream.
- * SSE format: "event: name\ndata: {...}\n\n"
- */
-function createSSEParser() {
-    let buffer = "";
-    // Reuse decoder with stream mode to correctly handle multi-byte UTF-8 chars spanning chunks
-    const decoder = new TextDecoder();
-    return new TransformStream({
-        transform(chunk, controller) {
-            buffer += decoder.decode(chunk, { stream: true });
-            // SSE events are separated by double newlines
-            const events = buffer.split("\n\n");
-            // Keep the last potentially incomplete event in the buffer
-            buffer = events.pop() || "";
-            for (const eventStr of events) {
-                if (!eventStr.trim())
-                    continue;
-                const lines = eventStr.split("\n");
-                let eventType = "";
-                let data = "";
-                for (const line of lines) {
-                    if (line.startsWith("event: ")) {
-                        eventType = line.slice(7);
-                    }
-                    else if (line.startsWith("data: ")) {
-                        data = line.slice(6);
-                    }
-                }
-                if (eventType && data) {
-                    controller.enqueue({ event: eventType, data });
-                }
-            }
-        },
-        flush(controller) {
-            // Process any remaining data in buffer
-            if (buffer.trim()) {
-                const lines = buffer.split("\n");
-                let eventType = "";
-                let data = "";
-                for (const line of lines) {
-                    if (line.startsWith("event: ")) {
-                        eventType = line.slice(7);
-                    }
-                    else if (line.startsWith("data: ")) {
-                        data = line.slice(6);
-                    }
-                }
-                if (eventType && data) {
-                    controller.enqueue({ event: eventType, data });
-                }
-            }
-        },
-    });
-}
-/**
- * Streams text response from Koine gateway service.
- * Returns a ReadableStream of text chunks that can be consumed as they arrive.
- */
-async function streamText(config, options) {
-    const response = await fetch(`${config.baseUrl}/stream`, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${config.authKey}`,
-        },
-        body: JSON.stringify({
-            system: options.system,
-            prompt: options.prompt,
-            sessionId: options.sessionId,
-            model: config.model,
-        }),
-        signal: AbortSignal.timeout(config.timeout),
-    });
-    if (!response.ok) {
-        const errorBody = await safeJsonParse(response);
-        throw new errors_js_1.KoineError(errorBody?.error || `HTTP ${response.status} ${response.statusText}`, errorBody?.code || "HTTP_ERROR", errorBody?.rawText);
-    }
-    if (!response.body) {
-        throw new errors_js_1.KoineError("No response body from Koine gateway", "NO_RESPONSE_BODY");
-    }
-    // Set up promises for session, usage, and accumulated text
-    let resolveSessionId;
-    let rejectSessionId;
-    const sessionIdPromise = new Promise((resolve, reject) => {
-        resolveSessionId = resolve;
-        rejectSessionId = reject;
-    });
-    let resolveUsage;
-    let rejectUsage;
-    const usagePromise = new Promise((resolve, reject) => {
-        resolveUsage = resolve;
-        rejectUsage = reject;
-    });
-    let resolveText;
-    let rejectText;
-    const textPromise = new Promise((resolve, reject) => {
-        resolveText = resolve;
-        rejectText = reject;
-    });
-    let accumulatedText = "";
-    let sessionIdReceived = false;
-    let usageReceived = false;
-    // Transform SSE events into text chunks
-    const textStream = response.body.pipeThrough(createSSEParser()).pipeThrough(new TransformStream({
-        transform(sseEvent, controller) {
-            // Critical events (session, result, error, done) must propagate parse errors
-            // Text events can log and continue - degraded content is better than total failure
-            const isCriticalEvent = ["session", "result", "error", "done"].includes(sseEvent.event);
-            try {
-                switch (sseEvent.event) {
-                    case "session": {
-                        const parsed = JSON.parse(sseEvent.data);
-                        if (!sessionIdReceived) {
-                            sessionIdReceived = true;
-                            resolveSessionId(parsed.sessionId);
-                        }
-                        break;
-                    }
-                    case "text": {
-                        const parsed = JSON.parse(sseEvent.data);
-                        accumulatedText += parsed.text;
-                        controller.enqueue(parsed.text);
-                        break;
-                    }
-                    case "result": {
-                        const parsed = JSON.parse(sseEvent.data);
-                        usageReceived = true;
-                        resolveUsage(parsed.usage);
-                        if (!sessionIdReceived) {
-                            sessionIdReceived = true;
-                            resolveSessionId(parsed.sessionId);
-                        }
-                        break;
-                    }
-                    case "error": {
-                        const parsed = JSON.parse(sseEvent.data);
-                        const error = new errors_js_1.KoineError(parsed.error, parsed.code || "STREAM_ERROR");
-                        usageReceived = true; // Prevent double rejection in flush
-                        rejectUsage(error);
-                        rejectText(error);
-                        if (!sessionIdReceived) {
-                            rejectSessionId(error);
-                        }
-                        controller.error(error);
-                        break;
-                    }
-                    case "done": {
-                        // Stream complete, resolve the text promise
-                        resolveText(accumulatedText);
-                        break;
-                    }
-                }
-            }
-            catch (parseError) {
-                if (isCriticalEvent) {
-                    // Critical event parse failure - propagate error
-                    const error = new errors_js_1.KoineError(`Failed to parse critical SSE event: ${sseEvent.event}`, "SSE_PARSE_ERROR");
-                    if (!usageReceived) {
-                        usageReceived = true;
-                        rejectUsage(error);
-                    }
-                    rejectText(error);
-                    if (!sessionIdReceived) {
-                        rejectSessionId(error);
-                    }
-                    controller.error(error);
-                }
-                // Non-critical event (text) - continue stream silently
-            }
-        },
-        flush() {
-            // Handle promises that were never resolved/rejected during stream
-            if (!sessionIdReceived) {
-                rejectSessionId(new errors_js_1.KoineError("Stream ended without session ID", "NO_SESSION"));
-            }
-            if (!usageReceived) {
-                rejectUsage(new errors_js_1.KoineError("Stream ended without usage information", "NO_USAGE"));
-            }
-            resolveText(accumulatedText);
-        },
-    }));
-    return {
-        textStream,
-        sessionId: sessionIdPromise,
-        usage: usagePromise,
-        text: textPromise,
-    };
-}
-/**
- * Generates structured JSON response from Koine gateway service.
- * Converts Zod schema to JSON Schema for the gateway service.
- */
-async function generateObject(config, options) {
-    // Convert Zod schema to JSON Schema for the gateway service
-    const jsonSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(options.schema, {
-        $refStrategy: "none",
-        target: "jsonSchema7",
-    });
-    const response = await fetch(`${config.baseUrl}/generate-object`, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${config.authKey}`,
-        },
-        body: JSON.stringify({
-            system: options.system,
-            prompt: options.prompt,
-            schema: jsonSchema,
-            sessionId: options.sessionId,
-            model: config.model,
-        }),
-        signal: AbortSignal.timeout(config.timeout),
-    });
-    if (!response.ok) {
-        const errorBody = await safeJsonParse(response);
-        throw new errors_js_1.KoineError(errorBody?.error || `HTTP ${response.status} ${response.statusText}`, errorBody?.code || "HTTP_ERROR", errorBody?.rawText);
-    }
-    const result = await safeJsonParse(response);
-    if (!result) {
-        throw new errors_js_1.KoineError("Invalid response from Koine gateway: expected JSON", "INVALID_RESPONSE");
-    }
-    // Validate the response against the Zod schema
-    const parseResult = options.schema.safeParse(result.object);
-    if (!parseResult.success) {
-        throw new errors_js_1.KoineError(`Response validation failed: ${parseResult.error.message}`, "VALIDATION_ERROR", result.rawText);
-    }
+function createKoine(config) {
+    // Validate config once at creation time
+    (0, http_js_1.validateConfig)(config);
     return {
-        object: parseResult.data,
-        rawText: result.rawText,
-        usage: result.usage,
-        sessionId: result.sessionId,
+        generateText: (options) => (0, text_js_1.generateText)(config, options),
+        streamText: (options) => (0, index_js_1.streamText)(config, options),
+        generateObject: (options) => (0, object_js_1.generateObject)(config, options),
     };
 }
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAoFA,kCAUC;AA9FD,sDAAsD;AACtD,uCAA2C;AAC3C,2CAIqB;AAUc,+FAXlC,0BAAc,OAWkC;AATjD,gDAAuE;AAShD,2FATU,qBAAU,OASV;AARjC,uCAImB;AAIV,6FALR,sBAAY,OAKQ;AA4CrB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,WAAW,CAAC,MAAmB;IAC9C,wCAAwC;IACxC,IAAA,wBAAc,EAAC,MAAM,CAAC,CAAC;IAEvB,OAAO;QACN,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAA,sBAAY,EAAC,MAAM,EAAE,OAAO,CAAC;QACxD,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAA,qBAAU,EAAC,MAAM,EAAE,OAAO,CAAC;QACpD,cAAc,EAAE,CAAI,OAAiC,EAAE,EAAE,CACxD,IAAA,0BAAc,EAAC,MAAM,EAAE,OAAO,CAAC;KAChC,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -1,9 +1,24 @@
+/**
+ * Known error codes returned by the SDK and gateway.
+ */
+export type KoineErrorCode = "HTTP_ERROR" | "INVALID_RESPONSE" | "INVALID_CONFIG" | "VALIDATION_ERROR" | "STREAM_ERROR" | "SSE_PARSE_ERROR" | "NO_SESSION" | "NO_USAGE" | "NO_RESPONSE_BODY" | "TIMEOUT" | "NETWORK_ERROR" | "INVALID_PARAMS" | "AUTH_ERROR" | "UNAUTHORIZED" | "SERVER_ERROR" | "SCHEMA_ERROR" | "RATE_LIMITED" | "CONTEXT_OVERFLOW";
 /**
  * Custom error class for Koine client errors.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await generateText(config, { prompt: 'Hello' });
+ * } catch (error) {
+ *   if (error instanceof KoineError) {
+ *     console.error(`[${error.code}]: ${error.message}`);
+ *   }
+ * }
+ * ```
  */
 export declare class KoineError extends Error {
-    code: string;
-    rawText?: string;
-    constructor(message: string, code: string, rawText?: string);
+    readonly code: KoineErrorCode;
+    readonly rawText?: string;
+    constructor(message: string, code: KoineErrorCode, rawText?: string);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEL,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAM3D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAEvB,YAAY,GACZ,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,cAAc,GACd,iBAAiB,GACjB,YAAY,GACZ,UAAU,GACV,kBAAkB,GAClB,SAAS,GACT,eAAe,GAEf,gBAAgB,GAChB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,cAAc,GACd,cAAc,GACd,kBAAkB,CAAC;AAEtB;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM;CAQnE"}

package/dist/errors.js

@@ -3,12 +3,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.KoineError = void 0;
 /**
  * Custom error class for Koine client errors.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await generateText(config, { prompt: 'Hello' });
+ * } catch (error) {
+ *   if (error instanceof KoineError) {
+ *     console.error(`[${error.code}]: ${error.message}`);
+ *   }
+ * }
+ * ```
  */
 class KoineError extends Error {
     code;
     rawText;
     constructor(message, code, rawText) {
         super(message);
+        // Fix prototype chain for proper instanceof checks in transpiled code
+        Object.setPrototypeOf(this, KoineError.prototype);
         this.name = "KoineError";
         this.code = code;
         this.rawText = rawText;

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,UAAW,SAAQ,KAAK;IACpC,IAAI,CAAS;IACb,OAAO,CAAU;IAEjB,YAAY,OAAe,EAAE,IAAY,EAAE,OAAgB;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD;AAVD,gCAUC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAyBA;;;;;;;;;;;;;GAaG;AACH,MAAa,UAAW,SAAQ,KAAK;IAC3B,IAAI,CAAiB;IACrB,OAAO,CAAU;IAE1B,YAAY,OAAe,EAAE,IAAoB,EAAE,OAAgB;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,sEAAsE;QACtE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD;AAZD,gCAYC"}

package/dist/http.d.ts

@@ -0,0 +1,29 @@
+import { type KoineErrorCode } from "./errors.js";
+import type { KoineConfig } from "./types.js";
+/**
+ * Known error codes for type-safe validation.
+ */
+export declare const KNOWN_ERROR_CODES: Set<KoineErrorCode>;
+/**
+ * Coerces an API error code to a known KoineErrorCode.
+ * Falls back to the provided default if the code is unknown.
+ */
+export declare function toErrorCode(code: string | undefined, fallback: KoineErrorCode): KoineErrorCode;
+/**
+ * Validates config parameters before making requests.
+ * @throws {KoineError} with code 'INVALID_CONFIG' if config is invalid
+ */
+export declare function validateConfig(config: KoineConfig): void;
+/**
+ * Creates an AbortSignal that combines timeout with optional user signal.
+ */
+export declare function createAbortSignal(timeout: number, userSignal?: AbortSignal): AbortSignal;
+/**
+ * Wraps fetch errors in KoineError for consistent error handling.
+ */
+export declare function safeFetch(url: string, options: RequestInit, timeout: number): Promise<Response>;
+/**
+ * Safely parses JSON from a response, handling non-JSON bodies gracefully.
+ */
+export declare function safeJsonParse<T>(response: Response): Promise<T | null>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,qBAqB5B,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,EAAE,cAAc,GACtB,cAAc,CAKhB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAUxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,WAAW,GACtB,WAAW,CAOb;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,QAAQ,CAAC,CAqBnB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAO5E"}