@patternzones/koine-sdk 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+import type { z } from "zod";
+import type { KoineConfig, KoineStreamResult, KoineUsage } from "./types.js";
+/**
+ * Generates plain text response from Koine gateway service.
+ */
+export declare function generateText(config: KoineConfig, options: {
+    system?: string;
+    prompt: string;
+    sessionId?: string;
+}): Promise<{
+    text: string;
+    usage: KoineUsage;
+    sessionId: string;
+}>;
+/**
+ * Streams text response from Koine gateway service.
+ * Returns a ReadableStream of text chunks that can be consumed as they arrive.
+ */
+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;
+}>;
+//# 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":"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"}

package/dist/client.js

@@ -0,0 +1,286 @@
+"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");
+/**
+ * Safely parses JSON from a response, handling non-JSON bodies gracefully.
+ */
+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);
+    }
+    return {
+        object: parseResult.data,
+        rawText: result.rawText,
+        usage: result.usage,
+        sessionId: result.sessionId,
+    };
+}
+//# 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/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Custom error class for Koine client errors.
+ */
+export declare class KoineError extends Error {
+    code: string;
+    rawText?: string;
+    constructor(message: string, code: string, rawText?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +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"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KoineError = void 0;
+/**
+ * Custom error class for Koine client errors.
+ */
+class KoineError extends Error {
+    code;
+    rawText;
+    constructor(message, code, rawText) {
+        super(message);
+        this.name = "KoineError";
+        this.code = code;
+        this.rawText = rawText;
+    }
+}
+exports.KoineError = KoineError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Koine SDK
+ *
+ * A TypeScript client for interacting with Koine gateway services.
+ *
+ * @example
+ * ```typescript
+ * import { generateText, KoineConfig } from '@patternzones/koine-sdk';
+ *
+ * const config: KoineConfig = {
+ *   baseUrl: 'http://localhost:3100',
+ *   timeout: 300000,
+ *   authKey: 'your-api-key',
+ *   model: 'sonnet',
+ * };
+ *
+ * const result = await generateText(config, {
+ *   prompt: 'Hello, how are you?',
+ * });
+ *
+ * console.log(result.text);
+ * ```
+ */
+export type { KoineConfig, KoineUsage, KoineStreamResult, GenerateTextResponse, GenerateObjectResponse, ErrorResponse, SSETextEvent, SSEResultEvent, SSEErrorEvent, } from "./types.js";
+export { KoineError } from "./errors.js";
+export { generateText, streamText, generateObject } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,YAAY,EACX,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Koine SDK
+ *
+ * A TypeScript client for interacting with Koine gateway services.
+ *
+ * @example
+ * ```typescript
+ * import { generateText, KoineConfig } from '@patternzones/koine-sdk';
+ *
+ * const config: KoineConfig = {
+ *   baseUrl: 'http://localhost:3100',
+ *   timeout: 300000,
+ *   authKey: 'your-api-key',
+ *   model: 'sonnet',
+ * };
+ *
+ * const result = await generateText(config, {
+ *   prompt: 'Hello, how are you?',
+ * });
+ *
+ * console.log(result.text);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateObject = exports.streamText = exports.generateText = exports.KoineError = void 0;
+// Errors
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "KoineError", { enumerable: true, get: function () { return errors_js_1.KoineError; } });
+// Client functions
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "generateText", { enumerable: true, get: function () { return client_js_1.generateText; } });
+Object.defineProperty(exports, "streamText", { enumerable: true, get: function () { return client_js_1.streamText; } });
+Object.defineProperty(exports, "generateObject", { enumerable: true, get: function () { return client_js_1.generateObject; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAeH,SAAS;AACT,yCAAyC;AAAhC,uGAAA,UAAU,OAAA;AAEnB,mBAAmB;AACnB,yCAAuE;AAA9D,yGAAA,YAAY,OAAA;AAAE,uGAAA,UAAU,OAAA;AAAE,2GAAA,cAAc,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Configuration for connecting to a Koine gateway service.
+ */
+export interface KoineConfig {
+    /** Base URL of the gateway service (e.g., "http://localhost:3100") */
+    baseUrl: string;
+    /** Request timeout in milliseconds */
+    timeout: number;
+    /** Authentication key for the gateway service (required) */
+    authKey: string;
+    /** Model alias (e.g., 'sonnet', 'haiku') or full model name */
+    model?: string;
+}
+/**
+ * Usage information from Koine gateway service.
+ */
+export interface KoineUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+/**
+ * Response from generate-text endpoint.
+ */
+export interface GenerateTextResponse {
+    text: string;
+    usage: KoineUsage;
+    sessionId: string;
+}
+/**
+ * Response from generate-object endpoint.
+ */
+export interface GenerateObjectResponse {
+    object: unknown;
+    rawText: string;
+    usage: KoineUsage;
+    sessionId: string;
+}
+/**
+ * Error response from Koine gateway service.
+ */
+export interface ErrorResponse {
+    error: string;
+    code: string;
+    rawText?: string;
+}
+/**
+ * Result from streaming text generation.
+ */
+export interface KoineStreamResult {
+    /** ReadableStream of text chunks as they arrive */
+    textStream: ReadableStream<string>;
+    /** Session ID for conversation continuity (resolves early in stream, after session event) */
+    sessionId: Promise<string>;
+    /** Usage stats (resolves when stream completes via result event) */
+    usage: Promise<KoineUsage>;
+    /** Full accumulated text (resolves when stream completes) */
+    text: Promise<string>;
+}
+/**
+ * SSE event types from Koine gateway /stream endpoint.
+ */
+export interface SSETextEvent {
+    text: string;
+}
+export interface SSEResultEvent {
+    sessionId: string;
+    usage: KoineUsage;
+}
+export interface SSEErrorEvent {
+    error: string;
+    code?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,mDAAmD;IACnD,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,6FAA6F;IAC7F,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3B,6DAA6D;IAC7D,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,48 @@
+{
+	"name": "@patternzones/koine-sdk",
+	"version": "1.0.0",
+	"description": "TypeScript SDK for Koine gateway",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/pattern-zones-co/koine.git",
+		"directory": "packages/sdks/typescript"
+	},
+	"homepage": "https://github.com/pattern-zones-co/koine",
+	"bugs": "https://github.com/pattern-zones-co/koine/issues",
+	"author": "Pattern Zones Co",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"build": "tsc",
+		"test": "vitest",
+		"test:run": "vitest run",
+		"test:coverage": "vitest run --coverage",
+		"lint": "biome check ."
+	},
+	"dependencies": {
+		"zod": "3.25.76",
+		"zod-to-json-schema": "3.24.5"
+	},
+	"devDependencies": {
+		"@types/node": "25.0.2",
+		"@vitest/coverage-v8": "3.2.4",
+		"typescript": "5.9.3",
+		"vitest": "3.2.4"
+	},
+	"peerDependencies": {
+		"zod": ">=3.0.0"
+	},
+	"engines": {
+		"node": "22.21.1",
+		"bun": "1.3.3"
+	},
+	"keywords": ["claude", "claude-code", "anthropic", "ai", "sdk", "gateway"],
+	"license": "AGPL-3.0",
+	"files": ["dist", "README.md"]
+}