@terreno/api 57.2.0 → 57.4.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 (472) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +23 -7
  3. package/dist/actions.js +19 -7
  4. package/dist/adminTypes.d.ts +7 -0
  5. package/dist/adminTypes.js +6 -1
  6. package/dist/api.d.ts +14 -0
  7. package/dist/api.js +111 -60
  8. package/dist/audit/auditApp.d.ts +30 -0
  9. package/dist/audit/auditApp.js +155 -0
  10. package/dist/audit/auditEventModel.d.ts +29 -0
  11. package/dist/audit/auditEventModel.js +102 -0
  12. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  13. package/dist/audit/cloudTasksEnqueue.js +162 -0
  14. package/dist/audit/diff.d.ts +10 -0
  15. package/dist/audit/diff.js +230 -0
  16. package/dist/audit/processQueue.d.ts +6 -0
  17. package/dist/audit/processQueue.js +101 -0
  18. package/dist/audit/rbacSink.d.ts +2 -0
  19. package/dist/audit/rbacSink.js +82 -0
  20. package/dist/audit/record.d.ts +56 -0
  21. package/dist/audit/record.js +373 -0
  22. package/dist/auth.d.ts +23 -10
  23. package/dist/auth.js +97 -32
  24. package/dist/authRecovery.d.ts +5 -0
  25. package/dist/authRecovery.js +350 -0
  26. package/dist/authTokens.d.ts +8 -0
  27. package/dist/authTokens.js +162 -0
  28. package/dist/betterAuth.d.ts +39 -0
  29. package/dist/betterAuthApp.d.ts +4 -0
  30. package/dist/betterAuthApp.js +26 -8
  31. package/dist/betterAuthSetup.d.ts +44 -2
  32. package/dist/betterAuthSetup.js +288 -18
  33. package/dist/collectionRegistry.d.ts +40 -0
  34. package/dist/collectionRegistry.js +97 -0
  35. package/dist/configurationApp.d.ts +11 -2
  36. package/dist/configurationApp.js +2 -4
  37. package/dist/docLoader.js +35 -6
  38. package/dist/expressServer.d.ts +26 -3
  39. package/dist/expressServer.js +79 -11
  40. package/dist/index.d.ts +42 -1
  41. package/dist/index.js +84 -2
  42. package/dist/mcp/auth.d.ts +1 -0
  43. package/dist/mcp/auth.js +47 -25
  44. package/dist/mcp/handlers.d.ts +1 -1
  45. package/dist/mcp/handlers.js +67 -233
  46. package/dist/mcp/query.d.ts +2 -15
  47. package/dist/mcp/query.js +8 -8
  48. package/dist/mcp/registry.d.ts +1 -5
  49. package/dist/mcp/registry.js +31 -20
  50. package/dist/mcp/schemaGenerator.d.ts +2 -7
  51. package/dist/mcp/schemaGenerator.js +41 -116
  52. package/dist/mcp/server.d.ts +1 -0
  53. package/dist/mcp/server.js +1 -0
  54. package/dist/mcp/serviceTokens.d.ts +16 -0
  55. package/dist/mcp/serviceTokens.js +345 -0
  56. package/dist/mcp/types.d.ts +2 -2
  57. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  58. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  59. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  60. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  61. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  62. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  63. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  64. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  65. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  66. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  67. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  68. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  69. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  70. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  71. package/dist/migrations/generate.d.ts +17 -0
  72. package/dist/migrations/generate.js +277 -0
  73. package/dist/migrations/load.d.ts +20 -0
  74. package/dist/migrations/load.js +236 -0
  75. package/dist/migrations/lock.d.ts +13 -0
  76. package/dist/migrations/lock.js +145 -0
  77. package/dist/migrations/runner.d.ts +42 -0
  78. package/dist/migrations/runner.js +503 -0
  79. package/dist/migrations/schemaCatalog.d.ts +44 -0
  80. package/dist/migrations/schemaCatalog.js +326 -0
  81. package/dist/migrations/types.d.ts +87 -0
  82. package/dist/migrations/types.js +7 -0
  83. package/dist/models/mcpServiceToken.d.ts +3 -0
  84. package/dist/models/mcpServiceToken.js +208 -0
  85. package/dist/models/notification.d.ts +2 -0
  86. package/dist/models/notification.js +62 -0
  87. package/dist/models/notificationPreference.d.ts +2 -0
  88. package/dist/models/notificationPreference.js +49 -0
  89. package/dist/notifications/notificationService.d.ts +40 -0
  90. package/dist/notifications/notificationService.js +323 -0
  91. package/dist/notifications/notificationsApp.d.ts +18 -0
  92. package/dist/notifications/notificationsApp.js +250 -0
  93. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  94. package/dist/notifications/notificationsBeforeSend.js +77 -0
  95. package/dist/openApi.d.ts +1 -7
  96. package/dist/openApi.js +7 -6
  97. package/dist/openApiBuilder.d.ts +19 -7
  98. package/dist/openApiBuilder.js +61 -8
  99. package/dist/openApiCompat.js +1 -1
  100. package/dist/openApiValidator.d.ts +13 -1
  101. package/dist/openApiValidator.js +200 -38
  102. package/dist/orgs/orgContext.d.ts +23 -0
  103. package/dist/orgs/orgContext.js +198 -0
  104. package/dist/orgs/orgPermissions.d.ts +4 -0
  105. package/dist/orgs/orgPermissions.js +77 -0
  106. package/dist/orgs/orgPlugin.d.ts +13 -0
  107. package/dist/orgs/orgPlugin.js +84 -0
  108. package/dist/orgs/organizationModel.d.ts +13 -0
  109. package/dist/orgs/organizationModel.js +301 -0
  110. package/dist/orgs/organizationSettings.d.ts +19 -0
  111. package/dist/orgs/organizationSettings.js +120 -0
  112. package/dist/orgs/orgsApp.d.ts +28 -0
  113. package/dist/orgs/orgsApp.js +678 -0
  114. package/dist/permissions.d.ts +7 -13
  115. package/dist/permissions.js +8 -31
  116. package/dist/plugins.d.ts +14 -1
  117. package/dist/plugins.js +17 -6
  118. package/dist/populate.d.ts +2 -2
  119. package/dist/populate.js +47 -42
  120. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  121. package/dist/rateLimit/applyTrustProxy.js +17 -0
  122. package/dist/rateLimit/createStore.d.ts +2 -0
  123. package/dist/rateLimit/createStore.js +28 -0
  124. package/dist/rateLimit/memoryStore.d.ts +2 -0
  125. package/dist/rateLimit/memoryStore.js +108 -0
  126. package/dist/rateLimit/middleware.d.ts +3 -0
  127. package/dist/rateLimit/middleware.js +109 -0
  128. package/dist/rateLimit/mongoStore.d.ts +4 -0
  129. package/dist/rateLimit/mongoStore.js +123 -0
  130. package/dist/rateLimit/policies.d.ts +10 -0
  131. package/dist/rateLimit/policies.js +149 -0
  132. package/dist/rateLimit/redisStore.d.ts +4 -0
  133. package/dist/rateLimit/redisStore.js +156 -0
  134. package/dist/rateLimit/types.d.ts +54 -0
  135. package/dist/rateLimit/types.js +9 -0
  136. package/dist/rbac/access.js +35 -14
  137. package/dist/rbac/assertAllowed.d.ts +9 -0
  138. package/dist/rbac/assertAllowed.js +182 -0
  139. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  140. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  141. package/dist/rbac/modelRouterAccess.d.ts +4 -0
  142. package/dist/rbac/modelRouterAccess.js +11 -4
  143. package/dist/rbac/permissionUtils.js +3 -2
  144. package/dist/rbac/resolve.js +65 -35
  145. package/dist/rbac/roleModel.d.ts +2 -5
  146. package/dist/rbac/roleModel.js +18 -4
  147. package/dist/rbac/routes.js +15 -6
  148. package/dist/rbac/statements.d.ts +10 -1
  149. package/dist/rbac/statements.js +19 -2
  150. package/dist/rbac/types.d.ts +5 -0
  151. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  152. package/dist/realtime/changeStreamWatcher.js +110 -64
  153. package/dist/realtime/deprecation.d.ts +13 -0
  154. package/dist/realtime/deprecation.js +33 -0
  155. package/dist/realtime/realtimeApp.d.ts +2 -1
  156. package/dist/realtime/realtimeApp.js +11 -11
  157. package/dist/realtime/registry.d.ts +0 -31
  158. package/dist/realtime/registry.js +44 -31
  159. package/dist/realtime/socketAuth.d.ts +5 -5
  160. package/dist/realtime/socketAuth.js +11 -1
  161. package/dist/realtime/socketUser.d.ts +5 -1
  162. package/dist/realtime/types.d.ts +14 -4
  163. package/dist/schemaMetadata.d.ts +56 -0
  164. package/dist/schemaMetadata.js +524 -0
  165. package/dist/seedRunner.d.ts +88 -0
  166. package/dist/seedRunner.js +627 -0
  167. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  168. package/dist/sync/adminBroadcastScope.js +194 -0
  169. package/dist/sync/adminWindowAccess.d.ts +13 -0
  170. package/dist/sync/adminWindowAccess.js +96 -0
  171. package/dist/sync/adminWindowMutation.d.ts +88 -0
  172. package/dist/sync/adminWindowMutation.js +247 -0
  173. package/dist/sync/executors.d.ts +19 -3
  174. package/dist/sync/executors.js +194 -165
  175. package/dist/sync/loadHarness.js +28 -19
  176. package/dist/sync/models.js +26 -24
  177. package/dist/sync/mutationHandler.d.ts +14 -2
  178. package/dist/sync/mutationHandler.js +201 -76
  179. package/dist/sync/registrationSideEffects.d.ts +35 -0
  180. package/dist/sync/registrationSideEffects.js +151 -0
  181. package/dist/sync/registry.d.ts +2 -52
  182. package/dist/sync/registry.js +42 -187
  183. package/dist/sync/routes.d.ts +13 -0
  184. package/dist/sync/routes.js +116 -58
  185. package/dist/sync/scripts/compactTombstones.js +0 -2
  186. package/dist/sync/socketHandlers.d.ts +8 -2
  187. package/dist/sync/socketHandlers.js +144 -50
  188. package/dist/sync/streams.d.ts +2 -0
  189. package/dist/sync/streams.js +7 -1
  190. package/dist/sync/syncApp.d.ts +4 -3
  191. package/dist/sync/syncApp.js +5 -4
  192. package/dist/sync/syncBatch.d.ts +5 -2
  193. package/dist/sync/syncBatch.js +7 -6
  194. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  195. package/dist/sync/syncSeqPlugin.js +20 -16
  196. package/dist/sync/types.d.ts +18 -0
  197. package/dist/terrenoApp.d.ts +48 -5
  198. package/dist/terrenoApp.js +157 -72
  199. package/dist/tests/createTestData.d.ts +1 -3
  200. package/dist/tests/createTestData.js +3 -5
  201. package/dist/tests/models.d.ts +3 -0
  202. package/dist/tests/models.js +15 -2
  203. package/dist/tests/testHelper.d.ts +0 -5
  204. package/dist/tests/testHelper.js +2 -9
  205. package/dist/types/authToken.d.ts +33 -0
  206. package/dist/types/authToken.js +2 -0
  207. package/dist/types/mcpServiceToken.d.ts +41 -0
  208. package/dist/types/mcpServiceToken.js +2 -0
  209. package/dist/types/membership.d.ts +23 -0
  210. package/dist/types/membership.js +2 -0
  211. package/dist/types/notification.d.ts +28 -0
  212. package/dist/types/notification.js +2 -0
  213. package/dist/types/notificationPreference.d.ts +20 -0
  214. package/dist/types/notificationPreference.js +2 -0
  215. package/dist/types/organization.d.ts +36 -0
  216. package/dist/types/organization.js +2 -0
  217. package/dist/webhooks/headerValue.d.ts +2 -0
  218. package/dist/webhooks/headerValue.js +14 -0
  219. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  220. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  221. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  222. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  223. package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
  224. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  225. package/dist/webhooks/rawBody.d.ts +15 -0
  226. package/dist/webhooks/rawBody.js +23 -0
  227. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  228. package/dist/webhooks/timingSafeEqual.js +17 -0
  229. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  230. package/dist/webhooks/verifiers/hmac.js +49 -0
  231. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  232. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  233. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  234. package/dist/webhooks/verifiers/stripe.js +99 -0
  235. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  236. package/dist/webhooks/verifiers/twilio.js +112 -0
  237. package/dist/webhooks/webhooksApp.d.ts +33 -0
  238. package/dist/webhooks/webhooksApp.js +195 -0
  239. package/package.json +32 -27
  240. package/src/__snapshots__/openApi.test.ts.snap +444 -36
  241. package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
  242. package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
  243. package/src/actions.ts +20 -13
  244. package/src/adminModelRouter.test.ts +133 -0
  245. package/src/adminTypes.ts +8 -0
  246. package/src/api.arrayOperations.test.ts +43 -31
  247. package/src/api.hooks.test.ts +38 -29
  248. package/src/api.query.test.ts +31 -31
  249. package/src/api.test.ts +133 -97
  250. package/src/api.ts +84 -27
  251. package/src/audit/auditApp.test.ts +243 -0
  252. package/src/audit/auditApp.ts +139 -0
  253. package/src/audit/auditEventModel.ts +156 -0
  254. package/src/audit/auditRouter.test.ts +456 -0
  255. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  256. package/src/audit/cloudTasksEnqueue.ts +104 -0
  257. package/src/audit/diff.ts +163 -0
  258. package/src/audit/processQueue.ts +69 -0
  259. package/src/audit/rbacSink.test.ts +86 -0
  260. package/src/audit/rbacSink.ts +42 -0
  261. package/src/audit/record.test.ts +402 -0
  262. package/src/audit/record.ts +328 -0
  263. package/src/auth.test.ts +108 -52
  264. package/src/auth.ts +98 -29
  265. package/src/authRecovery.test.ts +281 -0
  266. package/src/authRecovery.ts +279 -0
  267. package/src/authTokens.test.ts +94 -0
  268. package/src/authTokens.ts +118 -0
  269. package/src/authVerification.test.ts +293 -0
  270. package/src/betterAuth.ts +31 -0
  271. package/src/betterAuthApp.test.ts +1 -0
  272. package/src/betterAuthApp.ts +27 -9
  273. package/src/betterAuthSetup.test.ts +595 -38
  274. package/src/betterAuthSetup.ts +261 -5
  275. package/src/collectionRegistry.test.ts +164 -0
  276. package/src/collectionRegistry.ts +135 -0
  277. package/src/configurationApp.ts +13 -7
  278. package/src/docLoader.test.ts +45 -1
  279. package/src/docLoader.ts +37 -6
  280. package/src/express.d.ts +3 -0
  281. package/src/expressServer.test.ts +180 -68
  282. package/src/expressServer.ts +75 -19
  283. package/src/githubAuth.test.ts +60 -55
  284. package/src/index.ts +127 -0
  285. package/src/mcp/auth.test.ts +47 -0
  286. package/src/mcp/auth.ts +32 -11
  287. package/src/mcp/handlers.test.ts +275 -0
  288. package/src/mcp/handlers.ts +45 -172
  289. package/src/mcp/integration.test.ts +59 -9
  290. package/src/mcp/query.ts +5 -7
  291. package/src/mcp/registry.ts +29 -20
  292. package/src/mcp/schemaGenerator.test.ts +8 -0
  293. package/src/mcp/schemaGenerator.ts +49 -131
  294. package/src/mcp/server.ts +2 -0
  295. package/src/mcp/serviceTokens.test.ts +330 -0
  296. package/src/mcp/serviceTokens.ts +307 -0
  297. package/src/mcp/toolGenerator.test.ts +82 -1
  298. package/src/mcp/types.ts +2 -6
  299. package/src/migrations/cli.test.ts +376 -0
  300. package/src/migrations/cli.ts +283 -0
  301. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  302. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  303. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  304. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  305. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  306. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  307. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  308. package/src/migrations/generate.test.ts +333 -0
  309. package/src/migrations/generate.ts +216 -0
  310. package/src/migrations/load.test.ts +103 -0
  311. package/src/migrations/load.ts +124 -0
  312. package/src/migrations/lock.test.ts +133 -0
  313. package/src/migrations/lock.ts +118 -0
  314. package/src/migrations/runner.test.ts +504 -0
  315. package/src/migrations/runner.ts +358 -0
  316. package/src/migrations/schemaCatalog.test.ts +159 -0
  317. package/src/migrations/schemaCatalog.ts +262 -0
  318. package/src/migrations/types.ts +94 -0
  319. package/src/models/mcpServiceToken.test.ts +129 -0
  320. package/src/models/mcpServiceToken.ts +158 -0
  321. package/src/models/notification.ts +68 -0
  322. package/src/models/notificationPreference.ts +62 -0
  323. package/src/notifications/notificationService.ts +254 -0
  324. package/src/notifications/notificationsApp.test.ts +505 -0
  325. package/src/notifications/notificationsApp.ts +200 -0
  326. package/src/notifications/notificationsBeforeSend.ts +51 -0
  327. package/src/openApi.test.ts +80 -65
  328. package/src/openApi.ts +2 -1
  329. package/src/openApiBuilder.test.ts +95 -7
  330. package/src/openApiBuilder.ts +60 -12
  331. package/src/openApiCompat.ts +1 -1
  332. package/src/openApiValidator.test.ts +270 -56
  333. package/src/openApiValidator.ts +219 -36
  334. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  335. package/src/orgs/orgContext.test.ts +259 -0
  336. package/src/orgs/orgContext.ts +151 -0
  337. package/src/orgs/orgPermissions.test.ts +105 -0
  338. package/src/orgs/orgPermissions.ts +40 -0
  339. package/src/orgs/orgPlugin.test.ts +130 -0
  340. package/src/orgs/orgPlugin.ts +70 -0
  341. package/src/orgs/orgRbac.test.ts +267 -0
  342. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  343. package/src/orgs/organizationModel.test.ts +205 -0
  344. package/src/orgs/organizationModel.ts +257 -0
  345. package/src/orgs/organizationSettings.test.ts +113 -0
  346. package/src/orgs/organizationSettings.ts +126 -0
  347. package/src/orgs/orgsApp.test.ts +382 -0
  348. package/src/orgs/orgsApp.ts +563 -0
  349. package/src/permissions.test.ts +62 -36
  350. package/src/permissions.ts +8 -30
  351. package/src/plugins.test.ts +14 -0
  352. package/src/plugins.ts +34 -9
  353. package/src/populate.test.ts +34 -0
  354. package/src/populate.ts +40 -29
  355. package/src/rateLimit/applyTrustProxy.ts +17 -0
  356. package/src/rateLimit/createStore.ts +25 -0
  357. package/src/rateLimit/memoryStore.ts +40 -0
  358. package/src/rateLimit/middleware.ts +79 -0
  359. package/src/rateLimit/mongoStore.test.ts +80 -0
  360. package/src/rateLimit/mongoStore.ts +77 -0
  361. package/src/rateLimit/policies.ts +130 -0
  362. package/src/rateLimit/rateLimit.test.ts +328 -0
  363. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  364. package/src/rateLimit/redisStore.test.ts +114 -0
  365. package/src/rateLimit/redisStore.ts +86 -0
  366. package/src/rateLimit/types.ts +64 -0
  367. package/src/rbac/access.ts +16 -4
  368. package/src/rbac/assertAllowed.test.ts +325 -0
  369. package/src/rbac/assertAllowed.ts +157 -0
  370. package/src/rbac/backfillAdmins.test.ts +124 -0
  371. package/src/rbac/fieldViews.test.ts +89 -0
  372. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  373. package/src/rbac/modelRouterAccess.test.ts +126 -0
  374. package/src/rbac/modelRouterAccess.ts +8 -2
  375. package/src/rbac/permissionUtils.test.ts +26 -5
  376. package/src/rbac/permissionUtils.ts +3 -2
  377. package/src/rbac/realtimeAccess.test.ts +109 -1
  378. package/src/rbac/resolve.test.ts +34 -2
  379. package/src/rbac/resolve.ts +31 -11
  380. package/src/rbac/roleManager.test.ts +169 -0
  381. package/src/rbac/roleModel.test.ts +34 -1
  382. package/src/rbac/roleModel.ts +17 -1
  383. package/src/rbac/routes.test.ts +233 -0
  384. package/src/rbac/routes.ts +16 -6
  385. package/src/rbac/statements.test.ts +19 -0
  386. package/src/rbac/statements.ts +19 -1
  387. package/src/rbac/types.ts +5 -0
  388. package/src/realtime/changeStreamWatcher.ts +73 -33
  389. package/src/realtime/deprecation.test.ts +60 -0
  390. package/src/realtime/deprecation.ts +33 -0
  391. package/src/realtime/realtime.test.ts +365 -189
  392. package/src/realtime/realtimeApp.ts +11 -11
  393. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  394. package/src/realtime/registry.ts +48 -42
  395. package/src/realtime/sessionRevalidation.test.ts +57 -44
  396. package/src/realtime/socketAuth.test.ts +75 -23
  397. package/src/realtime/socketAuth.ts +17 -6
  398. package/src/realtime/socketUser.ts +5 -3
  399. package/src/realtime/types.ts +14 -4
  400. package/src/schemaMetadata.test.ts +419 -0
  401. package/src/schemaMetadata.ts +593 -0
  402. package/src/scrubAdminFields.test.ts +105 -0
  403. package/src/seedRunner.test.ts +591 -0
  404. package/src/seedRunner.ts +464 -0
  405. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  406. package/src/sync/adminBroadcastScope.test.ts +155 -0
  407. package/src/sync/adminBroadcastScope.ts +123 -0
  408. package/src/sync/adminWindowAccess.test.ts +57 -0
  409. package/src/sync/adminWindowAccess.ts +32 -0
  410. package/src/sync/adminWindowMutation.test.ts +450 -0
  411. package/src/sync/adminWindowMutation.ts +283 -0
  412. package/src/sync/docMatchesMutationData.test.ts +16 -0
  413. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  414. package/src/sync/executors.test.ts +40 -0
  415. package/src/sync/executors.ts +57 -18
  416. package/src/sync/integration.test.ts +15 -7
  417. package/src/sync/loadHarness.ts +28 -19
  418. package/src/sync/models.ts +32 -18
  419. package/src/sync/mutationHandler.test.ts +293 -17
  420. package/src/sync/mutationHandler.ts +180 -36
  421. package/src/sync/registrationSideEffects.test.ts +126 -0
  422. package/src/sync/registrationSideEffects.ts +131 -0
  423. package/src/sync/registry.ts +49 -171
  424. package/src/sync/routes.ts +55 -10
  425. package/src/sync/scripts/compactTombstones.ts +0 -2
  426. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  427. package/src/sync/socketHandlers.ts +154 -58
  428. package/src/sync/streams.ts +6 -0
  429. package/src/sync/sync.test.ts +28 -25
  430. package/src/sync/syncApp.ts +5 -4
  431. package/src/sync/syncBatch.ts +10 -4
  432. package/src/sync/syncFrontier.test.ts +17 -15
  433. package/src/sync/syncPhaseC.test.ts +54 -43
  434. package/src/sync/syncRoutes.test.ts +347 -38
  435. package/src/sync/syncSeqPlugin.ts +66 -44
  436. package/src/sync/syncSocket.test.ts +341 -81
  437. package/src/sync/types.ts +20 -0
  438. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  439. package/src/terrenoApp.migrations.test.ts +114 -0
  440. package/src/terrenoApp.test.ts +41 -0
  441. package/src/terrenoApp.ts +181 -46
  442. package/src/tests/createTestData.ts +2 -2
  443. package/src/tests/models.ts +24 -3
  444. package/src/tests/testHelper.ts +1 -7
  445. package/src/types/authToken.ts +41 -0
  446. package/src/types/mcpServiceToken.ts +48 -0
  447. package/src/types/membership.ts +48 -0
  448. package/src/types/notification.ts +34 -0
  449. package/src/types/notificationPreference.ts +28 -0
  450. package/src/types/organization.ts +49 -0
  451. package/src/webhooks/headerValue.test.ts +22 -0
  452. package/src/webhooks/headerValue.ts +12 -0
  453. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  454. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  455. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  456. package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
  457. package/src/webhooks/rawBody.test.ts +107 -0
  458. package/src/webhooks/rawBody.ts +24 -0
  459. package/src/webhooks/timingSafeEqual.ts +16 -0
  460. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  461. package/src/webhooks/verifiers/hmac.ts +54 -0
  462. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  463. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  464. package/src/webhooks/verifiers/stripe.ts +67 -0
  465. package/src/webhooks/verifiers/twilio.ts +69 -0
  466. package/src/webhooks/webhooksApp.test.ts +221 -0
  467. package/src/webhooks/webhooksApp.ts +144 -0
  468. package/tsconfig.json +1 -1
  469. package/tsconfig.typedoc.json +2 -1
  470. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  471. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  472. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -1,12 +1,17 @@
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";
4
5
  import type { ModelRouterRegistration } from "./api";
