@terreno/api 57.4.0 → 57.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (208) hide show
  1. package/README.md +5 -5
  2. package/bunfig.toml +1 -1
  3. package/dist/actions.js +197 -368
  4. package/dist/adminModelRouter.js +88 -173
  5. package/dist/api.js +598 -852
  6. package/dist/audit/auditApp.js +48 -89
  7. package/dist/audit/auditEventModel.js +15 -16
  8. package/dist/audit/cloudTasksEnqueue.js +56 -149
  9. package/dist/audit/diff.js +70 -160
  10. package/dist/audit/processQueue.js +25 -70
  11. package/dist/audit/rbacSink.js +25 -66
  12. package/dist/audit/record.js +129 -251
  13. package/dist/auth.js +432 -681
  14. package/dist/authRecovery.js +155 -269
  15. package/dist/authTokens.js +43 -118
  16. package/dist/betterAuthApp.js +25 -26
  17. package/dist/betterAuthSetup.js +258 -413
  18. package/dist/browserLogsRoute.d.ts +6 -0
  19. package/dist/browserLogsRoute.js +97 -0
  20. package/dist/collectionRegistry.js +32 -47
  21. package/dist/config.js +53 -122
  22. package/dist/configurationApp.js +180 -361
  23. package/dist/configurationPlugin.js +130 -302
  24. package/dist/consentApp.js +276 -421
  25. package/dist/docLoader.js +78 -126
  26. package/dist/envConfigurationPlugin.js +25 -147
  27. package/dist/errors.js +151 -247
  28. package/dist/example.js +28 -34
  29. package/dist/expressServer.d.ts +10 -0
  30. package/dist/expressServer.js +109 -255
  31. package/dist/frameworkModelNames.d.ts +24 -0
  32. package/dist/frameworkModelNames.js +31 -0
  33. package/dist/githubAuth.js +152 -216
  34. package/dist/httpClient.js +176 -264
  35. package/dist/index.d.ts +2 -0
  36. package/dist/index.js +7 -2
  37. package/dist/logger.js +145 -278
  38. package/dist/mcp/auth.js +76 -128
  39. package/dist/mcp/createMCPRequest.js +4 -5
  40. package/dist/mcp/handlers.js +268 -480
  41. package/dist/mcp/query.js +56 -150
  42. package/dist/mcp/registry.js +17 -30
  43. package/dist/mcp/schemaGenerator.js +95 -181
  44. package/dist/mcp/server.js +28 -100
  45. package/dist/mcp/serviceTokens.js +102 -191
  46. package/dist/mcp/toolGenerator.js +78 -191
  47. package/dist/middleware.js +15 -27
  48. package/dist/migrations/fixtures/all-down/20260910120000-one.js +2 -42
  49. package/dist/migrations/fixtures/all-down/20260910120001-two.js +2 -42
  50. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +1 -39
  51. package/dist/migrations/fixtures/bad-name/not-a-migration.js +1 -39
  52. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +1 -39
  53. package/dist/migrations/fixtures/valid/20260910120001-beta.js +2 -42
  54. package/dist/migrations/generate.js +107 -229
  55. package/dist/migrations/load.js +75 -201
  56. package/dist/migrations/lock.js +54 -126
  57. package/dist/migrations/runner.js +192 -446
  58. package/dist/migrations/schemaCatalog.js +122 -263
  59. package/dist/models/consentForm.js +6 -6
  60. package/dist/models/consentResponse.js +5 -5
  61. package/dist/models/mcpServiceToken.js +66 -156
  62. package/dist/models/notification.js +6 -6
  63. package/dist/models/notificationPreference.js +6 -6
  64. package/dist/models/versionConfig.js +5 -5
  65. package/dist/notifications/notificationService.js +133 -273
  66. package/dist/notifications/notificationsApp.js +85 -179
  67. package/dist/notifications/notificationsBeforeSend.js +19 -64
  68. package/dist/notifiers/googleChatNotifier.js +36 -117
  69. package/dist/notifiers/slackNotifier.d.ts +31 -2
  70. package/dist/notifiers/slackNotifier.js +170 -119
  71. package/dist/notifiers/zoomNotifier.js +60 -111
  72. package/dist/openApi.js +107 -122
  73. package/dist/openApiBuilder.js +117 -159
  74. package/dist/openApiCompat.js +81 -148
  75. package/dist/openApiEtag.js +7 -7
  76. package/dist/openApiValidator.js +177 -286
  77. package/dist/orgs/orgContext.js +87 -157
  78. package/dist/orgs/orgPermissions.js +29 -68
  79. package/dist/orgs/orgPlugin.js +9 -27
  80. package/dist/orgs/organizationModel.js +65 -166
  81. package/dist/orgs/organizationSettings.js +29 -36
  82. package/dist/orgs/orgsApp.js +346 -608
  83. package/dist/permissions.js +88 -181
  84. package/dist/plugins.js +125 -218
  85. package/dist/populate.js +130 -240
  86. package/dist/rateLimit/applyTrustProxy.js +1 -1
  87. package/dist/rateLimit/createStore.js +7 -8
  88. package/dist/rateLimit/memoryStore.js +22 -100
  89. package/dist/rateLimit/middleware.js +48 -99
  90. package/dist/rateLimit/mongoStore.js +54 -112
  91. package/dist/rateLimit/policies.js +41 -75
  92. package/dist/rateLimit/redisStore.js +39 -133
  93. package/dist/rbac/access.js +119 -267
  94. package/dist/rbac/assertAllowed.js +95 -171
  95. package/dist/rbac/auditModel.js +14 -58
  96. package/dist/rbac/backfillAdmins.js +24 -130
  97. package/dist/rbac/fieldViews.js +46 -141
  98. package/dist/rbac/membershipOrgAdminSource.js +28 -99
  99. package/dist/rbac/middleware.js +30 -96
  100. package/dist/rbac/modelRouterAccess.js +130 -307
  101. package/dist/rbac/permissionUtils.js +40 -179
  102. package/dist/rbac/realtimeAccess.js +81 -147
  103. package/dist/rbac/resolve.d.ts +1 -1
  104. package/dist/rbac/resolve.js +148 -342
  105. package/dist/rbac/roleManager.js +318 -700
  106. package/dist/rbac/roleModel.js +44 -171
  107. package/dist/rbac/routes.js +93 -196
  108. package/dist/rbac/scopes.js +39 -133
  109. package/dist/rbac/statements.js +23 -91
  110. package/dist/rbac/userPlugin.js +3 -29
  111. package/dist/realtime/changeStreamWatcher.js +489 -800
  112. package/dist/realtime/deprecation.js +8 -10
  113. package/dist/realtime/queryMatcher.js +110 -191
  114. package/dist/realtime/queryStore.js +35 -118
  115. package/dist/realtime/realtimeApp.js +247 -401
  116. package/dist/realtime/registry.js +19 -30
  117. package/dist/realtime/sessionRevalidation.js +132 -358
  118. package/dist/realtime/socketAuth.js +89 -208
  119. package/dist/realtime/socketUser.js +10 -56
  120. package/dist/requestContext.js +93 -139
  121. package/dist/schemaMetadata.js +179 -274
  122. package/dist/scriptRunner.js +96 -266
  123. package/dist/scrubAdminFields.js +36 -108
  124. package/dist/secretProviders.js +130 -299
  125. package/dist/seedRunner.js +221 -514
  126. package/dist/sync/adminBroadcastScope.js +58 -170
  127. package/dist/sync/adminWindowAccess.js +15 -86
  128. package/dist/sync/adminWindowMutation.js +110 -181
  129. package/dist/sync/executors.js +425 -629
  130. package/dist/sync/loadHarness.js +392 -689
  131. package/dist/sync/models.js +181 -341
  132. package/dist/sync/mutationHandler.js +533 -801
  133. package/dist/sync/registrationSideEffects.js +41 -95
  134. package/dist/sync/registry.js +29 -49
  135. package/dist/sync/routes.js +484 -817
  136. package/dist/sync/scripts/compactTombstones.js +83 -228
  137. package/dist/sync/serialize.js +18 -58
  138. package/dist/sync/socketHandlers.js +253 -478
  139. package/dist/sync/streams.js +49 -117
  140. package/dist/sync/syncApp.js +12 -15
  141. package/dist/sync/syncBatch.js +63 -168
  142. package/dist/sync/syncSeqPlugin.js +430 -702
  143. package/dist/syncConsents.js +113 -253
  144. package/dist/terrenoApp.js +166 -276
  145. package/dist/tests/createTestData.js +146 -256
  146. package/dist/tests/models.js +14 -54
  147. package/dist/tests/mongoTestSetup.js +42 -103
  148. package/dist/tests/testHelper.js +31 -93
  149. package/dist/tests.js +12 -51
  150. package/dist/transformers.js +61 -164
  151. package/dist/utils.js +31 -93
  152. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  153. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  154. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  155. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  156. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  157. package/dist/versionCheckPlugin.js +52 -100
  158. package/dist/webhooks/headerValue.js +2 -2
  159. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  160. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  161. package/dist/webhooks/idempotency/webhookReceipt.js +9 -9
  162. package/dist/webhooks/rawBody.js +1 -1
  163. package/dist/webhooks/timingSafeEqual.js +4 -5
  164. package/dist/webhooks/verifiers/hmac.js +17 -18
  165. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  166. package/dist/webhooks/verifiers/stripe.js +31 -65
  167. package/dist/webhooks/verifiers/twilio.js +23 -73
  168. package/dist/webhooks/webhooksApp.js +78 -177
  169. package/dist/zodOpenApi.js +2 -2
  170. package/package.json +6 -6
  171. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  172. package/src/audit/auditApp.test.ts +5 -5
  173. package/src/audit/auditEventModel.ts +7 -3
  174. package/src/audit/auditRouter.test.ts +5 -5
  175. package/src/audit/rbacSink.test.ts +2 -2
  176. package/src/audit/record.test.ts +2 -2
  177. package/src/audit/record.ts +3 -2
  178. package/src/auth.ts +1 -1
  179. package/src/authRecovery.test.ts +43 -0
  180. package/src/authRecovery.ts +16 -10
  181. package/src/authTokens.ts +6 -2
  182. package/src/authVerification.test.ts +22 -0
  183. package/src/browserLogsRoute.ts +110 -0
  184. package/src/configurationPlugin.test.ts +1 -11
  185. package/src/expressServer.ts +10 -0
  186. package/src/frameworkModelNames.test.ts +62 -0
  187. package/src/frameworkModelNames.ts +33 -0
  188. package/src/index.ts +7 -0
  189. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  190. package/src/mcp/auth.test.ts +34 -1
  191. package/src/migrations/cli.test.ts +0 -23
  192. package/src/models/mcpServiceToken.ts +4 -3
  193. package/src/models/notification.ts +3 -2
  194. package/src/models/notificationPreference.ts +1 -1
  195. package/src/notifications/notificationsApp.test.ts +24 -1
  196. package/src/notifiers/slackNotifier.test.ts +186 -1
  197. package/src/notifiers/slackNotifier.ts +167 -8
  198. package/src/orgs/orgPlugin.ts +1 -1
  199. package/src/orgs/organizationModel.ts +11 -6
  200. package/src/plugins.test.ts +5 -0
  201. package/src/plugins.ts +3 -0
  202. package/src/realtime/realtimeApp.ts +1 -1
  203. package/src/sync/integration.test.ts +2 -2
  204. package/src/terrenoApp.ts +3 -0
  205. package/src/types.d.ts +1 -0
  206. package/src/webhooks/idempotency/webhookReceipt.ts +4 -3
  207. package/tsconfig.json +13 -54
  208. package/tsconfig.typedoc.json +2 -0
