@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
@@ -1,104 +1,18 @@
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
- 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 __rest = (this && this.__rest) || function (s, e) {
50
- var t = {};
51
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
52
- t[p] = s[p];
53
- if (s != null && typeof Object.getOwnPropertySymbols === "function")
54
- for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
55
- if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
56
- t[p[i]] = s[p[i]];
57
- }
58
- return t;
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
- var __read = (this && this.__read) || function (o, n) {
72
- var m = typeof Symbol === "function" && o[Symbol.iterator];
73
- if (!m) return o;
74
- var i = m.call(o), r, ar = [], e;
75
- try {
76
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
77
- }
78
- catch (error) { e = { error: error }; }
79
- finally {
80
- try {
81
- if (r && !r.done && (m = i["return"])) m.call(i);
82
- }
83
- finally { if (e) throw e.error; }
84
- }
85
- return ar;
86
- };
87
2
  Object.defineProperty(exports, "__esModule", { value: true });
88
3
  exports.ConfigurationApp = void 0;
89
- var api_1 = require("./api");
90
- var auth_1 = require("./auth");
91
- var errors_1 = require("./errors");
92
- var logger_1 = require("./logger");
93
- var permissions_1 = require("./permissions");
94
- var populate_1 = require("./populate");
4
+ const api_1 = require("./api");
5
+ const auth_1 = require("./auth");
6
+ const errors_1 = require("./errors");
7
+ const logger_1 = require("./logger");
8
+ const permissions_1 = require("./permissions");
9
+ const populate_1 = require("./populate");
95
10
  /**
96
11
  * Middleware that requires the user to be an admin. Used as the default guard
97
12
  * for every configuration route when no custom `permissions` are supplied.
98
13
  */
