@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,283 @@
1
+ import type express from "express";
2
+ import mongoose from "mongoose";
3
+
4
+ import type {ModelRouterOptions} from "../api";
5
+ import type {User} from "../auth";
6
+ import {APIError} from "../errors";
7
+ import {checkPermissions, type PermissionMethod} from "../permissions";
8
+ import {findOneOrNoneFor} from "../plugins";
9
+ import type {AnyTerrenoAccess} from "../rbac/types";
10
+ import {canUseAdminBroadcastWindow} from "./adminWindowAccess";
11
+ import type {SyncRegistryEntry} from "./registry";
12
+ import type {SyncAppOptions} from "./routes";
13
+ import type {SyncMutateRequest, SyncMutationOperation} from "./types";
14
+
15
+ export interface AdminWindowMutationAuditEvent {
16
+ actorId?: string;
17
+ /** Serialized document after the successful mutation. */
18
+ doc?: Record<string, unknown>;
19
+ modelName: string;
20
+ recordId?: string;
21
+ recordLabel?: string;
22
+ verb: "created" | "deleted" | "updated";
23
+ }
24
+
25
+ export interface AdminWindowMutationScopeHooks {
26
+ preCreate?: ModelRouterOptions<unknown>["preCreate"];
27
+ preUpdate?: ModelRouterOptions<unknown>["preUpdate"];
28
+ preDelete?: ModelRouterOptions<unknown>["preDelete"];
29
+ postCreate?: ModelRouterOptions<unknown>["postCreate"];
30
+ postUpdate?: ModelRouterOptions<unknown>["postUpdate"];
31
+ postDelete?: ModelRouterOptions<unknown>["postDelete"];
32
+ }
33
+
34
+ export interface AdminWindowMutationScope extends AdminWindowMutationScopeHooks {
35
+ /** RBAC access used by AdminApp User admin-flag and role assignment hooks. */
36
+ accessControl?: AnyTerrenoAccess;
37
+ modelName: string;
38
+ permissions: {create: boolean; update: boolean; delete: boolean};
39
+ createPermissions: PermissionMethod<unknown>[];
40
+ updatePermissions: PermissionMethod<unknown>[];
41
+ deletePermissions: PermissionMethod<unknown>[];
42
+ stripMutationData: (data: Record<string, unknown>) => Record<string, unknown>;
43
+ /** Legacy standalone audit callback; prefer `postCreate` / `postUpdate` / `postDelete`. */
44
+ emitAudit?: (args: {
45
+ event: AdminWindowMutationAuditEvent;
46
+ req: express.Request;
47
+ }) => void | Promise<void>;
48
+ }
49
+
50
+ /** Coalesce `req.user.id` and `req.user._id` to match Admin REST audit actor ids. */
51
+ export const auditActorIdFromRequest = (req: express.Request): string | undefined => {
52
+ const actor = req.user as {id?: unknown; _id?: unknown} | undefined;
53
+ if (!actor) {
54
+ return undefined;
55
+ }
56
+ if (actor.id != null) {
57
+ return String(actor.id);
58
+ }
59
+ if (actor._id != null) {
60
+ return String(actor._id);
61
+ }
62
+ return undefined;
63
+ };
64
+
65
+ /**
66
+ * Admin-window sync mutations use AdminApp router pre/post hooks, not product `modelRouter`
67
+ * hooks. Product hooks can overwrite stripped or admin-authorized fields (for example by
68
+ * forcing `ownerId` in `preCreate`).
69
+ */
70
+ export const buildAdminWindowExecutorOptions = <T>({
71
+ productOptions,
72
+ scope,
73
+ }: {
74
+ productOptions: ModelRouterOptions<T>;
75
+ scope: AdminWindowMutationScope;
76
+ }): ModelRouterOptions<T> => ({
77
+ ...productOptions,
78
+ accessControl: scope.accessControl ?? productOptions.accessControl,
79
+ postCreate: scope.postCreate as ModelRouterOptions<T>["postCreate"],
80
+ postDelete: scope.postDelete as ModelRouterOptions<T>["postDelete"],
81
+ postUpdate: scope.postUpdate as ModelRouterOptions<T>["postUpdate"],
82
+ preCreate: scope.preCreate as ModelRouterOptions<T>["preCreate"],
83
+ preDelete: scope.preDelete as ModelRouterOptions<T>["preDelete"],
84
+ preUpdate: scope.preUpdate as ModelRouterOptions<T>["preUpdate"],
85
+ });
86
+
87
+ /** Ensure `req.params.id` is set for AdminApp update/delete hooks (User admin-flag gates). */
88
+ export const withAdminWindowMutationRequestContext = ({
89
+ mutation,
90
+ req,
91
+ }: {
92
+ mutation: SyncMutateRequest;
93
+ req: express.Request;
94
+ }): express.Request => {
95
+ if (mutation.operation === "create" || mutation.id == null) {
96
+ return req;
97
+ }
98
+ const params = {...(req.params ?? {}), id: mutation.id};
99
+ return Object.assign(req, {params}) as express.Request;
100
+ };
101
+
102
+ const adminWindowMutationScopes = new Map<string, AdminWindowMutationScope>();
103
+
104
+ export const registerAdminWindowMutationScope = (
105
+ modelName: string,
106
+ scope: AdminWindowMutationScope
107
+ ): void => {
108
+ adminWindowMutationScopes.set(modelName, scope);
109
+ };
110
+
111
+ export const getAdminWindowMutationScope = (
112
+ modelName: string
113
+ ): AdminWindowMutationScope | undefined => adminWindowMutationScopes.get(modelName);
114
+
115
+ export const clearAdminWindowMutationScopes = (): void => {
116
+ adminWindowMutationScopes.clear();
117
+ };
118
+
119
+ const operationEnabled = (
120
+ scope: AdminWindowMutationScope,
121
+ operation: SyncMutationOperation
122
+ ): boolean => {
123
+ if (operation === "create") {
124
+ return scope.permissions.create;
125
+ }
126
+ if (operation === "update") {
127
+ return scope.permissions.update;
128
+ }
129
+ return scope.permissions.delete;
130
+ };
131
+
132
+ const permissionsForOperation = (
133
+ scope: AdminWindowMutationScope,
134
+ operation: SyncMutationOperation
135
+ ): PermissionMethod<unknown>[] => {
136
+ if (operation === "create") {
137
+ return scope.createPermissions;
138
+ }
139
+ if (operation === "update") {
140
+ return scope.updatePermissions;
141
+ }
142
+ return scope.deletePermissions;
143
+ };
144
+
145
+ const loadInstance = async ({
146
+ entry,
147
+ id,
148
+ }: {
149
+ entry: SyncRegistryEntry;
150
+ id: string;
151
+ }): Promise<unknown> => {
152
+ const model = mongoose.model(entry.modelName);
153
+ return findOneOrNoneFor(model, {_id: id, deleted: {$in: [true, false]}});
154
+ };
155
+
156
+ /**
157
+ * Validates an explicit `mutationMode: "adminWindow"` marker and applies AdminApp write
158
+ * semantics before the product sync executor runs. Returns the mutation with stripped
159
+ * data, or `undefined` when the request stays on the product path.
160
+ *
161
+ * The marker alone is never trusted: callers must also have admin-window access, the
162
+ * collection must be `adminBroadcast`, and AdminApp must have registered a write scope.
163
+ */
164
+ export const prepareAdminWindowMutation = async ({
165
+ entry,
166
+ mutation,
167
+ req: _req,
168
+ syncOptions,
169
+ user,
170
+ }: {
171
+ entry: SyncRegistryEntry;
172
+ mutation: SyncMutateRequest;
173
+ req: express.Request;
174
+ syncOptions?: SyncAppOptions;
175
+ user: User;
176
+ }): Promise<{mutation: SyncMutateRequest; scope: AdminWindowMutationScope} | undefined> => {
177
+ if (mutation.mutationMode !== "adminWindow") {
178
+ return undefined;
179
+ }
180
+ if (!entry.config.adminBroadcast) {
181
+ throw new APIError({
182
+ status: 403,
183
+ title: "Admin window mutations require an adminBroadcast collection",
184
+ });
185
+ }
186
+ if (
187
+ !(await canUseAdminBroadcastWindow({
188
+ accessControl: syncOptions?.accessControl,
189
+ canOpenAdminWindow: syncOptions?.canOpenAdminWindow,
190
+ user,
191
+ }))
192
+ ) {
193
+ throw new APIError({status: 403, title: "Admin window access required"});
194
+ }
195
+ const scope = getAdminWindowMutationScope(entry.modelName);
196
+ if (!scope) {
197
+ throw new APIError({
198
+ status: 403,
199
+ title: "Admin window mutations are not registered for this collection",
200
+ });
201
+ }
202
+ if (!operationEnabled(scope, mutation.operation)) {
203
+ throw new APIError({
204
+ status: 403,
205
+ title: `${mutation.operation} is disabled for this admin model`,
206
+ });
207
+ }
208
+
209
+ let instance: unknown;
210
+ if (mutation.operation !== "create") {
211
+ if (!mutation.id) {
212
+ throw new APIError({
213
+ status: 400,
214
+ title: `id is required for ${mutation.operation} mutations`,
215
+ });
216
+ }
217
+ instance = await loadInstance({entry, id: mutation.id});
218
+ if (!instance && mutation.operation === "update") {
219
+ throw new APIError({status: 404, title: "Not found"});
220
+ }
221
+ }
222
+
223
+ const permissionMethod =
224
+ mutation.operation === "create"
225
+ ? "create"
226
+ : mutation.operation === "update"
227
+ ? "update"
228
+ : "delete";
229
+ const permissionInstance =
230
+ mutation.operation === "create" ? (mutation.data as unknown) : instance;
231
+ if (
232
+ !(await checkPermissions(
233
+ permissionMethod,
234
+ permissionsForOperation(scope, mutation.operation),
235
+ user,
236
+ permissionInstance
237
+ ))
238
+ ) {
239
+ throw new APIError({status: 403, title: "Admin write access denied"});
240
+ }
241
+
242
+ if (mutation.operation === "delete" || !mutation.data) {
243
+ return {mutation, scope};
244
+ }
245
+ return {
246
+ mutation: {...mutation, data: scope.stripMutationData(mutation.data)},
247
+ scope,
248
+ };
249
+ };
250
+
251
+ export const emitAdminWindowMutationAudit = async ({
252
+ doc,
253
+ mutation,
254
+ req,
255
+ scope,
256
+ }: {
257
+ doc: mongoose.Document;
258
+ mutation: SyncMutateRequest;
259
+ req: express.Request;
260
+ scope: AdminWindowMutationScope;
261
+ }): Promise<void> => {
262
+ if (!scope.emitAudit) {
263
+ return;
264
+ }
265
+ const plain = doc.toObject() as Record<string, unknown>;
266
+ const recordId = plain._id != null ? String(plain._id) : mutation.id;
267
+ const verb =
268
+ mutation.operation === "create"
269
+ ? "created"
270
+ : mutation.operation === "delete"
271
+ ? "deleted"
272
+ : "updated";
273
+ await scope.emitAudit({
274
+ event: {
275
+ actorId: auditActorIdFromRequest(req),
276
+ doc: plain,
277
+ modelName: scope.modelName,
278
+ recordId,
279
+ verb,
280
+ },
281
+ req,
282
+ });
283
+ };
@@ -0,0 +1,16 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import {DateTime} from "luxon";
3
+
4
+ import {docMatchesMutationData} from "./mutationHandler";
5
+
6
+ describe("docMatchesMutationData date compare", () => {
7
+ it("treats date-only ISO strings as UTC midnight like Date parsing", () => {
8
+ const stored = DateTime.fromISO("2024-01-15T00:00:00.000Z", {zone: "utc"}).toJSDate();
9
+ expect(docMatchesMutationData({due: stored}, {due: "2024-01-15"})).toBe(true);
10
+ });
11
+
12
+ it("returns false for invalid date strings instead of throwing", () => {
13
+ const stored = DateTime.fromISO("2024-01-15T00:00:00.000Z", {zone: "utc"}).toJSDate();
14
+ expect(docMatchesMutationData({due: stored}, {due: "not-a-date"})).toBe(false);
15
+ });
16
+ });
@@ -1,9 +1,9 @@
1
- // noExplicitAny: test model typing
2
- // biome-ignore-all lint/suspicious/noExplicitAny: test model typing
3
1
  import {beforeEach, describe, expect, it} from "bun:test";
