@terreno/api 57.2.0 → 57.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (472) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +23 -7
  3. package/dist/actions.js +19 -7
  4. package/dist/adminTypes.d.ts +7 -0
  5. package/dist/adminTypes.js +6 -1
  6. package/dist/api.d.ts +14 -0
  7. package/dist/api.js +111 -60
  8. package/dist/audit/auditApp.d.ts +30 -0
  9. package/dist/audit/auditApp.js +155 -0
  10. package/dist/audit/auditEventModel.d.ts +29 -0
  11. package/dist/audit/auditEventModel.js +102 -0
  12. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  13. package/dist/audit/cloudTasksEnqueue.js +162 -0
  14. package/dist/audit/diff.d.ts +10 -0
  15. package/dist/audit/diff.js +230 -0
  16. package/dist/audit/processQueue.d.ts +6 -0
  17. package/dist/audit/processQueue.js +101 -0
  18. package/dist/audit/rbacSink.d.ts +2 -0
  19. package/dist/audit/rbacSink.js +82 -0
  20. package/dist/audit/record.d.ts +56 -0
  21. package/dist/audit/record.js +373 -0
  22. package/dist/auth.d.ts +23 -10
  23. package/dist/auth.js +97 -32
  24. package/dist/authRecovery.d.ts +5 -0
  25. package/dist/authRecovery.js +350 -0
  26. package/dist/authTokens.d.ts +8 -0
  27. package/dist/authTokens.js +162 -0
  28. package/dist/betterAuth.d.ts +39 -0
  29. package/dist/betterAuthApp.d.ts +4 -0
  30. package/dist/betterAuthApp.js +26 -8
  31. package/dist/betterAuthSetup.d.ts +44 -2
  32. package/dist/betterAuthSetup.js +288 -18
  33. package/dist/collectionRegistry.d.ts +40 -0
  34. package/dist/collectionRegistry.js +97 -0
  35. package/dist/configurationApp.d.ts +11 -2
  36. package/dist/configurationApp.js +2 -4
  37. package/dist/docLoader.js +35 -6
  38. package/dist/expressServer.d.ts +26 -3
  39. package/dist/expressServer.js +79 -11
  40. package/dist/index.d.ts +42 -1
  41. package/dist/index.js +84 -2
  42. package/dist/mcp/auth.d.ts +1 -0
  43. package/dist/mcp/auth.js +47 -25
  44. package/dist/mcp/handlers.d.ts +1 -1
  45. package/dist/mcp/handlers.js +67 -233
  46. package/dist/mcp/query.d.ts +2 -15
  47. package/dist/mcp/query.js +8 -8
  48. package/dist/mcp/registry.d.ts +1 -5
  49. package/dist/mcp/registry.js +31 -20
  50. package/dist/mcp/schemaGenerator.d.ts +2 -7
  51. package/dist/mcp/schemaGenerator.js +41 -116
  52. package/dist/mcp/server.d.ts +1 -0
  53. package/dist/mcp/server.js +1 -0
  54. package/dist/mcp/serviceTokens.d.ts +16 -0
  55. package/dist/mcp/serviceTokens.js +345 -0
  56. package/dist/mcp/types.d.ts +2 -2
  57. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  58. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  59. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  60. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  61. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  62. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  63. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  64. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  65. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  66. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  67. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  68. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  69. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  70. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  71. package/dist/migrations/generate.d.ts +17 -0
  72. package/dist/migrations/generate.js +277 -0
  73. package/dist/migrations/load.d.ts +20 -0
  74. package/dist/migrations/load.js +236 -0
  75. package/dist/migrations/lock.d.ts +13 -0
  76. package/dist/migrations/lock.js +145 -0
  77. package/dist/migrations/runner.d.ts +42 -0
  78. package/dist/migrations/runner.js +503 -0
  79. package/dist/migrations/schemaCatalog.d.ts +44 -0
  80. package/dist/migrations/schemaCatalog.js +326 -0
  81. package/dist/migrations/types.d.ts +87 -0
  82. package/dist/migrations/types.js +7 -0
  83. package/dist/models/mcpServiceToken.d.ts +3 -0
  84. package/dist/models/mcpServiceToken.js +208 -0
  85. package/dist/models/notification.d.ts +2 -0
  86. package/dist/models/notification.js +62 -0
  87. package/dist/models/notificationPreference.d.ts +2 -0
  88. package/dist/models/notificationPreference.js +49 -0
  89. package/dist/notifications/notificationService.d.ts +40 -0
  90. package/dist/notifications/notificationService.js +323 -0
  91. package/dist/notifications/notificationsApp.d.ts +18 -0
  92. package/dist/notifications/notificationsApp.js +250 -0
  93. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  94. package/dist/notifications/notificationsBeforeSend.js +77 -0
  95. package/dist/openApi.d.ts +1 -7
  96. package/dist/openApi.js +7 -6
  97. package/dist/openApiBuilder.d.ts +19 -7
  98. package/dist/openApiBuilder.js +61 -8
  99. package/dist/openApiCompat.js +1 -1
  100. package/dist/openApiValidator.d.ts +13 -1
  101. package/dist/openApiValidator.js +200 -38
  102. package/dist/orgs/orgContext.d.ts +23 -0
  103. package/dist/orgs/orgContext.js +198 -0
  104. package/dist/orgs/orgPermissions.d.ts +4 -0
  105. package/dist/orgs/orgPermissions.js +77 -0
  106. package/dist/orgs/orgPlugin.d.ts +13 -0
  107. package/dist/orgs/orgPlugin.js +84 -0
  108. package/dist/orgs/organizationModel.d.ts +13 -0
  109. package/dist/orgs/organizationModel.js +301 -0
  110. package/dist/orgs/organizationSettings.d.ts +19 -0
  111. package/dist/orgs/organizationSettings.js +120 -0
  112. package/dist/orgs/orgsApp.d.ts +28 -0
  113. package/dist/orgs/orgsApp.js +678 -0
  114. package/dist/permissions.d.ts +7 -13
  115. package/dist/permissions.js +8 -31
  116. package/dist/plugins.d.ts +14 -1
  117. package/dist/plugins.js +17 -6
  118. package/dist/populate.d.ts +2 -2
  119. package/dist/populate.js +47 -42
  120. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  121. package/dist/rateLimit/applyTrustProxy.js +17 -0
  122. package/dist/rateLimit/createStore.d.ts +2 -0
  123. package/dist/rateLimit/createStore.js +28 -0
  124. package/dist/rateLimit/memoryStore.d.ts +2 -0
  125. package/dist/rateLimit/memoryStore.js +108 -0
  126. package/dist/rateLimit/middleware.d.ts +3 -0
  127. package/dist/rateLimit/middleware.js +109 -0
  128. package/dist/rateLimit/mongoStore.d.ts +4 -0
  129. package/dist/rateLimit/mongoStore.js +123 -0
  130. package/dist/rateLimit/policies.d.ts +10 -0
  131. package/dist/rateLimit/policies.js +149 -0
  132. package/dist/rateLimit/redisStore.d.ts +4 -0
  133. package/dist/rateLimit/redisStore.js +156 -0
  134. package/dist/rateLimit/types.d.ts +54 -0
  135. package/dist/rateLimit/types.js +9 -0
  136. package/dist/rbac/access.js +35 -14
  137. package/dist/rbac/assertAllowed.d.ts +9 -0
  138. package/dist/rbac/assertAllowed.js +182 -0
  139. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  140. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  141. package/dist/rbac/modelRouterAccess.d.ts +4 -0
  142. package/dist/rbac/modelRouterAccess.js +11 -4
  143. package/dist/rbac/permissionUtils.js +3 -2
  144. package/dist/rbac/resolve.js +65 -35
  145. package/dist/rbac/roleModel.d.ts +2 -5
  146. package/dist/rbac/roleModel.js +18 -4
  147. package/dist/rbac/routes.js +15 -6
  148. package/dist/rbac/statements.d.ts +10 -1
  149. package/dist/rbac/statements.js +19 -2
  150. package/dist/rbac/types.d.ts +5 -0
  151. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  152. package/dist/realtime/changeStreamWatcher.js +110 -64
  153. package/dist/realtime/deprecation.d.ts +13 -0
  154. package/dist/realtime/deprecation.js +33 -0
  155. package/dist/realtime/realtimeApp.d.ts +2 -1
  156. package/dist/realtime/realtimeApp.js +11 -11
  157. package/dist/realtime/registry.d.ts +0 -31
  158. package/dist/realtime/registry.js +44 -31
  159. package/dist/realtime/socketAuth.d.ts +5 -5
  160. package/dist/realtime/socketAuth.js +11 -1
  161. package/dist/realtime/socketUser.d.ts +5 -1
  162. package/dist/realtime/types.d.ts +14 -4
  163. package/dist/schemaMetadata.d.ts +56 -0
  164. package/dist/schemaMetadata.js +524 -0
  165. package/dist/seedRunner.d.ts +88 -0
  166. package/dist/seedRunner.js +627 -0
  167. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  168. package/dist/sync/adminBroadcastScope.js +194 -0
  169. package/dist/sync/adminWindowAccess.d.ts +13 -0
  170. package/dist/sync/adminWindowAccess.js +96 -0
  171. package/dist/sync/adminWindowMutation.d.ts +88 -0
  172. package/dist/sync/adminWindowMutation.js +247 -0
  173. package/dist/sync/executors.d.ts +19 -3
  174. package/dist/sync/executors.js +194 -165
  175. package/dist/sync/loadHarness.js +28 -19
  176. package/dist/sync/models.js +26 -24
  177. package/dist/sync/mutationHandler.d.ts +14 -2
  178. package/dist/sync/mutationHandler.js +201 -76
  179. package/dist/sync/registrationSideEffects.d.ts +35 -0
  180. package/dist/sync/registrationSideEffects.js +151 -0
  181. package/dist/sync/registry.d.ts +2 -52
  182. package/dist/sync/registry.js +42 -187
  183. package/dist/sync/routes.d.ts +13 -0
  184. package/dist/sync/routes.js +116 -58
  185. package/dist/sync/scripts/compactTombstones.js +0 -2
  186. package/dist/sync/socketHandlers.d.ts +8 -2
  187. package/dist/sync/socketHandlers.js +144 -50
  188. package/dist/sync/streams.d.ts +2 -0
  189. package/dist/sync/streams.js +7 -1
  190. package/dist/sync/syncApp.d.ts +4 -3
  191. package/dist/sync/syncApp.js +5 -4
  192. package/dist/sync/syncBatch.d.ts +5 -2
  193. package/dist/sync/syncBatch.js +7 -6
  194. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  195. package/dist/sync/syncSeqPlugin.js +20 -16
  196. package/dist/sync/types.d.ts +18 -0
  197. package/dist/terrenoApp.d.ts +48 -5
  198. package/dist/terrenoApp.js +157 -72
  199. package/dist/tests/createTestData.d.ts +1 -3
  200. package/dist/tests/createTestData.js +3 -5
  201. package/dist/tests/models.d.ts +3 -0
  202. package/dist/tests/models.js +15 -2
  203. package/dist/tests/testHelper.d.ts +0 -5
  204. package/dist/tests/testHelper.js +2 -9
  205. package/dist/types/authToken.d.ts +33 -0
  206. package/dist/types/authToken.js +2 -0
  207. package/dist/types/mcpServiceToken.d.ts +41 -0
  208. package/dist/types/mcpServiceToken.js +2 -0
  209. package/dist/types/membership.d.ts +23 -0
  210. package/dist/types/membership.js +2 -0
  211. package/dist/types/notification.d.ts +28 -0
  212. package/dist/types/notification.js +2 -0
  213. package/dist/types/notificationPreference.d.ts +20 -0
  214. package/dist/types/notificationPreference.js +2 -0
  215. package/dist/types/organization.d.ts +36 -0
  216. package/dist/types/organization.js +2 -0
  217. package/dist/webhooks/headerValue.d.ts +2 -0
  218. package/dist/webhooks/headerValue.js +14 -0
  219. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  220. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  221. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  222. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  223. package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
  224. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  225. package/dist/webhooks/rawBody.d.ts +15 -0
  226. package/dist/webhooks/rawBody.js +23 -0
  227. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  228. package/dist/webhooks/timingSafeEqual.js +17 -0
  229. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  230. package/dist/webhooks/verifiers/hmac.js +49 -0
  231. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  232. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  233. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  234. package/dist/webhooks/verifiers/stripe.js +99 -0
  235. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  236. package/dist/webhooks/verifiers/twilio.js +112 -0
  237. package/dist/webhooks/webhooksApp.d.ts +33 -0
  238. package/dist/webhooks/webhooksApp.js +195 -0
  239. package/package.json +32 -27
  240. package/src/__snapshots__/openApi.test.ts.snap +444 -36
  241. package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
  242. package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
  243. package/src/actions.ts +20 -13
  244. package/src/adminModelRouter.test.ts +133 -0
  245. package/src/adminTypes.ts +8 -0
  246. package/src/api.arrayOperations.test.ts +43 -31
  247. package/src/api.hooks.test.ts +38 -29
  248. package/src/api.query.test.ts +31 -31
  249. package/src/api.test.ts +133 -97
  250. package/src/api.ts +84 -27
  251. package/src/audit/auditApp.test.ts +243 -0
  252. package/src/audit/auditApp.ts +139 -0
  253. package/src/audit/auditEventModel.ts +156 -0
  254. package/src/audit/auditRouter.test.ts +456 -0
  255. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  256. package/src/audit/cloudTasksEnqueue.ts +104 -0
  257. package/src/audit/diff.ts +163 -0
  258. package/src/audit/processQueue.ts +69 -0
  259. package/src/audit/rbacSink.test.ts +86 -0
  260. package/src/audit/rbacSink.ts +42 -0
  261. package/src/audit/record.test.ts +402 -0
  262. package/src/audit/record.ts +328 -0
  263. package/src/auth.test.ts +108 -52
  264. package/src/auth.ts +98 -29
  265. package/src/authRecovery.test.ts +281 -0
  266. package/src/authRecovery.ts +279 -0
  267. package/src/authTokens.test.ts +94 -0
  268. package/src/authTokens.ts +118 -0
  269. package/src/authVerification.test.ts +293 -0
  270. package/src/betterAuth.ts +31 -0
  271. package/src/betterAuthApp.test.ts +1 -0
  272. package/src/betterAuthApp.ts +27 -9
  273. package/src/betterAuthSetup.test.ts +595 -38
  274. package/src/betterAuthSetup.ts +261 -5
  275. package/src/collectionRegistry.test.ts +164 -0
  276. package/src/collectionRegistry.ts +135 -0
  277. package/src/configurationApp.ts +13 -7
  278. package/src/docLoader.test.ts +45 -1
  279. package/src/docLoader.ts +37 -6
  280. package/src/express.d.ts +3 -0
  281. package/src/expressServer.test.ts +180 -68
  282. package/src/expressServer.ts +75 -19
  283. package/src/githubAuth.test.ts +60 -55
  284. package/src/index.ts +127 -0
  285. package/src/mcp/auth.test.ts +47 -0
  286. package/src/mcp/auth.ts +32 -11
  287. package/src/mcp/handlers.test.ts +275 -0
  288. package/src/mcp/handlers.ts +45 -172
  289. package/src/mcp/integration.test.ts +59 -9
  290. package/src/mcp/query.ts +5 -7
  291. package/src/mcp/registry.ts +29 -20
  292. package/src/mcp/schemaGenerator.test.ts +8 -0
  293. package/src/mcp/schemaGenerator.ts +49 -131
  294. package/src/mcp/server.ts +2 -0
  295. package/src/mcp/serviceTokens.test.ts +330 -0
  296. package/src/mcp/serviceTokens.ts +307 -0
  297. package/src/mcp/toolGenerator.test.ts +82 -1
  298. package/src/mcp/types.ts +2 -6
  299. package/src/migrations/cli.test.ts +376 -0
  300. package/src/migrations/cli.ts +283 -0
  301. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  302. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  303. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  304. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  305. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  306. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  307. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  308. package/src/migrations/generate.test.ts +333 -0
  309. package/src/migrations/generate.ts +216 -0
  310. package/src/migrations/load.test.ts +103 -0
  311. package/src/migrations/load.ts +124 -0
  312. package/src/migrations/lock.test.ts +133 -0
  313. package/src/migrations/lock.ts +118 -0
  314. package/src/migrations/runner.test.ts +504 -0
  315. package/src/migrations/runner.ts +358 -0
  316. package/src/migrations/schemaCatalog.test.ts +159 -0
  317. package/src/migrations/schemaCatalog.ts +262 -0
  318. package/src/migrations/types.ts +94 -0
  319. package/src/models/mcpServiceToken.test.ts +129 -0
  320. package/src/models/mcpServiceToken.ts +158 -0
  321. package/src/models/notification.ts +68 -0
  322. package/src/models/notificationPreference.ts +62 -0
  323. package/src/notifications/notificationService.ts +254 -0
  324. package/src/notifications/notificationsApp.test.ts +505 -0
  325. package/src/notifications/notificationsApp.ts +200 -0
  326. package/src/notifications/notificationsBeforeSend.ts +51 -0
  327. package/src/openApi.test.ts +80 -65
  328. package/src/openApi.ts +2 -1
  329. package/src/openApiBuilder.test.ts +95 -7
  330. package/src/openApiBuilder.ts +60 -12
  331. package/src/openApiCompat.ts +1 -1
  332. package/src/openApiValidator.test.ts +270 -56
  333. package/src/openApiValidator.ts +219 -36
  334. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  335. package/src/orgs/orgContext.test.ts +259 -0
  336. package/src/orgs/orgContext.ts +151 -0
  337. package/src/orgs/orgPermissions.test.ts +105 -0
  338. package/src/orgs/orgPermissions.ts +40 -0
  339. package/src/orgs/orgPlugin.test.ts +130 -0
  340. package/src/orgs/orgPlugin.ts +70 -0
  341. package/src/orgs/orgRbac.test.ts +267 -0
  342. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  343. package/src/orgs/organizationModel.test.ts +205 -0
  344. package/src/orgs/organizationModel.ts +257 -0
  345. package/src/orgs/organizationSettings.test.ts +113 -0
  346. package/src/orgs/organizationSettings.ts +126 -0
  347. package/src/orgs/orgsApp.test.ts +382 -0
  348. package/src/orgs/orgsApp.ts +563 -0
  349. package/src/permissions.test.ts +62 -36
  350. package/src/permissions.ts +8 -30
  351. package/src/plugins.test.ts +14 -0
  352. package/src/plugins.ts +34 -9
  353. package/src/populate.test.ts +34 -0
  354. package/src/populate.ts +40 -29
  355. package/src/rateLimit/applyTrustProxy.ts +17 -0
  356. package/src/rateLimit/createStore.ts +25 -0
  357. package/src/rateLimit/memoryStore.ts +40 -0
  358. package/src/rateLimit/middleware.ts +79 -0
  359. package/src/rateLimit/mongoStore.test.ts +80 -0
  360. package/src/rateLimit/mongoStore.ts +77 -0
  361. package/src/rateLimit/policies.ts +130 -0
  362. package/src/rateLimit/rateLimit.test.ts +328 -0
  363. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  364. package/src/rateLimit/redisStore.test.ts +114 -0
  365. package/src/rateLimit/redisStore.ts +86 -0
  366. package/src/rateLimit/types.ts +64 -0
  367. package/src/rbac/access.ts +16 -4
  368. package/src/rbac/assertAllowed.test.ts +325 -0
  369. package/src/rbac/assertAllowed.ts +157 -0
  370. package/src/rbac/backfillAdmins.test.ts +124 -0
  371. package/src/rbac/fieldViews.test.ts +89 -0
  372. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  373. package/src/rbac/modelRouterAccess.test.ts +126 -0
  374. package/src/rbac/modelRouterAccess.ts +8 -2
  375. package/src/rbac/permissionUtils.test.ts +26 -5
  376. package/src/rbac/permissionUtils.ts +3 -2
  377. package/src/rbac/realtimeAccess.test.ts +109 -1
  378. package/src/rbac/resolve.test.ts +34 -2
  379. package/src/rbac/resolve.ts +31 -11
  380. package/src/rbac/roleManager.test.ts +169 -0
  381. package/src/rbac/roleModel.test.ts +34 -1
  382. package/src/rbac/roleModel.ts +17 -1
  383. package/src/rbac/routes.test.ts +233 -0
  384. package/src/rbac/routes.ts +16 -6
  385. package/src/rbac/statements.test.ts +19 -0
  386. package/src/rbac/statements.ts +19 -1
  387. package/src/rbac/types.ts +5 -0
  388. package/src/realtime/changeStreamWatcher.ts +73 -33
  389. package/src/realtime/deprecation.test.ts +60 -0
  390. package/src/realtime/deprecation.ts +33 -0
  391. package/src/realtime/realtime.test.ts +365 -189
  392. package/src/realtime/realtimeApp.ts +11 -11
  393. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  394. package/src/realtime/registry.ts +48 -42
  395. package/src/realtime/sessionRevalidation.test.ts +57 -44
  396. package/src/realtime/socketAuth.test.ts +75 -23
  397. package/src/realtime/socketAuth.ts +17 -6
  398. package/src/realtime/socketUser.ts +5 -3
  399. package/src/realtime/types.ts +14 -4
  400. package/src/schemaMetadata.test.ts +419 -0
  401. package/src/schemaMetadata.ts +593 -0
  402. package/src/scrubAdminFields.test.ts +105 -0
  403. package/src/seedRunner.test.ts +591 -0
  404. package/src/seedRunner.ts +464 -0
  405. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  406. package/src/sync/adminBroadcastScope.test.ts +155 -0
  407. package/src/sync/adminBroadcastScope.ts +123 -0
  408. package/src/sync/adminWindowAccess.test.ts +57 -0
  409. package/src/sync/adminWindowAccess.ts +32 -0
  410. package/src/sync/adminWindowMutation.test.ts +450 -0
  411. package/src/sync/adminWindowMutation.ts +283 -0
  412. package/src/sync/docMatchesMutationData.test.ts +16 -0
  413. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  414. package/src/sync/executors.test.ts +40 -0
  415. package/src/sync/executors.ts +57 -18
  416. package/src/sync/integration.test.ts +15 -7
  417. package/src/sync/loadHarness.ts +28 -19
  418. package/src/sync/models.ts +32 -18
  419. package/src/sync/mutationHandler.test.ts +293 -17
  420. package/src/sync/mutationHandler.ts +180 -36
  421. package/src/sync/registrationSideEffects.test.ts +126 -0
  422. package/src/sync/registrationSideEffects.ts +131 -0
  423. package/src/sync/registry.ts +49 -171
  424. package/src/sync/routes.ts +55 -10
  425. package/src/sync/scripts/compactTombstones.ts +0 -2
  426. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  427. package/src/sync/socketHandlers.ts +154 -58
  428. package/src/sync/streams.ts +6 -0
  429. package/src/sync/sync.test.ts +28 -25
  430. package/src/sync/syncApp.ts +5 -4
  431. package/src/sync/syncBatch.ts +10 -4
  432. package/src/sync/syncFrontier.test.ts +17 -15
  433. package/src/sync/syncPhaseC.test.ts +54 -43
  434. package/src/sync/syncRoutes.test.ts +347 -38
  435. package/src/sync/syncSeqPlugin.ts +66 -44
  436. package/src/sync/syncSocket.test.ts +341 -81
  437. package/src/sync/types.ts +20 -0
  438. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  439. package/src/terrenoApp.migrations.test.ts +114 -0
  440. package/src/terrenoApp.test.ts +41 -0
  441. package/src/terrenoApp.ts +181 -46
  442. package/src/tests/createTestData.ts +2 -2
  443. package/src/tests/models.ts +24 -3
  444. package/src/tests/testHelper.ts +1 -7
  445. package/src/types/authToken.ts +41 -0
  446. package/src/types/mcpServiceToken.ts +48 -0
  447. package/src/types/membership.ts +48 -0
  448. package/src/types/notification.ts +34 -0
  449. package/src/types/notificationPreference.ts +28 -0
  450. package/src/types/organization.ts +49 -0
  451. package/src/webhooks/headerValue.test.ts +22 -0
  452. package/src/webhooks/headerValue.ts +12 -0
  453. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  454. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  455. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  456. package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
  457. package/src/webhooks/rawBody.test.ts +107 -0
  458. package/src/webhooks/rawBody.ts +24 -0
  459. package/src/webhooks/timingSafeEqual.ts +16 -0
  460. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  461. package/src/webhooks/verifiers/hmac.ts +54 -0
  462. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  463. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  464. package/src/webhooks/verifiers/stripe.ts +67 -0
  465. package/src/webhooks/verifiers/twilio.ts +69 -0
  466. package/src/webhooks/webhooksApp.test.ts +221 -0
  467. package/src/webhooks/webhooksApp.ts +144 -0
  468. package/tsconfig.json +1 -1
  469. package/tsconfig.typedoc.json +2 -1
  470. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  471. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  472. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
