@terreno/api 57.2.0 → 57.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (472) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +23 -7
  3. package/dist/actions.js +19 -7
  4. package/dist/adminTypes.d.ts +7 -0
  5. package/dist/adminTypes.js +6 -1
  6. package/dist/api.d.ts +14 -0
  7. package/dist/api.js +111 -60
  8. package/dist/audit/auditApp.d.ts +30 -0
  9. package/dist/audit/auditApp.js +155 -0
  10. package/dist/audit/auditEventModel.d.ts +29 -0
  11. package/dist/audit/auditEventModel.js +102 -0
  12. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  13. package/dist/audit/cloudTasksEnqueue.js +162 -0
  14. package/dist/audit/diff.d.ts +10 -0
  15. package/dist/audit/diff.js +230 -0
  16. package/dist/audit/processQueue.d.ts +6 -0
  17. package/dist/audit/processQueue.js +101 -0
  18. package/dist/audit/rbacSink.d.ts +2 -0
  19. package/dist/audit/rbacSink.js +82 -0
  20. package/dist/audit/record.d.ts +56 -0
  21. package/dist/audit/record.js +373 -0
  22. package/dist/auth.d.ts +23 -10
  23. package/dist/auth.js +97 -32
  24. package/dist/authRecovery.d.ts +5 -0
  25. package/dist/authRecovery.js +350 -0
  26. package/dist/authTokens.d.ts +8 -0
  27. package/dist/authTokens.js +162 -0
  28. package/dist/betterAuth.d.ts +39 -0
  29. package/dist/betterAuthApp.d.ts +4 -0
  30. package/dist/betterAuthApp.js +26 -8
  31. package/dist/betterAuthSetup.d.ts +44 -2
  32. package/dist/betterAuthSetup.js +288 -18
  33. package/dist/collectionRegistry.d.ts +40 -0
  34. package/dist/collectionRegistry.js +97 -0
  35. package/dist/configurationApp.d.ts +11 -2
  36. package/dist/configurationApp.js +2 -4
  37. package/dist/docLoader.js +35 -6
  38. package/dist/expressServer.d.ts +26 -3
  39. package/dist/expressServer.js +79 -11
  40. package/dist/index.d.ts +42 -1
  41. package/dist/index.js +84 -2
  42. package/dist/mcp/auth.d.ts +1 -0
  43. package/dist/mcp/auth.js +47 -25
  44. package/dist/mcp/handlers.d.ts +1 -1
  45. package/dist/mcp/handlers.js +67 -233
  46. package/dist/mcp/query.d.ts +2 -15
  47. package/dist/mcp/query.js +8 -8
  48. package/dist/mcp/registry.d.ts +1 -5
  49. package/dist/mcp/registry.js +31 -20
  50. package/dist/mcp/schemaGenerator.d.ts +2 -7
  51. package/dist/mcp/schemaGenerator.js +41 -116
  52. package/dist/mcp/server.d.ts +1 -0
  53. package/dist/mcp/server.js +1 -0
  54. package/dist/mcp/serviceTokens.d.ts +16 -0
  55. package/dist/mcp/serviceTokens.js +345 -0
  56. package/dist/mcp/types.d.ts +2 -2
  57. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  58. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  59. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  60. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  61. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  62. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  63. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  64. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  65. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  66. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  67. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  68. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  69. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  70. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  71. package/dist/migrations/generate.d.ts +17 -0
  72. package/dist/migrations/generate.js +277 -0
  73. package/dist/migrations/load.d.ts +20 -0
  74. package/dist/migrations/load.js +236 -0
  75. package/dist/migrations/lock.d.ts +13 -0
  76. package/dist/migrations/lock.js +145 -0
  77. package/dist/migrations/runner.d.ts +42 -0
  78. package/dist/migrations/runner.js +503 -0
  79. package/dist/migrations/schemaCatalog.d.ts +44 -0
  80. package/dist/migrations/schemaCatalog.js +326 -0
  81. package/dist/migrations/types.d.ts +87 -0
  82. package/dist/migrations/types.js +7 -0
  83. package/dist/models/mcpServiceToken.d.ts +3 -0
  84. package/dist/models/mcpServiceToken.js +208 -0
  85. package/dist/models/notification.d.ts +2 -0
  86. package/dist/models/notification.js +62 -0
  87. package/dist/models/notificationPreference.d.ts +2 -0
  88. package/dist/models/notificationPreference.js +49 -0
  89. package/dist/notifications/notificationService.d.ts +40 -0
  90. package/dist/notifications/notificationService.js +323 -0
  91. package/dist/notifications/notificationsApp.d.ts +18 -0
  92. package/dist/notifications/notificationsApp.js +250 -0
  93. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  94. package/dist/notifications/notificationsBeforeSend.js +77 -0
  95. package/dist/openApi.d.ts +1 -7
  96. package/dist/openApi.js +7 -6
  97. package/dist/openApiBuilder.d.ts +19 -7
  98. package/dist/openApiBuilder.js +61 -8
  99. package/dist/openApiCompat.js +1 -1
  100. package/dist/openApiValidator.d.ts +13 -1
  101. package/dist/openApiValidator.js +200 -38
  102. package/dist/orgs/orgContext.d.ts +23 -0
  103. package/dist/orgs/orgContext.js +198 -0
  104. package/dist/orgs/orgPermissions.d.ts +4 -0
  105. package/dist/orgs/orgPermissions.js +77 -0
  106. package/dist/orgs/orgPlugin.d.ts +13 -0
  107. package/dist/orgs/orgPlugin.js +84 -0
  108. package/dist/orgs/organizationModel.d.ts +13 -0
  109. package/dist/orgs/organizationModel.js +301 -0
  110. package/dist/orgs/organizationSettings.d.ts +19 -0
  111. package/dist/orgs/organizationSettings.js +120 -0
  112. package/dist/orgs/orgsApp.d.ts +28 -0
  113. package/dist/orgs/orgsApp.js +678 -0
  114. package/dist/permissions.d.ts +7 -13
  115. package/dist/permissions.js +8 -31
  116. package/dist/plugins.d.ts +14 -1
  117. package/dist/plugins.js +17 -6
  118. package/dist/populate.d.ts +2 -2
  119. package/dist/populate.js +47 -42
  120. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  121. package/dist/rateLimit/applyTrustProxy.js +17 -0
  122. package/dist/rateLimit/createStore.d.ts +2 -0
  123. package/dist/rateLimit/createStore.js +28 -0
  124. package/dist/rateLimit/memoryStore.d.ts +2 -0
  125. package/dist/rateLimit/memoryStore.js +108 -0
  126. package/dist/rateLimit/middleware.d.ts +3 -0
  127. package/dist/rateLimit/middleware.js +109 -0
  128. package/dist/rateLimit/mongoStore.d.ts +4 -0
  129. package/dist/rateLimit/mongoStore.js +123 -0
  130. package/dist/rateLimit/policies.d.ts +10 -0
  131. package/dist/rateLimit/policies.js +149 -0
  132. package/dist/rateLimit/redisStore.d.ts +4 -0
  133. package/dist/rateLimit/redisStore.js +156 -0
  134. package/dist/rateLimit/types.d.ts +54 -0
  135. package/dist/rateLimit/types.js +9 -0
  136. package/dist/rbac/access.js +35 -14
  137. package/dist/rbac/assertAllowed.d.ts +9 -0
  138. package/dist/rbac/assertAllowed.js +182 -0
  139. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  140. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  141. package/dist/rbac/modelRouterAccess.d.ts +4 -0
  142. package/dist/rbac/modelRouterAccess.js +11 -4
  143. package/dist/rbac/permissionUtils.js +3 -2
  144. package/dist/rbac/resolve.js +65 -35
  145. package/dist/rbac/roleModel.d.ts +2 -5
  146. package/dist/rbac/roleModel.js +18 -4
  147. package/dist/rbac/routes.js +15 -6
  148. package/dist/rbac/statements.d.ts +10 -1
  149. package/dist/rbac/statements.js +19 -2
  150. package/dist/rbac/types.d.ts +5 -0
  151. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  152. package/dist/realtime/changeStreamWatcher.js +110 -64
  153. package/dist/realtime/deprecation.d.ts +13 -0
  154. package/dist/realtime/deprecation.js +33 -0
  155. package/dist/realtime/realtimeApp.d.ts +2 -1
  156. package/dist/realtime/realtimeApp.js +11 -11
  157. package/dist/realtime/registry.d.ts +0 -31
  158. package/dist/realtime/registry.js +44 -31
  159. package/dist/realtime/socketAuth.d.ts +5 -5
  160. package/dist/realtime/socketAuth.js +11 -1
  161. package/dist/realtime/socketUser.d.ts +5 -1
  162. package/dist/realtime/types.d.ts +14 -4
  163. package/dist/schemaMetadata.d.ts +56 -0
  164. package/dist/schemaMetadata.js +524 -0
  165. package/dist/seedRunner.d.ts +88 -0
  166. package/dist/seedRunner.js +627 -0
  167. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  168. package/dist/sync/adminBroadcastScope.js +194 -0
  169. package/dist/sync/adminWindowAccess.d.ts +13 -0
  170. package/dist/sync/adminWindowAccess.js +96 -0
  171. package/dist/sync/adminWindowMutation.d.ts +88 -0
  172. package/dist/sync/adminWindowMutation.js +247 -0
  173. package/dist/sync/executors.d.ts +19 -3
  174. package/dist/sync/executors.js +194 -165
  175. package/dist/sync/loadHarness.js +28 -19
  176. package/dist/sync/models.js +26 -24
  177. package/dist/sync/mutationHandler.d.ts +14 -2
  178. package/dist/sync/mutationHandler.js +201 -76
  179. package/dist/sync/registrationSideEffects.d.ts +35 -0
  180. package/dist/sync/registrationSideEffects.js +151 -0
  181. package/dist/sync/registry.d.ts +2 -52
  182. package/dist/sync/registry.js +42 -187
  183. package/dist/sync/routes.d.ts +13 -0
  184. package/dist/sync/routes.js +116 -58
  185. package/dist/sync/scripts/compactTombstones.js +0 -2
  186. package/dist/sync/socketHandlers.d.ts +8 -2
  187. package/dist/sync/socketHandlers.js +144 -50
  188. package/dist/sync/streams.d.ts +2 -0
  189. package/dist/sync/streams.js +7 -1
  190. package/dist/sync/syncApp.d.ts +4 -3
  191. package/dist/sync/syncApp.js +5 -4
  192. package/dist/sync/syncBatch.d.ts +5 -2
  193. package/dist/sync/syncBatch.js +7 -6
  194. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  195. package/dist/sync/syncSeqPlugin.js +20 -16
  196. package/dist/sync/types.d.ts +18 -0
  197. package/dist/terrenoApp.d.ts +48 -5
  198. package/dist/terrenoApp.js +157 -72
  199. package/dist/tests/createTestData.d.ts +1 -3
  200. package/dist/tests/createTestData.js +3 -5
  201. package/dist/tests/models.d.ts +3 -0
  202. package/dist/tests/models.js +15 -2
  203. package/dist/tests/testHelper.d.ts +0 -5
  204. package/dist/tests/testHelper.js +2 -9
  205. package/dist/types/authToken.d.ts +33 -0
  206. package/dist/types/authToken.js +2 -0
  207. package/dist/types/mcpServiceToken.d.ts +41 -0
  208. package/dist/types/mcpServiceToken.js +2 -0
  209. package/dist/types/membership.d.ts +23 -0
  210. package/dist/types/membership.js +2 -0
  211. package/dist/types/notification.d.ts +28 -0
  212. package/dist/types/notification.js +2 -0
  213. package/dist/types/notificationPreference.d.ts +20 -0
  214. package/dist/types/notificationPreference.js +2 -0
  215. package/dist/types/organization.d.ts +36 -0
  216. package/dist/types/organization.js +2 -0
  217. package/dist/webhooks/headerValue.d.ts +2 -0
  218. package/dist/webhooks/headerValue.js +14 -0
  219. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  220. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  221. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  222. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  223. package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
  224. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  225. package/dist/webhooks/rawBody.d.ts +15 -0
  226. package/dist/webhooks/rawBody.js +23 -0
  227. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  228. package/dist/webhooks/timingSafeEqual.js +17 -0
  229. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  230. package/dist/webhooks/verifiers/hmac.js +49 -0
  231. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  232. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  233. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  234. package/dist/webhooks/verifiers/stripe.js +99 -0
  235. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  236. package/dist/webhooks/verifiers/twilio.js +112 -0
  237. package/dist/webhooks/webhooksApp.d.ts +33 -0
  238. package/dist/webhooks/webhooksApp.js +195 -0
  239. package/package.json +32 -27
  240. package/src/__snapshots__/openApi.test.ts.snap +444 -36
  241. package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
  242. package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
  243. package/src/actions.ts +20 -13
  244. package/src/adminModelRouter.test.ts +133 -0
  245. package/src/adminTypes.ts +8 -0
  246. package/src/api.arrayOperations.test.ts +43 -31
  247. package/src/api.hooks.test.ts +38 -29
  248. package/src/api.query.test.ts +31 -31
  249. package/src/api.test.ts +133 -97
  250. package/src/api.ts +84 -27
  251. package/src/audit/auditApp.test.ts +243 -0
  252. package/src/audit/auditApp.ts +139 -0
  253. package/src/audit/auditEventModel.ts +156 -0
  254. package/src/audit/auditRouter.test.ts +456 -0
  255. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  256. package/src/audit/cloudTasksEnqueue.ts +104 -0
  257. package/src/audit/diff.ts +163 -0
  258. package/src/audit/processQueue.ts +69 -0
  259. package/src/audit/rbacSink.test.ts +86 -0
  260. package/src/audit/rbacSink.ts +42 -0
  261. package/src/audit/record.test.ts +402 -0
  262. package/src/audit/record.ts +328 -0
  263. package/src/auth.test.ts +108 -52
  264. package/src/auth.ts +98 -29
  265. package/src/authRecovery.test.ts +281 -0
  266. package/src/authRecovery.ts +279 -0
  267. package/src/authTokens.test.ts +94 -0
  268. package/src/authTokens.ts +118 -0
  269. package/src/authVerification.test.ts +293 -0
  270. package/src/betterAuth.ts +31 -0
  271. package/src/betterAuthApp.test.ts +1 -0
  272. package/src/betterAuthApp.ts +27 -9
  273. package/src/betterAuthSetup.test.ts +595 -38
  274. package/src/betterAuthSetup.ts +261 -5
  275. package/src/collectionRegistry.test.ts +164 -0
  276. package/src/collectionRegistry.ts +135 -0
  277. package/src/configurationApp.ts +13 -7
  278. package/src/docLoader.test.ts +45 -1
  279. package/src/docLoader.ts +37 -6
  280. package/src/express.d.ts +3 -0
  281. package/src/expressServer.test.ts +180 -68
  282. package/src/expressServer.ts +75 -19
  283. package/src/githubAuth.test.ts +60 -55
  284. package/src/index.ts +127 -0
  285. package/src/mcp/auth.test.ts +47 -0
  286. package/src/mcp/auth.ts +32 -11
  287. package/src/mcp/handlers.test.ts +275 -0
  288. package/src/mcp/handlers.ts +45 -172
  289. package/src/mcp/integration.test.ts +59 -9
  290. package/src/mcp/query.ts +5 -7
  291. package/src/mcp/registry.ts +29 -20
  292. package/src/mcp/schemaGenerator.test.ts +8 -0
  293. package/src/mcp/schemaGenerator.ts +49 -131
  294. package/src/mcp/server.ts +2 -0
  295. package/src/mcp/serviceTokens.test.ts +330 -0
  296. package/src/mcp/serviceTokens.ts +307 -0
  297. package/src/mcp/toolGenerator.test.ts +82 -1
  298. package/src/mcp/types.ts +2 -6
  299. package/src/migrations/cli.test.ts +376 -0
  300. package/src/migrations/cli.ts +283 -0
  301. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  302. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  303. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  304. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  305. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  306. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  307. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  308. package/src/migrations/generate.test.ts +333 -0
  309. package/src/migrations/generate.ts +216 -0
  310. package/src/migrations/load.test.ts +103 -0
  311. package/src/migrations/load.ts +124 -0
  312. package/src/migrations/lock.test.ts +133 -0
  313. package/src/migrations/lock.ts +118 -0
  314. package/src/migrations/runner.test.ts +504 -0
  315. package/src/migrations/runner.ts +358 -0
  316. package/src/migrations/schemaCatalog.test.ts +159 -0
  317. package/src/migrations/schemaCatalog.ts +262 -0
  318. package/src/migrations/types.ts +94 -0
  319. package/src/models/mcpServiceToken.test.ts +129 -0
  320. package/src/models/mcpServiceToken.ts +158 -0
  321. package/src/models/notification.ts +68 -0
  322. package/src/models/notificationPreference.ts +62 -0
  323. package/src/notifications/notificationService.ts +254 -0
  324. package/src/notifications/notificationsApp.test.ts +505 -0
  325. package/src/notifications/notificationsApp.ts +200 -0
  326. package/src/notifications/notificationsBeforeSend.ts +51 -0
  327. package/src/openApi.test.ts +80 -65
  328. package/src/openApi.ts +2 -1
  329. package/src/openApiBuilder.test.ts +95 -7
  330. package/src/openApiBuilder.ts +60 -12
  331. package/src/openApiCompat.ts +1 -1
  332. package/src/openApiValidator.test.ts +270 -56
  333. package/src/openApiValidator.ts +219 -36
  334. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  335. package/src/orgs/orgContext.test.ts +259 -0
  336. package/src/orgs/orgContext.ts +151 -0
  337. package/src/orgs/orgPermissions.test.ts +105 -0
  338. package/src/orgs/orgPermissions.ts +40 -0
  339. package/src/orgs/orgPlugin.test.ts +130 -0
  340. package/src/orgs/orgPlugin.ts +70 -0
  341. package/src/orgs/orgRbac.test.ts +267 -0
  342. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  343. package/src/orgs/organizationModel.test.ts +205 -0
  344. package/src/orgs/organizationModel.ts +257 -0
  345. package/src/orgs/organizationSettings.test.ts +113 -0
  346. package/src/orgs/organizationSettings.ts +126 -0
  347. package/src/orgs/orgsApp.test.ts +382 -0
  348. package/src/orgs/orgsApp.ts +563 -0
  349. package/src/permissions.test.ts +62 -36
  350. package/src/permissions.ts +8 -30
  351. package/src/plugins.test.ts +14 -0
  352. package/src/plugins.ts +34 -9
  353. package/src/populate.test.ts +34 -0
  354. package/src/populate.ts +40 -29
  355. package/src/rateLimit/applyTrustProxy.ts +17 -0
  356. package/src/rateLimit/createStore.ts +25 -0
  357. package/src/rateLimit/memoryStore.ts +40 -0
  358. package/src/rateLimit/middleware.ts +79 -0
  359. package/src/rateLimit/mongoStore.test.ts +80 -0
  360. package/src/rateLimit/mongoStore.ts +77 -0
  361. package/src/rateLimit/policies.ts +130 -0
  362. package/src/rateLimit/rateLimit.test.ts +328 -0
  363. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  364. package/src/rateLimit/redisStore.test.ts +114 -0
  365. package/src/rateLimit/redisStore.ts +86 -0
  366. package/src/rateLimit/types.ts +64 -0
  367. package/src/rbac/access.ts +16 -4
  368. package/src/rbac/assertAllowed.test.ts +325 -0
  369. package/src/rbac/assertAllowed.ts +157 -0
  370. package/src/rbac/backfillAdmins.test.ts +124 -0
  371. package/src/rbac/fieldViews.test.ts +89 -0
  372. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  373. package/src/rbac/modelRouterAccess.test.ts +126 -0
  374. package/src/rbac/modelRouterAccess.ts +8 -2
  375. package/src/rbac/permissionUtils.test.ts +26 -5
  376. package/src/rbac/permissionUtils.ts +3 -2
  377. package/src/rbac/realtimeAccess.test.ts +109 -1
  378. package/src/rbac/resolve.test.ts +34 -2
  379. package/src/rbac/resolve.ts +31 -11
  380. package/src/rbac/roleManager.test.ts +169 -0
  381. package/src/rbac/roleModel.test.ts +34 -1
  382. package/src/rbac/roleModel.ts +17 -1
  383. package/src/rbac/routes.test.ts +233 -0
  384. package/src/rbac/routes.ts +16 -6
  385. package/src/rbac/statements.test.ts +19 -0
  386. package/src/rbac/statements.ts +19 -1
  387. package/src/rbac/types.ts +5 -0
  388. package/src/realtime/changeStreamWatcher.ts +73 -33
  389. package/src/realtime/deprecation.test.ts +60 -0
  390. package/src/realtime/deprecation.ts +33 -0
  391. package/src/realtime/realtime.test.ts +365 -189
  392. package/src/realtime/realtimeApp.ts +11 -11
  393. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  394. package/src/realtime/registry.ts +48 -42
  395. package/src/realtime/sessionRevalidation.test.ts +57 -44
  396. package/src/realtime/socketAuth.test.ts +75 -23
  397. package/src/realtime/socketAuth.ts +17 -6
  398. package/src/realtime/socketUser.ts +5 -3
  399. package/src/realtime/types.ts +14 -4
  400. package/src/schemaMetadata.test.ts +419 -0
  401. package/src/schemaMetadata.ts +593 -0
  402. package/src/scrubAdminFields.test.ts +105 -0
  403. package/src/seedRunner.test.ts +591 -0
  404. package/src/seedRunner.ts +464 -0
  405. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  406. package/src/sync/adminBroadcastScope.test.ts +155 -0
  407. package/src/sync/adminBroadcastScope.ts +123 -0
  408. package/src/sync/adminWindowAccess.test.ts +57 -0
  409. package/src/sync/adminWindowAccess.ts +32 -0
  410. package/src/sync/adminWindowMutation.test.ts +450 -0
  411. package/src/sync/adminWindowMutation.ts +283 -0
  412. package/src/sync/docMatchesMutationData.test.ts +16 -0
  413. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  414. package/src/sync/executors.test.ts +40 -0
  415. package/src/sync/executors.ts +57 -18
  416. package/src/sync/integration.test.ts +15 -7
  417. package/src/sync/loadHarness.ts +28 -19
  418. package/src/sync/models.ts +32 -18
  419. package/src/sync/mutationHandler.test.ts +293 -17
  420. package/src/sync/mutationHandler.ts +180 -36
  421. package/src/sync/registrationSideEffects.test.ts +126 -0
  422. package/src/sync/registrationSideEffects.ts +131 -0
  423. package/src/sync/registry.ts +49 -171
  424. package/src/sync/routes.ts +55 -10
  425. package/src/sync/scripts/compactTombstones.ts +0 -2
  426. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  427. package/src/sync/socketHandlers.ts +154 -58
  428. package/src/sync/streams.ts +6 -0
  429. package/src/sync/sync.test.ts +28 -25
  430. package/src/sync/syncApp.ts +5 -4
  431. package/src/sync/syncBatch.ts +10 -4
  432. package/src/sync/syncFrontier.test.ts +17 -15
  433. package/src/sync/syncPhaseC.test.ts +54 -43
  434. package/src/sync/syncRoutes.test.ts +347 -38
  435. package/src/sync/syncSeqPlugin.ts +66 -44
  436. package/src/sync/syncSocket.test.ts +341 -81
  437. package/src/sync/types.ts +20 -0
  438. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  439. package/src/terrenoApp.migrations.test.ts +114 -0
  440. package/src/terrenoApp.test.ts +41 -0
  441. package/src/terrenoApp.ts +181 -46
  442. package/src/tests/createTestData.ts +2 -2
  443. package/src/tests/models.ts +24 -3
  444. package/src/tests/testHelper.ts +1 -7
  445. package/src/types/authToken.ts +41 -0
  446. package/src/types/mcpServiceToken.ts +48 -0
  447. package/src/types/membership.ts +48 -0
  448. package/src/types/notification.ts +34 -0
  449. package/src/types/notificationPreference.ts +28 -0
  450. package/src/types/organization.ts +49 -0
  451. package/src/webhooks/headerValue.test.ts +22 -0
  452. package/src/webhooks/headerValue.ts +12 -0
  453. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  454. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  455. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  456. package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
  457. package/src/webhooks/rawBody.test.ts +107 -0
  458. package/src/webhooks/rawBody.ts +24 -0
  459. package/src/webhooks/timingSafeEqual.ts +16 -0
  460. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  461. package/src/webhooks/verifiers/hmac.ts +54 -0
  462. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  463. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  464. package/src/webhooks/verifiers/stripe.ts +67 -0
  465. package/src/webhooks/verifiers/twilio.ts +69 -0
  466. package/src/webhooks/webhooksApp.test.ts +221 -0
  467. package/src/webhooks/webhooksApp.ts +144 -0
  468. package/tsconfig.json +1 -1
  469. package/tsconfig.typedoc.json +2 -1
  470. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  471. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  472. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -0,0 +1,464 @@