2
+ import {assert} from "chai";
4
3
  import express from "express";
5
4
  import {model, Schema} from "mongoose";
6
5
  import type {ModelRouterOptions} from "../api";
6
+ import {APIError} from "../errors";
7
7
  import {Permissions} from "../permissions";
8
8
  import {createdUpdatedPlugin, type IsDeleted, isDeletedPlugin} from "../plugins";
9
9
  import {setupDb} from "../tests";
@@ -21,7 +21,8 @@ import {syncPlugin} from "./syncSeqPlugin";
21
21
  * (`SyncCounter.stream` / `SyncMutation.mutationId` uniques, the scope-move lookups,
22
22
  * `SyncKey.userId`), so they exist after startup without any manual `ensureIndexes()`
23
23
  * call — without the unique indexes, duplicate mutation deliveries double-apply and the
24
- * counter upsert race mints duplicate seqs.
24
+ * counter upsert race mints duplicate seqs. Index work must remain deferred until this
25
+ * function runs because model registration can happen before MongoDB connects.
25
26
  */
26
27
 
27
28
  interface IndexTodo extends IsDeleted {
@@ -50,7 +51,7 @@ const authedOptions = {
50
51
  read: [Permissions.IsAuthenticated],
51
52
  update: [Permissions.IsAuthenticated],
52
53
  },
53
- } as unknown as ModelRouterOptions<any>;
54
+ } as unknown as ModelRouterOptions<IndexTodo>;
54
55
 
