@usagetap/sdk 0.4.0 → 0.6.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 (39) hide show
  1. package/README.md +26 -10
  2. package/dist/adapters/openai.d.cts +135 -2
  3. package/dist/adapters/openai.d.ts +135 -2
  4. package/dist/adapters/{openai.js → openai.mjs} +2 -2
  5. package/dist/adapters/openai.mjs.map +1 -0
  6. package/dist/adapters/openrouter.d.cts +2 -1
  7. package/dist/adapters/openrouter.d.ts +2 -1
  8. package/dist/adapters/{openrouter.js → openrouter.mjs} +2 -2
  9. package/dist/adapters/openrouter.mjs.map +1 -0
  10. package/dist/{openai-Ch7hN2vD.d.cts → client-DAY6cR0C.d.cts} +1 -134
  11. package/dist/{openai-Ch7hN2vD.d.ts → client-DAY6cR0C.d.ts} +1 -134
  12. package/dist/express/index.cjs +691 -0
  13. package/dist/express/index.cjs.map +1 -0
  14. package/dist/express/index.d.cts +93 -0
  15. package/dist/express/index.d.ts +93 -0
  16. package/dist/express/index.mjs +688 -0
  17. package/dist/express/index.mjs.map +1 -0
  18. package/dist/index.cjs +1 -778
  19. package/dist/index.cjs.map +1 -1
  20. package/dist/index.d.cts +3 -94
  21. package/dist/index.d.ts +3 -94
  22. package/dist/{index.js → index.mjs} +4 -773
  23. package/dist/index.mjs.map +1 -0
  24. package/dist/openai/index.cjs +775 -0
  25. package/dist/openai/index.cjs.map +1 -0
  26. package/dist/openai/index.d.cts +4 -0
  27. package/dist/openai/index.d.ts +4 -0
  28. package/dist/openai/index.mjs +768 -0
  29. package/dist/openai/index.mjs.map +1 -0
  30. package/dist/react/index.cjs.map +1 -1
  31. package/dist/react/index.d.cts +1 -1
  32. package/dist/react/index.d.ts +1 -1
  33. package/dist/react/{index.js → index.mjs} +2 -2
  34. package/dist/react/index.mjs.map +1 -0
  35. package/package.json +23 -1
  36. package/dist/adapters/openai.js.map +0 -1
  37. package/dist/adapters/openrouter.js.map +0 -1
  38. package/dist/index.js.map +0 -1
  39. package/dist/react/index.js.map +0 -1
