@tiny-fish/sdk 0.0.1

package/README.md

@@ -0,0 +1,5 @@
+# TinyFish TypeScript SDK
+
+State-of-the-art web agents in an API.
+
+> Currently this SDK is still being built. Discuss with @simantak-dabhade

package/dist/_utils/client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Base HTTP client — handles auth, headers, retries, and error mapping.
+ */
+export interface ClientOptions {
+    apiKey?: string;
+    baseURL?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+export declare class BaseClient {
+    readonly apiKey: string;
+    readonly baseURL: string;
+    readonly timeout: number;
+    readonly maxRetries: number;
+    constructor(options?: ClientOptions);
+    protected _buildHeaders(): Record<string, string>;
+    /**
+     * Core request method with retry and error mapping.
+     * All public methods (get, post, postStream) delegate here.
+     */
+    private _request;
+    /**
+     * Extracts a human-readable error message from the response body.
+     * Tries JSON body → error.message → message, falls back to text, then HTTP status.
+     * Matches Python SDK's _parse_error_message.
+     */
+    private _parseErrorMessage;
+    /** Maps HTTP status codes to typed error classes. Matches Python SDK's _make_status_error. */
+    private _makeStatusError;
+    get<T>(path: string, options?: {
+        params?: Record<string, string | number | boolean | undefined>;
+    }): Promise<T>;
+    post<T>(path: string, options?: {
+        json?: unknown;
+    }): Promise<T>;
+    postStream(path: string, options?: {
+        json?: unknown;
+    }): Promise<ReadableStream<string>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/_utils/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/_utils/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH,MAAM,WAAW,aAAa;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,qBAAa,UAAU;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,OAAO,GAAE,aAAkB;IAcvC,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IASjD;;;OAGG;YACW,QAAQ;IAsDtB;;;;OAIG;YACW,kBAAkB;IAuBhC,8FAA8F;YAChF,gBAAgB;IAmCxB,GAAG,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;KAAE,GAC1E,OAAO,CAAC,CAAC,CAAC;IAgBP,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAK/D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;CAS7F"}

package/dist/_utils/client.js

@@ -0,0 +1,168 @@
+/**
+ * Base HTTP client — handles auth, headers, retries, and error mapping.
+ */
+import pRetry, { AbortError } from "p-retry";
+import { VERSION } from "../version.js";
+import { APIConnectionError, APIStatusError, APITimeoutError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, RequestTimeoutError, SDKError, UnprocessableEntityError, } from "./errors.js";
+const DEFAULT_BASE_URL = "https://agent.tinyfish.ai";
+const DEFAULT_TIMEOUT = 600_000; // 10 minutes, matches Python SDK
+const DEFAULT_MAX_RETRIES = 2;
+export class BaseClient {
+    apiKey;
+    baseURL;
+    timeout;
+    maxRetries;
+    constructor(options = {}) {
+        const apiKey = options.apiKey ?? process.env["TINYFISH_API_KEY"];
+        if (!apiKey) {
+            throw new SDKError("Missing API key. Pass `apiKey` to the constructor or set the TINYFISH_API_KEY environment variable.");
+        }
+        this.apiKey = apiKey;
+        this.baseURL = options.baseURL ?? DEFAULT_BASE_URL;
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    }
+    _buildHeaders() {
+        return {
+            "X-API-Key": this.apiKey,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            "User-Agent": `tinyfish-typescript/${VERSION}`,
+        };
+    }
+    /**
+     * Core request method with retry and error mapping.
+     * All public methods (get, post, postStream) delegate here.
+     */
+    async _request(method, path, body) {
+        const url = `${this.baseURL}${path}`;
+        const headers = this._buildHeaders();
+        return pRetry(async () => {
+            try {
+                const response = await fetch(url, {
+                    method,
+                    headers,
+                    body: body !== undefined ? JSON.stringify(body) : undefined,
+                    signal: AbortSignal.timeout(this.timeout),
+                });
+                if (response.ok) {
+                    return response;
+                }
+                const sdkError = await this._makeStatusError(response);
+                // Non-retryable status codes abort immediately
+                const status = response.status;
+                if (status !== 408 && status !== 429 && status < 500) {
+                    throw new AbortError(sdkError);
+                }
+                // Retryable — let p-retry handle backoff
+                throw sdkError;
+            }
+            catch (error) {
+                // Re-throw AbortError and SDK errors as-is
+                if (error instanceof AbortError || error instanceof SDKError) {
+                    throw error;
+                }
+                // AbortSignal.timeout throws a DOMException with name "TimeoutError"
+                if (error instanceof DOMException && error.name === "TimeoutError") {
+                    throw new APITimeoutError(`Request timed out after ${this.timeout}ms`);
+                }
+                // Network failures (DNS, refused, etc.)
+                throw new APIConnectionError(error instanceof Error ? error.message : "Connection failed");
+            }
+        }, {
+            retries: this.maxRetries,
+            minTimeout: 500,
+            maxTimeout: 8_000,
+            factor: 2,
+        });
+    }
+    /**
+     * Extracts a human-readable error message from the response body.
+     * Tries JSON body → error.message → message, falls back to text, then HTTP status.
+     * Matches Python SDK's _parse_error_message.
+     */
+    async _parseErrorMessage(response) {
+        try {
+            const text = await response.text();
+            try {
+                const body = JSON.parse(text);
+                const errorObj = body?.["error"];
+                const msg = errorObj?.["message"] ?? body?.["message"];
+                if (typeof msg === "string" && msg.length > 0) {
+                    return msg;
+                }
+            }
+            catch {
+                // Not JSON — fall through to use raw text
+            }
+            if (text.length > 0) {
+                return text;
+            }
+        }
+        catch {
+            // Body read failed entirely
+        }
+        return `HTTP ${response.status}`;
+    }
+    /** Maps HTTP status codes to typed error classes. Matches Python SDK's _make_status_error. */
+    async _makeStatusError(response) {
+        const msg = await this._parseErrorMessage(response);
+        const opts = { response };
+        switch (response.status) {
+            case 400:
+                return new BadRequestError(msg, opts);
+            case 401:
+                return new AuthenticationError(msg, opts);
+            case 403:
+                return new PermissionDeniedError(msg, opts);
+            case 404:
+                return new NotFoundError(msg, opts);
+            case 408:
+                return new RequestTimeoutError(msg, opts);
+            case 409:
+                return new ConflictError(msg, opts);
+            case 422:
+                return new UnprocessableEntityError(msg, opts);
+            case 429:
+                return new RateLimitError(msg, opts);
+            default:
+                if (response.status >= 500) {
+                    return new InternalServerError(msg, {
+                        response,
+                        statusCode: response.status,
+                    });
+                }
+                return new APIStatusError(msg, {
+                    response,
+                    statusCode: response.status,
+                });
+        }
+    }
+    async get(path, options) {
+        let url = path;
+        if (options?.params) {
+            const filtered = {};
+            for (const [key, value] of Object.entries(options.params)) {
+                if (value !== undefined) {
+                    filtered[key] = String(value);
+                }
+            }
+            const searchParams = new URLSearchParams(filtered);
+            url = `${path}?${searchParams.toString()}`;
+        }
+        const response = await this._request("GET", url);
+        return (await response.json());
+    }
+    async post(path, options) {
+        const response = await this._request("POST", path, options?.json);
+        return (await response.json());
+    }
+    async postStream(path, options) {
+        const response = await this._request("POST", path, options?.json);
+        if (!response.body) {
+            throw new SDKError("Response body is null — server did not return a stream");
+        }
+        return response.body.pipeThrough(new TextDecoderStream());
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/_utils/client.js.map

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

package/dist/_utils/errors.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Exception hierarchy for SDK errors.
+ *
+ * Hierarchy:
+ *   SDKError
+ *   +- SSEParseError
+ *   +- APIError
+ *      +- APIConnectionError
+ *      |  +- APITimeoutError
+ *      +- APIStatusError
+ *         +- BadRequestError (400)
+ *         +- AuthenticationError (401)
+ *         +- PermissionDeniedError (403)
+ *         +- NotFoundError (404)
+ *         +- RequestTimeoutError (408)
+ *         +- ConflictError (409)
+ *         +- UnprocessableEntityError (422)
+ *         +- RateLimitError (429)
+ *         +- InternalServerError (500+)
+ */
+export declare class SDKError extends Error {
+    constructor(message: string);
+}
+export declare class SSEParseError extends SDKError {
+    readonly line: string;
+    constructor(message: string, line: string);
+}
+export declare class APIError extends SDKError {
+    readonly request: Request | undefined;
+    readonly response: Response | undefined;
+    constructor(message: string, options?: {
+        request?: Request | undefined;
+        response?: Response | undefined;
+    });
+}
+export declare class APIConnectionError extends APIError {
+    constructor(message: string, options?: {
+        request?: Request | undefined;
+    });
+}
+export declare class APITimeoutError extends APIConnectionError {
+    constructor(message: string, options?: {
+        request?: Request | undefined;
+    });
+}
+export declare class APIStatusError extends APIError {
+    readonly statusCode: number;
+    constructor(message: string, options: {
+        response: Response;
+        statusCode: number;
+        request?: Request | undefined;
+    });
+}
+export declare class BadRequestError extends APIStatusError {
+    constructor(message: string, options: {
+        response: Response;
+        request?: Request | undefined;
+    });
+}
+export declare class AuthenticationError extends APIStatusError {
+    constructor(message: string, options: {
+        response: Response;
+        request?: Request | undefined;
+    });
+}
+export declare class PermissionDeniedError extends APIStatusError {
+    constructor(message: string, options: {
+        response: Response;
+        request?: Request | undefined;
+    });
+}
+export declare class NotFoundError extends APIStatusError {
+    constructor(message: string, options: {
+        response: Response;
+        request?: Request | undefined;
+    });
+}
+export declare class RequestTimeoutError extends APIStatusError {
+    constructor(message: string, options: {
+        response: Response;
+        request?: Request | undefined;
+    });
+}
+export declare class ConflictError extends APIStatusError {
+    constructor(message: string, options: {
+        response: Response;
+        request?: Request | undefined;
+    });
+}
+export declare class UnprocessableEntityError extends APIStatusError {
+    constructor(message: string, options: {
+        response: Response;
+        request?: Request | undefined;
+    });
+}
+export declare class RateLimitError extends APIStatusError {
+    constructor(message: string, options: {
+        response: Response;
+        request?: Request | undefined;
+    });
+}
+export declare class InternalServerError extends APIStatusError {
+    constructor(message: string, options: {
+        response: Response;
+        statusCode?: number | undefined;
+        request?: Request | undefined;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/_utils/errors.d.ts.map

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

package/dist/_utils/errors.js

@@ -0,0 +1,123 @@
+/**
+ * Exception hierarchy for SDK errors.
+ *
+ * Hierarchy:
+ *   SDKError
+ *   +- SSEParseError
+ *   +- APIError
+ *      +- APIConnectionError
+ *      |  +- APITimeoutError
+ *      +- APIStatusError
+ *         +- BadRequestError (400)
+ *         +- AuthenticationError (401)
+ *         +- PermissionDeniedError (403)
+ *         +- NotFoundError (404)
+ *         +- RequestTimeoutError (408)
+ *         +- ConflictError (409)
+ *         +- UnprocessableEntityError (422)
+ *         +- RateLimitError (429)
+ *         +- InternalServerError (500+)
+ */
+export class SDKError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SDKError";
+    }
+}
+export class SSEParseError extends SDKError {
+    line;
+    constructor(message, line) {
+        super(message);
+        this.name = "SSEParseError";
+        this.line = line;
+    }
+}
+export class APIError extends SDKError {
+    request;
+    response;
+    constructor(message, options) {
+        super(message);
+        this.name = "APIError";
+        this.request = options?.request;
+        this.response = options?.response;
+    }
+}
+export class APIConnectionError extends APIError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "APIConnectionError";
+    }
+}
+export class APITimeoutError extends APIConnectionError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "APITimeoutError";
+    }
+}
+export class APIStatusError extends APIError {
+    statusCode;
+    constructor(message, options) {
+        super(message, { request: options.request, response: options.response });
+        this.name = "APIStatusError";
+        this.statusCode = options.statusCode;
+    }
+}
+export class BadRequestError extends APIStatusError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 400 });
+        this.name = "BadRequestError";
+    }
+}
+export class AuthenticationError extends APIStatusError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 401 });
+        this.name = "AuthenticationError";
+    }
+}
+export class PermissionDeniedError extends APIStatusError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 403 });
+        this.name = "PermissionDeniedError";
+    }
+}
+export class NotFoundError extends APIStatusError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 404 });
+        this.name = "NotFoundError";
+    }
+}
+export class RequestTimeoutError extends APIStatusError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 408 });
+        this.name = "RequestTimeoutError";
+    }
+}
+export class ConflictError extends APIStatusError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 409 });
+        this.name = "ConflictError";
+    }
+}
+export class UnprocessableEntityError extends APIStatusError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 422 });
+        this.name = "UnprocessableEntityError";
+    }
+}
+export class RateLimitError extends APIStatusError {
+    constructor(message, options) {
+        super(message, { ...options, statusCode: 429 });
+        this.name = "RateLimitError";
+    }
+}
+export class InternalServerError extends APIStatusError {
+    constructor(message, options) {
+        super(message, {
+            response: options.response,
+            statusCode: options.statusCode ?? 500,
+            request: options.request,
+        });
+        this.name = "InternalServerError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/_utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/_utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAClC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACxB,CAAC;CACD;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACjC,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,IAAY;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CACD;AAED,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAC5B,OAAO,CAAsB;IAC7B,QAAQ,CAAuB;IAExC,YACC,OAAe,EACf,OAA4E;QAE5E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACnC,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC/C,YAAY,OAAe,EAAE,OAA2C;QACvE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,eAAgB,SAAQ,kBAAkB;IACtD,YAAY,OAAe,EAAE,OAA2C;QACvE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAClC,UAAU,CAAS;IAE5B,YACC,OAAe,EACf,OAAkF;QAElF,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,CAAC;CACD;AAED,MAAM,OAAO,eAAgB,SAAQ,cAAc;IAClD,YAAY,OAAe,EAAE,OAA8D;QAC1F,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACtD,YAAY,OAAe,EAAE,OAA8D;QAC1F,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD;AAED,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACxD,YAAY,OAAe,EAAE,OAA8D;QAC1F,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACrC,CAAC;CACD;AAED,MAAM,OAAO,aAAc,SAAQ,cAAc;IAChD,YAAY,OAAe,EAAE,OAA8D;QAC1F,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACtD,YAAY,OAAe,EAAE,OAA8D;QAC1F,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD;AAED,MAAM,OAAO,aAAc,SAAQ,cAAc;IAChD,YAAY,OAAe,EAAE,OAA8D;QAC1F,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD;AAED,MAAM,OAAO,wBAAyB,SAAQ,cAAc;IAC3D,YAAY,OAAe,EAAE,OAA8D;QAC1F,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACxC,CAAC;CACD;AAED,MAAM,OAAO,cAAe,SAAQ,cAAc;IACjD,YAAY,OAAe,EAAE,OAA8D;QAC1F,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACtD,YACC,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,EAAE;YACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;YACrC,OAAO,EAAE,OAAO,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD"}

package/dist/_utils/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Reusable SDK foundation.
+ *
+ * Provides base classes for building HTTP API SDKs:
+ * - Client: HTTP client with auth and request plumbing
+ * - Resource: Base class for API resource groupings
+ * - Errors: Complete error hierarchy
+ * - SSE: Server-sent events parser
+ */
+export { BaseClient } from "./client.js";
+export type { ClientOptions } from "./client.js";
+export { APIResource } from "./resource.js";
+export { parseSSEStream } from "./sse.js";
+export { SDKError, SSEParseError, APIError, APIConnectionError, APITimeoutError, APIStatusError, BadRequestError, AuthenticationError, PermissionDeniedError, NotFoundError, RequestTimeoutError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/_utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/_utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EACN,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,mBAAmB,GACnB,MAAM,aAAa,CAAC"}

package/dist/_utils/index.js

@@ -0,0 +1,14 @@
+/**
+ * Reusable SDK foundation.
+ *
+ * Provides base classes for building HTTP API SDKs:
+ * - Client: HTTP client with auth and request plumbing
+ * - Resource: Base class for API resource groupings
+ * - Errors: Complete error hierarchy
+ * - SSE: Server-sent events parser
+ */
+export { BaseClient } from "./client.js";
+export { APIResource } from "./resource.js";
+export { parseSSEStream } from "./sse.js";
+export { SDKError, SSEParseError, APIError, APIConnectionError, APITimeoutError, APIStatusError, BadRequestError, AuthenticationError, PermissionDeniedError, NotFoundError, RequestTimeoutError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/_utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/_utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EACN,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,mBAAmB,GACnB,MAAM,aAAa,CAAC"}

package/dist/_utils/resource.d.ts

@@ -0,0 +1,6 @@
+import type { BaseClient } from "./client.js";
+export declare class APIResource {
+    protected _client: BaseClient;
+    constructor(client: BaseClient);
+}
+//# sourceMappingURL=resource.d.ts.map

package/dist/_utils/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/_utils/resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,WAAW;IACvB,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC;gBAElB,MAAM,EAAE,UAAU;CAG9B"}

package/dist/_utils/resource.js

@@ -0,0 +1,7 @@
+export class APIResource {
+    _client;
+    constructor(client) {
+        this._client = client;
+    }
+}
+//# sourceMappingURL=resource.js.map

package/dist/_utils/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../src/_utils/resource.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACb,OAAO,CAAa;IAE9B,YAAY,MAAkB;QAC7B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;CACD"}

package/dist/_utils/sse.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SSE line-stream parser.
+ * Converts a ReadableStream of text chunks into parsed JSON event objects.
+ */
+/**
+ * Parse an SSE text stream into JSON event objects.
+ *
+ * Mirrors Python SDK's `parse_sse_line_stream`:
+ * - Strips each line
+ * - Skips empty lines and comment lines (`:` prefix)
+ * - Extracts `data:` payloads and parses as JSON
+ * - Ignores `event:`, `id:`, `retry:` lines
+ */
+export declare function parseSSEStream(stream: ReadableStream<string>): AsyncGenerator<Record<string, unknown>>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/_utils/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/_utils/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH;;;;;;;;GAQG;AACH,wBAAuB,cAAc,CACpC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,GAC5B,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBzC"}

package/dist/_utils/sse.js

@@ -0,0 +1,62 @@
+/**
+ * SSE line-stream parser.
+ * Converts a ReadableStream of text chunks into parsed JSON event objects.
+ */
+import { SSEParseError } from "./errors.js";
+const DATA_PREFIX = "data:";
+/** Split a ReadableStream<string> of arbitrary text chunks into lines. */
+async function* splitLines(stream) {
+    const reader = stream.getReader();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += value;
+            const lines = buffer.split("\n");
+            // Last element is either empty (if chunk ended with \n) or a partial line
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                yield line;
+            }
+        }
+        // Flush any remaining partial line
+        if (buffer.length > 0) {
+            yield buffer;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+/**
+ * Parse an SSE text stream into JSON event objects.
+ *
+ * Mirrors Python SDK's `parse_sse_line_stream`:
+ * - Strips each line
+ * - Skips empty lines and comment lines (`:` prefix)
+ * - Extracts `data:` payloads and parses as JSON
+ * - Ignores `event:`, `id:`, `retry:` lines
+ */
+export async function* parseSSEStream(stream) {
+    for await (const rawLine of splitLines(stream)) {
+        const line = rawLine.trim();
+        // Skip empty lines and comments
+        if (!line || line.startsWith(":")) {
+            continue;
+        }
+        // Parse data lines
+        if (line.startsWith(DATA_PREFIX)) {
+            const dataStr = line.slice(DATA_PREFIX.length).trim();
+            try {
+                yield JSON.parse(dataStr);
+            }
+            catch {
+                throw new SSEParseError("Malformed JSON in SSE event", line);
+            }
+        }
+        // Ignore event:, id:, retry: lines
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/_utils/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/_utils/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B,0EAA0E;AAC1E,KAAK,SAAS,CAAC,CAAC,UAAU,CAAC,MAA8B;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,IAAI,CAAC;QACJ,OAAO,IAAI,EAAE,CAAC;YACb,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAEhB,MAAM,IAAI,KAAK,CAAC;YAChB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,0EAA0E;YAC1E,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC;YACZ,CAAC;QACF,CAAC;QAED,mCAAmC;QACnC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,MAAM,CAAC;QACd,CAAC;IACF,CAAC;YAAS,CAAC;QACV,MAAM,CAAC,WAAW,EAAE,CAAC;IACtB,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACpC,MAA8B;IAE9B,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAE5B,gCAAgC;QAChC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,SAAS;QACV,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAEtD,IAAI,CAAC;gBACJ,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACR,MAAM,IAAI,aAAa,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;YAC9D,CAAC;QACF,CAAC;QAED,mCAAmC;IACpC,CAAC;AACF,CAAC"}