@terreno/api 57.3.0 → 57.6.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 (412) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +11 -5
  3. package/bunfig.toml +1 -1
  4. package/dist/actions.js +197 -368
  5. package/dist/adminModelRouter.js +88 -173
  6. package/dist/adminTypes.d.ts +7 -0
  7. package/dist/adminTypes.js +6 -1
  8. package/dist/api.d.ts +10 -0
  9. package/dist/api.js +601 -792
  10. package/dist/audit/auditApp.d.ts +30 -0
  11. package/dist/audit/auditApp.js +114 -0
  12. package/dist/audit/auditEventModel.d.ts +29 -0
  13. package/dist/audit/auditEventModel.js +101 -0
  14. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  15. package/dist/audit/cloudTasksEnqueue.js +69 -0
  16. package/dist/audit/diff.d.ts +10 -0
  17. package/dist/audit/diff.js +140 -0
  18. package/dist/audit/processQueue.d.ts +6 -0
  19. package/dist/audit/processQueue.js +56 -0
  20. package/dist/audit/rbacSink.d.ts +2 -0
  21. package/dist/audit/rbacSink.js +41 -0
  22. package/dist/audit/record.d.ts +56 -0
  23. package/dist/audit/record.js +251 -0
  24. package/dist/auth.js +432 -681
  25. package/dist/authRecovery.js +155 -269
  26. package/dist/authTokens.js +43 -118
  27. package/dist/betterAuth.d.ts +6 -0
  28. package/dist/betterAuthApp.js +25 -26
  29. package/dist/betterAuthSetup.js +258 -413
  30. package/dist/browserLogsRoute.d.ts +6 -0
  31. package/dist/browserLogsRoute.js +97 -0
  32. package/dist/collectionRegistry.d.ts +3 -1
  33. package/dist/collectionRegistry.js +43 -33
  34. package/dist/config.js +53 -122
  35. package/dist/configurationApp.js +180 -361
  36. package/dist/configurationPlugin.js +130 -302
  37. package/dist/consentApp.js +276 -421
  38. package/dist/docLoader.js +78 -126
  39. package/dist/envConfigurationPlugin.js +25 -147
  40. package/dist/errors.js +151 -247
  41. package/dist/example.js +28 -34
  42. package/dist/expressServer.d.ts +10 -0
  43. package/dist/expressServer.js +109 -255
  44. package/dist/frameworkModelNames.d.ts +24 -0
  45. package/dist/frameworkModelNames.js +31 -0
  46. package/dist/githubAuth.js +152 -216
  47. package/dist/httpClient.js +176 -264
  48. package/dist/index.d.ts +28 -1
  49. package/dist/index.js +53 -2
  50. package/dist/logger.js +145 -278
  51. package/dist/mcp/auth.js +76 -128
  52. package/dist/mcp/createMCPRequest.js +4 -5
  53. package/dist/mcp/handlers.js +268 -480
  54. package/dist/mcp/query.d.ts +0 -13
  55. package/dist/mcp/query.js +57 -151
  56. package/dist/mcp/registry.js +17 -30
  57. package/dist/mcp/schemaGenerator.js +95 -181
  58. package/dist/mcp/server.js +28 -100
  59. package/dist/mcp/serviceTokens.js +102 -191
  60. package/dist/mcp/toolGenerator.js +78 -191
  61. package/dist/middleware.js +15 -27
  62. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  63. package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
  64. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  65. package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
  66. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  67. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
  68. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  69. package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -0
  70. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  71. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  72. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  73. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +7 -0
  74. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  75. package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
  76. package/dist/migrations/generate.d.ts +17 -0
  77. package/dist/migrations/generate.js +155 -0
  78. package/dist/migrations/load.d.ts +20 -0
  79. package/dist/migrations/load.js +110 -0
  80. package/dist/migrations/lock.d.ts +13 -0
  81. package/dist/migrations/lock.js +73 -0
  82. package/dist/migrations/runner.d.ts +42 -0
  83. package/dist/migrations/runner.js +249 -0
  84. package/dist/migrations/schemaCatalog.d.ts +44 -0
  85. package/dist/migrations/schemaCatalog.js +185 -0
  86. package/dist/migrations/types.d.ts +87 -0
  87. package/dist/migrations/types.js +7 -0
  88. package/dist/models/consentForm.js +6 -6
  89. package/dist/models/consentResponse.js +5 -5
  90. package/dist/models/mcpServiceToken.js +66 -156
  91. package/dist/models/notification.d.ts +2 -0
  92. package/dist/models/notification.js +62 -0
  93. package/dist/models/notificationPreference.d.ts +2 -0
  94. package/dist/models/notificationPreference.js +49 -0
  95. package/dist/models/versionConfig.js +5 -5
  96. package/dist/notifications/notificationService.d.ts +40 -0
  97. package/dist/notifications/notificationService.js +183 -0
  98. package/dist/notifications/notificationsApp.d.ts +18 -0
  99. package/dist/notifications/notificationsApp.js +156 -0
  100. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  101. package/dist/notifications/notificationsBeforeSend.js +32 -0
  102. package/dist/notifiers/googleChatNotifier.js +36 -117
  103. package/dist/notifiers/slackNotifier.d.ts +31 -2
  104. package/dist/notifiers/slackNotifier.js +170 -119
  105. package/dist/notifiers/zoomNotifier.js +60 -111
  106. package/dist/openApi.d.ts +1 -7
  107. package/dist/openApi.js +113 -127
  108. package/dist/openApiBuilder.d.ts +14 -3
  109. package/dist/openApiBuilder.js +117 -159
  110. package/dist/openApiCompat.js +81 -148
  111. package/dist/openApiEtag.js +7 -7
  112. package/dist/openApiValidator.d.ts +13 -1
  113. package/dist/openApiValidator.js +301 -246
  114. package/dist/orgs/orgContext.d.ts +23 -0
  115. package/dist/orgs/orgContext.js +128 -0
  116. package/dist/orgs/orgPermissions.d.ts +4 -0
  117. package/dist/orgs/orgPermissions.js +38 -0
  118. package/dist/orgs/orgPlugin.d.ts +13 -0
  119. package/dist/orgs/orgPlugin.js +66 -0
  120. package/dist/orgs/organizationModel.d.ts +13 -0
  121. package/dist/orgs/organizationModel.js +200 -0
  122. package/dist/orgs/organizationSettings.d.ts +19 -0
  123. package/dist/orgs/organizationSettings.js +113 -0
  124. package/dist/orgs/orgsApp.d.ts +28 -0
  125. package/dist/orgs/orgsApp.js +416 -0
  126. package/dist/permissions.d.ts +7 -13
  127. package/dist/permissions.js +95 -211
  128. package/dist/plugins.js +125 -218
  129. package/dist/populate.js +130 -240
  130. package/dist/rateLimit/applyTrustProxy.js +1 -1
  131. package/dist/rateLimit/createStore.js +7 -8
  132. package/dist/rateLimit/memoryStore.js +22 -100
  133. package/dist/rateLimit/middleware.d.ts +0 -8
  134. package/dist/rateLimit/middleware.js +49 -101
  135. package/dist/rateLimit/mongoStore.d.ts +1 -0
  136. package/dist/rateLimit/mongoStore.js +55 -112
  137. package/dist/rateLimit/policies.d.ts +0 -4
  138. package/dist/rateLimit/policies.js +44 -80
  139. package/dist/rateLimit/redisStore.d.ts +1 -0
  140. package/dist/rateLimit/redisStore.js +40 -133
  141. package/dist/rbac/access.js +122 -253
  142. package/dist/rbac/assertAllowed.js +95 -171
  143. package/dist/rbac/auditModel.js +14 -58
  144. package/dist/rbac/backfillAdmins.js +24 -130
  145. package/dist/rbac/fieldViews.js +46 -141
  146. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  147. package/dist/rbac/membershipOrgAdminSource.js +51 -0
  148. package/dist/rbac/middleware.js +30 -96
  149. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  150. package/dist/rbac/modelRouterAccess.js +133 -307
  151. package/dist/rbac/permissionUtils.js +40 -179
  152. package/dist/rbac/realtimeAccess.js +81 -147
  153. package/dist/rbac/resolve.d.ts +1 -1
  154. package/dist/rbac/resolve.js +154 -319
  155. package/dist/rbac/roleManager.js +318 -700
  156. package/dist/rbac/roleModel.d.ts +2 -5
  157. package/dist/rbac/roleModel.js +60 -173
  158. package/dist/rbac/routes.js +93 -196
  159. package/dist/rbac/scopes.js +39 -133
  160. package/dist/rbac/statements.d.ts +10 -1
  161. package/dist/rbac/statements.js +42 -93
  162. package/dist/rbac/types.d.ts +5 -0
  163. package/dist/rbac/userPlugin.js +3 -29
  164. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  165. package/dist/realtime/changeStreamWatcher.js +499 -764
  166. package/dist/realtime/deprecation.d.ts +1 -0
  167. package/dist/realtime/deprecation.js +9 -10
  168. package/dist/realtime/queryMatcher.js +110 -191
  169. package/dist/realtime/queryStore.js +35 -118
  170. package/dist/realtime/realtimeApp.d.ts +1 -0
  171. package/dist/realtime/realtimeApp.js +248 -401
  172. package/dist/realtime/registry.js +19 -30
  173. package/dist/realtime/sessionRevalidation.js +132 -358
  174. package/dist/realtime/socketAuth.js +89 -208
  175. package/dist/realtime/socketUser.js +10 -56
  176. package/dist/requestContext.js +93 -139
  177. package/dist/schemaMetadata.js +181 -265
  178. package/dist/scriptRunner.js +96 -266
  179. package/dist/scrubAdminFields.js +36 -108
  180. package/dist/secretProviders.js +130 -299
  181. package/dist/seedRunner.js +221 -514
  182. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  183. package/dist/sync/adminBroadcastScope.js +82 -0
  184. package/dist/sync/adminWindowAccess.d.ts +13 -0
  185. package/dist/sync/adminWindowAccess.js +25 -0
  186. package/dist/sync/adminWindowMutation.d.ts +88 -0
  187. package/dist/sync/adminWindowMutation.js +176 -0
  188. package/dist/sync/executors.d.ts +9 -3
  189. package/dist/sync/executors.js +425 -598
  190. package/dist/sync/loadHarness.js +392 -689
  191. package/dist/sync/models.js +181 -341
  192. package/dist/sync/mutationHandler.d.ts +5 -2
  193. package/dist/sync/mutationHandler.js +549 -697
  194. package/dist/sync/registrationSideEffects.js +41 -95
  195. package/dist/sync/registry.js +31 -47
  196. package/dist/sync/routes.d.ts +13 -0
  197. package/dist/sync/routes.js +484 -760
  198. package/dist/sync/scripts/compactTombstones.js +83 -228
  199. package/dist/sync/serialize.js +18 -58
  200. package/dist/sync/socketHandlers.d.ts +8 -2
  201. package/dist/sync/socketHandlers.js +271 -402
  202. package/dist/sync/streams.d.ts +2 -0
  203. package/dist/sync/streams.js +54 -116
  204. package/dist/sync/syncApp.d.ts +2 -1
  205. package/dist/sync/syncApp.js +14 -16
  206. package/dist/sync/syncBatch.d.ts +5 -2
  207. package/dist/sync/syncBatch.js +63 -168
  208. package/dist/sync/syncSeqPlugin.js +430 -702
  209. package/dist/sync/types.d.ts +18 -0
  210. package/dist/syncConsents.js +113 -253
  211. package/dist/terrenoApp.d.ts +29 -0
  212. package/dist/terrenoApp.js +184 -257
  213. package/dist/tests/createTestData.d.ts +1 -3
  214. package/dist/tests/createTestData.js +147 -259
  215. package/dist/tests/models.d.ts +1 -0
  216. package/dist/tests/models.js +23 -56
  217. package/dist/tests/mongoTestSetup.js +42 -103
  218. package/dist/tests/testHelper.d.ts +0 -5
  219. package/dist/tests/testHelper.js +32 -101
  220. package/dist/tests.js +12 -51
  221. package/dist/transformers.js +61 -164
  222. package/dist/types/authToken.d.ts +3 -3
  223. package/dist/types/mcpServiceToken.d.ts +2 -2
  224. package/dist/types/membership.d.ts +23 -0
  225. package/dist/types/membership.js +2 -0
  226. package/dist/types/notification.d.ts +28 -0
  227. package/dist/types/notification.js +2 -0
  228. package/dist/types/notificationPreference.d.ts +20 -0
  229. package/dist/types/notificationPreference.js +2 -0
  230. package/dist/types/organization.d.ts +36 -0
  231. package/dist/types/organization.js +2 -0
  232. package/dist/utils.js +31 -93
  233. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  234. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  235. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  236. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  237. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  238. package/dist/versionCheckPlugin.js +52 -100
  239. package/dist/webhooks/headerValue.js +2 -2
  240. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  241. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  242. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  243. package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
  244. package/dist/webhooks/rawBody.d.ts +1 -0
  245. package/dist/webhooks/rawBody.js +2 -1
  246. package/dist/webhooks/timingSafeEqual.js +4 -5
  247. package/dist/webhooks/verifiers/hmac.js +17 -18
  248. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  249. package/dist/webhooks/verifiers/stripe.js +31 -65
  250. package/dist/webhooks/verifiers/twilio.js +23 -73
  251. package/dist/webhooks/webhooksApp.js +78 -177
  252. package/dist/zodOpenApi.js +2 -2
  253. package/package.json +34 -28
  254. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  255. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  256. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  257. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  258. package/src/adminTypes.ts +8 -0
  259. package/src/api.test.ts +39 -2
  260. package/src/api.ts +68 -0
  261. package/src/audit/auditApp.test.ts +243 -0
  262. package/src/audit/auditApp.ts +139 -0
  263. package/src/audit/auditEventModel.ts +160 -0
  264. package/src/audit/auditRouter.test.ts +456 -0
  265. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  266. package/src/audit/cloudTasksEnqueue.ts +104 -0
  267. package/src/audit/diff.ts +163 -0
  268. package/src/audit/processQueue.ts +69 -0
  269. package/src/audit/rbacSink.test.ts +86 -0
  270. package/src/audit/rbacSink.ts +42 -0
  271. package/src/audit/record.test.ts +402 -0
  272. package/src/audit/record.ts +329 -0
  273. package/src/auth.test.ts +1 -1
  274. package/src/auth.ts +1 -1
  275. package/src/authRecovery.test.ts +43 -0
  276. package/src/authRecovery.ts +16 -10
  277. package/src/authTokens.ts +6 -2
  278. package/src/authVerification.test.ts +22 -0
  279. package/src/betterAuth.ts +7 -0
  280. package/src/betterAuthSetup.test.ts +27 -0
  281. package/src/betterAuthSetup.ts +1 -0
  282. package/src/browserLogsRoute.ts +110 -0
  283. package/src/collectionRegistry.test.ts +8 -9
  284. package/src/collectionRegistry.ts +21 -1
  285. package/src/configurationPlugin.test.ts +1 -11
  286. package/src/express.d.ts +2 -0
  287. package/src/expressServer.test.ts +50 -2
  288. package/src/expressServer.ts +10 -0
  289. package/src/frameworkModelNames.test.ts +62 -0
  290. package/src/frameworkModelNames.ts +33 -0
  291. package/src/index.ts +76 -0
  292. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  293. package/src/mcp/auth.test.ts +34 -1
  294. package/src/mcp/handlers.test.ts +275 -0
  295. package/src/mcp/query.ts +3 -3
  296. package/src/mcp/toolGenerator.test.ts +81 -0
  297. package/src/migrations/cli.test.ts +353 -0
  298. package/src/migrations/cli.ts +283 -0
  299. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  300. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  301. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  302. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  303. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  304. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  305. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  306. package/src/migrations/generate.test.ts +333 -0
  307. package/src/migrations/generate.ts +216 -0
  308. package/src/migrations/load.test.ts +103 -0
  309. package/src/migrations/load.ts +124 -0
  310. package/src/migrations/lock.test.ts +133 -0
  311. package/src/migrations/lock.ts +118 -0
  312. package/src/migrations/runner.test.ts +504 -0
  313. package/src/migrations/runner.ts +358 -0
  314. package/src/migrations/schemaCatalog.test.ts +159 -0
  315. package/src/migrations/schemaCatalog.ts +262 -0
  316. package/src/migrations/types.ts +94 -0
  317. package/src/models/mcpServiceToken.ts +4 -3
  318. package/src/models/notification.ts +69 -0
  319. package/src/models/notificationPreference.ts +62 -0
  320. package/src/notifications/notificationService.ts +254 -0
  321. package/src/notifications/notificationsApp.test.ts +528 -0
  322. package/src/notifications/notificationsApp.ts +200 -0
  323. package/src/notifications/notificationsBeforeSend.ts +51 -0
  324. package/src/notifiers/slackNotifier.test.ts +186 -1
  325. package/src/notifiers/slackNotifier.ts +167 -8
  326. package/src/openApi.test.ts +0 -1
  327. package/src/openApi.ts +2 -1
  328. package/src/openApiBuilder.ts +14 -3
  329. package/src/openApiValidator.test.ts +221 -2
  330. package/src/openApiValidator.ts +218 -33
  331. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  332. package/src/orgs/orgContext.test.ts +259 -0
  333. package/src/orgs/orgContext.ts +151 -0
  334. package/src/orgs/orgPermissions.test.ts +105 -0
  335. package/src/orgs/orgPermissions.ts +40 -0
  336. package/src/orgs/orgPlugin.test.ts +130 -0
  337. package/src/orgs/orgPlugin.ts +70 -0
  338. package/src/orgs/orgRbac.test.ts +267 -0
  339. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  340. package/src/orgs/organizationModel.test.ts +205 -0
  341. package/src/orgs/organizationModel.ts +262 -0
  342. package/src/orgs/organizationSettings.test.ts +113 -0
  343. package/src/orgs/organizationSettings.ts +126 -0
  344. package/src/orgs/orgsApp.test.ts +382 -0
  345. package/src/orgs/orgsApp.ts +563 -0
  346. package/src/permissions.test.ts +62 -36
  347. package/src/permissions.ts +8 -30
  348. package/src/plugins.test.ts +5 -0
  349. package/src/plugins.ts +3 -0
  350. package/src/rateLimit/middleware.ts +1 -1
  351. package/src/rateLimit/mongoStore.ts +1 -0
  352. package/src/rateLimit/policies.ts +2 -2
  353. package/src/rateLimit/redisStore.ts +1 -0
  354. package/src/rbac/access.ts +11 -3
  355. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  356. package/src/rbac/modelRouterAccess.ts +3 -0
  357. package/src/rbac/permissionUtils.test.ts +26 -5
  358. package/src/rbac/resolve.test.ts +34 -2
  359. package/src/rbac/resolve.ts +26 -7
  360. package/src/rbac/roleModel.test.ts +34 -1
  361. package/src/rbac/roleModel.ts +17 -1
  362. package/src/rbac/statements.test.ts +19 -0
  363. package/src/rbac/statements.ts +19 -1
  364. package/src/rbac/types.ts +5 -0
  365. package/src/realtime/changeStreamWatcher.ts +73 -33
  366. package/src/realtime/deprecation.ts +1 -0
  367. package/src/realtime/realtime.test.ts +357 -185
  368. package/src/realtime/realtimeApp.ts +2 -1
  369. package/src/schemaMetadata.test.ts +14 -0
  370. package/src/schemaMetadata.ts +5 -5
  371. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  372. package/src/sync/adminBroadcastScope.test.ts +155 -0
  373. package/src/sync/adminBroadcastScope.ts +123 -0
  374. package/src/sync/adminWindowAccess.test.ts +57 -0
  375. package/src/sync/adminWindowAccess.ts +32 -0
  376. package/src/sync/adminWindowMutation.test.ts +450 -0
  377. package/src/sync/adminWindowMutation.ts +283 -0
  378. package/src/sync/executors.ts +33 -6
  379. package/src/sync/integration.test.ts +2 -2
  380. package/src/sync/mutationHandler.test.ts +277 -1
  381. package/src/sync/mutationHandler.ts +171 -29
  382. package/src/sync/registry.ts +4 -0
  383. package/src/sync/routes.ts +52 -8
  384. package/src/sync/socketHandlers.ts +154 -58
  385. package/src/sync/streams.ts +6 -0
  386. package/src/sync/sync.test.ts +3 -2
  387. package/src/sync/syncApp.ts +2 -1
  388. package/src/sync/syncBatch.ts +7 -2
  389. package/src/sync/syncRoutes.test.ts +297 -3
  390. package/src/sync/syncSocket.test.ts +229 -0
  391. package/src/sync/types.ts +20 -0
  392. package/src/terrenoApp.migrations.test.ts +114 -0
  393. package/src/terrenoApp.test.ts +41 -0
  394. package/src/terrenoApp.ts +97 -31
  395. package/src/tests/createTestData.ts +2 -2
  396. package/src/tests/models.ts +10 -2
  397. package/src/tests/testHelper.ts +1 -7
  398. package/src/types/authToken.ts +2 -4
  399. package/src/types/mcpServiceToken.ts +1 -7
  400. package/src/types/membership.ts +48 -0
  401. package/src/types/notification.ts +34 -0
  402. package/src/types/notificationPreference.ts +28 -0
  403. package/src/types/organization.ts +49 -0
  404. package/src/types.d.ts +1 -0
  405. package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
  406. package/src/webhooks/rawBody.test.ts +33 -0
  407. package/src/webhooks/rawBody.ts +1 -0
  408. package/tsconfig.json +13 -54
  409. package/tsconfig.typedoc.json +4 -1
  410. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  411. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  412. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -1,48 +1,12 @@
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
- }
37
- };
38
2
  Object.defineProperty(exports, "__esModule", { value: true });
