@terreno/api 0.24.0 → 0.26.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 (48) hide show
  1. package/.ai/guidelines/core.md +1 -0
  2. package/README.md +5 -3
  3. package/dist/__tests__/versionCheckPlugin.test.js +62 -2
  4. package/dist/api.query.test.js +99 -0
  5. package/dist/auth.compile.test.d.ts +1 -0
  6. package/dist/auth.compile.test.js +201 -0
  7. package/dist/auth.js +38 -7
  8. package/dist/auth.test.js +119 -1
  9. package/dist/betterAuthApp.test.js +1 -2
  10. package/dist/betterAuthSetup.test.js +76 -0
  11. package/dist/expressServer.js +6 -6
  12. package/dist/expressServer.test.js +37 -8
  13. package/dist/httpClient.d.ts +119 -0
  14. package/dist/httpClient.js +412 -0
  15. package/dist/httpClient.test.d.ts +1 -0
  16. package/dist/httpClient.test.js +1470 -0
  17. package/dist/index.d.ts +10 -2
  18. package/dist/index.js +29 -3
  19. package/dist/openApi.test.js +51 -0
  20. package/dist/realtime/queryStore.d.ts +3 -3
  21. package/dist/realtime/queryStore.js +0 -1
  22. package/dist/realtime/realtime.test.js +22 -0
  23. package/dist/tests/fixtures/compileAuthEntry.d.ts +1 -0
  24. package/dist/tests/fixtures/compileAuthEntry.js +37 -0
  25. package/package.json +2 -2
  26. package/src/__tests__/versionCheckPlugin.test.ts +46 -2
  27. package/src/api.query.test.ts +59 -0
  28. package/src/auth.compile.test.ts +106 -0
  29. package/src/auth.test.ts +81 -1
  30. package/src/auth.ts +49 -7
  31. package/src/betterAuthApp.test.ts +3 -3
  32. package/src/betterAuthSetup.test.ts +65 -0
  33. package/src/expressServer.test.ts +29 -8
  34. package/src/expressServer.ts +1 -1
  35. package/src/httpClient.test.ts +979 -0
  36. package/src/httpClient.ts +464 -0
  37. package/src/index.ts +41 -2
  38. package/src/openApi.test.ts +53 -0
  39. package/src/realtime/queryStore.ts +6 -7
  40. package/src/realtime/realtime.test.ts +28 -2
  41. package/src/realtime/realtimeApp.ts +3 -3
  42. package/src/tests/fixtures/compileAuthEntry.ts +43 -0
  43. package/dist/notifiers/index.d.ts +0 -3
  44. package/dist/notifiers/index.js +0 -19
  45. package/dist/realtime/index.d.ts +0 -6
  46. package/dist/realtime/index.js +0 -27
  47. package/src/notifiers/index.ts +0 -3
  48. package/src/realtime/index.ts +0 -34
