@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,15 +1,4 @@
1
1
  "use strict";
2
- var __assign = (this && this.__assign) || function () {
3
- __assign = Object.assign || function(t) {
4
- for (var s, i = 1, n = arguments.length; i < n; i++) {
5
- s = arguments[i];
6
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
- t[p] = s[p];
8
- }
9
- return t;
10
- };
11
- return __assign.apply(this, arguments);
12
- };
13
2
  var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
14
3
  if (k2 === undefined) k2 = k;
15
4
  var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -43,84 +32,41 @@ var __importStar = (this && this.__importStar) || (function () {
43
32
  return result;
44
33
  };
45
34
  })();
46
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
47
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
48
- return new (P || (P = Promise))(function (resolve, reject) {
49
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
50
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
51
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
52
- step((generator = generator.apply(thisArg, _arguments || [])).next());
53
- });
54
- };
55
- var __generator = (this && this.__generator) || function (thisArg, body) {
56
- 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);
57
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
58
- function verb(n) { return function (v) { return step([n, v]); }; }
59
- function step(op) {
60
- if (f) throw new TypeError("Generator is already executing.");
61
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
62
- 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;
63
- if (y = 0, t) op = [op[0] & 2, t.value];
64
- switch (op[0]) {
65
- case 0: case 1: t = op; break;
66
- case 4: _.label++; return { value: op[1], done: false };
67
- case 5: _.label++; y = op[1]; op = [0]; continue;
68
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
69
- default:
70
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
71
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
72
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
73
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
74
- if (t[2]) _.ops.pop();
75
- _.trys.pop(); continue;
76
- }
77
- op = body.call(thisArg, _);
78
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
79
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
80
- }
81
- };
82
- var __values = (this && this.__values) || function(o) {
83
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
84
- if (m) return m.call(o);
85
- if (o && typeof o.length === "number") return {
86
- next: function () {
87
- if (o && i >= o.length) o = void 0;
88
- return { value: o && o[i++], done: !o };
89
- }
90
- };
91
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
92
- };
93
35
  var __importDefault = (this && this.__importDefault) || function (mod) {
94
36
  return (mod && mod.__esModule) ? mod : { "default": mod };
95
37
  };
96
38
  Object.defineProperty(exports, "__esModule", { value: true });
97
39
  exports.TerrenoApp = void 0;
98
- var node_events_1 = require("node:events");
99
- var node_http_1 = require("node:http");
100
- var Sentry = __importStar(require("@sentry/bun"));
101
- var cors_1 = __importDefault(require("cors"));
102
- var express_1 = __importDefault(require("express"));
103
- var qs_1 = __importDefault(require("qs"));
104
- var auth_1 = require("./auth");
105
- var betterAuthSetup_1 = require("./betterAuthSetup");
106
- var configurationApp_1 = require("./configurationApp");
107
- var errors_1 = require("./errors");
108
- var expressServer_1 = require("./expressServer");
109
- var githubAuth_1 = require("./githubAuth");
110
- var logger_1 = require("./logger");
111
- var server_1 = require("./mcp/server");
112
- var serviceTokens_1 = require("./mcp/serviceTokens");
113
- var middleware_1 = require("./middleware");
114
- var openApiCompat_1 = require("./openApiCompat");
115
- var openApiEtag_1 = require("./openApiEtag");
116
- var applyTrustProxy_1 = require("./rateLimit/applyTrustProxy");
117
- var createStore_1 = require("./rateLimit/createStore");
118
- var middleware_2 = require("./rateLimit/middleware");
119
- var realtimeApp_1 = require("./realtime/realtimeApp");
120
- var requestContext_1 = require("./requestContext");
121
- var registry_1 = require("./sync/registry");
122
- var index_1 = __importDefault(require("./vendor/wesleytodd-openapi/index"));
123
- var rawBody_1 = require("./webhooks/rawBody");
40
+ const node_events_1 = require("node:events");
41
+ const node_http_1 = require("node:http");
42
+ const Sentry = __importStar(require("@sentry/bun"));
43
+ const cors_1 = __importDefault(require("cors"));
44
+ const express_1 = __importDefault(require("express"));
45
+ const mongoose_1 = __importDefault(require("mongoose"));
46
+ const qs_1 = __importDefault(require("qs"));
47
+ const auth_1 = require("./auth");
48
+ const betterAuthSetup_1 = require("./betterAuthSetup");
49
+ const browserLogsRoute_1 = require("./browserLogsRoute");
50
+ const configurationApp_1 = require("./configurationApp");
51
+ const errors_1 = require("./errors");
52
+ const expressServer_1 = require("./expressServer");
53
+ const githubAuth_1 = require("./githubAuth");
54
+ const logger_1 = require("./logger");
55
+ const server_1 = require("./mcp/server");
56
+ const serviceTokens_1 = require("./mcp/serviceTokens");
57
+ const middleware_1 = require("./middleware");
58
+ const runner_1 = require("./migrations/runner");
59
+ const openApiCompat_1 = require("./openApiCompat");
60
+ const openApiEtag_1 = require("./openApiEtag");
61
+ const orgsApp_1 = require("./orgs/orgsApp");
62
+ const applyTrustProxy_1 = require("./rateLimit/applyTrustProxy");
63
+ const createStore_1 = require("./rateLimit/createStore");
64
+ const middleware_2 = require("./rateLimit/middleware");
65
+ const realtimeApp_1 = require("./realtime/realtimeApp");
66
+ const requestContext_1 = require("./requestContext");
67
+ const registry_1 = require("./sync/registry");
68
+ const index_1 = __importDefault(require("./vendor/wesleytodd-openapi/index"));
69
+ const rawBody_1 = require("./webhooks/rawBody");
124
70
  /**
125
71
  * Fluent API for building Express applications with Terreno framework.
126
72
  *
@@ -183,17 +129,19 @@ var rawBody_1 = require("./webhooks/rawBody");
183
129
  * @see TerrenoPlugin for creating reusable plugins
184
130
  * @see modelRouter for creating CRUD route registrations
185
131
  */
