@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
@@ -1,6 +1,5 @@
1
- // noExplicitAny: test model typing
2
- // biome-ignore-all lint/suspicious/noExplicitAny: test model typing
3
- import {beforeAll, beforeEach, describe, expect, it} from "bun:test";
1
+ import {afterEach, beforeAll, beforeEach, describe, expect, it, spyOn} from "bun:test";
2
+ import {assert} from "chai";
4
3
  import mongoose, {model, Schema} from "mongoose";
5
4
  import type {ModelRouterOptions} from "../api";
6
5
  import type {User} from "../auth";
@@ -8,17 +7,24 @@ import {APIError} from "../errors";
8
7
  import {Permissions} from "../permissions";
9
8
  import {createdUpdatedPlugin, type IsDeleted, isDeletedPlugin} from "../plugins";
10
9
  import {setupDb} from "../tests";
10
+ import {
11
+ type AdminWindowMutationAuditEvent,
12
+ type AdminWindowMutationScope,
13
+ clearAdminWindowMutationScopes,
14
+ registerAdminWindowMutationScope,
15
+ } from "./adminWindowMutation";
11
16
  import {computeStableFrontier, SyncCounter, SyncMutation} from "./models";
12
17
  import {
13
18
  applySyncMutation,
14
19
  applySyncMutationBatch,
20
+ docMatchesMutationData,
15
21
  MAX_SYNC_MUTATIONS_PER_BATCH,
16
22
  type SyncMutationOutcome,
17
23
  validateSyncMutationBatch,
18
24
  } from "./mutationHandler";
19
25
  import {clearSyncRegistry, registerSync} from "./registry";
20
26
  import {syncPlugin} from "./syncSeqPlugin";
21
- import type {SyncMutateBatchResponse, SyncMutateRequest} from "./types";
27
+ import type {SyncConfig, SyncMutateBatchResponse, SyncMutateRequest} from "./types";
22
28
 
