@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
@@ -6,7 +6,8 @@
6
6
  *
7
7
  * Validation is always installed as middleware but only activates after
8
8
  * `configureOpenApiValidator()` is called. This makes it safe to include
9
- * in modelRouter by default.
9
+ * in modelRouter by default. Create bodies enforce Mongoose required fields;
10
+ * PATCH/update bodies are partial (present fields only).
10
11
  *
11
12
  * @module openApiValidator
12
13
  *
@@ -38,12 +39,11 @@ import Ajv, {type ErrorObject, type ValidateFunction} from "ajv";
38
39
  import addFormats from "ajv-formats";
39
40
  import type {NextFunction, Request, Response} from "express";
40
41
  import type {Model} from "mongoose";
41
- import m2s from "mongoose-to-swagger";
42
-
42
+ import {ADMIN_LIST_CHOICE_EMPTY_VALUE} from "./adminTypes";
43
43
  import {APIError} from "./errors";
44
44
  import {logger} from "./logger";
45
45
  import type {OpenApiSchema, OpenApiSchemaProperty} from "./openApiBuilder";
46
- import {fixMixedFields} from "./populate";
46
+ import {getOpenApiSpecForModel} from "./populate";
47
47
 
48
48
  /**
49
49
  * Global configuration for OpenAPI validation.
@@ -184,9 +184,12 @@ const getAjvInstance = (): Ajv => {
184
184
  useDefaults: true,
185
185
  validateSchema: false,
186
186
  });
187
- // noExplicitAny: ajv-formats has a known type compat issue with AJV instances
188
- // biome-ignore lint/suspicious/noExplicitAny: ajv-formats has a known type compat issue with AJV instances
189
- addFormats(instance as any);
187
+ addFormats(instance as unknown as Parameters<typeof addFormats>[0]);
188
+ instance.addKeyword({
189
+ keyword: ESCAPED_REGEX_LITERAL_KEYWORD,
190
+ type: "string",
191
+ validate: (_enabled: boolean, data: string) => isEscapedRegexLiteral(data),
192
+ });
190
193
  ajvCache.set(key, instance);
191
194
  }
192
195
 
@@ -213,6 +216,44 @@ const VALID_JSON_SCHEMA_TYPES = new Set([
213
216
  "null",
214
217
  ]);
215
218
 
219
+ const REGEX_META_CHARACTERS = new Set([
220
+ "\\",
221
+ ".",
222
+ "*",
223
+ "+",
224
+ "?",
225
+ "^",
226
+ "$",
227
+ "{",
228
+ "}",
229
+ "(",
230
+ ")",
231
+ "|",
232
+ "[",
233
+ "]",
234
+ ]);
235
+
236
+ /** Accepts literal text and escaped metacharacters (e.g. `\\.`), rejects executable patterns. */
237
+ export const isEscapedRegexLiteral = (value: string): boolean => {
238
+ for (let index = 0; index < value.length; index += 1) {
239
+ const character = value[index];
240
+ if (character === "\\") {
241
+ const escapedCharacter = value[index + 1];
242
+ if (!escapedCharacter || !REGEX_META_CHARACTERS.has(escapedCharacter)) {
243
+ return false;
244
+ }
245
+ index += 1;
246
+ continue;
247
+ }
248
+ if (REGEX_META_CHARACTERS.has(character)) {
249
+ return false;
250
+ }
251
+ }
252
+ return true;
253
+ };
254
+
255
+ const ESCAPED_REGEX_LITERAL_KEYWORD = "escapedRegexLiteral";
256
+
216
257
  // mongoose-to-swagger emits non-standard type strings for some Mongoose types
217
258
  const MONGOOSE_TYPE_MAP: Record<string, {type: string; format?: string}> = {
218
259
  dateonly: {format: "date", type: "string"},
@@ -263,9 +304,61 @@ const sanitizeSchemaForAjv = (schema: Record<string, unknown>): Record<string, u
263
304
  );
264
305
  }
265
306
 