package/src/sync/types.ts CHANGED
@@ -39,6 +39,13 @@ export type SyncScope = SyncScopeOwner | SyncScopeTenant | SyncScopeBroadcast |
39
39
  * (seq stamping) — validated at registration.
40
40
  */
41
41
  export interface SyncConfig {
42
+ /**
43
+ * When true, change-stream `sync:delta` emission also fans in to `{collection}|admin`
44
+ * in addition to the owner/tenant/broadcast/custom stream. Default false. App clients
45
+ * keep their existing scope; only admin window subscribers join `|admin`. Join
46
+ * permission is admin-only (same checks as `/admin/*`), not owner-stream membership.
47
+ */
48
+ adminBroadcast?: boolean;
42
49
  /** Which stream a document belongs to. Multi-tenant by default via the tenant scope. */
43
50
  scope: SyncScope;
44
51
  /**
@@ -65,6 +72,12 @@ export interface SyncConfig {
65
72
 
66
73
  export type SyncMutationOperation = "create" | "update" | "delete";
67
74
 
75
+ /** Explicit client marker for admin-panel windowed sync writes. */
76
+ export type SyncMutationMode = "adminWindow";
77
+
78
+ /** `sync:subscribe` / `sync:subscribed` window mode for admin fan-in (no snapshot paging). */
79
+ export type SyncSubscribeMode = "window";
80
+
68
81
  /** A single entity in a snapshot response. */
69
82
  export interface SyncEntityPayload {
70
83
  /** Document id. */
@@ -138,6 +151,13 @@ export interface SyncMutateRequest {
138
151
  data?: Record<string, unknown>;
139
152
  /** The `_syncSeq` the client last saw for this document; enables LWW conflict detection. */
140
153
  baseVersion?: number;
154
+ /**
155
+ * When `"adminWindow"`, the server applies AdminApp write semantics (RBAC,
156
+ * writeOwned, readonly/hidden stripping, audit) instead of product sync
157
+ * permissions. Ignored unless the collection is `adminBroadcast`, the caller
158
+ * has admin-window access, and AdminApp registered a write scope.
159
+ */
160
+ mutationMode?: SyncMutationMode;
141
161
  }
142
162
 
143
163
  /** Successful mutation acknowledgement. */
@@ -0,0 +1,173 @@
1
+ import {beforeEach, describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+ import mongoose, {model, Schema} from "mongoose";
4
+ import supertest from "supertest";
5
+
6
+ import {modelRouter} from "./api";
7
+ import type {UserModel as UserModelType} from "./auth";
8
+ import {clearMCPRegistry} from "./mcp/registry";
9
+ import {McpServiceToken} from "./models/mcpServiceToken";
10
+ import {Permissions} from "./permissions";
11
+ import {createdUpdatedPlugin} from "./plugins";
12
+ import {TerrenoApp} from "./terrenoApp";
13
+ import {authAsUser, setupDb, UserModel} from "./tests";
14
+
15
+ const typedUserModel = UserModel as unknown as UserModelType;
16
+
17
+ const PUBLIC_MCP_URL = "https://api.example.com";
18
+
19
+ const toolsCallBody = {
20
+ id: 3,
21
+ jsonrpc: "2.0",
22
+ method: "tools/call",
23
+ params: {arguments: {}, name: "tokenmcpnotes_list"},
24
+ };
25
+
26
+ const getNoteModel = (): mongoose.Model<{title?: string}> => {
27
+ if (mongoose.models.TokenMcpNote) {
28
+ return mongoose.models.TokenMcpNote as mongoose.Model<{title?: string}>;
29
+ }
30
+ const schema = new Schema({title: {description: "Note title", type: String}});
31
+ schema.plugin(createdUpdatedPlugin);
32
+ return model("TokenMcpNote", schema);
33
+ };
34
+
35
+ const TokenMcpNote = getNoteModel();
36
+
37
+ const noteRouter = () => {
38
+ return modelRouter("/token-mcp-notes", TokenMcpNote, {
39
+ mcp: {methods: ["list"], toolPrefix: "tokenmcpnotes"},
40
+ permissions: {
41
+ create: [],
42
+ delete: [],
43
+ list: [Permissions.IsAuthenticated],
44
+ read: [Permissions.IsAuthenticated],
45
+ update: [],
46
+ },
47
+ });
48
+ };
49
+
50
+ describe("TerrenoApp mcpServiceTokens", () => {
51
+ let notAdminId: mongoose.Types.ObjectId;
52
+
53
+ beforeEach(async () => {
54
+ const users = await setupDb();
55
+ notAdminId = users[1]._id as mongoose.Types.ObjectId;
56
+ await McpServiceToken.deleteMany({});
57
+ await TokenMcpNote.deleteMany({});
58
+ clearMCPRegistry();
59
+ });
60
+
61
+ it("does not serve token routes or accept mcp_ on /mcp when the flag is off", async () => {
62
+ const app = new TerrenoApp({
63
+ skipListen: true,
64
+ userModel: typedUserModel,
65
+ })
66
+ .register(noteRouter())
67
+ .build();
68
+
69
+ const missingRoutes = await supertest(app).get("/mcp/service-tokens");
70
+ assert.equal(missingRoutes.status, 404);
71
+
72
+ const issued = await McpServiceToken.issueFor({_id: notAdminId}, {name: "Ignored"});
73
+ const mcpCall = await supertest(app)
74
+ .post("/mcp")
75
+ .set("accept", "application/json, text/event-stream")
76
+ .set("Authorization", `Bearer ${issued.token}`)
77
+ .send(toolsCallBody);
78
+
79
+ assert.include(mcpCall.text, "Permission denied: authentication required");
80
+ });
81
+
82
+ it("serves token routes and accepts mcp_ on /mcp when the flag is true", async () => {
83
+ const app = new TerrenoApp({
84
+ mcpServiceTokens: true,
85
+ skipListen: true,
86
+ userModel: typedUserModel,
87
+ })
88
+ .register(noteRouter())
89
+ .build();
90
+
91
+ const agent = await authAsUser(app, "notAdmin");
92
+ const created = await agent.post("/mcp/service-tokens").send({name: "Perplexity"});
93
+
94
+ assert.equal(created.status, 200);
95
+ assert.match(created.body.data.token, /^mcp_[0-9a-f]{64}$/);
96
+
97
+ await TokenMcpNote.create({title: "Visible note"});
98
+
99
+ const mcpCall = await supertest(app)
100
+ .post("/mcp")
101
+ .set("accept", "application/json, text/event-stream")
102
+ .set("Authorization", `Bearer ${created.body.data.token}`)
103
+ .send(toolsCallBody);
104
+
105
+ assert.notInclude(mcpCall.text, "Permission denied");
106
+ assert.include(mcpCall.text, "Visible note");
107
+ });
108
+
109
+ it("uses publicMcpUrl from the object form of the flag", async () => {
110
+ const app = new TerrenoApp({
111
+ mcpServiceTokens: {enabled: true, publicMcpUrl: PUBLIC_MCP_URL},
112
+ skipListen: true,
113
+ userModel: typedUserModel,
114
+ }).build();
115
+
116
+ const agent = await authAsUser(app, "notAdmin");
117
+ const created = await agent.post("/mcp/service-tokens").send({name: "Named"});
118
+
119
+ assert.equal(created.status, 200);
120
+ assert.equal(created.body.data.mcpUrl, `${PUBLIC_MCP_URL}/mcp`);
121
+ });
122
+
123
+ it("documents the token routes in /openapi.json when enabled", async () => {
124
+ const app = new TerrenoApp({
125
+ mcpServiceTokens: true,
126
+ skipListen: true,
127
+ userModel: typedUserModel,
128
+ }).build();
129
+
130
+ const res = await supertest(app).get("/openapi.json");
131
+ assert.equal(res.body.paths["/mcp/service-tokens"].post.operationId, "createMcpServiceToken");
132
+ });
133
+
134
+ it("lets a minted service token call tools as the owner while GET /mcp stays 405", async () => {
135
+ await TokenMcpNote.create({title: "Visible note"});
136
+ const app = new TerrenoApp({
137
+ mcpServiceTokens: true,
138
+ skipListen: true,
139
+ userModel: typedUserModel,
140
+ })
141
+ .register(noteRouter())
142
+ .build();
143
+
144
+ const agent = await authAsUser(app, "notAdmin");
145
+ const created = await agent.post("/mcp/service-tokens").send({name: "Perplexity probe"});
146
+ const mcpToken = created.body.data.token as string;
147
+
148
+ const jwtCall = await agent
149
+ .post("/mcp")
150
+ .set("accept", "application/json, text/event-stream")
151
+ .send(toolsCallBody);
152
+ const tokenCall = await supertest(app)
153
+ .post("/mcp")
154
+ .set("Authorization", `Bearer ${mcpToken}`)
155
+ .set("accept", "application/json, text/event-stream")
156
+ .send(toolsCallBody);
157
+ const bogusCall = await supertest(app)
158
+ .post("/mcp")
159
+ .set("Authorization", "Bearer mcp_deadbeef")
160
+ .set("accept", "application/json, text/event-stream")
161
+ .send(toolsCallBody);
162
+ const probe = await supertest(app)
163
+ .get("/mcp")
164
+ .set("Authorization", `Bearer ${mcpToken}`)
165
+ .set("accept", "application/json, text/event-stream");
166
+
167
+ assert.include(jwtCall.text, "Visible note");
168
+ assert.include(tokenCall.text, "Visible note");
169
+ assert.include(bogusCall.text, "Permission denied: authentication required");
170
+ assert.equal(probe.status, 405);
171
+ assert.equal(probe.body.error.message, "Method not allowed.");
172
+ });
173
+ });
@@ -0,0 +1,114 @@
1
+ /**
2
+ * Tests for TerrenoApp `migrations.runOnStart` (wet up after connect, before listen).
3
+ */
4
+ import {beforeEach, describe, expect, it} from "bun:test";
5
+ import {join} from "node:path";
6
+ import mongoose from "mongoose";
7
+ import type {UserModel as UserModelType} from "./auth";
8
+ import {runStartupMigrations} from "./migrations/runner";
9
+ import {MIGRATION_LOCK_ID, MIGRATIONS_COLLECTION} from "./migrations/types";
10
+ import {TerrenoApp} from "./terrenoApp";
11
+ import {setupDb, UserModel} from "./tests";
12
+
13
+ const fixtures = (...parts: string[]): string => {
14
+ return join(import.meta.dir, "migrations", "fixtures", ...parts);
15
+ };
16
+
17
+ const appliedIds = async (): Promise<string[]> => {
18
+ const docs = await mongoose.connection
19
+ .collection(MIGRATIONS_COLLECTION)
20
+ .find({_id: {$ne: MIGRATION_LOCK_ID}})
21
+ .project({id: 1})
22
+ .toArray();
23
+ return docs.map((doc) => String(doc.id)).sort();
24
+ };
25
+
26
+ describe("runStartupMigrations", () => {
27
+ beforeEach(async () => {
28
+ await setupDb();
29
+ await mongoose.connection.collection(MIGRATIONS_COLLECTION).deleteMany({});
30
+ });
31
+
32
+ it("does not run when migrations option is omitted", async () => {
33
+ const result = await runStartupMigrations({
34
+ env: {NODE_ENV: "test"},
35
+ mongoose,
36
+ });
37
+ expect(result.ran).toBe(false);
38
+ expect(await appliedIds()).toEqual([]);
39
+ });
40
+
41
+ it("does not run when runOnStart is omitted", async () => {
42
+ const result = await runStartupMigrations({
43
+ env: {NODE_ENV: "test"},
44
+ migrations: {dir: fixtures("valid")},
45
+ mongoose,
46
+ });
47
+ expect(result.ran).toBe(false);
48
+ expect(await appliedIds()).toEqual([]);
49
+ });
50
+
51
+ it("applies pending files when runOnStart is true", async () => {
52
+ const result = await runStartupMigrations({
53
+ env: {NODE_ENV: "test"},
54
+ migrations: {dir: fixtures("valid"), runOnStart: true},
55
+ mongoose,
56
+ });
57
+ expect(result.ran).toBe(true);
58
+ expect(result.applied).toEqual(["20260910120000-alpha", "20260910120001-beta"]);
59
+ expect(await appliedIds()).toEqual(["20260910120000-alpha", "20260910120001-beta"]);
60
+ });
61
+
62
+ it("throws in production without ALLOW_MIGRATIONS before applying", async () => {
63
+ await expect(
64
+ runStartupMigrations({
65
+ env: {NODE_ENV: "production"},
66
+ migrations: {dir: fixtures("valid"), runOnStart: true},
67
+ mongoose,
68
+ })
69
+ ).rejects.toThrow("Migrations not allowed");
70
+ expect(await appliedIds()).toEqual([]);
71
+ });
72
+ });
73
+
74
+ describe("TerrenoApp start migrations", () => {
75
+ const typedUserModel = UserModel as unknown as UserModelType;
76
+
77
+ beforeEach(async () => {
78
+ await setupDb();
79
+ await mongoose.connection.collection(MIGRATIONS_COLLECTION).deleteMany({});
80
+ });
81
+
82
+ it("applies pending files through start() when runOnStart is true", async () => {
83
+ const app = new TerrenoApp({
84
+ migrations: {dir: fixtures("valid"), runOnStart: true},
85
+ skipListen: true,
86
+ userModel: typedUserModel,
87
+ });
88
+ app.start();
89
+ await app.whenReady();
90
+ expect(await appliedIds()).toEqual(["20260910120000-alpha", "20260910120001-beta"]);
91
+ });
92
+
93
+ it("rejects whenReady in production without ALLOW_MIGRATIONS and does not listen", async () => {
94
+ const previousNodeEnv = process.env.NODE_ENV;
95
+ process.env.NODE_ENV = "production";
96
+ Reflect.deleteProperty(process.env, "ALLOW_MIGRATIONS");
97
+ try {
98
+ const app = new TerrenoApp({
99
+ migrations: {dir: fixtures("valid"), runOnStart: true},
100
+ skipListen: true,
101
+ userModel: typedUserModel,
102
+ });
103
+ app.start();
104
+ await expect(app.whenReady()).rejects.toThrow("Migrations not allowed");
105
+ expect(await appliedIds()).toEqual([]);
106
+ } finally {
107
+ if (previousNodeEnv === undefined) {
108
+ Reflect.deleteProperty(process.env, "NODE_ENV");
109
+ } else {
110
+ process.env.NODE_ENV = previousNodeEnv;
111
+ }
112
+ }
113
+ });
114
+ });
@@ -9,6 +9,8 @@ import {configurationPlugin} from "./configurationPlugin";
9
9
  import {APIError} from "./errors";
10
10
  import {Permissions} from "./permissions";
11
11
  import {createdUpdatedPlugin} from "./plugins";
12
+ import {createAccess} from "./rbac/access";
13
+ import {terrenoStatements} from "./rbac/statements";
12
14
  import {TerrenoApp} from "./terrenoApp";
13
15
  import type {TerrenoPlugin} from "./terrenoPlugin";
14
16
  import {authAsUser, FoodModel, setupDb, UserModel} from "./tests";
@@ -74,6 +76,45 @@ describe("TerrenoApp", () => {
74
76
 
75
77
  expect(app).toBeDefined();
76
78
  });
79
+
80
+ it("does not mount /orgs when organizations is omitted", async () => {
81
+ const app = new TerrenoApp({
82
+ skipListen: true,
83
+ userModel: typedUserModel,
84
+ }).start();
85
+
86
+ const res = await supertest(app).get("/orgs");
87
+ expect(res.status).toBe(404);
88
+ });
89
+
90
+ it("requires accessControl when organizations is true", () => {
91
+ expect(() =>
92
+ new TerrenoApp({
93
+ organizations: true,
94
+ skipListen: true,
95
+ userModel: typedUserModel,
96
+ }).start()
97
+ ).toThrow("organizations requires accessControl");
98
+ });
99
+
100
+ it("mounts /orgs when organizations is true", async () => {
101
+ await setupDb();
102
+ const access = createAccess({
103
+ connection: mongoose.connection,
104
+ organizations: true,
105
+ statements: terrenoStatements,
106
+ userModel: typedUserModel,
107
+ });
108
+ const app = new TerrenoApp({
109
+ accessControl: access,
110
+ organizations: true,
111
+ skipListen: true,
112
+ userModel: typedUserModel,
113
+ }).start();
114
+
115
+ const res = await supertest(app).get("/orgs");
116
+ expect(res.status).not.toBe(404);
117
+ });
77
118
  });
78
119
 
79
120
  describe("register with modelRouter", () => {