@@ -0,0 +1,768 @@
1
+ // src/errors.ts
2
+ var UsageTapError = class extends Error {
3
+ code;
4
+ status;
5
+ retryable;
6
+ correlationId;
7
+ details;
8
+ constructor(code, message, init = {}) {
9
+ super(message, init.cause ? { cause: init.cause } : void 0);
10
+ this.name = "UsageTapError";
11
+ this.code = code;
12
+ this.status = init.status;
13
+ this.retryable = init.retryable ?? false;
14
+ this.correlationId = init.correlationId;
15
+ this.details = init.details;
16
+ }
17
+ toJSON() {
18
+ return {
19
+ name: this.name,
20
+ message: this.message,
21
+ code: this.code,
22
+ status: this.status,
23
+ retryable: this.retryable,
24
+ correlationId: this.correlationId,
25
+ details: this.details
26
+ };
27
+ }
28
+ };
29
+
30
+ // src/adapters/openai.ts
31
+ function createOpenAIAdapter(init) {
32
+ const { client, usageTap } = init;
33
+ return {
34
+ async invoke(params) {
35
+ const result = await usageTap.withUsage(
36
+ params.begin,
37
+ async (ctx) => {
38
+ const response = await params.call(client, {
39
+ hints: ctx.begin.data.vendorHints,
40
+ begin: ctx.begin
41
+ });
42
+ tryInferUsage(response, ctx.begin.data.vendorHints, params.extractUsage, ctx);
43
+ return {
44
+ data: response,
45
+ begin: ctx.begin
46
+ };
47
+ },
48
+ params.withUsageOptions
49
+ );
50
+ return result;
51
+ },
52
+ async invokeStream(params) {
53
+ const result = await usageTap.withUsage(
54
+ params.begin,
55
+ async (ctx) => {
56
+ const { stream, onComplete } = await params.call(client, {
57
+ hints: ctx.begin.data.vendorHints,
58
+ begin: ctx.begin
59
+ });
60
+ const wrapped = wrapStreamForUsageTap(stream, async () => {
61
+ if (!onComplete) return;
62
+ try {
63
+ const maybeUsage = await onComplete();
64
+ if (maybeUsage) {
65
+ ctx.setUsage(maybeUsage);
66
+ }
67
+ } catch (error) {
68
+ ctx.setError({
69
+ code: "USAGE_FINALIZE_ERROR",
70
+ message: error instanceof Error ? error.message : String(error)
71
+ });
72
+ throw error;
73
+ }
74
+ }, ctx);
75
+ const finalize = async () => {
76
+ await wrapped.__usageTapFinalize?.();
77
+ };
78
+ return {
79
+ stream: wrapped,
80
+ begin: ctx.begin,
81
+ finalize
82
+ };
83
+ },
84
+ params.withUsageOptions
85
+ );
86
+ return result;
87
+ }
88
+ };
89
+ }
90
+ function toNextResponse(stream, options = {}) {
91
+ const mode = options.mode ?? "text";
92
+ const headers = new Headers(options.headers ?? {});
93
+ if (mode === "sse") {
94
+ headers.set("content-type", "text/event-stream; charset=utf-8");
95
+ headers.set("cache-control", "no-cache, no-transform");
96
+ headers.set("connection", "keep-alive");
97
+ headers.set("x-accel-buffering", "no");
98
+ } else {
99
+ headers.set("content-type", options.contentType ?? "text/plain; charset=utf-8");
100
+ }
101
+ const encoder = new TextEncoder();
102
+ let iterator;
103
+ const body = new ReadableStream({
104
+ async start(controller) {
105
+ try {
106
+ const getIterator = stream[Symbol.asyncIterator];
107
+ if (typeof getIterator !== "function") {
108
+ controller.close();
109
+ return;
110
+ }
111
+ iterator = getIterator.call(stream);
112
+ while (true) {
113
+ const result = await iterator.next();
114
+ if (result.done) {
115
+ break;
116
+ }
117
+ const text = chunkToText(result.value);
118
+ if (!text) {
119
+ continue;
120
+ }
121
+ if (mode === "sse") {
122
+ controller.enqueue(encoder.encode(formatSsePayload(text, options.sse)));
123
+ } else {
124
+ controller.enqueue(encoder.encode(text));
125
+ }
126
+ }
127
+ controller.close();
128
+ } catch (error) {
129
+ controller.error(error);
130
+ } finally {
131
+ await stream.__usageTapFinalize?.();
132
+ }
133
+ },
134
+ async cancel() {
135
+ if (!iterator) {
136
+ const getIterator = stream[Symbol.asyncIterator];
137
+ if (typeof getIterator === "function") {
138
+ iterator = getIterator.call(stream);
139
+ }
140
+ }
141
+ if (iterator && typeof iterator.return === "function") {
142
+ await iterator.return();
143
+ }
144
+ await stream.__usageTapFinalize?.();
145
+ }
146
+ });
147
+ return new Response(body, { headers });
148
+ }
149
+ async function pipeToResponse(stream, res, options = {}) {
150
+ const mode = options.mode ?? "text";
151
+ if (mode === "sse") {
152
+ setHeaderIfPossible(res, "Content-Type", "text/event-stream; charset=utf-8");
153
+ setHeaderIfPossible(res, "Cache-Control", "no-cache, no-transform");
154
+ setHeaderIfPossible(res, "Connection", "keep-alive");
155
+ setHeaderIfPossible(res, "X-Accel-Buffering", "no");
156
+ } else {
157
+ setHeaderIfPossible(res, "Content-Type", options.contentType ?? "text/plain; charset=utf-8");
158
+ }
159
+ const encoder = new TextEncoder();
160
+ const iterator = stream[Symbol.asyncIterator]();
161
+ try {
162
+ while (true) {
163
+ const result = await iterator.next();
164
+ if (result.done) {
165
+ break;
166
+ }
167
+ const text = chunkToText(result.value);
168
+ if (!text) {
169
+ continue;
170
+ }
171
+ const payload = mode === "sse" ? formatSsePayload(text, options.sse) : text;
172
+ res.write(Buffer.from(encoder.encode(payload)));
173
+ res.flush?.();
174
+ }
175
+ } finally {
176
+ res.end();
177
+ await stream.__usageTapFinalize?.();
178
+ }
179
+ }
180
+ var USAGETAP_CORRELATION_HEADER = "x-usage-correlation-id";
181
+ function wrapOpenAI(client, usageTap, options = {}) {
182
+ if (!client) {
183
+ throw new UsageTapError("USAGETAP_BAD_REQUEST", "wrapOpenAI requires an OpenAI client instance");
184
+ }
185
+ const defaultContext = options.defaultContext;
186
+ const applyVendorHints = options.applyVendorHints !== false;
187
+ const proxiedChat = client.chat ? createChatProxy(client.chat, usageTap, defaultContext, applyVendorHints) : void 0;
188
+ const proxiedResponses = typeof client.responses !== "undefined" ? createResponsesProxy(client.responses, usageTap, defaultContext, applyVendorHints) : void 0;
189
+ const handler = {
190
+ get(target, prop, receiver) {
191
+ if (prop === "chat" && proxiedChat) {
192
+ return proxiedChat;
193
+ }
194
+ if (prop === "responses" && typeof target.responses !== "undefined") {
195
+ return proxiedResponses ?? Reflect.get(target, prop, receiver);
196
+ }
197
+ if (prop === "toNextResponse") {
198
+ return toNextResponse;
199
+ }
200
+ if (prop === "pipeToResponse") {
201
+ return pipeToResponse;
202
+ }
203
+ if (prop === "unwrap") {
204
+ return () => target;
205
+ }
206
+ return Reflect.get(target, prop, receiver);
207
+ }
208
+ };
209
+ return new Proxy(client, handler);
210
+ }
211
+ function streamOpenAIRoute(usageTap, openai, options) {
212
+ if (!options?.getRequest) {
213
+ throw new UsageTapError("USAGETAP_BAD_REQUEST", "streamOpenAIRoute requires a getRequest function");
214
+ }
215
+ const wrapConfig = options.wrapOptions || options.defaultContext ? {
216
+ ...options.wrapOptions ?? {},
217
+ defaultContext: options.defaultContext ?? options.wrapOptions?.defaultContext
218
+ } : void 0;
219
+ const wrappedClient = wrapConfig ? wrapOpenAI(openai, usageTap, wrapConfig) : wrapOpenAI(openai, usageTap);
220
+ return async (req) => {
221
+ const requestConfig = await options.getRequest(req);
222
+ const mergedParams = {
223
+ ...requestConfig.params,
224
+ stream: true
225
+ };
226
+ const callOptions = {};
227
+ if (requestConfig.usageTap) {
228
+ callOptions.usageTap = requestConfig.usageTap;
229
+ }
230
+ if (requestConfig.withUsage) {
231
+ callOptions.withUsage = requestConfig.withUsage;
232
+ }
233
+ const stream = await wrappedClient.chat.completions.create(
234
+ mergedParams,
235
+ Object.keys(callOptions).length ? callOptions : void 0
236
+ );
237
+ const baseResponse = toNextResponse(stream, {
238
+ mode: options.stream?.mode ?? "sse",
239
+ headers: options.stream?.headers
240
+ });
241
+ const init = options.stream?.responseInit;
242
+ if (!init) {
243
+ return baseResponse;
244
+ }
245
+ const mergedHeaders = new Headers(baseResponse.headers);
246
+ if (init.headers) {
247
+ const extra = normalizeHeaders(init.headers);
248
+ for (const [key, value] of Object.entries(extra)) {
249
+ mergedHeaders.set(key, value);
250
+ }
251
+ }
252
+ return new Response(baseResponse.body, {
253
+ status: init.status ?? baseResponse.status,
254
+ statusText: init.statusText ?? baseResponse.statusText,
255
+ headers: mergedHeaders
256
+ });
257
+ };
258
+ }
259
+ function createChatProxy(resource, usageTap, defaultContext, applyVendorHints) {
260
+ const completions = createChatCompletionsProxy(
261
+ resource.completions,
262
+ usageTap,
263
+ defaultContext,
264
+ applyVendorHints
265
+ );
266
+ const handler = {
267
+ get(target, prop, receiver) {
268
+ if (prop === "completions") {
269
+ return completions;
270
+ }
271
+ return Reflect.get(target, prop, receiver);
272
+ }
273
+ };
274
+ return new Proxy(resource, handler);
275
+ }
276
+ function createResponsesProxy(resource, usageTap, defaultContext, applyVendorHints) {
277
+ if (!resource || typeof resource !== "object") {
278
+ return void 0;
279
+ }
280
+ if (!("create" in resource) || typeof resource.create !== "function") {
281
+ return resource;
282
+ }
283
+ const originalCreate = resource.create.bind(resource);
284
+ const wrappedCreate = (params, options) => {
285
+ const { requestOptions, usageContext, withUsage } = splitUsageOptions(options);
286
+ const beginRequest = resolveBeginRequest(defaultContext, usageContext);
287
+ const wantsStream = isStreamingRequest(params);
288
+ return usageTap.withUsage(beginRequest, (ctx) => {
289
+ const finalParams = applyVendorHints ? applyResponsesVendorHints(params, ctx.begin.data.vendorHints) : params;
290
+ const request = attachCorrelationHeader(requestOptions, ctx.begin.correlationId);
291
+ if (wantsStream) {
292
+ const apiPromise2 = originalCreate(finalParams, request);
293
+ const wrappedPromise2 = transformApiPromise(apiPromise2, (rawStream) => {
294
+ ensureAsyncIterable(rawStream, "responses.create");
295
+ const wrappedStream = wrapStreamForUsageTap(rawStream, async () => {
296
+ const usage = await extractUsageFromStream(rawStream, ctx.begin.data.vendorHints);
297
+ if (usage) {
298
+ ctx.setUsage(usage);
299
+ }
300
+ }, ctx);
301
+ return wrappedStream;
302
+ });
303
+ return wrappedPromise2;
304
+ }
305
+ const apiPromise = originalCreate(finalParams, request);
306
+ const wrappedPromise = transformApiPromise(apiPromise, (response) => {
307
+ tryInferUsage(response, ctx.begin.data.vendorHints, void 0, ctx);
308
+ return response;
309
+ });
310
+ return wrappedPromise;
311
+ }, withUsage);
312
+ };
313
+ const handler = {
314
+ get(target, prop, receiver) {
315
+ if (prop === "create") {
316
+ return wrappedCreate;
317
+ }
318
+ return Reflect.get(target, prop, receiver);
319
+ }
320
+ };
321
+ return new Proxy(resource, handler);
322
+ }
323
+ function createChatCompletionsProxy(resource, usageTap, defaultContext, applyVendorHints) {
324
+ const originalCreate = resource.create.bind(resource);
325
+ const streamCandidate = resource.stream;
326
+ const originalStream = typeof streamCandidate === "function" ? streamCandidate.bind(resource) : void 0;
327
+ const wrappedCreate = (params, options) => {
328
+ const { requestOptions, usageContext, withUsage } = splitUsageOptions(options);
329
+ const beginRequest = resolveBeginRequest(defaultContext, usageContext);
330
+ const wantsStream = isStreamingRequest(params);
331
+ return usageTap.withUsage(beginRequest, (ctx) => {
332
+ const finalParams = applyVendorHints ? applyChatVendorHints(params, ctx.begin.data.vendorHints) : params;
333
+ const request = attachCorrelationHeader(requestOptions, ctx.begin.correlationId);
334
+ if (wantsStream) {
335
+ const apiPromise2 = originalCreate(finalParams, request);
336
+ const wrappedPromise2 = transformApiPromise(apiPromise2, (rawStream) => {
337
+ ensureAsyncIterable(rawStream, "chat.completions.create");
338
+ const wrappedStream2 = wrapStreamForUsageTap(rawStream, async () => {
339
+ const usage = await extractUsageFromStream(rawStream, ctx.begin.data.vendorHints);
340
+ if (usage) {
341
+ ctx.setUsage(usage);
342
+ }
343
+ }, ctx);
344
+ return wrappedStream2;
345
+ });
346
+ return wrappedPromise2;
347
+ }
348
+ const apiPromise = originalCreate(finalParams, request);
349
+ const wrappedPromise = transformApiPromise(apiPromise, (response) => {
350
+ tryInferUsage(response, ctx.begin.data.vendorHints, void 0, ctx);
351
+ return response;
352
+ });
353
+ return wrappedPromise;
354
+ }, withUsage);
355
+ };
356
+ const wrappedStream = originalStream ? (params, options) => {
357
+ const { requestOptions, usageContext, withUsage } = splitUsageOptions(options);
358
+ const beginRequest = resolveBeginRequest(defaultContext, usageContext);
359
+ return usageTap.withUsage(beginRequest, (ctx) => {
360
+ const finalParams = applyVendorHints ? applyChatVendorHints(params, ctx.begin.data.vendorHints) : params;
361
+ const request = attachCorrelationHeader(requestOptions, ctx.begin.correlationId);
362
+ const apiPromise = originalStream(finalParams, request);
363
+ const wrappedPromise = transformApiPromise(apiPromise, (rawStream) => {
364
+ ensureAsyncIterable(rawStream, "chat.completions.stream");
365
+ const wrappedStreamInner = wrapStreamForUsageTap(rawStream, async () => {
366
+ const usage = await extractUsageFromStream(rawStream, ctx.begin.data.vendorHints);
367
+ if (usage) {
368
+ ctx.setUsage(usage);
369
+ }
370
+ }, ctx);
371
+ return wrappedStreamInner;
372
+ });
373
+ return wrappedPromise;
374
+ }, withUsage);
375
+ } : void 0;
376
+ const handler = {
377
+ get(target, prop, receiver) {
378
+ if (prop === "create") {
379
+ return wrappedCreate;
380
+ }
381
+ if (prop === "stream" && wrappedStream) {
382
+ return wrappedStream;
383
+ }
384
+ return Reflect.get(target, prop, receiver);
385
+ }
386
+ };
387
+ return new Proxy(resource, handler);
388
+ }
389
+ function splitUsageOptions(options) {
390
+ if (!options || typeof options !== "object") {
391
+ return {};
392
+ }
393
+ const { usageTap, withUsage, ...rest } = options;
394
+ const requestOptions = Object.keys(rest).length ? cloneRequestOptions(rest) : void 0;
395
+ return {
396
+ requestOptions,
397
+ usageContext: usageTap,
398
+ withUsage
399
+ };
400
+ }
401
+ function resolveBeginRequest(defaults, override) {
402
+ const base = defaults ?? {};
403
+ const current = override ?? {};
404
+ const customerId = current.customerId ?? base.customerId;
405
+ if (!customerId) {
406
+ throw new UsageTapError(
407
+ "USAGETAP_BAD_REQUEST",
408
+ "wrapOpenAI requires usageTap.customerId (provide defaultContext or options.usageTap)"
409
+ );
410
+ }
411
+ const tags = mergeTags(base.tags, current.tags);
412
+ const begin = { customerId };
413
+ const requested = current.requested ?? base.requested;
414
+ if (requested) begin.requested = requested;
415
+ const feature = current.feature ?? base.feature;
416
+ if (feature) begin.feature = feature;
417
+ const idempotency = current.idempotency ?? base.idempotency;
418
+ if (idempotency) begin.idempotency = idempotency;
419
+ const customerName = current.customerName ?? base.customerName;
420
+ if (customerName) begin.customerName = customerName;
421
+ const customerEmail = current.customerEmail ?? base.customerEmail;
422
+ if (customerEmail) begin.customerEmail = customerEmail;
423
+ if (tags?.length) {
424
+ begin.tags = tags;
425
+ }
426
+ return begin;
427
+ }
428
+ function transformApiPromise(apiPromise, onResolve) {
429
+ const resolvedPromise = Promise.resolve(apiPromise).then(onResolve);
430
+ if (isObjectRecord(apiPromise)) {
431
+ const proto = Object.getPrototypeOf(apiPromise);
432
+ if (proto) {
433
+ Object.setPrototypeOf(resolvedPromise, proto);
434
+ }
435
+ for (const key of Reflect.ownKeys(apiPromise)) {
436
+ if (key === "then" || key === "catch" || key === "finally") {
437
+ continue;
438
+ }
439
+ try {
440
+ const descriptor = Object.getOwnPropertyDescriptor(apiPromise, key);
441
+ if (descriptor) {
442
+ Reflect.defineProperty(resolvedPromise, key, descriptor);
443
+ }
444
+ } catch {
445
+ }
446
+ }
447
+ }
448
+ return resolvedPromise;
449
+ }
450
+ function isObjectRecord(value) {
451
+ return typeof value === "object" && value !== null;
452
+ }
453
+ function cloneRecord(value) {
454
+ return isObjectRecord(value) ? { ...value } : {};
455
+ }
456
+ function isStringTuple(value) {
457
+ return Array.isArray(value) && value.length >= 2 && typeof value[0] === "string" && typeof value[1] === "string";
458
+ }
459
+ function cloneRequestOptions(source) {
460
+ const clone = { ...source };
461
+ if ("headers" in clone) {
462
+ clone.headers = normalizeHeaders(clone.headers);
463
+ }
464
+ return clone;
465
+ }
466
+ function attachCorrelationHeader(options, correlationId) {
467
+ const normalized = normalizeHeaders(options?.headers);
468
+ if (correlationId && !normalized[USAGETAP_CORRELATION_HEADER]) {
469
+ normalized[USAGETAP_CORRELATION_HEADER] = correlationId;
470
+ }
471
+ if (!options) {
472
+ return Object.keys(normalized).length ? { headers: normalized } : void 0;
473
+ }
474
+ const next = { ...options };
475
+ if (Object.keys(normalized).length) {
476
+ next.headers = normalized;
477
+ }
478
+ return next;
479
+ }
480
+ function normalizeHeaders(headers) {
481
+ if (!headers) {
482
+ return {};
483
+ }
484
+ if (headers instanceof Headers) {
485
+ const result = {};
486
+ headers.forEach((value, key) => {
487
+ result[key.toLowerCase()] = value;
488
+ });
489
+ return result;
490
+ }
491
+ if (Array.isArray(headers)) {
492
+ const result = {};
493
+ for (const entry of headers) {
494
+ if (!isStringTuple(entry)) {
495
+ continue;
496
+ }
497
+ const [key, value] = entry;
498
+ result[key.toLowerCase()] = value;
499
+ }
500
+ return result;
501
+ }
502
+ if (isObjectRecord(headers)) {
503
+ const result = {};
504
+ const record = headers;
505
+ for (const key of Object.keys(record)) {
506
+ const value = record[key];
507
+ if (value !== void 0 && value !== null) {
508
+ result[key.toLowerCase()] = String(value);
509
+ }
510
+ }
511
+ return result;
512
+ }
513
+ return {};
514
+ }
515
+ function mergeTags(a, b) {
516
+ const values = [...a ?? [], ...b ?? []].map((value) => typeof value === "string" ? value.trim() : "").filter(Boolean);
517
+ if (!values.length) {
518
+ return void 0;
519
+ }
520
+ return dedupeStrings(values);
521
+ }
522
+ function dedupeStrings(values) {
523
+ return Array.from(new Set(values));
524
+ }
525
+ function isStreamingRequest(params) {
526
+ if (!params || typeof params !== "object") {
527
+ return false;
528
+ }
529
+ const stream = params.stream;
530
+ if (typeof stream === "boolean") {
531
+ return stream;
532
+ }
533
+ return stream != null;
534
+ }
535
+ function applyChatVendorHints(params, hints) {
536
+ if (!hints) {
537
+ return params;
538
+ }
539
+ const next = cloneRecord(params);
540
+ if (hints.preferredModel && (next.model === void 0 || next.model === null)) {
541
+ next.model = hints.preferredModel;
542
+ }
543
+ if (typeof hints.maxResponseTokens === "number" && next.max_tokens == null) {
544
+ next.max_tokens = hints.maxResponseTokens;
545
+ }
546
+ if (typeof hints.maxInputTokens === "number" && next.max_input_tokens == null) {
547
+ next.max_input_tokens = hints.maxInputTokens;
548
+ }
549
+ return next;
550
+ }
551
+ function applyResponsesVendorHints(params, hints) {
552
+ if (!hints) {
553
+ return params;
554
+ }
555
+ const next = cloneRecord(params);
556
+ if (hints.preferredModel && (next.model === void 0 || next.model === null)) {
557
+ next.model = hints.preferredModel;
558
+ }
559
+ if (typeof hints.maxResponseTokens === "number" && next.max_output_tokens == null) {
560
+ next.max_output_tokens = hints.maxResponseTokens;
561
+ }
562
+ return next;
563
+ }
564
+ async function extractUsageFromStream(stream, hints) {
565
+ const finalPayload = await resolveStreamFinalPayload(stream);
566
+ if (!finalPayload) {
567
+ return void 0;
568
+ }
569
+ return inferUsageFromResponse(finalPayload, hints);
570
+ }
571
+ async function resolveStreamFinalPayload(stream) {
572
+ if (!stream || typeof stream !== "object") {
573
+ return void 0;
574
+ }
575
+ const candidate = stream;
576
+ if (typeof candidate.finalChatCompletion === "function") {
577
+ return candidate.finalChatCompletion();
578
+ }
579
+ if (typeof candidate.finalResponse === "function") {
580
+ return candidate.finalResponse();
581
+ }
582
+ if (typeof candidate.finalCompletion === "function") {
583
+ return candidate.finalCompletion();
584
+ }
585
+ if (typeof candidate.finalContent === "function") {
586
+ return candidate.finalContent();
587
+ }
588
+ return void 0;
589
+ }
590
+ function ensureAsyncIterable(value, label) {
591
+ if (!value || typeof value !== "object" || typeof value[Symbol.asyncIterator] !== "function") {
592
+ throw new UsageTapError(
593
+ "USAGETAP_BAD_REQUEST",
594
+ `${label} expected an async iterable stream but received ${typeof value}`
595
+ );
596
+ }
597
+ }
598
+ function chunkToText(chunk) {
599
+ if (chunk === void 0 || chunk === null) {
600
+ return "";
601
+ }
602
+ if (typeof chunk === "string") {
603
+ return chunk;
604
+ }
605
+ if (typeof chunk === "object") {
606
+ const candidate = chunk;
607
+ const delta = candidate.choices?.[0]?.delta;
608
+ const content = delta?.content ?? candidate.content;
609
+ if (typeof content === "string") {
610
+ return content;
611
+ }
612
+ if (Array.isArray(content)) {
613
+ return content.map((entry) => {
614
+ if (!entry) return "";
615
+ if (typeof entry === "string") return entry;
616
+ if (typeof entry.text === "string") return entry.text;
617
+ return "";
618
+ }).join("");
619
+ }
620
+ }
621
+ return String(chunk);
622
+ }
623
+ function formatSsePayload(text, options) {
624
+ if (!text) {
625
+ return "";
626
+ }
627
+ const lines = text.split(/\r?\n/);
628
+ const eventLine = options?.event ? `event: ${options.event}
629
+ ` : "";
630
+ const retryLine = options?.retry ? `retry: ${options.retry}
631
+ ` : "";
632
+ const dataLines = lines.map((line) => `data: ${line}`).join("\n");
633
+ return `${eventLine}${retryLine}${dataLines}
634
+
635
+ `;
636
+ }
637
+ function setHeaderIfPossible(res, key, value) {
638
+ if (typeof res.setHeader === "function" && res.headersSent !== true) {
639
+ res.setHeader(key, value);
640
+ }
641
+ }
642
+ function tryInferUsage(response, hints, extractor, ctx) {
643
+ const explicit = extractor?.(response);
644
+ const inferred = explicit ?? inferUsageFromResponse(response, hints);
645
+ if (inferred) {
646
+ ctx.setUsage(inferred);
647
+ }
648
+ }
649
+ function inferUsageFromResponse(response, hints) {
650
+ if (!response || typeof response !== "object") {
651
+ return void 0;
652
+ }
653
+ const candidate = response;
654
+ if (!candidate.usage) {
655
+ return void 0;
656
+ }
657
+ return {
658
+ modelUsed: candidate.model ?? hints?.preferredModel,
659
+ inputTokens: candidate.usage.prompt_tokens,
660
+ responseTokens: candidate.usage.completion_tokens,
661
+ cachedTokens: candidate.usage.cached_tokens
662
+ };
663
+ }
664
+ function wrapStreamForUsageTap(source, finalize, ctx) {
665
+ const getIterator = source[Symbol.asyncIterator];
666
+ if (typeof getIterator !== "function") {
667
+ throw new TypeError("Stream is not async iterable");
668
+ }
669
+ const iterator = getIterator.call(source);
670
+ let completed = false;
671
+ const invokeFinalize = async () => {
672
+ if (completed) return;
673
+ completed = true;
674
+ try {
675
+ await finalize();
676
+ } catch (error) {
677
+ ctx.setError({
678
+ code: "USAGE_FINALIZE_ERROR",
679
+ message: error instanceof Error ? error.message : String(error)
680
+ });
681
+ throw error;
682
+ }
683
+ };
684
+ const prototype = Object.getPrototypeOf(source) ?? Object.prototype;
685
+ const wrapped = Object.create(prototype);
686
+ for (const key of Reflect.ownKeys(source)) {
687
+ try {
688
+ const descriptor = Object.getOwnPropertyDescriptor(source, key);
689
+ if (descriptor) {
690
+ Object.defineProperty(wrapped, key, descriptor);
691
+ }
692
+ } catch {
693
+ }
694
+ }
695
+ Object.defineProperty(wrapped, Symbol.asyncIterator, {
696
+ value() {
697
+ return this;
698
+ },
699
+ configurable: true
700
+ });
701
+ Object.defineProperty(wrapped, "next", {
702
+ value: async (...args) => {
703
+ try {
704
+ const result = await iterator.next(...args);
705
+ if (result.done) {
706
+ await invokeFinalize();
707
+ }
708
+ return result;
709
+ } catch (error) {
710
+ await invokeFinalize().catch(() => void 0);
711
+ throw error;
712
+ }
713
+ },
714
+ configurable: true,
715
+ writable: true
716
+ });
717
+ Object.defineProperty(wrapped, "return", {
718
+ value: async (value) => {
719
+ if (typeof iterator.return === "function") {
720
+ const rawResult = await iterator.return(value);
721
+ if (!isIteratorResult(rawResult)) {
722
+ throw new TypeError("Iterator.return() returned an invalid result");
723
+ }
724
+ await invokeFinalize();
725
+ return rawResult;
726
+ }
727
+ await invokeFinalize();
728
+ return { done: true, value };
729
+ },
730
+ configurable: true,
731
+ writable: true
732
+ });
733
+ Object.defineProperty(wrapped, "throw", {
734
+ value: async (error) => {
735
+ if (typeof iterator.throw === "function") {
736
+ const rawResult = await iterator.throw(error);
737
+ if (!isIteratorResult(rawResult)) {
738
+ throw new TypeError("Iterator.throw() returned an invalid result");
739
+ }
740
+ await invokeFinalize();
741
+ return rawResult;
742
+ }
743
+ await invokeFinalize();
744
+ throw error;
745
+ },
746
+ configurable: true,
747
+ writable: true
748
+ });
749
+ Object.defineProperty(wrapped, "__usageTapFinalize", {
750
+ value: async () => {
751
+ await invokeFinalize();
752
+ },
753
+ configurable: true
754
+ });
755
+ return wrapped;
756
+ }
757
+ function isIteratorResult(value) {
758
+ return isObjectRecord(value) && "done" in value;
759
+ }
760
+
761
+ // src/adapters/openrouter.ts
762
+ function createOpenRouterAdapter(init) {
763
+ return createOpenAIAdapter(init);
764
+ }
765
+
766
+ export { createOpenAIAdapter, createOpenRouterAdapter, pipeToResponse, streamOpenAIRoute, toNextResponse, wrapOpenAI };
767
+ //# sourceMappingURL=index.mjs.map
768
+ //# sourceMappingURL=index.mjs.map