307
+ if (Array.isArray(result.oneOf)) {
308
+ result.oneOf = result.oneOf.map((entry) =>
309
+ typeof entry === "object" && entry !== null
310
+ ? sanitizeSchemaForAjv(entry as Record<string, unknown>)
311
+ : entry
312
+ );
313
+ }
314
+
315
+ if (typeof result.required === "boolean") {
316
+ delete result.required;
317
+ }
318
+
266
319
  return result;
267
320
  };
268
321
 
322
+ const stripBooleanRequiredFlag = (schema: OpenApiSchemaProperty): OpenApiSchemaProperty => {
323
+ if (schema.required === true || schema.required === false) {
324
+ const {required: _, ...rest} = schema;
325
+ const cleaned = {...rest} as OpenApiSchemaProperty;
326
+ if (cleaned.properties) {
327
+ cleaned.properties = Object.fromEntries(
328
+ Object.entries(cleaned.properties).map(([key, value]) => [
329
+ key,
330
+ stripBooleanRequiredFlag(value),
331
+ ])
332
+ );
333
+ }
334
+ if (cleaned.items) {
335
+ cleaned.items = stripBooleanRequiredFlag(cleaned.items);
336
+ }
337
+ if (cleaned.oneOf) {
338
+ cleaned.oneOf = cleaned.oneOf.map((entry) => stripBooleanRequiredFlag(entry));
339
+ }
340
+ return cleaned;
341
+ }
342
+ if (schema.properties) {
343
+ return {
344
+ ...schema,
345
+ properties: Object.fromEntries(
346
+ Object.entries(schema.properties).map(([key, value]) => [
347
+ key,
348
+ stripBooleanRequiredFlag(value),
349
+ ])
350
+ ),
351
+ };
352
+ }
353
+ if (schema.items) {
354
+ return {...schema, items: stripBooleanRequiredFlag(schema.items)};
355
+ }
356
+ if (schema.oneOf) {
357
+ return {...schema, oneOf: schema.oneOf.map((entry) => stripBooleanRequiredFlag(entry))};
358
+ }
359
+ return schema;
360
+ };
361
+
269
362
  /**
270
363
  * Get or create a compiled validator for a schema.
271
364
  * Uses the current config so changes take effect on next call.
@@ -317,20 +410,25 @@ const formatValidationErrors = (errors: ErrorObject[]): string => {
317
410
  */
