@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,78 +1,28 @@
1
1
  import type { Model } from "mongoose";
2
2
  import type { ModelRouterOptions } from "../api";
3
+ import { ensureSyncIndexes, trackSyncIndexCreation } from "./registrationSideEffects";
3
4
  import type { SyncConfig } from "./types";
4
- /**
5
- * A registered model with SyncDB local-first sync configuration.
6
- */
7
5
  export interface SyncRegistryEntry {
8
- /** Mongoose model name (e.g. "Todo") */
9
6
  modelName: string;
10
- /** Route path (e.g. "/todos") */
11
7
  routePath: string;
12
- /** Collection tag used in the sync protocol (route path without the leading slash) */
13
8
  collectionTag: string;
14
- /** MongoDB collection name (e.g. "todos") */
15
9
  collectionName: string;
16
- /** Sync configuration from modelRouter options */
17
10
  config: SyncConfig;
18
- /** Full modelRouter options (for responseHandler, permissions, etc.) */
19
11
  options: ModelRouterOptions<unknown>;
20
12
  }
21
- /**
22
- * Enqueue an index-creation promise for `ensureSyncIndexes()` to await at startup. Used by
23
- * `SyncApp.register` for the bookkeeping-model indexes (`SyncCounter`, `SyncMutation`,
24
- * `SyncScopeMove`, `SyncKey`), which are correctness-critical and must not depend on
25
- * Mongoose `autoIndex` being enabled.
26
- */
27
- export declare const trackSyncIndexCreation: (promise: Promise<void>) => void;
28
- /**
29
- * Register a model for local-first sync. Called automatically by modelRouter when the
30
- * `sync` option is provided. Validates the schema contract at startup and throws with
31
- * an actionable message when it is not met:
32
- * - soft delete (`isDeletedPlugin`) is required so deletes remain queryable tombstones;
33
- * - `syncPlugin` is required so every write stamps a per-stream `_syncSeq`;
34
- * - owner/tenant scope fields must exist on the schema.
35
- */
13
+ export { ensureSyncIndexes, trackSyncIndexCreation };
36
14
  export declare const registerSync: <T>({ model, routePath, config, options, }: {
37
15
  model: Model<T>;
38
16
  routePath: string;
39
17
  config: SyncConfig;
40
18
  options: ModelRouterOptions<T>;
41
19
  }) => void;
42
- /**
43
- * Replace options on an existing sync registry entry after TerrenoApp injects
44
- * accessControl and modelRouter resolves RBAC permissions.
45
- */
46
20
  export declare const updateSyncRegistryOptions: (routePath: string, options: ModelRouterOptions<unknown>) => void;
47
- /**
48
- * C8: await every enqueued sync index creation — per-model snapshot indexes from
49
- * `registerSync` plus the bookkeeping-model indexes from `SyncApp.register` — throwing on
50
- * the first failure. Called at server startup by `TerrenoApp.start()` (after all models
51
- * and plugins register) so a missing index fails the boot loudly rather than silently
52
- * degrading the snapshot query to a table scan or breaking mutation idempotency.
53
- */
54
- export declare const ensureSyncIndexes: () => Promise<void>;
55
- /** Get all registered sync models. */
56
21
  export declare const getSyncRegistry: () => SyncRegistryEntry[];
57
- /**
58
- * Task 9.21: warn loudly at startup when a tenant/custom-scoped collection is registered
59
- * but no `userModel` is configured for socket handshakes.
60
- *
61
- * Without one, `getSocketUser` falls back to the synthetic decoded-token user: `admin`
62
- * comes from a JWT claim rather than the database, and `getUserScopes` sees no
63
- * `organizationIds`, so tenant subscriptions silently resolve to no streams (a client that
64
- * appears connected but never receives data). This warns rather than throws so an existing
65
- * deployment cannot be bricked by an upgrade; the message names the collections and the
66
- * fix. Returns the offending collection tags for tests and callers that want to escalate.
67
- */
68
22
  export declare const warnOnSyncScopesWithoutUserModel: ({ userModel }: {
69
23
  userModel?: unknown;
70
24
  }) => string[];
71
- /** Find a sync registry entry by Mongoose model name. */
72
25
  export declare const findSyncEntryByModelName: (modelName: string) => SyncRegistryEntry | undefined;
