@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
@@ -33,6 +33,13 @@ export type SyncScope = SyncScopeOwner | SyncScopeTenant | SyncScopeBroadcast |
33
33
  * (seq stamping) — validated at registration.
34
34
  */
35
35
  export interface SyncConfig {
36
+ /**
37
+ * When true, change-stream `sync:delta` emission also fans in to `{collection}|admin`
38
+ * in addition to the owner/tenant/broadcast/custom stream. Default false. App clients
39
+ * keep their existing scope; only admin window subscribers join `|admin`. Join
40
+ * permission is admin-only (same checks as `/admin/*`), not owner-stream membership.
41
+ */
42
+ adminBroadcast?: boolean;
36
43
  /** Which stream a document belongs to. Multi-tenant by default via the tenant scope. */
37
44
  scope: SyncScope;
38
45
  /**
@@ -57,6 +64,10 @@ export interface SyncConfig {
57
64
  retentionDays?: number;
58
65
  }
59
66
  export type SyncMutationOperation = "create" | "update" | "delete";
67
+ /** Explicit client marker for admin-panel windowed sync writes. */
68
+ export type SyncMutationMode = "adminWindow";
69
+ /** `sync:subscribe` / `sync:subscribed` window mode for admin fan-in (no snapshot paging). */
70
+ export type SyncSubscribeMode = "window";
60
71
  /** A single entity in a snapshot response. */
61
72
  export interface SyncEntityPayload {
62
73
  /** Document id. */
@@ -125,6 +136,13 @@ export interface SyncMutateRequest {
125
136
  data?: Record<string, unknown>;
126
137
  /** The `_syncSeq` the client last saw for this document; enables LWW conflict detection. */
127
138
  baseVersion?: number;
139
+ /**
140
+ * When `"adminWindow"`, the server applies AdminApp write semantics (RBAC,
141
+ * writeOwned, readonly/hidden stripping, audit) instead of product sync
142
+ * permissions. Ignored unless the collection is `adminBroadcast`, the caller
143
+ * has admin-window access, and AdminApp registered a write scope.
144
+ */
145
+ mutationMode?: SyncMutationMode;
128
146
  }
129
147
  /** Successful mutation acknowledgement. */
130
148
  export interface SyncAck {
@@ -6,137 +6,64 @@
6
6
  * and creates, updates, or deactivates forms to match. When content changes, a new
7
7
  * version is published so users are prompted to re-consent.
8
8
  */
9
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
10
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
11
- return new (P || (P = Promise))(function (resolve, reject) {
12
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
13
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
14
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
15
- step((generator = generator.apply(thisArg, _arguments || [])).next());
16
- });
17
- };
18
- var __generator = (this && this.__generator) || function (thisArg, body) {
19
- 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);
20
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
21
- function verb(n) { return function (v) { return step([n, v]); }; }
22
- function step(op) {
23
- if (f) throw new TypeError("Generator is already executing.");
24
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
25
- 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;
26
- if (y = 0, t) op = [op[0] & 2, t.value];
27
- switch (op[0]) {
28
- case 0: case 1: t = op; break;
29
- case 4: _.label++; return { value: op[1], done: false };
30
- case 5: _.label++; y = op[1]; op = [0]; continue;
31
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
32
- default:
33
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
34
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
35
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
36
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
37
- if (t[2]) _.ops.pop();
38
- _.trys.pop(); continue;
39
- }
40
- op = body.call(thisArg, _);
41
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
42
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
43
- }
44
- };
45
- var __read = (this && this.__read) || function (o, n) {
46
- var m = typeof Symbol === "function" && o[Symbol.iterator];
47
- if (!m) return o;
48
- var i = m.call(o), r, ar = [], e;
49
- try {
50
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
51
- }
52
- catch (error) { e = { error: error }; }
53
- finally {
54
- try {
55
- if (r && !r.done && (m = i["return"])) m.call(i);
56
- }
57
- finally { if (e) throw e.error; }
58
- }
59
- return ar;
60
- };
61
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
62
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
63
- if (ar || !(i in from)) {
64
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
65
- ar[i] = from[i];
66
- }
67
- }
68
- return to.concat(ar || Array.prototype.slice.call(from));
69
- };
70
- var __values = (this && this.__values) || function(o) {
71
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
72
- if (m) return m.call(o);
73
- if (o && typeof o.length === "number") return {
74
- next: function () {
75
- if (o && i >= o.length) o = void 0;
76
- return { value: o && o[i++], done: !o };
77
- }
78
- };
79
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
80
- };
81
9
  Object.defineProperty(exports, "__esModule", { value: true });