318
411
  const propertiesToSchema = (
319
412
  properties: Record<string, OpenApiSchemaProperty>,
320
- requiredFields?: string[]
413
+ requiredFields?: string[],
414
+ options?: {partial?: boolean}
321
415
  ): OpenApiSchema => {
322
- // Extract required fields from properties that have required: true
323
- const autoRequired = Object.entries(properties)
324
- .filter(([_, prop]) => prop.required)
325
- .map(([key]) => key);
326
-
327
- const allRequired = [...new Set([...(requiredFields ?? []), ...autoRequired])];
328
-
329
- // Strip `required` from individual properties — AJV only accepts `required` at schema level
416
+ // Extract required fields from properties marked required: true (OpenAPI builder style).
417
+ // PATCH bodies are partial: omit mongoose/OpenAPI required so one field can be sent.
418
+ const autoRequired = options?.partial
419
+ ? []
420
+ : Object.entries(properties)
421
+ .filter(([_, prop]) => prop.required === true)
422
+ .map(([key]) => key);
423
+
424
+ const allRequired = options?.partial
425
+ ? []
426
+ : [...new Set([...(requiredFields ?? []), ...autoRequired])];
427
+
428
+ // Strip boolean `required` from individual properties — AJV only accepts `required` arrays on objects
330
429
  const cleanedProperties: Record<string, OpenApiSchemaProperty> = {};
331
430
  for (const [key, prop] of Object.entries(properties)) {
332
- const {required: _, ...rest} = prop;
333
- cleanedProperties[key] = rest as OpenApiSchemaProperty;
431
+ cleanedProperties[key] = stripBooleanRequiredFlag(prop);
334
432
  }
335
433
 
336
434
  const schema: OpenApiSchema = {
@@ -362,6 +460,12 @@ export interface RequestBodyValidatorOptions {
362
460
  */
363
461
  required?: string[];
364
462
 
463
+ /**
464
+ * When true, skip schema-level `required` (PATCH / partial update bodies).
465
+ * Present fields are still type-checked.
466
+ */
467
+ partial?: boolean;
468
+
365
469
  /**
366
470
  * Fields to exclude from validation (e.g. fields set by preCreate hooks).
367
471
  * Excluded fields are removed from both the schema properties and the required array.
@@ -394,7 +498,9 @@ export const validateRequestBody = (
394
498
  schema: Record<string, OpenApiSchemaProperty>,
395
499
  options?: RequestBodyValidatorOptions
396
500
  ): ((req: Request, res: Response, next: NextFunction) => void) => {
397
- const fullSchema = propertiesToSchema(schema, options?.required);
501
+ const fullSchema = propertiesToSchema(schema, options?.required, {
502
+ partial: options?.partial,
503
+ });
398
504
 
399
505
  return (req: Request, _res: Response, next: NextFunction): void => {
400
506
  // No-op if not configured
@@ -702,10 +808,6 @@ export const validateResponseData = (
702
808
  return {valid: true};
703
809
  };
704
810
 
705
- const m2sOptions = {
706
- props: ["readOnly", "required", "enum", "default"],
707
- };
708
-
709
811
  /**
710
812
  * Extract an OpenAPI-compatible schema from a Mongoose model.
711
813
  * This allows you to use the same schema definitions for both documentation
@@ -715,17 +817,16 @@ const m2sOptions = {
715
817
  * @returns Schema properties suitable for validation
716
818
  */
717
819
  export const getSchemaFromModel = <T>(model: Model<T>): Record<string, OpenApiSchemaProperty> => {
718
- const modelSwagger = m2s(model, m2sOptions);
719
- fixMixedFields(model.schema, modelSwagger.properties);
720
- return modelSwagger.properties as Record<string, OpenApiSchemaProperty>;
820
+ const {properties} = getOpenApiSpecForModel(model);
821
+ return properties as Record<string, OpenApiSchemaProperty>;
721
822
  };
722
823
 
723
824
  /**
724
825
  * Extract required field names from a Mongoose model's swagger schema.
725
826
  */
726
827
  const getRequiredFieldsFromModel = <T>(model: Model<T>): string[] => {
727
- const modelSwagger = m2s(model, m2sOptions);
728
- return (modelSwagger.required as string[]) ?? [];
828
+ const {required} = getOpenApiSpecForModel(model);
829
+ return required;
729
830
  };
730
831
 
731
832
  /**
@@ -741,7 +842,7 @@ export const validateModelRequestBody = <T>(
741
842
  options?: RequestBodyValidatorOptions
742
843
  ): ((req: Request, res: Response, next: NextFunction) => void) => {
743
844
  let schema = getSchemaFromModel(model);
744
- let requiredFields = getRequiredFieldsFromModel(model);
845
+ let requiredFields = options?.partial ? [] : getRequiredFieldsFromModel(model);
745
846
 
746
847
  if (options?.excludeFields?.length) {
747
848
  const excluded = new Set(options.excludeFields);
@@ -751,7 +852,7 @@ export const validateModelRequestBody = <T>(
751
852
 
752
853
  return validateRequestBody(schema, {
753
854
  ...options,
754
- required: [...(options?.required ?? []), ...requiredFields],
855
+ required: options?.partial ? [] : [...(options?.required ?? []), ...requiredFields],
755
856
  });
756
857
  };
757
858
 
@@ -826,10 +927,86 @@ export const createModelValidators = <T>(
826
927
  enabled: options?.validateUpdate,
827
928
  onAdditionalPropertiesRemoved: options?.onAdditionalPropertiesRemoved,
828
929
  onError: options?.onError,
930
+ partial: true,
829
931
  }),
830
932
  };
831
933
  };
832
934
 
935
+ const choiceEmptyInItemSchema = (baseItem: OpenApiSchemaProperty): OpenApiSchemaProperty => {
936
+ if (baseItem.enum) {
937
+ return {
938
+ oneOf: [
939
+ {enum: baseItem.enum, type: "string"},
940
+ {enum: [ADMIN_LIST_CHOICE_EMPTY_VALUE], type: "string"},
941
+ ],
942
+ };
943
+ }
944
+ return {
945
+ oneOf: [
946
+ stripBooleanRequiredFlag(baseItem),
947
+ {enum: [ADMIN_LIST_CHOICE_EMPTY_VALUE], type: "string"},
948
+ ],
949
+ };
950
+ };
951
+
952
+ const buildInOperatorSchema = (itemSchema: OpenApiSchemaProperty): OpenApiSchemaProperty => ({
953
+ additionalProperties: false,
954
+ properties: {
955
+ $in: {
956
+ items: itemSchema,
957
+ minItems: 1,
958
+ type: "array",
959
+ },
960
+ },
961
+ required: ["$in"],
962
+ type: "object",
963
+ });
964
+
965
+ const buildRegexOperatorSchema = (): OpenApiSchemaProperty => ({
966
+ additionalProperties: false,
967
+ properties: {
968
+ $options: {enum: ["i"], type: "string"},
969
+ $regex: {escapedRegexLiteral: true, type: "string"},
970
+ },
971
+ required: ["$regex", "$options"],
972
+ type: "object",
973
+ });
974
+
975
+ const buildRangeOperatorSchema = (valueSchema: OpenApiSchemaProperty): OpenApiSchemaProperty => ({
976
+ additionalProperties: false,
977
+ properties: {
978
+ $gt: valueSchema,
979
+ $gte: valueSchema,
980
+ $lt: valueSchema,
981
+ $lte: valueSchema,
982
+ },
983
+ type: "object",
984
+ });
985
+
986
+ /** Query schema for string/enum fields: scalar, `$in`, or escaped `$regex`. */
987
+ export const buildStringListQueryFieldSchema = (
988
+ fieldSchema: OpenApiSchemaProperty
989
+ ): OpenApiSchemaProperty => {
990
+ const scalar = stripBooleanRequiredFlag(fieldSchema);
991
+ const inItems = fieldSchema.enum
992
+ ? choiceEmptyInItemSchema(fieldSchema)
993
+ : stripBooleanRequiredFlag(fieldSchema);
994
+ return {
995
+ oneOf: [scalar, buildInOperatorSchema(inItems), buildRegexOperatorSchema()],
996
+ };
997
+ };
998
+
999
+ /** Query schema for number/date fields: scalar or comparison operators. */
1000
+ export const buildNumericListQueryFieldSchema = (
1001
+ fieldSchema: OpenApiSchemaProperty
1002
+ ): OpenApiSchemaProperty => {
1003
+ const scalar = stripBooleanRequiredFlag(fieldSchema);
1004
+ const valueSchema = stripBooleanRequiredFlag(fieldSchema);
1005
+ return {
1006
+ oneOf: [scalar, buildRangeOperatorSchema(valueSchema)],
1007
+ };
1008
+ };
1009
+
833
1010
  /**
834
1011
  * Build a query parameter schema from a model's Mongoose schema and queryFields array.
835
1012
  * Always includes pagination parameters (limit, page, sort).
@@ -851,13 +1028,19 @@ export const buildQuerySchemaFromFields = <T>(
851
1028
 
852
1029
  for (const field of queryFields) {
853
1030
  const modelField = modelSchema[field];
854
- if (modelField) {
855
- // Use the model's type info, but mark as not required for queries
856
- querySchema[field] = {...modelField, required: false};
857
- } else {
858
- // Field not in model schema — allow as string
859
- querySchema[field] = {type: "string"};
1031
+ if (!modelField) {
1032
+ querySchema[field] = buildStringListQueryFieldSchema({type: "string"});
1033
+ continue;
1034
+ }
1035
+ if (modelField.type === "boolean") {
1036
+ querySchema[field] = stripBooleanRequiredFlag(modelField);
1037
+ continue;
1038
+ }
1039
+ if (modelField.type === "number" || modelField.format === "date-time") {
1040
+ querySchema[field] = buildNumericListQueryFieldSchema(modelField);
1041
+ continue;
860
1042
  }
1043
+ querySchema[field] = buildStringListQueryFieldSchema(modelField);
861
1044
  }
862
1045
 
863
1046
  return querySchema;
@@ -0,0 +1,87 @@
1
+ import {describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+ import mongoose from "mongoose";
4
+
5
+ import type {User} from "../auth";
6
+ import {createAccess} from "../rbac/access";
7
+ import {createRbacRoleModel} from "../rbac/roleModel";
8
+ import {terrenoStatements} from "../rbac/statements";
9
+ import {setupDb} from "../tests";
10
+ import type {MembershipDocument} from "../types/membership";
11
+ import type {OrganizationDocument} from "../types/organization";
12
+ import {type ResolvedOrgContext, runWithOrgContext} from "./orgContext";
13
+
14
+ const createTestUser = (
15
+ overrides: Partial<User & {roles: string[]}> = {}
16
+ ): User & {roles: string[]} => {
17
+ const id = new mongoose.Types.ObjectId();
18
+ return {
19
+ _id: id as unknown as User["_id"],
20
+ admin: false,
21
+ id: id.toString(),
22
+ roles: [],
23
+ ...overrides,
24
+ };
25
+ };
26
+
27
+ const orgAdminContext = (): ResolvedOrgContext => ({
28
+ membership: {roleName: "org-admin", status: "active"} as MembershipDocument,
29
+ organization: {_id: new mongoose.Types.ObjectId()} as OrganizationDocument,
30
+ });
31
+
32
+ describe("optional organizations", () => {
33
+ it("does not seed operator or grant membership org-admin without organizations: true", async () => {
34
+ await setupDb();
35
+ const access = createAccess({
36
+ connection: mongoose.connection,
37
+ statements: terrenoStatements,
38
+ });
39
+ await access.roles.seedDefaults();
40
+
41
+ const RbacRole = createRbacRoleModel(mongoose.connection);
42
+ assert.isNull(await RbacRole.findOne({name: "operator"}));
43
+
44
+ const operatorList = await access.can({
45
+ permissions: {organization: ["list"]},
46
+ user: createTestUser({roles: ["operator"]}),
47
+ });
48
+ assert.isFalse(operatorList.allowed);
49
+
50
+ const orgAdminUpdate = await runWithOrgContext(orgAdminContext(), () =>
51
+ access.can({
52
+ permissions: {organization: ["update"]},
53
+ user: createTestUser(),
54
+ })
55
+ );
56
+ assert.isFalse(orgAdminUpdate.allowed);
57
+ });
58
+
59
+ it("seeds operator and grants membership org-admin when organizations is true", async () => {
60
+ await setupDb();
61
+ const access = createAccess({
62
+ connection: mongoose.connection,
63
+ organizations: true,
64
+ statements: terrenoStatements,
65
+ });
66
+ await access.roles.seedDefaults();
67
+
68
+ const RbacRole = createRbacRoleModel(mongoose.connection);
69
+ const operator = await RbacRole.findExactlyOne({name: "operator"});
70
+ assert.isTrue(operator.isLocked);
71
+ assert.deepEqual(operator.permissions.organization, [...terrenoStatements.organization]);
72
+
73
+ const operatorList = await access.can({
74
+ permissions: {organization: ["list"]},
75
+ user: createTestUser({roles: ["operator"]}),
76
+ });
77
+ assert.isTrue(operatorList.allowed);
78
+
79
+ const orgAdminUpdate = await runWithOrgContext(orgAdminContext(), () =>
80
+ access.can({
81
+ permissions: {organization: ["update"]},
82
+ user: createTestUser(),
83
+ })
84
+ );
85
+ assert.isTrue(orgAdminUpdate.allowed);
86
+ });
87
+ });