73
- /** Find a sync registry entry by collection tag (e.g. "todos"). */
74
26
  export declare const findSyncEntryByCollectionTag: (collectionTag: string) => SyncRegistryEntry | undefined;
75
- /** Find a sync registry entry by MongoDB collection name. */
76
27
  export declare const findSyncEntryByCollectionName: (collectionName: string) => SyncRegistryEntry | undefined;
77
- /** Clear the registry (for testing). */
78
28
  export declare const clearSyncRegistry: () => void;
@@ -1,200 +1,57 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
- var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
- function verb(n) { return function (v) { return step([n, v]); }; }
15
- function step(op) {
16
- if (f) throw new TypeError("Generator is already executing.");
17
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
- if (y = 0, t) op = [op[0] & 2, t.value];
20
- switch (op[0]) {
21
- case 0: case 1: t = op; break;
22
- case 4: _.label++; return { value: op[1], done: false };
23
- case 5: _.label++; y = op[1]; op = [0]; continue;
24
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
- default:
26
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
- if (t[2]) _.ops.pop();
31
- _.trys.pop(); continue;
32
- }
33
- op = body.call(thisArg, _);
34
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
- }
2
+ var __assign = (this && this.__assign) || function () {
3
+ __assign = Object.assign || function(t) {
4
+ for (var s, i = 1, n = arguments.length; i < n; i++) {
5
+ s = arguments[i];
6
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
+ t[p] = s[p];
8
+ }
9
+ return t;
10
+ };
11
+ return __assign.apply(this, arguments);
37
12
  };
38
13
  Object.defineProperty(exports, "__esModule", { value: true });
39
- exports.clearSyncRegistry = exports.findSyncEntryByCollectionName = exports.findSyncEntryByCollectionTag = exports.findSyncEntryByModelName = exports.warnOnSyncScopesWithoutUserModel = exports.getSyncRegistry = exports.ensureSyncIndexes = exports.updateSyncRegistryOptions = exports.registerSync = exports.trackSyncIndexCreation = void 0;
14
+ exports.clearSyncRegistry = exports.findSyncEntryByCollectionName = exports.findSyncEntryByCollectionTag = exports.findSyncEntryByModelName = exports.warnOnSyncScopesWithoutUserModel = exports.getSyncRegistry = exports.updateSyncRegistryOptions = exports.registerSync = exports.trackSyncIndexCreation = exports.ensureSyncIndexes = void 0;
15
+ var collectionRegistry_1 = require("../collectionRegistry");
40
16
  var logger_1 = require("../logger");