99
- var requireAdmin = function (req, _res, next) {
100
- var _a;
101
- if (!((_a = req.user) === null || _a === void 0 ? void 0 : _a.admin)) {
14
+ const requireAdmin = (req, _res, next) => {
15
+ if (!req.user?.admin) {
102
16
  next(new errors_1.APIError({ status: 403, title: "Admin access required" }));
103
17
  return;
104
18
  }
@@ -110,115 +24,72 @@ var requireAdmin = function (req, _res, next) {
110
24
  * configuration singleton has no per-object ownership, so the loaded config
111
25
  * document is passed as the permission object.
112
26
  */
113
- var buildPermissionMiddleware = function (perms, method, loadObj) {
114
- return (0, api_1.asyncHandler)(function (req, _res, next) { return __awaiter(void 0, void 0, void 0, function () {
115
- var obj, _a, allowed;
116
- return __generator(this, function (_b) {
117
- switch (_b.label) {
118
- case 0:
119
- if (!loadObj) return [3 /*break*/, 2];
120
- return [4 /*yield*/, loadObj()];
121
- case 1:
122
- _a = _b.sent();
123
- return [3 /*break*/, 3];
124
- case 2:
125
- _a = undefined;
126
- _b.label = 3;
127
- case 3:
128
- obj = _a;
129
- return [4 /*yield*/, (0, permissions_1.checkPermissions)(method, perms, req.user, obj)];
130
- case 4:
131
- allowed = _b.sent();
132
- if (!allowed) {
133
- throw new errors_1.APIError({
134
- status: 403,
135
- title: "Access to configuration denied",
136
- });
137
- }
138
- next();
139
- return [2 /*return*/];
140
- }
27
+ const buildPermissionMiddleware = (perms, method, loadObj) => (0, api_1.asyncHandler)(async (req, _res, next) => {
28
+ const obj = loadObj ? await loadObj() : undefined;
29
+ const allowed = await (0, permissions_1.checkPermissions)(method, perms, req.user, obj);
30
+ if (!allowed) {
31
+ throw new errors_1.APIError({
32
+ status: 403,
33
+ title: "Access to configuration denied",
141
34
  });
142
- }); });
143
- };
144
- var extractFieldMeta = function (properties, required, schema, prefix, fieldOverrides) {
145
- var e_1, _a;
146
- var _b, _c, _d;
147
- var fields = {};
148
- try {
149
- for (var _e = __values(Object.entries(properties)), _f = _e.next(); !_f.done; _f = _e.next()) {
150
- var _g = __read(_f.value, 2), key = _g[0], prop = _g[1];
151
- var fullPath = prefix ? "".concat(prefix, ".").concat(key) : key;
152
- var schemaPath = schema.path(fullPath);
153
- var opts = schemaPath === null || schemaPath === void 0 ? void 0 : schemaPath.options;
154
- fields[key] = {
155
- default: prop.default,
156
- description: (_b = opts === null || opts === void 0 ? void 0 : opts.description) !== null && _b !== void 0 ? _b : prop.description,
157
- enum: prop.enum,
158
- required: required.includes(key),
159
- secret: (opts === null || opts === void 0 ? void 0 : opts.secret) === true,
160
- type: (_c = prop.type) !== null && _c !== void 0 ? _c : "string",
161
- };
162
- // Apply field overrides
163
- if ((_d = fieldOverrides === null || fieldOverrides === void 0 ? void 0 : fieldOverrides[fullPath]) === null || _d === void 0 ? void 0 : _d.widget) {
164
- fields[key].widget = fieldOverrides[fullPath].widget;
165
- }
166
- }
167
35
  }
168
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
169
- finally {
170
- try {
171
- if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
36
+ next();
37
+ });
38
+ const extractFieldMeta = (properties, required, schema, prefix, fieldOverrides) => {
39
+ const fields = {};
40
+ for (const [key, prop] of Object.entries(properties)) {
41
+ const fullPath = prefix ? `${prefix}.${key}` : key;
42
+ const schemaPath = schema.path(fullPath);
43
+ const opts = schemaPath?.options;
44
+ fields[key] = {
45
+ default: prop.default,
46
+ description: opts?.description ?? prop.description,
47
+ enum: prop.enum,
48
+ required: required.includes(key),
49
+ secret: opts?.secret === true,
50
+ type: prop.type ?? "string",
51
+ };
52
+ // Apply field overrides
53
+ if (fieldOverrides?.[fullPath]?.widget) {
54
+ fields[key].widget = fieldOverrides[fullPath].widget;
172
55
  }
173
- finally { if (e_1) throw e_1.error; }
174
56
  }
175
57
  return fields;
176
58
  };
177
59
  /**
178
60
  * System fields to skip in configuration sections.
179
61
  */
180
- var SYSTEM_FIELDS = new Set(["_id", "_singleton", "id", "__v", "created", "updated", "deleted"]);
181
- var SECRET_REDACTED = "********";
62
+ const SYSTEM_FIELDS = new Set(["_id", "_singleton", "id", "__v", "created", "updated", "deleted"]);
63
+ const SECRET_REDACTED = "********";
182
64
  /**
183
65
  * Redacts secret field values in a configuration object.
184
66
  * Replaces values at secret paths with a placeholder string.
185
67
  */
186
- var redactSecrets = function (obj, secretFields) {
187
- var e_2, _a;
188
- var redacted = __assign({}, obj);
189
- try {
190
- for (var secretFields_1 = __values(secretFields), secretFields_1_1 = secretFields_1.next(); !secretFields_1_1.done; secretFields_1_1 = secretFields_1.next()) {
191
- var field = secretFields_1_1.value;
192
- var parts = field.path.split(".");
193
- var current = redacted;
194
- for (var i = 0; i < parts.length - 1; i++) {
195
- if (!current) {
196
- break;
197
- }
198
- var part = parts[i];
199
- var nested = current[part];
200
- if (nested != null && typeof nested === "object") {
201
- var copy = __assign({}, nested);
202
- current[part] = copy;
203
- current = copy;
204
- }
205
- else {
206
- current = null;
207
- break;
208
- }
68
+ const redactSecrets = (obj, secretFields) => {
69
+ const redacted = { ...obj };
70
+ for (const field of secretFields) {
71
+ const parts = field.path.split(".");
72
+ let current = redacted;
73
+ for (let i = 0; i < parts.length - 1; i++) {
74
+ if (!current) {
75
+ break;
76
+ }
77
+ const part = parts[i];
78
+ const nested = current[part];
79
+ if (nested != null && typeof nested === "object") {
80
+ const copy = { ...nested };
81
+ current[part] = copy;
82
+ current = copy;
209
83
  }
210
- var lastKey = parts[parts.length - 1];
211
- if (current != null && current[lastKey] != null && current[lastKey] !== "") {
212
- current[lastKey] = SECRET_REDACTED;
84
+ else {
85
+ current = null;
86
+ break;
213
87
  }
214
88
  }
215
- }
216
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
217
- finally {
218
- try {
219
- if (secretFields_1_1 && !secretFields_1_1.done && (_a = secretFields_1.return)) _a.call(secretFields_1);
89
+ const lastKey = parts[parts.length - 1];
90
+ if (current != null && current[lastKey] != null && current[lastKey] !== "") {
91
+ current[lastKey] = SECRET_REDACTED;
220
92
  }
221
- finally { if (e_2) throw e_2.error; }
222
93
  }
223
94
  return redacted;
224
95
  };
@@ -227,51 +98,40 @@ var redactSecrets = function (obj, secretFields) {
227
98
  * never be written to the configuration document through the update path.
228
99
  * Copies nodes along each secret path to avoid mutating the caller's object.
229
100
  */
230
- var stripSecretFields = function (obj, secretFields) {
231
- var e_3, _a;
232
- var stripped = __assign({}, obj);
233
- try {
234
- for (var secretFields_2 = __values(secretFields), secretFields_2_1 = secretFields_2.next(); !secretFields_2_1.done; secretFields_2_1 = secretFields_2.next()) {
235
- var field = secretFields_2_1.value;
236
- var parts = field.path.split(".");
237
- var current = stripped;
238
- for (var i = 0; i < parts.length - 1; i++) {
239
- if (!current) {
240
- break;
241
- }
242
- var part = parts[i];
243
- var nested = current[part];
244
- if (nested != null && typeof nested === "object") {
245
- var copy = __assign({}, nested);
246
- current[part] = copy;
247
- current = copy;
248
- }
249
- else {
250
- current = null;
251
- break;
252
- }
101
+ const stripSecretFields = (obj, secretFields) => {
102
+ const stripped = { ...obj };
103
+ for (const field of secretFields) {
104
+ const parts = field.path.split(".");
105
+ let current = stripped;
106
+ for (let i = 0; i < parts.length - 1; i++) {
107
+ if (!current) {
108
+ break;
109
+ }
110
+ const part = parts[i];
111
+ const nested = current[part];
112
+ if (nested != null && typeof nested === "object") {
113
+ const copy = { ...nested };
114
+ current[part] = copy;
115
+ current = copy;
253
116
  }
254
- if (current != null) {
255
- delete current[parts[parts.length - 1]];
117
+ else {
118
+ current = null;
119
+ break;
256
120
  }
257
121
  }
258
- }
259
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
260
- finally {
261
- try {
262
- if (secretFields_2_1 && !secretFields_2_1.done && (_a = secretFields_2.return)) _a.call(secretFields_2);
122
+ if (current != null) {
123
+ delete current[parts[parts.length - 1]];
263
124
  }
264
- finally { if (e_3) throw e_3.error; }
265
125
  }
266
126
  return stripped;
267
127
  };
268
128
  /**
269
129
  * Converts a camelCase or PascalCase string into a display-friendly title.
270
130
  */
271
- var toDisplayName = function (name) {
131
+ const toDisplayName = (name) => {
272
132
  return name
273
133
  .replace(/([A-Z])/g, " $1")
274
- .replace(/^./, function (s) { return s.toUpperCase(); })
134
+ .replace(/^./, (s) => s.toUpperCase())
275
135
  .trim();
276
136
  };
277
137
  /**
@@ -322,169 +182,130 @@ var toDisplayName = function (name) {
322
182
  * .start();
323
183
  * ```
324
184
  */
325
- var ConfigurationApp = /** @class */ (function () {
326
- function ConfigurationApp(options) {
185
+ class ConfigurationApp {
186
+ options;
187
+ constructor(options) {
327
188
  this.options = options;
328
189
  }
329
190
  /**
330
191
  * Resolves the guard middleware for a route: the consumer's terreno permission
331
192
  * functions when supplied, otherwise the default admin-only guard.
332
193
  */
333
- ConfigurationApp.prototype.guardFor = function (route, method) {
334
- var _a;
335
- var perms = (_a = this.options.permissions) === null || _a === void 0 ? void 0 : _a[route];
194
+ guardFor(route, method) {
195
+ const perms = this.options.permissions?.[route];
336
196
  if (perms && perms.length > 0) {
337
197
  return buildPermissionMiddleware(perms, method);
338
198
  }
339
199
  return requireAdmin;
340
- };
341
- ConfigurationApp.prototype.register = function (app) {
342
- var _this = this;
343
- var _a, _b, _c;
344
- var basePath = (_a = this.options.basePath) !== null && _a !== void 0 ? _a : "/configuration";
345
- var ConfigModel = this.options.model;
346
- var schema = ConfigModel.schema;
200
+ }
201
+ register(app) {
202
+ const basePath = this.options.basePath ?? "/configuration";
203
+ const ConfigModel = this.options.model;
204
+ const schema = ConfigModel.schema;
347
205
  // Build metadata by inspecting the schema
348
- var meta = this.buildMetadata(schema);
206
+ const meta = this.buildMetadata(schema);
349
207
  // GET /configuration/meta — schema metadata for the frontend
350
- app.get("".concat(basePath, "/meta"), (0, auth_1.authenticateMiddleware)(), this.guardFor("meta", "read"), function (_req, res) {
208
+ app.get(`${basePath}/meta`, (0, auth_1.authenticateMiddleware)(), this.guardFor("meta", "read"), (_req, res) => {
351
209
  return res.json(meta);
352
210
  });
353
- var ConfigStatics = ConfigModel;
211
+ const ConfigStatics = ConfigModel;
354
212
  // Discover secret fields once at registration time
355
- var secretFields = (_c = (_b = ConfigStatics.getSecretFields) === null || _b === void 0 ? void 0 : _b.call(ConfigStatics)) !== null && _c !== void 0 ? _c : [];
213
+ const secretFields = ConfigStatics.getSecretFields?.() ?? [];
356
214
  // GET /configuration — current values (secrets redacted)
357
- app.get("".concat(basePath), (0, auth_1.authenticateMiddleware)(), this.guardFor("read", "read"), (0, api_1.asyncHandler)(function (_req, res) { return __awaiter(_this, void 0, void 0, function () {
358
- var config, data;
359
- return __generator(this, function (_a) {
360
- switch (_a.label) {
361
- case 0: return [4 /*yield*/, ConfigStatics.getConfig()];
362
- case 1:
363
- config = _a.sent();
364
- data = redactSecrets(config.toJSON(), secretFields);
365
- return [2 /*return*/, res.json({ data: data })];
366
- }
367
- });
368
- }); }));
215
+ app.get(`${basePath}`, (0, auth_1.authenticateMiddleware)(), this.guardFor("read", "read"), (0, api_1.asyncHandler)(async (_req, res) => {
216
+ const config = await ConfigStatics.getConfig();
217
+ const data = redactSecrets(config.toJSON(), secretFields);
218
+ return res.json({ data });
219
+ }));
369
220
  // PATCH /configuration — update values (secret fields stripped; secrets redacted in response)
370
- app.patch("".concat(basePath), (0, auth_1.authenticateMiddleware)(), this.guardFor("update", "update"), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(_this, void 0, void 0, function () {
371
- var _a, _s, _i, _v, rest, safeBody, prevValue, before, config, data;
372
- var _b, _c;
373
- return __generator(this, function (_d) {
374
- switch (_d.label) {
375
- case 0:
376
- _a = req.body, _s = _a._singleton, _i = _a._id, _v = _a.__v, rest = __rest(_a, ["_singleton", "_id", "__v"]);
377
- safeBody = stripSecretFields(rest, secretFields);
378
- if (!this.options.preUpdate) return [3 /*break*/, 2];
379
- return [4 /*yield*/, this.options.preUpdate(safeBody, req)];
380
- case 1:
381
- safeBody = _d.sent();
382
- // Re-strip after the hook: preUpdate receives the raw request and could
383
- // otherwise (re)introduce secret paths. Secrets must never persist here.
384
- safeBody = stripSecretFields(safeBody, secretFields);
385
- _d.label = 2;
386
- case 2:
387
- prevValue = {};
388
- if (!this.options.postUpdate) return [3 /*break*/, 4];
389
- return [4 /*yield*/, ConfigStatics.getConfig()];
390
- case 3:
391
- before = _d.sent();
392
- prevValue = redactSecrets(before.toJSON(), secretFields);
393
- _d.label = 4;
394
- case 4: return [4 /*yield*/, ConfigStatics.updateConfig(safeBody)];
395
- case 5:
396
- config = _d.sent();
397
- logger_1.logger.info("Configuration updated by ".concat((_c = (_b = req.user) === null || _b === void 0 ? void 0 : _b.email) !== null && _c !== void 0 ? _c : "unknown"));
398
- data = redactSecrets(config.toJSON(), secretFields);
399
- if (!this.options.postUpdate) return [3 /*break*/, 7];
400
- return [4 /*yield*/, this.options.postUpdate(data, prevValue, req)];
401
- case 6:
402
- _d.sent();
403
- _d.label = 7;
404
- case 7: return [2 /*return*/, res.json({ data: data })];
405
- }
406
- });
407
- }); }));
221
+ app.patch(`${basePath}`, (0, auth_1.authenticateMiddleware)(), this.guardFor("update", "update"), (0, api_1.asyncHandler)(async (req, res) => {
222
+ // Strip internal system fields that should never be updated via the API.
223
+ const { _singleton: _s, _id: _i, __v: _v, ...rest } = req.body;
224
+ // Strip secret fields so a secret value can never be persisted via update.
225
+ let safeBody = stripSecretFields(rest, secretFields);
226
+ // Allow consumers to validate/normalize before applying.
227
+ if (this.options.preUpdate) {
228
+ safeBody = await this.options.preUpdate(safeBody, req);
229
+ // Re-strip after the hook: preUpdate receives the raw request and could
230
+ // otherwise (re)introduce secret paths. Secrets must never persist here.
231
+ safeBody = stripSecretFields(safeBody, secretFields);
232
+ }
233
+ // Capture the previous (redacted) value for audit hooks.
234
+ let prevValue = {};
235
+ if (this.options.postUpdate) {
236
+ const before = await ConfigStatics.getConfig();
237
+ prevValue = redactSecrets(before.toJSON(), secretFields);
238
+ }
239
+ const config = await ConfigStatics.updateConfig(safeBody);
240
+ logger_1.logger.info(`Configuration updated by ${req.user?.email ?? "unknown"}`);
241
+ const data = redactSecrets(config.toJSON(), secretFields);
242
+ if (this.options.postUpdate) {
243
+ await this.options.postUpdate(data, prevValue, req);
244
+ }
245
+ return res.json({ data });
246
+ }));
408
247
  // POST /configuration/list-secrets — read-only status of each secret field.
409
248
  // Never resolves values into the document and never returns secret values.
410
- var validateSecretsHandler = (0, api_1.asyncHandler)(function (_req, res) { return __awaiter(_this, void 0, void 0, function () {
411
- var resolved, fields;
412
- return __generator(this, function (_a) {
413
- switch (_a.label) {
414
- case 0: return [4 /*yield*/, ConfigStatics.resolveSecrets()];
415
- case 1:
416
- resolved = _a.sent();
417
- fields = secretFields.map(function (s) { return ({
418
- isConfigured: resolved.has(s.path),
419
- path: s.path,
420
- resolvable: resolved.has(s.path),
421
- secretName: s.secretName,
422
- version: s.version,
423
- }); });
424
- logger_1.logger.info("Validated ".concat(resolved.size, "/").concat(secretFields.length, " secrets (read-only)"));
425
- return [2 /*return*/, res.json({
426
- message: "".concat(resolved.size, "/").concat(secretFields.length, " secrets resolvable."),
427
- resolved: resolved.size,
428
- secretFields: fields,
429
- total: secretFields.length,
430
- })];
431
- }
249
+ const validateSecretsHandler = (0, api_1.asyncHandler)(async (_req, res) => {
250
+ // In-memory resolution only — used to report whether each secret is
251
+ // configured/resolvable. Values are never persisted or returned.
252
+ const resolved = await ConfigStatics.resolveSecrets();
253
+ const fields = secretFields.map((s) => ({
254
+ isConfigured: resolved.has(s.path),
255
+ path: s.path,
256
+ resolvable: resolved.has(s.path),
257
+ secretName: s.secretName,
258
+ version: s.version,
259
+ }));
260
+ logger_1.logger.info(`Validated ${resolved.size}/${secretFields.length} secrets (read-only)`);
261
+ return res.json({
262
+ message: `${resolved.size}/${secretFields.length} secrets resolvable.`,
263
+ resolved: resolved.size,
264
+ secretFields: fields,
265
+ total: secretFields.length,
432
266
  });
433
- }); });
434
- app.post("".concat(basePath, "/list-secrets"), (0, auth_1.authenticateMiddleware)(), this.guardFor("listSecrets", "read"), validateSecretsHandler);
267
+ });
268
+ app.post(`${basePath}/list-secrets`, (0, auth_1.authenticateMiddleware)(), this.guardFor("listSecrets", "read"), validateSecretsHandler);
435
269
  // Accurate alias for the read-only validation semantics.
436
- app.post("".concat(basePath, "/validate-secrets"), (0, auth_1.authenticateMiddleware)(), this.guardFor("listSecrets", "read"), validateSecretsHandler);
437
- logger_1.logger.info("Configuration routes mounted at ".concat(basePath));
438
- };
270
+ app.post(`${basePath}/validate-secrets`, (0, auth_1.authenticateMiddleware)(), this.guardFor("listSecrets", "read"), validateSecretsHandler);
271
+ logger_1.logger.info(`Configuration routes mounted at ${basePath}`);
272
+ }
439
273
  /**
440
274
  * Builds the metadata response by inspecting the model schema.
441
275
  * Top-level fields with subschemas become sections.
442
276
  * Top-level scalar fields go into a "General" section.
443
277
  */
444
- ConfigurationApp.prototype.buildMetadata = function (schema) {
445
- var _this = this;
446
- var sections = [];
447
- var generalFields = {};
278
+ buildMetadata(schema) {
279
+ const sections = [];
280
+ const generalFields = {};
448
281
  // Walk top-level paths
449
- schema.eachPath(function (pathName, schemaType) {
450
- var e_4, _a;
451
- var _b, _c;
282
+ schema.eachPath((pathName, schemaType) => {
452
283
  if (SYSTEM_FIELDS.has(pathName)) {
453
284
  return;
454
285
  }
455
- var subSchema = schemaType.schema;
286
+ const subSchema = schemaType.schema;
456
287
  if (subSchema) {
457
288
  // This is a nested subschema — make it a section
458
- var _d = (0, populate_1.getOpenApiSpecForModel)({
289
+ const { properties, required } = (0, populate_1.getOpenApiSpecForModel)({
459
290
  modelName: pathName,
460
291
  schema: subSchema,
461
- }), properties = _d.properties, required = _d.required;
292
+ });
462
293
  // Filter out system fields from the subschema too
463
- var filteredProperties = {};
464
- var filteredRequired = [];
465
- try {
466
- for (var _e = __values(Object.entries(properties)), _f = _e.next(); !_f.done; _f = _e.next()) {
467
- var _g = __read(_f.value, 2), key = _g[0], val = _g[1];
468
- if (!SYSTEM_FIELDS.has(key)) {
469
- filteredProperties[key] = val;
470
- if (required.includes(key)) {
471
- filteredRequired.push(key);
472
- }
294
+ const filteredProperties = {};
295
+ const filteredRequired = [];
296
+ for (const [key, val] of Object.entries(properties)) {
297
+ if (!SYSTEM_FIELDS.has(key)) {
298
+ filteredProperties[key] = val;
299
+ if (required.includes(key)) {
300
+ filteredRequired.push(key);
473
301
  }
474
302
  }
475
303
  }
476
- catch (e_4_1) { e_4 = { error: e_4_1 }; }
477
- finally {
478
- try {
479
- if (_f && !_f.done && (_a = _e.return)) _a.call(_e);
480
- }
481
- finally { if (e_4) throw e_4.error; }
482
- }
483
- var sectionFields = extractFieldMeta(filteredProperties, filteredRequired, schema, pathName, _this.options.fieldOverrides);
304
+ const sectionFields = extractFieldMeta(filteredProperties, filteredRequired, schema, pathName, this.options.fieldOverrides);
484
305
  // Get description from the parent path options
485
- var opts = schemaType.options;
306
+ const opts = schemaType.options;
486
307
  sections.push({
487
- description: opts === null || opts === void 0 ? void 0 : opts.description,
308
+ description: opts?.description,
488
309
  displayName: toDisplayName(pathName),
489
310
  fields: sectionFields,
490
311
  name: pathName,
@@ -492,18 +313,18 @@ var ConfigurationApp = /** @class */ (function () {
492
313
  }
493
314
  else {
494
315
  // Scalar top-level field — goes into "General" section
495
- var opts = schemaType.options;
496
- var fullPath = pathName;
316
+ const opts = schemaType.options;
317
+ const fullPath = pathName;
497
318
  generalFields[pathName] = {
498
- default: opts === null || opts === void 0 ? void 0 : opts.default,
499
- description: opts === null || opts === void 0 ? void 0 : opts.description,
500
- enum: opts === null || opts === void 0 ? void 0 : opts.enum,
501
- required: (opts === null || opts === void 0 ? void 0 : opts.required) === true,
502
- secret: (opts === null || opts === void 0 ? void 0 : opts.secret) === true,
503
- type: _this.mongooseTypeToString(schemaType),
319
+ default: opts?.default,
320
+ description: opts?.description,
321
+ enum: opts?.enum,
322
+ required: opts?.required === true,
323
+ secret: opts?.secret === true,
324
+ type: this.mongooseTypeToString(schemaType),
504
325
  };
505
- if ((_c = (_b = _this.options.fieldOverrides) === null || _b === void 0 ? void 0 : _b[fullPath]) === null || _c === void 0 ? void 0 : _c.widget) {
506
- generalFields[pathName].widget = _this.options.fieldOverrides[fullPath].widget;
326
+ if (this.options.fieldOverrides?.[fullPath]?.widget) {
327
+ generalFields[pathName].widget = this.options.fieldOverrides[fullPath].widget;
507
328
  }
508
329
  }
509
330
  });
@@ -515,16 +336,14 @@ var ConfigurationApp = /** @class */ (function () {
515
336
  name: "__root__",
516
337
  });
517
338
  }
518
- return { sections: sections };
519
- };
520
- ConfigurationApp.prototype.mongooseTypeToString = function (schemaType) {
521
- var _a;
522
- var instance = (_a = schemaType.instance) === null || _a === void 0 ? void 0 : _a.toLowerCase();
339
+ return { sections };
340
+ }
341
+ mongooseTypeToString(schemaType) {
342
+ const instance = schemaType.instance?.toLowerCase();
523
343
  if (instance === "objectid") {
524
344
  return "string";
525
345
  }
526
- return instance !== null && instance !== void 0 ? instance : "string";
527
- };
528
- return ConfigurationApp;
529
- }());
346
+ return instance ?? "string";
347
+ }
348
+ }
530
349
  exports.ConfigurationApp = ConfigurationApp;