@@ -0,0 +1,6 @@
1
+ import express from "express";
2
+ /**
3
+ * Dev-only ingestion for the Terreno MCP `read_logs` tool: POST batches of client
4
+ * console / global error lines as JSONL under `.terreno/logs/browser.log`.
5
+ */
6
+ export declare const addTerrenoDevBrowserLogsRoute: (app: express.Application) => void;
@@ -0,0 +1,97 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.addTerrenoDevBrowserLogsRoute = void 0;
7
+ const node_fs_1 = require("node:fs");
8
+ const node_path_1 = require("node:path");
9
+ const express_1 = __importDefault(require("express"));
10
+ const luxon_1 = require("luxon");
11
+ const MAX_BATCH_ENTRIES = 100;
12
+ const MAX_LEVEL_LENGTH = 32;
13
+ const MAX_MESSAGE_LENGTH = 8000;
14
+ const MAX_STACK_LENGTH = 16_000;
15
+ const BROWSER_LOG_BODY_LIMIT_BYTES = 256 * 1024;
16
+ const BROWSER_LOG_BODY_LIMIT = "256kb";
17
+ const MAX_BROWSER_LOG_FILE_BYTES = 5 * 1024 * 1024;
18
+ const shouldEnableBrowserLogs = () => {
19
+ if (process.env.NODE_ENV === "production") {
20
+ return false;
21
+ }
22
+ if (process.env.TERRENO_BROWSER_LOGS === "false" || process.env.TERRENO_BROWSER_LOGS === "0") {
23
+ return false;
24
+ }
25
+ if (process.env.TERRENO_BROWSER_LOGS === "true" || process.env.TERRENO_BROWSER_LOGS === "1") {
26
+ return true;
27
+ }
28
+ return process.env.NODE_ENV === "development";
29
+ };
30
+ const isLoopbackAddress = (address) => {
31
+ return address === "127.0.0.1" || address === "::1" || address === "::ffff:127.0.0.1";
32
+ };
33
+ const isBrowserLogRequestAllowed = (req) => {
34
+ return Boolean(req.user) || isLoopbackAddress(req.socket.remoteAddress);
35
+ };
36
+ /**
37
+ * Dev-only ingestion for the Terreno MCP `read_logs` tool: POST batches of client
38
+ * console / global error lines as JSONL under `.terreno/logs/browser.log`.
39
+ */
40
+ const addTerrenoDevBrowserLogsRoute = (app) => {
41
+ if (!shouldEnableBrowserLogs()) {
42
+ return;
43
+ }
44
+ app.post("/__terreno/browser-logs", express_1.default.json({ limit: BROWSER_LOG_BODY_LIMIT }), (req, res) => {
45
+ if (!isBrowserLogRequestAllowed(req)) {
46
+ res
47
+ .status(403)
48
+ .json({ error: "Browser log ingestion requires a local or authenticated client" });
49
+ return;
50
+ }
51
+ const parsedBodySize = Buffer.byteLength(JSON.stringify(req.body ?? null));
52
+ if (parsedBodySize > BROWSER_LOG_BODY_LIMIT_BYTES) {
53
+ res.status(413).json({ error: "Browser log payload may not exceed 256 kB" });
54
+ return;
55
+ }
56
+ const body = req.body;
57
+ if (!Array.isArray(body?.entries) || body.entries.length === 0) {
58
+ res.status(400).json({ error: "Expected { entries: [...] }" });
59
+ return;
60
+ }
61
+ if (body.entries.length > MAX_BATCH_ENTRIES) {
62
+ res.status(413).json({ error: `A batch may contain at most ${MAX_BATCH_ENTRIES} entries` });
63
+ return;
64
+ }
65
+ const logDir = (0, node_path_1.join)(process.cwd(), ".terreno", "logs");
66
+ (0, node_fs_1.mkdirSync)(logDir, { recursive: true });
67
+ const path = (0, node_path_1.join)(logDir, "browser.log");
68
+ const lines = [];
69
+ for (const row of body.entries) {
70
+ if (typeof row !== "object" || row === null) {
71
+ continue;
72
+ }
73
+ const r = row;
74
+ const level = (typeof r.level === "string" ? r.level : "info").slice(0, MAX_LEVEL_LENGTH);
75
+ const rawMessage = typeof r.message === "string" ? r.message : JSON.stringify(r.message ?? "");
76
+ lines.push(JSON.stringify({
77
+ level,
78
+ message: rawMessage.slice(0, MAX_MESSAGE_LENGTH),
79
+ source: "browser",
80
+ stack: typeof r.stack === "string" ? r.stack.slice(0, MAX_STACK_LENGTH) : undefined,
81
+ timestamp: typeof r.timestamp === "string" && r.timestamp ? r.timestamp : luxon_1.DateTime.now().toISO(),
82
+ }));
83
+ }
84
+ if (lines.length > 0) {
85
+ const payload = `${lines.join("\n")}\n`;
86
+ const currentSize = (0, node_fs_1.existsSync)(path) ? (0, node_fs_1.statSync)(path).size : 0;
87
+ if (currentSize + Buffer.byteLength(payload) > MAX_BROWSER_LOG_FILE_BYTES) {
88
+ (0, node_fs_1.writeFileSync)(path, payload, { encoding: "utf-8", mode: 0o600 });
89
+ }
90
+ else {
91
+ (0, node_fs_1.appendFileSync)(path, payload, { encoding: "utf-8", mode: 0o600 });
92
+ }
93
+ }
94
+ res.status(204).end();
95
+ });
96
+ };
97
+ exports.addTerrenoDevBrowserLogsRoute = addTerrenoDevBrowserLogsRoute;
@@ -1,52 +1,39 @@
1
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
2
  Object.defineProperty(exports, "__esModule", { value: true });