41
- var streams_1 = require("./streams");
42
- var syncRegistry = [];
43
- /**
44
- * C8: index creation is kicked off (fire-and-forget) at registration, but its failure must
45
- * be a STARTUP error, not a swallowed warning (a missing index table-scans the snapshot
46
- * query under load, and a missing unique index breaks mutation idempotency). Each
47
- * registration records its index promise here; `ensureSyncIndexes()` awaits them and
48
- * throws on any failure so server startup can fail loudly. A detached failure is also
49
- * logged so it is never silent even if startup never calls `ensureSyncIndexes`.
50
- */
51
- var indexCreationPromises = [];
52
- /**
53
- * Enqueue an index-creation promise for `ensureSyncIndexes()` to await at startup. Used by
54
- * `SyncApp.register` for the bookkeeping-model indexes (`SyncCounter`, `SyncMutation`,
55
- * `SyncScopeMove`, `SyncKey`), which are correctness-critical and must not depend on
56
- * Mongoose `autoIndex` being enabled.
57
- */
58
- var trackSyncIndexCreation = function (promise) {
59
- indexCreationPromises.push(promise);
60
- // Swallow the detached rejection (the failure is logged where it happens and rethrown
61
- // by `ensureSyncIndexes()` via the retained promise above).
62
- promise.catch(function () { });
17
+ var adminBroadcastScope_1 = require("./adminBroadcastScope");
18
+ var adminWindowMutation_1 = require("./adminWindowMutation");
19
+ var registrationSideEffects_1 = require("./registrationSideEffects");
20
+ Object.defineProperty(exports, "ensureSyncIndexes", { enumerable: true, get: function () { return registrationSideEffects_1.ensureSyncIndexes; } });
21
+ Object.defineProperty(exports, "trackSyncIndexCreation", { enumerable: true, get: function () { return registrationSideEffects_1.trackSyncIndexCreation; } });
22
+ var toSyncEntry = function (record) { return ({
23
+ collectionName: record.model.collection.collectionName,
24
+ collectionTag: record.routePath.replace(/^\//, ""),
25
+ config: record.options.sync,
26
+ modelName: record.model.modelName,
27
+ options: record.options,
28
+ routePath: record.routePath,
29
+ }); };
30
+ var syncCollections = function () {
31
+ return (0, collectionRegistry_1.listCollections)()
32
+ .filter(function (record) { return record.surfaces.sync; })
33
+ .map(toSyncEntry);
63
34
  };
64
- exports.trackSyncIndexCreation = trackSyncIndexCreation;
65
- /**
66
- * Register a model for local-first sync. Called automatically by modelRouter when the
67
- * `sync` option is provided. Validates the schema contract at startup and throws with
68
- * an actionable message when it is not met:
69
- * - soft delete (`isDeletedPlugin`) is required so deletes remain queryable tombstones;
70
- * - `syncPlugin` is required so every write stamps a per-stream `_syncSeq`;
71
- * - owner/tenant scope fields must exist on the schema.
72
- */
73
35
  var registerSync = function (_a) {
74
- var _b;
75
36
  var model = _a.model, routePath = _a.routePath, config = _a.config, options = _a.options;
76
- var name = model.modelName;
77
- var deletedPath = model.schema.path("deleted");
78
- if ((deletedPath === null || deletedPath === void 0 ? void 0 : deletedPath.instance) !== "Boolean") {
79
- throw new Error("Model ".concat(name, " has a sync config but no soft delete support. ") +
80
- "Apply isDeletedPlugin to the schema — sync catch-up requires delete tombstones.");
81
- }
82
- if (!model.schema.path("_syncSeq")) {
83
- throw new Error("Model ".concat(name, " has a sync config but syncPlugin is not applied to its schema. ") +
84
- "Apply syncPlugin so every write stamps a per-stream _syncSeq.");
85
- }
86
- var scopeField = (0, streams_1.getScopeField)(config.scope);
87
- if (scopeField && !model.schema.path(scopeField)) {
88
- throw new Error("Model ".concat(name, " has a sync scope on field \"").concat(scopeField, "\" but the schema has no such path."));
89
- }
90
- if (typeof config.scope === "function" && !config.snapshotFilter) {
91
- throw new Error("Model ".concat(name, " uses a custom sync scope resolver, which requires a snapshotFilter ") +
92
- "so the snapshot endpoint can restrict queries to the caller's documents.");
93
- }
94
- if (syncRegistry.some(function (entry) { return entry.modelName === name; })) {
95
- throw new Error("Model ".concat(name, " is already registered for sync."));
96
- }
97
- // C8: a duplicate collectionTag would make two models share sync streams and route
98
- // snapshots/deltas ambiguously — reject it loudly at registration.
99
- var collectionTag = routePath.replace(/^\//, "");
100
- if (syncRegistry.some(function (entry) { return entry.collectionTag === collectionTag; })) {
101
- throw new Error("Sync collection tag \"".concat(collectionTag, "\" is already registered (routePath ").concat(routePath, "). ") +
102
- "Each synced model must have a unique route path.");
103
- }
104
- syncRegistry.push({
105
- collectionName: model.collection.collectionName,
106
- collectionTag: collectionTag,
107
- config: config,
108
- modelName: name,
109
- options: options,
37
+ (0, collectionRegistry_1.registerCollection)({
38
+ model: model,
39
+ options: __assign(__assign({}, options), { sync: config }),
110
40
  routePath: routePath,
111
41
  });
112
- // `Model.bulkWrite` bypasses Mongoose middleware entirely, so `syncPlugin`'s query
113
- // guards never see it: writes land with no `_syncSeq`, invisible to both delta emission
114
- // and snapshot catch-up, and clients silently never learn about them. The restriction
115
- // used to be documentation only — replace the static so it throws the same way the
116
- // guarded multi-document paths do. Idempotent: the replacement never delegates, so a
117
- // re-registration (tests clearing the registry) re-patching it is harmless.
118
- model.bulkWrite = function () {
119
- throw new Error("bulkWrite is not supported on sync-enabled model ".concat(name, ": it bypasses Mongoose ") +
120
- "middleware, so writes are never stamped with a per-stream _syncSeq and become " +
121
- "invisible to sync delta emission and snapshot catch-up. Loop per document instead.");
122
- };
123
- // Compound index for snapshot/catch-up queries: {scopeField, _syncSeq}. Created
124
- // directly on the collection because the model is already compiled at registration.
125
- // C8: track the promise so `ensureSyncIndexes()` (server startup) can fail loudly on a
126
- // createIndex error — a missing index table-scans the snapshot query under load. The
127
- // detached path only logs (never throws into an orphaned promise).
128
- var indexSpec = scopeField ? (_b = {}, _b[scopeField] = 1, _b._syncSeq = 1, _b) : { _syncSeq: 1 };
129
- var indexPromise = model.collection
130
- .createIndex(indexSpec)
131
- .then(function () { })
132
- .catch(function (error) {
133
- logger_1.logger.error("[sync] Failed to create sync index for ".concat(name), { error: String(error) });
134
- throw new Error("Failed to create sync snapshot index for ".concat(name, ": ").concat(String(error), ". ") +
135
- "The snapshot/catch-up query requires this index; fix the schema/DB and restart.");
136
- });
137
- indexCreationPromises.push(indexPromise);
138
- // Swallow the detached rejection (already logged) so it is not an unhandled rejection;
139
- // `ensureSyncIndexes()` still observes it via the retained promise above.
140
- indexPromise.catch(function () { });
141
42
  };
142
43
  exports.registerSync = registerSync;
143
- /**
144
- * Replace options on an existing sync registry entry after TerrenoApp injects
145
- * accessControl and modelRouter resolves RBAC permissions.
146
- */
147
44
  var updateSyncRegistryOptions = function (routePath, options) {
148
- var existing = syncRegistry.find(function (entry) { return entry.routePath === routePath; });
149
- if (!existing) {
150
- return;
151
- }
152
- existing.options = options;
45
+ (0, collectionRegistry_1.replaceCollectionOptions)(routePath, options);
153
46
  };
154
47
  exports.updateSyncRegistryOptions = updateSyncRegistryOptions;
155
- /**
156
- * C8: await every enqueued sync index creation — per-model snapshot indexes from
157
- * `registerSync` plus the bookkeeping-model indexes from `SyncApp.register` — throwing on
158
- * the first failure. Called at server startup by `TerrenoApp.start()` (after all models
159
- * and plugins register) so a missing index fails the boot loudly rather than silently
160
- * degrading the snapshot query to a table scan or breaking mutation idempotency.
161
- */
162
- var ensureSyncIndexes = function () { return __awaiter(void 0, void 0, void 0, function () {
163
- return __generator(this, function (_a) {
164
- switch (_a.label) {
165
- case 0: return [4 /*yield*/, Promise.all(indexCreationPromises)];
166
- case 1:
167
- _a.sent();
168
- return [2 /*return*/];
169
- }
170
- });
171
- }); };
172
- exports.ensureSyncIndexes = ensureSyncIndexes;
173
- /** Get all registered sync models. */
174
- var getSyncRegistry = function () { return syncRegistry; };
48
+ var getSyncRegistry = function () { return syncCollections(); };
175
49
  exports.getSyncRegistry = getSyncRegistry;
176
- /**
177
- * Collection tags whose scope can only be resolved from the FULL user document —
178
- * tenant scopes read `organizationIds` (or whatever `getUserScopes` looks at) and custom
179
- * resolvers may read anything. The synthetic `{_id, admin, id}` user built from JWT claims
180
- * carries none of that.
181
- */
182
50
  var scopesRequiringFullUser = function () {
183
- return syncRegistry
51
+ return syncCollections()
184
52
  .filter(function (entry) { return typeof entry.config.scope === "function" || entry.config.scope.type === "tenant"; })
185
53
  .map(function (entry) { return entry.collectionTag; });
186
54
  };
187
- /**
188
- * Task 9.21: warn loudly at startup when a tenant/custom-scoped collection is registered
189
- * but no `userModel` is configured for socket handshakes.
190
- *
191
- * Without one, `getSocketUser` falls back to the synthetic decoded-token user: `admin`
192
- * comes from a JWT claim rather than the database, and `getUserScopes` sees no
193
- * `organizationIds`, so tenant subscriptions silently resolve to no streams (a client that
194
- * appears connected but never receives data). This warns rather than throws so an existing
195
- * deployment cannot be bricked by an upgrade; the message names the collections and the
196
- * fix. Returns the offending collection tags for tests and callers that want to escalate.
197
- */
198
55
  var warnOnSyncScopesWithoutUserModel = function (_a) {
199
56
  var userModel = _a.userModel;
200
57
  if (userModel) {
@@ -212,24 +69,22 @@ var warnOnSyncScopesWithoutUserModel = function (_a) {
212
69
  return collections;
213
70
  };
214
71
  exports.warnOnSyncScopesWithoutUserModel = warnOnSyncScopesWithoutUserModel;
215
- /** Find a sync registry entry by Mongoose model name. */
216
72
  var findSyncEntryByModelName = function (modelName) {
217
- return syncRegistry.find(function (entry) { return entry.modelName === modelName; });
73
+ return syncCollections().find(function (entry) { return entry.modelName === modelName; });
218
74
  };
219
75
  exports.findSyncEntryByModelName = findSyncEntryByModelName;
220
- /** Find a sync registry entry by collection tag (e.g. "todos"). */
221
76
  var findSyncEntryByCollectionTag = function (collectionTag) {
222
- return syncRegistry.find(function (entry) { return entry.collectionTag === collectionTag; });
77
+ return syncCollections().find(function (entry) { return entry.collectionTag === collectionTag; });
223
78
  };
224
79
  exports.findSyncEntryByCollectionTag = findSyncEntryByCollectionTag;
225
- /** Find a sync registry entry by MongoDB collection name. */
226
80
  var findSyncEntryByCollectionName = function (collectionName) {
227
- return syncRegistry.find(function (entry) { return entry.collectionName === collectionName; });
81
+ return syncCollections().find(function (entry) { return entry.collectionName === collectionName; });
228
82
  };
229
83
  exports.findSyncEntryByCollectionName = findSyncEntryByCollectionName;
230
- /** Clear the registry (for testing). */
231
84
  var clearSyncRegistry = function () {
232
- syncRegistry.length = 0;
233
- indexCreationPromises.length = 0;
85
+ (0, collectionRegistry_1.clearCollectionRegistry)();
86
+ (0, registrationSideEffects_1.clearSyncIndexCreationTasks)();
87
+ (0, adminBroadcastScope_1.clearAdminBroadcastScopes)();
88
+ (0, adminWindowMutation_1.clearAdminWindowMutationScopes)();
234
89
  };
235
90
  exports.clearSyncRegistry = clearSyncRegistry;
@@ -1,6 +1,7 @@
1
1
  import express from "express";
2
2
  import mongoose from "mongoose";
3
3
  import { type User } from "../auth";
4
+ import type { AnyTerrenoAccess } from "../rbac/types";
4
5
  import { type SyncRegistryEntry } from "./registry";
5
6
  /**
6
7
  * Maximum mutations per user per second on the HTTP mutate routes.
@@ -21,6 +22,18 @@ export interface SyncAppOptions {
21
22
  getUserScopes?: (user: User, entry: SyncRegistryEntry) => Promise<string[]> | string[];
22
23
  /** Default page size for snapshots (default 100, max 100). */
23
24
  defaultSnapshotLimit?: number;
25
+ /**
26
+ * When set, `{collection}|admin` window subscribe and cross-owner entity
27
+ * hydrate require `admin:access` instead of the legacy `user.admin` flag.
28
+ * AdminApp also registers per-model list/read/`queryFilter` so hydrate and
29
+ * `|admin` deltas match `/admin` REST, not product `IsOwner`.
30
+ */
31
+ accessControl?: AnyTerrenoAccess;
32
+ /**
33
+ * Override the admin-window gate. Defaults to `admin:access` when
34
+ * `accessControl` is set, otherwise `Permissions.IsAdmin`.
35
+ */
36
+ canOpenAdminWindow?: (user: User) => boolean | Promise<boolean>;
24
37
  }
25
38
  /**
26
39
  * Serialize a document for a sync payload through the fallback chain:
@@ -94,6 +94,9 @@ var auth_1 = require("../auth");
94
94
  var errors_1 = require("../errors");
95
95
  var logger_1 = require("../logger");
96
96
  var permissions_1 = require("../permissions");
97
+ var plugins_1 = require("../plugins");
98
+ var adminBroadcastScope_1 = require("./adminBroadcastScope");
99
+ var adminWindowAccess_1 = require("./adminWindowAccess");
97
100
  var models_1 = require("./models");
98
101
  var registry_1 = require("./registry");
99
102
  var serialize_1 = require("./serialize");
@@ -360,10 +363,10 @@ var frontierBelowStreamHead = function (streamKey, frontierSeq) { return __await
360
363
  var _a;
361
364
  return __generator(this, function (_b) {
362
365
  switch (_b.label) {
363
- case 0: return [4 /*yield*/, models_1.SyncCounter.findOne({ stream: streamKey }).select({ seq: 1 }).lean()];
366
+ case 0: return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(models_1.SyncCounter, { stream: streamKey })];
364
367
  case 1:
365
368
  counter = _b.sent();
366
- head = counter ? ((_a = counter.seq) !== null && _a !== void 0 ? _a : 0) : 0;
369
+ head = (_a = counter === null || counter === void 0 ? void 0 : counter.seq) !== null && _a !== void 0 ? _a : 0;
367
370
  return [2 /*return*/, head > frontierSeq];
368
371
  }
369
372
  });
@@ -730,17 +733,17 @@ var addSyncRoutes = function (app, options) {
730
733
  });
