@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
@@ -0,0 +1,373 @@
1
+ "use strict";
2
+ var __assign = (this && this.__assign) || function () {
3
+ __assign = Object.assign || function(t) {
4
+ for (var s, i = 1, n = arguments.length; i < n; i++) {
5
+ s = arguments[i];
6
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
+ t[p] = s[p];
8
+ }
9
+ return t;
10
+ };
11
+ return __assign.apply(this, arguments);
12
+ };
13
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
14
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
15
+ return new (P || (P = Promise))(function (resolve, reject) {
16
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
17
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
18
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
19
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
20
+ });
21
+ };
22
+ var __generator = (this && this.__generator) || function (thisArg, body) {
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
+ function verb(n) { return function (v) { return step([n, v]); }; }
26
+ function step(op) {
27
+ if (f) throw new TypeError("Generator is already executing.");
28
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
29
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
30
+ if (y = 0, t) op = [op[0] & 2, t.value];
31
+ switch (op[0]) {
32
+ case 0: case 1: t = op; break;
33
+ case 4: _.label++; return { value: op[1], done: false };
34
+ case 5: _.label++; y = op[1]; op = [0]; continue;
35
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
36
+ default:
37
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
38
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
39
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
40
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
41
+ if (t[2]) _.ops.pop();
42
+ _.trys.pop(); continue;
43
+ }
44
+ op = body.call(thisArg, _);
45
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
46
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
47
+ }
48
+ };
49
+ var __read = (this && this.__read) || function (o, n) {
50
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
51
+ if (!m) return o;
52
+ var i = m.call(o), r, ar = [], e;
53
+ try {
54
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
55
+ }
56
+ catch (error) { e = { error: error }; }
57
+ finally {
58
+ try {
59
+ if (r && !r.done && (m = i["return"])) m.call(i);
60
+ }
61
+ finally { if (e) throw e.error; }
62
+ }
63
+ return ar;
64
+ };
65
+ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
66
+ if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
67
+ if (ar || !(i in from)) {
68
+ if (!ar) ar = Array.prototype.slice.call(from, 0, i);
69
+ ar[i] = from[i];
70
+ }
71
+ }
72
+ return to.concat(ar || Array.prototype.slice.call(from));
73
+ };
74
+ var __importDefault = (this && this.__importDefault) || function (mod) {
75
+ return (mod && mod.__esModule) ? mod : { "default": mod };
76
+ };
77
+ Object.defineProperty(exports, "__esModule", { value: true });
78
+ exports.maybeRecordModelRouterAudit = exports.recordAuditEvent = exports.persistEnqueuedAuditEvent = exports.snapshotAuditBefore = exports.actorIdForAuditWrite = exports.maybeRecordAdminAudit = exports.flushAuditRecorderForTests = exports.resetAuditRecorderForTests = exports.isAuditRecorderInstalled = exports.installAuditRecorder = void 0;
79
+ var mongoose_1 = __importDefault(require("mongoose"));
80
+ var logger_1 = require("../logger");
81
+ var orgContext_1 = require("../orgs/orgContext");
82
+ var diff_1 = require("./diff");
83
+ var MISSING_PLUGIN_MESSAGE = "modelRouter audit: true requires AuditApp to be registered; skipping AuditEvent write";
84
+ var auditEventModel;
85
+ var auditEnqueue;
86
+ var missingPluginLogged = false;
87
+ var inflightWrites = new Set();
88
+ var installAuditRecorder = function (model, options) {
89
+ if (options === void 0) { options = {}; }
90
+ auditEventModel = model;
91
+ auditEnqueue = options.enqueue;
92
+ };
93
+ exports.installAuditRecorder = installAuditRecorder;
94
+ var isAuditRecorderInstalled = function () { return Boolean(auditEventModel); };
95
+ exports.isAuditRecorderInstalled = isAuditRecorderInstalled;
96
+ var resetAuditRecorderForTests = function () {
97
+ auditEventModel = undefined;
98
+ auditEnqueue = undefined;
99
+ missingPluginLogged = false;
100
+ inflightWrites.clear();
101
+ };
102
+ exports.resetAuditRecorderForTests = resetAuditRecorderForTests;
103
+ var flushAuditRecorderForTests = function () { return __awaiter(void 0, void 0, void 0, function () {
104
+ return __generator(this, function (_a) {
105
+ switch (_a.label) {
106
+ case 0: return [4 /*yield*/, Promise.all(__spreadArray([], __read(inflightWrites), false))];
107
+ case 1:
108
+ _a.sent();
109
+ return [2 /*return*/];
110
+ }
111
+ });
112
+ }); };
113
+ exports.flushAuditRecorderForTests = flushAuditRecorderForTests;
114
+ var operationFromVerb = function (verb) {
115
+ if (verb === "created") {
116
+ return "create";
117
+ }
118
+ if (verb === "deleted") {
119
+ return "delete";
120
+ }
121
+ return "update";
122
+ };
123
+ var maybeRecordAdminAudit = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
124
+ var beforePlain, afterPlain, diff, recordIdValue, error_1;
125
+ var _c, _d;
126
+ var after = _b.after, before = _b.before, _e = _b.extraRedact, extraRedact = _e === void 0 ? [] : _e, modelName = _b.modelName, recordLabel = _b.recordLabel, req = _b.req, verb = _b.verb;
127
+ return __generator(this, function (_f) {
128
+ switch (_f.label) {
129
+ case 0:
130
+ _f.trys.push([0, 2, , 3]);
131
+ if (!auditEventModel) {
132
+ return [2 /*return*/];
133
+ }
134
+ if (modelName === "AuditEvent") {
135
+ return [2 /*return*/];
136
+ }
137
+ beforePlain = (0, diff_1.toAuditPlain)(before);
138
+ afterPlain = (0, diff_1.toAuditPlain)(after);
139
+ diff = (0, diff_1.changedFieldDiff)({ after: afterPlain, before: beforePlain, extraRedact: extraRedact });
140
+ recordIdValue = (_c = afterPlain === null || afterPlain === void 0 ? void 0 : afterPlain._id) !== null && _c !== void 0 ? _c : beforePlain === null || beforePlain === void 0 ? void 0 : beforePlain._id;
141
+ return [4 /*yield*/, (0, exports.recordAuditEvent)({
142
+ actorId: actorIdFromRequest(req),
143
+ after: diff.after,
144
+ before: diff.before,
145
+ modelName: modelName,
146
+ operation: operationFromVerb(verb),
147
+ organizationId: organizationIdFromAuditContext(req, afterPlain, beforePlain),
148
+ recordId: recordIdValue != null ? String(recordIdValue) : undefined,
149
+ recordLabel: (_d = recordLabel !== null && recordLabel !== void 0 ? recordLabel : (0, diff_1.recordLabelFromDoc)(afterPlain)) !== null && _d !== void 0 ? _d : (0, diff_1.recordLabelFromDoc)(beforePlain),
150
+ source: "admin",
151
+ verb: verb,
152
+ })];
153
+ case 1:
154
+ _f.sent();
155
+ return [3 /*break*/, 3];
156
+ case 2:
157
+ error_1 = _f.sent();
158
+ logger_1.logger.error("Failed to persist AuditEvent", error_1);
159
+ return [3 /*break*/, 3];
160
+ case 3: return [2 /*return*/];
161
+ }
162
+ });
163
+ }); };
164
+ exports.maybeRecordAdminAudit = maybeRecordAdminAudit;
165
+ var resolveAuditRedact = function (audit) {
166
+ var _a;
167
+ if (!audit) {
168
+ return undefined;
169
+ }
170
+ if (audit === true) {
171
+ return [];
172
+ }
173
+ return (_a = audit.redact) !== null && _a !== void 0 ? _a : [];
174
+ };
175
+ var actorIdFromRequest = function (req) {
176
+ var user = req.user;
177
+ if (!user) {
178
+ return undefined;
179
+ }
180
+ if (user.id) {
181
+ return String(user.id);
182
+ }
183
+ if (user._id) {
184
+ return String(user._id);
185
+ }
186
+ return undefined;
187
+ };
188
+ var idString = function (value) {
189
+ if (value === null || value === undefined) {
190
+ return undefined;
191
+ }
192
+ if (typeof value === "string") {
193
+ return value.length > 0 ? value : undefined;
194
+ }
195
+ if (typeof value === "object" && ("id" in value || "_id" in value)) {
196
+ var record = value;
197
+ if (record.id !== undefined && record.id !== null) {
198
+ return String(record.id);
199
+ }
200
+ if (record._id !== undefined && record._id !== null) {
201
+ return String(record._id);
202
+ }
203
+ }
204
+ return String(value);
205
+ };
206
+ var organizationIdFromAuditContext = function (req, after, before) {
207
+ var _a, _b, _c;
208
+ var organization = req.organization;
209
+ var fromRequest = idString(organization);
210
+ if (fromRequest) {
211
+ return fromRequest;
212
+ }
213
+ var fromAls = idString((_a = (0, orgContext_1.getOrgContext)()) === null || _a === void 0 ? void 0 : _a.organization);
214
+ if (fromAls) {
215
+ return fromAls;
216
+ }
217
+ var fromHeader = typeof req.header === "function" ? (_b = req.header(orgContext_1.ORGANIZATION_ID_HEADER)) === null || _b === void 0 ? void 0 : _b.trim() : undefined;
218
+ if (fromHeader) {
219
+ return fromHeader;
220
+ }
221
+ var fromDoc = (_c = after === null || after === void 0 ? void 0 : after.organizationId) !== null && _c !== void 0 ? _c : before === null || before === void 0 ? void 0 : before.organizationId;
222
+ return idString(fromDoc);
223
+ };
224
+ /** 24-hex ObjectIds only. mongoose.isValidObjectId also accepts 12-char strings. */
225
+ var isCanonicalObjectId = function (id) {
226
+ try {
227
+ return new mongoose_1.default.Types.ObjectId(id).toString() === id;
228
+ }
229
+ catch (_a) {
230
+ return false;
231
+ }
232
+ };
233
+ var actorIdForAuditWrite = function (actorId) {
234
+ if (!actorId) {
235
+ return undefined;
236
+ }
237
+ if (!isCanonicalObjectId(actorId)) {
238
+ logger_1.logger.warn("AuditEvent actorId is not an ObjectId, recording without an actor: ".concat(actorId));
239
+ return undefined;
240
+ }
241
+ return actorId;
242
+ };
243
+ exports.actorIdForAuditWrite = actorIdForAuditWrite;
244
+ var actorObjectId = function (actorId) {
245
+ var validId = (0, exports.actorIdForAuditWrite)(actorId);
246
+ if (!validId) {
247
+ return undefined;
248
+ }
249
+ return new mongoose_1.default.Types.ObjectId(validId);
250
+ };
251
+ /** Capture pre-mutation state only when audit is on. A throwing toJSON must not fail the write. */
252
+ var snapshotAuditBefore = function (_a) {
253
+ var audit = _a.audit, doc = _a.doc;
254
+ if (!audit) {
255
+ return undefined;
256
+ }
257
+ try {
258
+ if (typeof doc.toJSON === "function") {
259
+ return doc.toJSON();
260
+ }
261
+ return doc;
262
+ }
263
+ catch (error) {
264
+ logger_1.logger.error("Failed to snapshot document for AuditEvent", error);
265
+ return undefined;
266
+ }
267
+ };
268
+ exports.snapshotAuditBefore = snapshotAuditBefore;
269
+ var persistAuditEvent = function (write) { return __awaiter(void 0, void 0, void 0, function () {
270
+ var actorId;
271
+ return __generator(this, function (_a) {
272
+ switch (_a.label) {
273
+ case 0:
274
+ if (write.modelName === "AuditEvent") {
275
+ return [2 /*return*/];
276
+ }
277
+ if (!auditEventModel) {
278
+ if (!missingPluginLogged) {
279
+ missingPluginLogged = true;
280
+ logger_1.logger.error(MISSING_PLUGIN_MESSAGE);
281
+ }
282
+ return [2 /*return*/];
283
+ }
284
+ actorId = actorObjectId(write.actorId);
285
+ return [4 /*yield*/, auditEventModel.create(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({}, (actorId ? { actorId: actorId } : {})), (write.after ? { after: write.after } : {})), (write.before ? { before: write.before } : {})), { modelName: write.modelName, operation: write.operation }), (write.organizationId ? { organizationId: write.organizationId } : {})), (write.recordId ? { recordId: write.recordId } : {})), (write.recordLabel ? { recordLabel: write.recordLabel } : {})), { source: write.source, verb: write.verb }))];
286
+ case 1:
287
+ _a.sent();
288
+ return [2 /*return*/];
289
+ }
290
+ });
291
+ }); };
292
+ var runAuditWrite = function (write) { return __awaiter(void 0, void 0, void 0, function () {
293
+ var error_2;
294
+ return __generator(this, function (_a) {
295
+ switch (_a.label) {
296
+ case 0:
297
+ _a.trys.push([0, 4, , 5]);
298
+ if (!auditEnqueue) return [3 /*break*/, 2];
299
+ return [4 /*yield*/, auditEnqueue(write)];
300
+ case 1:
301
+ _a.sent();
302
+ return [2 /*return*/];
303
+ case 2: return [4 /*yield*/, persistAuditEvent(write)];
304
+ case 3:
305
+ _a.sent();
306
+ return [3 /*break*/, 5];
307
+ case 4:
308
+ error_2 = _a.sent();
309
+ logger_1.logger.error("Failed to persist AuditEvent", error_2);
310
+ return [3 /*break*/, 5];
311
+ case 5: return [2 /*return*/];
312
+ }
313
+ });
314
+ }); };
315
+ var persistEnqueuedAuditEvent = function (write) { return __awaiter(void 0, void 0, void 0, function () {
316
+ return __generator(this, function (_a) {
317
+ switch (_a.label) {
318
+ case 0: return [4 /*yield*/, persistAuditEvent(write)];
319
+ case 1:
320
+ _a.sent();
321
+ return [2 /*return*/];
322
+ }
323
+ });
324
+ }); };
325
+ exports.persistEnqueuedAuditEvent = persistEnqueuedAuditEvent;
326
+ var recordAuditEvent = function (write) {
327
+ var run = runAuditWrite(write);
328
+ inflightWrites.add(run);
329
+ void run.finally(function () {
330
+ inflightWrites.delete(run);
331
+ });
332
+ return run;
333
+ };
334
+ exports.recordAuditEvent = recordAuditEvent;
335
+ var maybeRecordModelRouterAudit = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
336
+ var extraRedact, beforePlain, afterPlain, diff, error_3;
337
+ var _c;
338
+ var after = _b.after, audit = _b.audit, before = _b.before, modelName = _b.modelName, operation = _b.operation, recordId = _b.recordId, req = _b.req, verb = _b.verb;
339
+ return __generator(this, function (_d) {
340
+ switch (_d.label) {
341
+ case 0:
342
+ _d.trys.push([0, 2, , 3]);
343
+ extraRedact = resolveAuditRedact(audit);
344
+ if (extraRedact === undefined) {
345
+ return [2 /*return*/];
346
+ }
347
+ beforePlain = (0, diff_1.toAuditPlain)(before);
348
+ afterPlain = (0, diff_1.toAuditPlain)(after);
349
+ diff = (0, diff_1.changedFieldDiff)({ after: afterPlain, before: beforePlain, extraRedact: extraRedact });
350
+ return [4 /*yield*/, (0, exports.recordAuditEvent)({
351
+ actorId: actorIdFromRequest(req),
352
+ after: diff.after,
353
+ before: diff.before,
354
+ modelName: modelName,
355
+ operation: operation,
356
+ organizationId: organizationIdFromAuditContext(req, afterPlain, beforePlain),
357
+ recordId: recordId,
358
+ recordLabel: (_c = (0, diff_1.recordLabelFromDoc)(afterPlain)) !== null && _c !== void 0 ? _c : (0, diff_1.recordLabelFromDoc)(beforePlain),
359
+ source: "modelRouter",
360
+ verb: verb,
361
+ })];
362
+ case 1:
363
+ _d.sent();
364
+ return [3 /*break*/, 3];
365
+ case 2:
366
+ error_3 = _d.sent();
367
+ logger_1.logger.error("Failed to persist AuditEvent", error_3);
368
+ return [3 /*break*/, 3];
369
+ case 3: return [2 /*return*/];
370
+ }
371
+ });
372
+ }); };
373
+ exports.maybeRecordModelRouterAudit = maybeRecordModelRouterAudit;
package/dist/auth.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import express from "express";
2
- import type { Model, ObjectId } from "mongoose";
2
+ import type { Model, ObjectId, Query } from "mongoose";
3
+ import passport from "passport";
3
4
  import type { AuthOptions } from "./expressServer";
