@terreno/api 57.3.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 (412) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +11 -5
  3. package/bunfig.toml +1 -1
  4. package/dist/actions.js +197 -368
  5. package/dist/adminModelRouter.js +88 -173
  6. package/dist/adminTypes.d.ts +7 -0
  7. package/dist/adminTypes.js +6 -1
  8. package/dist/api.d.ts +10 -0
  9. package/dist/api.js +601 -792
  10. package/dist/audit/auditApp.d.ts +30 -0
  11. package/dist/audit/auditApp.js +114 -0
  12. package/dist/audit/auditEventModel.d.ts +29 -0
  13. package/dist/audit/auditEventModel.js +101 -0
  14. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  15. package/dist/audit/cloudTasksEnqueue.js +69 -0
  16. package/dist/audit/diff.d.ts +10 -0
  17. package/dist/audit/diff.js +140 -0
  18. package/dist/audit/processQueue.d.ts +6 -0
  19. package/dist/audit/processQueue.js +56 -0
  20. package/dist/audit/rbacSink.d.ts +2 -0
  21. package/dist/audit/rbacSink.js +41 -0
  22. package/dist/audit/record.d.ts +56 -0
  23. package/dist/audit/record.js +251 -0
  24. package/dist/auth.js +432 -681
  25. package/dist/authRecovery.js +155 -269
  26. package/dist/authTokens.js +43 -118
  27. package/dist/betterAuth.d.ts +6 -0
  28. package/dist/betterAuthApp.js +25 -26
  29. package/dist/betterAuthSetup.js +258 -413
  30. package/dist/browserLogsRoute.d.ts +6 -0
  31. package/dist/browserLogsRoute.js +97 -0
  32. package/dist/collectionRegistry.d.ts +3 -1
  33. package/dist/collectionRegistry.js +43 -33
  34. package/dist/config.js +53 -122
  35. package/dist/configurationApp.js +180 -361
  36. package/dist/configurationPlugin.js +130 -302
  37. package/dist/consentApp.js +276 -421
  38. package/dist/docLoader.js +78 -126
  39. package/dist/envConfigurationPlugin.js +25 -147
  40. package/dist/errors.js +151 -247
  41. package/dist/example.js +28 -34
  42. package/dist/expressServer.d.ts +10 -0
  43. package/dist/expressServer.js +109 -255
  44. package/dist/frameworkModelNames.d.ts +24 -0
  45. package/dist/frameworkModelNames.js +31 -0
  46. package/dist/githubAuth.js +152 -216
  47. package/dist/httpClient.js +176 -264
  48. package/dist/index.d.ts +28 -1
  49. package/dist/index.js +53 -2
  50. package/dist/logger.js +145 -278
  51. package/dist/mcp/auth.js +76 -128
  52. package/dist/mcp/createMCPRequest.js +4 -5
  53. package/dist/mcp/handlers.js +268 -480
  54. package/dist/mcp/query.d.ts +0 -13
  55. package/dist/mcp/query.js +57 -151
  56. package/dist/mcp/registry.js +17 -30
  57. package/dist/mcp/schemaGenerator.js +95 -181
  58. package/dist/mcp/server.js +28 -100
  59. package/dist/mcp/serviceTokens.js +102 -191
  60. package/dist/mcp/toolGenerator.js +78 -191
  61. package/dist/middleware.js +15 -27
  62. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  63. package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
  64. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  65. package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
  66. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  67. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
  68. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  69. package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -0
  70. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  71. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  72. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  73. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +7 -0
  74. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  75. package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
  76. package/dist/migrations/generate.d.ts +17 -0
  77. package/dist/migrations/generate.js +155 -0
  78. package/dist/migrations/load.d.ts +20 -0
  79. package/dist/migrations/load.js +110 -0
  80. package/dist/migrations/lock.d.ts +13 -0
  81. package/dist/migrations/lock.js +73 -0
  82. package/dist/migrations/runner.d.ts +42 -0
  83. package/dist/migrations/runner.js +249 -0
  84. package/dist/migrations/schemaCatalog.d.ts +44 -0
  85. package/dist/migrations/schemaCatalog.js +185 -0
  86. package/dist/migrations/types.d.ts +87 -0
  87. package/dist/migrations/types.js +7 -0
  88. package/dist/models/consentForm.js +6 -6
  89. package/dist/models/consentResponse.js +5 -5
  90. package/dist/models/mcpServiceToken.js +66 -156
  91. package/dist/models/notification.d.ts +2 -0
  92. package/dist/models/notification.js +62 -0
  93. package/dist/models/notificationPreference.d.ts +2 -0
  94. package/dist/models/notificationPreference.js +49 -0
  95. package/dist/models/versionConfig.js +5 -5
  96. package/dist/notifications/notificationService.d.ts +40 -0
  97. package/dist/notifications/notificationService.js +183 -0
  98. package/dist/notifications/notificationsApp.d.ts +18 -0
  99. package/dist/notifications/notificationsApp.js +156 -0
  100. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  101. package/dist/notifications/notificationsBeforeSend.js +32 -0
  102. package/dist/notifiers/googleChatNotifier.js +36 -117
  103. package/dist/notifiers/slackNotifier.d.ts +31 -2
  104. package/dist/notifiers/slackNotifier.js +170 -119
  105. package/dist/notifiers/zoomNotifier.js +60 -111
  106. package/dist/openApi.d.ts +1 -7
  107. package/dist/openApi.js +113 -127
  108. package/dist/openApiBuilder.d.ts +14 -3
  109. package/dist/openApiBuilder.js +117 -159
  110. package/dist/openApiCompat.js +81 -148
  111. package/dist/openApiEtag.js +7 -7
  112. package/dist/openApiValidator.d.ts +13 -1
  113. package/dist/openApiValidator.js +301 -246
  114. package/dist/orgs/orgContext.d.ts +23 -0
  115. package/dist/orgs/orgContext.js +128 -0
  116. package/dist/orgs/orgPermissions.d.ts +4 -0
  117. package/dist/orgs/orgPermissions.js +38 -0
  118. package/dist/orgs/orgPlugin.d.ts +13 -0
  119. package/dist/orgs/orgPlugin.js +66 -0
  120. package/dist/orgs/organizationModel.d.ts +13 -0
  121. package/dist/orgs/organizationModel.js +200 -0
  122. package/dist/orgs/organizationSettings.d.ts +19 -0
  123. package/dist/orgs/organizationSettings.js +113 -0
  124. package/dist/orgs/orgsApp.d.ts +28 -0
  125. package/dist/orgs/orgsApp.js +416 -0
  126. package/dist/permissions.d.ts +7 -13
  127. package/dist/permissions.js +95 -211
  128. package/dist/plugins.js +125 -218
  129. package/dist/populate.js +130 -240
  130. package/dist/rateLimit/applyTrustProxy.js +1 -1
  131. package/dist/rateLimit/createStore.js +7 -8
  132. package/dist/rateLimit/memoryStore.js +22 -100
  133. package/dist/rateLimit/middleware.d.ts +0 -8
  134. package/dist/rateLimit/middleware.js +49 -101
  135. package/dist/rateLimit/mongoStore.d.ts +1 -0
  136. package/dist/rateLimit/mongoStore.js +55 -112
  137. package/dist/rateLimit/policies.d.ts +0 -4
  138. package/dist/rateLimit/policies.js +44 -80
  139. package/dist/rateLimit/redisStore.d.ts +1 -0
  140. package/dist/rateLimit/redisStore.js +40 -133
  141. package/dist/rbac/access.js +122 -253
  142. package/dist/rbac/assertAllowed.js +95 -171
  143. package/dist/rbac/auditModel.js +14 -58
  144. package/dist/rbac/backfillAdmins.js +24 -130
  145. package/dist/rbac/fieldViews.js +46 -141
  146. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  147. package/dist/rbac/membershipOrgAdminSource.js +51 -0
  148. package/dist/rbac/middleware.js +30 -96
  149. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  150. package/dist/rbac/modelRouterAccess.js +133 -307
  151. package/dist/rbac/permissionUtils.js +40 -179
  152. package/dist/rbac/realtimeAccess.js +81 -147
  153. package/dist/rbac/resolve.d.ts +1 -1
  154. package/dist/rbac/resolve.js +154 -319
  155. package/dist/rbac/roleManager.js +318 -700
  156. package/dist/rbac/roleModel.d.ts +2 -5
  157. package/dist/rbac/roleModel.js +60 -173
  158. package/dist/rbac/routes.js +93 -196
  159. package/dist/rbac/scopes.js +39 -133
  160. package/dist/rbac/statements.d.ts +10 -1
  161. package/dist/rbac/statements.js +42 -93
  162. package/dist/rbac/types.d.ts +5 -0
  163. package/dist/rbac/userPlugin.js +3 -29
  164. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  165. package/dist/realtime/changeStreamWatcher.js +499 -764
  166. package/dist/realtime/deprecation.d.ts +1 -0
  167. package/dist/realtime/deprecation.js +9 -10
  168. package/dist/realtime/queryMatcher.js +110 -191
  169. package/dist/realtime/queryStore.js +35 -118
  170. package/dist/realtime/realtimeApp.d.ts +1 -0
  171. package/dist/realtime/realtimeApp.js +248 -401
  172. package/dist/realtime/registry.js +19 -30
  173. package/dist/realtime/sessionRevalidation.js +132 -358
  174. package/dist/realtime/socketAuth.js +89 -208
  175. package/dist/realtime/socketUser.js +10 -56
  176. package/dist/requestContext.js +93 -139
  177. package/dist/schemaMetadata.js +181 -265
  178. package/dist/scriptRunner.js +96 -266
  179. package/dist/scrubAdminFields.js +36 -108
  180. package/dist/secretProviders.js +130 -299
  181. package/dist/seedRunner.js +221 -514
  182. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  183. package/dist/sync/adminBroadcastScope.js +82 -0
  184. package/dist/sync/adminWindowAccess.d.ts +13 -0
  185. package/dist/sync/adminWindowAccess.js +25 -0
  186. package/dist/sync/adminWindowMutation.d.ts +88 -0
  187. package/dist/sync/adminWindowMutation.js +176 -0
  188. package/dist/sync/executors.d.ts +9 -3
  189. package/dist/sync/executors.js +425 -598
  190. package/dist/sync/loadHarness.js +392 -689
  191. package/dist/sync/models.js +181 -341
  192. package/dist/sync/mutationHandler.d.ts +5 -2
  193. package/dist/sync/mutationHandler.js +549 -697
  194. package/dist/sync/registrationSideEffects.js +41 -95
  195. package/dist/sync/registry.js +31 -47
  196. package/dist/sync/routes.d.ts +13 -0
  197. package/dist/sync/routes.js +484 -760
  198. package/dist/sync/scripts/compactTombstones.js +83 -228
  199. package/dist/sync/serialize.js +18 -58
  200. package/dist/sync/socketHandlers.d.ts +8 -2
  201. package/dist/sync/socketHandlers.js +271 -402
  202. package/dist/sync/streams.d.ts +2 -0
  203. package/dist/sync/streams.js +54 -116
  204. package/dist/sync/syncApp.d.ts +2 -1
  205. package/dist/sync/syncApp.js +14 -16
  206. package/dist/sync/syncBatch.d.ts +5 -2
  207. package/dist/sync/syncBatch.js +63 -168
  208. package/dist/sync/syncSeqPlugin.js +430 -702
  209. package/dist/sync/types.d.ts +18 -0
  210. package/dist/syncConsents.js +113 -253
  211. package/dist/terrenoApp.d.ts +29 -0
  212. package/dist/terrenoApp.js +184 -257
  213. package/dist/tests/createTestData.d.ts +1 -3
  214. package/dist/tests/createTestData.js +147 -259
  215. package/dist/tests/models.d.ts +1 -0
  216. package/dist/tests/models.js +23 -56
  217. package/dist/tests/mongoTestSetup.js +42 -103
  218. package/dist/tests/testHelper.d.ts +0 -5
  219. package/dist/tests/testHelper.js +32 -101
  220. package/dist/tests.js +12 -51
  221. package/dist/transformers.js +61 -164
  222. package/dist/types/authToken.d.ts +3 -3
  223. package/dist/types/mcpServiceToken.d.ts +2 -2
  224. package/dist/types/membership.d.ts +23 -0
  225. package/dist/types/membership.js +2 -0
  226. package/dist/types/notification.d.ts +28 -0
  227. package/dist/types/notification.js +2 -0
  228. package/dist/types/notificationPreference.d.ts +20 -0
  229. package/dist/types/notificationPreference.js +2 -0
  230. package/dist/types/organization.d.ts +36 -0
  231. package/dist/types/organization.js +2 -0
  232. package/dist/utils.js +31 -93
  233. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  234. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  235. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  236. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  237. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  238. package/dist/versionCheckPlugin.js +52 -100
  239. package/dist/webhooks/headerValue.js +2 -2
  240. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  241. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  242. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  243. package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
  244. package/dist/webhooks/rawBody.d.ts +1 -0
  245. package/dist/webhooks/rawBody.js +2 -1
  246. package/dist/webhooks/timingSafeEqual.js +4 -5
  247. package/dist/webhooks/verifiers/hmac.js +17 -18
  248. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  249. package/dist/webhooks/verifiers/stripe.js +31 -65
  250. package/dist/webhooks/verifiers/twilio.js +23 -73
  251. package/dist/webhooks/webhooksApp.js +78 -177
  252. package/dist/zodOpenApi.js +2 -2
  253. package/package.json +34 -28
  254. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  255. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  256. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  257. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  258. package/src/adminTypes.ts +8 -0
  259. package/src/api.test.ts +39 -2
  260. package/src/api.ts +68 -0
  261. package/src/audit/auditApp.test.ts +243 -0
  262. package/src/audit/auditApp.ts +139 -0
  263. package/src/audit/auditEventModel.ts +160 -0
  264. package/src/audit/auditRouter.test.ts +456 -0
  265. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  266. package/src/audit/cloudTasksEnqueue.ts +104 -0
  267. package/src/audit/diff.ts +163 -0
  268. package/src/audit/processQueue.ts +69 -0
  269. package/src/audit/rbacSink.test.ts +86 -0
  270. package/src/audit/rbacSink.ts +42 -0
  271. package/src/audit/record.test.ts +402 -0
  272. package/src/audit/record.ts +329 -0
  273. package/src/auth.test.ts +1 -1
  274. package/src/auth.ts +1 -1
  275. package/src/authRecovery.test.ts +43 -0
  276. package/src/authRecovery.ts +16 -10
  277. package/src/authTokens.ts +6 -2
  278. package/src/authVerification.test.ts +22 -0
  279. package/src/betterAuth.ts +7 -0
  280. package/src/betterAuthSetup.test.ts +27 -0
  281. package/src/betterAuthSetup.ts +1 -0
  282. package/src/browserLogsRoute.ts +110 -0
  283. package/src/collectionRegistry.test.ts +8 -9
  284. package/src/collectionRegistry.ts +21 -1
  285. package/src/configurationPlugin.test.ts +1 -11
  286. package/src/express.d.ts +2 -0
  287. package/src/expressServer.test.ts +50 -2
  288. package/src/expressServer.ts +10 -0
  289. package/src/frameworkModelNames.test.ts +62 -0
  290. package/src/frameworkModelNames.ts +33 -0
  291. package/src/index.ts +76 -0
  292. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  293. package/src/mcp/auth.test.ts +34 -1
  294. package/src/mcp/handlers.test.ts +275 -0
  295. package/src/mcp/query.ts +3 -3
  296. package/src/mcp/toolGenerator.test.ts +81 -0
  297. package/src/migrations/cli.test.ts +353 -0
  298. package/src/migrations/cli.ts +283 -0
  299. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  300. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  301. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  302. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  303. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  304. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  305. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  306. package/src/migrations/generate.test.ts +333 -0
  307. package/src/migrations/generate.ts +216 -0
  308. package/src/migrations/load.test.ts +103 -0
  309. package/src/migrations/load.ts +124 -0
  310. package/src/migrations/lock.test.ts +133 -0
  311. package/src/migrations/lock.ts +118 -0
  312. package/src/migrations/runner.test.ts +504 -0
  313. package/src/migrations/runner.ts +358 -0
  314. package/src/migrations/schemaCatalog.test.ts +159 -0
  315. package/src/migrations/schemaCatalog.ts +262 -0
  316. package/src/migrations/types.ts +94 -0
  317. package/src/models/mcpServiceToken.ts +4 -3
  318. package/src/models/notification.ts +69 -0
  319. package/src/models/notificationPreference.ts +62 -0
  320. package/src/notifications/notificationService.ts +254 -0
  321. package/src/notifications/notificationsApp.test.ts +528 -0
  322. package/src/notifications/notificationsApp.ts +200 -0
  323. package/src/notifications/notificationsBeforeSend.ts +51 -0
  324. package/src/notifiers/slackNotifier.test.ts +186 -1
  325. package/src/notifiers/slackNotifier.ts +167 -8
  326. package/src/openApi.test.ts +0 -1
  327. package/src/openApi.ts +2 -1
  328. package/src/openApiBuilder.ts +14 -3
  329. package/src/openApiValidator.test.ts +221 -2
  330. package/src/openApiValidator.ts +218 -33
  331. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  332. package/src/orgs/orgContext.test.ts +259 -0
  333. package/src/orgs/orgContext.ts +151 -0
  334. package/src/orgs/orgPermissions.test.ts +105 -0
  335. package/src/orgs/orgPermissions.ts +40 -0
  336. package/src/orgs/orgPlugin.test.ts +130 -0
  337. package/src/orgs/orgPlugin.ts +70 -0
  338. package/src/orgs/orgRbac.test.ts +267 -0
  339. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  340. package/src/orgs/organizationModel.test.ts +205 -0
  341. package/src/orgs/organizationModel.ts +262 -0
  342. package/src/orgs/organizationSettings.test.ts +113 -0
  343. package/src/orgs/organizationSettings.ts +126 -0
  344. package/src/orgs/orgsApp.test.ts +382 -0
  345. package/src/orgs/orgsApp.ts +563 -0
  346. package/src/permissions.test.ts +62 -36
  347. package/src/permissions.ts +8 -30
  348. package/src/plugins.test.ts +5 -0
  349. package/src/plugins.ts +3 -0
  350. package/src/rateLimit/middleware.ts +1 -1
  351. package/src/rateLimit/mongoStore.ts +1 -0
  352. package/src/rateLimit/policies.ts +2 -2
  353. package/src/rateLimit/redisStore.ts +1 -0
  354. package/src/rbac/access.ts +11 -3
  355. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  356. package/src/rbac/modelRouterAccess.ts +3 -0
  357. package/src/rbac/permissionUtils.test.ts +26 -5
  358. package/src/rbac/resolve.test.ts +34 -2
  359. package/src/rbac/resolve.ts +26 -7
  360. package/src/rbac/roleModel.test.ts +34 -1
  361. package/src/rbac/roleModel.ts +17 -1
  362. package/src/rbac/statements.test.ts +19 -0
  363. package/src/rbac/statements.ts +19 -1
  364. package/src/rbac/types.ts +5 -0
  365. package/src/realtime/changeStreamWatcher.ts +73 -33
  366. package/src/realtime/deprecation.ts +1 -0
  367. package/src/realtime/realtime.test.ts +357 -185
  368. package/src/realtime/realtimeApp.ts +2 -1
  369. package/src/schemaMetadata.test.ts +14 -0
  370. package/src/schemaMetadata.ts +5 -5
  371. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  372. package/src/sync/adminBroadcastScope.test.ts +155 -0
  373. package/src/sync/adminBroadcastScope.ts +123 -0
  374. package/src/sync/adminWindowAccess.test.ts +57 -0
  375. package/src/sync/adminWindowAccess.ts +32 -0
  376. package/src/sync/adminWindowMutation.test.ts +450 -0
  377. package/src/sync/adminWindowMutation.ts +283 -0
  378. package/src/sync/executors.ts +33 -6
  379. package/src/sync/integration.test.ts +2 -2
  380. package/src/sync/mutationHandler.test.ts +277 -1
  381. package/src/sync/mutationHandler.ts +171 -29
  382. package/src/sync/registry.ts +4 -0
  383. package/src/sync/routes.ts +52 -8
  384. package/src/sync/socketHandlers.ts +154 -58
  385. package/src/sync/streams.ts +6 -0
  386. package/src/sync/sync.test.ts +3 -2
  387. package/src/sync/syncApp.ts +2 -1
  388. package/src/sync/syncBatch.ts +7 -2
  389. package/src/sync/syncRoutes.test.ts +297 -3
  390. package/src/sync/syncSocket.test.ts +229 -0
  391. package/src/sync/types.ts +20 -0
  392. package/src/terrenoApp.migrations.test.ts +114 -0
  393. package/src/terrenoApp.test.ts +41 -0
  394. package/src/terrenoApp.ts +97 -31
  395. package/src/tests/createTestData.ts +2 -2
  396. package/src/tests/models.ts +10 -2
  397. package/src/tests/testHelper.ts +1 -7
  398. package/src/types/authToken.ts +2 -4
  399. package/src/types/mcpServiceToken.ts +1 -7
  400. package/src/types/membership.ts +48 -0
  401. package/src/types/notification.ts +34 -0
  402. package/src/types/notificationPreference.ts +28 -0
  403. package/src/types/organization.ts +49 -0
  404. package/src/types.d.ts +1 -0
  405. package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
  406. package/src/webhooks/rawBody.test.ts +33 -0
  407. package/src/webhooks/rawBody.ts +1 -0
  408. package/tsconfig.json +13 -54
  409. package/tsconfig.typedoc.json +4 -1
  410. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  411. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  412. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -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;