5
6
  import { type UserModel as UserMongooseModel } from "./auth";
6
- import { type ConfigurationAppOptions } from "./configurationApp";
7
+ import { type ConfigurationAppOptions, type ConfigurationModelLike } from "./configurationApp";
7
8
  import { type AddRoutes, type AuthOptions } from "./expressServer";
8
9
  import { type GitHubAuthOptions } from "./githubAuth";
9
10
  import { type LoggingOptions } from "./logger";
11
+ import { type McpServiceTokensAppOption } from "./mcp/serviceTokens";
12
+ import { type StartupMigrationsOption } from "./migrations/runner";
13
+ import { type OrgsAppOptions } from "./orgs/orgsApp";
14
+ import type { RateLimitOptions } from "./rateLimit/types";
10
15
  import type { RealtimeAppOptions } from "./realtime/types";
11
16
  import type { TerrenoPlugin } from "./terrenoPlugin";
12
17
  type CorsOrigin = string | boolean | RegExp | Array<boolean | string | RegExp> | ((requestOrigin: string | undefined, callback: (err: Error | null, origin?: boolean | string | RegExp | Array<boolean | string | RegExp>) => void) => void);
@@ -26,6 +31,12 @@ export interface TerrenoAppOptions {
26
31
  githubAuth?: GitHubAuthOptions;
27
32
  /** Skip calling app.listen() in start() method (useful for testing) */
28
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;
29
40
  /** Sentry configuration options */
30
41
  sentryOptions?: Sentry.BunOptions;
31
42
  /** Maximum number of array items in query parameters (default: 200) */
@@ -43,6 +54,13 @@ export interface TerrenoAppOptions {
43
54
  * RBAC access controller injected into model routers and `/auth/me` enrichment.
44
55
  */
45
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">;
46
64
  /**
47
65
  * Runs after CORS and before the `addMiddleware` chain and JSON body parsing.
48
66
  * Use to attach early middleware via `app.use(...)` before JSON parsing.
@@ -53,6 +71,23 @@ export interface TerrenoAppOptions {
53
71
  * Receives the Express app and OpenAPI bundle for `modelRouter` / `createOpenApiBuilder` wiring.
54
72
  */
55
73
  configureApp?: AddRoutes;
74
+ /**
75
+ * Optional HTTP rate limiting. Omitted or `undefined` leaves the limiter off
76
+ * (Terreno 58 will default it on). Pass `{}` or `{store, limits, trustProxy}`
77
+ * to enable. See [Rate limiting](../how-to/rate-limiting.md).
78
+ */
79
+ rateLimit?: RateLimitOptions;
80
+ /**
81
+ * Opt-in personal MCP service tokens. `true` is `{enabled: true}`. When enabled,
82
+ * mounts `/mcp/service-tokens` and accepts `Authorization: Bearer mcp_…` on `/mcp`.
83
+ */
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;
56
91
  }
57
92
  /**
58
93
  * Fluent API for building Express applications with Terreno framework.
@@ -65,7 +100,7 @@ export interface TerrenoAppOptions {
65
100
  * 1. CORS
66
101
  * 2. Optional `beforeJsonSetup` (configure the app before JSON parsing)
67
102
  * 3. Custom middleware (via addMiddleware)
68
- * 4. JSON body parser
103
+ * 4. JSON and urlencoded body parsers (stash `req.rawBody`)
69
104
  * 5. Auth routes (/auth/login, /auth/signup, etc.)
70
105
  * 6. JWT authentication setup
71
106
  * 7. Request logging
@@ -122,6 +157,7 @@ export declare class TerrenoApp {
122
157
  private middlewareFns;
123
158
  private configurationApp;
124
159
  private readonly adminEvents;
160
+ private bootPromise;
125
161
  /**
126
162
  * Create a new TerrenoApp builder.
127
163
  *
@@ -201,13 +237,14 @@ export declare class TerrenoApp {
201
237
  * .start();
202
238
  * ```
203
239
  */
204
- configure(model: import("mongoose").Model<any>, options?: Omit<ConfigurationAppOptions, "model">): this;
240
+ configure(model: ConfigurationModelLike, options?: Omit<ConfigurationAppOptions, "model">): this;
205
241
  /**
206
242
  * Build the Express application without starting the server.
207
243
  *
208
244
  * Configures the complete middleware stack including:
209
- * - CORS, JSON parsing, authentication, logging, Sentry, OpenAPI
210
- * - All registered model routers and plugins
245
+ * - CORS, JSON parsing, JWT decode, optional HTTP rate limiting, auth routes
246
+ * - Better Auth session (when BetterAuthApp is registered) before the limiter
247
+ * - Logging, Sentry, OpenAPI, model routers and plugins
211
248
  * - Error handling middleware
212
249
  *
213
250
  * Use this method when you need the Express app instance for testing
@@ -247,6 +284,12 @@ export declare class TerrenoApp {
247
284
  * ```
248
285
  */
249
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;
250
293
  private isModelRouterRegistration;
251
294
  }
