@gatectr/sdk 0.1.0

package/dist/esm/client.d.ts

@@ -0,0 +1,50 @@
+import type { GateCtrConfig, CompleteParams, CompleteResponse, ChatParams, ChatResponse, StreamParams, StreamChunk, ModelsResponse, UsageParams, UsageResponse } from "./types.js";
+/**
+ * GateCtr client — the main entry point for the @gatectr/sdk.
+ *
+ * @example
+ * ```typescript
+ * const client = new GateCtr({ apiKey: process.env.GATECTR_API_KEY });
+ * const response = await client.complete({ model: "gpt-4o", messages: [...] });
+ * ```
+ */
+export declare class GateCtr {
+    /** Resolved, validated configuration (all fields required after construction) */
+    private readonly _baseUrl;
+    private readonly _apiKey;
+    private readonly _timeout;
+    private readonly _maxRetries;
+    private readonly _optimize;
+    private readonly _route;
+    constructor(config?: GateCtrConfig);
+    /** Build the standard headers for every request */
+    private buildHeaders;
+    /** Extract GateCtrMetadata from response headers + body */
+    private extractMetadata;
+    /** Merge per-request GateCtr options into the request body */
+    private mergeGatectrOptions;
+    /** Build RequestOptions, conditionally including signal to satisfy exactOptionalPropertyTypes */
+    private buildRequestOptions;
+    /**
+     * Text completion — POST /complete
+     */
+    complete(params: CompleteParams): Promise<CompleteResponse>;
+    /**
+     * Chat completion — POST /chat
+     */
+    chat(params: ChatParams): Promise<ChatResponse>;
+    /**
+     * Streaming chat completion — POST /chat with stream: true
+     * Returns an AsyncIterable<StreamChunk> for use with `for await`.
+     */
+    stream(params: StreamParams): AsyncIterable<StreamChunk>;
+    /**
+     * List available models — GET /models
+     */
+    models(): Promise<ModelsResponse>;
+    /**
+     * Fetch usage statistics — GET /usage
+     */
+    usage(params?: UsageParams): Promise<UsageResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EAEb,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,EAEd,MAAM,YAAY,CAAC;AAUpB;;;;;;;;GAQG;AACH,qBAAa,OAAO;IAClB,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,MAAM,GAAE,aAAkB;IAuCtC,mDAAmD;IACnD,OAAO,CAAC,YAAY;IAQpB,2DAA2D;IAC3D,OAAO,CAAC,eAAe;IAYvB,8DAA8D;IAC9D,OAAO,CAAC,mBAAmB;IAe3B,iGAAiG;IACjG,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0DjE;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAmErD;;;OAGG;IACI,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC,WAAW,CAAC;IAoC/D;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAsCvC;;OAEG;IACG,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;CAwC1D"}

package/dist/esm/client.js

@@ -0,0 +1,312 @@
+// sdk-node/src/client.ts
+import { GateCtrConfigError } from "./errors.js";
+import { httpRequest } from "./http.js";
+import { parseSSE } from "./stream.js";
+// SDK version constant — avoids ESM/CJS import.meta.url compatibility issues
+const SDK_VERSION = "0.1.0";
+const DEFAULT_BASE_URL = "https://api.gatectr.com/v1";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_RETRIES = 3;
+/**
+ * GateCtr client — the main entry point for the @gatectr/sdk.
+ *
+ * @example
+ * ```typescript
+ * const client = new GateCtr({ apiKey: process.env.GATECTR_API_KEY });
+ * const response = await client.complete({ model: "gpt-4o", messages: [...] });
+ * ```
+ */
+export class GateCtr {
+    /** Resolved, validated configuration (all fields required after construction) */
+    _baseUrl;
+    _apiKey;
+    _timeout;
+    _maxRetries;
+    _optimize;
+    _route;
+    constructor(config = {}) {
+        // Resolve API key: constructor option → env var → throw
+        const rawKey = config.apiKey ?? process.env["GATECTR_API_KEY"];
+        if (!rawKey || rawKey.trim() === "") {
+            throw new GateCtrConfigError("GateCtr API key is required. Pass apiKey in the config or set the GATECTR_API_KEY environment variable.");
+        }
+        this._apiKey = rawKey.trim();
+        // Validate and normalize baseUrl
+        const rawBaseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+        try {
+            const parsed = new URL(rawBaseUrl);
+            if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+                throw new GateCtrConfigError(`Invalid baseUrl: "${rawBaseUrl}". Must be an HTTP or HTTPS URL.`);
+            }
+        }
+        catch (err) {
+            if (err instanceof GateCtrConfigError)
+                throw err;
+            throw new GateCtrConfigError(`Invalid baseUrl: "${rawBaseUrl}". Must be a valid HTTP or HTTPS URL.`);
+        }
+        // Strip trailing slash(es)
+        this._baseUrl = rawBaseUrl.replace(/\/+$/, "");
+        this._timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
+        this._maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this._optimize = config.optimize ?? true;
+        this._route = config.route ?? false;
+    }
+    // ─── Private helpers ────────────────────────────────────────────────────────
+    /** Build the standard headers for every request */
+    buildHeaders(extra) {
+        return {
+            Authorization: `Bearer ${this._apiKey}`,
+            "User-Agent": `@gatectr/sdk/${SDK_VERSION} node/${process.version}`,
+            ...extra,
+        };
+    }
+    /** Extract GateCtrMetadata from response headers + body */
+    extractMetadata(headers, body) {
+        const requestId = headers.get("x-gatectr-request-id") ?? "";
+        const latencyMs = parseInt(headers.get("x-gatectr-latency-ms") ?? "0", 10);
+        const overage = headers.get("x-gatectr-overage") === "true";
+        const usage = body["usage"];
+        const tokensSaved = typeof usage?.["saved_tokens"] === "number" ? usage["saved_tokens"] : 0;
+        const modelUsed = typeof body["model"] === "string" ? body["model"] : "";
+        return { requestId, latencyMs, overage, modelUsed, tokensSaved };
+    }
+    /** Merge per-request GateCtr options into the request body */
+    mergeGatectrOptions(perRequest) {
+        const merged = {
+            optimize: this._optimize,
+            route: this._route,
+        };
+        if (perRequest !== undefined) {
+            if (perRequest.optimize !== undefined)
+                merged["optimize"] = perRequest.optimize;
+            if (perRequest.route !== undefined)
+                merged["route"] = perRequest.route;
+            if (perRequest.budgetId !== undefined)
+                merged["budgetId"] = perRequest.budgetId;
+        }
+        return merged;
+    }
+    /** Build RequestOptions, conditionally including signal to satisfy exactOptionalPropertyTypes */
+    buildRequestOptions(base, signal) {
+        if (signal !== undefined) {
+            return { ...base, signal };
+        }
+        return base;
+    }
+    // ─── Public API ─────────────────────────────────────────────────────────────
+    /**
+     * Text completion — POST /complete
+     */
+    async complete(params) {
+        const gatectrOpts = this.mergeGatectrOptions(params.gatectr);
+        const body = {
+            model: params.model,
+            messages: params.messages,
+            stream: false,
+            ...gatectrOpts,
+        };
+        if (params.max_tokens !== undefined)
+            body["max_tokens"] = params.max_tokens;
+        if (params.temperature !== undefined)
+            body["temperature"] = params.temperature;
+        const raw = await httpRequest(this.buildRequestOptions({
+            method: "POST",
+            url: `${this._baseUrl}/complete`,
+            headers: {
+                ...this.buildHeaders(),
+                "Content-Type": "application/json",
+            },
+            body,
+            timeoutMs: this._timeout,
+            maxRetries: this._maxRetries,
+        }, params.signal));
+        const responseBody = (await raw.json());
+        const gatectr = this.extractMetadata(raw.headers, responseBody);
+        const usageBody = responseBody["usage"];
+        const promptTokens = usageBody !== undefined ? Number(usageBody["prompt_tokens"] ?? 0) : 0;
+        const completionTokens = usageBody !== undefined ? Number(usageBody["completion_tokens"] ?? 0) : 0;
+        const totalTokens = usageBody !== undefined ? Number(usageBody["total_tokens"] ?? 0) : 0;
+        return {
+            id: typeof responseBody["id"] === "string" ? responseBody["id"] : "",
+            object: "text_completion",
+            model: typeof responseBody["model"] === "string" ? responseBody["model"] : "",
+            choices: (Array.isArray(responseBody["choices"])
+                ? responseBody["choices"]
+                : []).map((c) => ({
+                text: typeof c["text"] === "string" ? c["text"] : "",
+                finish_reason: typeof c["finish_reason"] === "string" ? c["finish_reason"] : "",
+            })),
+            usage: {
+                prompt_tokens: promptTokens,
+                completion_tokens: completionTokens,
+                total_tokens: totalTokens,
+            },
+            gatectr,
+        };
+    }
+    /**
+     * Chat completion — POST /chat
+     */
+    async chat(params) {
+        const gatectrOpts = this.mergeGatectrOptions(params.gatectr);
+        const body = {
+            model: params.model,
+            messages: params.messages,
+            stream: false,
+            ...gatectrOpts,
+        };
+        if (params.max_tokens !== undefined)
+            body["max_tokens"] = params.max_tokens;
+        if (params.temperature !== undefined)
+            body["temperature"] = params.temperature;
+        const raw = await httpRequest(this.buildRequestOptions({
+            method: "POST",
+            url: `${this._baseUrl}/chat`,
+            headers: {
+                ...this.buildHeaders(),
+                "Content-Type": "application/json",
+            },
+            body,
+            timeoutMs: this._timeout,
+            maxRetries: this._maxRetries,
+        }, params.signal));
+        const responseBody = (await raw.json());
+        const gatectr = this.extractMetadata(raw.headers, responseBody);
+        const usageBody = responseBody["usage"];
+        const promptTokens = usageBody !== undefined ? Number(usageBody["prompt_tokens"] ?? 0) : 0;
+        const completionTokens = usageBody !== undefined ? Number(usageBody["completion_tokens"] ?? 0) : 0;
+        const totalTokens = usageBody !== undefined ? Number(usageBody["total_tokens"] ?? 0) : 0;
+        return {
+            id: typeof responseBody["id"] === "string" ? responseBody["id"] : "",
+            object: "chat.completion",
+            model: typeof responseBody["model"] === "string" ? responseBody["model"] : "",
+            choices: (Array.isArray(responseBody["choices"])
+                ? responseBody["choices"]
+                : []).map((c) => {
+                const msg = c["message"];
+                const role = msg !== undefined && typeof msg["role"] === "string"
+                    ? msg["role"]
+                    : "assistant";
+                const content = msg !== undefined && typeof msg["content"] === "string" ? msg["content"] : "";
+                return {
+                    message: { role, content },
+                    finish_reason: typeof c["finish_reason"] === "string" ? c["finish_reason"] : "",
+                };
+            }),
+            usage: {
+                prompt_tokens: promptTokens,
+                completion_tokens: completionTokens,
+                total_tokens: totalTokens,
+            },
+            gatectr,
+        };
+    }
+    /**
+     * Streaming chat completion — POST /chat with stream: true
+     * Returns an AsyncIterable<StreamChunk> for use with `for await`.
+     */
+    async *stream(params) {
+        const gatectrOpts = this.mergeGatectrOptions(params.gatectr);
+        const body = {
+            model: params.model,
+            messages: params.messages,
+            stream: true,
+            ...gatectrOpts,
+        };
+        if (params.max_tokens !== undefined)
+            body["max_tokens"] = params.max_tokens;
+        if (params.temperature !== undefined)
+            body["temperature"] = params.temperature;
+        const raw = await httpRequest(this.buildRequestOptions({
+            method: "POST",
+            url: `${this._baseUrl}/chat`,
+            headers: {
+                ...this.buildHeaders(),
+                "Content-Type": "application/json",
+            },
+            body,
+            timeoutMs: this._timeout,
+            maxRetries: this._maxRetries,
+        }, params.signal));
+        if (raw.body === null) {
+            return;
+        }
+        yield* parseSSE(raw.body, params.signal);
+    }
+    /**
+     * List available models — GET /models
+     */
+    async models() {
+        const raw = await httpRequest({
+            method: "GET",
+            url: `${this._baseUrl}/models`,
+            headers: this.buildHeaders(),
+            timeoutMs: this._timeout,
+            maxRetries: this._maxRetries,
+        });
+        const responseBody = (await raw.json());
+        const requestId = raw.headers.get("x-gatectr-request-id") ?? "";
+        const modelsRaw = responseBody["models"] ?? [];
+        return {
+            models: modelsRaw.map((m) => ({
+                modelId: typeof m["modelId"] === "string"
+                    ? m["modelId"]
+                    : typeof m["model_id"] === "string"
+                        ? m["model_id"]
+                        : "",
+                displayName: typeof m["displayName"] === "string"
+                    ? m["displayName"]
+                    : typeof m["display_name"] === "string"
+                        ? m["display_name"]
+                        : "",
+                provider: typeof m["provider"] === "string" ? m["provider"] : "",
+                contextWindow: Number(m["contextWindow"] ?? m["context_window"] ?? 0),
+                capabilities: Array.isArray(m["capabilities"])
+                    ? m["capabilities"].map(String)
+                    : [],
+            })),
+            requestId,
+        };
+    }
+    /**
+     * Fetch usage statistics — GET /usage
+     */
+    async usage(params) {
+        const url = new URL(`${this._baseUrl}/usage`);
+        if (params?.from !== undefined)
+            url.searchParams.set("from", params.from);
+        if (params?.to !== undefined)
+            url.searchParams.set("to", params.to);
+        if (params?.projectId !== undefined)
+            url.searchParams.set("projectId", params.projectId);
+        const raw = await httpRequest({
+            method: "GET",
+            url: url.toString(),
+            headers: this.buildHeaders(),
+            timeoutMs: this._timeout,
+            maxRetries: this._maxRetries,
+        });
+        const responseBody = (await raw.json());
+        const byProject = (responseBody["byProject"] ?? []).map((p) => ({
+            projectId: typeof p["projectId"] === "string" ? p["projectId"] : null,
+            totalTokens: Number(p["totalTokens"] ?? 0),
+            totalRequests: Number(p["totalRequests"] ?? 0),
+            totalCostUsd: Number(p["totalCostUsd"] ?? 0),
+        }));
+        return {
+            totalTokens: Number(responseBody["totalTokens"] ?? 0),
+            totalRequests: Number(responseBody["totalRequests"] ?? 0),
+            totalCostUsd: Number(responseBody["totalCostUsd"] ?? 0),
+            savedTokens: Number(responseBody["savedTokens"] ?? 0),
+            from: typeof responseBody["from"] === "string" ? responseBody["from"] : "",
+            to: typeof responseBody["to"] === "string" ? responseBody["to"] : "",
+            byProject,
+            ...(responseBody["budgetStatus"] !== undefined
+                ? {
+                    budgetStatus: responseBody["budgetStatus"],
+                }
+                : {}),
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/errors.d.ts

@@ -0,0 +1,42 @@
+/** Base error class for all GateCtr SDK errors */
+export declare class GateCtrError extends Error {
+    constructor(message: string);
+}
+/** Thrown for invalid or missing configuration (e.g., no API key) */
+export declare class GateCtrConfigError extends GateCtrError {
+    constructor(message: string);
+}
+/** Thrown when the Platform returns a non-2xx HTTP response */
+export declare class GateCtrApiError extends GateCtrError {
+    readonly status: number;
+    readonly code: string;
+    readonly requestId: string | undefined;
+    constructor(opts: {
+        message: string;
+        status: number;
+        code: string;
+        requestId?: string;
+    });
+    /** Returns a plain object safe for JSON.stringify in logging pipelines. Never includes the API key. */
+    toJSON(): {
+        name: string;
+        message: string;
+        status: number;
+        code: string;
+        requestId: string | undefined;
+    };
+}
+/** Thrown when a request exceeds the configured timeout */
+export declare class GateCtrTimeoutError extends GateCtrError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+/** Thrown when a streaming connection fails mid-stream */
+export declare class GateCtrStreamError extends GateCtrError {
+    constructor(message: string, cause?: unknown);
+}
+/** Thrown for DNS failures, connection refused, and other transport-level errors */
+export declare class GateCtrNetworkError extends GateCtrError {
+    constructor(message: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAM5B;AAED,qEAAqE;AACrE,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,OAAO,EAAE,MAAM;CAK5B;AAED,+DAA+D;AAC/D,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IASvF,uGAAuG;IACvG,MAAM,IAAI;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;KAC/B;CASF;AAED,2DAA2D;AAC3D,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAM9B;AAED,0DAA0D;AAC1D,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAQ7C;AAED,oFAAoF;AACpF,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAQ7C"}

package/dist/esm/errors.js

@@ -0,0 +1,75 @@
+// sdk-node/src/errors.ts
+/** Base error class for all GateCtr SDK errors */
+export class GateCtrError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GateCtrError";
+        // Fix prototype chain for instanceof checks in transpiled code
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Thrown for invalid or missing configuration (e.g., no API key) */
+export class GateCtrConfigError extends GateCtrError {
+    constructor(message) {
+        super(message);
+        this.name = "GateCtrConfigError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Thrown when the Platform returns a non-2xx HTTP response */
+export class GateCtrApiError extends GateCtrError {
+    status;
+    code;
+    requestId;
+    constructor(opts) {
+        super(opts.message);
+        this.name = "GateCtrApiError";
+        this.status = opts.status;
+        this.code = opts.code;
+        this.requestId = opts.requestId;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    /** Returns a plain object safe for JSON.stringify in logging pipelines. Never includes the API key. */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            status: this.status,
+            code: this.code,
+            requestId: this.requestId,
+        };
+    }
+}
+/** Thrown when a request exceeds the configured timeout */
+export class GateCtrTimeoutError extends GateCtrError {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Request timed out after ${String(timeoutMs)}ms`);
+        this.name = "GateCtrTimeoutError";
+        this.timeoutMs = timeoutMs;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Thrown when a streaming connection fails mid-stream */
+export class GateCtrStreamError extends GateCtrError {
+    constructor(message, cause) {
+        super(message);
+        this.name = "GateCtrStreamError";
+        if (cause !== undefined) {
+            this.cause = cause;
+        }
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Thrown for DNS failures, connection refused, and other transport-level errors */
+export class GateCtrNetworkError extends GateCtrError {
+    constructor(message, cause) {
+        super(message);
+        this.name = "GateCtrNetworkError";
+        if (cause !== undefined) {
+            this.cause = cause;
+        }
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,yBAAyB;AAEzB,kDAAkD;AAClD,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,+DAA+D;QAC/D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,OAAO,eAAgB,SAAQ,YAAY;IACtC,MAAM,CAAS;IACf,IAAI,CAAS;IACb,SAAS,CAAqB;IAEvC,YAAY,IAA2E;QACrF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,uGAAuG;IACvG,MAAM;QAOJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IAC1C,SAAS,CAAS;IAE3B,YAAY,SAAiB;QAC3B,KAAK,CAAC,2BAA2B,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,0DAA0D;AAC1D,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/esm/http.d.ts

@@ -0,0 +1,26 @@
+export interface RequestOptions {
+    method: "GET" | "POST";
+    url: string;
+    headers: Record<string, string>;
+    body?: unknown;
+    signal?: AbortSignal;
+    timeoutMs: number;
+    maxRetries: number;
+}
+export interface RawResponse {
+    status: number;
+    headers: Headers;
+    body: ReadableStream<Uint8Array> | null;
+    json(): Promise<unknown>;
+}
+/**
+ * Exponential backoff with jitter.
+ * delay = min(500 * 2^attempt + jitter(0-100ms), 10_000ms)
+ */
+export declare function backoffMs(attempt: number): number;
+/**
+ * Core HTTP request function with retry loop and timeout.
+ * Throws typed GateCtr errors — never raw fetch errors.
+ */
+export declare function httpRequest(opts: RequestOptions): Promise<RawResponse>;
+//# sourceMappingURL=http.d.ts.map

package/dist/esm/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACxC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAQD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIjD;AA6BD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAuI5E"}