39
3
  exports.clearSyncIndexCreationTasks = exports.ensureSyncIndexes = exports.applySyncRegistrationSideEffects = exports.trackSyncIndexCreation = void 0;
40
- var errors_1 = require("../errors");
41
- var logger_1 = require("../logger");
42
- var streams_1 = require("./streams");
43
- var indexCreationTasks = [];
4
+ const errors_1 = require("../errors");
5
+ const logger_1 = require("../logger");
6
+ const streams_1 = require("./streams");
7
+ const indexCreationTasks = [];
44
8
  /** Queue extra index work (tests and SyncApp bookkeeping models). */
45
- var trackSyncIndexCreation = function (task) {
9
+ const trackSyncIndexCreation = (task) => {
46
10
  indexCreationTasks.push(task);
47
11
  };
48
12
  exports.trackSyncIndexCreation = trackSyncIndexCreation;
@@ -50,102 +14,84 @@ exports.trackSyncIndexCreation = trackSyncIndexCreation;
50
14
  * Fail loud if the model cannot participate in sync, then queue the
51
15
  * snapshot index. Call only on the first sync enable for a routePath.
52
16
  */
53
- var applySyncRegistrationSideEffects = function (_a) {
54
- var _b;
55
- var config = _a.config, existingSyncEntries = _a.existingSyncEntries, model = _a.model, routePath = _a.routePath;
56
- var name = model.modelName;
57
- var deletedPath = model.schema.path("deleted");
58
- if ((deletedPath === null || deletedPath === void 0 ? void 0 : deletedPath.instance) !== "Boolean") {
17
+ const applySyncRegistrationSideEffects = ({ config, existingSyncEntries, model, routePath, }) => {
18
+ const name = model.modelName;
19
+ const deletedPath = model.schema.path("deleted");
20
+ if (deletedPath?.instance !== "Boolean") {
59
21
  throw new errors_1.APIError({
60
22
  status: 500,
61
- title: "Model ".concat(name, " has a sync config but no soft delete support. ") +
23
+ title: `Model ${name} has a sync config but no soft delete support. ` +
62
24
  "Apply isDeletedPlugin to the schema — sync catch-up requires delete tombstones.",
63
25
  });
64
26
  }
65
27
  if (!model.schema.path("_syncSeq")) {
66
28
  throw new errors_1.APIError({
67
29
  status: 500,
68
- title: "Model ".concat(name, " has a sync config but syncPlugin is not applied to its schema. ") +
30
+ title: `Model ${name} has a sync config but syncPlugin is not applied to its schema. ` +
69
31
  "Apply syncPlugin so every write stamps a per-stream _syncSeq.",
70
32
  });
71
33
  }
72
- var scopeField = (0, streams_1.getScopeField)(config.scope);
34
+ const scopeField = (0, streams_1.getScopeField)(config.scope);
73
35
  if (scopeField && !model.schema.path(scopeField)) {
74
36
  throw new errors_1.APIError({
75
37
  status: 500,
76
- title: "Model ".concat(name, " has a sync scope on field \"").concat(scopeField, "\" but the schema has no such path."),
38
+ title: `Model ${name} has a sync scope on field "${scopeField}" but the schema has no such path.`,
77
39
  });
78
40
  }
79
41
  if (typeof config.scope === "function" && !config.snapshotFilter) {
80
42
  throw new errors_1.APIError({
81
43
  status: 500,
82
- title: "Model ".concat(name, " uses a custom sync scope resolver, which requires a snapshotFilter ") +
44
+ title: `Model ${name} uses a custom sync scope resolver, which requires a snapshotFilter ` +
83
45
  "so the snapshot endpoint can restrict queries to the caller's documents.",
84
46
  });
85
47
  }
86
- if (existingSyncEntries.some(function (entry) { return entry.modelName === name; })) {
48
+ if (existingSyncEntries.some((entry) => entry.modelName === name)) {
87
49
  throw new errors_1.APIError({
88
50
  status: 500,
89
- title: "Model ".concat(name, " is already registered for sync."),
51
+ title: `Model ${name} is already registered for sync.`,
90
52
  });
91
53
  }
92
- var collectionTag = routePath.replace(/^\//, "");
93
- if (existingSyncEntries.some(function (entry) { return entry.collectionTag === collectionTag; })) {
54
+ const collectionTag = routePath.replace(/^\//, "");
55
+ if (existingSyncEntries.some((entry) => entry.collectionTag === collectionTag)) {
94
56
  throw new errors_1.APIError({
95
57
  status: 500,
96
- title: "Sync collection tag \"".concat(collectionTag, "\" is already registered (routePath ").concat(routePath, "). ") +
58
+ title: `Sync collection tag "${collectionTag}" is already registered (routePath ${routePath}). ` +
97
59
  "Each synced model must have a unique route path.",
98
60
  });
99
61
  }
100
- model.bulkWrite = function () {
62
+ model.bulkWrite = () => {
101
63
  throw new errors_1.APIError({
102
64
  status: 500,
103
- title: "bulkWrite is not supported on sync-enabled model ".concat(name, ": it bypasses Mongoose ") +
65
+ title: `bulkWrite is not supported on sync-enabled model ${name}: it bypasses Mongoose ` +
104
66
  "middleware, so writes are never stamped with a per-stream _syncSeq and become " +
105
67
  "invisible to sync delta emission and snapshot catch-up. Loop per document instead.",
106
68
  });
107
69
  };
108
- var indexSpec = scopeField ? (_b = {}, _b[scopeField] = 1, _b._syncSeq = 1, _b) : { _syncSeq: 1 };
109
- indexCreationTasks.push(function () { return __awaiter(void 0, void 0, void 0, function () {
110
- var error_1;
111
- return __generator(this, function (_a) {
112
- switch (_a.label) {
113
- case 0:
114
- _a.trys.push([0, 2, , 3]);
115
- return [4 /*yield*/, model.collection.createIndex(indexSpec)];
116
- case 1:
117
- _a.sent();
118
- return [3 /*break*/, 3];
119
- case 2:
120
- error_1 = _a.sent();
121
- logger_1.logger.error("[sync] Failed to create sync index for ".concat(name), { error: String(error_1) });
122
- throw new errors_1.APIError({
123
- cause: error_1,
124
- code: "sync-snapshot-index-failed",
125
- detail: "".concat((0, errors_1.errorDetail)(error_1), ". The snapshot/catch-up query requires this index; fix the schema/DB and restart."),
126
- status: 500,
127
- title: "Failed to create sync snapshot index for ".concat(name),
128
- });
129
- case 3: return [2 /*return*/];
130
- }
131
- });
132
- }); });
70
+ const indexSpec = scopeField ? { [scopeField]: 1, _syncSeq: 1 } : { _syncSeq: 1 };
71
+ indexCreationTasks.push(async () => {
72
+ try {
73
+ await model.collection.createIndex(indexSpec);
74
+ }
75
+ catch (error) {
76
+ logger_1.logger.error(`[sync] Failed to create sync index for ${name}`, { error: String(error) });
77
+ throw new errors_1.APIError({
78
+ cause: error,
79
+ code: "sync-snapshot-index-failed",
80
+ detail: `${(0, errors_1.errorDetail)(error)}. The snapshot/catch-up query requires this index; fix the schema/DB and restart.`,
81
+ status: 500,
82
+ title: `Failed to create sync snapshot index for ${name}`,
83
+ });
84
+ }
85
+ });
133
86
  };
134
87
  exports.applySyncRegistrationSideEffects = applySyncRegistrationSideEffects;
135
88
  /** Create every queued sync index after Mongo is connected. */
136
- var ensureSyncIndexes = function () { return __awaiter(void 0, void 0, void 0, function () {
137
- return __generator(this, function (_a) {
138
- switch (_a.label) {
139
- case 0: return [4 /*yield*/, Promise.all(indexCreationTasks.map(function (task) { return task(); }))];
140
- case 1:
141
- _a.sent();
142
- return [2 /*return*/];
143
- }
144
- });
145
- }); };
89
+ const ensureSyncIndexes = async () => {
90
+ await Promise.all(indexCreationTasks.map((task) => task()));
91
+ };
146
92
  exports.ensureSyncIndexes = ensureSyncIndexes;
147
93
  /** Drop queued index work when the collection catalog is wiped (tests). */
148
- var clearSyncIndexCreationTasks = function () {
94
+ const clearSyncIndexCreationTasks = () => {
149
95
  indexCreationTasks.length = 0;
150
96
  };
151
97
  exports.clearSyncIndexCreationTasks = clearSyncIndexCreationTasks;
@@ -1,61 +1,49 @@
1
1
  "use strict";
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);
12
- };
13
2
  Object.defineProperty(exports, "__esModule", { value: true });
14
3
  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");
16
- var logger_1 = require("../logger");
17
- var registrationSideEffects_1 = require("./registrationSideEffects");
4
+ const collectionRegistry_1 = require("../collectionRegistry");
5
+ const logger_1 = require("../logger");
6
+ const adminBroadcastScope_1 = require("./adminBroadcastScope");
7
+ const adminWindowMutation_1 = require("./adminWindowMutation");
8
+ const registrationSideEffects_1 = require("./registrationSideEffects");
18
9
  Object.defineProperty(exports, "ensureSyncIndexes", { enumerable: true, get: function () { return registrationSideEffects_1.ensureSyncIndexes; } });
19
10
  Object.defineProperty(exports, "trackSyncIndexCreation", { enumerable: true, get: function () { return registrationSideEffects_1.trackSyncIndexCreation; } });
20
- var toSyncEntry = function (record) { return ({
11
+ const toSyncEntry = (record) => ({
21
12
  collectionName: record.model.collection.collectionName,
22
13
  collectionTag: record.routePath.replace(/^\//, ""),
23
14
  config: record.options.sync,
24
15
  modelName: record.model.modelName,
25
16
  options: record.options,
26
17
  routePath: record.routePath,
27
- }); };
28
- var syncCollections = function () {
29
- return (0, collectionRegistry_1.listCollections)()
30
- .filter(function (record) { return record.surfaces.sync; })
31
- .map(toSyncEntry);
32
- };
33
- var registerSync = function (_a) {
34
- var model = _a.model, routePath = _a.routePath, config = _a.config, options = _a.options;
18
+ });
19
+ const syncCollections = () => (0, collectionRegistry_1.listCollections)()
20
+ .filter((record) => record.surfaces.sync)
21
+ .map(toSyncEntry);
22
+ const registerSync = ({ model, routePath, config, options, }) => {
35
23
  (0, collectionRegistry_1.registerCollection)({
36
- model: model,
37
- options: __assign(__assign({}, options), { sync: config }),
38
- routePath: routePath,
24
+ model,
25
+ options: {
26
+ ...options,
27
+ sync: config,
28
+ },
29
+ routePath,
39
30
  });
40
31
  };
41
32
  exports.registerSync = registerSync;
42
- var updateSyncRegistryOptions = function (routePath, options) {
33
+ const updateSyncRegistryOptions = (routePath, options) => {
43
34
  (0, collectionRegistry_1.replaceCollectionOptions)(routePath, options);
44
35
  };
45
36
  exports.updateSyncRegistryOptions = updateSyncRegistryOptions;
46
- var getSyncRegistry = function () { return syncCollections(); };
37
+ const getSyncRegistry = () => syncCollections();
47
38
  exports.getSyncRegistry = getSyncRegistry;
48
- var scopesRequiringFullUser = function () {
49
- return syncCollections()
50
- .filter(function (entry) { return typeof entry.config.scope === "function" || entry.config.scope.type === "tenant"; })
51
- .map(function (entry) { return entry.collectionTag; });
52
- };
53
- var warnOnSyncScopesWithoutUserModel = function (_a) {
54
- var userModel = _a.userModel;
39
+ const scopesRequiringFullUser = () => syncCollections()
40
+ .filter((entry) => typeof entry.config.scope === "function" || entry.config.scope.type === "tenant")
41
+ .map((entry) => entry.collectionTag);
42
+ const warnOnSyncScopesWithoutUserModel = ({ userModel }) => {
55
43
  if (userModel) {
56
44
  return [];
57
45
  }
58
- var collections = scopesRequiringFullUser();
46
+ const collections = scopesRequiringFullUser();
59
47
  if (collections.length === 0) {
60
48
  return [];
61
49
  }
@@ -63,24 +51,20 @@ var warnOnSyncScopesWithoutUserModel = function (_a) {
63
51
  "userModel: socket authorization will fall back to the synthetic JWT-claim user, which " +
64
52
  "carries no membership fields, so tenant streams resolve to nothing and `admin` is " +
65
53
  "trusted from the token instead of the database. Pass `userModel` in RealtimeAppOptions " +
66
- "(TerrenoApp does this automatically for its own userModel).", { collections: collections });
54
+ "(TerrenoApp does this automatically for its own userModel).", { collections });
67
55
  return collections;
68
56
  };
69
57
  exports.warnOnSyncScopesWithoutUserModel = warnOnSyncScopesWithoutUserModel;
70
- var findSyncEntryByModelName = function (modelName) {
71
- return syncCollections().find(function (entry) { return entry.modelName === modelName; });
72
- };
58
+ const findSyncEntryByModelName = (modelName) => syncCollections().find((entry) => entry.modelName === modelName);
73
59
  exports.findSyncEntryByModelName = findSyncEntryByModelName;
74
- var findSyncEntryByCollectionTag = function (collectionTag) {
75
- return syncCollections().find(function (entry) { return entry.collectionTag === collectionTag; });
76
- };
60
+ const findSyncEntryByCollectionTag = (collectionTag) => syncCollections().find((entry) => entry.collectionTag === collectionTag);
77
61
  exports.findSyncEntryByCollectionTag = findSyncEntryByCollectionTag;
78
- var findSyncEntryByCollectionName = function (collectionName) {
79
- return syncCollections().find(function (entry) { return entry.collectionName === collectionName; });
80
- };
62
+ const findSyncEntryByCollectionName = (collectionName) => syncCollections().find((entry) => entry.collectionName === collectionName);
81
63
  exports.findSyncEntryByCollectionName = findSyncEntryByCollectionName;
82
- var clearSyncRegistry = function () {
64
+ const clearSyncRegistry = () => {
83
65
  (0, collectionRegistry_1.clearCollectionRegistry)();
84
66
  (0, registrationSideEffects_1.clearSyncIndexCreationTasks)();
67
+ (0, adminBroadcastScope_1.clearAdminBroadcastScopes)();
68
+ (0, adminWindowMutation_1.clearAdminWindowMutationScopes)();
85
69
  };
86
70
  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: