@terreno/api 0.26.0 → 0.28.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 (122) hide show
  1. package/dist/__tests__/openApiCompat.test.js +8 -2
  2. package/dist/actions.openApi.test.js +1 -0
  3. package/dist/actions.test.js +3 -1
  4. package/dist/api.arrayOperations.test.js +1 -0
  5. package/dist/api.coverage.test.d.ts +1 -0
  6. package/dist/api.coverage.test.js +193 -0
  7. package/dist/api.errorPaths.test.d.ts +1 -0
  8. package/dist/api.errorPaths.test.js +280 -0
  9. package/dist/api.errors.test.js +7 -7
  10. package/dist/api.hooks.test.js +66 -8
  11. package/dist/api.js +245 -206
  12. package/dist/api.query.test.js +1 -0
  13. package/dist/api.test.js +11 -4
  14. package/dist/auth.js +1 -0
  15. package/dist/auth.test.js +123 -1
  16. package/dist/betterAuthSetup.js +1 -0
  17. package/dist/betterAuthSetup.test.js +1 -0
  18. package/dist/config.js +7 -4
  19. package/dist/config.test.js +28 -3
  20. package/dist/configuration.test.js +1 -0
  21. package/dist/configurationApp.js +1 -0
  22. package/dist/configurationPlugin.test.js +80 -0
  23. package/dist/consentApp.test.js +1 -0
  24. package/dist/docLoader.js +16 -54
  25. package/dist/docLoader.test.js +2 -1
  26. package/dist/envConfigurationPlugin.js +1 -0
  27. package/dist/errors.d.ts +72 -5
  28. package/dist/errors.js +265 -67
  29. package/dist/errors.test.js +163 -13
  30. package/dist/example.js +3 -2
  31. package/dist/expressServer.test.js +1 -0
  32. package/dist/githubAuth.js +2 -0
  33. package/dist/githubAuth.test.js +1 -0
  34. package/dist/httpClient.d.ts +2 -3
  35. package/dist/httpClient.js +4 -4
  36. package/dist/httpClient.test.js +3 -2
  37. package/dist/logger.test.js +107 -0
  38. package/dist/notifiers/googleChatNotifier.test.js +2 -1
  39. package/dist/notifiers/slackNotifier.test.js +1 -1
  40. package/dist/notifiers/zoomNotifier.test.js +2 -1
  41. package/dist/openApi.test.js +1 -0
  42. package/dist/openApiBuilder.js +2 -1
  43. package/dist/openApiBuilder.test.js +3 -2
  44. package/dist/openApiValidator.js +1 -0
  45. package/dist/openApiValidator.test.js +41 -0
  46. package/dist/permissions.js +0 -2
  47. package/dist/permissions.middleware.test.js +8 -42
  48. package/dist/permissions.test.js +1 -0
  49. package/dist/plugins.js +8 -0
  50. package/dist/plugins.test.js +5 -2
  51. package/dist/populate.js +4 -2
  52. package/dist/populate.test.js +1 -0
  53. package/dist/realtime/realtime.test.js +13 -3
  54. package/dist/realtime/types.d.ts +1 -1
  55. package/dist/requestContext.test.js +28 -0
  56. package/dist/terrenoApp.js +1 -0
  57. package/dist/tests/createTestData.js +11 -6
  58. package/dist/tests/models.js +1 -0
  59. package/dist/transformers.js +4 -2
  60. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +3 -1
  61. package/package.json +7 -7
  62. package/src/__tests__/openApiCompat.test.ts +8 -2
  63. package/src/actions.openApi.test.ts +1 -0
  64. package/src/actions.test.ts +3 -1
  65. package/src/api.arrayOperations.test.ts +1 -0
  66. package/src/api.coverage.test.ts +123 -0
  67. package/src/api.errorPaths.test.ts +173 -0
  68. package/src/api.errors.test.ts +7 -7
  69. package/src/api.hooks.test.ts +25 -1
  70. package/src/api.query.test.ts +1 -0
  71. package/src/api.test.ts +11 -4
  72. package/src/api.ts +106 -57
  73. package/src/auth.test.ts +92 -3
  74. package/src/auth.ts +6 -0
  75. package/src/betterAuthSetup.test.ts +1 -0
  76. package/src/betterAuthSetup.ts +3 -0
  77. package/src/config.test.ts +25 -3
  78. package/src/config.ts +7 -4
  79. package/src/configuration.test.ts +1 -0
  80. package/src/configurationApp.ts +2 -0
  81. package/src/configurationPlugin.test.ts +46 -1
  82. package/src/consentApp.test.ts +1 -0
  83. package/src/docLoader.test.ts +2 -1
  84. package/src/docLoader.ts +17 -20
  85. package/src/envConfigurationPlugin.ts +2 -0
  86. package/src/errors.test.ts +178 -13
  87. package/src/errors.ts +278 -79
  88. package/src/example.ts +3 -2
  89. package/src/expressServer.test.ts +1 -0
  90. package/src/expressServer.ts +4 -2
  91. package/src/githubAuth.test.ts +1 -0
  92. package/src/githubAuth.ts +2 -0
  93. package/src/httpClient.test.ts +3 -2
  94. package/src/httpClient.ts +4 -4
  95. package/src/logger.test.ts +78 -0
  96. package/src/notifiers/googleChatNotifier.test.ts +2 -2
  97. package/src/notifiers/slackNotifier.test.ts +2 -2
  98. package/src/notifiers/zoomNotifier.test.ts +2 -2
  99. package/src/openApi.test.ts +1 -0
  100. package/src/openApiBuilder.test.ts +7 -6
  101. package/src/openApiBuilder.ts +2 -1
  102. package/src/openApiValidator.test.ts +64 -0
  103. package/src/openApiValidator.ts +1 -0
  104. package/src/permissions.middleware.test.ts +8 -11
  105. package/src/permissions.test.ts +1 -0
  106. package/src/permissions.ts +0 -2
  107. package/src/plugins.test.ts +5 -2
  108. package/src/plugins.ts +9 -0
  109. package/src/populate.test.ts +1 -0
  110. package/src/populate.ts +4 -2
  111. package/src/realtime/realtime.test.ts +13 -3
  112. package/src/realtime/realtimeApp.ts +1 -0
  113. package/src/realtime/registry.ts +1 -0
  114. package/src/realtime/types.ts +1 -2
  115. package/src/requestContext.test.ts +32 -0
  116. package/src/terrenoApp.ts +1 -0
  117. package/src/tests/createTestData.ts +11 -6
  118. package/src/tests/models.ts +1 -0
  119. package/src/transformers.ts +4 -2
  120. package/src/vendor/wesleytodd-openapi/lib/generate-doc.js +4 -1
  121. package/tsconfig.json +4 -4
  122. /package/{types.d.ts → src/types.d.ts} +0 -0
@@ -88,6 +88,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
88
88
  return (mod && mod.__esModule) ? mod : { "default": mod };
89
89
  };
90
90
  Object.defineProperty(exports, "__esModule", { value: true });
91
+ // noExplicitAny: test mock typing
91
92
  // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
92
93
  var bun_test_1 = require("bun:test");
93
94
  var Sentry = __importStar(require("@sentry/bun"));
package/dist/api.test.js CHANGED
@@ -88,6 +88,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
88
88
  return (mod && mod.__esModule) ? mod : { "default": mod };
89
89
  };
90
90
  Object.defineProperty(exports, "__esModule", { value: true });
91
+ // noExplicitAny: test mock typing
91
92
  // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
92
93
  // biome-ignore-all lint/suspicious/noImplicitAnyLet: test mock typing
93
94
  var bun_test_1 = require("bun:test");
@@ -831,7 +832,8 @@ var transformers_1 = require("./transformers");
831
832
  return [4 /*yield*/, server.post("/required").send({ about: "test" }).expect(400)];
832
833
  case 1:
833
834
  res = _a.sent();
834
- (0, bun_test_1.expect)(res.body.title).toContain("Required");
835
+ (0, bun_test_1.expect)(res.body.title).toBe("Create error");
836
+ (0, bun_test_1.expect)(res.body.detail).toContain("Required");
835
837
  return [2 /*return*/];
836
838
  }
837
839
  });
@@ -866,6 +868,7 @@ var transformers_1 = require("./transformers");
866
868
  case 2:
867
869
  res = _a.sent();
868
870
  (0, bun_test_1.expect)(res.body.title).toBe("Custom preDelete APIError");
871
+ // Serialized when true so the frontend can suppress duplicate Sentry reporting.
869
872
  (0, bun_test_1.expect)(res.body.disableExternalErrorTracking).toBe(true);
870
873
  return [2 /*return*/];
871
874
  }
@@ -1759,7 +1762,8 @@ var transformers_1 = require("./transformers");
1759
1762
  return [4 /*yield*/, server.post("/required").send({ about: "test" }).expect(400)];
1760
1763
  case 2:
1761
1764
  res = _a.sent();
1762
- (0, bun_test_1.expect)(res.body.title).toContain("Required");
1765
+ (0, bun_test_1.expect)(res.body.title).toBe("Create error");
1766
+ (0, bun_test_1.expect)(res.body.detail).toContain("Required");
1763
1767
  return [2 /*return*/];
1764
1768
  }
1765
1769
  });
@@ -1794,6 +1798,7 @@ var transformers_1 = require("./transformers");
1794
1798
  case 2:
1795
1799
  res = _a.sent();
1796
1800
  (0, bun_test_1.expect)(res.body.title).toBe("Custom preDelete APIError");
1801
+ // Serialized when true so the frontend can suppress duplicate Sentry reporting.
1797
1802
  (0, bun_test_1.expect)(res.body.disableExternalErrorTracking).toBe(true);
1798
1803
  return [2 /*return*/];
1799
1804
  }
@@ -2740,7 +2745,8 @@ var transformers_1 = require("./transformers");
2740
2745
  .expect(400)];
2741
2746
  case 1:
2742
2747
  res = _a.sent();
2743
- (0, bun_test_1.expect)(res.body.title).toContain("generic transform error");
2748
+ (0, bun_test_1.expect)(res.body.title).toBe("Transform error");
2749
+ (0, bun_test_1.expect)(res.body.detail).toContain("generic transform error");
2744
2750
  return [2 /*return*/];
2745
2751
  }
2746
2752
  });
@@ -2798,7 +2804,8 @@ var transformers_1 = require("./transformers");
2798
2804
  case 0: return [4 /*yield*/, agent.patch("/food/".concat(spinach._id)).send({ name: "Updated" }).expect(403)];
2799
2805
  case 1:
2800
2806
  res = _a.sent();
2801
- (0, bun_test_1.expect)(res.body.title).toContain("update transform error");
2807
+ (0, bun_test_1.expect)(res.body.title).toBe("PATCH failed");
2808
+ (0, bun_test_1.expect)(res.body.detail).toContain("update transform error");
2802
2809
  return [2 /*return*/];
2803
2810
  }
2804
2811
  });
package/dist/auth.js CHANGED
@@ -419,6 +419,7 @@ var setupAuth = function (app, userModel) {
419
419
  });
420
420
  }); };
421
421
  app.use(decodeJWTMiddleware);
422
+ // noExplicitAny: express 5 type for urlencoded doesn't match RequestHandler
422
423
  // biome-ignore lint/suspicious/noExplicitAny: express 5 type for urlencoded doesn't match RequestHandler
423
424
  app.use(express_1.default.urlencoded({ extended: false }));
424
425
  };
package/dist/auth.test.js CHANGED
@@ -99,6 +99,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
99
99
  return (mod && mod.__esModule) ? mod : { "default": mod };
100
100
  };
101
101
  Object.defineProperty(exports, "__esModule", { value: true });
102
+ // noExplicitAny: test mock typing
102
103
  // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
103
104
  var bun_test_1 = require("bun:test");
104
105
  var supertest_1 = __importDefault(require("supertest"));
@@ -710,7 +711,7 @@ var decodeTokenPayload = function (token) {
710
711
  case 0: return [4 /*yield*/, agent.post("/auth/signup").send({ email: "new@example.com" }).expect(400)];
711
712
  case 1:
712
713
  res = _a.sent();
713
- (0, bun_test_1.expect)(res.body).toEqual({ meta: {}, status: 400, title: "Missing credentials" });
714
+ (0, bun_test_1.expect)(res.body).toEqual({ status: 400, title: "Missing credentials" });
714
715
  return [2 /*return*/];
715
716
  }
716
717
  });
@@ -2003,3 +2004,124 @@ var decodeTokenPayload = function (token) {
2003
2004
  });
2004
2005
  }); });
2005
2006
  });
2007
+ (0, bun_test_1.describe)("signupUser postCreate failures", function () {
2008
+ (0, bun_test_1.it)("wraps and rethrows errors thrown by user.postCreate", function () { return __awaiter(void 0, void 0, void 0, function () {
2009
+ var saveCalled, failingUser, fakeModel;
2010
+ return __generator(this, function (_a) {
2011
+ switch (_a.label) {
2012
+ case 0:
2013
+ saveCalled = false;
2014
+ failingUser = {
2015
+ postCreate: function () { return __awaiter(void 0, void 0, void 0, function () {
2016
+ return __generator(this, function (_a) {
2017
+ throw new Error("postCreate failed");
2018
+ });
2019
+ }); },
2020
+ save: function () { return __awaiter(void 0, void 0, void 0, function () {
2021
+ return __generator(this, function (_a) {
2022
+ saveCalled = true;
2023
+ return [2 /*return*/];
2024
+ });
2025
+ }); },
2026
+ };
2027
+ fakeModel = {
2028
+ register: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
2029
+ return [2 /*return*/, failingUser];
2030
+ }); }); },
2031
+ };
2032
+ return [4 /*yield*/, (0, bun_test_1.expect)((0, auth_1.signupUser)(fakeModel, "new@example.com", "password123")).rejects.toThrow("postCreate failed")];
2033
+ case 1:
2034
+ _a.sent();
2035
+ (0, bun_test_1.expect)(saveCalled).toBe(false);
2036
+ return [2 /*return*/];
2037
+ }
2038
+ });
2039
+ }); });
2040
+ });
2041
+ (0, bun_test_1.describe)("auth error paths when the user lookup fails", function () {
2042
+ var app;
2043
+ var agent;
2044
+ var admin;
2045
+ (0, bun_test_1.beforeEach)(function () { return __awaiter(void 0, void 0, void 0, function () {
2046
+ var testData;
2047
+ return __generator(this, function (_a) {
2048
+ switch (_a.label) {
2049
+ case 0:
2050
+ (0, bun_test_1.setSystemTime)();
2051
+ return [4 /*yield*/, (0, tests_1.setupTestData)()];
2052
+ case 1:
2053
+ testData = _a.sent();
2054
+ admin = testData.users.admin;
2055
+ app = new terrenoApp_1.TerrenoApp({
2056
+ configureApp: function () { },
2057
+ skipListen: true,
2058
+ userModel: tests_1.UserModel,
2059
+ }).build();
2060
+ agent = supertest_1.default.agent(app);
2061
+ return [2 /*return*/];
2062
+ }
2063
+ });
2064
+ }); });
2065
+ (0, bun_test_1.afterEach)(function () {
2066
+ (0, bun_test_1.setSystemTime)();
2067
+ });
2068
+ (0, bun_test_1.it)("responds with an error when userModel.findById throws during authentication", function () { return __awaiter(void 0, void 0, void 0, function () {
2069
+ var jwtLib, token, findSpy, res;
2070
+ return __generator(this, function (_a) {
2071
+ switch (_a.label) {
2072
+ case 0: return [4 /*yield*/, Promise.resolve().then(function () { return __importStar(require("jsonwebtoken")); })];
2073
+ case 1:
2074
+ jwtLib = (_a.sent()).default;
2075
+ token = jwtLib.sign({ id: admin._id.toString() }, process.env.TOKEN_SECRET, {
2076
+ issuer: process.env.TOKEN_ISSUER,
2077
+ });
2078
+ findSpy = (0, bun_test_1.spyOn)(tests_1.UserModel, "findById").mockImplementation(function () {
2079
+ throw new Error("database unavailable");
2080
+ });
2081
+ _a.label = 2;
2082
+ case 2:
2083
+ _a.trys.push([2, , 4, 5]);
2084
+ return [4 /*yield*/, agent.get("/auth/me").set("authorization", "Bearer ".concat(token))];
2085
+ case 3:
2086
+ res = _a.sent();
2087
+ (0, bun_test_1.expect)(res.status).toBeGreaterThanOrEqual(400);
2088
+ return [3 /*break*/, 5];
2089
+ case 4:
2090
+ findSpy.mockRestore();
2091
+ return [7 /*endfinally*/];
2092
+ case 5: return [2 /*return*/];
2093
+ }
2094
+ });
2095
+ }); });
2096
+ (0, bun_test_1.it)("calls next(err) when the local login strategy errors", function () { return __awaiter(void 0, void 0, void 0, function () {
2097
+ var authSpy, errApp, errAgent, res;
2098
+ return __generator(this, function (_a) {
2099
+ switch (_a.label) {
2100
+ case 0:
2101
+ authSpy = (0, bun_test_1.spyOn)(tests_1.UserModel, "authenticate").mockReturnValue(function (_username, _password, done) {
2102
+ done(new Error("strategy failure"));
2103
+ });
2104
+ _a.label = 1;
2105
+ case 1:
2106
+ _a.trys.push([1, , 3, 4]);
2107
+ errApp = new terrenoApp_1.TerrenoApp({
2108
+ configureApp: function () { },
2109
+ skipListen: true,
2110
+ userModel: tests_1.UserModel,
2111
+ }).build();
2112
+ errAgent = supertest_1.default.agent(errApp);
2113
+ return [4 /*yield*/, errAgent
2114
+ .post("/auth/login")
2115
+ .send({ email: "notAdmin@example.com", password: "password" })];
2116
+ case 2:
2117
+ res = _a.sent();
2118
+ (0, bun_test_1.expect)(res.status).toBeGreaterThanOrEqual(400);
2119
+ return [3 /*break*/, 4];
2120
+ case 3:
2121
+ authSpy.mockRestore();
2122
+ return [7 /*endfinally*/];
2123
+ case 4: return [2 /*return*/];
2124
+ }
2125
+ });
2126
+ }); });
2127
+ });
@@ -191,6 +191,7 @@ var createBetterAuthSessionMiddleware = function (auth, userModel) {
191
191
  };
