@sierragridteam/sdk 0.0.0-stage → 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 (42) hide show
  1. package/README.md +49 -2
  2. package/dist/fixtures-data.d.ts +609 -0
  3. package/dist/fixtures-data.js +2676 -0
  4. package/dist/fixtures.d.ts +12 -0
  5. package/dist/fixtures.js +139 -0
  6. package/dist/generated/client/client.gen.d.ts +2 -0
  7. package/dist/generated/client/client.gen.js +216 -0
  8. package/dist/generated/client/index.d.ts +10 -0
  9. package/dist/generated/client/index.js +6 -0
  10. package/dist/generated/client/types.gen.d.ts +120 -0
  11. package/dist/generated/client/types.gen.js +2 -0
  12. package/dist/generated/client/utils.gen.d.ts +37 -0
  13. package/dist/generated/client/utils.gen.js +228 -0
  14. package/dist/generated/client.gen.d.ts +12 -0
  15. package/dist/generated/client.gen.js +3 -0
  16. package/dist/generated/core/auth.gen.d.ts +25 -0
  17. package/dist/generated/core/auth.gen.js +14 -0
  18. package/dist/generated/core/bodySerializer.gen.d.ts +25 -0
  19. package/dist/generated/core/bodySerializer.gen.js +57 -0
  20. package/dist/generated/core/params.gen.d.ts +43 -0
  21. package/dist/generated/core/params.gen.js +109 -0
  22. package/dist/generated/core/pathSerializer.gen.d.ts +33 -0
  23. package/dist/generated/core/pathSerializer.gen.js +106 -0
  24. package/dist/generated/core/queryKeySerializer.gen.d.ts +18 -0
  25. package/dist/generated/core/queryKeySerializer.gen.js +92 -0
  26. package/dist/generated/core/serverSentEvents.gen.d.ts +71 -0
  27. package/dist/generated/core/serverSentEvents.gen.js +132 -0
  28. package/dist/generated/core/types.gen.d.ts +83 -0
  29. package/dist/generated/core/types.gen.js +2 -0
  30. package/dist/generated/core/utils.gen.d.ts +19 -0
  31. package/dist/generated/core/utils.gen.js +87 -0
  32. package/dist/generated/index.d.ts +2 -0
  33. package/dist/generated/index.js +2 -0
  34. package/dist/generated/sdk.gen.d.ts +210 -0
  35. package/dist/generated/sdk.gen.js +336 -0
  36. package/dist/generated/types.gen.d.ts +3474 -0
  37. package/dist/generated/types.gen.js +2 -0
  38. package/dist/generated/zod.gen.d.ts +6537 -0
  39. package/dist/generated/zod.gen.js +1849 -0
  40. package/dist/index.d.ts +1287 -0
  41. package/dist/index.js +99 -0
  42. package/package.json +42 -4