186
- var TerrenoApp = /** @class */ (function () {
132
+ class TerrenoApp {
133
+ options;
134
+ registrations = [];
135
+ middlewareFns = [];
136
+ configurationApp = null;
137
+ adminEvents = new node_events_1.EventEmitter();
138
+ bootPromise = Promise.resolve();
187
139
  /**
188
140
  * Create a new TerrenoApp builder.
189
141
  *
190
142
  * @param options - Application configuration options including user model and auth settings
191
143
  */
192
- function TerrenoApp(options) {
193
- this.registrations = [];
194
- this.middlewareFns = [];
195
- this.configurationApp = null;
196
- this.adminEvents = new node_events_1.EventEmitter();
144
+ constructor(options) {
197
145
  this.options = options;
198
146
  this.adminEvents.setMaxListeners(50);
199
147
  }
@@ -217,35 +165,34 @@ var TerrenoApp = /** @class */ (function () {
217
165
  * app.register(todoRouter).register(healthPlugin);
218
166
  * ```
219
167
  */
220
- TerrenoApp.prototype.register = function (registration) {
168
+ register(registration) {
221
169
  this.registrations.push(registration);
222
170
  return this;
223
- };
171
+ }
224
172
  /**
225
173
  * Returns registered model routers and plugins in mount order.
226
174
  */
227
- TerrenoApp.prototype.getRegistrations = function () {
175
+ getRegistrations() {
228
176
  return this.registrations;
229
- };
177
+ }
230
178
  /**
231
179
  * Returns only TerrenoPlugin registrations (excludes model routers).
232
180
  */
233
- TerrenoApp.prototype.getPlugins = function () {
234
- var _this = this;
235
- return this.registrations.filter(function (registration) { return !_this.isModelRouterRegistration(registration); });
236
- };
237
- TerrenoApp.prototype.on = function (event, listener) {
181
+ getPlugins() {
182
+ return this.registrations.filter((registration) => !this.isModelRouterRegistration(registration));
183
+ }
184
+ on(event, listener) {
238
185
  this.adminEvents.on(event, listener);
239
186
  return this;
240
- };
241
- TerrenoApp.prototype.off = function (event, listener) {
187
+ }
188
+ off(event, listener) {
242
189
  this.adminEvents.off(event, listener);
243
190
  return this;
244
- };
191
+ }
245
192
  /** @internal Emits scrubbed admin model change events from modelRouter hooks. */
246
- TerrenoApp.prototype.emitAdminModelChanged = function (payload) {
193
+ emitAdminModelChanged(payload) {
247
194
  this.adminEvents.emit("admin:model.changed", payload);
248
- };
195
+ }
249
196
  /**
250
197
  * Add custom Express middleware to the application.
251
198
  *
@@ -263,10 +210,10 @@ var TerrenoApp = /** @class */ (function () {
263
210
  * });
264
211
  * ```
265
212
  */
266
- TerrenoApp.prototype.addMiddleware = function (fn) {
213
+ addMiddleware(fn) {
267
214
  this.middlewareFns.push(fn);
268
215
  return this;
269
- };
216
+ }
270
217
  /**
271
218
  * Register a configuration model with the application.
272
219
  *
@@ -289,10 +236,10 @@ var TerrenoApp = /** @class */ (function () {
289
236
  * .start();
290
237
  * ```
291
238
  */
292
- TerrenoApp.prototype.configure = function (model, options) {
293
- this.configurationApp = new configurationApp_1.ConfigurationApp(__assign({ model: model }, options));
239
+ configure(model, options) {
240
+ this.configurationApp = new configurationApp_1.ConfigurationApp({ model, ...options });
294
241
  return this;
295
- };
242
+ }
296
243
  /**
297
244
  * Build the Express application without starting the server.
298
245
  *
@@ -317,87 +264,75 @@ var TerrenoApp = /** @class */ (function () {
317
264
  * await request(app).get("/todos").expect(200);
318
265
  * ```
319
266
  */
320
- TerrenoApp.prototype.build = function () {
321
- var e_1, _a, e_2, _b;
322
- var _this = this;
323
- var _c, _d, _e, _f, _g, _h;
267
+ build() {
324
268
  (0, logger_1.setupLogging)(this.options.loggingOptions);
325
- var app = (0, express_1.default)();
326
- var options = this.options;
269
+ const app = (0, express_1.default)();
270
+ const options = this.options;
327
271
  // Record mount paths on layers for Express 5 → OpenAPI compat
328
272
  (0, openApiCompat_1.patchAppUse)(app);
329
- app.set("query parser", function (str) { var _a; return qs_1.default.parse(str, { arrayLimit: (_a = options.arrayLimit) !== null && _a !== void 0 ? _a : 200 }); });
273
+ app.set("query parser", (str) => qs_1.default.parse(str, { arrayLimit: options.arrayLimit ?? 200 }));
330
274
  app.use(requestContext_1.requestContextMiddleware);
331
- app.use((0, cors_1.default)({ credentials: true, origin: (_c = options.corsOrigin) !== null && _c !== void 0 ? _c : "*" }));
275
+ app.use((0, cors_1.default)({ credentials: true, origin: options.corsOrigin ?? "*" }));
332
276
  if (options.beforeJsonSetup) {
333
277
  options.beforeJsonSetup(app);
334
278
  }
335
- try {
336
- // Apply custom middleware before JSON parsing
337
- for (var _j = __values(this.middlewareFns), _k = _j.next(); !_k.done; _k = _j.next()) {
338
- var fn = _k.value;
339
- if (fn.length <= 3) {
340
- // express.RequestHandler (req, res, next)
341
- app.use(fn);
342
- }
343
- else {
344
- // Function that receives the app
345
- fn(app);
346
- }
279
+ // Apply custom middleware before JSON parsing
280
+ for (const fn of this.middlewareFns) {
281
+ if (fn.length <= 3) {
282
+ // express.RequestHandler (req, res, next)
283
+ app.use(fn);
347
284
  }
348
- }
349
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
350
- finally {
351
- try {
352
- if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
285
+ else {
286
+ // Function that receives the app
287
+ fn(app);
353
288
  }
354
- finally { if (e_1) throw e_1.error; }
355
289
  }
356
290
  app.use(express_1.default.json(rawBody_1.jsonBodyParserOptions));
357
291
  app.use(express_1.default.urlencoded(rawBody_1.urlencodedBodyParserOptions));
358
292
  // JWT decode before rate limiting so authenticated keys use userId.
359
293
  // Auth routes mount after the limiter so login is in the auth bucket.
360
294
  (0, auth_1.setupAuth)(app, options.userModel);
361
- app.use(function (req, res, next) {
295
+ app.use((req, res, next) => {
362
296
  (0, requestContext_1.updateRequestContextFromRequest)(req, res);
363
297
  next();
364
298
  });
365
- var betterAuthForLimiter = this.registrations.find(function (registration) {
366
- return "getAuth" in registration &&
367
- typeof registration.getAuth === "function";
368
- });
369
- if (betterAuthForLimiter === null || betterAuthForLimiter === void 0 ? void 0 : betterAuthForLimiter.ensureAuth) {
370
- var auth = betterAuthForLimiter.ensureAuth();
299
+ const betterAuthForLimiter = this.registrations.find((registration) => "getAuth" in registration &&
300
+ typeof registration.getAuth === "function");
301
+ if (betterAuthForLimiter?.ensureAuth) {
302
+ const auth = betterAuthForLimiter.ensureAuth();
371
303
  app.use((0, betterAuthSetup_1.createBetterAuthSessionMiddleware)(auth, options.userModel));
372
- (_d = betterAuthForLimiter.markSessionMiddlewareMounted) === null || _d === void 0 ? void 0 : _d.call(betterAuthForLimiter);
304
+ betterAuthForLimiter.markSessionMiddlewareMounted?.();
373
305
  }
374
306
  if (options.rateLimit) {
375
- var betterAuthBasePath = (_e = options.rateLimit.betterAuthBasePath) !== null && _e !== void 0 ? _e : (_f = betterAuthForLimiter === null || betterAuthForLimiter === void 0 ? void 0 : betterAuthForLimiter.getBetterAuthBasePath) === null || _f === void 0 ? void 0 : _f.call(betterAuthForLimiter);
376
- var rateLimit = __assign(__assign({}, options.rateLimit), (betterAuthBasePath ? { betterAuthBasePath: betterAuthBasePath } : {}));
307
+ const betterAuthBasePath = options.rateLimit.betterAuthBasePath ?? betterAuthForLimiter?.getBetterAuthBasePath?.();
308
+ const rateLimit = {
309
+ ...options.rateLimit,
310
+ ...(betterAuthBasePath ? { betterAuthBasePath } : {}),
311
+ };
377
312
  (0, applyTrustProxy_1.applyRateLimitTrustProxy)(app, rateLimit);
378
- var store = (0, createStore_1.createRateLimitStore)(rateLimit);
313
+ const store = (0, createStore_1.createRateLimitStore)(rateLimit);
379
314
  app.use((0, middleware_2.createRateLimitMiddleware)(store, rateLimit));
380
315
  }
316
+ (0, browserLogsRoute_1.addTerrenoDevBrowserLogsRoute)(app);
381
317
  if (!options.authOptions) {
382
318
  options.authOptions = {};
383
319
  }
384
- var authOptions = options.authOptions;
320
+ const authOptions = options.authOptions;
385
321
  (0, auth_1.addAuthRoutes)(app, options.userModel, authOptions);
386
322
  if (options.logRequests !== false) {
387
323
  app.use(expressServer_1.logRequests);
388
324
  }
389
325
  // Store logging options on the response locals
390
- app.use(function (_req, res, next) {
326
+ app.use((_req, res, next) => {
391
327
  res.locals.loggingOptions = options.loggingOptions;
392
328
  next();
393
329
  });
394
330
  // Sentry scopes
395
- app.use(function (req, _res, next) {
396
- var _a, _b;
397
- var context = (0, requestContext_1.getCurrentRequestContext)();
398
- var transactionId = req.header("X-Transaction-ID");
399
- var sessionId = (_a = context === null || context === void 0 ? void 0 : context.sessionId) !== null && _a !== void 0 ? _a : req.header("X-Session-ID");
400
- if (context === null || context === void 0 ? void 0 : context.requestId) {
331
+ app.use((req, _res, next) => {
332
+ const context = (0, requestContext_1.getCurrentRequestContext)();
333
+ const transactionId = req.header("X-Transaction-ID");
334
+ const sessionId = context?.sessionId ?? req.header("X-Session-ID");
335
+ if (context?.requestId) {
401
336
  Sentry.getCurrentScope().setTag("request_id", context.requestId);
402
337
  }
403
338
  if (transactionId) {
@@ -406,7 +341,7 @@ var TerrenoApp = /** @class */ (function () {
406
341
  if (sessionId) {
407
342
  Sentry.getCurrentScope().setTag("session_id", sessionId);
408
343
  }
409
- if ((_b = req.user) === null || _b === void 0 ? void 0 : _b._id) {
344
+ if (req.user?._id) {
410
345
  Sentry.getCurrentScope().setTag("user", String(req.user._id));
411
346
  }
412
347
  next();
@@ -415,7 +350,7 @@ var TerrenoApp = /** @class */ (function () {
415
350
  app.use(openApiCompat_1.openApiCompatMiddleware);
416
351
  app.use(openApiEtag_1.openApiEtagMiddleware);
417
352
  app.use(middleware_1.jsonResponseRequestIdMiddleware);
418
- var oapi = (0, index_1.default)({
353
+ const oapi = (0, index_1.default)({
419
354
  info: {
420
355
  description: "Generated docs from an Express api",
421
356
  title: "Express Application",
@@ -436,50 +371,31 @@ var TerrenoApp = /** @class */ (function () {
436
371
  if (this.configurationApp) {
437
372
  this.configurationApp.register(app);
438
373
  }
439
- try {
440
- // Mount registered model routers and plugins
441
- for (var _l = __values(this.registrations), _m = _l.next(); !_m.done; _m = _l.next()) {
442
- var registration = _m.value;
443
- if (this.isModelRouterRegistration(registration)) {
444
- var router = registration._buildWithContext({
445
- accessControl: options.accessControl,
446
- openApi: oapi,
447
- routePath: registration.path,
448
- terrenoApp: this,
449
- });
450
- app.use(registration.path, router);
451
- }
452
- else {
453
- registration.register(app, oapi, this);
454
- }
374
+ // Mount registered model routers and plugins
375
+ for (const registration of this.registrations) {
376
+ if (this.isModelRouterRegistration(registration)) {
377
+ const router = registration._buildWithContext({
378
+ accessControl: options.accessControl,
379
+ openApi: oapi,
380
+ routePath: registration.path,
381
+ terrenoApp: this,
382
+ });
383
+ app.use(registration.path, router);
455
384
  }
456
- }
457
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
458
- finally {
459
- try {
460
- if (_m && !_m.done && (_b = _l.return)) _b.call(_l);
385
+ else {
386
+ registration.register(app, oapi, this);
461
387
  }
462
- finally { if (e_2) throw e_2.error; }
463
388
  }
464
389
  // Mount MCP at POST /mcp when any model opted in or a custom tool was registered.
465
- var betterAuthPlugin = this.registrations.find(function (registration) {
466
- return "getAuth" in registration &&
467
- typeof registration.getAuth === "function";
468
- });
469
- var betterAuth = (_h = (_g = betterAuthPlugin === null || betterAuthPlugin === void 0 ? void 0 : betterAuthPlugin.ensureAuth) === null || _g === void 0 ? void 0 : _g.call(betterAuthPlugin)) !== null && _h !== void 0 ? _h : betterAuthPlugin === null || betterAuthPlugin === void 0 ? void 0 : betterAuthPlugin.getAuth();
390
+ const betterAuthPlugin = this.registrations.find((registration) => "getAuth" in registration &&
391
+ typeof registration.getAuth === "function");
392
+ const betterAuth = betterAuthPlugin?.ensureAuth?.() ?? betterAuthPlugin?.getAuth();
470
393
  if (betterAuth) {
471
- authOptions.syncPasswordResetToBetterAuth = function (user, password) { return __awaiter(_this, void 0, void 0, function () {
472
- return __generator(this, function (_a) {
473
- switch (_a.label) {
474
- case 0: return [4 /*yield*/, (0, betterAuthSetup_1.applyJwtPasswordResetToBetterAuth)(betterAuth, user, password)];
475
- case 1:
476
- _a.sent();
477
- return [2 /*return*/];
478
- }
479
- });
480
- }); };
394
+ authOptions.syncPasswordResetToBetterAuth = async (user, password) => {
395
+ await (0, betterAuthSetup_1.applyJwtPasswordResetToBetterAuth)(betterAuth, user, password);
396
+ };
481
397
  }
482
- var mcpServiceTokens = (0, serviceTokens_1.resolveMcpServiceTokensOption)(options.mcpServiceTokens);
398
+ const mcpServiceTokens = (0, serviceTokens_1.resolveMcpServiceTokensOption)(options.mcpServiceTokens);
483
399
  if (mcpServiceTokens.enabled) {
484
400
  (0, serviceTokens_1.addMcpServiceTokenRoutes)(app, {
485
401
  openApi: oapi,
@@ -487,7 +403,7 @@ var TerrenoApp = /** @class */ (function () {
487
403
  });
488
404
  }
489
405
  (0, server_1.mountMCPServer)(app, {
490
- betterAuth: betterAuth,
406
+ betterAuth,
491
407
  mcpServiceTokens: mcpServiceTokens.enabled,
492
408
  userModel: options.userModel,
493
409
  });
@@ -503,7 +419,7 @@ var TerrenoApp = /** @class */ (function () {
503
419
  app.use(errors_1.apiErrorMiddleware);
504
420
  app.use(errors_1.apiFallthroughErrorMiddleware);
505
421
  return app;
506
- };
422
+ }
507
423
  /**
508
424
  * Build the Express application and start listening on the configured port.
509
425
  *
@@ -524,79 +440,90 @@ var TerrenoApp = /** @class */ (function () {
524
440
  * .start();
525
441
  * ```
526
442
  */
527
- TerrenoApp.prototype.start = function () {
528
- var _this = this;
529
- var _a;
443
+ start() {
444
+ if (this.options.organizations) {
445
+ if (!this.options.accessControl) {
446
+ throw new errors_1.APIError({
447
+ status: 500,
448
+ title: "TerrenoApp organizations requires accessControl from createAccess({ organizations: true })",
449
+ });
450
+ }
451
+ const hasOrgsPlugin = this.registrations.some((registration) => !this.isModelRouterRegistration(registration) && registration instanceof orgsApp_1.OrgsApp);
452
+ if (!hasOrgsPlugin) {
453
+ const orgConfig = typeof this.options.organizations === "object" ? this.options.organizations : {};
454
+ this.register(new orgsApp_1.OrgsApp({
455
+ ...orgConfig,
456
+ access: this.options.accessControl,
457
+ userModel: this.options.userModel,
458
+ }));
459
+ }
460
+ }
530
461
  // If realtime option is set, auto-register the RealtimeApp plugin
531
462
  if (this.options.realtime) {
532
- var hasRealtimePlugin = this.registrations.some(function (r) { return !_this.isModelRouterRegistration(r) && r instanceof realtimeApp_1.RealtimeApp; });
463
+ const hasRealtimePlugin = this.registrations.some((r) => !this.isModelRouterRegistration(r) && r instanceof realtimeApp_1.RealtimeApp);
533
464
  if (!hasRealtimePlugin) {
534
- var realtimeConfig = typeof this.options.realtime === "object" ? this.options.realtime : {};
535
- this.register(new realtimeApp_1.RealtimeApp(__assign(__assign({}, realtimeConfig), {
465
+ const realtimeConfig = typeof this.options.realtime === "object" ? this.options.realtime : {};
466
+ this.register(new realtimeApp_1.RealtimeApp({
467
+ ...realtimeConfig,
536
468
  // Task 9.21 (D2): default the socket full-user load to this app's own user
537
469
  // model. Without it socket authorization falls back to the synthetic
538
470
  // JWT-claim user, which trusts the token's `admin` over the database and
539
471
  // carries no membership fields for tenant-scoped sync.
540
- userModel: (_a = realtimeConfig.userModel) !== null && _a !== void 0 ? _a : this.options.userModel })));
472
+ userModel: realtimeConfig.userModel ?? this.options.userModel,
473
+ }));
541
474
  }
542
475
  }
543
- var app = this.build();
476
+ const app = this.build();
477
+ this.bootPromise = this.completeStart(app);
544
478
  if (!this.options.skipListen) {
545
- var port_1 = process.env.PORT || "9000";
546
- // Await sync index creation before listening: the per-model snapshot indexes (a
547
- // failed createIndex degrades the snapshot/catch-up query to a table scan) and the
548
- // bookkeeping-model indexes enqueued by SyncApp (the unique mutationId index is what
549
- // makes duplicate mutation deliveries idempotent, and the unique stream index is what
550
- // keeps the counter upsert race from minting duplicate seqs). Either failure is a
551
- // loud startup error rather than a silent correctness cliff. No-op when no sync
552
- // models or SyncApp are registered. Detached because start() returns synchronously.
553
- void (function () { return __awaiter(_this, void 0, void 0, function () {
554
- var server, _a, _b, reg, error_1, stack;
555
- var e_3, _c;
556
- return __generator(this, function (_d) {
557
- switch (_d.label) {
558
- case 0:
559
- _d.trys.push([0, 2, , 3]);
560
- return [4 /*yield*/, (0, registry_1.ensureSyncIndexes)()];
561
- case 1:
562
- _d.sent();
563
- server = (0, node_http_1.createServer)(app);
564
- try {
565
- // Notify plugins that need access to the HTTP server (e.g. WebSocket plugins)
566
- for (_a = __values(this.registrations), _b = _a.next(); !_b.done; _b = _a.next()) {
567
- reg = _b.value;
568
- if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
569
- reg.onServerCreated(server);
570
- }
571
- }
572
- }
573
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
574
- finally {
575
- try {
576
- if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
577
- }
578
- finally { if (e_3) throw e_3.error; }
579
- }
580
- server.listen(port_1, function () {
581
- logger_1.logger.info("Listening on port ".concat(port_1));
582
- });
583
- return [3 /*break*/, 3];
584
- case 2:
585
- error_1 = _d.sent();
586
- stack = error_1 instanceof Error ? error_1.stack : String(error_1);
587
- logger_1.logger.error("Error trying to start HTTP server: ".concat(error_1, "\n").concat(stack));
588
- process.exit(1);
589
- return [3 /*break*/, 3];
590
- case 3: return [2 /*return*/];
591
- }
592
- });
593
- }); })();
479
+ void this.bootPromise.catch((error) => {
480
+ const stack = error instanceof Error ? error.stack : String(error);
481
+ logger_1.logger.error(`Error trying to start HTTP server: ${error}\n${stack}`);
482
+ process.exit(1);
483
+ });
594
484
  }
595
485
  return app;
486
+ }
487
+ /**
488
+ * Resolves after startup migrations (and listen, unless `skipListen`).
489
+ * Tests with `skipListen` should await this instead of assuming `start()` is idle.
490
+ */
491
+ whenReady() {
492
+ return this.bootPromise;
493
+ }
494
+ completeStart = async (app) => {
495
+ if (!this.options.skipListen) {
496
+ const port = process.env.PORT || "9000";
497
+ const existingServer = this.options.httpServer;
498
+ const server = existingServer ?? (0, node_http_1.createServer)(app);
499
+ if (existingServer) {
500
+ existingServer.removeAllListeners("request");
501
+ existingServer.on("request", app);
502
+ }
503
+ for (const reg of this.registrations) {
504
+ if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
505
+ reg.onServerCreated(server);
506
+ }
507
+ }
508
+ // Bind PORT before index/migration work so Cloud Run's startup probe can
509
+ // succeed while `ensureSyncIndexes` still runs. whenReady() still waits.
510
+ if (!existingServer) {
511
+ server.listen(port, () => {
512
+ logger_1.logger.info(`Listening on port ${port}`);
513
+ });
514
+ }
515
+ else {
516
+ logger_1.logger.info(`Listening on port ${port}`);
517
+ }
518
+ await (0, registry_1.ensureSyncIndexes)();
519
+ }
520
+ await (0, runner_1.runStartupMigrations)({
521
+ migrations: this.options.migrations,
522
+ mongoose: mongoose_1.default,
523
+ });
596
524
  };
597
- TerrenoApp.prototype.isModelRouterRegistration = function (registration) {
525
+ isModelRouterRegistration(registration) {
598
526
  return registration.__type === "modelRouter";
599
- };
600
- return TerrenoApp;
601
- }());
527
+ }
528
+ }
602
529
  exports.TerrenoApp = TerrenoApp;
@@ -1,8 +1,6 @@
1
- import type { CachedTestData, TestData, TestFoods, TestRequired, TestUsers } from "./types";
1
+ import type { CachedTestData, TestData, TestUsers } from "./types";
2
2
  export declare const clearTestCollections: () => Promise<void>;
3
3
  export declare const createTestUsers: () => Promise<TestUsers>;
4
- export declare const createStandardFoods: (users: TestUsers) => Promise<TestFoods>;
5
- export declare const createRequiredFixtures: () => Promise<TestRequired>;
6
4
  /** Builds the standard Terreno API test database (users, foods, required docs). */
7
5
  export declare const createTestData: () => Promise<TestData>;
8
6
  export declare const toCachedTestData: (testData: TestData) => CachedTestData;