192
192
  exports.createBetterAuthSessionMiddleware = createBetterAuthSessionMiddleware;
193
193
  var syncBetterAuthUser = function (userModel, betterAuthUser, oauthProvider
194
+ // noExplicitAny: return is a consumer-defined user document; tests inspect varied fields
194
195
  // biome-ignore lint/suspicious/noExplicitAny: return is a consumer-defined user document; tests inspect varied fields
195
196
  ) { return __awaiter(void 0, void 0, void 0, function () {
196
197
  var existingUser, userByEmail, useAsId, newUser, error_2;
@@ -83,6 +83,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
83
83
  return (mod && mod.__esModule) ? mod : { "default": mod };
84
84
  };
85
85
  Object.defineProperty(exports, "__esModule", { value: true });
86
+ // noExplicitAny: test mock typing
86
87
  // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
87
88
  var bun_test_1 = require("bun:test");
88
89
  var express_1 = __importDefault(require("express"));
package/dist/config.js CHANGED
@@ -126,9 +126,10 @@ var getNumber = function (key) {
126
126
  var parsed = Number(raw);
127
127
  if (!Number.isFinite(parsed)) {
128
128
  throw new errors_1.APIError({
129
- error: new Error("Config key \"".concat(key, "\" is not a valid number: ").concat(JSON.stringify(raw))),
129
+ code: "invalid-config-value",
130
+ detail: "Config key \"".concat(key, "\" is not a valid number: ").concat(JSON.stringify(raw)),
130
131
  status: 500,
131
- title: "Config key \"".concat(key, "\" is not a valid number"),
132
+ title: "Invalid config value",
132
133
  });
133
134
  }
134
135
  return parsed;
@@ -156,9 +157,11 @@ var getJSON = function (key) {
156
157
  }
157
158
  catch (error) {
158
159
  throw new errors_1.APIError({
159
- error: new Error("Config key \"".concat(key, "\" is not valid JSON: ").concat(error.message)),
160
+ cause: error,
161
+ code: "invalid-config-value",
162
+ detail: "Config key \"".concat(key, "\" is not valid JSON: ").concat(error.message),
160
163
  status: 500,
161
- title: "Config key \"".concat(key, "\" is not valid JSON"),
164
+ title: "Invalid config value",
162
165
  });
163
166
  }
164
167
  };
@@ -74,6 +74,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
74
74
  Object.defineProperty(exports, "__esModule", { value: true });
75
75
  var bun_test_1 = require("bun:test");
76
76
  var config_1 = require("./config");
77
+ var errors_1 = require("./errors");
77
78
  var KEYS = [
78
79
  "TERRENO_CFG_STRING",
79
80
  "TERRENO_CFG_DEFAULTED",
@@ -174,11 +175,27 @@ var resetEnv = function () {
174
175
  });
175
176
  (0, bun_test_1.it)("throws on non-numeric values", function () {
176
177
  process.env.TERRENO_CFG_NUM = "not-a-number";
177
- (0, bun_test_1.expect)(function () { return config_1.Config.getNumber("TERRENO_CFG_NUM"); }).toThrow(/not a valid number/);
178
+ try {
179
+ config_1.Config.getNumber("TERRENO_CFG_NUM");
180
+ bun_test_1.expect.unreachable("expected throw");
181
+ }
182
+ catch (error) {
183
+ (0, bun_test_1.expect)(error).toBeInstanceOf(errors_1.APIError);
184
+ (0, bun_test_1.expect)(error.title).toBe("Invalid config value");
185
+ (0, bun_test_1.expect)(error.detail).toContain("not a valid number");
186
+ }
178
187
  });
179
188
  (0, bun_test_1.it)("throws on partially-numeric strings like '5000ms'", function () {
180
189
  process.env.TERRENO_CFG_NUM = "5000ms";
181
- (0, bun_test_1.expect)(function () { return config_1.Config.getNumber("TERRENO_CFG_NUM"); }).toThrow(/not a valid number/);
190
+ try {
191
+ config_1.Config.getNumber("TERRENO_CFG_NUM");
192
+ bun_test_1.expect.unreachable("expected throw");
193
+ }
194
+ catch (error) {
195
+ (0, bun_test_1.expect)(error).toBeInstanceOf(errors_1.APIError);
196
+ (0, bun_test_1.expect)(error.title).toBe("Invalid config value");
197
+ (0, bun_test_1.expect)(error.detail).toContain("not a valid number");
198
+ }
182
199
  });
183
200
  (0, bun_test_1.it)("supports floats", function () {
184
201
  process.env.TERRENO_CFG_NUM = "3.14";
@@ -221,7 +238,15 @@ var resetEnv = function () {
221
238
  });
222
239
  (0, bun_test_1.it)("throws on malformed JSON instead of silently returning undefined", function () {
223
240
  process.env.TERRENO_CFG_JSON = "{not json";
224
- (0, bun_test_1.expect)(function () { return config_1.Config.getJSON("TERRENO_CFG_JSON"); }).toThrow(/not valid JSON/);
241
+ try {
242
+ config_1.Config.getJSON("TERRENO_CFG_JSON");
243
+ bun_test_1.expect.unreachable("expected throw");
244
+ }
245
+ catch (error) {
246
+ (0, bun_test_1.expect)(error).toBeInstanceOf(errors_1.APIError);
247
+ (0, bun_test_1.expect)(error.title).toBe("Invalid config value");
248
+ (0, bun_test_1.expect)(error.detail).toContain("not valid JSON");
249
+ }
225
250
  });
226
251
  });
227
252
  (0, bun_test_1.describe)("registry", function () {
@@ -83,6 +83,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
83
83
  return (mod && mod.__esModule) ? mod : { "default": mod };
84
84
  };
85
85
  Object.defineProperty(exports, "__esModule", { value: true });
86
+ // noExplicitAny: test mock typing
86
87
  // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
87
88
  var bun_test_1 = require("bun:test");
88
89
  var mongoose_1 = __importStar(require("mongoose"));
@@ -441,6 +441,7 @@ var ConfigurationApp = /** @class */ (function () {
441
441
  * Top-level fields with subschemas become sections.
442
442
  * Top-level scalar fields go into a "General" section.
443
443
  */
444
+ // noExplicitAny: Model<any> required for invariance with consumer-supplied configuration models
444
445
  // biome-ignore lint/suspicious/noExplicitAny: Model<any> required for invariance with consumer-supplied configuration models
445
446
  ConfigurationApp.prototype.buildMetadata = function (_model, schema) {
446
447
  var _this = this;
@@ -85,6 +85,7 @@ var __read = (this && this.__read) || function (o, n) {
85
85
  return ar;
86
86
  };
87
87
  Object.defineProperty(exports, "__esModule", { value: true });
88
+ // noExplicitAny: test mock typing
88
89
  // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
89
90
  var bun_test_1 = require("bun:test");
90
91
  var mongoose_1 = __importStar(require("mongoose"));
@@ -469,6 +470,85 @@ var ValidatedConfigModel = (0, mongoose_1.model)("ValidatedConfiguration", valid
469
470
  }
470
471
  });
471
472
  }); });