@@ -0,0 +1,12 @@
1
+ export declare const FIXTURE_NOW: string;
2
+ export declare const FIXTURE_LABEL = "Synthetic demonstration data \u2014 not current conditions";
3
+ export type FixtureScenario = 'normal' | 'empty' | 'stale' | 'partial' | 'unavailable';
4
+ export declare const fixtureNodes: {
5
+ id: string;
6
+ name: string;
7
+ publicKey: string;
8
+ }[];
9
+ /** Deterministic GET-only fixture transport. It never performs network requests. */
10
+ export declare function createFixtureFetch({ scenario }?: {
11
+ scenario?: FixtureScenario;
12
+ }): typeof fetch;
@@ -0,0 +1,139 @@
1
+ import { fixtureData } from './fixtures-data.js';
2
+ import * as s from './generated/zod.gen.js';
3
+ export const FIXTURE_NOW = fixtureData.now;
4
+ export const FIXTURE_LABEL = 'Synthetic demonstration data — not current conditions';
5
+ const events = fixtureData.events.map(x => s.zV1Event.parse(x));
6
+ const places = fixtureData.places.map(x => s.zV1Place.parse(x));
7
+ const telemetry = Object.fromEntries(Object.entries(fixtureData.telemetry).map(([key, x]) => [key, s.zV1MeshTelemetryArchive.parse(x)]));
8
+ const links = fixtureData.links.map(x => s.zMeshLink.parse(x));
9
+ export const fixtureNodes = events.filter(x => x.mesh).map(x => ({ id: x.id, name: x.headline, publicKey: x.mesh.publicKey }));
10
+ const STALE_LAST_SUCCESS = '2026-11-05T12:00:00Z';
11
+ const ranks = ['INFO', 'MINOR', 'MODERATE', 'SEVERE', 'EXTREME'];
12
+ /** Deterministic GET-only fixture transport. It never performs network requests. */
13
+ export function createFixtureFetch({ scenario = 'normal' } = {}) {
14
+ return async (input, init) => {
15
+ const req = new Request(input, init);
16
+ req.signal.throwIfAborted();
17
+ const url = new URL(req.url);
18
+ const q = url.searchParams;
19
+ const reply = (body, status = 200) => new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json', 'X-Sierra-Fixture': scenario } });
20
+ const unavailable = (plain = false) => new Response(plain ? 'Synthetic deployment handoff' : JSON.stringify({ code: 14, codeName: 'UNAVAILABLE', message: 'Synthetic data service unavailable', details: [] }), { status: 503, headers: { 'Content-Type': plain ? 'text/plain' : 'application/json', 'Retry-After': '1', 'X-Sierra-Fixture': scenario } });
21
+ const lastSuccessAt = scenario === 'unavailable' ? null : scenario === 'stale' ? STALE_LAST_SUCCESS : FIXTURE_NOW;
22
+ const error = (message, status = 400) => reply({ code: status === 404 ? 5 : 3, codeName: status === 404 ? 'NOT_FOUND' : 'INVALID_ARGUMENT', message, details: [] }, status);
23
+ if (req.method !== 'GET')
24
+ return error('Fixtures support public GET only', 405);
25
+ const path = decodeURIComponent(url.pathname);
26
+ const place = q.get('place');
27
+ if (scenario === 'unavailable' && (path === '/api/v1/events' || path.startsWith('/api/v1/events/') || path === '/api/v1/history' || path === '/api/v1/mesh/telemetry' || path === '/api/v1/mesh/links'))
28
+ return unavailable(path === '/api/v1/mesh/links');
29
+ const allowed = new Set(['place', 'layer', 'status', 'severityMin', 'since', 'pageSize', 'pageToken', 'geometryFormat', 'from', 'to', 'node', 'window', 'kind', 'q']);
30
+ for (const key of q.keys())
31
+ if (!allowed.has(key))
32
+ return error(`Unsupported fixture parameter: ${key}`);
33
+ if (q.has('geometryFormat') && q.get('geometryFormat') !== 'OBJECT')
34
+ return error('Fixtures support OBJECT geometry only');
35
+ const foundPlace = (key) => places.find(x => x.slug === key || x.id === key);
36
+ if (place && !foundPlace(place))
37
+ return error('Unknown fixture place', 404);
38
+ const filters = (items) => {
39
+ let result = scenario === 'empty' ? [] : items;
40
+ for (const key of ['layer', 'status']) {
41
+ const values = q.getAll(key).flatMap(x => x.split(',')).map(x => x.toUpperCase());
42
+ if (values.length)
43
+ result = result.filter(x => values.includes(x[key]));
44
+ }
45
+ if (place)
46
+ result = result.filter(x => x.placeIds.includes(foundPlace(place).id));
47
+ if (q.has('severityMin'))
48
+ result = result.filter(x => ranks.indexOf(x.severity) >= ranks.indexOf(q.get('severityMin').toUpperCase()));
49
+ if (q.has('since'))
50
+ result = result.filter(x => Date.parse(x.observedAt ?? '') >= Date.parse(q.get('since')));
51
+ return result.sort((a, b) => ranks.indexOf(b.severity) - ranks.indexOf(a.severity) || Date.parse(b.observedAt ?? '') - Date.parse(a.observedAt ?? '') || a.id.localeCompare(b.id));
52
+ };
53
+ const page = (items, field) => {
54
+ const size = Math.min(200, Number(q.get('pageSize') || 50)) || 50;
55
+ const offset = Number(q.get('pageToken') || 0);
56
+ if (size < 0 || !Number.isInteger(size) || !Number.isInteger(offset) || offset < 0)
57
+ return error('Invalid fixture pagination');
58
+ const count = scenario === 'partial' ? Math.min(size, 2) : size;
59
+ return reply({ [field]: items.slice(offset, offset + count), nextPageToken: offset + count < items.length ? String(offset + count) : '' });
60
+ };
61
+ if (path === '/api/v1/events')
62
+ return page(filters(events), 'events');
63
+ if (path === '/api/v1/history' || path.endsWith('/history')) {
64
+ const from = q.get('from'), to = q.get('to');
65
+ if (path === '/api/v1/history' && (!from || !to || !(Date.parse(from) < Date.parse(to))))
66
+ return error('Fixture history requires explicit from < to');
67
+ const id = path === '/api/v1/history' ? null : path.slice('/api/v1/events/'.length, -'/history'.length);
68
+ const selected = id ? events.filter(x => x.id === id) : filters(events);
69
+ if (id && !selected.length)
70
+ return error('Unknown event', 404);
71
+ const revisions = selected.flatMap(event => [0, 1].map(i => { const at = i ? '2026-11-07T10:00:00Z' : '2026-11-07T08:00:00Z'; return { revision: i + 1, observedAt: at, ingestedAt: at, event: { ...event, revision: i + 1, observedAt: at, status: i ? 'ACTIVE' : 'SCHEDULED' } }; })).filter(x => (!from || Date.parse(x.observedAt) >= Date.parse(from)) && (!to || Date.parse(x.observedAt) < Date.parse(to))).sort((a, b) => b.observedAt.localeCompare(a.observedAt) || a.event.id.localeCompare(b.event.id));
72
+ return page(revisions, 'revisions');
73
+ }
74
+ if (path.startsWith('/api/v1/events/')) {
75
+ const event = events.find(x => x.id === path.slice('/api/v1/events/'.length));
76
+ return event ? reply(event) : error('Unknown event', 404);
77
+ }
78
+ if (path === '/api/v1/places')
79
+ return reply({ places: places.filter(x => (!q.get('kind') || x.kind === q.get('kind')) && (!q.get('q') || x.name.toLowerCase().includes(q.get('q').toLowerCase()))) });
80
+ if (path === '/api/v1/sources')
81
+ return reply({ sources: fixtureData.sources.map(x => ({ ...x, lastSuccessAt, lastAttemptAt: FIXTURE_NOW, lastError: scenario === 'stale' ? 'Synthetic upstream timeout' : scenario === 'unavailable' ? 'Synthetic upstream unavailable' : '', status: scenario === 'stale' ? 'STALE' : scenario === 'unavailable' ? 'UNAVAILABLE' : 'OK' })) });
82
+ if (path === '/api/v1/mesh/links') {
83
+ const window = q.get('window') ?? '72h';
84
+ const match = /^(\d+(?:\.\d+)?)(h|m|s)$/.exec(window);
85
+ if (!match || Number(match[1]) <= 0)
86
+ return error('Fixture supports positive h/m/s windows');
87
+ const age = Number(match[1]) * ({ h: 3600000, m: 60000, s: 1000 }[match[2]]);
88
+ return reply({ window, generatedAt: FIXTURE_NOW, links: scenario === 'empty' ? [] : links.filter(x => Date.parse(x.lastSeen) >= Date.parse(FIXTURE_NOW) - age) });
89
+ }
90
+ if (path === '/api/v1/mesh/telemetry') {
91
+ const key = (q.get('node') ?? '').toLowerCase().replace(/^meshcore:/, '');
92
+ if (!/^([a-f0-9]{2}){4,32}$/.test(key))
93
+ return error('Invalid mesh key');
94
+ if (scenario === 'partial' && key === fixtureNodes[2].publicKey)
95
+ return unavailable();
96
+ const to = q.get('to') ?? FIXTURE_NOW;
97
+ const from = q.get('from') ?? new Date(Date.parse(to) - 86400000).toISOString();
98
+ if (!(Date.parse(from) < Date.parse(to)))
99
+ return error('Invalid telemetry window');
100
+ const archive = telemetry[key];
101
+ if (!archive || scenario === 'empty')
102
+ return reply({ node: key, from, to, coverage: { from: null, to: null, samples: 0 }, cadenceSeconds: null, reboots: [], samples: [], truncated: false });
103
+ const samples = archive.samples.filter(x => Date.parse(x.reading.reportedAt) >= Date.parse(from) && Date.parse(x.reading.reportedAt) < Date.parse(to));
104
+ return reply({ ...archive, from, to, samples, reboots: archive.reboots.filter(x => Date.parse(x) >= Date.parse(from) && Date.parse(x) < Date.parse(to)), truncated: archive.truncated || scenario === 'partial' });
105
+ }
106
+ if (path === '/api/v1/conditions')
107
+ return reply(fixtureData.conditions);
108
+ if (path === '/api/v1/cameras')
109
+ return reply(fixtureData.cameras);
110
+ if (path === '/api/v1/scanners')
111
+ return reply(fixtureData.scanners);
112
+ const match = /^\/api\/v1\/places\/([^/]+)(?:\/(.*))?$/.exec(path);
113
+ if (match) {
114
+ const selected = foundPlace(match[1]);
115
+ if (!selected)
116
+ return error('Unknown place', 404);
117
+ if (!match[2])
118
+ return reply(selected);
119
+ if (match[2] === 'summary') {
120
+ const status = scenario === 'unavailable' ? 'UNAVAILABLE' : scenario === 'stale' ? 'STALE' : 'OK';
121
+ return reply({ ...fixtureData.summary, place: selected.slug, placeId: selected.id, placeName: selected.name, mode: scenario === 'empty' ? 'QUIET' : 'WATCH', generatedAt: FIXTURE_NOW,
122
+ summary: { ...fixtureData.summary.summary, activeEvacuations: scenario === 'unavailable' ? null : 0, evacuationStatus: status, evacuationSourceUrl: 'https://protect.genasys.com/', totalActive: scenario === 'empty' ? 0 : 1, highestSeverity: scenario === 'empty' ? 'INFO' : 'MODERATE', highestSeverityRank: scenario === 'empty' ? 0 : 2 },
123
+ domains: ['fire', 'evacuation', 'weather', 'roads', 'seismic', 'power', 'burn', 'comms'].map(domain => ({ domain, status, activeCount: scenario === 'empty' ? 0 : domain === 'comms' ? 5 : domain === 'roads' ? 1 : 0, highestSeverity: domain === 'roads' && scenario !== 'empty' ? 'MODERATE' : 'INFO', headlines: [] })),
124
+ sources: [{ id: 'meshcore', status, lastSuccessAt }] });
125
+ }
126
+ if (match[2].startsWith('map/')) {
127
+ const layer = match[2].slice(4).replace(/\.geojson$/, '');
128
+ if (!['mesh_node', 'mesh_link', 'road_incident'].includes(layer))
129
+ return error(`Unsupported fixture map layer: ${layer}`, 404);
130
+ const nodeFeature = (event) => ({ type: 'Feature', geometry: event.geometry?.object ?? null, properties: { id: event.id, layer: event.layer === 'MESH' ? 'MESH_NODE' : event.layer, kind: event.mesh ? 'Mesh node' : 'Road incident', severity: event.severity, severityRank: ranks.indexOf(event.severity), headline: event.headline, source: { id: event.provenance.sourceId, name: event.provenance.sourceName, attribution: event.provenance.attribution }, ...(event.mesh ? { mesh: { publicKey: event.mesh.publicKey, name: event.headline, nodeType: event.mesh.nodeType, inRegion: event.placeIds.includes(selected.id) } } : {}) } });
131
+ let features = layer === 'mesh_link' ? [...events.filter(x => x.mesh).map(nodeFeature), ...links.map(link => ({ type: 'Feature', geometry: { type: 'LineString', coordinates: [events.find(x => x.mesh?.publicKey === link.a).geometry.object.coordinates, events.find(x => x.mesh?.publicKey === link.b).geometry.object.coordinates] }, properties: { id: `mesh_link:${link.a}:${link.b}`, layer: 'MESH_LINK', kind: 'Relay link', severity: 'INFO', severityRank: 0, headline: 'Observed demo link', source: { id: 'meshcore', name: 'Synthetic MeshCore fixture', attribution: FIXTURE_LABEL }, meshLink: link } }))] : events.filter(x => x.placeIds.includes(selected.id) && (layer === 'mesh_node' ? x.layer === 'MESH' : x.layer.toLowerCase() === layer)).map(nodeFeature);
132
+ if (scenario === 'empty' || scenario === 'unavailable')
133
+ features = [];
134
+ return reply({ type: 'FeatureCollection', features, metadata: { layer, area: selected.slug, generatedAt: FIXTURE_NOW, ...(lastSuccessAt ? { lastSourceUpdate: lastSuccessAt } : {}), sourceStatus: scenario === 'stale' ? 'STALE' : scenario === 'unavailable' ? 'UNAVAILABLE' : 'OK', attribution: FIXTURE_LABEL, schemaVersion: 1 } });
135
+ }
136
+ }
137
+ return error('Endpoint not implemented by synthetic fixtures', 404);
138
+ };
139
+ }
@@ -0,0 +1,2 @@
1
+ import type { Client, Config } from './types.gen.js';
2
+ export declare const createClient: (config?: Config) => Client;
@@ -0,0 +1,216 @@
1
+ // This file is auto-generated by @hey-api/openapi-ts
2
+ import { createSseClient } from '../core/serverSentEvents.gen.js';
3
+ import { getValidRequestBody } from '../core/utils.gen.js';
4
+ import { buildUrl, createConfig, createInterceptors, getParseAs, mergeConfigs, mergeHeaders, setAuthParams, } from './utils.gen.js';
5
+ export const createClient = (config = {}) => {
6
+ let _config = mergeConfigs(createConfig(), config);
7
+ const getConfig = () => ({ ..._config });
8
+ const setConfig = (config) => {
9
+ _config = mergeConfigs(_config, config);
10
+ return getConfig();
11
+ };
12
+ const interceptors = createInterceptors();
13
+ const beforeRequest = async (options) => {
14
+ const opts = {
15
+ ..._config,
16
+ ...options,
17
+ fetch: options.fetch ?? _config.fetch ?? globalThis.fetch,
18
+ headers: mergeHeaders(_config.headers, options.headers),
19
+ serializedBody: undefined,
20
+ };
21
+ if (opts.security) {
22
+ await setAuthParams(opts);
23
+ }
24
+ if (opts.requestValidator) {
25
+ await opts.requestValidator(opts);
26
+ }
27
+ if (opts.body !== undefined && opts.bodySerializer) {
28
+ opts.serializedBody = opts.bodySerializer(opts.body);
29
+ }
30
+ // remove Content-Type header if body is empty to avoid sending invalid requests
31
+ if (opts.body === undefined || opts.serializedBody === '') {
32
+ opts.headers.delete('Content-Type');
33
+ }
34
+ const resolvedOpts = opts;
35
+ const url = buildUrl(resolvedOpts);
36
+ return { opts: resolvedOpts, url };
37
+ };
38
+ const request = async (options) => {
39
+ const throwOnError = options.throwOnError ?? _config.throwOnError;
40
+ const responseStyle = options.responseStyle ?? _config.responseStyle;
41
+ let request;
42
+ let response;
43
+ try {
44
+ const { opts, url } = await beforeRequest(options);
45
+ const requestInit = {
46
+ redirect: 'follow',
47
+ ...opts,
48
+ body: getValidRequestBody(opts),
49
+ };
50
+ request = new Request(url, requestInit);
51
+ for (const fn of interceptors.request.fns) {
52
+ if (fn) {
53
+ request = await fn(request, opts);
54
+ }
55
+ }
56
+ // fetch must be assigned here, otherwise it would throw the error:
57
+ // TypeError: Failed to execute 'fetch' on 'Window': Illegal invocation
58
+ const _fetch = opts.fetch;
59
+ response = await _fetch(request);
60
+ for (const fn of interceptors.response.fns) {
61
+ if (fn) {
62
+ response = await fn(response, request, opts);
63
+ }
64
+ }
65
+ const result = {
66
+ request,
67
+ response,
68
+ };
69
+ if (response.ok) {
70
+ const parseAs = (opts.parseAs === 'auto'
71
+ ? getParseAs(response.headers.get('Content-Type'))
72
+ : opts.parseAs) ?? 'json';
73
+ if (response.status === 204 || response.headers.get('Content-Length') === '0') {
74
+ let emptyData;
75
+ switch (parseAs) {
76
+ case 'arrayBuffer':
77
+ case 'blob':
78
+ case 'text':
79
+ emptyData = await response[parseAs]();
80
+ break;
81
+ case 'formData':
82
+ emptyData = new FormData();
83
+ break;
84
+ case 'stream':
85
+ emptyData = response.body;
86
+ break;
87
+ case 'json':
88
+ default:
89
+ emptyData = {};
90
+ break;
91
+ }
92
+ return opts.responseStyle === 'data'
93
+ ? emptyData
94
+ : {
95
+ data: emptyData,
96
+ ...result,
97
+ };
98
+ }
99
+ let data;
100
+ switch (parseAs) {
101
+ case 'arrayBuffer':
102
+ case 'blob':
103
+ case 'formData':
104
+ case 'text':
105
+ data = await response[parseAs]();
106
+ break;
107
+ case 'json': {
108
+ // Some servers return 200 with no Content-Length and empty body.
109
+ // response.json() would throw; read as text and parse if non-empty.
110
+ const text = await response.text();
111
+ data = text ? JSON.parse(text) : {};
112
+ break;
113
+ }
114
+ case 'stream':
115
+ return opts.responseStyle === 'data'
116
+ ? response.body
117
+ : {
118
+ data: response.body,
119
+ ...result,
120
+ };
121
+ }
122
+ if (parseAs === 'json') {
123
+ if (opts.responseValidator) {
124
+ await opts.responseValidator(data);
125
+ }
126
+ if (opts.responseTransformer) {
127
+ data = await opts.responseTransformer(data);
128
+ }
129
+ }
130
+ return opts.responseStyle === 'data'
131
+ ? data
132
+ : {
133
+ data,
134
+ ...result,
135
+ };
136
+ }
137
+ const textError = await response.text();
138
+ let jsonError;
139
+ try {
140
+ jsonError = JSON.parse(textError);
141
+ }
142
+ catch {
143
+ // noop
144
+ }
145
+ throw jsonError ?? textError;
146
+ }
147
+ catch (error) {
148
+ let finalError = error;
149
+ for (const fn of interceptors.error.fns) {
150
+ if (fn) {
151
+ finalError = await fn(finalError, response, request, options);
152
+ }
153
+ }
154
+ finalError = finalError || {};
155
+ if (throwOnError) {
156
+ throw finalError;
157
+ }
158
+ // TODO: we probably want to return error and improve types
159
+ return responseStyle === 'data'
160
+ ? undefined
161
+ : {
162
+ error: finalError,
163
+ request,
164
+ response,
165
+ };
166
+ }
167
+ };
168
+ const makeMethodFn = (method) => (options) => request({ ...options, method });
169
+ const makeSseFn = (method) => async (options) => {
170
+ const { opts, url } = await beforeRequest(options);
171
+ return createSseClient({
172
+ ...opts,
173
+ body: opts.body,
174
+ method,
175
+ onRequest: async (url, init) => {
176
+ let request = new Request(url, init);
177
+ for (const fn of interceptors.request.fns) {
178
+ if (fn) {
179
+ request = await fn(request, opts);
180
+ }
181
+ }
182
+ return request;
183
+ },
184
+ serializedBody: getValidRequestBody(opts),
185
+ url,
186
+ });
187
+ };
188
+ const _buildUrl = (options) => buildUrl({ ..._config, ...options });
189
+ return {
190
+ buildUrl: _buildUrl,
191
+ connect: makeMethodFn('CONNECT'),
192
+ delete: makeMethodFn('DELETE'),
193
+ get: makeMethodFn('GET'),
194
+ getConfig,
195
+ head: makeMethodFn('HEAD'),
196
+ interceptors,
197
+ options: makeMethodFn('OPTIONS'),
198
+ patch: makeMethodFn('PATCH'),
199
+ post: makeMethodFn('POST'),
200
+ put: makeMethodFn('PUT'),
201
+ request,
202
+ setConfig,
203
+ sse: {
204
+ connect: makeSseFn('CONNECT'),
205
+ delete: makeSseFn('DELETE'),
206
+ get: makeSseFn('GET'),
207
+ head: makeSseFn('HEAD'),
208
+ options: makeSseFn('OPTIONS'),
209
+ patch: makeSseFn('PATCH'),
210
+ post: makeSseFn('POST'),
211
+ put: makeSseFn('PUT'),
212
+ trace: makeSseFn('TRACE'),
213
+ },
214
+ trace: makeMethodFn('TRACE'),
215
+ };
216
+ };
@@ -0,0 +1,10 @@
1
+ export type { Auth } from '../core/auth.gen.js';
2
+ export type { QuerySerializerOptions } from '../core/bodySerializer.gen.js';
3
+ export { formDataBodySerializer, jsonBodySerializer, urlSearchParamsBodySerializer, } from '../core/bodySerializer.gen.js';
4
+ export { buildClientParams } from '../core/params.gen.js';
5
+ export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen.js';
6
+ export type { ServerSentEventsResult } from '../core/serverSentEvents.gen.js';
7
+ export type { ClientMeta } from '../core/types.gen.js';
8
+ export { createClient } from './client.gen.js';
9
+ export type { Client, ClientOptions, Config, CreateClientConfig, Options, RequestOptions, RequestResult, ResolvedRequestOptions, ResponseStyle, TDataShape, } from './types.gen.js';
10
+ export { createConfig, mergeHeaders } from './utils.gen.js';
@@ -0,0 +1,6 @@
1
+ // This file is auto-generated by @hey-api/openapi-ts
2
+ export { formDataBodySerializer, jsonBodySerializer, urlSearchParamsBodySerializer, } from '../core/bodySerializer.gen.js';
3
+ export { buildClientParams } from '../core/params.gen.js';
4
+ export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen.js';
5
+ export { createClient } from './client.gen.js';
6
+ export { createConfig, mergeHeaders } from './utils.gen.js';
@@ -0,0 +1,120 @@
1
+ import type { Auth } from '../core/auth.gen.js';
2
+ import type { ServerSentEventsOptions, ServerSentEventsResult } from '../core/serverSentEvents.gen.js';
3
+ import type { Client as CoreClient, Config as CoreConfig } from '../core/types.gen.js';
4
+ import type { Middleware } from './utils.gen.js';
5
+ export type ResponseStyle = 'data' | 'fields';
6
+ export interface Config<T extends ClientOptions = ClientOptions> extends Omit<RequestInit, 'body' | 'headers' | 'method'>, CoreConfig {
7
+ /**
8
+ * Base URL for all requests made by this client.
9
+ */
10
+ baseUrl?: T['baseUrl'];
11
+ /**
12
+ * Fetch API implementation. You can use this option to provide a custom
13
+ * fetch instance.
14
+ *
15
+ * @default globalThis.fetch
16
+ */
17
+ fetch?: typeof fetch;
18
+ /**
19
+ * Please don't use the Fetch client for Next.js applications. The `next`
20
+ * options won't have any effect.
21
+ *
22
+ * Install {@link https://www.npmjs.com/package/@hey-api/client-next `@hey-api/client-next`} instead.
23
+ */
24
+ next?: never;
25
+ /**
26
+ * Return the response data parsed in a specified format. By default, `auto`
27
+ * will infer the appropriate method from the `Content-Type` response header.
28
+ * You can override this behavior with any of the {@link Body} methods.
29
+ * Select `stream` if you don't want to parse response data at all.
30
+ *
31
+ * @default 'auto'
32
+ */
33
+ parseAs?: 'arrayBuffer' | 'auto' | 'blob' | 'formData' | 'json' | 'stream' | 'text';
34
+ /**
35
+ * Should we return only data or multiple fields (data, error, response, etc.)?
36
+ *
37
+ * @default 'fields'
38
+ */
39
+ responseStyle?: ResponseStyle;
40
+ /**
41
+ * Throw an error instead of returning it in the response?
42
+ *
43
+ * @default false
44
+ */
45
+ throwOnError?: T['throwOnError'];
46
+ }
47
+ export interface RequestOptions<TData = unknown, TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends Config<{
48
+ responseStyle: TResponseStyle;
49
+ throwOnError: ThrowOnError;
50
+ }>, Pick<ServerSentEventsOptions<TData>, 'onRequest' | 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
51
+ /**
52
+ * Any body that you want to add to your request.
53
+ *
54
+ * {@link https://developer.mozilla.org/docs/Web/API/fetch#body}
55
+ */
56
+ body?: unknown;
57
+ path?: Record<string, unknown>;
58
+ query?: Record<string, unknown>;
59
+ /**
60
+ * Security mechanism(s) to use for the request.
61
+ */
62
+ security?: ReadonlyArray<Auth>;
63
+ url: Url;
64
+ }
65
+ export interface ResolvedRequestOptions<TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends RequestOptions<unknown, TResponseStyle, ThrowOnError, Url> {
66
+ headers: Headers;
67
+ serializedBody?: string;
68
+ }
69
+ export type RequestResult<TData = unknown, TError = unknown, ThrowOnError extends boolean = boolean, TResponseStyle extends ResponseStyle = 'fields'> = ThrowOnError extends true ? Promise<TResponseStyle extends 'data' ? TData extends Record<string, unknown> ? TData[keyof TData] : TData : {
70
+ data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
71
+ request: Request;
72
+ response: Response;
73
+ }> : Promise<TResponseStyle extends 'data' ? (TData extends Record<string, unknown> ? TData[keyof TData] : TData) | undefined : ({
74
+ data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
75
+ error: undefined;
76
+ } | {
77
+ data: undefined;
78
+ error: TError extends Record<string, unknown> ? TError[keyof TError] : TError;
79
+ }) & {
80
+ /** request may be undefined, because error may be from building the request object itself */
81
+ request?: Request;
82
+ /** response may be undefined, because error may be from building the request object itself or from a network error */
83
+ response?: Response;
84
+ }>;
85
+ export interface ClientOptions {
86
+ baseUrl?: string;
87
+ responseStyle?: ResponseStyle;
88
+ throwOnError?: boolean;
89
+ }
90
+ type MethodFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
91
+ type SseFn = <TData = unknown, _TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<never, TResponseStyle, ThrowOnError>, 'method'>) => Promise<ServerSentEventsResult<TData>>;
92
+ type RequestFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'> & Pick<Required<RequestOptions<TData, TResponseStyle, ThrowOnError>>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
93
+ type BuildUrlFn = <TData extends {
94
+ body?: unknown;
95
+ path?: Record<string, unknown>;
96
+ query?: Record<string, unknown>;
97
+ url: string;
98
+ }>(options: TData & Options<TData>) => string;
99
+ export type Client = CoreClient<RequestFn, Config, MethodFn, BuildUrlFn, SseFn> & {
100
+ interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions>;
101
+ };
102
+ /**
103
+ * The `createClientConfig()` function will be called on client initialization
104
+ * and the returned object will become the client's initial configuration.
105
+ *
106
+ * You may want to initialize your client this way instead of calling
107
+ * `setConfig()`. This is useful for example if you're using Next.js
108
+ * to ensure your client always has the correct values.
109
+ */
110
+ export type CreateClientConfig<T extends ClientOptions = ClientOptions> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;
111
+ export interface TDataShape {
112
+ body?: unknown;
113
+ headers?: unknown;
114
+ path?: unknown;
115
+ query?: unknown;
116
+ url: string;
117
+ }
118
+ type OmitKeys<T, K> = Pick<T, Exclude<keyof T, K>>;
119
+ export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown, TResponseStyle extends ResponseStyle = 'fields'> = OmitKeys<RequestOptions<TResponse, TResponseStyle, ThrowOnError>, 'body' | 'path' | 'query' | 'url'> & ([TData] extends [never] ? unknown : Omit<TData, 'url'>);
120
+ export {};
@@ -0,0 +1,2 @@
1
+ // This file is auto-generated by @hey-api/openapi-ts
2
+ export {};
@@ -0,0 +1,37 @@
1
+ import type { QuerySerializerOptions } from '../core/bodySerializer.gen.js';
2
+ import type { Client, ClientOptions, Config, RequestOptions } from './types.gen.js';
3
+ export declare const createQuerySerializer: <T = unknown>({ parameters, ...args }?: QuerySerializerOptions) => ((queryParams: T) => string);
4
+ /**
5
+ * Infers parseAs value from provided Content-Type header.
6
+ */
7
+ export declare const getParseAs: (contentType: string | null) => Exclude<Config["parseAs"], "auto">;
8
+ export declare function setAuthParams(options: Pick<RequestOptions, 'auth' | 'query' | 'security'> & {
9
+ headers: Headers;
10
+ }): Promise<void>;
11
+ export declare const buildUrl: Client['buildUrl'];
12
+ export declare const mergeConfigs: (a: Config, b: Config) => Config;
13
+ export declare const mergeHeaders: (...headers: Array<Required<Config>["headers"] | undefined>) => Headers;
14
+ type ErrInterceptor<Err, Res, Req, Options> = (error: Err,
15
+ /** response may be undefined due to a network error where no response object is produced */
16
+ response: Res | undefined,
17
+ /** request may be undefined, because error may be from building the request object itself */
18
+ request: Req | undefined, options: Options) => Err | Promise<Err>;
19
+ type ReqInterceptor<Req, Options> = (request: Req, options: Options) => Req | Promise<Req>;
20
+ type ResInterceptor<Res, Req, Options> = (response: Res, request: Req, options: Options) => Res | Promise<Res>;
21
+ declare class Interceptors<Interceptor> {
22
+ fns: Array<Interceptor | null>;
23
+ clear(): void;
24
+ eject(id: number | Interceptor): void;
25
+ exists(id: number | Interceptor): boolean;
26
+ getInterceptorIndex(id: number | Interceptor): number;
27
+ update(id: number | Interceptor, fn: Interceptor): number | Interceptor | false;
28
+ use(fn: Interceptor): number;
29
+ }
30
+ export interface Middleware<Req, Res, Err, Options> {
31
+ error: Interceptors<ErrInterceptor<Err, Res, Req, Options>>;
32
+ request: Interceptors<ReqInterceptor<Req, Options>>;
33
+ response: Interceptors<ResInterceptor<Res, Req, Options>>;
34
+ }
35
+ export declare const createInterceptors: <Req, Res, Err, Options>() => Middleware<Req, Res, Err, Options>;
36
+ export declare const createConfig: <T extends ClientOptions = ClientOptions>(override?: Config<Omit<ClientOptions, keyof T> & T>) => Config<Omit<ClientOptions, keyof T> & T>;
37
+ export {};