@gatectr/sdk 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +199 -0
  3. package/dist/cjs/client.d.ts +50 -0
  4. package/dist/cjs/client.d.ts.map +1 -0
  5. package/dist/cjs/client.js +316 -0
  6. package/dist/cjs/client.js.map +1 -0
  7. package/dist/cjs/errors.d.ts +42 -0
  8. package/dist/cjs/errors.d.ts.map +1 -0
  9. package/dist/cjs/errors.js +84 -0
  10. package/dist/cjs/errors.js.map +1 -0
  11. package/dist/cjs/http.d.ts +26 -0
  12. package/dist/cjs/http.d.ts.map +1 -0
  13. package/dist/cjs/http.js +164 -0
  14. package/dist/cjs/http.js.map +1 -0
  15. package/dist/cjs/index.d.ts +4 -0
  16. package/dist/cjs/index.d.ts.map +1 -0
  17. package/dist/cjs/index.js +15 -0
  18. package/dist/cjs/index.js.map +1 -0
  19. package/dist/cjs/package.json +3 -0
  20. package/dist/cjs/stream.d.ts +8 -0
  21. package/dist/cjs/stream.d.ts.map +1 -0
  22. package/dist/cjs/stream.js +100 -0
  23. package/dist/cjs/stream.js.map +1 -0
  24. package/dist/cjs/types.d.ts +155 -0
  25. package/dist/cjs/types.d.ts.map +1 -0
  26. package/dist/cjs/types.js +3 -0
  27. package/dist/cjs/types.js.map +1 -0
  28. package/dist/esm/client.d.ts +50 -0
  29. package/dist/esm/client.d.ts.map +1 -0
  30. package/dist/esm/client.js +312 -0
  31. package/dist/esm/client.js.map +1 -0
  32. package/dist/esm/errors.d.ts +42 -0
  33. package/dist/esm/errors.d.ts.map +1 -0
  34. package/dist/esm/errors.js +75 -0
  35. package/dist/esm/errors.js.map +1 -0
  36. package/dist/esm/http.d.ts +26 -0
  37. package/dist/esm/http.d.ts.map +1 -0
  38. package/dist/esm/http.js +160 -0
  39. package/dist/esm/http.js.map +1 -0
  40. package/dist/esm/index.d.ts +4 -0
  41. package/dist/esm/index.d.ts.map +1 -0
  42. package/dist/esm/index.js +5 -0
  43. package/dist/esm/index.js.map +1 -0
  44. package/dist/esm/stream.d.ts +8 -0
  45. package/dist/esm/stream.d.ts.map +1 -0
  46. package/dist/esm/stream.js +97 -0
  47. package/dist/esm/stream.js.map +1 -0
  48. package/dist/esm/types.d.ts +155 -0
  49. package/dist/esm/types.d.ts.map +1 -0
  50. package/dist/esm/types.js +2 -0
  51. package/dist/esm/types.js.map +1 -0
  52. package/package.json +88 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 GateCtr
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,199 @@
1
+ <div align="center">
2
+
3
+ <img src="https://raw.githubusercontent.com/GateCtr/.github/main/profile/logo.svg" width="56" height="56" alt="GateCtr" />
4
+
5
+ # @gatectr/sdk
6
+
7
+ **Node.js SDK for GateCtr — One gateway. Every LLM.**
8
+
9
+ [![npm](https://img.shields.io/npm/v/@gatectr/sdk?color=1B4F82)](https://www.npmjs.com/package/@gatectr/sdk)
10
+ [![CI](https://github.com/GateCtr/sdk-node/actions/workflows/ci.yml/badge.svg)](https://github.com/GateCtr/sdk-node/actions/workflows/ci.yml)
11
+ [![license](https://img.shields.io/badge/license-MIT-00B4C8)](LICENSE)
12
+ [![node](https://img.shields.io/badge/node-%3E%3D22-brightgreen)](https://nodejs.org)
13
+
14
+ </div>
15
+
16
+ ---
17
+
18
+ ## Install
19
+
20
+ ```bash
21
+ npm install @gatectr/sdk
22
+ pnpm add @gatectr/sdk
23
+ yarn add @gatectr/sdk
24
+ bun add @gatectr/sdk
25
+ ```
26
+
27
+ ## Quick start
28
+
29
+ ```typescript
30
+ import { GateCtr } from "@gatectr/sdk";
31
+
32
+ const client = new GateCtr({ apiKey: process.env.GATECTR_API_KEY });
33
+
34
+ const response = await client.complete({
35
+ model: "gpt-4o",
36
+ messages: [{ role: "user", content: "Hello" }],
37
+ });
38
+
39
+ console.log(response.choices[0]?.text);
40
+ console.log(response.gatectr.tokensSaved); // tokens saved by the optimizer
41
+ ```
42
+
43
+ One endpoint swap. Your existing code works as-is.
44
+
45
+ ---
46
+
47
+ ## What GateCtr adds automatically
48
+
49
+ - **-40% tokens** — Context Optimizer compresses prompts before they hit the LLM
50
+ - **Budget Firewall** — Hard caps per project. Requests blocked when limit is reached.
51
+ - **Model Router** — Let GateCtr pick the right model for each request
52
+ - **Analytics** — Every token, every cost tracked in your dashboard
53
+ - **Webhooks** — Budget alerts pushed to Slack, Teams, or any URL
54
+
55
+ ---
56
+
57
+ ## Usage
58
+
59
+ ### Completion
60
+
61
+ ```typescript
62
+ const response = await client.complete({
63
+ model: "gpt-4o",
64
+ messages: [
65
+ { role: "system", content: "You are a helpful assistant." },
66
+ { role: "user", content: "Summarize this document." },
67
+ ],
68
+ max_tokens: 512,
69
+ temperature: 0.7,
70
+ });
71
+ ```
72
+
73
+ ### Chat
74
+
75
+ ```typescript
76
+ const response = await client.chat({
77
+ model: "gpt-4o",
78
+ messages: [{ role: "user", content: "Hello" }],
79
+ });
80
+
81
+ console.log(response.choices[0]?.message.content);
82
+ ```
83
+
84
+ ### Streaming
85
+
86
+ ```typescript
87
+ for await (const chunk of client.stream({
88
+ model: "gpt-4o",
89
+ messages: [{ role: "user", content: "Hello" }],
90
+ })) {
91
+ process.stdout.write(chunk.delta ?? "");
92
+ }
93
+ ```
94
+
95
+ ### Models & usage
96
+
97
+ ```typescript
98
+ const { models } = await client.models();
99
+ // [{ modelId: "gpt-4o", provider: "openai", ... }, ...]
100
+
101
+ const usage = await client.usage({ from: "2025-01-01", to: "2025-01-31" });
102
+ // { totalTokens: 150000, savedTokens: 45000, ... }
103
+ ```
104
+
105
+ ### Per-request options
106
+
107
+ ```typescript
108
+ const response = await client.complete({
109
+ model: "gpt-4o",
110
+ messages,
111
+ gatectr: {
112
+ budgetId: "proj_123", // enforce a specific budget
113
+ optimize: true, // override client-level setting
114
+ route: false, // disable model router for this call
115
+ },
116
+ });
117
+ ```
118
+
119
+ ---
120
+
121
+ ## Configuration
122
+
123
+ ```typescript
124
+ const client = new GateCtr({
125
+ apiKey: "gct_...", // or set GATECTR_API_KEY env var
126
+ baseUrl: "https://api.gatectr.com/v1", // default
127
+ timeout: 30_000, // ms, default 30s
128
+ maxRetries: 3, // default 3
129
+ optimize: true, // enable context optimizer globally
130
+ route: false, // disable model router globally
131
+ });
132
+ ```
133
+
134
+ | Option | Type | Default | Description |
135
+ | ------------ | --------- | ---------------------------- | --------------------------------- |
136
+ | `apiKey` | `string` | `GATECTR_API_KEY` env var | Your GateCtr API key |
137
+ | `baseUrl` | `string` | `https://api.gatectr.com/v1` | API base URL |
138
+ | `timeout` | `number` | `30000` | Request timeout in ms |
139
+ | `maxRetries` | `number` | `3` | Retries on 429/5xx |
140
+ | `optimize` | `boolean` | `true` | Enable context optimizer globally |
141
+ | `route` | `boolean` | `false` | Enable model router globally |
142
+
143
+ ---
144
+
145
+ ## Error handling
146
+
147
+ ```typescript
148
+ import { GateCtrApiError, GateCtrTimeoutError, GateCtrNetworkError } from "@gatectr/sdk";
149
+
150
+ try {
151
+ await client.complete({ model: "gpt-4o", messages });
152
+ } catch (err) {
153
+ if (err instanceof GateCtrApiError) {
154
+ console.error(err.status, err.code, err.requestId);
155
+ } else if (err instanceof GateCtrTimeoutError) {
156
+ console.error(`Timed out after ${err.timeoutMs}ms`);
157
+ } else if (err instanceof GateCtrNetworkError) {
158
+ console.error("Network error", err.cause);
159
+ }
160
+ }
161
+ ```
162
+
163
+ | Error class | When |
164
+ | --------------------- | ----------------------------------------- |
165
+ | `GateCtrConfigError` | Invalid `apiKey` or `baseUrl` at init |
166
+ | `GateCtrApiError` | Non-2xx response from the API |
167
+ | `GateCtrTimeoutError` | Request exceeded `timeout` |
168
+ | `GateCtrNetworkError` | Network failure (DNS, connection refused) |
169
+ | `GateCtrStreamError` | SSE stream parse or connection error |
170
+
171
+ ---
172
+
173
+ ## Drop-in for OpenAI SDK
174
+
175
+ Already using the OpenAI SDK? Swap the base URL:
176
+
177
+ ```typescript
178
+ import OpenAI from "openai";
179
+
180
+ const openai = new OpenAI({
181
+ apiKey: process.env.GATECTR_API_KEY,
182
+ baseURL: "https://api.gatectr.com/v1",
183
+ });
184
+
185
+ // Everything else stays the same
186
+ ```
187
+
188
+ ---
189
+
190
+ ## Requirements
191
+
192
+ - Node.js 22+
193
+ - TypeScript 5+ (optional but recommended)
194
+
195
+ ---
196
+
197
+ ## Links
198
+
199
+ [Dashboard](https://gatectr.com) · [Docs](https://docs.gatectr.com) · [Status](https://status.gatectr.com) · [npm](https://www.npmjs.com/package/@gatectr/sdk)
@@ -0,0 +1,50 @@
1
+ import type { GateCtrConfig, CompleteParams, CompleteResponse, ChatParams, ChatResponse, StreamParams, StreamChunk, ModelsResponse, UsageParams, UsageResponse } from "./types.js";
2
+ /**
3
+ * GateCtr client — the main entry point for the @gatectr/sdk.
4
+ *
5
+ * @example
6
+ * ```typescript
7
+ * const client = new GateCtr({ apiKey: process.env.GATECTR_API_KEY });
8
+ * const response = await client.complete({ model: "gpt-4o", messages: [...] });
9
+ * ```
10
+ */
11
+ export declare class GateCtr {
12
+ /** Resolved, validated configuration (all fields required after construction) */
13
+ private readonly _baseUrl;
14
+ private readonly _apiKey;
15
+ private readonly _timeout;
16
+ private readonly _maxRetries;
17
+ private readonly _optimize;
18
+ private readonly _route;
19
+ constructor(config?: GateCtrConfig);
20
+ /** Build the standard headers for every request */
21
+ private buildHeaders;
22
+ /** Extract GateCtrMetadata from response headers + body */
23
+ private extractMetadata;
24
+ /** Merge per-request GateCtr options into the request body */
25
+ private mergeGatectrOptions;
26
+ /** Build RequestOptions, conditionally including signal to satisfy exactOptionalPropertyTypes */
27
+ private buildRequestOptions;
28
+ /**
29
+ * Text completion — POST /complete
30
+ */
31
+ complete(params: CompleteParams): Promise<CompleteResponse>;
32
+ /**
33
+ * Chat completion — POST /chat
34
+ */
35
+ chat(params: ChatParams): Promise<ChatResponse>;
36
+ /**
37
+ * Streaming chat completion — POST /chat with stream: true
38
+ * Returns an AsyncIterable<StreamChunk> for use with `for await`.
39
+ */
40
+ stream(params: StreamParams): AsyncIterable<StreamChunk>;
41
+ /**
42
+ * List available models — GET /models
43
+ */
44
+ models(): Promise<ModelsResponse>;
45
+ /**
46
+ * Fetch usage statistics — GET /usage
47
+ */
48
+ usage(params?: UsageParams): Promise<UsageResponse>;
49
+ }
50
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,316 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.GateCtr = void 0;
4
+ // sdk-node/src/client.ts
5
+ const errors_js_1 = require("./errors.js");
6
+ const http_js_1 = require("./http.js");
7
+ const stream_js_1 = require("./stream.js");
8
+ // SDK version constant — avoids ESM/CJS import.meta.url compatibility issues
9
+ const SDK_VERSION = "0.1.0";
10
+ const DEFAULT_BASE_URL = "https://api.gatectr.com/v1";
11
+ const DEFAULT_TIMEOUT_MS = 30_000;
12
+ const DEFAULT_MAX_RETRIES = 3;
13
+ /**
14
+ * GateCtr client — the main entry point for the @gatectr/sdk.
15
+ *
16
+ * @example
17
+ * ```typescript
18
+ * const client = new GateCtr({ apiKey: process.env.GATECTR_API_KEY });
19
+ * const response = await client.complete({ model: "gpt-4o", messages: [...] });
20
+ * ```
21
+ */
22
+ class GateCtr {
23
+ /** Resolved, validated configuration (all fields required after construction) */
24
+ _baseUrl;
25
+ _apiKey;
26
+ _timeout;
27
+ _maxRetries;
28
+ _optimize;
29
+ _route;
30
+ constructor(config = {}) {
31
+ // Resolve API key: constructor option → env var → throw
32
+ const rawKey = config.apiKey ?? process.env["GATECTR_API_KEY"];
33
+ if (!rawKey || rawKey.trim() === "") {
34
+ throw new errors_js_1.GateCtrConfigError("GateCtr API key is required. Pass apiKey in the config or set the GATECTR_API_KEY environment variable.");
35
+ }
36
+ this._apiKey = rawKey.trim();
37
+ // Validate and normalize baseUrl
38
+ const rawBaseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
39
+ try {
40
+ const parsed = new URL(rawBaseUrl);
41
+ if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
42
+ throw new errors_js_1.GateCtrConfigError(`Invalid baseUrl: "${rawBaseUrl}". Must be an HTTP or HTTPS URL.`);
43
+ }
44
+ }
45
+ catch (err) {
46
+ if (err instanceof errors_js_1.GateCtrConfigError)
47
+ throw err;
48
+ throw new errors_js_1.GateCtrConfigError(`Invalid baseUrl: "${rawBaseUrl}". Must be a valid HTTP or HTTPS URL.`);
49
+ }
50
+ // Strip trailing slash(es)
51
+ this._baseUrl = rawBaseUrl.replace(/\/+$/, "");
52
+ this._timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
53
+ this._maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
54
+ this._optimize = config.optimize ?? true;
55
+ this._route = config.route ?? false;
56
+ }
57
+ // ─── Private helpers ────────────────────────────────────────────────────────
58
+ /** Build the standard headers for every request */
59
+ buildHeaders(extra) {
60
+ return {
61
+ Authorization: `Bearer ${this._apiKey}`,
62
+ "User-Agent": `@gatectr/sdk/${SDK_VERSION} node/${process.version}`,
63
+ ...extra,
64
+ };
65
+ }
66
+ /** Extract GateCtrMetadata from response headers + body */
67
+ extractMetadata(headers, body) {
68
+ const requestId = headers.get("x-gatectr-request-id") ?? "";
69
+ const latencyMs = parseInt(headers.get("x-gatectr-latency-ms") ?? "0", 10);
70
+ const overage = headers.get("x-gatectr-overage") === "true";
71
+ const usage = body["usage"];
72
+ const tokensSaved = typeof usage?.["saved_tokens"] === "number" ? usage["saved_tokens"] : 0;
73
+ const modelUsed = typeof body["model"] === "string" ? body["model"] : "";
74
+ return { requestId, latencyMs, overage, modelUsed, tokensSaved };
75
+ }
76
+ /** Merge per-request GateCtr options into the request body */
77
+ mergeGatectrOptions(perRequest) {
78
+ const merged = {
79
+ optimize: this._optimize,
80
+ route: this._route,
81
+ };
82
+ if (perRequest !== undefined) {
83
+ if (perRequest.optimize !== undefined)
84
+ merged["optimize"] = perRequest.optimize;
85
+ if (perRequest.route !== undefined)
86
+ merged["route"] = perRequest.route;
87
+ if (perRequest.budgetId !== undefined)
88
+ merged["budgetId"] = perRequest.budgetId;
89
+ }
90
+ return merged;
91
+ }
92
+ /** Build RequestOptions, conditionally including signal to satisfy exactOptionalPropertyTypes */
93
+ buildRequestOptions(base, signal) {
94
+ if (signal !== undefined) {
95
+ return { ...base, signal };
96
+ }
97
+ return base;
98
+ }
99
+ // ─── Public API ─────────────────────────────────────────────────────────────
100
+ /**
101
+ * Text completion — POST /complete
102
+ */
103
+ async complete(params) {
104
+ const gatectrOpts = this.mergeGatectrOptions(params.gatectr);
105
+ const body = {
106
+ model: params.model,
107
+ messages: params.messages,
108
+ stream: false,
109
+ ...gatectrOpts,
110
+ };
111
+ if (params.max_tokens !== undefined)
112
+ body["max_tokens"] = params.max_tokens;
113
+ if (params.temperature !== undefined)
114
+ body["temperature"] = params.temperature;
115
+ const raw = await (0, http_js_1.httpRequest)(this.buildRequestOptions({
116
+ method: "POST",
117
+ url: `${this._baseUrl}/complete`,
118
+ headers: {
119
+ ...this.buildHeaders(),
120
+ "Content-Type": "application/json",
121
+ },
122
+ body,
123
+ timeoutMs: this._timeout,
124
+ maxRetries: this._maxRetries,
125
+ }, params.signal));
126
+ const responseBody = (await raw.json());
127
+ const gatectr = this.extractMetadata(raw.headers, responseBody);
128
+ const usageBody = responseBody["usage"];
129
+ const promptTokens = usageBody !== undefined ? Number(usageBody["prompt_tokens"] ?? 0) : 0;
130
+ const completionTokens = usageBody !== undefined ? Number(usageBody["completion_tokens"] ?? 0) : 0;
131
+ const totalTokens = usageBody !== undefined ? Number(usageBody["total_tokens"] ?? 0) : 0;
132
+ return {
133
+ id: typeof responseBody["id"] === "string" ? responseBody["id"] : "",
134
+ object: "text_completion",
135
+ model: typeof responseBody["model"] === "string" ? responseBody["model"] : "",
136
+ choices: (Array.isArray(responseBody["choices"])
137
+ ? responseBody["choices"]
138
+ : []).map((c) => ({
139
+ text: typeof c["text"] === "string" ? c["text"] : "",
140
+ finish_reason: typeof c["finish_reason"] === "string" ? c["finish_reason"] : "",
141
+ })),
142
+ usage: {
143
+ prompt_tokens: promptTokens,
144
+ completion_tokens: completionTokens,
145
+ total_tokens: totalTokens,
146
+ },
147
+ gatectr,
148
+ };
149
+ }
150
+ /**
151
+ * Chat completion — POST /chat
152
+ */
153
+ async chat(params) {
154
+ const gatectrOpts = this.mergeGatectrOptions(params.gatectr);
155
+ const body = {
156
+ model: params.model,
157
+ messages: params.messages,
158
+ stream: false,
159
+ ...gatectrOpts,
160
+ };
161
+ if (params.max_tokens !== undefined)
162
+ body["max_tokens"] = params.max_tokens;
163
+ if (params.temperature !== undefined)
164
+ body["temperature"] = params.temperature;
165
+ const raw = await (0, http_js_1.httpRequest)(this.buildRequestOptions({
166
+ method: "POST",
167
+ url: `${this._baseUrl}/chat`,
168
+ headers: {
169
+ ...this.buildHeaders(),
170
+ "Content-Type": "application/json",
171
+ },
172
+ body,
173
+ timeoutMs: this._timeout,
174
+ maxRetries: this._maxRetries,
175
+ }, params.signal));
176
+ const responseBody = (await raw.json());
177
+ const gatectr = this.extractMetadata(raw.headers, responseBody);
178
+ const usageBody = responseBody["usage"];
179
+ const promptTokens = usageBody !== undefined ? Number(usageBody["prompt_tokens"] ?? 0) : 0;
180
+ const completionTokens = usageBody !== undefined ? Number(usageBody["completion_tokens"] ?? 0) : 0;
181
+ const totalTokens = usageBody !== undefined ? Number(usageBody["total_tokens"] ?? 0) : 0;
182
+ return {
183
+ id: typeof responseBody["id"] === "string" ? responseBody["id"] : "",
184
+ object: "chat.completion",
185
+ model: typeof responseBody["model"] === "string" ? responseBody["model"] : "",
186
+ choices: (Array.isArray(responseBody["choices"])
187
+ ? responseBody["choices"]
188
+ : []).map((c) => {
189
+ const msg = c["message"];
190
+ const role = msg !== undefined && typeof msg["role"] === "string"
191
+ ? msg["role"]
192
+ : "assistant";
193
+ const content = msg !== undefined && typeof msg["content"] === "string" ? msg["content"] : "";
194
+ return {
195
+ message: { role, content },
196
+ finish_reason: typeof c["finish_reason"] === "string" ? c["finish_reason"] : "",
197
+ };
198
+ }),
199
+ usage: {
200
+ prompt_tokens: promptTokens,
201
+ completion_tokens: completionTokens,
202
+ total_tokens: totalTokens,
203
+ },
204
+ gatectr,
205
+ };
206
+ }
207
+ /**
208
+ * Streaming chat completion — POST /chat with stream: true
209
+ * Returns an AsyncIterable<StreamChunk> for use with `for await`.
210
+ */
211
+ async *stream(params) {
212
+ const gatectrOpts = this.mergeGatectrOptions(params.gatectr);
213
+ const body = {
214
+ model: params.model,
215
+ messages: params.messages,
216
+ stream: true,
217
+ ...gatectrOpts,
218
+ };
219
+ if (params.max_tokens !== undefined)
220
+ body["max_tokens"] = params.max_tokens;
221
+ if (params.temperature !== undefined)
222
+ body["temperature"] = params.temperature;
223
+ const raw = await (0, http_js_1.httpRequest)(this.buildRequestOptions({
224
+ method: "POST",
225
+ url: `${this._baseUrl}/chat`,
226
+ headers: {
227
+ ...this.buildHeaders(),
228
+ "Content-Type": "application/json",
229
+ },
230
+ body,
231
+ timeoutMs: this._timeout,
232
+ maxRetries: this._maxRetries,
233
+ }, params.signal));
234
+ if (raw.body === null) {
235
+ return;
236
+ }
237
+ yield* (0, stream_js_1.parseSSE)(raw.body, params.signal);
238
+ }
239
+ /**
240
+ * List available models — GET /models
241
+ */
242
+ async models() {
243
+ const raw = await (0, http_js_1.httpRequest)({
244
+ method: "GET",
245
+ url: `${this._baseUrl}/models`,
246
+ headers: this.buildHeaders(),
247
+ timeoutMs: this._timeout,
248
+ maxRetries: this._maxRetries,
249
+ });
250
+ const responseBody = (await raw.json());
251
+ const requestId = raw.headers.get("x-gatectr-request-id") ?? "";
252
+ const modelsRaw = responseBody["models"] ?? [];
253
+ return {
254
+ models: modelsRaw.map((m) => ({
255
+ modelId: typeof m["modelId"] === "string"
256
+ ? m["modelId"]
257
+ : typeof m["model_id"] === "string"
258
+ ? m["model_id"]
259
+ : "",
260
+ displayName: typeof m["displayName"] === "string"
261
+ ? m["displayName"]
262
+ : typeof m["display_name"] === "string"
263
+ ? m["display_name"]
264
+ : "",
265
+ provider: typeof m["provider"] === "string" ? m["provider"] : "",
266
+ contextWindow: Number(m["contextWindow"] ?? m["context_window"] ?? 0),
267
+ capabilities: Array.isArray(m["capabilities"])
268
+ ? m["capabilities"].map(String)
269
+ : [],
270
+ })),
271
+ requestId,
272
+ };
273
+ }
274
+ /**
275
+ * Fetch usage statistics — GET /usage
276
+ */
277
+ async usage(params) {
278
+ const url = new URL(`${this._baseUrl}/usage`);
279
+ if (params?.from !== undefined)
280
+ url.searchParams.set("from", params.from);
281
+ if (params?.to !== undefined)
282
+ url.searchParams.set("to", params.to);
283
+ if (params?.projectId !== undefined)
284
+ url.searchParams.set("projectId", params.projectId);
285
+ const raw = await (0, http_js_1.httpRequest)({
286
+ method: "GET",
287
+ url: url.toString(),
288
+ headers: this.buildHeaders(),
289
+ timeoutMs: this._timeout,
290
+ maxRetries: this._maxRetries,
291
+ });
292
+ const responseBody = (await raw.json());
293
+ const byProject = (responseBody["byProject"] ?? []).map((p) => ({
294
+ projectId: typeof p["projectId"] === "string" ? p["projectId"] : null,
295
+ totalTokens: Number(p["totalTokens"] ?? 0),
296
+ totalRequests: Number(p["totalRequests"] ?? 0),
297
+ totalCostUsd: Number(p["totalCostUsd"] ?? 0),
298
+ }));
299
+ return {
300
+ totalTokens: Number(responseBody["totalTokens"] ?? 0),
301
+ totalRequests: Number(responseBody["totalRequests"] ?? 0),
302
+ totalCostUsd: Number(responseBody["totalCostUsd"] ?? 0),
303
+ savedTokens: Number(responseBody["savedTokens"] ?? 0),
304
+ from: typeof responseBody["from"] === "string" ? responseBody["from"] : "",
305
+ to: typeof responseBody["to"] === "string" ? responseBody["to"] : "",
306
+ byProject,
307
+ ...(responseBody["budgetStatus"] !== undefined
308
+ ? {
309
+ budgetStatus: responseBody["budgetStatus"],
310
+ }
311
+ : {}),
312
+ };
313
+ }
314
+ }
315
+ exports.GateCtr = GateCtr;
316
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ /** Base error class for all GateCtr SDK errors */
2
+ export declare class GateCtrError extends Error {
3
+ constructor(message: string);
4
+ }
5
+ /** Thrown for invalid or missing configuration (e.g., no API key) */
6
+ export declare class GateCtrConfigError extends GateCtrError {
7
+ constructor(message: string);
8
+ }
9
+ /** Thrown when the Platform returns a non-2xx HTTP response */
10
+ export declare class GateCtrApiError extends GateCtrError {
11
+ readonly status: number;
12
+ readonly code: string;
13
+ readonly requestId: string | undefined;
14
+ constructor(opts: {
15
+ message: string;
16
+ status: number;
17
+ code: string;
18
+ requestId?: string;
19
+ });
20
+ /** Returns a plain object safe for JSON.stringify in logging pipelines. Never includes the API key. */
21
+ toJSON(): {
22
+ name: string;
23
+ message: string;
24
+ status: number;
25
+ code: string;
26
+ requestId: string | undefined;
27
+ };
28
+ }
29
+ /** Thrown when a request exceeds the configured timeout */
30
+ export declare class GateCtrTimeoutError extends GateCtrError {
31
+ readonly timeoutMs: number;
32
+ constructor(timeoutMs: number);
33
+ }
34
+ /** Thrown when a streaming connection fails mid-stream */
35
+ export declare class GateCtrStreamError extends GateCtrError {
36
+ constructor(message: string, cause?: unknown);
37
+ }
38
+ /** Thrown for DNS failures, connection refused, and other transport-level errors */
39
+ export declare class GateCtrNetworkError extends GateCtrError {
40
+ constructor(message: string, cause?: unknown);
41
+ }
42
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
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"}