473
+ (0, bun_test_1.it)("re-fetches the existing singleton when a concurrent create hits a 409", function () { return __awaiter(void 0, void 0, void 0, function () {
474
+ var existing, spy, config;
475
+ return __generator(this, function (_a) {
476
+ switch (_a.label) {
477
+ case 0:
478
+ if (!dbConnected) {
479
+ return [2 /*return*/];
480
+ }
481
+ return [4 /*yield*/, SimpleConfigModel.getConfig()];
482
+ case 1:
483
+ existing = (_a.sent());
484
+ spy = (0, bun_test_1.spyOn)(SimpleConfigModel, "findOneOrNone").mockResolvedValueOnce(null);
485
+ _a.label = 2;
486
+ case 2:
487
+ _a.trys.push([2, , 4, 5]);
488
+ return [4 /*yield*/, SimpleConfigModel.getConfig()];
489
+ case 3:
490
+ config = (_a.sent());
491
+ (0, bun_test_1.expect)(config._id.toString()).toBe(existing._id.toString());
492
+ return [3 /*break*/, 5];
493
+ case 4:
494
+ spy.mockRestore();
495
+ return [7 /*endfinally*/];
496
+ case 5: return [2 /*return*/];
497
+ }
498
+ });
499
+ }); });
500
+ (0, bun_test_1.it)("rethrows non-409 errors raised while creating the singleton", function () { return __awaiter(void 0, void 0, void 0, function () {
501
+ var findSpy, saveSpy;
502
+ return __generator(this, function (_a) {
503
+ switch (_a.label) {
504
+ case 0:
505
+ if (!dbConnected) {
506
+ return [2 /*return*/];
507
+ }
508
+ findSpy = (0, bun_test_1.spyOn)(SimpleConfigModel, "findOneOrNone").mockResolvedValueOnce(null);
509
+ saveSpy = (0, bun_test_1.spyOn)(SimpleConfigModel.prototype, "save").mockRejectedValueOnce(new Error("unexpected save failure"));
510
+ _a.label = 1;
511
+ case 1:
512
+ _a.trys.push([1, , 3, 4]);
513
+ return [4 /*yield*/, (0, bun_test_1.expect)(SimpleConfigModel.getConfig()).rejects.toThrow("unexpected save failure")];
514
+ case 2:
515
+ _a.sent();
516
+ return [3 /*break*/, 4];
517
+ case 3:
518
+ findSpy.mockRestore();
519
+ saveSpy.mockRestore();
520
+ return [7 /*endfinally*/];
521
+ case 4: return [2 /*return*/];
522
+ }
523
+ });
524
+ }); });
525
+ (0, bun_test_1.it)("returns undefined for a dotted key that traverses a non-object value", function () { return __awaiter(void 0, void 0, void 0, function () {
526
+ var _a, _b;
527
+ return __generator(this, function (_c) {
528
+ switch (_c.label) {
529
+ case 0:
530
+ if (!dbConnected) {
531
+ return [2 /*return*/];
532
+ }
533
+ return [4 /*yield*/, SimpleConfigModel.getConfig()];
534
+ case 1:
535
+ _c.sent();
536
+ // `value` is a string, so descending into `value.missing` bails out.
537
+ _a = bun_test_1.expect;
538
+ return [4 /*yield*/, SimpleConfigModel.getConfig("value.missing")];
539
+ case 2:
540
+ // `value` is a string, so descending into `value.missing` bails out.
541
+ _a.apply(void 0, [_c.sent()]).toBeUndefined();
542
+ // A missing top-level segment also resolves to undefined.
543
+ _b = bun_test_1.expect;
544
+ return [4 /*yield*/, SimpleConfigModel.getConfig("nope.deeper")];
545
+ case 3:
546
+ // A missing top-level segment also resolves to undefined.
547
+ _b.apply(void 0, [_c.sent()]).toBeUndefined();
548
+ return [2 /*return*/];
549
+ }
550
+ });
551
+ }); });
472
552
  (0, bun_test_1.it)("updates an existing document via updateConfig", function () { return __awaiter(void 0, void 0, void 0, function () {
473
553
  var updated, count;
474
554
  return __generator(this, function (_a) {
@@ -55,6 +55,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
55
55
  return (mod && mod.__esModule) ? mod : { "default": mod };
56
56
  };
57
57
  Object.defineProperty(exports, "__esModule", { value: true });
58
+ // noExplicitAny: test mock typing
58
59
  // biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
59
60
  var bun_test_1 = require("bun:test");
60
61
  var supertest_1 = __importDefault(require("supertest"));
package/dist/docLoader.js CHANGED
@@ -1,37 +1,4 @@
1
1
  "use strict";
2
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
- if (k2 === undefined) k2 = k;
4
- var desc = Object.getOwnPropertyDescriptor(m, k);
5
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
- desc = { enumerable: true, get: function() { return m[k]; } };
7
- }
8
- Object.defineProperty(o, k2, desc);
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
- Object.defineProperty(o, "default", { enumerable: true, value: v });
15
- }) : function(o, v) {
16
- o["default"] = v;
17
- });
18
- var __importStar = (this && this.__importStar) || (function () {
19
- var ownKeys = function(o) {
20
- ownKeys = Object.getOwnPropertyNames || function (o) {
21
- var ar = [];
22
- for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
- return ar;
24
- };
25
- return ownKeys(o);
26
- };
27
- return function (mod) {
28
- if (mod && mod.__esModule) return mod;
29
- var result = {};
30
- if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
- __setModuleDefault(result, mod);
32
- return result;
33
- };
34
- })();
35
2
  var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
36
3
  function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
37
4
  return new (P || (P = Promise))(function (resolve, reject) {
@@ -73,7 +40,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
73
40
  };
74
41
  Object.defineProperty(exports, "__esModule", { value: true });
75
42
  exports.loadDocOr404 = void 0;
76
- var Sentry = __importStar(require("@sentry/bun"));
77
43
  var mongoose_1 = __importDefault(require("mongoose"));
78
44
  var api_1 = require("./api");
79
45
  var errors_1 = require("./errors");
@@ -82,14 +48,12 @@ var errors_1 = require("./errors");
82
48
  * Matches permission middleware behavior including soft-delete metadata.
83
49
  */
84
50
  var loadDocOr404 = function (model, id, populatePaths) { return __awaiter(void 0, void 0, void 0, function () {
85
- var builtQuery, populatedQuery, data, error_1, hiddenDoc, error, reason, error;
51
+ var builtQuery, populatedQuery, data, error_1, hiddenDoc, notFoundDetail, reason;
86
52
  return __generator(this, function (_a) {
87
53
  switch (_a.label) {
88
54
  case 0:
89
55
  builtQuery = model.findById(id);
90
- populatedQuery = (0, api_1.addPopulateToQuery)(
91
- // biome-ignore lint/suspicious/noExplicitAny: Query types vary based on populate paths
92
- builtQuery, populatePaths);
56
+ populatedQuery = (0, api_1.addPopulateToQuery)(builtQuery, populatePaths);
93
57
  _a.label = 1;
94
58
  case 1:
95
59
  _a.trys.push([1, 3, , 4]);
@@ -103,9 +67,11 @@ var loadDocOr404 = function (model, id, populatePaths) { return __awaiter(void 0
103
67
  throw error_1;
104
68
  }
105
69
  throw new errors_1.APIError({
106
- error: error_1,
70
+ cause: error_1,
71
+ code: "get-error",
72
+ detail: "GET failed on ".concat(id),
107
73
  status: 500,
108
- title: "GET failed on ".concat(id),
74
+ title: "GET error",
109
75
  });
110
76
  case 4:
111
77
  if (!!data) return [3 /*break*/, 6];
@@ -114,14 +80,12 @@ var loadDocOr404 = function (model, id, populatePaths) { return __awaiter(void 0
114
80
  })];
115
81
  case 5:
116
82
  hiddenDoc = _a.sent();
83
+ notFoundDetail = "Document ".concat(id, " not found for model ").concat(model.modelName);
117
84
  if (!hiddenDoc) {
118
- Sentry.captureMessage("Document ".concat(id, " not found for model ").concat(model.modelName));
119
- error = new errors_1.APIError({
120
- status: 404,
121
- title: "Document ".concat(id, " not found for model ").concat(model.modelName),
85
+ throw new errors_1.NotFoundError({
86
+ detail: notFoundDetail,
87
+ title: "Document not found",
122
88
  });
123
- error.meta = undefined;
124
- throw error;
125
89
  }
126
90
  reason = null;
127
91
  if (hiddenDoc.deleted) {
@@ -134,18 +98,16 @@ var loadDocOr404 = function (model, id, populatePaths) { return __awaiter(void 0
134
98
  reason = { archived: "true" };
135
99
  }
136
100
  if (!reason) {
137
- error = new errors_1.APIError({
138
- status: 404,
139
- title: "Document ".concat(id, " not found for model ").concat(model.modelName),
101
+ throw new errors_1.NotFoundError({
102
+ detail: notFoundDetail,
103
+ title: "Document not found",
140
104
  });
141
- error.meta = undefined;
142
- throw error;
143
105
  }
144
- throw new errors_1.APIError({
106
+ throw new errors_1.NotFoundError({
107
+ detail: notFoundDetail,
145
108
  disableExternalErrorTracking: true,
146
109
  meta: reason,
147
- status: 404,
148
- title: "Document ".concat(id, " not found for model ").concat(model.modelName),
110
+ title: "Document not found",
149
111
  });
150
112
  case 6: return [2 /*return*/, data];
151
113
  }
@@ -127,7 +127,8 @@ var errors_1 = require("./errors");
127
127
  (0, bun_test_1.expect)(error_2).toBeInstanceOf(errors_1.APIError);
128
128
  apiError = error_2;
129
129
  (0, bun_test_1.expect)(apiError.status).toBe(404);
130
- (0, bun_test_1.expect)(apiError.meta).toBeUndefined();
130
+ (0, bun_test_1.expect)(apiError.title).toBe("Document not found");
131
+ (0, bun_test_1.expect)(apiError.meta).toEqual({});
131
132
  return [3 /*break*/, 4];
132
133
  case 4: return [2 /*return*/];
133
134
  }
@@ -121,6 +121,7 @@ var refreshFromDoc = function (Model) { return __awaiter(void 0, void 0, void 0,
121
121
  }
122
122
  });
123
123
  }); };
124
+ // noExplicitAny: Schema generics must be loose to accept arbitrary consumer schemas
124
125
  // biome-ignore lint/suspicious/noExplicitAny: Schema generics must be loose to accept arbitrary consumer schemas
125
126
  var envConfigurationPlugin = function (schema) {
126
127
  schema.add({