55
56
  describe("ensureSyncIndexes (C8)", () => {
56
57
  beforeEach(() => {
@@ -65,28 +66,58 @@ describe("ensureSyncIndexes (C8)", () => {
65
66
  const IndexTodoModel = buildModel("EnsureIndexTodoOk");
66
67
  registerSync({
67
68
  config: {scope: {type: "owner"}},
68
- model: IndexTodoModel as any,
69
+ model: IndexTodoModel,
69
70
  options: authedOptions,
70
71
  routePath: "/ensureIndexTodosOk",
71
72
  });
72
73
  await expect(ensureSyncIndexes()).resolves.toBeUndefined();
73
74
  });
74
75
 
76
+ it("defers snapshot index creation until startup ensures indexes", async () => {
77
+ const IndexTodoModel = buildModel("EnsureIndexTodoDeferred");
78
+ let createIndexCalls = 0;
79
+ IndexTodoModel.collection.createIndex = async (): Promise<string> => {
80
+ createIndexCalls += 1;
81
+ return "ownerId_1__syncSeq_1";
82
+ };
83
+
84
+ registerSync({
85
+ config: {scope: {type: "owner"}},
86
+ model: IndexTodoModel,
87
+ options: authedOptions,
88
+ routePath: "/ensureIndexTodosDeferred",
89
+ });
90
+
91
+ assert.strictEqual(createIndexCalls, 0);
92
+ await ensureSyncIndexes();
93
+ assert.strictEqual(createIndexCalls, 1);
94
+ });
95
+
75
96
  it("rejects with an actionable error when createIndex fails, so startup fails loudly", async () => {
76
97
  const IndexTodoModel = buildModel("EnsureIndexTodoFail");
98
+ const sentinel = new Error("boom-sentinel-snapshot-index");
77
99
  // Force the collection's createIndex to reject, simulating a DB/schema failure.
78
- (IndexTodoModel.collection as any).createIndex = async () => {
79
- throw new Error("boom: index build failed");
100
+ IndexTodoModel.collection.createIndex = async (): Promise<string> => {
101
+ throw sentinel;
80
102
  };
81
103
  registerSync({
82
104
  config: {scope: {type: "owner"}},
83
- model: IndexTodoModel as any,
105
+ model: IndexTodoModel,
84
106
  options: authedOptions,
85
107
  routePath: "/ensureIndexTodosFail",
86
108
  });
87
- await expect(ensureSyncIndexes()).rejects.toThrow(
109
+ const rejection = ensureSyncIndexes();
110
+ await expect(rejection).rejects.toThrow(
88
111
  /Failed to create sync snapshot index for EnsureIndexTodoFail/
89
112
  );
113
+ const error = await rejection.catch((caught: unknown) => caught);
114
+ expect(error).toBeInstanceOf(APIError);
115
+ const apiError = error as APIError;
116
+ expect(apiError.code).toBe("sync-snapshot-index-failed");
117
+ expect(apiError.cause).toBe(sentinel);
118
+ expect(apiError.status).toBe(500);
119
+ expect(apiError.message).not.toContain(sentinel.message);
120
+ expect(apiError.detail).toContain(sentinel.message);
90
121
  });
91
122
  });
92
123
 
@@ -129,16 +160,24 @@ describe("sync bookkeeping indexes at startup (Task 9.9)", () => {
129
160
 
130
161
  it("rejects with an actionable error when a bookkeeping index build fails", async () => {
131
162
  const originalEnsure = SyncMutation.ensureIndexes.bind(SyncMutation);
132
- (SyncMutation as any).ensureIndexes = async () => {
133
- throw new Error("boom: mutationId index build failed");
163
+ const sentinel = new Error("boom-sentinel-mutation-index");
164
+ SyncMutation.ensureIndexes = async (): Promise<void> => {
165
+ throw sentinel;
134
166
  };
135
167
  try {
136
168
  new SyncApp().register(express());
137
- await expect(ensureSyncIndexes()).rejects.toThrow(
138
- /Failed to ensure sync indexes for SyncMutation/
139
- );
169
+ const rejection = ensureSyncIndexes();
170
+ await expect(rejection).rejects.toThrow(/Failed to ensure sync indexes for SyncMutation/);
171
+ const error = await rejection.catch((caught: unknown) => caught);
172
+ expect(error).toBeInstanceOf(APIError);
173
+ const apiError = error as APIError;
174
+ expect(apiError.code).toBe("sync-indexes-failed");
175
+ expect(apiError.cause).toBe(sentinel);
176
+ expect(apiError.status).toBe(500);
177
+ expect(apiError.message).not.toContain(sentinel.message);
178
+ expect(apiError.detail).toContain(sentinel.message);
140
179
  } finally {
141
- (SyncMutation as any).ensureIndexes = originalEnsure;
180
+ SyncMutation.ensureIndexes = originalEnsure;
142
181
  }
143
182
  });
144
183
  });
@@ -59,6 +59,17 @@ const execHardSchema = new Schema<ExecHardStuff>({
59
59
  });
60
60
  const ExecHardModel = model<ExecHardStuff>("ExecHardStuff", execHardSchema);
61
61
 
62
+ interface ExecUserish {
63
+ email: string;
64
+ roles?: string[];
65
+ }
66
+
67
+ const execUserishSchema = new Schema<ExecUserish>({
68
+ email: {description: "Login email", required: true, type: String},
69
+ roles: {description: "Authority-bearing roles stripped after hooks", type: [String]},
70
+ });
71
+ const ExecUserishModel = model<ExecUserish>("ExecUserish", execUserishSchema);
72
+
62
73
  const owner = {_id: "u-owner", admin: false, id: "u-owner"} as unknown as User;
63
74
  const stranger = {_id: "u-stranger", admin: false, id: "u-stranger"} as unknown as User;
64
75
 
@@ -133,6 +144,35 @@ describe("executeCreate", () => {
133
144
  expect(error.title).toContain("Access to CREATE on ExecStuff");
134
145
  });
135
146
 
147
+ it("strips User roles after preCreate when writeModelName is User", async () => {
148
+ await ExecUserishModel.deleteMany({});
149
+ let seenRoles: unknown;
150
+ const {doc} = await executeCreate<ExecUserish>({
151
+ body: {email: "exec-roles@example.com", roles: ["superadmin"]},
152
+ model: ExecUserishModel,
153
+ options: {
154
+ accessControl: {} as never,
155
+ permissions: {
156
+ create: [Permissions.IsAuthenticated],
157
+ delete: [],
158
+ list: [],
159
+ read: [],
160
+ update: [],
161
+ },
162
+ preCreate: (body) => {
163
+ seenRoles = (body as ExecUserish).roles;
164
+ return body;
165
+ },
166
+ } as ModelRouterOptions<ExecUserish>,
167
+ user: owner,
168
+ writeModelName: "User",
169
+ });
170
+ assert.deepEqual(seenRoles, ["superadmin"]);
171
+ assert.deepEqual(doc.roles ?? [], []);
172
+ const stored = await ExecUserishModel.findById(doc._id).lean();
173
+ assert.deepEqual(stored?.roles ?? [], []);
174
+ });
175
+
136
176
  it("passes a {user} stub request to preCreate when no req is provided", async () => {
137
177
  const options = baseOptions({
138
178
  preCreate: (body, request) => ({
@@ -184,7 +184,9 @@ export const executeCreate = async <T>({
184
184
  user,
185
185
  body,
186
186
  req,
187
+ skipPermissionChecks,
187
188
  skipPostHooks,
189
+ writeModelName,
188
190
  }: {
189
191
  model: Model<T>;
190
192
  options: ModelRouterOptions<T>;
@@ -192,6 +194,11 @@ export const executeCreate = async <T>({
192
194
  body: unknown;
193
195
  /** The real Express request when called over HTTP; hooks receive a `{user}` stub otherwise. */
194
196
  req?: express.Request;
197
+ /**
198
+ * Name used for User-role stripping after hooks. Defaults to `model.modelName`.
199
+ * MCP passes the registry `modelName` because compiled mongoose names can differ.
200
+ */
201
+ writeModelName?: string;
195
202
  /**
196
203
  * C5 (FIX 6): when true, skip the built-in `postCreate` call — the caller
197
204
  * (the sync mutation handler) runs it manually AFTER finalizing the
@@ -199,10 +206,15 @@ export const executeCreate = async <T>({
199
206
  * committed write look like a failure. REST handlers never set this.
200
207
  */
201
208
  skipPostHooks?: boolean;
209
+ /** When true, skip modelRouter permission checks (admin-window sync mutations). */
210
+ skipPermissionChecks?: boolean;
202
211
  }): Promise<ExecutorResult<T>> => {
203
212
  const request = req ?? stubRequest(user);
204
213
 
205
- if (!(await checkPermissions("create", options.permissions.create, user))) {
214
+ if (
215
+ !skipPermissionChecks &&
216
+ !(await checkPermissions("create", options.permissions.create, user))
217
+ ) {
206
218
  throw new APIError({
207
219
  status: 405,
208
220
  title: `Access to CREATE on ${model.modelName} denied for ${user?.id}`,
@@ -245,7 +257,7 @@ export const executeCreate = async <T>({
245
257
  }
246
258
  }
247
259
  cleanedBody = omitUserRolesFromWriteBody(
248
- model.modelName,
260
+ writeModelName ?? model.modelName,
249
261
  options.accessControl,
250
262
  cleanedBody,
251
263
  (request as express.Request & {terrenoAllowUserAdminWrite?: boolean})
@@ -277,11 +289,11 @@ export const executeCreate = async <T>({
277
289
 
278
290
  if (options.populatePaths) {
279
291
  try {
280
- // noExplicitAny: mongoose Query type varies based on populatePaths
281
- // biome-ignore lint/suspicious/noExplicitAny: mongoose Query type varies based on populatePaths
282
- let populateQuery: any = model.findById(data._id);
283
- populateQuery = addPopulateToQuery(populateQuery, options.populatePaths);
284
- data = await populateQuery.exec();
292
+ const populateQuery = addPopulateToQuery(
293
+ model.findById(data._id) as unknown as Parameters<typeof addPopulateToQuery>[0],
294
+ options.populatePaths
295
+ );
296
+ data = (await populateQuery.exec()) as unknown as ExecutorDoc<T>;
285
297
  } catch (error: unknown) {
286
298
  throw passthroughOrWrap(error, {
287
299
  code: "populate-error",
@@ -342,7 +354,9 @@ export const executeUpdate = async <T>({
342
354
  concurrencyCheck,
343
355
  existingDoc,
344
356
  req,
357
+ skipPermissionChecks,
345
358
  skipPostHooks,
359
+ writeModelName,
346
360
  }: {
347
361
  model: Model<T>;
348
362
  options: ModelRouterOptions<T>;
@@ -359,10 +373,20 @@ export const executeUpdate = async <T>({
359
373
  req?: express.Request;
360
374
  /** C5 (FIX 6): see `executeCreate`'s `skipPostHooks` doc comment. */
361
375
  skipPostHooks?: boolean;
376
+ /**
377
+ * Name used for User-role stripping after hooks. Defaults to `model.modelName`.
378
+ * MCP passes the registry `modelName` because compiled mongoose names can differ.
379
+ */
380
+ writeModelName?: string;
381
+ /** When true, skip modelRouter permission checks (admin-window sync mutations). */
382
+ skipPermissionChecks?: boolean;
362
383
  }): Promise<ExecutorResult<T>> => {
363
384
  const request = req ?? stubRequest(user);
364
385
 
365
- if (!(await checkPermissions("update", options.permissions.update, user))) {
386
+ if (
387
+ !skipPermissionChecks &&
388
+ !(await checkPermissions("update", options.permissions.update, user))
389
+ ) {
366
390
  throw new APIError({
367
391
  status: 405,
368
392
  title: `Access to UPDATE on ${model.modelName} denied for ${user?.id}`,
@@ -372,7 +396,10 @@ export const executeUpdate = async <T>({
372
396
  let doc =
373
397
  existingDoc ?? ((await loadDocOr404<T>(model, id, options.populatePaths)) as ExecutorDoc<T>);
374
398
 
375
- if (!(await checkPermissions("update", options.permissions.update, user, doc))) {
399
+ if (
400
+ !skipPermissionChecks &&
401
+ !(await checkPermissions("update", options.permissions.update, user, doc))
402
+ ) {
376
403
  throw new APIError({
377
404
  status: 403,
378
405
  title: `Access to GET on ${model.modelName}:${id} denied for ${user?.id}`,
@@ -428,7 +455,7 @@ export const executeUpdate = async <T>({
428
455
  }
429
456
 
430
457
  cleanedBody = omitUserRolesFromWriteBody(
431
- model.modelName,
458
+ writeModelName ?? model.modelName,
432
459
  options.accessControl,
433
460
  cleanedBody,
434
461
  (request as express.Request & {terrenoAllowUserAdminWrite?: boolean})
@@ -536,11 +563,11 @@ export const executeUpdate = async <T>({
536
563
  }
537
564
 
538
565
  if (options.populatePaths) {
539
- // noExplicitAny: mongoose Query type varies based on populatePaths
540
- // biome-ignore lint/suspicious/noExplicitAny: mongoose Query type varies based on populatePaths
541
- let populateQuery: any = model.findById(doc._id);
542
- populateQuery = addPopulateToQuery(populateQuery, options.populatePaths);
543
- doc = await populateQuery.exec();
566
+ const populateQuery = addPopulateToQuery(
567
+ model.findById(doc._id) as unknown as Parameters<typeof addPopulateToQuery>[0],
568
+ options.populatePaths
569
+ );
570
+ doc = (await populateQuery.exec()) as unknown as ExecutorDoc<T>;
544
571
  }
545
572
 
546
573
  if (options.postUpdate && !skipPostHooks) {
@@ -591,6 +618,7 @@ export const executeDelete = async <T>({
591
618
  id,
592
619
  existingDoc,
593
620
  req,
621
+ skipPermissionChecks,
594
622
  skipPostHooks,
595
623
  }: {
596
624
  model: Model<T>;
@@ -606,10 +634,15 @@ export const executeDelete = async <T>({
606
634
  req?: express.Request;
607
635
  /** C5 (FIX 6): see `executeCreate`'s `skipPostHooks` doc comment. */
608
636
  skipPostHooks?: boolean;
637
+ /** When true, skip modelRouter permission checks (admin-window sync mutations). */
638
+ skipPermissionChecks?: boolean;
609
639
  }): Promise<ExecutorResult<T>> => {
610
640
  const request = req ?? stubRequest(user);
611
641
 
612
- if (!(await checkPermissions("delete", options.permissions.delete, user))) {
642
+ if (
643
+ !skipPermissionChecks &&
644
+ !(await checkPermissions("delete", options.permissions.delete, user))
645
+ ) {
613
646
  throw new APIError({
614
647
  status: 405,
615
648
  title: `Access to DELETE on ${model.modelName} denied for ${user?.id}`,
@@ -637,7 +670,10 @@ export const executeDelete = async <T>({
637
670
  if (!resolved) {
638
671
  throw error;
639
672
  }
640
- if (!(await checkPermissions("delete", options.permissions.delete, user, resolved))) {
673
+ if (
674
+ !skipPermissionChecks &&
675
+ !(await checkPermissions("delete", options.permissions.delete, user, resolved))
676
+ ) {
641
677
  throw new APIError({
642
678
  status: 403,
643
679
  title: `Access to GET on ${model.modelName}:${id} denied for ${user?.id}`,
@@ -649,7 +685,10 @@ export const executeDelete = async <T>({
649
685
  }
650
686
  }
651
687
 
652
- if (!(await checkPermissions("delete", options.permissions.delete, user, doc))) {
688
+ if (
689
+ !skipPermissionChecks &&
690
+ !(await checkPermissions("delete", options.permissions.delete, user, doc))
691
+ ) {
653
692
  throw new APIError({
654
693
  status: 403,
655
694
  title: `Access to GET on ${model.modelName}:${id} denied for ${user?.id}`,