@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
package/src/terrenoApp.ts CHANGED
@@ -1,15 +1,25 @@
1
1
  import {EventEmitter} from "node:events";
2
- import {createServer} from "node:http";
2
+ import {createServer, type Server as HttpServer} from "node:http";
3
3
  import * as Sentry from "@sentry/bun";
4
4
  import cors from "cors";
5
5
  import express from "express";
6
+ import mongoose from "mongoose";
6
7
  import qs from "qs";
7
8
  import type {AdminChangeEvent, TerrenoAppAdminEvent} from "./adminTypes";
8
9
  import type {ModelRouterRegistration} from "./api";
9
10
  import {addAuthRoutes, addMeRoutes, setupAuth, type UserModel as UserMongooseModel} from "./auth";
10
- import type {BetterAuthInstance} from "./betterAuthSetup";
11
- import {ConfigurationApp, type ConfigurationAppOptions} from "./configurationApp";
12
11
  import {
12
+ applyJwtPasswordResetToBetterAuth,
13
+ type BetterAuthInstance,
14
+ createBetterAuthSessionMiddleware,
15
+ } from "./betterAuthSetup";
16
+ import {
17
+ ConfigurationApp,
18
+ type ConfigurationAppOptions,
19
+ type ConfigurationModelLike,
20
+ } from "./configurationApp";
21
+ import {
22
+ APIError,
13
23
  apiErrorMiddleware,
14
24
  apiFallthroughErrorMiddleware,
15
25
  apiUnauthorizedMiddleware,
@@ -18,9 +28,20 @@ import {type AddRoutes, type AuthOptions, logRequests} from "./expressServer";
18
28
  import {addGitHubAuthRoutes, type GitHubAuthOptions, setupGitHubAuth} from "./githubAuth";
19
29
  import {type LoggingOptions, logger, setupLogging} from "./logger";
20
30
  import {mountMCPServer} from "./mcp/server";
31
+ import {
32
+ addMcpServiceTokenRoutes,
33
+ type McpServiceTokensAppOption,
34
+ resolveMcpServiceTokensOption,
35
+ } from "./mcp/serviceTokens";
21
36
  import {jsonResponseRequestIdMiddleware} from "./middleware";
37
+ import {runStartupMigrations, type StartupMigrationsOption} from "./migrations/runner";
22
38
  import {openApiCompatMiddleware, patchAppUse} from "./openApiCompat";
23
39
  import {openApiEtagMiddleware} from "./openApiEtag";
40
+ import {OrgsApp, type OrgsAppOptions} from "./orgs/orgsApp";
41
+ import {applyRateLimitTrustProxy} from "./rateLimit/applyTrustProxy";
42
+ import {createRateLimitStore} from "./rateLimit/createStore";
43
+ import {createRateLimitMiddleware} from "./rateLimit/middleware";
44
+ import type {RateLimitOptions} from "./rateLimit/types";
24
45
  import {RealtimeApp} from "./realtime/realtimeApp";
25
46
  import type {RealtimeAppOptions} from "./realtime/types";
26
47
  import {
@@ -31,10 +52,14 @@ import {
31
52
  import {ensureSyncIndexes} from "./sync/registry";
32
53
  import type {TerrenoPlugin} from "./terrenoPlugin";
33
54
  import openapi from "./vendor/wesleytodd-openapi/index";
55
+ import {jsonBodyParserOptions, urlencodedBodyParserOptions} from "./webhooks/rawBody";
34
56
 
35
57
  /** A registered plugin that exposes a Better Auth instance, e.g. BetterAuthApp. */
36
58
  interface BetterAuthProvider {
37
59
  getAuth: () => BetterAuthInstance | undefined;
60
+ ensureAuth?: () => BetterAuthInstance;
61
+ markSessionMiddlewareMounted?: () => void;
62
+ getBetterAuthBasePath?: () => string;
38
63
  }
39
64
 
40
65
  type CorsOrigin =
@@ -66,6 +91,12 @@ export interface TerrenoAppOptions {
66
91
  githubAuth?: GitHubAuthOptions;
67
92
  /** Skip calling app.listen() in start() method (useful for testing) */
68
93
  skipListen?: boolean;
94
+ /**
95
+ * Already-listening HTTP server. `start()` attaches the Express app to it
96
+ * instead of creating and binding a new server, so Cloud Run can see PORT
97
+ * before MongoDB connect and plugin registration finish.
98
+ */
99
+ httpServer?: HttpServer;
69
100
  /** Sentry configuration options */
70
101
  sentryOptions?: Sentry.BunOptions;
71
102
  /** Maximum number of array items in query parameters (default: 200) */
@@ -83,6 +114,13 @@ export interface TerrenoAppOptions {
83
114
  * RBAC access controller injected into model routers and `/auth/me` enrichment.
84
115
  */
85
116
  accessControl?: import("./rbac/types").AnyTerrenoAccess;
117
+ /**
118
+ * Multi-tenant organizations. Default off so existing single-tenant apps stay unchanged.
119
+ * New apps from `terreno_bootstrap_app` pass `true`. Requires `accessControl` from
120
+ * `createAccess({ organizations: true })`. Pass `{ settingsSchema }` to type and
121
+ * validate `Organization.settings`.
122
+ */
123
+ organizations?: boolean | Omit<OrgsAppOptions, "access" | "userModel">;
86
124
  /**
87
125
  * Runs after CORS and before the `addMiddleware` chain and JSON body parsing.
88
126
  * Use to attach early middleware via `app.use(...)` before JSON parsing.
@@ -93,6 +131,23 @@ export interface TerrenoAppOptions {
93
131
  * Receives the Express app and OpenAPI bundle for `modelRouter` / `createOpenApiBuilder` wiring.
94
132
  */
95
133
  configureApp?: AddRoutes;
134
+ /**
135
+ * Optional HTTP rate limiting. Omitted or `undefined` leaves the limiter off
136
+ * (Terreno 58 will default it on). Pass `{}` or `{store, limits, trustProxy}`
137
+ * to enable. See [Rate limiting](../how-to/rate-limiting.md).
138
+ */
139
+ rateLimit?: RateLimitOptions;
140
+ /**
141
+ * Opt-in personal MCP service tokens. `true` is `{enabled: true}`. When enabled,
142
+ * mounts `/mcp/service-tokens` and accepts `Authorization: Bearer mcp_…` on `/mcp`.
143
+ */
144
+ mcpServiceTokens?: McpServiceTokensAppOption;
145
+ /**
146
+ * Versioned MongoDB migrations. `runOnStart` defaults to false. When true, wet `up`
147
+ * runs after listen and `ensureSyncIndexes`. Production still requires
148
+ * `ALLOW_MIGRATIONS=true`.
149
+ */
150
+ migrations?: StartupMigrationsOption;
96
151
  }
97
152
 
98
153
  /**
@@ -106,7 +161,7 @@ export interface TerrenoAppOptions {
106
161
  * 1. CORS
107
162
  * 2. Optional `beforeJsonSetup` (configure the app before JSON parsing)
108
163
  * 3. Custom middleware (via addMiddleware)
109
- * 4. JSON body parser
164
+ * 4. JSON and urlencoded body parsers (stash `req.rawBody`)
110
165
  * 5. Auth routes (/auth/login, /auth/signup, etc.)
111
166
  * 6. JWT authentication setup
112
167
  * 7. Request logging
@@ -163,6 +218,7 @@ export class TerrenoApp {
163
218
  private middlewareFns: (express.RequestHandler | ((app: express.Application) => void))[] = [];
164
219
  private configurationApp: ConfigurationApp | null = null;
165
220
  private readonly adminEvents = new EventEmitter();
221
+ private bootPromise: Promise<void> = Promise.resolve();
166
222
 
167
223
  /**
168
224
  * Create a new TerrenoApp builder.
@@ -274,12 +330,7 @@ export class TerrenoApp {
274
330
  * .start();
275
331
  * ```
276
332
  */
277
- configure(
278
- // noExplicitAny: Model<any> required for invariance — consumers pass arbitrary configuration models
279
- // biome-ignore lint/suspicious/noExplicitAny: Model<any> required for invariance — consumers pass arbitrary configuration models
280
- model: import("mongoose").Model<any>,
281
- options?: Omit<ConfigurationAppOptions, "model">
282
- ): this {
333
+ configure(model: ConfigurationModelLike, options?: Omit<ConfigurationAppOptions, "model">): this {
283
334
  this.configurationApp = new ConfigurationApp({model, ...options});
284
335
  return this;
285
336
  }
@@ -288,8 +339,9 @@ export class TerrenoApp {
288
339
  * Build the Express application without starting the server.
289
340
  *
290
341
  * Configures the complete middleware stack including:
291
- * - CORS, JSON parsing, authentication, logging, Sentry, OpenAPI
292
- * - All registered model routers and plugins
342
+ * - CORS, JSON parsing, JWT decode, optional HTTP rate limiting, auth routes
343
+ * - Better Auth session (when BetterAuthApp is registered) before the limiter
344
+ * - Logging, Sentry, OpenAPI, model routers and plugins
293
345
  * - Error handling middleware
294
346
  *
295
347
  * Use this method when you need the Express app instance for testing
@@ -339,16 +391,46 @@ export class TerrenoApp {
339
391
  }
340
392
  }
341
393
 
342
- app.use(express.json({limit: "50mb"}));
394
+ app.use(express.json(jsonBodyParserOptions));
395
+ app.use(express.urlencoded(urlencodedBodyParserOptions) as unknown as express.RequestHandler);
343
396
 
344
- // Auth routes (login/signup/refresh_token) before JWT middleware
345
- addAuthRoutes(app, options.userModel, options.authOptions);
397
+ // JWT decode before rate limiting so authenticated keys use userId.
398
+ // Auth routes mount after the limiter so login is in the auth bucket.
346
399
  setupAuth(app, options.userModel);
347
400
  app.use((req, res, next) => {
348
401
  updateRequestContextFromRequest(req, res);
349
402
  next();
350
403
  });
351
404
 
405
+ const betterAuthForLimiter = this.registrations.find(
406
+ (registration) =>
407
+ "getAuth" in registration &&
408
+ typeof (registration as Partial<BetterAuthProvider>).getAuth === "function"
409
+ ) as BetterAuthProvider | undefined;
410
+ if (betterAuthForLimiter?.ensureAuth) {
411
+ const auth = betterAuthForLimiter.ensureAuth();
412
+ app.use(createBetterAuthSessionMiddleware(auth, options.userModel));
413
+ betterAuthForLimiter.markSessionMiddlewareMounted?.();
414
+ }
415
+
416
+ if (options.rateLimit) {
417
+ const betterAuthBasePath =
418
+ options.rateLimit.betterAuthBasePath ?? betterAuthForLimiter?.getBetterAuthBasePath?.();
419
+ const rateLimit = {
420
+ ...options.rateLimit,
421
+ ...(betterAuthBasePath ? {betterAuthBasePath} : {}),
422
+ };
423
+ applyRateLimitTrustProxy(app, rateLimit);
424
+ const store = createRateLimitStore(rateLimit);
425
+ app.use(createRateLimitMiddleware(store, rateLimit));
426
+ }
427
+
428
+ if (!options.authOptions) {
429
+ options.authOptions = {};
430
+ }
431
+ const authOptions = options.authOptions;
432
+ addAuthRoutes(app, options.userModel, authOptions);
433
+
352
434
  if (options.logRequests !== false) {
353
435
  app.use(logRequests);
354
436
  }
@@ -429,8 +511,22 @@ export class TerrenoApp {
429
511
  "getAuth" in registration &&
430
512
  typeof (registration as Partial<BetterAuthProvider>).getAuth === "function"
431
513
  ) as BetterAuthProvider | undefined;
514
+ const betterAuth = betterAuthPlugin?.ensureAuth?.() ?? betterAuthPlugin?.getAuth();
515
+ if (betterAuth) {
516
+ authOptions.syncPasswordResetToBetterAuth = async (user, password): Promise<void> => {
517
+ await applyJwtPasswordResetToBetterAuth(betterAuth, user, password);
518
+ };
519
+ }
520
+ const mcpServiceTokens = resolveMcpServiceTokensOption(options.mcpServiceTokens);
521
+ if (mcpServiceTokens.enabled) {
522
+ addMcpServiceTokenRoutes(app, {
523
+ openApi: oapi,
524
+ publicMcpUrl: mcpServiceTokens.publicMcpUrl,
525
+ });
526
+ }
432
527
  mountMCPServer(app, {
433
- betterAuth: betterAuthPlugin?.getAuth(),
528
+ betterAuth,
529
+ mcpServiceTokens: mcpServiceTokens.enabled,
434
530
  userModel: options.userModel,
435
531
  });
436
532
 
@@ -474,6 +570,31 @@ export class TerrenoApp {
474
570
  * ```
475
571
  */
476
572
  start(): express.Application {
573
+ if (this.options.organizations) {
574
+ if (!this.options.accessControl) {
575
+ throw new APIError({
576
+ status: 500,
577
+ title:
578
+ "TerrenoApp organizations requires accessControl from createAccess({ organizations: true })",
579
+ });
580
+ }
581
+ const hasOrgsPlugin = this.registrations.some(
582
+ (registration) =>
583
+ !this.isModelRouterRegistration(registration) && registration instanceof OrgsApp
584
+ );
585
+ if (!hasOrgsPlugin) {
586
+ const orgConfig =
587
+ typeof this.options.organizations === "object" ? this.options.organizations : {};
588
+ this.register(
589
+ new OrgsApp({
590
+ ...orgConfig,
591
+ access: this.options.accessControl,
592
+ userModel: this.options.userModel,
593
+ })
594
+ );
595
+ }
596
+ }
597
+
477
598
  // If realtime option is set, auto-register the RealtimeApp plugin
478
599
  if (this.options.realtime) {
479
600
  const hasRealtimePlugin = this.registrations.some(
@@ -496,41 +617,55 @@ export class TerrenoApp {
496
617
  }
497
618
 
498
619
  const app = this.build();
620
+ this.bootPromise = this.completeStart(app);
621
+ if (!this.options.skipListen) {
622
+ void this.bootPromise.catch((error: unknown) => {
623
+ const stack = error instanceof Error ? error.stack : String(error);
624
+ logger.error(`Error trying to start HTTP server: ${error}\n${stack}`);
625
+ process.exit(1);
626
+ });
627
+ }
628
+ return app;
629
+ }
499
630
 
631
+ /**
632
+ * Resolves after startup migrations (and listen, unless `skipListen`).
633
+ * Tests with `skipListen` should await this instead of assuming `start()` is idle.
634
+ */
635
+ whenReady(): Promise<void> {
636
+ return this.bootPromise;
637
+ }
638
+
639
+ private completeStart = async (app: express.Application): Promise<void> => {
500
640
  if (!this.options.skipListen) {
501
641
  const port = process.env.PORT || "9000";
502
- // Await sync index creation before listening: the per-model snapshot indexes (a
503
- // failed createIndex degrades the snapshot/catch-up query to a table scan) and the
504
- // bookkeeping-model indexes enqueued by SyncApp (the unique mutationId index is what
505
- // makes duplicate mutation deliveries idempotent, and the unique stream index is what
506
- // keeps the counter upsert race from minting duplicate seqs). Either failure is a
507
- // loud startup error rather than a silent correctness cliff. No-op when no sync
508
- // models or SyncApp are registered. Detached because start() returns synchronously.
509
- void (async (): Promise<void> => {
510
- try {
511
- await ensureSyncIndexes();
512
- const server = createServer(app);
513
-
514
- // Notify plugins that need access to the HTTP server (e.g. WebSocket plugins)
515
- for (const reg of this.registrations) {
516
- if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
517
- reg.onServerCreated(server);
518
- }
519
- }
520
-
521
- server.listen(port, () => {
522
- logger.info(`Listening on port ${port}`);
523
- });
524
- } catch (error) {
525
- const stack = error instanceof Error ? error.stack : String(error);
526
- logger.error(`Error trying to start HTTP server: ${error}\n${stack}`);
527
- process.exit(1);
642
+ const existingServer = this.options.httpServer;
643
+ const server = existingServer ?? createServer(app);
644
+ if (existingServer) {
645
+ existingServer.removeAllListeners("request");
646
+ existingServer.on("request", app);
647
+ }
648
+ for (const reg of this.registrations) {
649
+ if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
650
+ reg.onServerCreated(server);
528
651
  }
529
- })();
652
+ }
653
+ // Bind PORT before index/migration work so Cloud Run's startup probe can
654
+ // succeed while `ensureSyncIndexes` still runs. whenReady() still waits.
655
+ if (!existingServer) {
656
+ server.listen(port, () => {
657
+ logger.info(`Listening on port ${port}`);
658
+ });
659
+ } else {
660
+ logger.info(`Listening on port ${port}`);
661
+ }
662
+ await ensureSyncIndexes();
530
663
  }
531
-
532
- return app;
533
- }
664
+ await runStartupMigrations({
665
+ migrations: this.options.migrations,
666
+ mongoose,
667
+ });
668
+ };
534
669
 
535
670
  private isModelRouterRegistration(
536
671
  registration: ModelRouterRegistration | TerrenoPlugin
@@ -40,7 +40,7 @@ export const createTestUsers = async (): Promise<TestUsers> => {
40
40
  return {admin, adminOther, notAdmin};
41
41
  };
42
42
 
43
- export const createStandardFoods = async (users: TestUsers): Promise<TestFoods> => {
43
+ const createStandardFoods = async (users: TestUsers): Promise<TestFoods> => {
44
44
  const {admin, adminOther, notAdmin} = users;
45
45
 
46
46
  const [spinach, apple, carrots, pizza] = await Promise.all([
@@ -106,7 +106,7 @@ export const createStandardFoods = async (users: TestUsers): Promise<TestFoods>
106
106
  return {apple, carrots, pizza, spinach};
107
107
  };
108
108
 
109
- export const createRequiredFixtures = async (): Promise<TestRequired> => {
109
+ const createRequiredFixtures = async (): Promise<TestRequired> => {
110
110
  const [sample, withAbout] = await Promise.all([
111
111
  RequiredModel.create({name: "Sample Required"}),
112
112
  RequiredModel.create({about: "Optional about text", name: "Required With About"}),
@@ -1,7 +1,12 @@
1
1
  import mongoose, {type Model, model, Schema, type StringSchemaDefinition} from "mongoose";
2
2
  import passportLocalMongoose from "passport-local-mongoose";
3
3
 
4
- import {createdUpdatedPlugin, DateOnly, isDisabledPlugin} from "../plugins";
4
+ import {
5
+ createdUpdatedPlugin,
6
+ DateOnly,
7
+ emailVerificationPlugin,
8
+ isDisabledPlugin,
9
+ } from "../plugins";
5
10
 
6
11
  export interface User {
7
12
  admin: boolean;
@@ -11,6 +16,9 @@ export interface User {
11
16
  age?: number;
12
17
  disabled?: boolean;
13
18
  organizationIds?: string[];
19
+ roles?: string[];
20
+ tokenEpoch?: number;
21
+ emailVerified?: boolean;
14
22
  }
15
23
 
16
24
  export interface SuperUser extends User {
@@ -63,6 +71,16 @@ const userSchema = new Schema<User>({
63
71
  description: "Organization memberships",
64
72
  type: [String],
65
73
  },
74
+ roles: {
75
+ default: [],
76
+ description: "RBAC role names assigned to this user",
77
+ type: [String],
78
+ },
79
+ tokenEpoch: {
80
+ default: 0,
81
+ description: "Incremented on password reset to invalidate outstanding refresh tokens",
82
+ type: Number,
83
+ },
66
84
  username: {description: "The user's username", type: String},
67
85
  });
68
86
 
@@ -70,16 +88,19 @@ userSchema.plugin(
70
88
  passportLocalMongoose as unknown as (schema: Schema, options?: Record<string, unknown>) => void,
71
89
  {
72
90
  attemptsField: "attempts",
73
- interval: process.env.NODE_ENV === "test" ? 1 : 100,
91
+ interval: 1,
74
92
  limitAttempts: true,
75
93
  maxAttempts: 3,
76
- maxInterval: process.env.NODE_ENV === "test" ? 1 : 300000,
94
+ // Test-only schema: maxInterval 0 caps calculatedInterval at 0 so AttemptTooSoon
95
+ // never preempts maxAttempts lockout under rapid supertest logins.
96
+ maxInterval: 0,
77
97
  usernameCaseInsensitive: true,
78
98
  usernameField: "email",
79
99
  }
80
100
  );
81
101
  userSchema.plugin(createdUpdatedPlugin);
82
102
  userSchema.plugin(isDisabledPlugin);
103
+ userSchema.plugin(emailVerificationPlugin);
83
104
  userSchema.methods.postCreate = async function (body: {age?: number}) {
84
105
  this.age = body.age;
85
106
  return this.save();
@@ -7,7 +7,7 @@ import type {TestData} from "./types";
7
7
 
8
8
  const defaultTestMongoUri = "mongodb://127.0.0.1/terreno?&connectTimeoutMS=360000";
9
9
 
10
- export const applyTestAuthEnv = (): void => {
10
+ const applyTestAuthEnv = (): void => {
11
11
  process.env.REFRESH_TOKEN_SECRET = "refresh_secret";
12
12
  process.env.TOKEN_SECRET = "secret";
13
13
  process.env.TOKEN_EXPIRES_IN = "30m";
@@ -47,9 +47,3 @@ export const setupTestData = async (): Promise<TestData> => {
47
47
 
48
48
  return createTestData();
49
49
  };
50
-
51
- /** Clears all API test collections without re-seeding. */
52
- export const resetTestCollections = clearTestCollections;
53
-
54
- export {createTestData} from "./createTestData";
55
- export {loadTestData} from "./mongoTestSetup";
@@ -0,0 +1,41 @@
1
+ import type mongoose from "mongoose";
2
+ import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
3
+
4
+ export type AuthTokenType = "passwordReset" | "emailVerification";
5
+
6
+ type AuthTokenMethods = Record<string, never>;
7
+
8
+ interface AuthTokenStatics
9
+ extends FindExactlyOnePlugin<AuthTokenDocument>,
10
+ FindOneOrNonePlugin<AuthTokenDocument> {
11
+ consume: (
12
+ this: AuthTokenModel,
13
+ token: string,
14
+ type: AuthTokenType
15
+ ) => Promise<AuthTokenDocument | null>;
16
+ invalidateUnusedFor: (
17
+ this: AuthTokenModel,
18
+ user: {_id: {toString(): string}},
19
+ type: AuthTokenType
20
+ ) => Promise<void>;
21
+ issueFor: (
22
+ this: AuthTokenModel,
23
+ user: {_id: {toString(): string}},
24
+ type: AuthTokenType
25
+ ) => Promise<{authToken: AuthTokenDocument; token: string}>;
26
+ }
27
+
28
+ export interface AuthTokenModel
29
+ extends mongoose.Model<AuthTokenDocument, object, AuthTokenMethods>,
30
+ AuthTokenStatics {}
31
+
32
+ export interface AuthTokenDocument extends mongoose.Document {
33
+ _id: mongoose.Types.ObjectId;
34
+ userId: mongoose.Types.ObjectId;
35
+ tokenHash: string;
36
+ type: AuthTokenType;
37
+ expiresAt: Date;
38
+ consumedAt?: Date;
39
+ created: Date;
40
+ updated: Date;
41
+ }
@@ -0,0 +1,48 @@
1
+ import type mongoose from "mongoose";
2
+ import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
3
+
4
+ export interface McpServiceTokenIssueOptions {
5
+ expiresAt?: Date;
6
+ name: string;
7
+ }
8
+
9
+ interface McpServiceTokenMethods {
10
+ deleteOne: (this: McpServiceTokenDocument) => Promise<McpServiceTokenDocument>;
11
+ }
12
+
13
+ export interface McpServiceTokenStatics
14
+ extends FindExactlyOnePlugin<McpServiceTokenDocument>,
15
+ FindOneOrNonePlugin<McpServiceTokenDocument> {
16
+ countActiveForUser: (
17
+ this: McpServiceTokenModel,
18
+ userId: mongoose.Types.ObjectId
19
+ ) => Promise<number>;
20
+ issueFor: (
21
+ this: McpServiceTokenModel,
22
+ user: {_id: {toString(): string}},
23
+ options: McpServiceTokenIssueOptions
24
+ ) => Promise<{mcpServiceToken: McpServiceTokenDocument; token: string}>;
25
+ revokeForUser: (
26
+ this: McpServiceTokenModel,
27
+ user: {_id: {toString(): string}},
28
+ tokenId: mongoose.Types.ObjectId
29
+ ) => Promise<McpServiceTokenDocument | null>;
30
+ verify: (this: McpServiceTokenModel, token: string) => Promise<McpServiceTokenDocument | null>;
31
+ }
32
+
33
+ export interface McpServiceTokenModel
34
+ extends mongoose.Model<McpServiceTokenDocument, object, McpServiceTokenMethods>,
35
+ McpServiceTokenStatics {}
36
+
37
+ export interface McpServiceTokenDocument extends mongoose.Document {
38
+ _id: mongoose.Types.ObjectId;
39
+ created: Date;
40
+ expiresAt?: Date;
41
+ lastUsedAt?: Date;
42
+ name: string;
43
+ revokedAt?: Date;
44
+ tokenHash: string;
45
+ tokenPrefix: string;
46
+ updated: Date;
47
+ userId: mongoose.Types.ObjectId;
48
+ }
@@ -0,0 +1,48 @@
1
+ import type mongoose from "mongoose";
2
+ import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
3
+
4
+ export type MembershipRoleName = "org-admin" | "member";
5
+ export type MembershipStatus = "active" | "suspended";
6
+
7
+ // biome-ignore lint/complexity/noBannedTypes: No instance methods.
8
+ export type MembershipMethods = {};
9
+
10
+ export interface MembershipStatics
11
+ extends FindExactlyOnePlugin<MembershipDocument>,
12
+ FindOneOrNonePlugin<MembershipDocument> {
13
+ findActiveForUser: (
14
+ this: MembershipModel,
15
+ userId: mongoose.Types.ObjectId | string
16
+ ) => Promise<MembershipDocument[]>;
17
+ isMember: (
18
+ this: MembershipModel,
19
+ userId: mongoose.Types.ObjectId | string,
20
+ organizationId: mongoose.Types.ObjectId | string
21
+ ) => Promise<boolean>;
22
+ isOrgAdmin: (
23
+ this: MembershipModel,
24
+ userId: mongoose.Types.ObjectId | string,
25
+ organizationId: mongoose.Types.ObjectId | string
26
+ ) => Promise<boolean>;
27
+ }
28
+
29
+ export interface MembershipModel
30
+ extends mongoose.Model<MembershipDocument, object, MembershipMethods>,
31
+ MembershipStatics {}
32
+
33
+ export type MembershipSchema = mongoose.Schema<
34
+ MembershipDocument,
35
+ MembershipModel,
36
+ MembershipMethods
37
+ >;
38
+
39
+ export interface MembershipDocument extends mongoose.Document {
40
+ _id: mongoose.Types.ObjectId;
41
+ created: Date;
42
+ deleted: boolean;
43
+ organizationId: mongoose.Types.ObjectId;
44
+ roleName: MembershipRoleName;
45
+ status: MembershipStatus;
46
+ updated: Date;
47
+ userId: mongoose.Types.ObjectId;
48
+ }
@@ -0,0 +1,34 @@
1
+ import type mongoose from "mongoose";
2
+ import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
3
+
4
+ type NotificationMethods = Record<never, never>;
5
+
6
+ interface NotificationStatics
7
+ extends FindExactlyOnePlugin<NotificationDocument>,
8
+ FindOneOrNonePlugin<NotificationDocument> {}
9
+
10
+ export interface NotificationModel
11
+ extends mongoose.Model<NotificationDocument, object, NotificationMethods>,
12
+ NotificationStatics {}
13
+
14
+ export interface NotificationDocument extends mongoose.Document<string>, NotificationMethods {
15
+ _id: string;
16
+ archivedAt: Date | null;
17
+ body: string;
18
+ href?: string;
19
+ kind?: string;
20
+ ownerId: mongoose.Types.ObjectId;
21
+ readAt: Date | null;
22
+ title: string;
23
+ created: Date;
24
+ updated: Date;
25
+ deleted: boolean;
26
+ }
27
+
28
+ export interface NotifyInput {
29
+ body: string;
30
+ href?: string;
31
+ kind?: string;
32
+ title: string;
33
+ userId: string;
34
+ }
@@ -0,0 +1,28 @@
1
+ import type mongoose from "mongoose";
2
+ import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
3
+
4
+ export type NotificationPreferenceChannel = "inapp" | "mail" | "push" | "sms";
5
+
6
+ type NotificationPreferenceMethods = Record<never, never>;
7
+
8
+ interface NotificationPreferenceStatics
9
+ extends FindExactlyOnePlugin<NotificationPreferenceDocument>,
10
+ FindOneOrNonePlugin<NotificationPreferenceDocument> {}
11
+
12
+ export interface NotificationPreferenceModel
13
+ extends mongoose.Model<NotificationPreferenceDocument, object, NotificationPreferenceMethods>,
14
+ NotificationPreferenceStatics {}
15
+
16
+ export interface NotificationPreferenceDocument
17
+ extends mongoose.Document<string>,
18
+ NotificationPreferenceMethods {
19
+ _id: string;
20
+ inapp: boolean;
21
+ mail: boolean;
22
+ ownerId: mongoose.Types.ObjectId;
23
+ push: boolean;
24
+ sms: boolean;
25
+ created: Date;
26
+ updated: Date;
27
+ deleted: boolean;
28
+ }