1
+ import isEqual from "lodash/isEqual";
2
+
3
+ import type {UserModel} from "./auth";
4
+ import type {BetterAuthUser} from "./betterAuth";
5
+ import {type BetterAuthInstance, syncBetterAuthUser} from "./betterAuthSetup";
6
+ import {APIError, errorMessage} from "./errors";
7
+ import {logger, type ScopedLogger} from "./logger";
8
+
9
+ export type SeedMode = "reset" | "sync";
10
+ export type SeedChange = "created" | "deleted" | "unchanged" | "updated";
11
+
12
+ interface SeedDocument {
13
+ get: (path: string) => unknown;
14
+ save: () => Promise<unknown>;
15
+ set: (pathOrValues: object, value?: unknown) => unknown;
16
+ }
17
+
18
+ /** The small structural subset of a Mongoose model used by seed helpers. */
19
+ export interface SeedModel {
20
+ new (): SeedDocument;
21
+ modelName: string;
22
+ countDocuments: (filter: Record<string, unknown>) => PromiseLike<number>;
23
+ deleteMany: (filter: Record<string, unknown>) => PromiseLike<unknown>;
24
+ find: (filter: Record<string, unknown>) => {
25
+ limit: (limit: number) => PromiseLike<SeedDocument[]>;
26
+ };
27
+ }
28
+
29
+ export interface SeedChangeResult {
30
+ change: SeedChange;
31
+ count: number;
32
+ key: string;
33
+ model: string;
34
+ }
35
+
36
+ export interface SeedContext {
37
+ dryRun: boolean;
38
+ mode: SeedMode;
39
+ changes: SeedChangeResult[];
40
+ deleteMany: (model: SeedModel, filter?: Record<string, unknown>) => Promise<SeedChangeResult>;
41
+ upsert: <TValues extends object>(
42
+ model: SeedModel,
43
+ key: Record<string, unknown>,
44
+ values: TValues
45
+ ) => Promise<SeedChangeResult>;
46
+ }
47
+
48
+ export interface SeedStep {
49
+ name: string;
50
+ description?: string;
51
+ dependsOn?: string[];
52
+ reset?: (context: SeedContext) => Promise<void>;
53
+ run: (context: SeedContext) => Promise<void>;
54
+ }
55
+
56
+ export interface SeedRunOptions {
57
+ name: string;
58
+ steps: SeedStep[];
59
+ mode?: SeedMode;
60
+ dryRun?: boolean;
61
+ only?: string[];
62
+ force?: boolean;
63
+ allowProductionReset?: boolean | (() => boolean | Promise<boolean>);
64
+ connect?: () => Promise<void>;
65
+ disconnect?: () => Promise<void>;
66
+ log?: ScopedLogger;
67
+ }
68
+
69
+ export interface SeedRunResult {
70
+ changes: SeedChangeResult[];
71
+ dryRun: boolean;
72
+ mode: SeedMode;
73
+ name: string;
74
+ steps: string[];
75
+ summary: Record<SeedChange, number>;
76
+ success: boolean;
77
+ }
78
+
79
+ export interface SeedCliOptions extends Omit<SeedRunOptions, "dryRun" | "force" | "mode" | "only"> {
80
+ argv?: string[];
81
+ }
82
+
83
+ export interface SeedCliResult {
84
+ exitCode: number;
85
+ help?: string;
86
+ result?: SeedRunResult;
87
+ }
88
+
89
+ export interface BetterAuthSeedUser {
90
+ email: string;
91
+ name: string;
92
+ password: string;
93
+ }
94
+
95
+ const EMPTY_SUMMARY: Record<SeedChange, number> = {
96
+ created: 0,
97
+ deleted: 0,
98
+ unchanged: 0,
99
+ updated: 0,
100
+ };
101
+
102
+ const formatKey = (key: Record<string, unknown>): string => {
103
+ return JSON.stringify(key);
104
+ };
105
+
106
+ const toComparableSeedValue = (value: unknown): unknown => {
107
+ if (value == null) {
108
+ return value;
109
+ }
110
+ if (value instanceof Date) {
111
+ return value.toISOString();
112
+ }
113
+ if (value instanceof Map) {
114
+ return Object.fromEntries(
115
+ [...value.entries()].map(([entryKey, nested]) => [
116
+ String(entryKey),
117
+ toComparableSeedValue(nested),
118
+ ])
119
+ );
120
+ }
121
+ if (typeof (value as {toObject?: () => unknown}).toObject === "function") {
122
+ return toComparableSeedValue((value as {toObject: () => unknown}).toObject());
123
+ }
124
+ if (Array.isArray(value)) {
125
+ return value.map(toComparableSeedValue);
126
+ }
127
+ if (typeof value === "object") {
128
+ const next: Record<string, unknown> = {};
129
+ for (const [field, nested] of Object.entries(value as Record<string, unknown>)) {
130
+ if (field === "_id") {
131
+ continue;
132
+ }
133
+ next[field] = toComparableSeedValue(nested);
134
+ }
135
+ return next;
136
+ }
137
+ return value;
138
+ };
139
+
140
+ const seedValuesEqual = (currentValues: unknown, nextValues: unknown): boolean => {
141
+ return isEqual(toComparableSeedValue(currentValues), toComparableSeedValue(nextValues));
142
+ };
143
+
144
+ /**
145
+ * Create a Better Auth credential user when missing, verify existing credentials,
146
+ * and reconcile the corresponding application user document.
147
+ */
148
+ export const seedBetterAuthUser = async ({
149
+ auth,
150
+ user,
151
+ userModel,
152
+ }: {
153
+ auth: BetterAuthInstance;
154
+ user: BetterAuthSeedUser;
155
+ userModel: UserModel;
156
+ }): Promise<Awaited<ReturnType<typeof syncBetterAuthUser>>> => {
157
+ let authUser: BetterAuthUser | undefined;
158
+ try {
159
+ const result = await auth.api.signUpEmail({body: user});
160
+ authUser = result.user as BetterAuthUser;
161
+ } catch {
162
+ const result = await auth.api.signInEmail({
163
+ body: {email: user.email, password: user.password},
164
+ });
165
+ authUser = result.user as BetterAuthUser;
166
+ }
167
+ if (!authUser) {
168
+ throw new APIError({
169
+ detail: user.email,
170
+ status: 500,
171
+ title: "Better Auth seed returned no user",
172
+ });
173
+ }
174
+ return syncBetterAuthUser(userModel, authUser);
175
+ };
176
+
177
+ const selectSteps = (steps: SeedStep[], only?: string[]): SeedStep[] => {
178
+ const stepByName = new Map(steps.map((step) => [step.name, step]));
179
+ if (stepByName.size !== steps.length) {
180
+ throw new APIError({status: 500, title: "Seed step names must be unique"});
181
+ }
182
+ if (!only || only.length === 0) {
183
+ return steps;
184
+ }
185
+
186
+ const selectedNames = new Set<string>();
187
+ const include = (name: string, ancestry: string[] = []): void => {
188
+ const step = stepByName.get(name);
189
+ if (!step) {
190
+ throw new APIError({
191
+ detail: `Unknown seed step "${name}". Available steps: ${steps.map((item) => item.name).join(", ")}`,
192
+ status: 400,
193
+ title: "Unknown seed step",
194
+ });
195
+ }
196
+ if (ancestry.includes(name)) {
197
+ throw new APIError({
198
+ detail: [...ancestry, name].join(" -> "),
199
+ status: 500,
200
+ title: "Seed step dependency cycle",
201
+ });
202
+ }
203
+ if (selectedNames.has(name)) {
204
+ return;
205
+ }
206
+ for (const dependency of step.dependsOn ?? []) {
207
+ include(dependency, [...ancestry, name]);
208
+ }
209
+ selectedNames.add(name);
210
+ };
211
+
212
+ for (const name of only) {
213
+ include(name);
214
+ }
215
+ return steps.filter((step) => selectedNames.has(step.name));
216
+ };
217
+
218
+ const isProductionResetAllowed = async ({
219
+ allowProductionReset,
220
+ force,
221
+ }: Pick<SeedRunOptions, "allowProductionReset" | "force">): Promise<boolean> => {
222
+ if (process.env.NODE_ENV !== "production") {
223
+ return true;
224
+ }
225
+ if (!force || allowProductionReset === undefined) {
226
+ return false;
227
+ }
228
+ return typeof allowProductionReset === "function"
229
+ ? await allowProductionReset()
230
+ : allowProductionReset;
231
+ };
232
+
233
+ const makeContext = ({dryRun, mode}: {dryRun: boolean; mode: SeedMode}): SeedContext => {
234
+ const changes: SeedChangeResult[] = [];
235
+ const record = (change: SeedChangeResult): SeedChangeResult => {
236
+ changes.push(change);
237
+ return change;
238
+ };
239
+
240
+ return {
241
+ changes,
242
+ deleteMany: async (
243
+ model: SeedModel,
244
+ filter: Record<string, unknown> = {}
245
+ ): Promise<SeedChangeResult> => {
246
+ const count = await model.countDocuments(filter);
247
+ if (!dryRun && count > 0) {
248
+ await model.deleteMany(filter);
249
+ }
250
+ return record({
251
+ change: count > 0 ? "deleted" : "unchanged",
252
+ count,
253
+ key: formatKey(filter),
254
+ model: model.modelName,
255
+ });
256
+ },
257
+ dryRun,
258
+ mode,
259
+ upsert: async <TValues extends object>(
260
+ model: SeedModel,
261
+ key: Record<string, unknown>,
262
+ values: TValues
263
+ ): Promise<SeedChangeResult> => {
264
+ const findByKey = async (filter: Record<string, unknown>): Promise<SeedDocument[]> => {
265
+ return [...(await model.find(filter).limit(100))];
266
+ };
267
+
268
+ let documents = await findByKey(key);
269
+ if (documents.length === 0) {
270
+ documents = await findByKey({...key, deleted: true});
271
+ }
272
+
273
+ const extras = documents.slice(1);
274
+ if (extras.length > 0) {
275
+ if (!dryRun) {
276
+ for (const extra of extras) {
277
+ const extraDeleted = extra.get("deleted");
278
+ if (extraDeleted === true || extraDeleted === false) {
279
+ extra.set({deleted: true});
280
+ await extra.save();
281
+ } else {
282
+ await model.deleteMany({_id: extra.get("_id")});
283
+ }
284
+ }
285
+ }
286
+ record({
287
+ change: "deleted",
288
+ count: extras.length,
289
+ key: formatKey(key),
290
+ model: model.modelName,
291
+ });
292
+ }
293
+
294
+ const document = documents[0];
295
+ if (!document) {
296
+ if (!dryRun) {
297
+ const createdDocument = new model();
298
+ createdDocument.set(key);
299
+ createdDocument.set(values);
300
+ await createdDocument.save();
301
+ }
302
+ return record({
303
+ change: "created",
304
+ count: 1,
305
+ key: formatKey(key),
306
+ model: model.modelName,
307
+ });
308
+ }
309
+
310
+ const isDeleted = document.get("deleted") === true;
311
+ const currentValues = Object.fromEntries(
312
+ Object.keys(values).map((field) => [field, document.get(field)])
313
+ );
314
+ if (!isDeleted && seedValuesEqual(currentValues, values)) {
315
+ return record({
316
+ change: "unchanged",
317
+ count: 1,
318
+ key: formatKey(key),
319
+ model: model.modelName,
320
+ });
321
+ }
322
+ if (!dryRun) {
323
+ document.set(isDeleted ? {...values, deleted: false} : values);
324
+ await document.save();
325
+ }
326
+ return record({
327
+ change: "updated",
328
+ count: 1,
329
+ key: formatKey(key),
330
+ model: model.modelName,
331
+ });
332
+ },
333
+ };
334
+ };
335
+
336
+ const summarizeChanges = (changes: SeedChangeResult[]): Record<SeedChange, number> => {
337
+ const summary = {...EMPTY_SUMMARY};
338
+ for (const item of changes) {
339
+ summary[item.change] += item.count;
340
+ }
341
+ return summary;
342
+ };
343
+
344
+ /** Run an ordered, idempotent seed plan in sync or reset-and-reseed mode. */
345
+ export const runSeeds = async (options: SeedRunOptions): Promise<SeedRunResult> => {
346
+ const mode = options.mode ?? "sync";
347
+ const dryRun = options.dryRun ?? false;
348
+ const log = options.log ?? logger;
349
+ const steps = selectSteps(options.steps, options.only);
350
+ if (
351
+ mode === "reset" &&
352
+ !(await isProductionResetAllowed({
353
+ allowProductionReset: options.allowProductionReset,
354
+ force: options.force,
355
+ }))
356
+ ) {
357
+ throw new APIError({
358
+ detail:
359
+ "Production resets require force: true and allowProductionReset: true (or an approving callback).",
360
+ status: 403,
361
+ title: "Production seed reset is disabled",
362
+ });
363
+ }
364
+
365
+ const context = makeContext({dryRun, mode});
366
+ await options.connect?.();
367
+ try {
368
+ log.info(
369
+ `${dryRun ? "Previewing" : "Running"} ${options.name} seeds in ${mode} mode (${steps.length} step(s))`
370
+ );
371
+ if (mode === "reset") {
372
+ for (const step of [...steps].reverse()) {
373
+ await step.reset?.(context);
374
+ }
375
+ }
376
+ for (const step of steps) {
377
+ log.info(`Seed step: ${step.name}`);
378
+ await step.run(context);
379
+ }
380
+ const summary = summarizeChanges(context.changes);
381
+ log.info(
382
+ `Seed complete: created=${summary.created} updated=${summary.updated} deleted=${summary.deleted} unchanged=${summary.unchanged}`
383
+ );
384
+ return {
385
+ changes: context.changes,
386
+ dryRun,
387
+ mode,
388
+ name: options.name,
389
+ steps: steps.map((step) => step.name),
390
+ success: true,
391
+ summary,
392
+ };
393
+ } finally {
394
+ await options.disconnect?.();
395
+ }
396
+ };
397
+
398
+ const seedHelp = (name: string, steps: SeedStep[]): string => {
399
+ return [
400
+ `Usage: ${name} [--reset] [--dry-run] [--only <step>] [--force]`,
401
+ "",
402
+ "Modes:",
403
+ " (default) Sync code-defined seed data into the database",
404
+ " --reset Run step reset handlers in reverse order, then reseed",
405
+ "",
406
+ "Options:",
407
+ " --dry-run Report changes without writing",
408
+ " --only Run one step plus its dependencies; may be repeated",
409
+ " --force Required with an explicitly allowed production reset",
410
+ " --help Show this help",
411
+ "",
412
+ `Steps: ${steps.map((step) => step.name).join(", ")}`,
413
+ ].join("\n");
414
+ };
415
+
416
+ const readRepeatedOption = (argv: string[], name: string): string[] => {
417
+ const values: string[] = [];
418
+ for (let index = 0; index < argv.length; index++) {
419
+ const token = argv[index];
420
+ if (token === `--${name}` && argv[index + 1]) {
421
+ values.push(argv[index + 1]);
422
+ index++;
423
+ continue;
424
+ }
425
+ if (token.startsWith(`--${name}=`)) {
426
+ values.push(token.slice(name.length + 3));
427
+ }
428
+ }
429
+ return values;
430
+ };
431
+
432
+ /** CLI adapter for runSeeds. It returns an exit code and never terminates the process. */
433
+ export const runSeedCli = async (options: SeedCliOptions): Promise<SeedCliResult> => {
434
+ const argv = options.argv ?? process.argv.slice(2);
435
+ const help = seedHelp(options.name, options.steps);
436
+ if (argv.includes("--help") || argv.includes("-h")) {
437
+ return {exitCode: 0, help};
438
+ }
439
+ const knownOptions = new Set(["--dry-run", "--force", "--help", "-h", "--only", "--reset"]);
440
+ const unknown = argv.filter(
441
+ (token, index) =>
442
+ token.startsWith("-") &&
443
+ !knownOptions.has(token) &&
444
+ !token.startsWith("--only=") &&
445
+ argv[index - 1] !== "--only"
446
+ );
447
+ if (unknown.length > 0) {
448
+ return {exitCode: 2, help: `Unknown option(s): ${unknown.join(", ")}\n\n${help}`};
449
+ }
450
+
451
+ try {
452
+ const result = await runSeeds({
453
+ ...options,
454
+ dryRun: argv.includes("--dry-run"),
455
+ force: argv.includes("--force"),
456
+ mode: argv.includes("--reset") ? "reset" : "sync",
457
+ only: readRepeatedOption(argv, "only"),
458
+ });
459
+ return {exitCode: 0, result};
460
+ } catch (error: unknown) {
461
+ (options.log ?? logger).error(`Seed failed: ${errorMessage(error)}`);
462
+ return {exitCode: 1};
463
+ }
464
+ };
@@ -0,0 +1,96 @@
1
+ import {beforeEach, describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+ import {model, Schema} from "mongoose";
4
+
5
+ import {Permissions} from "../permissions";
6
+ import {createdUpdatedPlugin, type IsDeleted, isDeletedPlugin} from "../plugins";
7
+ import {clearSyncRegistry, getSyncRegistry, registerSync} from "./registry";
8
+ import {syncPlugin} from "./syncSeqPlugin";
9
+
10
+ interface AdminBroadcastTodo extends IsDeleted {
11
+ _id: string;
12
+ ownerId: string;
13
+ title: string;
14
+ _syncSeq?: number;
15
+ }
16
+
17
+ const adminBroadcastTodoSchema = new Schema<AdminBroadcastTodo>({
18
+ ownerId: {description: "The owner", type: String},
19
+ title: {description: "The title", required: true, type: String},
20
+ });
21
+ adminBroadcastTodoSchema.plugin(isDeletedPlugin);
22
+ adminBroadcastTodoSchema.plugin(createdUpdatedPlugin);
23
+ adminBroadcastTodoSchema.plugin(syncPlugin);
24
+ const AdminBroadcastTodoModel = model<AdminBroadcastTodo>(
25
+ "AdminBroadcastTodo",
26
+ adminBroadcastTodoSchema
27
+ );
28
+
29
+ const syncOptions = {
30
+ permissions: {
31
+ create: [Permissions.IsAuthenticated],
32
+ delete: [Permissions.IsAuthenticated],
33
+ list: [Permissions.IsAuthenticated],
34
+ read: [Permissions.IsAuthenticated],
35
+ update: [Permissions.IsAuthenticated],
36
+ },
37
+ sync: {scope: {type: "owner" as const}},
38
+ };
39
+
40
+ describe("SyncConfig.adminBroadcast", () => {
41
+ beforeEach(() => {
42
+ clearSyncRegistry();
43
+ });
44
+
45
+ it("stores adminBroadcast true when registerSync is given the flag", () => {
46
+ registerSync({
47
+ config: {adminBroadcast: true, scope: {type: "owner"}},
48
+ model: AdminBroadcastTodoModel,
49
+ options: syncOptions,
50
+ routePath: "/adminBroadcastTodos",
51
+ });
52
+
53
+ assert.strictEqual(getSyncRegistry()[0]?.config.adminBroadcast, true);
54
+ });
55
+
56
+ it("stores adminBroadcast false when registerSync omits the flag", () => {
57
+ registerSync({
58
+ config: {scope: {type: "owner"}},
59
+ model: AdminBroadcastTodoModel,
60
+ options: syncOptions,
61
+ routePath: "/adminBroadcastTodos",
62
+ });
63
+
64
+ assert.strictEqual(getSyncRegistry()[0]?.config.adminBroadcast, false);
65
+ });
66
+
67
+ it("stores adminBroadcast false when the host sets the flag to false", () => {
68
+ registerSync({
69
+ config: {adminBroadcast: false, scope: {type: "owner"}},
70
+ model: AdminBroadcastTodoModel,
71
+ options: syncOptions,
72
+ routePath: "/adminBroadcastTodos",
73
+ });
74
+
75
+ assert.strictEqual(getSyncRegistry()[0]?.config.adminBroadcast, false);
76
+ });
77
+
78
+ it("treats a second registerSync for the same model and route path as a no-op", () => {
79
+ registerSync({
80
+ config: {adminBroadcast: true, scope: {type: "owner"}},
81
+ model: AdminBroadcastTodoModel,
82
+ options: syncOptions,
83
+ routePath: "/adminBroadcastTodos",
84
+ });
85
+
86
+ registerSync({
87
+ config: {adminBroadcast: true, scope: {type: "owner"}},
88
+ model: AdminBroadcastTodoModel,
89
+ options: syncOptions,
90
+ routePath: "/adminBroadcastTodos",
91
+ });
92
+
93
+ assert.equal(getSyncRegistry().length, 1);
94
+ assert.strictEqual(getSyncRegistry()[0]?.config.adminBroadcast, true);
95
+ });
96
+ });
@@ -0,0 +1,155 @@
1
+ import {describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+
4
+ import type {User} from "../auth";
5
+ import {
6
+ authorizeAdminBroadcastDocument,
7
+ clearAdminBroadcastScopes,
8
+ isAdminBroadcastSocketRoom,
9
+ registerAdminBroadcastScope,
10
+ } from "./adminBroadcastScope";
11
+
12
+ const adminUser = {admin: true, id: "u-admin"} as User;
13
+
14
+ describe("adminBroadcastScope", () => {
15
+ it("treats an unregistered model as unscoped", async () => {
16
+ clearAdminBroadcastScopes();
17
+ assert.equal(
18
+ await authorizeAdminBroadcastDocument({
19
+ doc: {ownerId: "other"},
20
+ modelName: "Missing",
21
+ user: adminUser,
22
+ }),
23
+ "unscoped"
24
+ );
25
+ });
26
+
27
+ it("denies when list permission fails", async () => {
28
+ clearAdminBroadcastScopes();
29
+ registerAdminBroadcastScope("Scoped", {
30
+ listPermissions: [() => false],
31
+ readPermissions: [() => true],
32
+ });
33
+ assert.equal(
34
+ await authorizeAdminBroadcastDocument({
35
+ doc: {ownerId: "other"},
36
+ modelName: "Scoped",
37
+ user: adminUser,
38
+ }),
39
+ "deny"
40
+ );
41
+ });
42
+
43
+ it("denies when queryFilter excludes the document", async () => {
44
+ clearAdminBroadcastScopes();
45
+ registerAdminBroadcastScope("Scoped", {
46
+ listPermissions: [() => true],
47
+ queryFilter: () => ({tenantId: "acme"}),
48
+ readPermissions: [() => true],
49
+ });
50
+ assert.equal(
51
+ await authorizeAdminBroadcastDocument({
52
+ doc: {tenantId: "other"},
53
+ modelName: "Scoped",
54
+ user: adminUser,
55
+ }),
56
+ "deny"
57
+ );
58
+ assert.equal(
59
+ await authorizeAdminBroadcastDocument({
60
+ doc: {tenantId: "acme"},
61
+ modelName: "Scoped",
62
+ user: adminUser,
63
+ }),
64
+ "allow"
65
+ );
66
+ });
67
+
68
+ it("denies when queryFilter returns null", async () => {
69
+ clearAdminBroadcastScopes();
70
+ registerAdminBroadcastScope("Scoped", {
71
+ listPermissions: [() => true],
72
+ queryFilter: () => null,
73
+ readPermissions: [() => true],
74
+ });
75
+ assert.equal(
76
+ await authorizeAdminBroadcastDocument({
77
+ doc: {tenantId: "acme"},
78
+ modelName: "Scoped",
79
+ user: adminUser,
80
+ }),
81
+ "deny"
82
+ );
83
+ });
84
+
85
+ it("allows when queryFilter is omitted", async () => {
86
+ clearAdminBroadcastScopes();
87
+ registerAdminBroadcastScope("Scoped", {
88
+ listPermissions: [() => true],
89
+ readPermissions: [() => true],
90
+ });
91
+ assert.equal(
92
+ await authorizeAdminBroadcastDocument({
93
+ doc: {ownerId: "other"},
94
+ modelName: "Scoped",
95
+ user: adminUser,
96
+ }),
97
+ "allow"
98
+ );
99
+ });
100
+
101
+ it("denies when queryFilter throws", async () => {
102
+ clearAdminBroadcastScopes();
103
+ registerAdminBroadcastScope("Scoped", {
104
+ listPermissions: [() => true],
105
+ queryFilter: () => {
106
+ throw new Error("filter exploded");
107
+ },
108
+ readPermissions: [() => true],
109
+ });
110
+ assert.equal(
111
+ await authorizeAdminBroadcastDocument({
112
+ doc: {ownerId: "other"},
113
+ modelName: "Scoped",
114
+ user: adminUser,
115
+ }),
116
+ "deny"
117
+ );
118
+ });
119
+
120
+ it("denies when the user is missing", async () => {
121
+ clearAdminBroadcastScopes();
122
+ registerAdminBroadcastScope("Scoped", {
123
+ listPermissions: [() => true],
124
+ readPermissions: [() => true],
125
+ });
126
+ assert.equal(
127
+ await authorizeAdminBroadcastDocument({
128
+ doc: {ownerId: "other"},
129
+ modelName: "Scoped",
130
+ }),
131
+ "deny"
132
+ );
133
+ });
134
+
135
+ it("denies when read permission fails", async () => {
136
+ clearAdminBroadcastScopes();
137
+ registerAdminBroadcastScope("Scoped", {
138
+ listPermissions: [() => true],
139
+ readPermissions: [() => false],
140
+ });
141
+ assert.equal(
142
+ await authorizeAdminBroadcastDocument({
143
+ doc: {ownerId: "other"},
144
+ modelName: "Scoped",
145
+ user: adminUser,
146
+ }),
147
+ "deny"
148
+ );
149
+ });
150
+
151
+ it("identifies the admin broadcast socket room", () => {
152
+ assert.isTrue(isAdminBroadcastSocketRoom("sync:todos|admin", "todos"));
153
+ assert.isFalse(isAdminBroadcastSocketRoom("sync:todos|owner:u1", "todos"));
154
+ });
155
+ });