731
734
  }); }));
732
735
  router.get("/sync/entities", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
733
- var user, collection, idsParam, ids, entry, memberStreams, memberSet, queryFilterResult, deniedResponse, model, castIds, docs, entities, _a, _b, doc, allowed, docObj, stream, isTombstone, _c, _d, _e, e_5_1, response;
734
- var e_5, _f, _g;
735
- var _h, _j;
736
- return __generator(this, function (_k) {
737
- switch (_k.label) {
736
+ var user, collection, idsParam, ids, entry, isAdminWindow, _a, adminScope, _b, deniedResponse, memberStreams, _c, memberSet, queryFilterResult, _d, _e, deniedResponse, model, castIds, docs, entities, _f, _g, doc, allowed, _h, docObj, stream, isTombstone, _j, _k, _l, e_5_1, response;
737
+ var e_5, _m, _o;
738
+ var _p, _q;
739
+ return __generator(this, function (_r) {
740
+ switch (_r.label) {
738
741
  case 0:
739
742
  user = req.user;
740
743
  if (!user) {
741
744
  throw new errors_1.APIError({ status: 401, title: "Authentication required" });
742
745
  }
743
- collection = String((_h = req.query.collection) !== null && _h !== void 0 ? _h : "").trim();
746
+ collection = String((_p = req.query.collection) !== null && _p !== void 0 ? _p : "").trim();
744
747
  if (!collection) {
745
748
  throw new errors_1.APIError({ status: 400, title: "collection query parameter is required" });
746
749
  }
@@ -772,23 +775,68 @@ var addSyncRoutes = function (app, options) {
772
775
  }
773
776
  return [4 /*yield*/, (0, permissions_1.checkPermissions)("list", entry.options.permissions.list, user)];
774
777
  case 1:
775
- if (!(_k.sent())) {
778
+ if (!(_r.sent())) {
776
779
  throw new errors_1.APIError({
777
780
  status: 403,
778
781
  title: "Access to sync entities for ".concat(collection, " denied for ").concat(user.id),
779
782
  });
780
783
  }
781
- return [4 /*yield*/, (0, streams_1.resolveUserStreamsForEntry)({
782
- entry: entry,
783
- getUserScopes: options.getUserScopes,
784
+ _a = entry.config.adminBroadcast === true;
785
+ if (!_a) return [3 /*break*/, 3];
786
+ return [4 /*yield*/, (0, adminWindowAccess_1.canUseAdminBroadcastWindow)({
787
+ accessControl: options.accessControl,
788
+ canOpenAdminWindow: options.canOpenAdminWindow,
784
789
  user: user,
785
790
  })];
786
791
  case 2:
787
- memberStreams = _k.sent();
788
- memberSet = new Set(memberStreams);
789
- return [4 /*yield*/, resolveSyncQueryFilter({ entry: entry, user: user })];
792
+ _a = (_r.sent());
793
+ _r.label = 3;
790
794
  case 3:
791
- queryFilterResult = _k.sent();
795
+ isAdminWindow = _a;
796
+ adminScope = isAdminWindow ? (0, adminBroadcastScope_1.getAdminBroadcastScope)(entry.modelName) : undefined;
797
+ _b = adminScope;
798
+ if (!_b) return [3 /*break*/, 5];
799
+ return [4 /*yield*/, (0, adminBroadcastScope_1.canListAdminBroadcastScope)({ scope: adminScope, user: user })];
800
+ case 4:
801
+ _b = !(_r.sent());
802
+ _r.label = 5;
803
+ case 5:
804
+ if (_b) {
805
+ deniedResponse = { entities: [] };
806
+ return [2 /*return*/, res.json(deniedResponse)];
807
+ }
808
+ if (!isAdminWindow) return [3 /*break*/, 6];
809
+ _c = [];
810
+ return [3 /*break*/, 8];
811
+ case 6: return [4 /*yield*/, (0, streams_1.resolveUserStreamsForEntry)({
812
+ entry: entry,
813
+ getUserScopes: options.getUserScopes,
814
+ user: user,
815
+ })];
816
+ case 7:
817
+ _c = _r.sent();
818
+ _r.label = 8;
819
+ case 8:
820
+ memberStreams = _c;
821
+ memberSet = new Set(memberStreams);
822
+ if (!adminScope) return [3 /*break*/, 10];
823
+ return [4 /*yield*/, (0, adminBroadcastScope_1.resolveAdminBroadcastQueryFilter)({ scope: adminScope, user: user })];
824
+ case 9:
825
+ _d = _r.sent();
826
+ return [3 /*break*/, 14];
827
+ case 10:
828
+ if (!isAdminWindow) return [3 /*break*/, 11];
829
+ _e = { denied: false, filter: undefined };
830
+ return [3 /*break*/, 13];
831
+ case 11: return [4 /*yield*/, resolveSyncQueryFilter({ entry: entry, user: user })];
832
+ case 12:
833
+ _e = _r.sent();
834
+ _r.label = 13;
835
+ case 13:
836
+ _d = _e;
837
+ _r.label = 14;
838
+ case 14:
839
+ queryFilterResult = _d;
792
840
  if (queryFilterResult.denied) {
793
841
  deniedResponse = { entities: [] };
794
842
  return [2 /*return*/, res.json(deniedResponse)];
@@ -799,22 +847,30 @@ var addSyncRoutes = function (app, options) {
799
847
  queryFilter: queryFilterResult.filter,
800
848
  scopeFilter: { _id: { $in: castIds } },
801
849
  })), { deleted: { $in: [true, false] } }))];
802
- case 4:
803
- docs = _k.sent();
850
+ case 15:
851
+ docs = _r.sent();
804
852
  entities = [];
805
- _k.label = 5;
806
- case 5:
807
- _k.trys.push([5, 13, 14, 15]);
808
- _a = __values(docs), _b = _a.next();
809
- _k.label = 6;
810
- case 6:
811
- if (!!_b.done) return [3 /*break*/, 12];
812
- doc = _b.value;
813
- return [4 /*yield*/, (0, permissions_1.checkPermissions)("read", entry.options.permissions.read, user, doc)];
814
- case 7:
815
- allowed = _k.sent();
853
+ _r.label = 16;
854
+ case 16:
855
+ _r.trys.push([16, 27, 28, 29]);
856
+ _f = __values(docs), _g = _f.next();
857
+ _r.label = 17;
858
+ case 17:
859
+ if (!!_g.done) return [3 /*break*/, 26];
860
+ doc = _g.value;
861
+ if (!adminScope) return [3 /*break*/, 19];
862
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("read", adminScope.readPermissions, user, doc)];
863
+ case 18:
864
+ _h = _r.sent();
865
+ return [3 /*break*/, 21];
866
+ case 19: return [4 /*yield*/, (0, permissions_1.checkPermissions)("read", entry.options.permissions.read, user, doc)];
867
+ case 20:
868
+ _h = _r.sent();
869
+ _r.label = 21;
870
+ case 21:
871
+ allowed = _h;
816
872
  if (!allowed) {
817
- return [3 /*break*/, 11];
873
+ return [3 /*break*/, 25];
818
874
  }
819
875
  docObj = doc.toObject();
820
876
  stream = (0, streams_1.resolveStreamForDoc)({
@@ -822,41 +878,41 @@ var addSyncRoutes = function (app, options) {
822
878
  doc: docObj,
823
879
  scope: entry.config.scope,
824
880
  });
825
- if (!memberSet.has(stream)) {
826
- return [3 /*break*/, 11];
881
+ if (!isAdminWindow && !memberSet.has(stream)) {
882
+ return [3 /*break*/, 25];
827
883
  }
828
884
  isTombstone = Boolean(docObj.deleted);
829
- _d = (_c = entities).push;
830
- _g = {};
831
- if (!isTombstone) return [3 /*break*/, 8];
832
- _e = null;
833
- return [3 /*break*/, 10];
834
- case 8: return [4 /*yield*/, (0, exports.serializeSyncDoc)({ doc: doc, entry: entry, req: req })];
835
- case 9:
836
- _e = _k.sent();
837
- _k.label = 10;
838
- case 10:
839
- _d.apply(_c, [(_g.data = _e,
840
- _g.deleted = isTombstone,
841
- _g.id = String(doc._id),
842
- _g.seq = (_j = docObj._syncSeq) !== null && _j !== void 0 ? _j : 0,
843
- _g)]);
844
- _k.label = 11;
845
- case 11:
846
- _b = _a.next();
847
- return [3 /*break*/, 6];
848
- case 12: return [3 /*break*/, 15];
849
- case 13:
850
- e_5_1 = _k.sent();
885
+ _k = (_j = entities).push;
886
+ _o = {};
887
+ if (!isTombstone) return [3 /*break*/, 22];
888
+ _l = null;
889
+ return [3 /*break*/, 24];
890
+ case 22: return [4 /*yield*/, (0, exports.serializeSyncDoc)({ doc: doc, entry: entry, req: req })];
891
+ case 23:
892
+ _l = _r.sent();
893
+ _r.label = 24;
894
+ case 24:
895
+ _k.apply(_j, [(_o.data = _l,
896
+ _o.deleted = isTombstone,
897
+ _o.id = String(doc._id),
898
+ _o.seq = (_q = docObj._syncSeq) !== null && _q !== void 0 ? _q : 0,
899
+ _o)]);
900
+ _r.label = 25;
901
+ case 25:
902
+ _g = _f.next();
903
+ return [3 /*break*/, 17];
904
+ case 26: return [3 /*break*/, 29];
905
+ case 27:
906
+ e_5_1 = _r.sent();
851
907
  e_5 = { error: e_5_1 };
852
- return [3 /*break*/, 15];
853
- case 14:
908
+ return [3 /*break*/, 29];
909
+ case 28:
854
910
  try {
855
- if (_b && !_b.done && (_f = _a.return)) _f.call(_a);
911
+ if (_g && !_g.done && (_m = _f.return)) _m.call(_f);
856
912
  }
857
913
  finally { if (e_5) throw e_5.error; }
858
914
  return [7 /*endfinally*/];
859
- case 15:
915
+ case 29:
860
916
  response = { entities: entities };
861
917
  return [2 /*return*/, res.json(response)];
862
918
  }
@@ -875,6 +931,7 @@ var addSyncRoutes = function (app, options) {
875
931
  mutation: req.body,
876
932
  req: req,
877
933
  scopeResolver: options.getUserScopes,
934
+ syncOptions: options,
878
935
  user: user,
879
936
  })];
880
937
  case 1:
@@ -902,6 +959,7 @@ var addSyncRoutes = function (app, options) {
902
959
  mutations: mutations,
903
960
  req: req,
904
961
  scopeResolver: options.getUserScopes,
962
+ syncOptions: options,
905
963
  user: user,
906
964
  })];
907
965
  case 1:
@@ -67,8 +67,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
67
67
  };
68
68
  Object.defineProperty(exports, "__esModule", { value: true });
69
69
  exports.compactTombstones = exports.compactEntryTombstones = exports.DEFAULT_TOMBSTONE_RETENTION_DAYS = void 0;
70
- // noExplicitAny: operates generically across registered sync models
71
- // biome-ignore-all lint/suspicious/noExplicitAny: operates generically across registered sync models
72
70
  var luxon_1 = require("luxon");
73
71
  var mongoose_1 = __importDefault(require("mongoose"));
74
72
  var logger_1 = require("../../logger");