4
5
  export interface User {
5
6
  _id: ObjectId | string;
@@ -10,25 +11,34 @@ export interface User {
10
11
  * This can be helpful for pre-signup users.
11
12
  */
12
13
  isAnonymous?: boolean;
14
+ /** Login identifier; present on passport-local and Better Auth app users. */
15
+ email?: string;
16
+ /** Incremented on password reset so outstanding refresh tokens fail. */
17
+ tokenEpoch?: number;
18
+ /** Set by emailVerificationPlugin; login may require this when requireEmailVerification is on. */
19
+ emailVerified?: boolean;
13
20
  }
14
21
  export interface UserModel extends Model<User> {
15
22
  createAnonymousUser?: (id?: string) => Promise<User>;
16
23
  postCreate?: (body: Record<string, unknown>) => Promise<void>;
17
- createStrategy(): any;
18
- serializeUser(): any;
19
- deserializeUser(): any;
20
- findByUsername(username: string, findOpts: any): any;
24
+ createStrategy(): passport.Strategy;
25
+ serializeUser(): (user: User, cb: (err: unknown, id?: unknown) => void) => void;
26
+ deserializeUser(): (username: string, cb: (err: unknown, user?: User | null) => void) => void;
27
+ findByUsername(username: string, findOpts: boolean | {
28
+ selectHashSaltFields?: boolean;
29
+ }): Query<User | null, User>;
21
30
  }
22
31
  export interface GenerateTokensOptions {
23
32
  sessionId?: string;
24
33
  }
25
34
  export declare const authenticateMiddleware: (anonymous?: boolean) => (req: express.Request, res: express.Response, next: express.NextFunction) => any;
26
35
  /**
27
- * User fields that confer authority. Self-service requests (anonymous signup, `PATCH /me`)
28
- * must never set them, or any caller could grant themselves admin or an RBAC role. Elevate
29
- * users through the admin API or `access.roles.assign` instead.
36
+ * User fields that confer authority or skip security gates. Self-service requests
37
+ * (anonymous signup, `PATCH /me`) must never set them, or any caller could grant
38
+ * themselves admin, an RBAC role, a verified email, or a reset epoch. Elevate users
39
+ * through the admin API or `access.roles.assign` instead.
30
40
  */
31
- export declare const PRIVILEGED_USER_FIELDS: readonly ["admin", "roles", "organizationIds"];
41
+ export declare const PRIVILEGED_USER_FIELDS: readonly ["admin", "roles", "organizationIds", "emailVerified", "tokenEpoch"];
32
42
  /**
33
43
  * Removes {@link PRIVILEGED_USER_FIELDS} from a self-service body. Fields are dropped rather
34
44
  * than rejected so clients that echo a whole user object back still succeed.
@@ -40,7 +50,10 @@ export declare const stripPrivilegedUserFields: (body: Record<string, unknown>,
40
50
  * explicitly marks authorized legacy-admin writes after its additional checks.
41
51
  */
42
52
  export declare const omitUserRolesFromWriteBody: (modelName: string, accessControl: unknown, body: unknown, allowAdminWrite?: boolean) => unknown;
43
- export declare const signupUser: (userModel: UserModel, email: string, password: string, body?: Record<string, unknown>) => Promise<any>;
53
+ export declare const signupUser: (userModel: UserModel, email: string, password: string, body?: Record<string, unknown>) => Promise<User & {
54
+ postCreate?: (body: Record<string, unknown>) => Promise<void>;
55
+ save: () => Promise<unknown>;
56
+ }>;
44
57
  /** A user document exposing passport-local-mongoose's `setPassword`. */
45
58
  export interface HasSetPassword {
46
59
  _id?: unknown;