82
10
  exports.syncConsents = void 0;
83
- var logger_1 = require("./logger");
84
- var consentForm_1 = require("./models/consentForm");
85
- var contentEqual = function (a, b) {
86
- var aKeys = __spreadArray([], __read(a.keys()), false).sort();
87
- var bKeys = Object.keys(b).sort();
11
+ const logger_1 = require("./logger");
12
+ const consentForm_1 = require("./models/consentForm");
13
+ const contentEqual = (a, b) => {
14
+ const aKeys = [...a.keys()].sort();
15
+ const bKeys = Object.keys(b).sort();
88
16
  if (aKeys.length !== bKeys.length) {
89
17
  return false;
90
18
  }
91
- return aKeys.every(function (key, i) { return key === bKeys[i] && a.get(key) === b[key]; });
19
+ return aKeys.every((key, i) => key === bKeys[i] && a.get(key) === b[key]);
92
20
  };
93
- var formFieldsMatch = function (existing, def) {
94
- var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
21
+ const formFieldsMatch = (existing, def) => {
95
22
  if (existing.title !== def.title) {
96
23
  return false;
97
24
  }
98
25
  if (existing.type !== def.type) {
99
26
  return false;
100
27
  }
101
- if (existing.order !== ((_a = def.order) !== null && _a !== void 0 ? _a : 0)) {
28
+ if (existing.order !== (def.order ?? 0)) {
102
29
  return false;
103
30
  }
104
- if (existing.required !== ((_b = def.required) !== null && _b !== void 0 ? _b : true)) {
31
+ if (existing.required !== (def.required ?? true)) {
105
32
  return false;
106
33
  }
107
- if (existing.requireScrollToBottom !== ((_c = def.requireScrollToBottom) !== null && _c !== void 0 ? _c : false)) {
34
+ if (existing.requireScrollToBottom !== (def.requireScrollToBottom ?? false)) {
108
35
  return false;
109
36
  }
110
- if (existing.captureSignature !== ((_d = def.captureSignature) !== null && _d !== void 0 ? _d : false)) {
37
+ if (existing.captureSignature !== (def.captureSignature ?? false)) {
111
38
  return false;
112
39
  }
113
- if (existing.agreeButtonText !== ((_e = def.agreeButtonText) !== null && _e !== void 0 ? _e : "I Agree")) {
40
+ if (existing.agreeButtonText !== (def.agreeButtonText ?? "I Agree")) {
114
41
  return false;
115
42
  }
116
- if (existing.allowDecline !== ((_f = def.allowDecline) !== null && _f !== void 0 ? _f : false)) {
43
+ if (existing.allowDecline !== (def.allowDecline ?? false)) {
117
44
  return false;
118
45
  }
119
- if (existing.declineButtonText !== ((_g = def.declineButtonText) !== null && _g !== void 0 ? _g : "Decline")) {
46
+ if (existing.declineButtonText !== (def.declineButtonText ?? "Decline")) {
120
47
  return false;
121
48
  }
122
- if (existing.defaultLocale !== ((_h = def.defaultLocale) !== null && _h !== void 0 ? _h : "en")) {
49
+ if (existing.defaultLocale !== (def.defaultLocale ?? "en")) {
123
50
  return false;
124
51
  }
125
52
  if (!contentEqual(existing.content, def.content)) {
126
53
  return false;
127
54
  }
128
- var existingCheckboxes = (_j = existing.checkboxes) !== null && _j !== void 0 ? _j : [];
129
- var defCheckboxes = (_k = def.checkboxes) !== null && _k !== void 0 ? _k : [];
55
+ const existingCheckboxes = existing.checkboxes ?? [];
56
+ const defCheckboxes = def.checkboxes ?? [];
130
57
  if (existingCheckboxes.length !== defCheckboxes.length) {
131
58
  return false;
132
59
  }
133
- for (var i = 0; i < existingCheckboxes.length; i++) {
134
- var ec = existingCheckboxes[i];
135
- var dc = defCheckboxes[i];
136
- if (ec.label !== dc.label || ec.required !== ((_l = dc.required) !== null && _l !== void 0 ? _l : false)) {
60
+ for (let i = 0; i < existingCheckboxes.length; i++) {
61
+ const ec = existingCheckboxes[i];
62
+ const dc = defCheckboxes[i];
63
+ if (ec.label !== dc.label || ec.required !== (dc.required ?? false)) {
137
64
  return false;
138
65
  }
139
- if (((_m = ec.confirmationPrompt) !== null && _m !== void 0 ? _m : undefined) !== ((_o = dc.confirmationPrompt) !== null && _o !== void 0 ? _o : undefined)) {
66
+ if ((ec.confirmationPrompt ?? undefined) !== (dc.confirmationPrompt ?? undefined)) {
140
67
  return false;
141
68
  }
142
69
  }
@@ -170,165 +97,98 @@ var formFieldsMatch = function (existing, def) {
170
97
  * });
171
98
  * ```
172
99
  */
173
- var syncConsents = function (definitions_1) {
174
- var args_1 = [];
175
- for (var _i = 1; _i < arguments.length; _i++) {
176
- args_1[_i - 1] = arguments[_i];
177
- }
178
- return __awaiter(void 0, __spreadArray([definitions_1], __read(args_1), false), void 0, function (definitions, options) {
179
- var _a, deactivateRemoved, _b, dryRun, result, slugs, activeForms, activeBySlug, slugs_1, slugs_1_1, slug, def, existing, newVersion, e_1_1, activeBySlug_1, activeBySlug_1_1, _c, slug, e_2_1, summary;
180
- var e_1, _d, e_2, _e;
181
- var _f, _g, _h, _j;
182
- if (options === void 0) { options = {}; }
183
- return __generator(this, function (_k) {
184
- switch (_k.label) {
185
- case 0:
186
- _a = options.deactivateRemoved, deactivateRemoved = _a === void 0 ? false : _a, _b = options.dryRun, dryRun = _b === void 0 ? false : _b;
187
- result = {
188
- created: [],
189
- deactivated: [],
190
- unchanged: [],
191
- updated: [],
192
- };
193
- slugs = Object.keys(definitions);
194
- return [4 /*yield*/, consentForm_1.ConsentForm.find({ active: true })];
195
- case 1:
196
- activeForms = _k.sent();
197
- activeBySlug = new Map(activeForms.map(function (f) { return [f.slug, f]; }));
198
- _k.label = 2;
199
- case 2:
200
- _k.trys.push([2, 12, 13, 14]);
201
- slugs_1 = __values(slugs), slugs_1_1 = slugs_1.next();
202
- _k.label = 3;
203
- case 3:
204
- if (!!slugs_1_1.done) return [3 /*break*/, 11];
205
- slug = slugs_1_1.value;
206
- def = definitions[slug];
207
- existing = activeBySlug.get(slug);
208
- if (!!existing) return [3 /*break*/, 6];
209
- // No active form for this slug — create version 1
210
- logger_1.logger.info("syncConsents: creating \"".concat(slug, "\""), { dryRun: dryRun });
211
- if (!!dryRun) return [3 /*break*/, 5];
212
- return [4 /*yield*/, consentForm_1.ConsentForm.create({
213
- active: true,
214
- agreeButtonText: def.agreeButtonText,
215
- allowDecline: def.allowDecline,
216
- captureSignature: def.captureSignature,
217
- checkboxes: def.checkboxes,
218
- content: new Map(Object.entries(def.content)),
219
- declineButtonText: def.declineButtonText,
220
- defaultLocale: def.defaultLocale,
221
- order: (_f = def.order) !== null && _f !== void 0 ? _f : 0,
222
- required: (_g = def.required) !== null && _g !== void 0 ? _g : true,
223
- requireScrollToBottom: def.requireScrollToBottom,
224
- slug: slug,
225
- title: def.title,
226
- type: def.type,
227
- version: 1,
228
- })];
229
- case 4:
230
- _k.sent();
231
- _k.label = 5;
232
- case 5:
233
- result.created.push(slug);
234
- return [3 /*break*/, 10];
235
- case 6:
236
- if (formFieldsMatch(existing, def)) {
237
- result.unchanged.push(slug);
238
- return [3 /*break*/, 10];
239
- }
240
- newVersion = existing.version + 1;
241
- logger_1.logger.info("syncConsents: updating \"".concat(slug, "\" v").concat(existing.version, " -> v").concat(newVersion), {
242
- dryRun: dryRun,
243
- });
244
- if (!!dryRun) return [3 /*break*/, 9];
245
- return [4 /*yield*/, consentForm_1.ConsentForm.create({
246
- active: true,
247
- agreeButtonText: def.agreeButtonText,
248
- allowDecline: def.allowDecline,
249
- captureSignature: def.captureSignature,
250
- checkboxes: def.checkboxes,
251
- content: new Map(Object.entries(def.content)),
252
- declineButtonText: def.declineButtonText,
253
- defaultLocale: def.defaultLocale,
254
- order: (_h = def.order) !== null && _h !== void 0 ? _h : 0,
255
- required: (_j = def.required) !== null && _j !== void 0 ? _j : true,
256
- requireScrollToBottom: def.requireScrollToBottom,
257
- slug: slug,
258
- title: def.title,
259
- type: def.type,
260
- version: newVersion,
261
- })];
262
- case 7:
263
- _k.sent();
264
- return [4 /*yield*/, consentForm_1.ConsentForm.updateMany({ _id: { $ne: undefined }, slug: slug, version: { $lt: newVersion } }, { active: false })];
265
- case 8:
266
- _k.sent();
267
- _k.label = 9;
268
- case 9:
269
- result.updated.push(slug);
270
- _k.label = 10;
271
- case 10:
272
- slugs_1_1 = slugs_1.next();
273
- return [3 /*break*/, 3];
274
- case 11: return [3 /*break*/, 14];
275
- case 12:
276
- e_1_1 = _k.sent();
277
- e_1 = { error: e_1_1 };
278
- return [3 /*break*/, 14];
279
- case 13:
280
- try {
281
- if (slugs_1_1 && !slugs_1_1.done && (_d = slugs_1.return)) _d.call(slugs_1);
282
- }
283
- finally { if (e_1) throw e_1.error; }
284
- return [7 /*endfinally*/];
285
- case 14:
286
- if (!deactivateRemoved) return [3 /*break*/, 23];
287
- _k.label = 15;
288
- case 15:
289
- _k.trys.push([15, 21, 22, 23]);
290
- activeBySlug_1 = __values(activeBySlug), activeBySlug_1_1 = activeBySlug_1.next();
291
- _k.label = 16;
292
- case 16:
293
- if (!!activeBySlug_1_1.done) return [3 /*break*/, 20];
294
- _c = __read(activeBySlug_1_1.value, 1), slug = _c[0];
295
- if (!!definitions[slug]) return [3 /*break*/, 19];
296
- logger_1.logger.info("syncConsents: deactivating \"".concat(slug, "\""), { dryRun: dryRun });
297
- if (!!dryRun) return [3 /*break*/, 18];
298
- return [4 /*yield*/, consentForm_1.ConsentForm.updateMany({ slug: slug }, { active: false })];
299
- case 17:
300
- _k.sent();
301
- _k.label = 18;
302
- case 18:
303
- result.deactivated.push(slug);
304
- _k.label = 19;
305
- case 19:
306
- activeBySlug_1_1 = activeBySlug_1.next();
307
- return [3 /*break*/, 16];
308
- case 20: return [3 /*break*/, 23];
309
- case 21:
310
- e_2_1 = _k.sent();
311
- e_2 = { error: e_2_1 };
312
- return [3 /*break*/, 23];
313
- case 22:
314
- try {
315
- if (activeBySlug_1_1 && !activeBySlug_1_1.done && (_e = activeBySlug_1.return)) _e.call(activeBySlug_1);
316
- }
317
- finally { if (e_2) throw e_2.error; }
318
- return [7 /*endfinally*/];
319
- case 23:
320
- summary = [
321
- result.created.length > 0 ? "created: ".concat(result.created.join(", ")) : null,
322
- result.updated.length > 0 ? "updated: ".concat(result.updated.join(", ")) : null,
323
- result.deactivated.length > 0 ? "deactivated: ".concat(result.deactivated.join(", ")) : null,
324
- result.unchanged.length > 0 ? "unchanged: ".concat(result.unchanged.join(", ")) : null,
325
- ]
326
- .filter(Boolean)
327
- .join(" | ");
328
- logger_1.logger.info("syncConsents: ".concat(dryRun ? "[DRY RUN] " : "").concat(summary || "nothing to do"));
329
- return [2 /*return*/, result];
100
+ const syncConsents = async (definitions, options = {}) => {
101
+ const { deactivateRemoved = false, dryRun = false } = options;
102
+ const result = {
103
+ created: [],
104
+ deactivated: [],
105
+ unchanged: [],
106
+ updated: [],
107
+ };
108
+ const slugs = Object.keys(definitions);
109
+ // Fetch the current active form for each slug
110
+ const activeForms = await consentForm_1.ConsentForm.find({ active: true });
111
+ const activeBySlug = new Map(activeForms.map((f) => [f.slug, f]));
112
+ for (const slug of slugs) {
113
+ const def = definitions[slug];
114
+ const existing = activeBySlug.get(slug);
115
+ if (!existing) {
116
+ // No active form for this slug — create version 1
117
+ logger_1.logger.info(`syncConsents: creating "${slug}"`, { dryRun });
118
+ if (!dryRun) {
119
+ await consentForm_1.ConsentForm.create({
120
+ active: true,
121
+ agreeButtonText: def.agreeButtonText,
122
+ allowDecline: def.allowDecline,
123
+ captureSignature: def.captureSignature,
124
+ checkboxes: def.checkboxes,
125
+ content: new Map(Object.entries(def.content)),
126
+ declineButtonText: def.declineButtonText,
127
+ defaultLocale: def.defaultLocale,
128
+ order: def.order ?? 0,
129
+ required: def.required ?? true,
130
+ requireScrollToBottom: def.requireScrollToBottom,
131
+ slug,
132
+ title: def.title,
133
+ type: def.type,
134
+ version: 1,
135
+ });
330
136
  }
137
+ result.created.push(slug);
138
+ continue;
139
+ }
140
+ if (formFieldsMatch(existing, def)) {
141
+ result.unchanged.push(slug);
142
+ continue;
143
+ }
144
+ // Content or config changed — publish a new version
145
+ const newVersion = existing.version + 1;
146
+ logger_1.logger.info(`syncConsents: updating "${slug}" v${existing.version} -> v${newVersion}`, {
147
+ dryRun,
331
148
  });
332
- });
149
+ if (!dryRun) {
150
+ await consentForm_1.ConsentForm.create({
151
+ active: true,
152
+ agreeButtonText: def.agreeButtonText,
153
+ allowDecline: def.allowDecline,
154
+ captureSignature: def.captureSignature,
155
+ checkboxes: def.checkboxes,
156
+ content: new Map(Object.entries(def.content)),
157
+ declineButtonText: def.declineButtonText,
158
+ defaultLocale: def.defaultLocale,
159
+ order: def.order ?? 0,
160
+ required: def.required ?? true,
161
+ requireScrollToBottom: def.requireScrollToBottom,
162
+ slug,
163
+ title: def.title,
164
+ type: def.type,
165
+ version: newVersion,
166
+ });
167
+ await consentForm_1.ConsentForm.updateMany({ _id: { $ne: undefined }, slug, version: { $lt: newVersion } }, { active: false });
168
+ }
169
+ result.updated.push(slug);
170
+ }
171
+ // Deactivate forms that are no longer in definitions
172
+ if (deactivateRemoved) {
173
+ for (const [slug] of activeBySlug) {
174
+ if (!definitions[slug]) {
175
+ logger_1.logger.info(`syncConsents: deactivating "${slug}"`, { dryRun });
176
+ if (!dryRun) {
177
+ await consentForm_1.ConsentForm.updateMany({ slug }, { active: false });
178
+ }
179
+ result.deactivated.push(slug);
180
+ }
181
+ }
182
+ }
183
+ const summary = [
184
+ result.created.length > 0 ? `created: ${result.created.join(", ")}` : null,
185
+ result.updated.length > 0 ? `updated: ${result.updated.join(", ")}` : null,
186
+ result.deactivated.length > 0 ? `deactivated: ${result.deactivated.join(", ")}` : null,
187
+ result.unchanged.length > 0 ? `unchanged: ${result.unchanged.join(", ")}` : null,
188
+ ]
189
+ .filter(Boolean)
190
+ .join(" | ");
191
+ logger_1.logger.info(`syncConsents: ${dryRun ? "[DRY RUN] " : ""}${summary || "nothing to do"}`);
192
+ return result;
333
193
  };
334
194
  exports.syncConsents = syncConsents;
@@ -1,3 +1,4 @@
1
+ import { type Server as HttpServer } from "node:http";
1
2
  import * as Sentry from "@sentry/bun";
2
3
  import express from "express";
3
4
  import type { AdminChangeEvent, TerrenoAppAdminEvent } from "./adminTypes";
@@ -8,6 +9,8 @@ import { type AddRoutes, type AuthOptions } from "./expressServer";
8
9
  import { type GitHubAuthOptions } from "./githubAuth";
9
10
  import { type LoggingOptions } from "./logger";
10
11
  import { type McpServiceTokensAppOption } from "./mcp/serviceTokens";
12
+ import { type StartupMigrationsOption } from "./migrations/runner";
13
+ import { type OrgsAppOptions } from "./orgs/orgsApp";
11
14
  import type { RateLimitOptions } from "./rateLimit/types";
12
15
  import type { RealtimeAppOptions } from "./realtime/types";
13
16
  import type { TerrenoPlugin } from "./terrenoPlugin";
@@ -28,6 +31,12 @@ export interface TerrenoAppOptions {
28
31
  githubAuth?: GitHubAuthOptions;
29
32
  /** Skip calling app.listen() in start() method (useful for testing) */
30
33
  skipListen?: boolean;
34
+ /**
35
+ * Already-listening HTTP server. `start()` attaches the Express app to it
36
+ * instead of creating and binding a new server, so Cloud Run can see PORT
37
+ * before MongoDB connect and plugin registration finish.
38
+ */
39
+ httpServer?: HttpServer;
31
40
  /** Sentry configuration options */
32
41
  sentryOptions?: Sentry.BunOptions;
33
42
  /** Maximum number of array items in query parameters (default: 200) */
@@ -45,6 +54,13 @@ export interface TerrenoAppOptions {
45
54
  * RBAC access controller injected into model routers and `/auth/me` enrichment.
46
55
  */
47
56
  accessControl?: import("./rbac/types").AnyTerrenoAccess;
57
+ /**
58
+ * Multi-tenant organizations. Default off so existing single-tenant apps stay unchanged.
59
+ * New apps from `terreno_bootstrap_app` pass `true`. Requires `accessControl` from
60
+ * `createAccess({ organizations: true })`. Pass `{ settingsSchema }` to type and
61
+ * validate `Organization.settings`.
62
+ */
63
+ organizations?: boolean | Omit<OrgsAppOptions, "access" | "userModel">;
48
64
  /**
49
65
  * Runs after CORS and before the `addMiddleware` chain and JSON body parsing.
50
66
  * Use to attach early middleware via `app.use(...)` before JSON parsing.
@@ -66,6 +82,12 @@ export interface TerrenoAppOptions {
66
82
  * mounts `/mcp/service-tokens` and accepts `Authorization: Bearer mcp_…` on `/mcp`.
67
83
  */
68
84
  mcpServiceTokens?: McpServiceTokensAppOption;
85
+ /**
86
+ * Versioned MongoDB migrations. `runOnStart` defaults to false. When true, wet `up`
87
+ * runs after listen and `ensureSyncIndexes`. Production still requires
88
+ * `ALLOW_MIGRATIONS=true`.
89
+ */
90
+ migrations?: StartupMigrationsOption;
69
91
  }
70
92
  /**
71
93
  * Fluent API for building Express applications with Terreno framework.
@@ -135,6 +157,7 @@ export declare class TerrenoApp {
135
157
  private middlewareFns;
136
158
  private configurationApp;
137
159
  private readonly adminEvents;
160
+ private bootPromise;
138
161
  /**
139
162
  * Create a new TerrenoApp builder.
140
163
  *
@@ -261,6 +284,12 @@ export declare class TerrenoApp {
261
284
  * ```
262
285
  */
263
286
  start(): express.Application;
287
+ /**
288
+ * Resolves after startup migrations (and listen, unless `skipListen`).
289
+ * Tests with `skipListen` should await this instead of assuming `start()` is idle.
290
+ */
291
+ whenReady(): Promise<void>;
292
+ private completeStart;
264
293
  private isModelRouterRegistration;
265
294
  }
266
295
  export {};