252
295
  export {};
@@ -100,21 +100,30 @@ var node_http_1 = require("node:http");
100
100
  var Sentry = __importStar(require("@sentry/bun"));
101
101
  var cors_1 = __importDefault(require("cors"));
102
102
  var express_1 = __importDefault(require("express"));
103
+ var mongoose_1 = __importDefault(require("mongoose"));
103
104
  var qs_1 = __importDefault(require("qs"));
104
105
  var auth_1 = require("./auth");
106
+ var betterAuthSetup_1 = require("./betterAuthSetup");
105
107
  var configurationApp_1 = require("./configurationApp");
106
108
  var errors_1 = require("./errors");
107
109
  var expressServer_1 = require("./expressServer");
108
110
  var githubAuth_1 = require("./githubAuth");
109
111
  var logger_1 = require("./logger");
110
112
  var server_1 = require("./mcp/server");
113
+ var serviceTokens_1 = require("./mcp/serviceTokens");
111
114
  var middleware_1 = require("./middleware");
115
+ var runner_1 = require("./migrations/runner");
112
116
  var openApiCompat_1 = require("./openApiCompat");
113
117
  var openApiEtag_1 = require("./openApiEtag");
118
+ var orgsApp_1 = require("./orgs/orgsApp");
119
+ var applyTrustProxy_1 = require("./rateLimit/applyTrustProxy");
120
+ var createStore_1 = require("./rateLimit/createStore");
121
+ var middleware_2 = require("./rateLimit/middleware");
114
122
  var realtimeApp_1 = require("./realtime/realtimeApp");