@@ -0,0 +1,1470 @@
1
+ "use strict";
2
+ var __assign = (this && this.__assign) || function () {
3
+ __assign = Object.assign || function(t) {
4
+ for (var s, i = 1, n = arguments.length; i < n; i++) {
5
+ s = arguments[i];
6
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
+ t[p] = s[p];
8
+ }
9
+ return t;
10
+ };
11
+ return __assign.apply(this, arguments);
12
+ };
13
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
14
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
15
+ return new (P || (P = Promise))(function (resolve, reject) {
16
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
17
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
18
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
19
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
20
+ });
21
+ };
22
+ var __generator = (this && this.__generator) || function (thisArg, body) {
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
+ function verb(n) { return function (v) { return step([n, v]); }; }
26
+ function step(op) {
27
+ if (f) throw new TypeError("Generator is already executing.");
28
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
29
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
30
+ if (y = 0, t) op = [op[0] & 2, t.value];
31
+ switch (op[0]) {
32
+ case 0: case 1: t = op; break;
33
+ case 4: _.label++; return { value: op[1], done: false };
34
+ case 5: _.label++; y = op[1]; op = [0]; continue;
35
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
36
+ default:
37
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
38
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
39
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
40
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
41
+ if (t[2]) _.ops.pop();
42
+ _.trys.pop(); continue;
43
+ }
44
+ op = body.call(thisArg, _);
45
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
46
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
47
+ }
48
+ };
49
+ var __values = (this && this.__values) || function(o) {
50
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
51
+ if (m) return m.call(o);
52
+ if (o && typeof o.length === "number") return {
53
+ next: function () {
54
+ if (o && i >= o.length) o = void 0;
55
+ return { value: o && o[i++], done: !o };
56
+ }
57
+ };
58
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
59
+ };
60
+ var __read = (this && this.__read) || function (o, n) {
61
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
62
+ if (!m) return o;
63
+ var i = m.call(o), r, ar = [], e;
64
+ try {
65
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
66
+ }
67
+ catch (error) { e = { error: error }; }
68
+ finally {
69
+ try {
70
+ if (r && !r.done && (m = i["return"])) m.call(i);
71
+ }
72
+ finally { if (e) throw e.error; }
73
+ }
74
+ return ar;
75
+ };
76
+ var __importDefault = (this && this.__importDefault) || function (mod) {
77
+ return (mod && mod.__esModule) ? mod : { "default": mod };
78
+ };
79
+ Object.defineProperty(exports, "__esModule", { value: true });
80
+ var bun_test_1 = require("bun:test");
81
+ var axios_1 = require("axios");
82
+ var express_1 = __importDefault(require("express"));
83
+ var errors_1 = require("./errors");
84
+ var httpClient_1 = require("./httpClient");
85
+ var startTestServer = function (configure) { return __awaiter(void 0, void 0, void 0, function () {
86
+ var app, server, port;
87
+ return __generator(this, function (_a) {
88
+ switch (_a.label) {
89
+ case 0:
90
+ app = (0, express_1.default)();
91
+ app.use(express_1.default.json());
92
+ app.use(express_1.default.urlencoded({ extended: false }));
93
+ configure(app);
94
+ return [4 /*yield*/, new Promise(function (resolve) {
95
+ var listening = app.listen(0, function () { return resolve(listening); });
96
+ })];
97
+ case 1:
98
+ server = _a.sent();
99
+ port = server.address().port;
100
+ return [2 /*return*/, {
101
+ baseURL: "http://127.0.0.1:".concat(port),
102
+ close: function () { return new Promise(function (resolve) { return server.close(function () { return resolve(); }); }); },
103
+ }];
104
+ }
105
+ });
106
+ }); };
107
+ // Tests use a 1ms base delay so retry backoff doesn't slow the suite.
108
+ var FAST_RETRY = { baseDelayMs: 1 };
109
+ var createRecordingLogger = function () {
110
+ var entries = [];
111
+ var record = function (level) {
112
+ return function (msg) {
113
+ var args = [];
114
+ for (var _i = 1; _i < arguments.length; _i++) {
115
+ args[_i - 1] = arguments[_i];
116
+ }
117
+ entries.push({ args: args, level: level, msg: msg });
118
+ };
119
+ };
120
+ return {
121
+ entries: entries,
122
+ logger: { debug: record("debug"), error: record("error"), warn: record("warn") },
123
+ };
124
+ };
125
+ var CONTEXT = { apiName: "testApi", operation: "getWidget" };
126
+ var buildAxiosError = function (_a) {
127
+ var status = _a.status, data = _a.data, code = _a.code;
128
+ var config = { headers: {}, url: "/widgets" };
129
+ var response;
130
+ if (status !== undefined) {
131
+ response = {
132
+ config: config,
133
+ data: data,
134
+ headers: {},
135
+ status: status,
136
+ statusText: "",
137
+ };
138
+ }
139
+ return new axios_1.AxiosError(status !== undefined ? "Request failed with status code ".concat(status) : "Network Error", code, config, undefined, response);
140
+ };
141
+ (0, bun_test_1.describe)("normalizeApiError", function () {
142
+ (0, bun_test_1.it)("classifies HTTP statuses from an axios error response", function () {
143
+ var e_1, _a;
144
+ var cases = [
145
+ [429, "rateLimited"],
146
+ [401, "unauthorized"],
147
+ [403, "unauthorized"],
148
+ [404, "notFound"],
149
+ [400, "validation"],
150
+ [422, "validation"],
151
+ [500, "server"],
152
+ [503, "server"],
153
+ ];
154
+ try {
155
+ for (var cases_1 = __values(cases), cases_1_1 = cases_1.next(); !cases_1_1.done; cases_1_1 = cases_1.next()) {
156
+ var _b = __read(cases_1_1.value, 2), status_1 = _b[0], classification = _b[1];
157
+ var normalized = (0, httpClient_1.normalizeApiError)(buildAxiosError({ status: status_1 }), CONTEXT);
158
+ (0, bun_test_1.expect)(normalized.isAxios).toBe(true);
159
+ (0, bun_test_1.expect)(normalized.statusCode).toBe(status_1);
160
+ (0, bun_test_1.expect)(normalized.classification).toBe(classification);
161
+ }
162
+ }
163
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
164
+ finally {
165
+ try {
166
+ if (cases_1_1 && !cases_1_1.done && (_a = cases_1.return)) _a.call(cases_1);
167
+ }
168
+ finally { if (e_1) throw e_1.error; }
169
+ }
170
+ });
171
+ (0, bun_test_1.it)("extracts messages from a {message} response body", function () {
172
+ var error = buildAxiosError({ data: { message: "Widget not found" }, status: 404 });
173
+ var normalized = (0, httpClient_1.normalizeApiError)(error, CONTEXT);
174
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["Widget not found"]);
175
+ });
176
+ (0, bun_test_1.it)("extracts messages from a JSONAPI-style {errors: [{title, detail}]} body", function () {
177
+ var error = buildAxiosError({
178
+ data: {
179
+ errors: [
180
+ { detail: "name is required", title: "Validation failed" },
181
+ { title: "Another problem" },
182
+ ],
183
+ },
184
+ status: 422,
185
+ });
186
+ var normalized = (0, httpClient_1.normalizeApiError)(error, CONTEXT);
187
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["Validation failed: name is required", "Another problem"]);
188
+ });
189
+ (0, bun_test_1.it)("extracts a plain-string response body as the message", function () {
190
+ var error = buildAxiosError({ data: "Service unavailable", status: 503 });
191
+ var normalized = (0, httpClient_1.normalizeApiError)(error, CONTEXT);
192
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["Service unavailable"]);
193
+ });
194
+ (0, bun_test_1.it)("falls back to the axios error message when the body has no recognizable message", function () {
195
+ var error = buildAxiosError({ data: { unexpected: true }, status: 500 });
196
+ var normalized = (0, httpClient_1.normalizeApiError)(error, CONTEXT);
197
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["Request failed with status code 500"]);
198
+ });
199
+ (0, bun_test_1.it)("classifies an axios error without a response as network", function () {
200
+ var error = buildAxiosError({ code: "ECONNREFUSED" });
201
+ var normalized = (0, httpClient_1.normalizeApiError)(error, CONTEXT);
202
+ (0, bun_test_1.expect)(normalized.isAxios).toBe(true);
203
+ (0, bun_test_1.expect)(normalized.statusCode).toBeUndefined();
204
+ (0, bun_test_1.expect)(normalized.classification).toBe("network");
205
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["Network Error"]);
206
+ });
207
+ (0, bun_test_1.it)("classifies a sub-400 response status as unknown", function () {
208
+ var normalized = (0, httpClient_1.normalizeApiError)(buildAxiosError({ status: 302 }), CONTEXT);
209
+ (0, bun_test_1.expect)(normalized.classification).toBe("unknown");
210
+ (0, bun_test_1.expect)(normalized.statusCode).toBe(302);
211
+ });
212
+ (0, bun_test_1.it)("extracts detail-only JSONAPI error entries", function () {
213
+ var error = buildAxiosError({ data: { errors: [{ detail: "just a detail" }] }, status: 400 });
214
+ var normalized = (0, httpClient_1.normalizeApiError)(error, CONTEXT);
215
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["just a detail"]);
216
+ });
217
+ (0, bun_test_1.it)("falls back to the axios message for empty-string, empty-message, and empty-errors bodies", function () {
218
+ var e_2, _a;
219
+ try {
220
+ for (var _b = __values(["", { message: "" }, { errors: [] }]), _c = _b.next(); !_c.done; _c = _b.next()) {
221
+ var data = _c.value;
222
+ var normalized = (0, httpClient_1.normalizeApiError)(buildAxiosError({ data: data, status: 500 }), CONTEXT);
223
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["Request failed with status code 500"]);
224
+ }
225
+ }
226
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
227
+ finally {
228
+ try {
229
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
230
+ }
231
+ finally { if (e_2) throw e_2.error; }
232
+ }
233
+ });
234
+ (0, bun_test_1.it)("falls back to the axios message when the errors array has no usable entries", function () {
235
+ var error = buildAxiosError({ data: { errors: ["oops", null, 42, { title: 5 }] }, status: 500 });
236
+ var normalized = (0, httpClient_1.normalizeApiError)(error, CONTEXT);
237
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["Request failed with status code 500"]);
238
+ });
239
+ (0, bun_test_1.it)("truncates long plain-string bodies so unbounded payloads never reach the logger", function () {
240
+ var error = buildAxiosError({ data: "x".repeat(2000), status: 503 });
241
+ var normalized = (0, httpClient_1.normalizeApiError)(error, CONTEXT);
242
+ (0, bun_test_1.expect)(normalized.messages[0].length).toBeLessThanOrEqual(512);
243
+ (0, bun_test_1.expect)(normalized.messages[0].endsWith("…")).toBe(true);
244
+ });
245
+ (0, bun_test_1.it)("classifies a plain Error as unknown and preserves its message", function () {
246
+ var normalized = (0, httpClient_1.normalizeApiError)(new Error("boom"), CONTEXT);
247
+ (0, bun_test_1.expect)(normalized.isAxios).toBe(false);
248
+ (0, bun_test_1.expect)(normalized.statusCode).toBeUndefined();
249
+ (0, bun_test_1.expect)(normalized.classification).toBe("unknown");
250
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["boom"]);
251
+ });
252
+ (0, bun_test_1.it)("classifies a non-Error thrown value as unknown with a stringified message", function () {
253
+ var normalized = (0, httpClient_1.normalizeApiError)("total failure", CONTEXT);
254
+ (0, bun_test_1.expect)(normalized.classification).toBe("unknown");
255
+ (0, bun_test_1.expect)(normalized.messages).toEqual(["total failure"]);
256
+ });
257
+ (0, bun_test_1.it)("echoes apiName and operation for structured logging", function () {
258
+ var normalized = (0, httpClient_1.normalizeApiError)(new Error("boom"), CONTEXT);
259
+ (0, bun_test_1.expect)(normalized.apiName).toBe("testApi");
260
+ (0, bun_test_1.expect)(normalized.operation).toBe("getWidget");
261
+ });
262
+ });
263
+ (0, bun_test_1.describe)("withApiErrorHandling", function () {
264
+ (0, bun_test_1.it)("returns the wrapped function's result on success and logs nothing", function () { return __awaiter(void 0, void 0, void 0, function () {
265
+ var _a, logger, entries, result;
266
+ return __generator(this, function (_b) {
267
+ switch (_b.label) {
268
+ case 0:
269
+ _a = createRecordingLogger(), logger = _a.logger, entries = _a.entries;
270
+ return [4 /*yield*/, (0, httpClient_1.withApiErrorHandling)(function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
271
+ return [2 /*return*/, "ok"];
272
+ }); }); }, __assign(__assign({}, CONTEXT), { logger: logger }))];
273
+ case 1:
274
+ result = _b.sent();
275
+ (0, bun_test_1.expect)(result).toBe("ok");
276
+ (0, bun_test_1.expect)(entries).toHaveLength(0);
277
+ return [2 /*return*/];
278
+ }
279
+ });
280
+ }); });
281
+ (0, bun_test_1.it)("logs the normalized error and rethrows the original error by default", function () { return __awaiter(void 0, void 0, void 0, function () {
282
+ var _a, logger, entries, original, caught, error_1, normalized;
283
+ return __generator(this, function (_b) {
284
+ switch (_b.label) {
285
+ case 0:
286
+ _a = createRecordingLogger(), logger = _a.logger, entries = _a.entries;
287
+ original = buildAxiosError({ data: { message: "nope" }, status: 404 });
288
+ _b.label = 1;
289
+ case 1:
290
+ _b.trys.push([1, 3, , 4]);
291
+ return [4 /*yield*/, (0, httpClient_1.withApiErrorHandling)(function () { return __awaiter(void 0, void 0, void 0, function () {
292
+ return __generator(this, function (_a) {
293
+ throw original;
294
+ });
295
+ }); }, __assign(__assign({}, CONTEXT), { logger: logger }))];
296
+ case 2:
297
+ _b.sent();
298
+ return [3 /*break*/, 4];
299
+ case 3:
300
+ error_1 = _b.sent();
301
+ caught = error_1;
302
+ return [3 /*break*/, 4];
303
+ case 4:
304
+ (0, bun_test_1.expect)(caught).toBe(original);
305
+ (0, bun_test_1.expect)(entries).toHaveLength(1);
306
+ (0, bun_test_1.expect)(entries[0].level).toBe("error");
307
+ (0, bun_test_1.expect)(entries[0].msg).toContain("testApi");
308
+ (0, bun_test_1.expect)(entries[0].msg).toContain("getWidget");
309
+ normalized = entries[0].args[0];
310
+ (0, bun_test_1.expect)(normalized.statusCode).toBe(404);
311
+ (0, bun_test_1.expect)(normalized.classification).toBe("notFound");
312
+ return [2 /*return*/];
313
+ }
314
+ });
315
+ }); });
316
+ (0, bun_test_1.it)("converts to an APIError when rethrowAs is apiError, logging via APIError only", function () { return __awaiter(void 0, void 0, void 0, function () {
317
+ var _a, logger, entries, original, caught, error_2, apiError;
318
+ var _b;
319
+ return __generator(this, function (_c) {
320
+ switch (_c.label) {
321
+ case 0:
322
+ _a = createRecordingLogger(), logger = _a.logger, entries = _a.entries;
323
+ original = buildAxiosError({ data: { message: "Rate limit exceeded" }, status: 429 });
324
+ _c.label = 1;
325
+ case 1:
326
+ _c.trys.push([1, 3, , 4]);
327
+ return [4 /*yield*/, (0, httpClient_1.withApiErrorHandling)(function () { return __awaiter(void 0, void 0, void 0, function () {
328
+ return __generator(this, function (_a) {
329
+ throw original;
330
+ });
331
+ }); }, __assign(__assign({}, CONTEXT), { logger: logger, rethrowAs: "apiError" }))];
332
+ case 2:
333
+ _c.sent();
334
+ return [3 /*break*/, 4];
335
+ case 3:
336
+ error_2 = _c.sent();
337
+ caught = error_2;
338
+ return [3 /*break*/, 4];
339
+ case 4:
340
+ (0, bun_test_1.expect)(caught).toBeInstanceOf(errors_1.APIError);
341
+ apiError = caught;
342
+ (0, bun_test_1.expect)(apiError.status).toBe(429);
343
+ (0, bun_test_1.expect)(apiError.title).toBe("testApi getWidget request failed");
344
+ (0, bun_test_1.expect)(apiError.detail).toBe("Rate limit exceeded");
345
+ (0, bun_test_1.expect)(apiError.error).toBe(original);
346
+ (0, bun_test_1.expect)((_b = apiError.meta) === null || _b === void 0 ? void 0 : _b.classification).toBe("rateLimited");
347
+ // Logged exactly once: the APIError constructor logs, so the wrapper must not.
348
+ (0, bun_test_1.expect)(entries).toHaveLength(0);
349
+ return [2 /*return*/];
350
+ }
351
+ });
352
+ }); });
353
+ (0, bun_test_1.it)("defaults the APIError status to 500 when the failure has no status code", function () { return __awaiter(void 0, void 0, void 0, function () {
354
+ var logger, caught, error_3;
355
+ return __generator(this, function (_a) {
356
+ switch (_a.label) {
357
+ case 0:
358
+ logger = createRecordingLogger().logger;
359
+ _a.label = 1;
360
+ case 1:
361
+ _a.trys.push([1, 3, , 4]);
362
+ return [4 /*yield*/, (0, httpClient_1.withApiErrorHandling)(function () { return __awaiter(void 0, void 0, void 0, function () {
363
+ return __generator(this, function (_a) {
364
+ throw new Error("boom");
365
+ });
366
+ }); }, __assign(__assign({}, CONTEXT), { logger: logger, rethrowAs: "apiError" }))];
367
+ case 2:
368
+ _a.sent();
369
+ return [3 /*break*/, 4];
370
+ case 3:
371
+ error_3 = _a.sent();
372
+ caught = error_3;
373
+ return [3 /*break*/, 4];
374
+ case 4:
375
+ (0, bun_test_1.expect)(caught).toBeInstanceOf(errors_1.APIError);
376
+ (0, bun_test_1.expect)(caught.status).toBe(500);
377
+ return [2 /*return*/];
378
+ }
379
+ });
380
+ }); });
381
+ (0, bun_test_1.it)("clamps sub-400 response statuses to a 500 APIError", function () { return __awaiter(void 0, void 0, void 0, function () {
382
+ var logger, caught, error_4;
383
+ return __generator(this, function (_a) {
384
+ switch (_a.label) {
385
+ case 0:
386
+ logger = createRecordingLogger().logger;
387
+ _a.label = 1;
388
+ case 1:
389
+ _a.trys.push([1, 3, , 4]);
390
+ return [4 /*yield*/, (0, httpClient_1.withApiErrorHandling)(function () { return __awaiter(void 0, void 0, void 0, function () {
391
+ return __generator(this, function (_a) {
392
+ throw buildAxiosError({ status: 302 });
393
+ });
394
+ }); }, __assign(__assign({}, CONTEXT), { logger: logger, rethrowAs: "apiError" }))];
395
+ case 2:
396
+ _a.sent();
397
+ return [3 /*break*/, 4];
398
+ case 3:
399
+ error_4 = _a.sent();
400
+ caught = error_4;
401
+ return [3 /*break*/, 4];
402
+ case 4:
403
+ (0, bun_test_1.expect)(caught.status).toBe(500);
404
+ return [2 /*return*/];
405
+ }
406
+ });
407
+ }); });
408
+ (0, bun_test_1.it)("applies the redactError hook before logging", function () { return __awaiter(void 0, void 0, void 0, function () {
409
+ var _a, logger, entries, original, caught, error_5, logged;
410
+ return __generator(this, function (_b) {
411
+ switch (_b.label) {
412
+ case 0:
413
+ _a = createRecordingLogger(), logger = _a.logger, entries = _a.entries;
414
+ original = buildAxiosError({ data: { message: "patient 12345 not found" }, status: 404 });
415
+ _b.label = 1;
416
+ case 1:
417
+ _b.trys.push([1, 3, , 4]);
418
+ return [4 /*yield*/, (0, httpClient_1.withApiErrorHandling)(function () { return __awaiter(void 0, void 0, void 0, function () {
419
+ return __generator(this, function (_a) {
420
+ throw original;
421
+ });
422
+ }); }, __assign(__assign({}, CONTEXT), { logger: logger, redactError: function (normalized) { return (__assign(__assign({}, normalized), { messages: ["[redacted]"] })); } }))];
423
+ case 2:
424
+ _b.sent();
425
+ return [3 /*break*/, 4];
426
+ case 3:
427
+ error_5 = _b.sent();
428
+ caught = error_5;
429
+ return [3 /*break*/, 4];
430
+ case 4:
431
+ (0, bun_test_1.expect)(caught).toBe(original);
432
+ logged = entries[0].args[0];
433
+ (0, bun_test_1.expect)(logged.messages).toEqual(["[redacted]"]);
434
+ return [2 /*return*/];
435
+ }
436
+ });
437
+ }); });
438
+ (0, bun_test_1.it)("uses redacted messages in the APIError detail when combined with rethrowAs apiError", function () { return __awaiter(void 0, void 0, void 0, function () {
439
+ var logger, caught, error_6, apiError;
440
+ return __generator(this, function (_a) {
441
+ switch (_a.label) {
442
+ case 0:
443
+ logger = createRecordingLogger().logger;
444
+ _a.label = 1;
445
+ case 1:
446
+ _a.trys.push([1, 3, , 4]);
447
+ return [4 /*yield*/, (0, httpClient_1.withApiErrorHandling)(function () { return __awaiter(void 0, void 0, void 0, function () {
448
+ return __generator(this, function (_a) {
449
+ throw buildAxiosError({ data: { message: "patient 12345 not found" }, status: 404 });
450
+ });
451
+ }); }, __assign(__assign({}, CONTEXT), { logger: logger, redactError: function (normalized) { return (__assign(__assign({}, normalized), { messages: ["[redacted]"] })); }, rethrowAs: "apiError" }))];
452
+ case 2:
453
+ _a.sent();
454
+ return [3 /*break*/, 4];
455
+ case 3:
456
+ error_6 = _a.sent();
457
+ caught = error_6;
458
+ return [3 /*break*/, 4];
459
+ case 4:
460
+ apiError = caught;
461
+ (0, bun_test_1.expect)(apiError.detail).toBe("[redacted]");
462
+ (0, bun_test_1.expect)(apiError.message).not.toContain("patient 12345");
463
+ return [2 /*return*/];
464
+ }
465
+ });
466
+ }); });
467
+ (0, bun_test_1.it)("falls back to a generic detail when redactError strips all messages", function () { return __awaiter(void 0, void 0, void 0, function () {
468
+ var logger, caught, error_7;
469
+ return __generator(this, function (_a) {
470
+ switch (_a.label) {
471
+ case 0:
472
+ logger = createRecordingLogger().logger;
473
+ _a.label = 1;
474
+ case 1:
475
+ _a.trys.push([1, 3, , 4]);
476
+ return [4 /*yield*/, (0, httpClient_1.withApiErrorHandling)(function () { return __awaiter(void 0, void 0, void 0, function () {
477
+ return __generator(this, function (_a) {
478
+ throw buildAxiosError({ data: { message: "sensitive" }, status: 404 });
479
+ });
480
+ }); }, __assign(__assign({}, CONTEXT), { logger: logger, redactError: function (normalized) { return (__assign(__assign({}, normalized), { messages: [] })); }, rethrowAs: "apiError" }))];
481
+ case 2:
482
+ _a.sent();
483
+ return [3 /*break*/, 4];
484
+ case 3:
485
+ error_7 = _a.sent();
486
+ caught = error_7;
487
+ return [3 /*break*/, 4];
488
+ case 4:
489
+ (0, bun_test_1.expect)(caught.detail).toBe("unknown error");
490
+ return [2 /*return*/];
491
+ }
492
+ });
493
+ }); });
494
+ });
495
+ (0, bun_test_1.describe)("createAuthenticatedClient", function () {
496
+ (0, bun_test_1.describe)("bearer strategy", function () {
497
+ (0, bun_test_1.it)("attaches the Authorization header and caches the token across requests", function () { return __awaiter(void 0, void 0, void 0, function () {
498
+ var seenAuthHeaders, server, tokenFetches_1, client;
499
+ return __generator(this, function (_a) {
500
+ switch (_a.label) {
501
+ case 0:
502
+ seenAuthHeaders = [];
503
+ return [4 /*yield*/, startTestServer(function (app) {
504
+ app.get("/widgets", function (req, res) {
505
+ seenAuthHeaders.push(req.headers.authorization);
506
+ res.json({ ok: true });
507
+ });
508
+ })];
509
+ case 1:
510
+ server = _a.sent();
511
+ _a.label = 2;
512
+ case 2:
513
+ _a.trys.push([2, , 5, 7]);
514
+ tokenFetches_1 = 0;
515
+ client = (0, httpClient_1.createAuthenticatedClient)({
516
+ auth: {
517
+ getToken: function () { return __awaiter(void 0, void 0, void 0, function () {
518
+ return __generator(this, function (_a) {
519
+ tokenFetches_1 += 1;
520
+ return [2 /*return*/, "token-abc"];
521
+ });
522
+ }); },
523
+ type: "bearer",
524
+ },
525
+ baseURL: server.baseURL,
526
+ });
527
+ return [4 /*yield*/, client.axios.get("/widgets")];
528
+ case 3:
529
+ _a.sent();
530
+ return [4 /*yield*/, client.axios.get("/widgets")];
531
+ case 4:
532
+ _a.sent();
533
+ (0, bun_test_1.expect)(seenAuthHeaders).toEqual(["Bearer token-abc", "Bearer token-abc"]);
534
+ (0, bun_test_1.expect)(tokenFetches_1).toBe(1);
535
+ return [3 /*break*/, 7];
536
+ case 5: return [4 /*yield*/, server.close()];
537
+ case 6:
538
+ _a.sent();
539
+ return [7 /*endfinally*/];
540
+ case 7: return [2 /*return*/];
541
+ }
542
+ });
543
+ }); });
544
+ (0, bun_test_1.it)("re-fetches the token after invalidateToken", function () { return __awaiter(void 0, void 0, void 0, function () {
545
+ var server, tokenFetches_2, client;
546
+ return __generator(this, function (_a) {
547
+ switch (_a.label) {
548
+ case 0: return [4 /*yield*/, startTestServer(function (app) {
549
+ app.get("/widgets", function (_req, res) {
550
+ res.json({ ok: true });
551
+ });
552
+ })];
553
+ case 1:
554
+ server = _a.sent();
555
+ _a.label = 2;
556
+ case 2:
557
+ _a.trys.push([2, , 5, 7]);
558
+ tokenFetches_2 = 0;
559
+ client = (0, httpClient_1.createAuthenticatedClient)({
560
+ auth: {
561
+ getToken: function () { return __awaiter(void 0, void 0, void 0, function () {
562
+ return __generator(this, function (_a) {
563
+ tokenFetches_2 += 1;
564
+ return [2 /*return*/, "token-".concat(tokenFetches_2)];
565
+ });
566
+ }); },
567
+ type: "bearer",
568
+ },
569
+ baseURL: server.baseURL,
570
+ });
571
+ return [4 /*yield*/, client.axios.get("/widgets")];
572
+ case 3:
573
+ _a.sent();
574
+ client.invalidateToken();
575
+ return [4 /*yield*/, client.axios.get("/widgets")];
576
+ case 4:
577
+ _a.sent();
578
+ (0, bun_test_1.expect)(tokenFetches_2).toBe(2);
579
+ return [3 /*break*/, 7];
580
+ case 5: return [4 /*yield*/, server.close()];
581
+ case 6:
582
+ _a.sent();
583
+ return [7 /*endfinally*/];
584
+ case 7: return [2 /*return*/];
585
+ }
586
+ });
587
+ }); });
588
+ });
589
+ (0, bun_test_1.describe)("apiKey strategy", function () {
590
+ (0, bun_test_1.it)("attaches the key to the configured header", function () { return __awaiter(void 0, void 0, void 0, function () {
591
+ var seenKeys, server, client;
592
+ return __generator(this, function (_a) {
593
+ switch (_a.label) {
594
+ case 0:
595
+ seenKeys = [];
596
+ return [4 /*yield*/, startTestServer(function (app) {
597
+ app.get("/widgets", function (req, res) {
598
+ seenKeys.push(req.headers["x-api-key"]);
599
+ res.json({ ok: true });
600
+ });
601
+ })];
602
+ case 1:
603
+ server = _a.sent();
604
+ _a.label = 2;
605
+ case 2:
606
+ _a.trys.push([2, , 4, 6]);
607
+ client = (0, httpClient_1.createAuthenticatedClient)({
608
+ auth: { getKey: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
609
+ return [2 /*return*/, "secret-key"];
610
+ }); }); }, header: "X-Api-Key", type: "apiKey" },
611
+ baseURL: server.baseURL,
612
+ });
613
+ return [4 /*yield*/, client.axios.get("/widgets")];
614
+ case 3:
615
+ _a.sent();
616
+ (0, bun_test_1.expect)(seenKeys).toEqual(["secret-key"]);
617
+ return [3 /*break*/, 6];
618
+ case 4: return [4 /*yield*/, server.close()];
619
+ case 5:
620
+ _a.sent();
621
+ return [7 /*endfinally*/];
622
+ case 6: return [2 /*return*/];
623
+ }
624
+ });
625
+ }); });
626
+ });
627
+ (0, bun_test_1.describe)("oauth2 strategy", function () {
628
+ var configureOauthServer = function (app, state) {
629
+ app.post("/oauth/token", function (req, res) {
630
+ var _a;
631
+ state.tokenFetches += 1;
632
+ var authHeader = (_a = req.headers.authorization) !== null && _a !== void 0 ? _a : "";
633
+ var decoded = Buffer.from(authHeader.replace("Basic ", ""), "base64").toString();
634
+ if (decoded !== "client-id:client-secret" || req.body.grant_type !== "client_credentials") {
635
+ res.status(400).json({ message: "bad token request" });
636
+ return;
637
+ }
638
+ res.json({ access_token: state.validToken });
639
+ });
640
+ };
641
+ (0, bun_test_1.it)("fetches a client-credentials token and sends it as a bearer", function () { return __awaiter(void 0, void 0, void 0, function () {
642
+ var state, seenAuthHeaders, server, client;
643
+ return __generator(this, function (_a) {
644
+ switch (_a.label) {
645
+ case 0:
646
+ state = { tokenFetches: 0, validToken: "oauth-token-1" };
647
+ seenAuthHeaders = [];
648
+ return [4 /*yield*/, startTestServer(function (app) {
649
+ configureOauthServer(app, state);
650
+ app.get("/widgets", function (req, res) {
651
+ seenAuthHeaders.push(req.headers.authorization);
652
+ res.json({ ok: true });
653
+ });
654
+ })];
655
+ case 1:
656
+ server = _a.sent();
657
+ _a.label = 2;
658
+ case 2:
659
+ _a.trys.push([2, , 5, 7]);
660
+ client = (0, httpClient_1.createAuthenticatedClient)({
661
+ auth: {
662
+ credentials: { clientId: "client-id", clientSecret: "client-secret" },
663
+ refreshOn401: true,
664
+ tokenUrl: "".concat(server.baseURL, "/oauth/token"),
665
+ type: "oauth2",
666
+ },
667
+ baseURL: server.baseURL,
668
+ });
669
+ return [4 /*yield*/, client.axios.get("/widgets")];
670
+ case 3:
671
+ _a.sent();
672
+ return [4 /*yield*/, client.axios.get("/widgets")];
673
+ case 4:
674
+ _a.sent();
675
+ (0, bun_test_1.expect)(seenAuthHeaders).toEqual(["Bearer oauth-token-1", "Bearer oauth-token-1"]);
676
+ (0, bun_test_1.expect)(state.tokenFetches).toBe(1);
677
+ return [3 /*break*/, 7];
678
+ case 5: return [4 /*yield*/, server.close()];
679
+ case 6:
680
+ _a.sent();
681
+ return [7 /*endfinally*/];
682
+ case 7: return [2 /*return*/];
683
+ }
684
+ });
685
+ }); });
686
+ (0, bun_test_1.it)("refreshes the token and retries exactly once on a 401", function () { return __awaiter(void 0, void 0, void 0, function () {
687
+ var state, server, client, response;
688
+ return __generator(this, function (_a) {
689
+ switch (_a.label) {
690
+ case 0:
691
+ state = { tokenFetches: 0, validToken: "stale-token" };
692
+ return [4 /*yield*/, startTestServer(function (app) {
693
+ configureOauthServer(app, state);
694
+ app.get("/widgets", function (req, res) {
695
+ if (req.headers.authorization === "Bearer fresh-token") {
696
+ res.json({ ok: true });
697
+ return;
698
+ }
699
+ // Invalidate the stale token server-side so the refresh fetches a good one.
700
+ state.validToken = "fresh-token";
701
+ res.status(401).json({ message: "expired" });
702
+ });
703
+ })];
704
+ case 1:
705
+ server = _a.sent();
706
+ _a.label = 2;
707
+ case 2:
708
+ _a.trys.push([2, , 4, 6]);
709
+ client = (0, httpClient_1.createAuthenticatedClient)({
710
+ auth: {
711
+ credentials: { clientId: "client-id", clientSecret: "client-secret" },
712
+ refreshOn401: true,
713
+ tokenUrl: "".concat(server.baseURL, "/oauth/token"),
714
+ type: "oauth2",
715
+ },
716
+ baseURL: server.baseURL,
717
+ });
718
+ return [4 /*yield*/, client.axios.get("/widgets")];
719
+ case 3:
720
+ response = _a.sent();
721
+ (0, bun_test_1.expect)(response.data.ok).toBe(true);
722
+ (0, bun_test_1.expect)(state.tokenFetches).toBe(2);
723
+ return [3 /*break*/, 6];
724
+ case 4: return [4 /*yield*/, server.close()];
725
+ case 5:
726
+ _a.sent();
727
+ return [7 /*endfinally*/];
728
+ case 6: return [2 /*return*/];
729
+ }
730
+ });
731
+ }); });
732
+ (0, bun_test_1.it)("propagates a persistent 401 after a single refresh attempt", function () { return __awaiter(void 0, void 0, void 0, function () {
733
+ var state, widgetRequests, server, client, caught, error_8;
734
+ var _a;
735
+ return __generator(this, function (_b) {
736
+ switch (_b.label) {
737
+ case 0:
738
+ state = { tokenFetches: 0, validToken: "always-stale" };
739
+ widgetRequests = 0;
740
+ return [4 /*yield*/, startTestServer(function (app) {
741
+ configureOauthServer(app, state);
742
+ app.get("/widgets", function (_req, res) {
743
+ widgetRequests += 1;
744
+ res.status(401).json({ message: "still expired" });
745
+ });
746
+ })];
747
+ case 1:
748
+ server = _b.sent();
749
+ _b.label = 2;
750
+ case 2:
751
+ _b.trys.push([2, , 7, 9]);
752
+ client = (0, httpClient_1.createAuthenticatedClient)({
753
+ auth: {
754
+ credentials: { clientId: "client-id", clientSecret: "client-secret" },
755
+ refreshOn401: true,
756
+ tokenUrl: "".concat(server.baseURL, "/oauth/token"),
757
+ type: "oauth2",
758
+ },
759
+ baseURL: server.baseURL,
760
+ });
761
+ caught = void 0;
762
+ _b.label = 3;
763
+ case 3:
764
+ _b.trys.push([3, 5, , 6]);
765
+ return [4 /*yield*/, client.axios.get("/widgets")];
766
+ case 4:
767
+ _b.sent();
768
+ return [3 /*break*/, 6];
769
+ case 5:
770
+ error_8 = _b.sent();
771
+ caught = error_8;
772
+ return [3 /*break*/, 6];
773
+ case 6:
774
+ (0, bun_test_1.expect)((0, axios_1.isAxiosError)(caught)).toBe(true);
775
+ (0, bun_test_1.expect)((_a = caught.response) === null || _a === void 0 ? void 0 : _a.status).toBe(401);
776
+ (0, bun_test_1.expect)(widgetRequests).toBe(2);
777
+ (0, bun_test_1.expect)(state.tokenFetches).toBe(2);
778
+ return [3 /*break*/, 9];
779
+ case 7: return [4 /*yield*/, server.close()];
780
+ case 8:
781
+ _b.sent();
782
+ return [7 /*endfinally*/];
783
+ case 9: return [2 /*return*/];
784
+ }
785
+ });
786
+ }); });
787
+ });
788
+ (0, bun_test_1.describe)("retry policy", function () {
789
+ var NO_AUTH = { getToken: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
790
+ return [2 /*return*/, "t"];
791
+ }); }); }, type: "bearer" };
792
+ (0, bun_test_1.it)("retries an idempotent GET on 5xx and succeeds within maxAttempts", function () { return __awaiter(void 0, void 0, void 0, function () {
793
+ var attempts, server, client, response;
794
+ return __generator(this, function (_a) {
795
+ switch (_a.label) {
796
+ case 0:
797
+ attempts = 0;
798
+ return [4 /*yield*/, startTestServer(function (app) {
799
+ app.get("/flaky", function (_req, res) {
800
+ attempts += 1;
801
+ if (attempts < 3) {
802
+ res.status(500).json({ message: "boom" });
803
+ return;
804
+ }
805
+ res.json({ ok: true });
806
+ });
807
+ })];
808
+ case 1:
809
+ server = _a.sent();
810
+ _a.label = 2;
811
+ case 2:
812
+ _a.trys.push([2, , 4, 6]);
813
+ client = (0, httpClient_1.createAuthenticatedClient)({
814
+ auth: NO_AUTH,
815
+ baseURL: server.baseURL,
816
+ retry: FAST_RETRY,
817
+ });
818
+ return [4 /*yield*/, client.axios.get("/flaky")];
819
+ case 3:
820
+ response = _a.sent();
821
+ (0, bun_test_1.expect)(response.data.ok).toBe(true);
822
+ (0, bun_test_1.expect)(attempts).toBe(3);
823
+ return [3 /*break*/, 6];
824
+ case 4: return [4 /*yield*/, server.close()];
825
+ case 5:
826
+ _a.sent();
827
+ return [7 /*endfinally*/];
828
+ case 6: return [2 /*return*/];
829
+ }
830
+ });
831
+ }); });
832
+ (0, bun_test_1.it)("retries a GET on 429 rate limiting", function () { return __awaiter(void 0, void 0, void 0, function () {
833
+ var attempts, server, client, response;
834
+ return __generator(this, function (_a) {
835
+ switch (_a.label) {
836
+ case 0:
837
+ attempts = 0;
838
+ return [4 /*yield*/, startTestServer(function (app) {
839
+ app.get("/limited", function (_req, res) {
840
+ attempts += 1;
841
+ if (attempts === 1) {
842
+ res.set("Retry-After", "0").status(429).json({ message: "slow down" });
843
+ return;
844
+ }
845
+ res.json({ ok: true });
846
+ });
847
+ })];
848
+ case 1:
849
+ server = _a.sent();
850
+ _a.label = 2;
851
+ case 2:
852
+ _a.trys.push([2, , 4, 6]);
853
+ client = (0, httpClient_1.createAuthenticatedClient)({
854
+ auth: NO_AUTH,
855
+ baseURL: server.baseURL,
856
+ retry: FAST_RETRY,
857
+ });
858
+ return [4 /*yield*/, client.axios.get("/limited")];
859
+ case 3:
860
+ response = _a.sent();
861
+ (0, bun_test_1.expect)(response.data.ok).toBe(true);
862
+ (0, bun_test_1.expect)(attempts).toBe(2);
863
+ return [3 /*break*/, 6];
864
+ case 4: return [4 /*yield*/, server.close()];
865
+ case 5:
866
+ _a.sent();
867
+ return [7 /*endfinally*/];
868
+ case 6: return [2 /*return*/];
869
+ }
870
+ });
871
+ }); });
872
+ (0, bun_test_1.it)("rejects with the original error once maxAttempts is exhausted", function () { return __awaiter(void 0, void 0, void 0, function () {
873
+ var attempts, server, client, caught, error_9;
874
+ var _a;
875
+ return __generator(this, function (_b) {
876
+ switch (_b.label) {
877
+ case 0:
878
+ attempts = 0;
879
+ return [4 /*yield*/, startTestServer(function (app) {
880
+ app.get("/down", function (_req, res) {
881
+ attempts += 1;
882
+ res.status(503).json({ message: "unavailable" });
883
+ });
884
+ })];
885
+ case 1:
886
+ server = _b.sent();
887
+ _b.label = 2;
888
+ case 2:
889
+ _b.trys.push([2, , 7, 9]);
890
+ client = (0, httpClient_1.createAuthenticatedClient)({
891
+ auth: NO_AUTH,
892
+ baseURL: server.baseURL,
893
+ retry: __assign(__assign({}, FAST_RETRY), { maxAttempts: 2 }),
894
+ });
895
+ caught = void 0;
896
+ _b.label = 3;
897
+ case 3:
898
+ _b.trys.push([3, 5, , 6]);
899
+ return [4 /*yield*/, client.axios.get("/down")];
900
+ case 4:
901
+ _b.sent();
902
+ return [3 /*break*/, 6];
903
+ case 5:
904
+ error_9 = _b.sent();
905
+ caught = error_9;
906
+ return [3 /*break*/, 6];
907
+ case 6:
908
+ (0, bun_test_1.expect)((0, axios_1.isAxiosError)(caught)).toBe(true);
909
+ (0, bun_test_1.expect)((_a = caught.response) === null || _a === void 0 ? void 0 : _a.status).toBe(503);
910
+ (0, bun_test_1.expect)(attempts).toBe(2);
911
+ return [3 /*break*/, 9];
912
+ case 7: return [4 /*yield*/, server.close()];
913
+ case 8:
914
+ _b.sent();
915
+ return [7 /*endfinally*/];
916
+ case 9: return [2 /*return*/];
917
+ }
918
+ });
919
+ }); });
920
+ (0, bun_test_1.it)("does not retry a POST by default even on 5xx", function () { return __awaiter(void 0, void 0, void 0, function () {
921
+ var attempts, server, client, caught, error_10;
922
+ return __generator(this, function (_a) {
923
+ switch (_a.label) {
924
+ case 0:
925
+ attempts = 0;
926
+ return [4 /*yield*/, startTestServer(function (app) {
927
+ app.post("/orders", function (_req, res) {
928
+ attempts += 1;
929
+ res.status(500).json({ message: "boom" });
930
+ });
931
+ })];
932
+ case 1:
933
+ server = _a.sent();
934
+ _a.label = 2;
935
+ case 2:
936
+ _a.trys.push([2, , 7, 9]);
937
+ client = (0, httpClient_1.createAuthenticatedClient)({
938
+ auth: NO_AUTH,
939
+ baseURL: server.baseURL,
940
+ retry: FAST_RETRY,
941
+ });
942
+ caught = void 0;
943
+ _a.label = 3;
944
+ case 3:
945
+ _a.trys.push([3, 5, , 6]);
946
+ return [4 /*yield*/, client.axios.post("/orders", { widget: 1 })];
947
+ case 4:
948
+ _a.sent();
949
+ return [3 /*break*/, 6];
950
+ case 5:
951
+ error_10 = _a.sent();
952
+ caught = error_10;
953
+ return [3 /*break*/, 6];
954
+ case 6:
955
+ (0, bun_test_1.expect)((0, axios_1.isAxiosError)(caught)).toBe(true);
956
+ (0, bun_test_1.expect)(attempts).toBe(1);
957
+ return [3 /*break*/, 9];
958
+ case 7: return [4 /*yield*/, server.close()];
959
+ case 8:
960
+ _a.sent();
961
+ return [7 /*endfinally*/];
962
+ case 9: return [2 /*return*/];
963
+ }
964
+ });
965
+ }); });
966
+ (0, bun_test_1.it)("retries a POST when the request opts in via markRetryUnsafe, preserving config", function () { return __awaiter(void 0, void 0, void 0, function () {
967
+ var attempts, seenTestHeaders, server, client, response;
968
+ return __generator(this, function (_a) {
969
+ switch (_a.label) {
970
+ case 0:
971
+ attempts = 0;
972
+ seenTestHeaders = [];
973
+ return [4 /*yield*/, startTestServer(function (app) {
974
+ app.post("/orders", function (req, res) {
975
+ attempts += 1;
976
+ seenTestHeaders.push(req.headers["x-test"]);
977
+ if (attempts === 1) {
978
+ res.status(500).json({ message: "boom" });
979
+ return;
980
+ }
981
+ res.json({ ok: true });
982
+ });
983
+ })];
984
+ case 1:
985
+ server = _a.sent();
986
+ _a.label = 2;
987
+ case 2:
988
+ _a.trys.push([2, , 4, 6]);
989
+ client = (0, httpClient_1.createAuthenticatedClient)({
990
+ auth: NO_AUTH,
991
+ baseURL: server.baseURL,
992
+ retry: FAST_RETRY,
993
+ });
994
+ return [4 /*yield*/, client.axios.post("/orders", { widget: 1 }, (0, httpClient_1.markRetryUnsafe)({ headers: { "X-Test": "kept" } }))];
995
+ case 3:
996
+ response = _a.sent();
997
+ (0, bun_test_1.expect)(response.data.ok).toBe(true);
998
+ (0, bun_test_1.expect)(attempts).toBe(2);
999
+ (0, bun_test_1.expect)(seenTestHeaders).toEqual(["kept", "kept"]);
1000
+ return [3 /*break*/, 6];
1001
+ case 4: return [4 /*yield*/, server.close()];
1002
+ case 5:
1003
+ _a.sent();
1004
+ return [7 /*endfinally*/];
1005
+ case 6: return [2 /*return*/];
1006
+ }
1007
+ });
1008
+ }); });
1009
+ (0, bun_test_1.it)("does not retry non-retryable classifications like validation errors", function () { return __awaiter(void 0, void 0, void 0, function () {
1010
+ var attempts, server, client, caught, error_11;
1011
+ var _a;
1012
+ return __generator(this, function (_b) {
1013
+ switch (_b.label) {
1014
+ case 0:
1015
+ attempts = 0;
1016
+ return [4 /*yield*/, startTestServer(function (app) {
1017
+ app.get("/bad", function (_req, res) {
1018
+ attempts += 1;
1019
+ res.status(400).json({ message: "bad request" });
1020
+ });
1021
+ })];
1022
+ case 1:
1023
+ server = _b.sent();
1024
+ _b.label = 2;
1025
+ case 2:
1026
+ _b.trys.push([2, , 7, 9]);
1027
+ client = (0, httpClient_1.createAuthenticatedClient)({
1028
+ auth: NO_AUTH,
1029
+ baseURL: server.baseURL,
1030
+ retry: FAST_RETRY,
1031
+ });
1032
+ caught = void 0;
1033
+ _b.label = 3;
1034
+ case 3:
1035
+ _b.trys.push([3, 5, , 6]);
1036
+ return [4 /*yield*/, client.axios.get("/bad")];
1037
+ case 4:
1038
+ _b.sent();
1039
+ return [3 /*break*/, 6];
1040
+ case 5:
1041
+ error_11 = _b.sent();
1042
+ caught = error_11;
1043
+ return [3 /*break*/, 6];
1044
+ case 6:
1045
+ (0, bun_test_1.expect)((_a = caught.response) === null || _a === void 0 ? void 0 : _a.status).toBe(400);
1046
+ (0, bun_test_1.expect)(attempts).toBe(1);
1047
+ return [3 /*break*/, 9];
1048
+ case 7: return [4 /*yield*/, server.close()];
1049
+ case 8:
1050
+ _b.sent();
1051
+ return [7 /*endfinally*/];
1052
+ case 9: return [2 /*return*/];
1053
+ }
1054
+ });
1055
+ }); });
1056
+ });
1057
+ });
1058
+ (0, bun_test_1.describe)("createAuthenticatedClient hardening", function () {
1059
+ (0, bun_test_1.it)("rejects without looping when the oauth2 token endpoint itself returns 401", function () { return __awaiter(void 0, void 0, void 0, function () {
1060
+ var tokenRequests, server, client, caught, error_12;
1061
+ return __generator(this, function (_a) {
1062
+ switch (_a.label) {
1063
+ case 0:
1064
+ tokenRequests = 0;
1065
+ return [4 /*yield*/, startTestServer(function (app) {
1066
+ app.post("/oauth/token", function (_req, res) {
1067
+ tokenRequests += 1;
1068
+ res.status(401).json({ message: "invalid client credentials" });
1069
+ });
1070
+ app.get("/widgets", function (_req, res) {
1071
+ res.json({ ok: true });
1072
+ });
1073
+ })];
1074
+ case 1:
1075
+ server = _a.sent();
1076
+ _a.label = 2;
1077
+ case 2:
1078
+ _a.trys.push([2, , 7, 9]);
1079
+ client = (0, httpClient_1.createAuthenticatedClient)({
1080
+ auth: {
1081
+ credentials: { clientId: "bad", clientSecret: "creds" },
1082
+ refreshOn401: true,
1083
+ tokenUrl: "".concat(server.baseURL, "/oauth/token"),
1084
+ type: "oauth2",
1085
+ },
1086
+ baseURL: server.baseURL,
1087
+ });
1088
+ caught = void 0;
1089
+ _a.label = 3;
1090
+ case 3:
1091
+ _a.trys.push([3, 5, , 6]);
1092
+ return [4 /*yield*/, client.axios.get("/widgets")];
1093
+ case 4:
1094
+ _a.sent();
1095
+ return [3 /*break*/, 6];
1096
+ case 5:
1097
+ error_12 = _a.sent();
1098
+ caught = error_12;
1099
+ return [3 /*break*/, 6];
1100
+ case 6:
1101
+ (0, bun_test_1.expect)(caught).toBeInstanceOf(Error);
1102
+ (0, bun_test_1.expect)(caught.message).toContain("token fetch");
1103
+ (0, bun_test_1.expect)(tokenRequests).toBe(1);
1104
+ return [3 /*break*/, 9];
1105
+ case 7: return [4 /*yield*/, server.close()];
1106
+ case 8:
1107
+ _a.sent();
1108
+ return [7 /*endfinally*/];
1109
+ case 9: return [2 /*return*/];
1110
+ }
1111
+ });
1112
+ }); });
1113
+ (0, bun_test_1.it)("rejects clearly when the token response has no access_token", function () { return __awaiter(void 0, void 0, void 0, function () {
1114
+ var server, client, caught, error_13;
1115
+ return __generator(this, function (_a) {
1116
+ switch (_a.label) {
1117
+ case 0: return [4 /*yield*/, startTestServer(function (app) {
1118
+ app.post("/oauth/token", function (_req, res) {
1119
+ res.json({ unexpected: "shape" });
1120
+ });
1121
+ })];
1122
+ case 1:
1123
+ server = _a.sent();
1124
+ _a.label = 2;
1125
+ case 2:
1126
+ _a.trys.push([2, , 7, 9]);
1127
+ client = (0, httpClient_1.createAuthenticatedClient)({
1128
+ auth: {
1129
+ credentials: { clientId: "client-id", clientSecret: "client-secret" },
1130
+ refreshOn401: true,
1131
+ tokenUrl: "".concat(server.baseURL, "/oauth/token"),
1132
+ type: "oauth2",
1133
+ },
1134
+ baseURL: server.baseURL,
1135
+ });
1136
+ caught = void 0;
1137
+ _a.label = 3;
1138
+ case 3:
1139
+ _a.trys.push([3, 5, , 6]);
1140
+ return [4 /*yield*/, client.axios.get("/widgets")];
1141
+ case 4:
1142
+ _a.sent();
1143
+ return [3 /*break*/, 6];
1144
+ case 5:
1145
+ error_13 = _a.sent();
1146
+ caught = error_13;
1147
+ return [3 /*break*/, 6];
1148
+ case 6:
1149
+ (0, bun_test_1.expect)(caught.message).toContain("access_token");
1150
+ return [3 /*break*/, 9];
1151
+ case 7: return [4 /*yield*/, server.close()];
1152
+ case 8:
1153
+ _a.sent();
1154
+ return [7 /*endfinally*/];
1155
+ case 9: return [2 /*return*/];
1156
+ }
1157
+ });
1158
+ }); });
1159
+ (0, bun_test_1.it)("shares a single token fetch across concurrent first requests", function () { return __awaiter(void 0, void 0, void 0, function () {
1160
+ var server, tokenFetches_3, client;
1161
+ return __generator(this, function (_a) {
1162
+ switch (_a.label) {
1163
+ case 0: return [4 /*yield*/, startTestServer(function (app) {
1164
+ app.get("/widgets", function (_req, res) {
1165
+ res.json({ ok: true });
1166
+ });
1167
+ })];
1168
+ case 1:
1169
+ server = _a.sent();
1170
+ _a.label = 2;
1171
+ case 2:
1172
+ _a.trys.push([2, , 4, 6]);
1173
+ tokenFetches_3 = 0;
1174
+ client = (0, httpClient_1.createAuthenticatedClient)({
1175
+ auth: {
1176
+ getToken: function () { return __awaiter(void 0, void 0, void 0, function () {
1177
+ return __generator(this, function (_a) {
1178
+ switch (_a.label) {
1179
+ case 0:
1180
+ tokenFetches_3 += 1;
1181
+ return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, 5); })];
1182
+ case 1:
1183
+ _a.sent();
1184
+ return [2 /*return*/, "token-shared"];
1185
+ }
1186
+ });
1187
+ }); },
1188
+ type: "bearer",
1189
+ },
1190
+ baseURL: server.baseURL,
1191
+ });
1192
+ return [4 /*yield*/, Promise.all([client.axios.get("/widgets"), client.axios.get("/widgets")])];
1193
+ case 3:
1194
+ _a.sent();
1195
+ (0, bun_test_1.expect)(tokenFetches_3).toBe(1);
1196
+ return [3 /*break*/, 6];
1197
+ case 4: return [4 /*yield*/, server.close()];
1198
+ case 5:
1199
+ _a.sent();
1200
+ return [7 /*endfinally*/];
1201
+ case 6: return [2 /*return*/];
1202
+ }
1203
+ });
1204
+ }); });
1205
+ (0, bun_test_1.it)("retries network errors and logs the retry attempts", function () { return __awaiter(void 0, void 0, void 0, function () {
1206
+ var server, baseURL, _a, logger, entries, client, caught, error_14, retryLogs;
1207
+ return __generator(this, function (_b) {
1208
+ switch (_b.label) {
1209
+ case 0: return [4 /*yield*/, startTestServer(function () { })];
1210
+ case 1:
1211
+ server = _b.sent();
1212
+ baseURL = server.baseURL;
1213
+ return [4 /*yield*/, server.close()];
1214
+ case 2:
1215
+ _b.sent();
1216
+ _a = createRecordingLogger(), logger = _a.logger, entries = _a.entries;
1217
+ client = (0, httpClient_1.createAuthenticatedClient)({
1218
+ auth: { getToken: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
1219
+ return [2 /*return*/, "t"];
1220
+ }); }); }, type: "bearer" },
1221
+ baseURL: baseURL,
1222
+ logger: logger,
1223
+ retry: { baseDelayMs: 1, maxAttempts: 2 },
1224
+ });
1225
+ _b.label = 3;
1226
+ case 3:
1227
+ _b.trys.push([3, 5, , 6]);
1228
+ return [4 /*yield*/, client.axios.get("/gone")];
1229
+ case 4:
1230
+ _b.sent();
1231
+ return [3 /*break*/, 6];
1232
+ case 5:
1233
+ error_14 = _b.sent();
1234
+ caught = error_14;
1235
+ return [3 /*break*/, 6];
1236
+ case 6:
1237
+ (0, bun_test_1.expect)((0, axios_1.isAxiosError)(caught)).toBe(true);
1238
+ retryLogs = entries.filter(function (entry) { return entry.msg.includes("retrying attempt"); });
1239
+ (0, bun_test_1.expect)(retryLogs).toHaveLength(1);
1240
+ (0, bun_test_1.expect)(retryLogs[0].msg).toContain("attempt 2/2");
1241
+ (0, bun_test_1.expect)(retryLogs[0].msg).toContain("network");
1242
+ return [2 /*return*/];
1243
+ }
1244
+ });
1245
+ }); });
1246
+ (0, bun_test_1.it)("prefers a numeric Retry-After header over backoff", function () { return __awaiter(void 0, void 0, void 0, function () {
1247
+ var attempts, server, _a, logger, entries, client, retryLog;
1248
+ return __generator(this, function (_b) {
1249
+ switch (_b.label) {
1250
+ case 0:
1251
+ attempts = 0;
1252
+ return [4 /*yield*/, startTestServer(function (app) {
1253
+ app.get("/limited", function (_req, res) {
1254
+ attempts += 1;
1255
+ if (attempts === 1) {
1256
+ res.set("Retry-After", "0").status(429).json({ message: "slow down" });
1257
+ return;
1258
+ }
1259
+ res.json({ ok: true });
1260
+ });
1261
+ })];
1262
+ case 1:
1263
+ server = _b.sent();
1264
+ _b.label = 2;
1265
+ case 2:
1266
+ _b.trys.push([2, , 4, 6]);
1267
+ _a = createRecordingLogger(), logger = _a.logger, entries = _a.entries;
1268
+ client = (0, httpClient_1.createAuthenticatedClient)({
1269
+ auth: { getToken: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
1270
+ return [2 /*return*/, "t"];
1271
+ }); }); }, type: "bearer" },
1272
+ baseURL: server.baseURL,
1273
+ logger: logger,
1274
+ // A base delay far above the Retry-After value: if backoff were used the log
1275
+ // would show >=100ms, so "in 0ms" proves the header took precedence.
1276
+ retry: { baseDelayMs: 100 },
1277
+ });
1278
+ return [4 /*yield*/, client.axios.get("/limited")];
1279
+ case 3:
1280
+ _b.sent();
1281
+ retryLog = entries.find(function (entry) { return entry.msg.includes("retrying attempt"); });
1282
+ (0, bun_test_1.expect)(retryLog === null || retryLog === void 0 ? void 0 : retryLog.msg).toContain("in 0ms");
1283
+ return [3 /*break*/, 6];
1284
+ case 4: return [4 /*yield*/, server.close()];
1285
+ case 5:
1286
+ _b.sent();
1287
+ return [7 /*endfinally*/];
1288
+ case 6: return [2 /*return*/];
1289
+ }
1290
+ });
1291
+ }); });
1292
+ (0, bun_test_1.it)("falls back to backoff for a non-numeric Retry-After header", function () { return __awaiter(void 0, void 0, void 0, function () {
1293
+ var attempts, server, _a, logger, entries, client, retryLog;
1294
+ return __generator(this, function (_b) {
1295
+ switch (_b.label) {
1296
+ case 0:
1297
+ attempts = 0;
1298
+ return [4 /*yield*/, startTestServer(function (app) {
1299
+ app.get("/limited", function (_req, res) {
1300
+ attempts += 1;
1301
+ if (attempts === 1) {
1302
+ res
1303
+ .set("Retry-After", "Wed, 21 Oct 2015 07:28:00 GMT")
1304
+ .status(429)
1305
+ .json({ message: "slow down" });
1306
+ return;
1307
+ }
1308
+ res.json({ ok: true });
1309
+ });
1310
+ })];
1311
+ case 1:
1312
+ server = _b.sent();
1313
+ _b.label = 2;
1314
+ case 2:
1315
+ _b.trys.push([2, , 4, 6]);
1316
+ _a = createRecordingLogger(), logger = _a.logger, entries = _a.entries;
1317
+ client = (0, httpClient_1.createAuthenticatedClient)({
1318
+ auth: { getToken: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
1319
+ return [2 /*return*/, "t"];
1320
+ }); }); }, type: "bearer" },
1321
+ baseURL: server.baseURL,
1322
+ logger: logger,
1323
+ retry: FAST_RETRY,
1324
+ });
1325
+ return [4 /*yield*/, client.axios.get("/limited")];
1326
+ case 3:
1327
+ _b.sent();
1328
+ retryLog = entries.find(function (entry) { return entry.msg.includes("retrying attempt"); });
1329
+ (0, bun_test_1.expect)(retryLog === null || retryLog === void 0 ? void 0 : retryLog.msg).toMatch(/in [1-9]\d*ms/);
1330
+ return [3 /*break*/, 6];
1331
+ case 4: return [4 /*yield*/, server.close()];
1332
+ case 5:
1333
+ _b.sent();
1334
+ return [7 /*endfinally*/];
1335
+ case 6: return [2 /*return*/];
1336
+ }
1337
+ });
1338
+ }); });
1339
+ (0, bun_test_1.it)("caps an excessive Retry-After header at the delay ceiling", function () { return __awaiter(void 0, void 0, void 0, function () {
1340
+ var attempts, server, _a, logger, entries, client, retryLog;
1341
+ return __generator(this, function (_b) {
1342
+ switch (_b.label) {
1343
+ case 0:
1344
+ attempts = 0;
1345
+ return [4 /*yield*/, startTestServer(function (app) {
1346
+ app.get("/limited", function (_req, res) {
1347
+ attempts += 1;
1348
+ if (attempts === 1) {
1349
+ res.set("Retry-After", "3600").status(429).json({ message: "slow down" });
1350
+ return;
1351
+ }
1352
+ res.json({ ok: true });
1353
+ });
1354
+ })];
1355
+ case 1:
1356
+ server = _b.sent();
1357
+ _b.label = 2;
1358
+ case 2:
1359
+ _b.trys.push([2, , 4, 6]);
1360
+ _a = createRecordingLogger(), logger = _a.logger, entries = _a.entries;
1361
+ client = (0, httpClient_1.createAuthenticatedClient)({
1362
+ auth: { getToken: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
1363
+ return [2 /*return*/, "t"];
1364
+ }); }); }, type: "bearer" },
1365
+ baseURL: server.baseURL,
1366
+ logger: logger,
1367
+ retry: __assign(__assign({}, FAST_RETRY), { maxDelayMs: 2 }),
1368
+ });
1369
+ return [4 /*yield*/, client.axios.get("/limited")];
1370
+ case 3:
1371
+ _b.sent();
1372
+ retryLog = entries.find(function (entry) { return entry.msg.includes("retrying attempt"); });
1373
+ (0, bun_test_1.expect)(retryLog === null || retryLog === void 0 ? void 0 : retryLog.msg).toContain("in 2ms");
1374
+ return [3 /*break*/, 6];
1375
+ case 4: return [4 /*yield*/, server.close()];
1376
+ case 5:
1377
+ _b.sent();
1378
+ return [7 /*endfinally*/];
1379
+ case 6: return [2 /*return*/];
1380
+ }
1381
+ });
1382
+ }); });
1383
+ (0, bun_test_1.it)("honors a custom retryOn list", function () { return __awaiter(void 0, void 0, void 0, function () {
1384
+ var attempts, server, client, response;
1385
+ return __generator(this, function (_a) {
1386
+ switch (_a.label) {
1387
+ case 0:
1388
+ attempts = 0;
1389
+ return [4 /*yield*/, startTestServer(function (app) {
1390
+ app.get("/missing", function (_req, res) {
1391
+ attempts += 1;
1392
+ if (attempts === 1) {
1393
+ res.status(404).json({ message: "not here yet" });
1394
+ return;
1395
+ }
1396
+ res.json({ ok: true });
1397
+ });
1398
+ })];
1399
+ case 1:
1400
+ server = _a.sent();
1401
+ _a.label = 2;
1402
+ case 2:
1403
+ _a.trys.push([2, , 4, 6]);
1404
+ client = (0, httpClient_1.createAuthenticatedClient)({
1405
+ auth: { getToken: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
1406
+ return [2 /*return*/, "t"];
1407
+ }); }); }, type: "bearer" },
1408
+ baseURL: server.baseURL,
1409
+ retry: __assign(__assign({}, FAST_RETRY), { retryOn: ["notFound"] }),
1410
+ });
1411
+ return [4 /*yield*/, client.axios.get("/missing")];
1412
+ case 3:
1413
+ response = _a.sent();
1414
+ (0, bun_test_1.expect)(response.data.ok).toBe(true);
1415
+ (0, bun_test_1.expect)(attempts).toBe(2);
1416
+ return [3 /*break*/, 6];
1417
+ case 4: return [4 /*yield*/, server.close()];
1418
+ case 5:
1419
+ _a.sent();
1420
+ return [7 /*endfinally*/];
1421
+ case 6: return [2 /*return*/];
1422
+ }
1423
+ });
1424
+ }); });
1425
+ (0, bun_test_1.it)("uses the apiName option in normalized retry context instead of the baseURL", function () { return __awaiter(void 0, void 0, void 0, function () {
1426
+ var attempts, server, _a, logger, entries, client, retryLog;
1427
+ return __generator(this, function (_b) {
1428
+ switch (_b.label) {
1429
+ case 0:
1430
+ attempts = 0;
1431
+ return [4 /*yield*/, startTestServer(function (app) {
1432
+ app.get("/flaky", function (_req, res) {
1433
+ attempts += 1;
1434
+ if (attempts === 1) {
1435
+ res.status(500).json({ message: "boom" });
1436
+ return;
1437
+ }
1438
+ res.json({ ok: true });
1439
+ });
1440
+ })];
1441
+ case 1:
1442
+ server = _b.sent();
1443
+ _b.label = 2;
1444
+ case 2:
1445
+ _b.trys.push([2, , 4, 6]);
1446
+ _a = createRecordingLogger(), logger = _a.logger, entries = _a.entries;
1447
+ client = (0, httpClient_1.createAuthenticatedClient)({
1448
+ apiName: "widgetService",
1449
+ auth: { getToken: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
1450
+ return [2 /*return*/, "t"];
1451
+ }); }); }, type: "bearer" },
1452
+ baseURL: server.baseURL,
1453
+ logger: logger,
1454
+ retry: FAST_RETRY,
1455
+ });
1456
+ return [4 /*yield*/, client.axios.get("/flaky")];
1457
+ case 3:
1458
+ _b.sent();
1459
+ retryLog = entries.find(function (entry) { return entry.msg.includes("retrying attempt"); });
1460
+ (0, bun_test_1.expect)(retryLog === null || retryLog === void 0 ? void 0 : retryLog.msg).toContain("[widgetService]");
1461
+ return [3 /*break*/, 6];
1462
+ case 4: return [4 /*yield*/, server.close()];
1463
+ case 5:
1464
+ _b.sent();
1465
+ return [7 /*endfinally*/];
1466
+ case 6: return [2 /*return*/];
1467
+ }
1468
+ });
1469
+ }); });
1470
+ });