23
29
  interface MutStuff extends IsDeleted {
24
30
  _id: string;
@@ -40,7 +46,7 @@ const MutStuffModel = model<MutStuff>("MutStuff", mutStuffSchema);
40
46
  const owner = {_id: "mut-owner", admin: false, id: "mut-owner"} as unknown as User;
41
47
  const stranger = {_id: "mut-stranger", admin: false, id: "mut-stranger"} as unknown as User;
42
48
 
43
- const ownerOptions = {
49
+ const ownerOptions: ModelRouterOptions<MutStuff> = {
44
50
  permissions: {
45
51
  create: [Permissions.IsAuthenticated],
46
52
  delete: [Permissions.IsOwner],
@@ -48,14 +54,16 @@ const ownerOptions = {
48
54
  read: [Permissions.IsAny],
49
55
  update: [Permissions.IsOwner],
50
56
  },
51
- } as unknown as ModelRouterOptions<any>;
57
+ };
52
58
 
53
- const registerMutStuff = (overrides: Partial<Record<string, unknown>> = {}): void => {
59
+ const registerMutStuff = (
60
+ overrides: {config?: Partial<SyncConfig>; options?: ModelRouterOptions<MutStuff>} = {}
61
+ ): void => {
54
62
  clearSyncRegistry();
55
63
  registerSync({
56
- config: {scope: {type: "owner"}, ...(overrides.config as object)},
57
- model: MutStuffModel as any,
58
- options: (overrides.options as ModelRouterOptions<any>) ?? ownerOptions,
64
+ config: {scope: {type: "owner"}, ...overrides.config},
65
+ model: MutStuffModel,
66
+ options: overrides.options ?? ownerOptions,
59
67
  routePath: "/mutStuff",
60
68
  });
61
69
  };
@@ -365,6 +373,32 @@ describe("applySyncMutation", () => {
365
373
  expect(row?.resultId).toBe(entityId);
366
374
  });
367
375
 
376
+ it("create: surfaces the E11000 as a nack when the colliding _id is not readable (soft-deleted)", async () => {
377
+ const entityId = new mongoose.Types.ObjectId().toHexString();
378
+ await MutStuffModel.create({
379
+ _id: entityId,
380
+ deleted: true,
381
+ name: "tombstone",
382
+ ownerId: owner.id,
383
+ });
384
+ await createStalePendingRow("m-lease-create-tombstone", 90_000);
385
+
386
+ const nack = expectNack(
387
+ await applySyncMutation({
388
+ mutation: {
389
+ collection: "mutStuff",
390
+ data: {name: "tombstone", ownerId: owner.id},
391
+ id: entityId,
392
+ mutationId: "m-lease-create-tombstone",
393
+ operation: "create",
394
+ },
395
+ user: owner,
396
+ })
397
+ );
398
+ assert.notEqual(nack.code, "conflict");
399
+ assert.equal(await MutStuffModel.countDocuments({_id: entityId, deleted: true}), 1);
400
+ });
401
+
368
402
  it("update: tolerates the write having already landed (seq already advanced by exactly this mutation) and reads back the doc as the ack", async () => {
369
403
  const doc = await MutStuffModel.create({name: "v1", ownerId: owner.id});
370
404
  // Simulate the crash: the update write from the FIRST attempt landed
@@ -743,7 +777,7 @@ describe("applySyncMutation", () => {
743
777
  read: [Permissions.IsAdmin],
744
778
  update: [Permissions.IsAdmin],
745
779
  },
746
- } as unknown as ModelRouterOptions<any>,
780
+ },
747
781
  });
748
782
  const nack = expectNack(
749
783
  await applySyncMutation({
@@ -813,6 +847,25 @@ describe("applySyncMutation", () => {
813
847
  expect(nack.message).toContain("Unknown sync collection");
814
848
  });
815
849
 
850
+ it("nacks validation when an update omits baseVersion", async () => {
851
+ const doc = await MutStuffModel.create({name: "no base", ownerId: owner.id});
852
+ const nack = expectNack(
853
+ await applySyncMutation({
854
+ mutation: {
855
+ collection: "mutStuff",
856
+ data: {name: "changed"},
857
+ id: String(doc._id),
858
+ mutationId: "m-no-base-version",
859
+ operation: "update",
860
+ },
861
+ user: owner,
862
+ })
863
+ );
864
+ assert.equal(nack.code, "validation");
865
+ assert.include(nack.message, "baseVersion is required");
866
+ assert.equal(await SyncMutation.countDocuments({mutationId: "m-no-base-version"}), 0);
867
+ });
868
+
816
869
  it("nacks validation when update or delete is missing an id", async () => {
817
870
  for (const operation of ["update", "delete"] as const) {
818
871
  const nack = expectNack(
@@ -892,7 +945,7 @@ describe("applySyncMutation", () => {
892
945
  preCreate: () => {
893
946
  throw new APIError({status: 500, title: "database exploded"});
894
947
  },
895
- } as unknown as ModelRouterOptions<any>,
948
+ },
896
949
  });
897
950
  const nack = expectNack(
898
951
  await applySyncMutation({
@@ -917,14 +970,14 @@ describe("applySyncMutation", () => {
917
970
  registerMutStuff({
918
971
  options: {
919
972
  ...ownerOptions,
920
- preCreate: (body: unknown) => {
973
+ preCreate: (body) => {
921
974
  attempts += 1;
922
975
  if (attempts === 1) {
923
976
  throw new APIError({status: 500, title: "transient DB hiccup"});
924
977
  }
925
- return body;
978
+ return body as MutStuff;
926
979
  },
927
- } as unknown as ModelRouterOptions<any>,
980
+ },
928
981
  });
929
982
  const mutation: SyncMutateRequest = {
930
983
  collection: "mutStuff",
@@ -953,7 +1006,7 @@ describe("applySyncMutation", () => {
953
1006
  attempts += 1;
954
1007
  throw new APIError({status: 400, title: "name is not allowed"});
955
1008
  },
956
- } as unknown as ModelRouterOptions<any>,
1009
+ },
957
1010
  });
958
1011
  const mutation: SyncMutateRequest = {
959
1012
  collection: "mutStuff",
@@ -982,7 +1035,7 @@ describe("applySyncMutation", () => {
982
1035
  read: [Permissions.IsAny],
983
1036
  update: [Permissions.IsOwner],
984
1037
  },
985
- } as unknown as ModelRouterOptions<any>,
1038
+ },
986
1039
  });
987
1040
  const nack = expectNack(
988
1041
  await applySyncMutation({
@@ -1000,6 +1053,229 @@ describe("applySyncMutation", () => {
1000
1053
  // Task 9.18: error-class outcomes release the claim rather than recording it.
1001
1054
  expect(await SyncMutation.countDocuments({mutationId: "m-plain-error"})).toBe(0);
1002
1055
  });
1056
+
1057
+ it("rethrows a non-duplicate failure from the ledger claim insert", async () => {
1058
+ const createSpy = spyOn(SyncMutation, "create").mockImplementation((() => {
1059
+ throw new Error("ledger unavailable");
1060
+ }) as never);
1061
+ try {
1062
+ let thrown: unknown;
1063
+ try {
1064
+ await applySyncMutation({
1065
+ mutation: {
1066
+ collection: "mutStuff",
1067
+ data: {name: "never claimed", ownerId: owner.id},
1068
+ mutationId: "m-claim-crash",
1069
+ operation: "create",
1070
+ },
1071
+ user: owner,
1072
+ });
1073
+ } catch (error: unknown) {
1074
+ thrown = error;
1075
+ }
1076
+ assert.instanceOf(thrown, Error);
1077
+ assert.equal((thrown as Error).message, "ledger unavailable");
1078
+ } finally {
1079
+ createSpy.mockRestore();
1080
+ }
1081
+ assert.equal(await MutStuffModel.countDocuments({name: "never claimed"}), 0);
1082
+ });
1083
+ });
1084
+
1085
+ describe("write scope enforcement", () => {
1086
+ it("skips the write-scope check for broadcast collections", async () => {
1087
+ registerMutStuff({config: {scope: {type: "broadcast"}}});
1088
+ const ack = expectAck(
1089
+ await applySyncMutation({
1090
+ mutation: {
1091
+ collection: "mutStuff",
1092
+ data: {name: "broadcast", ownerId: stranger.id},
1093
+ mutationId: "m-broadcast-create",
1094
+ operation: "create",
1095
+ },
1096
+ user: owner,
1097
+ })
1098
+ );
1099
+ assert.equal(ack.seq, 1);
1100
+ const saved = await MutStuffModel.findById(ack.id);
1101
+ assert.equal(saved?.ownerId, stranger.id);
1102
+ });
1103
+
1104
+ it("nacks error when a tenant-scoped collection has no scope resolver", async () => {
1105
+ registerMutStuff({config: {scope: {field: "ownerId", type: "tenant"}}});
1106
+ const nack = expectNack(
1107
+ await applySyncMutation({
1108
+ mutation: {
1109
+ collection: "mutStuff",
1110
+ data: {name: "tenant", ownerId: "tenant-1"},
1111
+ mutationId: "m-tenant-no-resolver",
1112
+ operation: "create",
1113
+ },
1114
+ user: owner,
1115
+ })
1116
+ );
1117
+ assert.equal(nack.code, "error");
1118
+ assert.include(nack.message, "no getUserScopes resolver");
1119
+ assert.equal(await MutStuffModel.countDocuments({name: "tenant"}), 0);
1120
+ });
1121
+
1122
+ it("acks a tenant-scoped create when the resolver confirms the membership", async () => {
1123
+ registerMutStuff({config: {scope: {field: "ownerId", type: "tenant"}}});
1124
+ const ack = expectAck(
1125
+ await applySyncMutation({
1126
+ mutation: {
1127
+ collection: "mutStuff",
1128
+ data: {name: "tenant ok", ownerId: "tenant-1"},
1129
+ mutationId: "m-tenant-member",
1130
+ operation: "create",
1131
+ },
1132
+ scopeResolver: async () => ["tenant-1", "tenant-2"],
1133
+ user: owner,
1134
+ })
1135
+ );
1136
+ assert.equal(ack.seq, 1);
1137
+ });
1138
+ });
1139
+
1140
+ describe("recorded conflict replay", () => {
1141
+ const recordConflict = async (
1142
+ mutationId: string,
1143
+ resultId: string | undefined
1144
+ ): Promise<void> => {
1145
+ await SyncMutation.create({
1146
+ claimedAt: new Date(),
1147
+ error: "recorded conflict",
1148
+ mutationId,
1149
+ resultId,
1150
+ resultSeq: 3,
1151
+ status: "conflicted",
1152
+ userId: String(owner.id),
1153
+ });
1154
+ };
1155
+
1156
+ const replay = (mutationId: string): Promise<SyncMutationOutcome> =>
1157
+ applySyncMutation({
1158
+ mutation: {
1159
+ baseVersion: 1,
1160
+ collection: "mutStuff",
1161
+ data: {name: "replayed"},
1162
+ id: new mongoose.Types.ObjectId().toHexString(),
1163
+ mutationId,
1164
+ operation: "update",
1165
+ },
1166
+ user: owner,
1167
+ });
1168
+
1169
+ it("omits the server doc when the recorded conflict has no resultId", async () => {
1170
+ await recordConflict("m-conflict-no-id", undefined);
1171
+ const nack = expectNack(await replay("m-conflict-no-id"));
1172
+ assert.equal(nack.code, "conflict");
1173
+ assert.equal(nack.message, "recorded conflict");
1174
+ assert.equal(nack.serverSeq, 3);
1175
+ assert.isUndefined(nack.serverDoc);
1176
+ });
1177
+
1178
+ it("omits the server doc when the recorded resultId no longer resolves to a document", async () => {
1179
+ await recordConflict("m-conflict-missing", new mongoose.Types.ObjectId().toHexString());
1180
+ const nack = expectNack(await replay("m-conflict-missing"));
1181
+ assert.equal(nack.code, "conflict");
1182
+ assert.isUndefined(nack.serverDoc);
1183
+ });
1184
+
1185
+ it("omits the server doc when loading it throws", async () => {
1186
+ await recordConflict("m-conflict-bad-id", "not-an-object-id");
1187
+ const nack = expectNack(await replay("m-conflict-bad-id"));
1188
+ assert.equal(nack.code, "conflict");
1189
+ assert.isUndefined(nack.serverDoc);
1190
+ });
1191
+ });
1192
+
1193
+ describe("admin window mutations", () => {
1194
+ const admin = {_id: "mut-admin", admin: true, id: "mut-admin"} as unknown as User;
1195
+
1196
+ const registerAdminScope = (
1197
+ emitAudit?: AdminWindowMutationScope["emitAudit"]
1198
+ ): AdminWindowMutationScope => {
1199
+ const scope: AdminWindowMutationScope = {
1200
+ createPermissions: [Permissions.IsAdmin],
1201
+ deletePermissions: [Permissions.IsAdmin],
1202
+ emitAudit,
1203
+ modelName: MutStuffModel.modelName,
1204
+ permissions: {create: true, delete: true, update: true},
1205
+ stripMutationData: (data) => {
1206
+ const next = {...data};
1207
+ delete next.secret;
1208
+ return next;
1209
+ },
1210
+ updatePermissions: [Permissions.IsAdmin],
1211
+ };
1212
+ registerAdminWindowMutationScope(MutStuffModel.modelName, scope);
1213
+ return scope;
1214
+ };
1215
+
1216
+ beforeEach(() => {
1217
+ clearAdminWindowMutationScopes();
1218
+ registerMutStuff({config: {adminBroadcast: true, scope: {type: "owner"}}});
1219
+ });
1220
+
1221
+ afterEach(() => {
1222
+ clearAdminWindowMutationScopes();
1223
+ });
1224
+
1225
+ it("applies an admin window create with stripped data and emits the audit event", async () => {
1226
+ const events: AdminWindowMutationAuditEvent[] = [];
1227
+ registerAdminScope(({event}) => {
1228
+ events.push(event);
1229
+ });
1230
+ const ack = expectAck(
1231
+ await applySyncMutation({
1232
+ mutation: {
1233
+ collection: "mutStuff",
1234
+ data: {name: "admin created", ownerId: owner.id, secret: "strip me"},
1235
+ mutationId: "m-admin-create",
1236
+ mutationMode: "adminWindow",
1237
+ operation: "create",
1238
+ },
1239
+ user: admin,
1240
+ })
1241
+ );
1242
+ assert.equal(ack.seq, 1);
1243
+ assert.isUndefined(ack.warning);
1244
+ const saved = await MutStuffModel.findById(ack.id);
1245
+ assert.equal(saved?.name, "admin created");
1246
+ assert.equal(saved?.ownerId, owner.id);
1247
+ assert.lengthOf(events, 1);
1248
+ assert.equal(events[0].verb, "created");
1249
+ assert.equal(events[0].recordId, ack.id);
1250
+ });
1251
+
1252
+ it("still acks when the admin window audit hook throws after the write committed", async () => {
1253
+ registerAdminScope(() => {
1254
+ throw new Error("audit sink down");
1255
+ });
1256
+ const ack = expectAck(
1257
+ await applySyncMutation({
1258
+ mutation: {
1259
+ collection: "mutStuff",
1260
+ data: {name: "audited anyway", ownerId: owner.id},
1261
+ mutationId: "m-admin-audit-throw",
1262
+ mutationMode: "adminWindow",
1263
+ operation: "create",
1264
+ },
1265
+ user: admin,
1266
+ })
1267
+ );
1268
+ assert.isUndefined(ack.warning);
1269
+ assert.equal(await MutStuffModel.countDocuments({name: "audited anyway"}), 1);
1270
+ const row = await SyncMutation.findOne({mutationId: "m-admin-audit-throw"});
1271
+ assert.equal(row?.status, "applied");
1272
+ });
1273
+ });
1274
+ });
1275
+
1276
+ describe("docMatchesMutationData", () => {
1277
+ it("treats an absent mutation payload as matching any document", () => {
1278
+ assert.isTrue(docMatchesMutationData({name: "anything"}, undefined));
1003
1279
  });
1004
1280
  });
1005
1281