@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,262 @@
1
+ /**
2
+ * Snapshot Mongoose models into a catalog and diff against the last generated
3
+ * `schemaAfter`. Drives `terreno-migrate generate` (safe ops vs fail-closed stubs).
4
+ */
5
+ import type {Model, Document as MongooseDocument, SchemaType} from "mongoose";
6
+
7
+ export interface SchemaFieldCatalog {
8
+ path: string;
9
+ instance: string;
10
+ required: boolean;
11
+ unique: boolean;
12
+ }
13
+
14
+ export interface SchemaIndexCatalog {
15
+ keys: Record<string, number | string>;
16
+ unique: boolean;
17
+ }
18
+
19
+ export interface ModelSchemaCatalog {
20
+ collection: string;
21
+ modelName: string;
22
+ fields: SchemaFieldCatalog[];
23
+ indexes: SchemaIndexCatalog[];
24
+ }
25
+
26
+ export interface SchemaCatalog {
27
+ models: Record<string, ModelSchemaCatalog>;
28
+ }
29
+
30
+ export type SchemaDiffKind =
31
+ | "addIndex"
32
+ | "dropIndex"
33
+ | "addOptionalField"
34
+ | "addRequiredField"
35
+ | "addUniqueIndex"
36
+ | "changeFieldType"
37
+ | "removeField"
38
+ | "renameField";
39
+
40
+ export interface SchemaDiffOp {
41
+ kind: SchemaDiffKind;
42
+ safe: boolean;
43
+ modelName: string;
44
+ path?: string;
45
+ fromPath?: string;
46
+ toPath?: string;
47
+ keys?: Record<string, number | string>;
48
+ }
49
+
50
+ export interface SchemaDiff {
51
+ ops: SchemaDiffOp[];
52
+ }
53
+
54
+ const skipPaths = new Set(["_id", "__v"]);
55
+
56
+ const indexKey = (index: SchemaIndexCatalog): string => {
57
+ return `${JSON.stringify(index.keys)}:${index.unique ? "u" : "n"}`;
58
+ };
59
+
60
+ const fieldMap = (fields: SchemaFieldCatalog[]): Map<string, SchemaFieldCatalog> => {
61
+ return new Map(fields.map((field) => [field.path, field]));
62
+ };
63
+
64
+ export const buildSchemaCatalog = ({
65
+ models,
66
+ }: {
67
+ models: Model<MongooseDocument>[];
68
+ }): SchemaCatalog => {
69
+ const catalog: SchemaCatalog = {models: {}};
70
+ for (const model of models) {
71
+ const fields: SchemaFieldCatalog[] = [];
72
+ const paths = model.schema.paths as Record<string, SchemaType>;
73
+ for (const path of Object.keys(paths)) {
74
+ if (skipPaths.has(path)) {
75
+ continue;
76
+ }
77
+ const schemaType = paths[path];
78
+ const required = Boolean(schemaType.isRequired);
79
+ const unique = Boolean((schemaType as {options?: {unique?: boolean}}).options?.unique);
80
+ fields.push({
81
+ instance: schemaType.instance || "Mixed",
82
+ path,
83
+ required,
84
+ unique,
85
+ });
86
+ }
87
+ fields.sort((a, b) => a.path.localeCompare(b.path));
88
+
89
+ const indexes: SchemaIndexCatalog[] = model.schema
90
+ .indexes()
91
+ .map((entry) => {
92
+ const [keys, options] = entry;
93
+ return {
94
+ keys: keys as Record<string, number | string>,
95
+ unique: Boolean(options?.unique),
96
+ };
97
+ })
98
+ .sort((a, b) => indexKey(a).localeCompare(indexKey(b)));
99
+
100
+ catalog.models[model.modelName] = {
101
+ collection: model.collection.collectionName,
102
+ fields,
103
+ indexes,
104
+ modelName: model.modelName,
105
+ };
106
+ }
107
+ return catalog;
108
+ };
109
+
110
+ export const diffSchemaCatalog = ({
111
+ after,
112
+ before,
113
+ }: {
114
+ after: SchemaCatalog;
115
+ before: SchemaCatalog;
116
+ }): SchemaDiff => {
117
+ const ops: SchemaDiffOp[] = [];
118
+ const modelNames = new Set([...Object.keys(before.models), ...Object.keys(after.models)]);
119
+
120
+ for (const modelName of [...modelNames].sort()) {
121
+ const beforeModel = before.models[modelName] ?? {
122
+ collection: after.models[modelName]?.collection ?? modelName,
123
+ fields: [],
124
+ indexes: [],
125
+ modelName,
126
+ };
127
+ const afterModel = after.models[modelName] ?? {
128
+ collection: beforeModel.collection,
129
+ fields: [],
130
+ indexes: [],
131
+ modelName,
132
+ };
133
+
134
+ const beforeFields = fieldMap(beforeModel.fields);
135
+ const afterFields = fieldMap(afterModel.fields);
136
+ const removed = beforeModel.fields.filter((field) => !afterFields.has(field.path));
137
+ const added = afterModel.fields.filter((field) => !beforeFields.has(field.path));
138
+
139
+ const usedRemoved = new Set<string>();
140
+ const usedAdded = new Set<string>();
141
+ for (const removedField of removed) {
142
+ const match = added.find(
143
+ (addedField) =>
144
+ addedField.instance === removedField.instance && !usedAdded.has(addedField.path)
145
+ );
146
+ if (!match) {
147
+ continue;
148
+ }
149
+ usedRemoved.add(removedField.path);
150
+ usedAdded.add(match.path);
151
+ ops.push({
152
+ fromPath: removedField.path,
153
+ kind: "renameField",
154
+ modelName,
155
+ safe: false,
156
+ toPath: match.path,
157
+ });
158
+ if (match.required) {
159
+ ops.push({
160
+ kind: "addRequiredField",
161
+ modelName,
162
+ path: match.path,
163
+ safe: false,
164
+ });
165
+ }
166
+ }
167
+
168
+ for (const field of added) {
169
+ if (usedAdded.has(field.path)) {
170
+ continue;
171
+ }
172
+ if (field.required) {
173
+ ops.push({
174
+ kind: "addRequiredField",
175
+ modelName,
176
+ path: field.path,
177
+ safe: false,
178
+ });
179
+ continue;
180
+ }
181
+ ops.push({
182
+ kind: "addOptionalField",
183
+ modelName,
184
+ path: field.path,
185
+ safe: true,
186
+ });
187
+ }
188
+
189
+ for (const field of removed) {
190
+ if (usedRemoved.has(field.path)) {
191
+ continue;
192
+ }
193
+ ops.push({
194
+ kind: "removeField",
195
+ modelName,
196
+ path: field.path,
197
+ safe: false,
198
+ });
199
+ }
200
+
201
+ for (const field of afterModel.fields) {
202
+ const previous = beforeFields.get(field.path);
203
+ if (!previous) {
204
+ continue;
205
+ }
206
+ if (previous.instance !== field.instance) {
207
+ ops.push({
208
+ kind: "changeFieldType",
209
+ modelName,
210
+ path: field.path,
211
+ safe: false,
212
+ });
213
+ }
214
+ if (!previous.required && field.required) {
215
+ ops.push({
216
+ kind: "addRequiredField",
217
+ modelName,
218
+ path: field.path,
219
+ safe: false,
220
+ });
221
+ }
222
+ }
223
+
224
+ const beforeIndexes = new Set(beforeModel.indexes.map(indexKey));
225
+ const afterIndexes = new Set(afterModel.indexes.map(indexKey));
226
+
227
+ for (const index of afterModel.indexes) {
228
+ if (beforeIndexes.has(indexKey(index))) {
229
+ continue;
230
+ }
231
+ if (index.unique) {
232
+ ops.push({
233
+ keys: index.keys,
234
+ kind: "addUniqueIndex",
235
+ modelName,
236
+ safe: false,
237
+ });
238
+ continue;
239
+ }
240
+ ops.push({
241
+ keys: index.keys,
242
+ kind: "addIndex",
243
+ modelName,
244
+ safe: true,
245
+ });
246
+ }
247
+
248
+ for (const index of beforeModel.indexes) {
249
+ if (afterIndexes.has(indexKey(index))) {
250
+ continue;
251
+ }
252
+ ops.push({
253
+ keys: index.keys,
254
+ kind: "dropIndex",
255
+ modelName,
256
+ safe: true,
257
+ });
258
+ }
259
+ }
260
+
261
+ return {ops};
262
+ };
@@ -0,0 +1,94 @@
1
+ /**
2
+ * Shared types and constants for Terreno MongoDB migrations. History and the
3
+ * migrate lock both live in the native `terreno_migrations` collection.
4
+ */
5
+ import type mongoose from "mongoose";
6
+
7
+ /** Mongo collection that stores applied migration rows and the lock document. */
8
+ export const MIGRATIONS_COLLECTION = "terreno_migrations";
9
+
10
+ /** Reserved `_id` for the migrate lock row (Task 1.2). */
11
+ export const MIGRATION_LOCK_ID = "_lock";
12
+
13
+ /** Native collection documents in `terreno_migrations` (string `_id`, not ObjectId). */
14
+ export interface MigrationStoreDoc {
15
+ _id: string;
16
+ id?: string;
17
+ checksum?: string;
18
+ appliedAt?: Date;
19
+ holder?: string;
20
+ heartbeatAt?: Date;
21
+ expiresAt?: Date;
22
+ }
23
+
24
+ export interface MigrationLogger {
25
+ debug: (message: string, ...meta: unknown[]) => void;
26
+ info: (message: string, ...meta: unknown[]) => void;
27
+ warn: (message: string, ...meta: unknown[]) => void;
28
+ error: (message: string, ...meta: unknown[]) => void;
29
+ }
30
+
31
+ export interface MigrationContext {
32
+ dryRun: boolean;
33
+ mongoose: typeof mongoose;
34
+ logger: MigrationLogger;
35
+ addLog?: (level: "info" | "warn" | "error", message: string) => Promise<void>;
36
+ checkCancellation?: () => Promise<void>;
37
+ }
38
+
39
+ export interface MigrationModule {
40
+ id: string;
41
+ up: (ctx: MigrationContext) => Promise<void>;
42
+ down?: (ctx: MigrationContext) => Promise<void>;
43
+ schemaAfter?: unknown;
44
+ }
45
+
46
+ export interface LoadedMigration extends MigrationModule {
47
+ checksum: string;
48
+ }
49
+
50
+ export interface AppliedMigrationRecord {
51
+ id: string;
52
+ checksum: string;
53
+ appliedAt: Date;
54
+ }
55
+
56
+ export interface RunMigrationsOptions {
57
+ migrations: LoadedMigration[];
58
+ dryRun: boolean;
59
+ connection: mongoose.Connection;
60
+ mongoose: typeof mongoose;
61
+ logger?: MigrationLogger;
62
+ lockTtlMs?: number;
63
+ lockPollMs?: number;
64
+ checkCancellation?: () => Promise<void>;
65
+ addLog?: MigrationContext["addLog"];
66
+ }
67
+
68
+ export interface RunMigrationsResult {
69
+ applied: string[];
70
+ skipped: string[];
71
+ dryRun: boolean;
72
+ }
73
+
74
+ export interface RunDownMigrationsOptions {
75
+ migrations: LoadedMigration[];
76
+ dryRun: boolean;
77
+ connection: mongoose.Connection;
78
+ mongoose: typeof mongoose;
79
+ logger?: MigrationLogger;
80
+ lockTtlMs?: number;
81
+ lockPollMs?: number;
82
+ steps: number;
83
+ }
84
+
85
+ export interface RunDownMigrationsResult {
86
+ reversed: string[];
87
+ dryRun: boolean;
88
+ }
89
+
90
+ export interface MigrationStatus {
91
+ applied: AppliedMigrationRecord[];
92
+ pending: Array<{id: string; checksum: string}>;
93
+ lock: {holder: string; expiresAt: Date} | null;
94
+ }
@@ -0,0 +1,129 @@
1
+ import {beforeEach, describe, it} from "bun:test";
2
+ import {createHash} from "node:crypto";
3
+ import {assert} from "chai";
4
+ import {DateTime} from "luxon";
5
+ import mongoose from "mongoose";
6
+
7
+ import {McpServiceToken} from "./mcpServiceToken";
8
+
9
+ const hashToken = (token: string): string => createHash("sha256").update(token).digest("hex");
10
+
11
+ describe("McpServiceToken", () => {
12
+ beforeEach(async () => {
13
+ await McpServiceToken.deleteMany({});
14
+ await McpServiceToken.syncIndexes();
15
+ });
16
+
17
+ it("issues an mcp_ token and stores only its SHA-256 hash", async () => {
18
+ const userId = new mongoose.Types.ObjectId();
19
+ const issued = await McpServiceToken.issueFor({_id: userId}, {name: "Perplexity"});
20
+
21
+ assert.match(issued.token, /^mcp_[0-9a-f]{64}$/);
22
+ assert.equal(issued.mcpServiceToken.name, "Perplexity");
23
+ assert.equal(issued.mcpServiceToken.tokenHash, hashToken(issued.token));
24
+ assert.equal(issued.mcpServiceToken.tokenPrefix, issued.token.slice(4, 12));
25
+ assert.notInclude(JSON.stringify(issued.mcpServiceToken.toJSON()), issued.token);
26
+ });
27
+
28
+ it("verifies an active token but not a revoked or expired token", async () => {
29
+ const userId = new mongoose.Types.ObjectId();
30
+ const active = await McpServiceToken.issueFor({_id: userId}, {name: "Active"});
31
+ const revoked = await McpServiceToken.issueFor({_id: userId}, {name: "Revoked"});
32
+ const expired = await McpServiceToken.issueFor(
33
+ {_id: userId},
34
+ {expiresAt: DateTime.now().minus({minute: 1}).toJSDate(), name: "Expired"}
35
+ );
36
+
37
+ const revokedToken = await McpServiceToken.revokeForUser(
38
+ {_id: userId},
39
+ revoked.mcpServiceToken._id
40
+ );
41
+
42
+ assert.equal(
43
+ (await McpServiceToken.verify(active.token))?._id.toString(),
44
+ active.mcpServiceToken._id.toString()
45
+ );
46
+ assert.isDefined(revokedToken?.revokedAt);
47
+ assert.isNull(await McpServiceToken.verify(revoked.token));
48
+ assert.isNull(await McpServiceToken.verify(expired.token));
49
+ assert.isNull(await McpServiceToken.verify("mcp_unknown"));
50
+ });
51
+
52
+ it("allows only the owner to revoke an active token once", async () => {
53
+ const ownerId = new mongoose.Types.ObjectId();
54
+ const otherUserId = new mongoose.Types.ObjectId();
55
+ const issued = await McpServiceToken.issueFor({_id: ownerId}, {name: "Owner token"});
56
+
57
+ assert.isNull(
58
+ await McpServiceToken.revokeForUser({_id: otherUserId}, issued.mcpServiceToken._id)
59
+ );
60
+
61
+ const revoked = await McpServiceToken.revokeForUser({_id: ownerId}, issued.mcpServiceToken._id);
62
+ assert.equal(revoked?._id.toString(), issued.mcpServiceToken._id.toString());
63
+ assert.instanceOf(revoked?.revokedAt, Date);
64
+
65
+ assert.isNull(await McpServiceToken.revokeForUser({_id: ownerId}, issued.mcpServiceToken._id));
66
+ assert.isNull(
67
+ await McpServiceToken.revokeForUser({_id: ownerId}, new mongoose.Types.ObjectId())
68
+ );
69
+ });
70
+
71
+ it("enforces unique token hashes", async () => {
72
+ const tokenHash = "same-hash";
73
+ const tokenFields = {
74
+ name: "Duplicate",
75
+ tokenHash,
76
+ tokenPrefix: "duplicate",
77
+ userId: new mongoose.Types.ObjectId(),
78
+ };
79
+
80
+ await McpServiceToken.create(tokenFields);
81
+
82
+ let error: unknown;
83
+ try {
84
+ await McpServiceToken.create(tokenFields);
85
+ } catch (caughtError) {
86
+ error = caughtError;
87
+ }
88
+
89
+ assert.instanceOf(error, Error);
90
+ assert.match(error.message, /duplicate key/i);
91
+ });
92
+
93
+ it("counts only active tokens for a user", async () => {
94
+ const userId = new mongoose.Types.ObjectId();
95
+ const otherUserId = new mongoose.Types.ObjectId();
96
+ const revoked = await McpServiceToken.issueFor({_id: userId}, {name: "Revoked"});
97
+ await McpServiceToken.issueFor({_id: userId}, {name: "Active"});
98
+ await McpServiceToken.issueFor(
99
+ {_id: userId},
100
+ {expiresAt: DateTime.now().minus({minute: 1}).toJSDate(), name: "Expired"}
101
+ );
102
+ await McpServiceToken.issueFor({_id: otherUserId}, {name: "Other"});
103
+ await McpServiceToken.revokeForUser({_id: userId}, revoked.mcpServiceToken._id);
104
+
105
+ assert.equal(await McpServiceToken.countActiveForUser(userId), 1);
106
+ });
107
+
108
+ it("revokes on document deleteOne instead of removing the row", async () => {
109
+ const userId = new mongoose.Types.ObjectId();
110
+ const issued = await McpServiceToken.issueFor({_id: userId}, {name: "Admin delete"});
111
+
112
+ await issued.mcpServiceToken.deleteOne();
113
+
114
+ const stored = await McpServiceToken.findById(issued.mcpServiceToken._id);
115
+ assert.isDefined(stored?.revokedAt);
116
+ assert.isNull(await McpServiceToken.verify(issued.token));
117
+ });
118
+
119
+ it("revokes on query deleteOne used by admin DELETE", async () => {
120
+ const userId = new mongoose.Types.ObjectId();
121
+ const issued = await McpServiceToken.issueFor({_id: userId}, {name: "Query delete"});
122
+
123
+ await McpServiceToken.deleteOne({_id: issued.mcpServiceToken._id});
124
+
125
+ const stored = await McpServiceToken.findById(issued.mcpServiceToken._id);
126
+ assert.isDefined(stored?.revokedAt);
127
+ assert.isNull(await McpServiceToken.verify(issued.token));
128
+ });
129
+ });
@@ -0,0 +1,158 @@
1
+ import {createHash, randomBytes} from "node:crypto";
2
+ import {DateTime} from "luxon";
3
+ import mongoose from "mongoose";
4
+
5
+ import {createdUpdatedPlugin, findExactlyOne, findOneOrNone, findOneOrNoneFor} from "../plugins";
6
+ import type {McpServiceTokenDocument, McpServiceTokenModel} from "../types/mcpServiceToken";
7
+
8
+ export type {
9
+ McpServiceTokenDocument,
10
+ McpServiceTokenIssueOptions,
11
+ McpServiceTokenModel,
12
+ McpServiceTokenStatics,
13
+ } from "../types/mcpServiceToken";
14
+
15
+ const MCP_SERVICE_TOKEN_PREFIX = "mcp_";
16
+ const MCP_SERVICE_TOKEN_RANDOM_BYTES = 32;
17
+ const MCP_SERVICE_TOKEN_DISPLAY_LENGTH = 8;
18
+
19
+ const hashToken = (token: string): string => createHash("sha256").update(token).digest("hex");
20
+
21
+ const mcpServiceTokenSchema = new mongoose.Schema<McpServiceTokenDocument, McpServiceTokenModel>(
22
+ {
23
+ expiresAt: {
24
+ description: "When this MCP service token expires; unset when it does not expire",
25
+ type: Date,
26
+ },
27
+ lastUsedAt: {
28
+ description: "When this MCP service token most recently authenticated an MCP request",
29
+ type: Date,
30
+ },
31
+ name: {
32
+ description: "User-provided label identifying the MCP service token",
33
+ required: true,
34
+ trim: true,
35
+ type: String,
36
+ },
37
+ revokedAt: {
38
+ description: "When this MCP service token was revoked; unset while it remains active",
39
+ type: Date,
40
+ },
41
+ tokenHash: {
42
+ description: "SHA-256 hash of the full MCP service token plaintext",
43
+ required: true,
44
+ type: String,
45
+ unique: true,
46
+ },
47
+ tokenPrefix: {
48
+ description: "First eight characters after mcp_ used to identify the token safely",
49
+ required: true,
50
+ type: String,
51
+ },
52
+ userId: {
53
+ description: "The user this MCP service token acts as",
54
+ index: true,
55
+ ref: "User",
56
+ required: true,
57
+ type: mongoose.Schema.Types.ObjectId,
58
+ },
59
+ },
60
+ {strict: "throw", toJSON: {virtuals: true}, toObject: {virtuals: true}}
61
+ );
62
+
63
+ mcpServiceTokenSchema.index({expiresAt: 1}, {expireAfterSeconds: 0});
64
+ mcpServiceTokenSchema.index({revokedAt: 1, userId: 1});
65
+
66
+ mcpServiceTokenSchema.plugin(createdUpdatedPlugin);
67
+ mcpServiceTokenSchema.plugin(findOneOrNone);
68
+ mcpServiceTokenSchema.plugin(findExactlyOne);
69
+
70
+ const revokeInsteadOfDelete = async (
71
+ doc: McpServiceTokenDocument | null
72
+ ): Promise<McpServiceTokenDocument | null> => {
73
+ if (!doc) {
74
+ return null;
75
+ }
76
+ if (!doc.revokedAt) {
77
+ doc.set("revokedAt", DateTime.now().toJSDate());
78
+ await doc.save();
79
+ }
80
+ return doc;
81
+ };
82
+
83
+ mcpServiceTokenSchema.methods = {
84
+ ...mcpServiceTokenSchema.methods,
85
+ async deleteOne(this: McpServiceTokenDocument): Promise<McpServiceTokenDocument> {
86
+ const revoked = await revokeInsteadOfDelete(this);
87
+ return revoked ?? this;
88
+ },
89
+ };
90
+
91
+ mcpServiceTokenSchema.pre("deleteOne", {document: false, query: true}, async function () {
92
+ const existing = await findOneOrNoneFor(this.model, this.getFilter());
93
+ await revokeInsteadOfDelete(existing as McpServiceTokenDocument | null);
94
+ this.setQuery({_id: {$exists: false}});
95
+ });
96
+
97
+ mcpServiceTokenSchema.statics = {
98
+ ...mcpServiceTokenSchema.statics,
99
+ async countActiveForUser(
100
+ this: McpServiceTokenModel,
101
+ userId: mongoose.Types.ObjectId
102
+ ): Promise<number> {
103
+ const now = DateTime.now().toJSDate();
104
+ return this.countDocuments({
105
+ $or: [{expiresAt: {$exists: false}}, {expiresAt: {$gt: now}}],
106
+ revokedAt: {$exists: false},
107
+ userId,
108
+ });
109
+ },
110
+ async issueFor(
111
+ this: McpServiceTokenModel,
112
+ user: {_id: {toString(): string}},
113
+ options: {expiresAt?: Date; name: string}
114
+ ): Promise<{mcpServiceToken: McpServiceTokenDocument; token: string}> {
115
+ const token = `${MCP_SERVICE_TOKEN_PREFIX}${randomBytes(MCP_SERVICE_TOKEN_RANDOM_BYTES).toString("hex")}`;
116
+ const mcpServiceToken = await this.create({
117
+ expiresAt: options.expiresAt,
118
+ name: options.name,
119
+ tokenHash: hashToken(token),
120
+ tokenPrefix: token.slice(
121
+ MCP_SERVICE_TOKEN_PREFIX.length,
122
+ MCP_SERVICE_TOKEN_PREFIX.length + MCP_SERVICE_TOKEN_DISPLAY_LENGTH
123
+ ),
124
+ userId: new mongoose.Types.ObjectId(String(user._id)),
125
+ });
126
+ return {mcpServiceToken, token};
127
+ },
128
+ async revokeForUser(
129
+ this: McpServiceTokenModel,
130
+ user: {_id: {toString(): string}},
131
+ tokenId: mongoose.Types.ObjectId
132
+ ): Promise<McpServiceTokenDocument | null> {
133
+ return this.findOneAndUpdate(
134
+ {
135
+ _id: tokenId,
136
+ revokedAt: {$exists: false},
137
+ userId: new mongoose.Types.ObjectId(String(user._id)),
138
+ },
139
+ {$set: {revokedAt: DateTime.now().toJSDate()}},
140
+ {returnDocument: "after"}
141
+ );
142
+ },
143
+ async verify(this: McpServiceTokenModel, token: string): Promise<McpServiceTokenDocument | null> {
144
+ const now = DateTime.now().toJSDate();
145
+ return this.findOneOrNone({
146
+ $or: [{expiresAt: {$exists: false}}, {expiresAt: {$gt: now}}],
147
+ revokedAt: {$exists: false},
148
+ tokenHash: hashToken(token),
149
+ });
150
+ },
151
+ };
152
+
153
+ export const McpServiceToken =
154
+ (mongoose.models.McpServiceToken as McpServiceTokenModel | undefined) ??
155
+ mongoose.model<McpServiceTokenDocument, McpServiceTokenModel>(
156
+ "McpServiceToken",
157
+ mcpServiceTokenSchema
158
+ );
@@ -0,0 +1,68 @@
1
+ import mongoose from "mongoose";
2
+ import {createdUpdatedPlugin, findExactlyOne, findOneOrNone, isDeletedPlugin} from "../plugins";
3
+ import {syncPlugin} from "../sync/syncSeqPlugin";
4
+ import type {NotificationDocument, NotificationModel} from "../types/notification";
5
+
6
+ const notificationSchema = new mongoose.Schema<NotificationDocument, NotificationModel>(
7
+ {
8
+ _id: {
9
+ default: (): string => new mongoose.Types.ObjectId().toHexString(),
10
+ description: "The document id (string so offline sync clients can mint ids)",
11
+ type: String,
12
+ },
13
+ archivedAt: {
14
+ default: null,
15
+ description:
16
+ "When the owner archived (dismissed) this notification; null means it is still in the active inbox",
17
+ type: Date,
18
+ },
19
+ body: {
20
+ description: "Main notification message text shown in the inbox",
21
+ required: true,
22
+ trim: true,
23
+ type: String,
24
+ },
25
+ href: {
26
+ description: "Optional deep link or in-app route opened when the user taps the notification",
27
+ trim: true,
28
+ type: String,
29
+ },
30
+ kind: {
31
+ description: "Optional category string used for icons or grouping in the UI",
32
+ trim: true,
33
+ type: String,
34
+ },
35
+ ownerId: {
36
+ description: "The user who owns this inbox row",
37
+ ref: "User",
38
+ required: true,
39
+ type: mongoose.Schema.Types.ObjectId,
40
+ },
41
+ readAt: {
42
+ default: null,
43
+ description: "When the owner marked this notification as read; null means unread",
44
+ type: Date,
45
+ },
46
+ title: {
47
+ description: "Short headline shown in the inbox list",
48
+ required: true,
49
+ trim: true,
50
+ type: String,
51
+ },
52
+ },
53
+ {strict: "throw", toJSON: {virtuals: true}, toObject: {virtuals: true}}
54
+ );
55
+
56
+ // biome-ignore assist/source/useSortedKeys: ownerId must lead the compound index for owner-scoped inbox queries
57
+ notificationSchema.index({ownerId: 1, created: -1});
58
+
59
+ notificationSchema.plugin(createdUpdatedPlugin);
60
+ notificationSchema.plugin(isDeletedPlugin);
61
+ notificationSchema.plugin(findExactlyOne);
62
+ notificationSchema.plugin(findOneOrNone);
63
+ notificationSchema.plugin(syncPlugin);
64
+
65
+ export const Notification = mongoose.model<NotificationDocument, NotificationModel>(
66
+ "Notification",
67
+ notificationSchema
68
+ );