14
3
  exports.clearCollectionRegistry = exports.listCollections = exports.getCollection = exports.replaceCollectionOptions = exports.registerCollection = void 0;
15
- var errors_1 = require("./errors");
16
- var registrationSideEffects_1 = require("./sync/registrationSideEffects");
17
- var withAdminBroadcastDefault = function (config) { return (__assign(__assign({}, config), { adminBroadcast: config.adminBroadcast === true })); };
4
+ const errors_1 = require("./errors");
5
+ const registrationSideEffects_1 = require("./sync/registrationSideEffects");
6
+ const withAdminBroadcastDefault = (config) => ({
7
+ ...config,
8
+ adminBroadcast: config.adminBroadcast === true,
9
+ });
18
10
  /** Store `adminBroadcast: false` when the host omitted the flag (default). */
19
- var applyAdminBroadcastDefault = function (options) {
11
+ const applyAdminBroadcastDefault = (options) => {
20
12
  if (!options.sync) {
21
13
  return;
22
14
  }
23
15
  options.sync = withAdminBroadcastDefault(options.sync);
24
16
  };
25
- var collectionRegistry = new Map();
17
+ const collectionRegistry = new Map();
26
18
  /** OR new option flags onto existing ones so a patch cannot disable a surface. */
27
- var deriveSurfaces = function (options, existing) {
28
- var _a, _b, _c;
29
- return ({
30
- mcp: Boolean(options.mcp) || ((_a = existing === null || existing === void 0 ? void 0 : existing.mcp) !== null && _a !== void 0 ? _a : false),
31
- realtime: Boolean(options.realtime) || ((_b = existing === null || existing === void 0 ? void 0 : existing.realtime) !== null && _b !== void 0 ? _b : false),
32
- sync: Boolean(options.sync) || ((_c = existing === null || existing === void 0 ? void 0 : existing.sync) !== null && _c !== void 0 ? _c : false),
33
- });
34
- };
19
+ const deriveSurfaces = (options, existing) => ({
20
+ mcp: Boolean(options.mcp) || (existing?.mcp ?? false),
21
+ realtime: Boolean(options.realtime) || (existing?.realtime ?? false),
22
+ sync: Boolean(options.sync) || (existing?.sync ?? false),
23
+ });
35
24
  /** Insert or merge a collection. First sync enable runs schema/index guards. */
36
- var registerCollection = function (_a) {
37
- var _b;
38
- var model = _a.model, options = _a.options, routePath = _a.routePath;
25
+ const registerCollection = ({ model, options, routePath, }) => {
39
26
  applyAdminBroadcastDefault(options);
40
- var existing = collectionRegistry.get(routePath);
41
- var wasSyncEnabled = (_b = existing === null || existing === void 0 ? void 0 : existing.surfaces.sync) !== null && _b !== void 0 ? _b : false;
27
+ const existing = collectionRegistry.get(routePath);
28
+ const wasSyncEnabled = existing?.surfaces.sync ?? false;
42
29
  if (options.sync && wasSyncEnabled) {
43
- if ((existing === null || existing === void 0 ? void 0 : existing.model.modelName) === model.modelName) {
30
+ if (existing?.model.modelName === model.modelName) {
44
31
  return;
45
32
  }
46
- var collectionTag = routePath.replace(/^\//, "");
33
+ const collectionTag = routePath.replace(/^\//, "");
47
34
  throw new errors_1.APIError({
48
35
  status: 500,
49
- title: "Sync collection tag \"".concat(collectionTag, "\" is already registered (routePath ").concat(routePath, "). ") +
36
+ title: `Sync collection tag "${collectionTag}" is already registered (routePath ${routePath}). ` +
50
37
  "Each synced model must have a unique route path.",
51
38
  });
52
39
  }
@@ -54,27 +41,27 @@ var registerCollection = function (_a) {
54
41
  (0, registrationSideEffects_1.applySyncRegistrationSideEffects)({
55
42
  config: options.sync,
56
43
  existingSyncEntries: (0, exports.listCollections)()
57
- .filter(function (record) { return record.surfaces.sync; })
58
- .map(function (record) { return ({
44
+ .filter((record) => record.surfaces.sync)
45
+ .map((record) => ({
59
46
  collectionTag: record.routePath.replace(/^\//, ""),
60
47
  modelName: record.model.modelName,
61
- }); }),
62
- model: model,
63
- options: options,
64
- routePath: routePath,
48
+ })),
49
+ model,
50
+ options,
51
+ routePath,
65
52
  });
66
53
  }
67
54
  collectionRegistry.set(routePath, {
68
55
  model: model,
69
56
  options: options,
70
- routePath: routePath,
71
- surfaces: deriveSurfaces(options, existing === null || existing === void 0 ? void 0 : existing.surfaces),
57
+ routePath,
58
+ surfaces: deriveSurfaces(options, existing?.surfaces),
72
59
  });
73
60
  };
74
61
  exports.registerCollection = registerCollection;
75
62
  /** Swap the options pointer after TerrenoApp enriches it. Unknown path is a no-op. */
76
- var replaceCollectionOptions = function (routePath, options) {
77
- var existing = collectionRegistry.get(routePath);
63
+ const replaceCollectionOptions = (routePath, options) => {
64
+ const existing = collectionRegistry.get(routePath);
78
65
  if (!existing) {
79
66
  return;
80
67
  }
@@ -83,14 +70,12 @@ var replaceCollectionOptions = function (routePath, options) {
83
70
  };
84
71
  exports.replaceCollectionOptions = replaceCollectionOptions;
85
72
  /** @internal */
86
- var getCollection = function (routePath) {
87
- return collectionRegistry.get(routePath);
88
- };
73
+ const getCollection = (routePath) => collectionRegistry.get(routePath);
89
74
  exports.getCollection = getCollection;
90
- var listCollections = function () { return Array.from(collectionRegistry.values()); };
75
+ const listCollections = () => Array.from(collectionRegistry.values());
91
76
  exports.listCollections = listCollections;
92
77
  /** Wipe the catalog and queued sync indexes so tests cannot leave a stale surface. */
93
- var clearCollectionRegistry = function () {
78
+ const clearCollectionRegistry = () => {
94
79
  collectionRegistry.clear();
95
80
  (0, registrationSideEffects_1.clearSyncIndexCreationTasks)();
96
81
  };
package/dist/config.js CHANGED
@@ -21,70 +21,22 @@
21
21
  * their backing store with `Config.setEnvLoader(fn)`. The optional
22
22
  * `envConfigurationPlugin` provides a drop-in Mongoose schema integration.
23
23
  */
24
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
25
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
26
- return new (P || (P = Promise))(function (resolve, reject) {
27
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
28
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
29
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
30
- step((generator = generator.apply(thisArg, _arguments || [])).next());
31
- });
32
- };
33
- var __generator = (this && this.__generator) || function (thisArg, body) {
34
- 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);
35
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
36
- function verb(n) { return function (v) { return step([n, v]); }; }
37
- function step(op) {
38
- if (f) throw new TypeError("Generator is already executing.");
39
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
40
- 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;
41
- if (y = 0, t) op = [op[0] & 2, t.value];
42
- switch (op[0]) {
43
- case 0: case 1: t = op; break;
44
- case 4: _.label++; return { value: op[1], done: false };
45
- case 5: _.label++; y = op[1]; op = [0]; continue;
46
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
47
- default:
48
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
49
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
50
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
51
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
52
- if (t[2]) _.ops.pop();
53
- _.trys.pop(); continue;
54
- }
55
- op = body.call(thisArg, _);
56
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
57
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
58
- }
59
- };
60
- var __values = (this && this.__values) || function(o) {
61
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
62
- if (m) return m.call(o);
63
- if (o && typeof o.length === "number") return {
64
- next: function () {
65
- if (o && i >= o.length) o = void 0;
66
- return { value: o && o[i++], done: !o };
67
- }
68
- };
69
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
70
- };
71
24
  Object.defineProperty(exports, "__esModule", { value: true });
72
25
  exports.Config = void 0;
73
- var errors_1 = require("./errors");
74
- var overrides = new Map();
75
- var cachedEnv = null;
76
- var envLoader = null;
26
+ const errors_1 = require("./errors");
27
+ const overrides = new Map();
28
+ let cachedEnv = null;
29
+ let envLoader = null;
77
30
  // Null-prototype object so lookups don't resolve inherited keys like
78
31
  // `constructor` / `toString` as accidentally-registered entries.
79
- var REGISTRY = Object.create(null);
32
+ const REGISTRY = Object.create(null);
80
33
  /**
81
34
  * Registers a configuration key, its default, and metadata. Re-registration
82
35
  * of the same key throws so duplicates surface at boot.
83
36
  */
84
- var register = function (key, registration) {
85
- if (registration === void 0) { registration = {}; }
37
+ const register = (key, registration = {}) => {
86
38
  if (REGISTRY[key]) {
87
- throw new errors_1.APIError({ status: 500, title: "Config key \"".concat(key, "\" registered more than once") });
39
+ throw new errors_1.APIError({ status: 500, title: `Config key "${key}" registered more than once` });
88
40
  }
89
41
  REGISTRY[key] = registration;
90
42
  };
@@ -93,41 +45,40 @@ var register = function (key, registration) {
93
45
  * order documented at the top of this file. Returns `undefined` if no
94
46
  * source supplies a value and no default was registered.
95
47
  */
96
- var getString = function (key) {
97
- var _a;
48
+ const getString = (key) => {
98
49
  if (overrides.has(key)) {
99
50
  return overrides.get(key);
100
51
  }
101
52
  if (cachedEnv && key in cachedEnv) {
102
- var v = cachedEnv[key];
53
+ const v = cachedEnv[key];
103
54
  if (v !== undefined && v !== "") {
104
55
  return v;
105
56
  }
106
57
  }
107
58
  // Guard against process.env keys like "toString" / "constructor" inheriting
108
59
  // a function from Object.prototype. Only accept string values.
109
- var fromProcess = process.env[key];
60
+ const fromProcess = process.env[key];
110
61
  if (typeof fromProcess === "string" && fromProcess !== "") {
111
62
  return fromProcess;
112
63
  }
113
- return (_a = REGISTRY[key]) === null || _a === void 0 ? void 0 : _a.default;
64
+ return REGISTRY[key]?.default;
114
65
  };
115
66
  /**
116
67
  * Returns the configured value as a number. Throws if a value is present but
117
68
  * not finite — silent NaN propagation has bitten apps before.
118
69
  */
119
- var getNumber = function (key) {
120
- var raw = getString(key);
70
+ const getNumber = (key) => {
71
+ const raw = getString(key);
121
72
  if (raw === undefined) {
122
73
  return undefined;
123
74
  }
124
75
  // Number() rejects partially-numeric strings like "5000ms" (returns NaN)
125
76
  // whereas parseFloat would silently truncate to 5000.
126
- var parsed = Number(raw);
77
+ const parsed = Number(raw);
127
78
  if (!Number.isFinite(parsed)) {
128
79
  throw new errors_1.APIError({
129
80
  code: "invalid-config-value",
130
- detail: "Config key \"".concat(key, "\" is not a valid number: ").concat(JSON.stringify(raw)),
81
+ detail: `Config key "${key}" is not a valid number: ${JSON.stringify(raw)}`,
131
82
  status: 500,
132
83
  title: "Invalid config value",
133
84
  });
@@ -138,8 +89,8 @@ var getNumber = function (key) {
138
89
  * Returns true iff the string value equals "true" (case-insensitive). Mirrors
139
90
  * the existing `process.env.X === "true"` idiom.
140
91
  */
141
- var getBoolean = function (key) {
142
- var raw = getString(key);
92
+ const getBoolean = (key) => {
93
+ const raw = getString(key);
143
94
  return raw !== undefined && raw.toLowerCase() === "true";
144
95
  };
145
96
  /**
@@ -147,8 +98,8 @@ var getBoolean = function (key) {
147
98
  * malformed JSON so misconfiguration fails loud at the call site rather than
148
99
  * producing silent runtime errors later.
149
100
  */
150
- var getJSON = function (key) {
151
- var raw = getString(key);
101
+ const getJSON = (key) => {
102
+ const raw = getString(key);
152
103
  if (raw === undefined) {
153
104
  return undefined;
154
105
  }
@@ -159,7 +110,7 @@ var getJSON = function (key) {
159
110
  throw new errors_1.APIError({
160
111
  cause: error,
161
112
  code: "invalid-config-value",
162
- detail: "Config key \"".concat(key, "\" is not valid JSON: ").concat(error.message),
113
+ detail: `Config key "${key}" is not valid JSON: ${error.message}`,
163
114
  status: 500,
164
115
  title: "Invalid config value",
165
116
  });
@@ -170,91 +121,71 @@ var getJSON = function (key) {
170
121
  * admin-editable Mongoose document). Called once at app startup before
171
122
  * the first `Config.refresh()`.
172
123
  */
173
- var setEnvLoader = function (loader) {
124
+ const setEnvLoader = (loader) => {
174
125
  envLoader = loader;
175
126
  };
176
127
  /**
177
128
  * Reloads the in-memory cache by invoking the registered env loader. No-op
178
129
  * (clears cache) if no loader has been registered.
179
130
  */
180
- var refresh = function () { return __awaiter(void 0, void 0, void 0, function () {
181
- return __generator(this, function (_a) {
182
- switch (_a.label) {
183
- case 0:
184
- if (!envLoader) {
185
- cachedEnv = {};
186
- return [2 /*return*/];
187
- }
188
- return [4 /*yield*/, envLoader()];
189
- case 1:
190
- cachedEnv = _a.sent();
191
- return [2 /*return*/];
192
- }
193
- });
194
- }); };
131
+ const refresh = async () => {
132
+ if (!envLoader) {
133
+ cachedEnv = {};
134
+ return;
135
+ }
136
+ cachedEnv = await envLoader();
137
+ };
195
138
  /** Replaces the cache directly. Intended for the envConfigurationPlugin and tests. */
196
- var setCachedEnv = function (env) {
139
+ const setCachedEnv = (env) => {
197
140
  cachedEnv = env;
198
141
  };
199
142
  /**
200
143
  * Sets an in-process override for `key`. Highest precedence — wins over
201
144
  * the cached env map. Intended for tests and bootstrap helpers.
202
145
  */
203
- var setOverride = function (key, value) {
146
+ const setOverride = (key, value) => {
204
147
  overrides.set(key, value);
205
148
  };
206
149
  /** Clears every override. Call from afterEach in tests. */
207
- var clearOverrides = function () {
150
+ const clearOverrides = () => {
208
151
  overrides.clear();
209
152
  };
210
153
  /** Returns the registered default (if any) for `key`. */
211
- var getDefault = function (key) {
212
- var _a;
213
- return (_a = REGISTRY[key]) === null || _a === void 0 ? void 0 : _a.default;
154
+ const getDefault = (key) => {
155
+ return REGISTRY[key]?.default;
214
156
  };
215
157
  /** Returns the registration metadata for `key`, including secret/description. */
216
- var getRegistration = function (key) {
158
+ const getRegistration = (key) => {
217
159
  return REGISTRY[key];
218
160
  };
219
161
  /** Returns the registered keys, sorted. Used by the admin UI. */
220
- var getRegisteredKeys = function () {
162
+ const getRegisteredKeys = () => {
221
163
  return Object.keys(REGISTRY).sort();
222
164
  };
223
165
  /** Returns true if `key` was registered. */
224
- var isRegistered = function (key) {
166
+ const isRegistered = (key) => {
225
167
  return key in REGISTRY;
226
168
  };
227
169
  /** Removes every registered key. Intended for tests. */
228
- var clearRegistryForTesting = function () {
229
- var e_1, _a;
230
- try {
231
- for (var _b = __values(Object.keys(REGISTRY)), _c = _b.next(); !_c.done; _c = _b.next()) {
232
- var key = _c.value;
233
- delete REGISTRY[key];
234
- }
235
- }
236
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
237
- finally {
238
- try {
239
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
240
- }
241
- finally { if (e_1) throw e_1.error; }
170
+ const clearRegistryForTesting = () => {
171
+ for (const key of Object.keys(REGISTRY)) {
172
+ delete REGISTRY[key];
242
173
  }
243
174
  };
244
175
  exports.Config = {
245
- clearOverrides: clearOverrides,
246
- clearRegistryForTesting: clearRegistryForTesting,
176
+ clearOverrides,
177
+ clearRegistryForTesting,
247
178
  get: getString,
248
- getBoolean: getBoolean,
249
- getDefault: getDefault,
250
- getJSON: getJSON,
251
- getNumber: getNumber,
252
- getRegisteredKeys: getRegisteredKeys,
253
- getRegistration: getRegistration,
254
- isRegistered: isRegistered,
255
- refresh: refresh,
256
- register: register,
257
- setCachedEnv: setCachedEnv,
258
- setEnvLoader: setEnvLoader,
259
- setOverride: setOverride,
179
+ getBoolean,
180
+ getDefault,
181
+ getJSON,
182
+ getNumber,
183
+ getRegisteredKeys,
184
+ getRegistration,
185
+ isRegistered,
186
+ refresh,
187
+ register,
188
+ setCachedEnv,
189
+ setEnvLoader,
190
+ setOverride,
260
191
  };