115
123
  var requestContext_1 = require("./requestContext");
116
124
  var registry_1 = require("./sync/registry");
117
125
  var index_1 = __importDefault(require("./vendor/wesleytodd-openapi/index"));
126
+ var rawBody_1 = require("./webhooks/rawBody");
118
127
  /**
119
128
  * Fluent API for building Express applications with Terreno framework.
120
129
  *
@@ -126,7 +135,7 @@ var index_1 = __importDefault(require("./vendor/wesleytodd-openapi/index"));
126
135
  * 1. CORS
127
136
  * 2. Optional `beforeJsonSetup` (configure the app before JSON parsing)
128
137
  * 3. Custom middleware (via addMiddleware)
129
- * 4. JSON body parser
138
+ * 4. JSON and urlencoded body parsers (stash `req.rawBody`)
130
139
  * 5. Auth routes (/auth/login, /auth/signup, etc.)
131
140
  * 6. JWT authentication setup
132
141
  * 7. Request logging
@@ -184,10 +193,65 @@ var TerrenoApp = /** @class */ (function () {
184
193
  * @param options - Application configuration options including user model and auth settings
185
194
  */
186
195
  function TerrenoApp(options) {
196
+ var _this = this;
187
197
  this.registrations = [];
188
198
  this.middlewareFns = [];
189
199
  this.configurationApp = null;
190
200
  this.adminEvents = new node_events_1.EventEmitter();
201
+ this.bootPromise = Promise.resolve();
202
+ this.completeStart = function (app) { return __awaiter(_this, void 0, void 0, function () {
203
+ var port_1, existingServer, server, _a, _b, reg;
204
+ var e_1, _c;
205
+ return __generator(this, function (_d) {
206
+ switch (_d.label) {
207
+ case 0:
208
+ if (!!this.options.skipListen) return [3 /*break*/, 2];
209
+ port_1 = process.env.PORT || "9000";
210
+ existingServer = this.options.httpServer;
211
+ server = existingServer !== null && existingServer !== void 0 ? existingServer : (0, node_http_1.createServer)(app);
212
+ if (existingServer) {
213
+ existingServer.removeAllListeners("request");
214
+ existingServer.on("request", app);
215
+ }
216
+ try {
217
+ for (_a = __values(this.registrations), _b = _a.next(); !_b.done; _b = _a.next()) {
218
+ reg = _b.value;
219
+ if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
220
+ reg.onServerCreated(server);
221
+ }
222
+ }
223
+ }
224
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
225
+ finally {
226
+ try {
227
+ if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
228
+ }
229
+ finally { if (e_1) throw e_1.error; }
230
+ }
231
+ // Bind PORT before index/migration work so Cloud Run's startup probe can
232
+ // succeed while `ensureSyncIndexes` still runs. whenReady() still waits.
233
+ if (!existingServer) {
234
+ server.listen(port_1, function () {
235
+ logger_1.logger.info("Listening on port ".concat(port_1));
236
+ });
237
+ }
238
+ else {
239
+ logger_1.logger.info("Listening on port ".concat(port_1));
240
+ }
241
+ return [4 /*yield*/, (0, registry_1.ensureSyncIndexes)()];
242
+ case 1:
243
+ _d.sent();
244
+ _d.label = 2;
245
+ case 2: return [4 /*yield*/, (0, runner_1.runStartupMigrations)({
246
+ migrations: this.options.migrations,
247
+ mongoose: mongoose_1.default,
248
+ })];
249
+ case 3:
250
+ _d.sent();
251
+ return [2 /*return*/];
252
+ }
253
+ });
254
+ }); };
191
255
  this.options = options;
192
256
  this.adminEvents.setMaxListeners(50);
193
257
  }
@@ -283,10 +347,7 @@ var TerrenoApp = /** @class */ (function () {
283
347
  * .start();
284
348
  * ```
285
349
  */
286
- TerrenoApp.prototype.configure = function (
287
- // noExplicitAny: Model<any> required for invariance — consumers pass arbitrary configuration models
288
- // biome-ignore lint/suspicious/noExplicitAny: Model<any> required for invariance — consumers pass arbitrary configuration models
289
- model, options) {
350
+ TerrenoApp.prototype.configure = function (model, options) {
290
351
  this.configurationApp = new configurationApp_1.ConfigurationApp(__assign({ model: model }, options));
291
352
  return this;
292
353
  };
@@ -294,8 +355,9 @@ var TerrenoApp = /** @class */ (function () {
294
355
  * Build the Express application without starting the server.
295
356
  *
296
357
  * Configures the complete middleware stack including:
297
- * - CORS, JSON parsing, authentication, logging, Sentry, OpenAPI
298
- * - All registered model routers and plugins
358
+ * - CORS, JSON parsing, JWT decode, optional HTTP rate limiting, auth routes
359
+ * - Better Auth session (when BetterAuthApp is registered) before the limiter
360
+ * - Logging, Sentry, OpenAPI, model routers and plugins
299
361
  * - Error handling middleware
300
362
  *
301
363
  * Use this method when you need the Express app instance for testing
@@ -314,8 +376,9 @@ var TerrenoApp = /** @class */ (function () {
314
376
  * ```
315
377
  */
316
378
  TerrenoApp.prototype.build = function () {
317
- var e_1, _a, e_2, _b;
318
- var _c;
379
+ var e_2, _a, e_3, _b;
380
+ var _this = this;
381
+ var _c, _d, _e, _f, _g, _h;
319
382
  (0, logger_1.setupLogging)(this.options.loggingOptions);
320
383
  var app = (0, express_1.default)();
321
384
  var options = this.options;
@@ -329,8 +392,8 @@ var TerrenoApp = /** @class */ (function () {
329
392
  }
330
393
  try {
331
394
  // Apply custom middleware before JSON parsing
332
- for (var _d = __values(this.middlewareFns), _e = _d.next(); !_e.done; _e = _d.next()) {
333
- var fn = _e.value;
395
+ for (var _j = __values(this.middlewareFns), _k = _j.next(); !_k.done; _k = _j.next()) {
396
+ var fn = _k.value;
334
397
  if (fn.length <= 3) {
335
398
  // express.RequestHandler (req, res, next)
336
399
  app.use(fn);
@@ -341,21 +404,43 @@ var TerrenoApp = /** @class */ (function () {
341
404
  }
342
405
  }
343
406
  }
344
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
407
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
345
408
  finally {
346
409
  try {
347
- if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
410
+ if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
348
411
  }
349
- finally { if (e_1) throw e_1.error; }
412
+ finally { if (e_2) throw e_2.error; }
350
413
  }
351
- app.use(express_1.default.json({ limit: "50mb" }));
352
- // Auth routes (login/signup/refresh_token) before JWT middleware
353
- (0, auth_1.addAuthRoutes)(app, options.userModel, options.authOptions);
414
+ app.use(express_1.default.json(rawBody_1.jsonBodyParserOptions));
415
+ app.use(express_1.default.urlencoded(rawBody_1.urlencodedBodyParserOptions));
416
+ // JWT decode before rate limiting so authenticated keys use userId.
417
+ // Auth routes mount after the limiter so login is in the auth bucket.
354
418
  (0, auth_1.setupAuth)(app, options.userModel);
355
419
  app.use(function (req, res, next) {
356
420
  (0, requestContext_1.updateRequestContextFromRequest)(req, res);
357
421
  next();
358
422
  });
423
+ var betterAuthForLimiter = this.registrations.find(function (registration) {
424
+ return "getAuth" in registration &&
425
+ typeof registration.getAuth === "function";
426
+ });
427
+ if (betterAuthForLimiter === null || betterAuthForLimiter === void 0 ? void 0 : betterAuthForLimiter.ensureAuth) {
428
+ var auth = betterAuthForLimiter.ensureAuth();
429
+ app.use((0, betterAuthSetup_1.createBetterAuthSessionMiddleware)(auth, options.userModel));
430
+ (_d = betterAuthForLimiter.markSessionMiddlewareMounted) === null || _d === void 0 ? void 0 : _d.call(betterAuthForLimiter);
431
+ }
432
+ if (options.rateLimit) {
433
+ 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);
434
+ var rateLimit = __assign(__assign({}, options.rateLimit), (betterAuthBasePath ? { betterAuthBasePath: betterAuthBasePath } : {}));
435
+ (0, applyTrustProxy_1.applyRateLimitTrustProxy)(app, rateLimit);
436
+ var store = (0, createStore_1.createRateLimitStore)(rateLimit);
437
+ app.use((0, middleware_2.createRateLimitMiddleware)(store, rateLimit));
438
+ }
439
+ if (!options.authOptions) {
440
+ options.authOptions = {};
441
+ }
442
+ var authOptions = options.authOptions;
443
+ (0, auth_1.addAuthRoutes)(app, options.userModel, authOptions);
359
444
  if (options.logRequests !== false) {
360
445
  app.use(expressServer_1.logRequests);
361
446
  }
@@ -411,8 +496,8 @@ var TerrenoApp = /** @class */ (function () {
411
496
  }
412
497
  try {
413
498
  // Mount registered model routers and plugins
414
- for (var _f = __values(this.registrations), _g = _f.next(); !_g.done; _g = _f.next()) {
415
- var registration = _g.value;
499
+ for (var _l = __values(this.registrations), _m = _l.next(); !_m.done; _m = _l.next()) {
500
+ var registration = _m.value;
416
501
  if (this.isModelRouterRegistration(registration)) {
417
502
  var router = registration._buildWithContext({
418
503
  accessControl: options.accessControl,
@@ -427,20 +512,41 @@ var TerrenoApp = /** @class */ (function () {
427
512
  }
428
513
  }
429
514
  }
430
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
515
+ catch (e_3_1) { e_3 = { error: e_3_1 }; }
431
516
  finally {
432
517
  try {
433
- if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
518
+ if (_m && !_m.done && (_b = _l.return)) _b.call(_l);
434
519
  }
435
- finally { if (e_2) throw e_2.error; }
520
+ finally { if (e_3) throw e_3.error; }
436
521
  }
437
522
  // Mount MCP at POST /mcp when any model opted in or a custom tool was registered.
438
523
  var betterAuthPlugin = this.registrations.find(function (registration) {
439
524
  return "getAuth" in registration &&
440
525
  typeof registration.getAuth === "function";
441
526
  });
527
+ 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();
528
+ if (betterAuth) {
529
+ authOptions.syncPasswordResetToBetterAuth = function (user, password) { return __awaiter(_this, void 0, void 0, function () {
530
+ return __generator(this, function (_a) {
531
+ switch (_a.label) {
532
+ case 0: return [4 /*yield*/, (0, betterAuthSetup_1.applyJwtPasswordResetToBetterAuth)(betterAuth, user, password)];
533
+ case 1:
534
+ _a.sent();
535
+ return [2 /*return*/];
536
+ }
537
+ });
538
+ }); };
539
+ }
540
+ var mcpServiceTokens = (0, serviceTokens_1.resolveMcpServiceTokensOption)(options.mcpServiceTokens);
541
+ if (mcpServiceTokens.enabled) {
542
+ (0, serviceTokens_1.addMcpServiceTokenRoutes)(app, {
543
+ openApi: oapi,
544
+ publicMcpUrl: mcpServiceTokens.publicMcpUrl,
545
+ });
546
+ }
442
547
  (0, server_1.mountMCPServer)(app, {
443
- betterAuth: betterAuthPlugin === null || betterAuthPlugin === void 0 ? void 0 : betterAuthPlugin.getAuth(),
548
+ betterAuth: betterAuth,
549
+ mcpServiceTokens: mcpServiceTokens.enabled,
444
550
  userModel: options.userModel,
445
551
  });
446
552
  if (options.configureApp) {
@@ -479,6 +585,21 @@ var TerrenoApp = /** @class */ (function () {
479
585
  TerrenoApp.prototype.start = function () {
480
586
  var _this = this;
481
587
  var _a;
588
+ if (this.options.organizations) {
589
+ if (!this.options.accessControl) {
590
+ throw new errors_1.APIError({
591
+ status: 500,
592
+ title: "TerrenoApp organizations requires accessControl from createAccess({ organizations: true })",
593
+ });
594
+ }
595
+ var hasOrgsPlugin = this.registrations.some(function (registration) {
596
+ return !_this.isModelRouterRegistration(registration) && registration instanceof orgsApp_1.OrgsApp;
597
+ });
598
+ if (!hasOrgsPlugin) {
599
+ var orgConfig = typeof this.options.organizations === "object" ? this.options.organizations : {};
600
+ this.register(new orgsApp_1.OrgsApp(__assign(__assign({}, orgConfig), { access: this.options.accessControl, userModel: this.options.userModel })));
601
+ }
602
+ }
482
603
  // If realtime option is set, auto-register the RealtimeApp plugin
483
604
  if (this.options.realtime) {
484
605
  var hasRealtimePlugin = this.registrations.some(function (r) { return !_this.isModelRouterRegistration(r) && r instanceof realtimeApp_1.RealtimeApp; });
@@ -493,59 +614,23 @@ var TerrenoApp = /** @class */ (function () {
493
614
  }
494
615
  }
495
616
  var app = this.build();
617
+ this.bootPromise = this.completeStart(app);
496
618
  if (!this.options.skipListen) {
497
- var port_1 = process.env.PORT || "9000";
498
- // Await sync index creation before listening: the per-model snapshot indexes (a
499
- // failed createIndex degrades the snapshot/catch-up query to a table scan) and the
500
- // bookkeeping-model indexes enqueued by SyncApp (the unique mutationId index is what
501
- // makes duplicate mutation deliveries idempotent, and the unique stream index is what
502
- // keeps the counter upsert race from minting duplicate seqs). Either failure is a
503
- // loud startup error rather than a silent correctness cliff. No-op when no sync
504
- // models or SyncApp are registered. Detached because start() returns synchronously.
505
- void (function () { return __awaiter(_this, void 0, void 0, function () {
506
- var server, _a, _b, reg, error_1, stack;
507
- var e_3, _c;
508
- return __generator(this, function (_d) {
509
- switch (_d.label) {
510
- case 0:
511
- _d.trys.push([0, 2, , 3]);
512
- return [4 /*yield*/, (0, registry_1.ensureSyncIndexes)()];
513
- case 1:
514
- _d.sent();
515
- server = (0, node_http_1.createServer)(app);
516
- try {
517
- // Notify plugins that need access to the HTTP server (e.g. WebSocket plugins)
518
- for (_a = __values(this.registrations), _b = _a.next(); !_b.done; _b = _a.next()) {
519
- reg = _b.value;
520
- if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
521
- reg.onServerCreated(server);
522
- }
523
- }
524
- }
525
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
526
- finally {
527
- try {
528
- if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
529
- }
530
- finally { if (e_3) throw e_3.error; }
531
- }
532
- server.listen(port_1, function () {
533
- logger_1.logger.info("Listening on port ".concat(port_1));
534
- });
535
- return [3 /*break*/, 3];
536
- case 2:
537
- error_1 = _d.sent();
538
- stack = error_1 instanceof Error ? error_1.stack : String(error_1);
539
- logger_1.logger.error("Error trying to start HTTP server: ".concat(error_1, "\n").concat(stack));
540
- process.exit(1);
541
- return [3 /*break*/, 3];
542
- case 3: return [2 /*return*/];
543
- }
544
- });
545
- }); })();
619
+ void this.bootPromise.catch(function (error) {
620
+ var stack = error instanceof Error ? error.stack : String(error);
621
+ logger_1.logger.error("Error trying to start HTTP server: ".concat(error, "\n").concat(stack));
622
+ process.exit(1);
623
+ });
546
624
  }
547
625
  return app;
548
626
  };
627
+ /**
628
+ * Resolves after startup migrations (and listen, unless `skipListen`).
629
+ * Tests with `skipListen` should await this instead of assuming `start()` is idle.
630
+ */
631
+ TerrenoApp.prototype.whenReady = function () {
632
+ return this.bootPromise;
633
+ };
549
634
  TerrenoApp.prototype.isModelRouterRegistration = function (registration) {
550
635
  return registration.__type === "modelRouter";
551
636
  };
@@ -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;
@@ -55,7 +55,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
55
55
  return (mod && mod.__esModule) ? mod : { "default": mod };
56
56
  };
57
57
  Object.defineProperty(exports, "__esModule", { value: true });
58
- exports.loadTestDataFromDocuments = exports.toCachedTestData = exports.createTestData = exports.createRequiredFixtures = exports.createStandardFoods = exports.createTestUsers = exports.clearTestCollections = void 0;
58
+ exports.loadTestDataFromDocuments = exports.toCachedTestData = exports.createTestData = exports.createTestUsers = exports.clearTestCollections = void 0;
59
59
  var luxon_1 = require("luxon");
60
60
  var mongoose_1 = __importDefault(require("mongoose"));
61
61
  var errors_1 = require("../errors");
@@ -187,7 +187,6 @@ var createStandardFoods = function (users) { return __awaiter(void 0, void 0, vo
187
187
  }
188
188
  });
189
189
  }); };
190
- exports.createStandardFoods = createStandardFoods;
191
190
  var createRequiredFixtures = function () { return __awaiter(void 0, void 0, void 0, function () {
192
191
  var _a, sample, withAbout;
193
192
  return __generator(this, function (_b) {
@@ -202,7 +201,6 @@ var createRequiredFixtures = function () { return __awaiter(void 0, void 0, void
202
201
  }
203
202
  });
204
203
  }); };
205
- exports.createRequiredFixtures = createRequiredFixtures;
206
204
  /** Builds the standard Terreno API test database (users, foods, required docs). */
207
205
  var createTestData = function () { return __awaiter(void 0, void 0, void 0, function () {
208
206
  var users, _a, foods, required;
@@ -215,8 +213,8 @@ var createTestData = function () { return __awaiter(void 0, void 0, void 0, func
215
213
  case 2:
216
214
  users = _b.sent();
217
215
  return [4 /*yield*/, Promise.all([
218
- (0, exports.createStandardFoods)(users),
219
- (0, exports.createRequiredFixtures)(),
216
+ createStandardFoods(users),
217
+ createRequiredFixtures(),
220
218
  ])];
221
219
  case 3:
222
220
  _a = __read.apply(void 0, [_b.sent(), 2]), foods = _a[0], required = _a[1];
@@ -7,6 +7,9 @@ export interface User {
7
7
  age?: number;
8
8
  disabled?: boolean;
9
9
  organizationIds?: string[];
10
+ roles?: string[];
11
+ tokenEpoch?: number;
12
+ emailVerified?: boolean;
10
13
  }
11
14
  export interface SuperUser extends User {
12
15
  superTitle: string;
@@ -52,19 +52,32 @@ var userSchema = new mongoose_1.Schema({
52
52
  description: "Organization memberships",
53
53
  type: [String],
54
54
  },
55
+ roles: {
56
+ default: [],
57
+ description: "RBAC role names assigned to this user",
58
+ type: [String],
59
+ },
60
+ tokenEpoch: {
61
+ default: 0,
62
+ description: "Incremented on password reset to invalidate outstanding refresh tokens",
63
+ type: Number,
64
+ },
55
65
  username: { description: "The user's username", type: String },
56
66
  });
57
67
  userSchema.plugin(passport_local_mongoose_1.default, {
58
68
  attemptsField: "attempts",
59
- interval: process.env.NODE_ENV === "test" ? 1 : 100,
69
+ interval: 1,
60
70
  limitAttempts: true,
61
71
  maxAttempts: 3,
62
- maxInterval: process.env.NODE_ENV === "test" ? 1 : 300000,
72
+ // Test-only schema: maxInterval 0 caps calculatedInterval at 0 so AttemptTooSoon
73
+ // never preempts maxAttempts lockout under rapid supertest logins.
74
+ maxInterval: 0,
63
75
  usernameCaseInsensitive: true,
64
76
  usernameField: "email",
65
77
  });
66
78
  userSchema.plugin(plugins_1.createdUpdatedPlugin);
67
79
  userSchema.plugin(plugins_1.isDisabledPlugin);
80
+ userSchema.plugin(plugins_1.emailVerificationPlugin);
68
81
  userSchema.methods.postCreate = function (body) {
69
82
  return __awaiter(this, void 0, void 0, function () {
70
83
  return __generator(this, function (_a) {
@@ -1,5 +1,4 @@
1
1
  import type { TestData } from "./types";
2
- export declare const applyTestAuthEnv: () => void;
3
2
  /** Seeds only the standard users (legacy helper). */
4
3
  export declare const setupDb: () => Promise<readonly [import("mongoose").Document<unknown, {}, import("./models").User, {}, import("mongoose").DefaultSchemaOptions> & import("./models").User & {
5
4
  _id: import("mongoose").Types.ObjectId;
@@ -22,7 +21,3 @@ export declare const setupDb: () => Promise<readonly [import("mongoose").Documen
22
21
  }]>;
23
22
  /** Seeds users, foods, and required docs — the recommended API test baseline. */
24
23
  export declare const setupTestData: () => Promise<TestData>;
25
- /** Clears all API test collections without re-seeding. */
26
- export declare const resetTestCollections: () => Promise<void>;
27
- export { createTestData } from "./createTestData";
28
- export { loadTestData } from "./mongoTestSetup";
@@ -36,7 +36,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
36
36
  }
37
37
  };
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
- exports.loadTestData = exports.createTestData = exports.resetTestCollections = exports.setupTestData = exports.setupDb = exports.applyTestAuthEnv = void 0;
39
+ exports.setupTestData = exports.setupDb = void 0;
40
40
  var test_1 = require("@terreno/test");
41
41
  var logger_1 = require("../logger");
42
42
  var createTestData_1 = require("./createTestData");
@@ -49,7 +49,6 @@ var applyTestAuthEnv = function () {
49
49
  process.env.TOKEN_ISSUER = "example.com";
50
50
  process.env.SESSION_SECRET = "session";
51
51
  };
52
- exports.applyTestAuthEnv = applyTestAuthEnv;
53
52
  var ensureConnected = function () { return __awaiter(void 0, void 0, void 0, function () {
54
53
  return __generator(this, function (_a) {
55
54
  switch (_a.label) {
@@ -59,7 +58,7 @@ var ensureConnected = function () { return __awaiter(void 0, void 0, void 0, fun
59
58
  })];
60
59
  case 1:
61
60
  _a.sent();
62
- (0, exports.applyTestAuthEnv)();
61
+ applyTestAuthEnv();
63
62
  return [2 /*return*/];
64
63
  }
65
64
  });
@@ -106,9 +105,3 @@ var setupTestData = function () { return __awaiter(void 0, void 0, void 0, funct
106
105
  });
107
106
  }); };
108
107
  exports.setupTestData = setupTestData;
109
- /** Clears all API test collections without re-seeding. */
110
- exports.resetTestCollections = createTestData_1.clearTestCollections;
111
- var createTestData_2 = require("./createTestData");
112
- Object.defineProperty(exports, "createTestData", { enumerable: true, get: function () { return createTestData_2.createTestData; } });
113
- var mongoTestSetup_2 = require("./mongoTestSetup");
114
- Object.defineProperty(exports, "loadTestData", { enumerable: true, get: function () { return mongoTestSetup_2.loadTestData; } });
@@ -0,0 +1,33 @@
1
+ import type mongoose from "mongoose";
2
+ import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
3
+ export type AuthTokenType = "passwordReset" | "emailVerification";
4
+ type AuthTokenMethods = Record<string, never>;
5
+ interface AuthTokenStatics extends FindExactlyOnePlugin<AuthTokenDocument>, FindOneOrNonePlugin<AuthTokenDocument> {
6
+ consume: (this: AuthTokenModel, token: string, type: AuthTokenType) => Promise<AuthTokenDocument | null>;
7
+ invalidateUnusedFor: (this: AuthTokenModel, user: {
8
+ _id: {
9
+ toString(): string;
10
+ };
11
+ }, type: AuthTokenType) => Promise<void>;
12
+ issueFor: (this: AuthTokenModel, user: {
13
+ _id: {
14
+ toString(): string;
15
+ };
16
+ }, type: AuthTokenType) => Promise<{
17
+ authToken: AuthTokenDocument;
18
+ token: string;
19
+ }>;
20
+ }
21
+ export interface AuthTokenModel extends mongoose.Model<AuthTokenDocument, object, AuthTokenMethods>, AuthTokenStatics {
22
+ }
23
+ export interface AuthTokenDocument extends mongoose.Document {
24
+ _id: mongoose.Types.ObjectId;
25
+ userId: mongoose.Types.ObjectId;
26
+ tokenHash: string;
27
+ type: AuthTokenType;
28
+ expiresAt: Date;
29
+ consumedAt?: Date;
30
+ created: Date;
31
+ updated: Date;
32
+ }
33
+ export {};
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });