@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.
- package/LICENSE +21 -0
- package/README.md +199 -0
- package/dist/cjs/client.d.ts +50 -0
- package/dist/cjs/client.d.ts.map +1 -0
- package/dist/cjs/client.js +316 -0
- package/dist/cjs/client.js.map +1 -0
- package/dist/cjs/errors.d.ts +42 -0
- package/dist/cjs/errors.d.ts.map +1 -0
- package/dist/cjs/errors.js +84 -0
- package/dist/cjs/errors.js.map +1 -0
- package/dist/cjs/http.d.ts +26 -0
- package/dist/cjs/http.d.ts.map +1 -0
- package/dist/cjs/http.js +164 -0
- package/dist/cjs/http.js.map +1 -0
- package/dist/cjs/index.d.ts +4 -0
- package/dist/cjs/index.d.ts.map +1 -0
- package/dist/cjs/index.js +15 -0
- package/dist/cjs/index.js.map +1 -0
- package/dist/cjs/package.json +3 -0
- package/dist/cjs/stream.d.ts +8 -0
- package/dist/cjs/stream.d.ts.map +1 -0
- package/dist/cjs/stream.js +100 -0
- package/dist/cjs/stream.js.map +1 -0
- package/dist/cjs/types.d.ts +155 -0
- package/dist/cjs/types.d.ts.map +1 -0
- package/dist/cjs/types.js +3 -0
- package/dist/cjs/types.js.map +1 -0
- package/dist/esm/client.d.ts +50 -0
- package/dist/esm/client.d.ts.map +1 -0
- package/dist/esm/client.js +312 -0
- package/dist/esm/client.js.map +1 -0
- package/dist/esm/errors.d.ts +42 -0
- package/dist/esm/errors.d.ts.map +1 -0
- package/dist/esm/errors.js +75 -0
- package/dist/esm/errors.js.map +1 -0
- package/dist/esm/http.d.ts +26 -0
- package/dist/esm/http.d.ts.map +1 -0
- package/dist/esm/http.js +160 -0
- package/dist/esm/http.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +5 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/stream.d.ts +8 -0
- package/dist/esm/stream.d.ts.map +1 -0
- package/dist/esm/stream.js +97 -0
- package/dist/esm/stream.js.map +1 -0
- package/dist/esm/types.d.ts +155 -0
- package/dist/esm/types.d.ts.map +1 -0
- package/dist/esm/types.js +2 -0
- package/dist/esm/types.js.map +1 -0
- 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
|
+
[](https://www.npmjs.com/package/@gatectr/sdk)
|
|
10
|
+
[](https://github.com/GateCtr/sdk-node/actions/workflows/ci.yml)
|
|
11
|
+
[](LICENSE)
|
|
12
|
+
[](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":";;;AAAA,yBAAyB;AACzB,2CAAiD;AACjD,uCAAwC;AACxC,2CAAuC;AAiBvC,6EAA6E;AAC7E,MAAM,WAAW,GAAG,OAAO,CAAC;AAE5B,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AACtD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B;;;;;;;;GAQG;AACH,MAAa,OAAO;IAClB,iFAAiF;IAChE,QAAQ,CAAS;IACjB,OAAO,CAAS;IAChB,QAAQ,CAAS;IACjB,WAAW,CAAS;IACpB,SAAS,CAAU;IACnB,MAAM,CAAU;IAEjC,YAAY,SAAwB,EAAE;QACpC,wDAAwD;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAE/D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,8BAAkB,CAC1B,yGAAyG,CAC1G,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAE7B,iCAAiC;QACjC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;YACnC,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAChE,MAAM,IAAI,8BAAkB,CAC1B,qBAAqB,UAAU,kCAAkC,CAClE,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,8BAAkB;gBAAE,MAAM,GAAG,CAAC;YACjD,MAAM,IAAI,8BAAkB,CAC1B,qBAAqB,UAAU,uCAAuC,CACvE,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAE/C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,IAAI,kBAAkB,CAAC;QACrD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;IACtC,CAAC;IAED,+EAA+E;IAE/E,mDAAmD;IAC3C,YAAY,CAAC,KAA8B;QACjD,OAAO;YACL,aAAa,EAAE,UAAU,IAAI,CAAC,OAAO,EAAE;YACvC,YAAY,EAAE,gBAAgB,WAAW,SAAS,OAAO,CAAC,OAAO,EAAE;YACnE,GAAG,KAAK;SACT,CAAC;IACJ,CAAC;IAED,2DAA2D;IACnD,eAAe,CAAC,OAAgB,EAAE,IAA6B;QACrE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,MAAM,CAAC;QAE5D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAwC,CAAC;QACnE,MAAM,WAAW,GAAG,OAAO,KAAK,EAAE,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5F,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IACnE,CAAC;IAED,8DAA8D;IACtD,mBAAmB,CAAC,UAAyC;QACnE,MAAM,MAAM,GAA4B;YACtC,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC;QAEF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS;gBAAE,MAAM,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC;YAChF,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;YACvE,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS;gBAAE,MAAM,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC;QAClF,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iGAAiG;IACzF,mBAAmB,CACzB,IAAoC,EACpC,MAA+B;QAE/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAE/E;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE7D,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,KAAK;YACb,GAAG,WAAW;SACf,CAAC;QACF,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QAC5E,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;QAE/E,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAW,EAC3B,IAAI,CAAC,mBAAmB,CACtB;YACE,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,WAAW;YAChC,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,YAAY,EAAE;gBACtB,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B,EACD,MAAM,CAAC,MAAM,CACd,CACF,CAAC;QAEF,MAAM,YAAY,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAEhE,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAwC,CAAC;QAC/E,MAAM,YAAY,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,MAAM,gBAAgB,GACpB,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,WAAW,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzF,OAAO;YACL,EAAE,EAAE,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YACpE,MAAM,EAAE,iBAAiB;YACzB,KAAK,EAAE,OAAO,YAAY,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;YAC7E,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;gBAC9C,CAAC,CAAE,YAAY,CAAC,SAAS,CAAoC;gBAC7D,CAAC,CAAC,EAAE,CACL,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACZ,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;gBACpD,aAAa,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE;aAChF,CAAC,CAAC;YACH,KAAK,EAAE;gBACL,aAAa,EAAE,YAAY;gBAC3B,iBAAiB,EAAE,gBAAgB;gBACnC,YAAY,EAAE,WAAW;aAC1B;YACD,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAkB;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE7D,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,KAAK;YACb,GAAG,WAAW;SACf,CAAC;QACF,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QAC5E,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;QAE/E,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAW,EAC3B,IAAI,CAAC,mBAAmB,CACtB;YACE,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,OAAO;YAC5B,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,YAAY,EAAE;gBACtB,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B,EACD,MAAM,CAAC,MAAM,CACd,CACF,CAAC;QAEF,MAAM,YAAY,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAEhE,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAwC,CAAC;QAC/E,MAAM,YAAY,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,MAAM,gBAAgB,GACpB,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,WAAW,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzF,OAAO;YACL,EAAE,EAAE,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YACpE,MAAM,EAAE,iBAAiB;YACzB,KAAK,EAAE,OAAO,YAAY,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;YAC7E,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;gBAC9C,CAAC,CAAE,YAAY,CAAC,SAAS,CAAoC;gBAC7D,CAAC,CAAC,EAAE,CACL,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACV,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAwC,CAAC;gBAChE,MAAM,IAAI,GACR,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ;oBAClD,CAAC,CAAE,GAAG,CAAC,MAAM,CAAqC;oBAClD,CAAC,CAAE,WAAqB,CAAC;gBAC7B,MAAM,OAAO,GACX,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChF,OAAO;oBACL,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;oBAC1B,aAAa,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE;iBAChF,CAAC;YACJ,CAAC,CAAC;YACF,KAAK,EAAE;gBACL,aAAa,EAAE,YAAY;gBAC3B,iBAAiB,EAAE,gBAAgB;gBACnC,YAAY,EAAE,WAAW;aAC1B;YACD,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,CAAC,MAAM,CAAC,MAAoB;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE7D,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,MAAM,EAAE,IAAI;YACZ,GAAG,WAAW;SACf,CAAC;QACF,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QAC5E,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;QAE/E,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAW,EAC3B,IAAI,CAAC,mBAAmB,CACtB;YACE,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,OAAO;YAC5B,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,YAAY,EAAE;gBACtB,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B,EACD,MAAM,CAAC,MAAM,CACd,CACF,CAAC;QAEF,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,KAAK,CAAC,CAAC,IAAA,oBAAQ,EAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAW,EAAC;YAC5B,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,SAAS;YAC9B,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE;YAC5B,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;QACnE,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC;QAEhE,MAAM,SAAS,GAAI,YAAY,CAAC,QAAQ,CAAgD,IAAI,EAAE,CAAC;QAE/F,OAAO;YACL,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5B,OAAO,EACL,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,QAAQ;oBAC9B,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBACd,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,QAAQ;wBACjC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;wBACf,CAAC,CAAC,EAAE;gBACV,WAAW,EACT,OAAO,CAAC,CAAC,aAAa,CAAC,KAAK,QAAQ;oBAClC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;oBAClB,CAAC,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,QAAQ;wBACrC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;wBACnB,CAAC,CAAC,EAAE;gBACV,QAAQ,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE;gBAChE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACrE,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;oBAC5C,CAAC,CAAE,CAAC,CAAC,cAAc,CAAe,CAAC,GAAG,CAAC,MAAM,CAAC;oBAC9C,CAAC,CAAC,EAAE;aACP,CAAC,CAAC;YACH,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC9B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,QAAQ,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,IAAI,KAAK,SAAS;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1E,IAAI,MAAM,EAAE,EAAE,KAAK,SAAS;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,MAAM,EAAE,SAAS,KAAK,SAAS;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAEzF,MAAM,GAAG,GAAG,MAAM,IAAA,qBAAW,EAAC;YAC5B,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;YACnB,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE;YAC5B,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;QAEnE,MAAM,SAAS,GAAG,CACf,YAAY,CAAC,WAAW,CAAgD,IAAI,EAAE,CAChF,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACZ,SAAS,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;YACrE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1C,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC9C,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;SAC7C,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACrD,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACzD,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YACvD,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,EAAE,OAAO,YAAY,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;YAC1E,EAAE,EAAE,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YACpE,SAAS;YACT,GAAG,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,SAAS;gBAC5C,CAAC,CAAC;oBACE,YAAY,EAAE,YAAY,CAAC,cAAc,CAA4B;iBACtE;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;CACF;AAlWD,0BAkWC"}
|
|
@@ -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"}
|