@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
@@ -7,7 +7,8 @@
7
7
  *
8
8
  * Validation is always installed as middleware but only activates after
9
9
  * `configureOpenApiValidator()` is called. This makes it safe to include
10
- * in modelRouter by default.
10
+ * in modelRouter by default. Create bodies enforce Mongoose required fields;
11
+ * PATCH/update bodies are partial (present fields only).
11
12
  *
12
13
  * @module openApiValidator
13
14
  *
@@ -96,10 +97,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
96
97
  return (mod && mod.__esModule) ? mod : { "default": mod };
97
98
  };
98
99
  Object.defineProperty(exports, "__esModule", { value: true });
99
- exports.buildQuerySchemaFromFields = exports.createModelValidators = exports.validateModelRequestBody = exports.getSchemaFromModel = exports.validateResponseData = exports.createValidator = exports.validateQueryParams = exports.validateRequestBody = exports.resetOpenApiValidatorConfig = exports.getOpenApiValidatorConfig = exports.configureOpenApiValidator = exports.isOpenApiValidatorConfigured = void 0;
100
+ exports.buildQuerySchemaFromFields = exports.buildNumericListQueryFieldSchema = exports.buildStringListQueryFieldSchema = exports.createModelValidators = exports.validateModelRequestBody = exports.getSchemaFromModel = exports.validateResponseData = exports.createValidator = exports.validateQueryParams = exports.validateRequestBody = exports.isEscapedRegexLiteral = exports.resetOpenApiValidatorConfig = exports.getOpenApiValidatorConfig = exports.configureOpenApiValidator = exports.isOpenApiValidatorConfigured = void 0;
100
101
  var ajv_1 = __importDefault(require("ajv"));
101
102
  var ajv_formats_1 = __importDefault(require("ajv-formats"));
102
- var mongoose_to_swagger_1 = __importDefault(require("mongoose-to-swagger"));
103
+ var adminTypes_1 = require("./adminTypes");
103
104
  var errors_1 = require("./errors");
104
105
  var logger_1 = require("./logger");
105
106
  var populate_1 = require("./populate");
@@ -191,9 +192,12 @@ var getAjvInstance = function () {
191
192
  useDefaults: true,
192
193
  validateSchema: false,
193
194
  });
194
- // noExplicitAny: ajv-formats has a known type compat issue with AJV instances
195
- // biome-ignore lint/suspicious/noExplicitAny: ajv-formats has a known type compat issue with AJV instances
196
195
  (0, ajv_formats_1.default)(instance);
196
+ instance.addKeyword({
197
+ keyword: ESCAPED_REGEX_LITERAL_KEYWORD,
198
+ type: "string",
199
+ validate: function (_enabled, data) { return (0, exports.isEscapedRegexLiteral)(data); },
200
+ });
197
201
  ajvCache.set(key, instance);
198
202
  }
199
203
  return instance;
@@ -215,6 +219,42 @@ var VALID_JSON_SCHEMA_TYPES = new Set([
215
219
  "object",
216
220
  "null",
217
221
  ]);
222
+ var REGEX_META_CHARACTERS = new Set([
223
+ "\\",
224
+ ".",
225
+ "*",
226
+ "+",
227
+ "?",
228
+ "^",
229
+ "$",
230
+ "{",
231
+ "}",
232
+ "(",
233
+ ")",
234
+ "|",
235
+ "[",
236
+ "]",
237
+ ]);
238
+ /** Accepts literal text and escaped metacharacters (e.g. `\\.`), rejects executable patterns. */
239
+ var isEscapedRegexLiteral = function (value) {
240
+ for (var index = 0; index < value.length; index += 1) {
241
+ var character = value[index];
242
+ if (character === "\\") {
243
+ var escapedCharacter = value[index + 1];
244
+ if (!escapedCharacter || !REGEX_META_CHARACTERS.has(escapedCharacter)) {
245
+ return false;
246
+ }
247
+ index += 1;
248
+ continue;
249
+ }
250
+ if (REGEX_META_CHARACTERS.has(character)) {
251
+ return false;
252
+ }
253
+ }
254
+ return true;
255
+ };
256
+ exports.isEscapedRegexLiteral = isEscapedRegexLiteral;
257
+ var ESCAPED_REGEX_LITERAL_KEYWORD = "escapedRegexLiteral";
218
258
  // mongoose-to-swagger emits non-standard type strings for some Mongoose types
219
259
  var MONGOOSE_TYPE_MAP = {
220
260
  dateonly: { format: "date", type: "string" },
@@ -268,8 +308,56 @@ var sanitizeSchemaForAjv = function (schema) {
268
308
  if (result.additionalProperties && typeof result.additionalProperties === "object") {
269
309
  result.additionalProperties = sanitizeSchemaForAjv(result.additionalProperties);
270
310
  }
311
+ if (Array.isArray(result.oneOf)) {
312
+ result.oneOf = result.oneOf.map(function (entry) {
313
+ return typeof entry === "object" && entry !== null
314
+ ? sanitizeSchemaForAjv(entry)
315
+ : entry;
316
+ });
317
+ }
318
+ if (typeof result.required === "boolean") {
319
+ delete result.required;
320
+ }
271
321
  return result;
272
322
  };
323
+ var stripBooleanRequiredFlag = function (schema) {
324
+ if (schema.required === true || schema.required === false) {
325
+ var _1 = schema.required, rest = __rest(schema, ["required"]);
326
+ var cleaned = __assign({}, rest);
327
+ if (cleaned.properties) {
328
+ cleaned.properties = Object.fromEntries(Object.entries(cleaned.properties).map(function (_a) {
329
+ var _b = __read(_a, 2), key = _b[0], value = _b[1];
330
+ return [
331
+ key,
332
+ stripBooleanRequiredFlag(value),
333
+ ];
334
+ }));
335
+ }
336
+ if (cleaned.items) {
337
+ cleaned.items = stripBooleanRequiredFlag(cleaned.items);
338
+ }
339
+ if (cleaned.oneOf) {
340
+ cleaned.oneOf = cleaned.oneOf.map(function (entry) { return stripBooleanRequiredFlag(entry); });
341
+ }
342
+ return cleaned;
343
+ }
344
+ if (schema.properties) {
345
+ return __assign(__assign({}, schema), { properties: Object.fromEntries(Object.entries(schema.properties).map(function (_a) {
346
+ var _b = __read(_a, 2), key = _b[0], value = _b[1];
347
+ return [
348
+ key,
349
+ stripBooleanRequiredFlag(value),
350
+ ];
351
+ })) });
352
+ }
353
+ if (schema.items) {
354
+ return __assign(__assign({}, schema), { items: stripBooleanRequiredFlag(schema.items) });
355
+ }
356
+ if (schema.oneOf) {
357
+ return __assign(__assign({}, schema), { oneOf: schema.oneOf.map(function (entry) { return stripBooleanRequiredFlag(entry); }) });
358
+ }
359
+ return schema;
360
+ };
273
361
  /**
274
362
  * Get or create a compiled validator for a schema.
275
363
  * Uses the current config so changes take effect on next call.
@@ -314,26 +402,30 @@ var formatValidationErrors = function (errors) {
314
402
  * Strips `required` from individual properties (OpenAPI-style) and moves it
315
403
  * to the schema-level `required` array (JSON Schema-style) for AJV compatibility.
316
404
  */
317
- var propertiesToSchema = function (properties, requiredFields) {
405
+ var propertiesToSchema = function (properties, requiredFields, options) {
318
406
  var e_2, _a;
319
- // Extract required fields from properties that have required: true
320
- var autoRequired = Object.entries(properties)
321
- .filter(function (_a) {
322
- var _b = __read(_a, 2), _ = _b[0], prop = _b[1];
323
- return prop.required;
324
- })
325
- .map(function (_a) {
326
- var _b = __read(_a, 1), key = _b[0];
327
- return key;
328
- });
329
- var allRequired = __spreadArray([], __read(new Set(__spreadArray(__spreadArray([], __read((requiredFields !== null && requiredFields !== void 0 ? requiredFields : [])), false), __read(autoRequired), false))), false);
330
- // Strip `required` from individual properties — AJV only accepts `required` at schema level
407
+ // Extract required fields from properties marked required: true (OpenAPI builder style).
408
+ // PATCH bodies are partial: omit mongoose/OpenAPI required so one field can be sent.
409
+ var autoRequired = (options === null || options === void 0 ? void 0 : options.partial)
410
+ ? []
411
+ : Object.entries(properties)
412
+ .filter(function (_a) {
413
+ var _b = __read(_a, 2), _ = _b[0], prop = _b[1];
414
+ return prop.required === true;
415
+ })
416
+ .map(function (_a) {
417
+ var _b = __read(_a, 1), key = _b[0];
418
+ return key;
419
+ });
420
+ var allRequired = (options === null || options === void 0 ? void 0 : options.partial)
421
+ ? []
422
+ : __spreadArray([], __read(new Set(__spreadArray(__spreadArray([], __read((requiredFields !== null && requiredFields !== void 0 ? requiredFields : [])), false), __read(autoRequired), false))), false);
423
+ // Strip boolean `required` from individual properties — AJV only accepts `required` arrays on objects
331
424
  var cleanedProperties = {};
332
425
  try {
333
426
  for (var _b = __values(Object.entries(properties)), _c = _b.next(); !_c.done; _c = _b.next()) {
334
427
  var _d = __read(_c.value, 2), key = _d[0], prop = _d[1];
335
- var _1 = prop.required, rest = __rest(prop, ["required"]);
336
- cleanedProperties[key] = rest;
428
+ cleanedProperties[key] = stripBooleanRequiredFlag(prop);
337
429
  }
338
430
  }
339
431
  catch (e_2_1) { e_2 = { error: e_2_1 }; }
@@ -366,7 +458,9 @@ var propertiesToSchema = function (properties, requiredFields) {
366
458
  * @returns Express middleware function
367
459
  */
368
460
  var validateRequestBody = function (schema, options) {
369
- var fullSchema = propertiesToSchema(schema, options === null || options === void 0 ? void 0 : options.required);
461
+ var fullSchema = propertiesToSchema(schema, options === null || options === void 0 ? void 0 : options.required, {
462
+ partial: options === null || options === void 0 ? void 0 : options.partial,
463
+ });
370
464
  return function (req, _res, next) {
371
465
  var _a, _b, _c;
372
466
  // No-op if not configured
@@ -588,9 +682,6 @@ var validateResponseData = function (data, schema) {
588
682
  return { valid: true };
589
683
  };
590
684
  exports.validateResponseData = validateResponseData;
591
- var m2sOptions = {
592
- props: ["readOnly", "required", "enum", "default"],
593
- };
594
685
  /**
595
686
  * Extract an OpenAPI-compatible schema from a Mongoose model.
596
687
  * This allows you to use the same schema definitions for both documentation
@@ -600,18 +691,16 @@ var m2sOptions = {
600
691
  * @returns Schema properties suitable for validation
601
692
  */
602
693
  var getSchemaFromModel = function (model) {
603
- var modelSwagger = (0, mongoose_to_swagger_1.default)(model, m2sOptions);
604
- (0, populate_1.fixMixedFields)(model.schema, modelSwagger.properties);
605
- return modelSwagger.properties;
694
+ var properties = (0, populate_1.getOpenApiSpecForModel)(model).properties;
695
+ return properties;
606
696
  };
607
697
  exports.getSchemaFromModel = getSchemaFromModel;
608
698
  /**
609
699
  * Extract required field names from a Mongoose model's swagger schema.
610
700
  */
611
701
  var getRequiredFieldsFromModel = function (model) {
612
- var _a;
613
- var modelSwagger = (0, mongoose_to_swagger_1.default)(model, m2sOptions);
614
- return (_a = modelSwagger.required) !== null && _a !== void 0 ? _a : [];
702
+ var required = (0, populate_1.getOpenApiSpecForModel)(model).required;
703
+ return required;
615
704
  };
616
705
  /**
617
706
  * Creates a request body validator middleware from a Mongoose model.
@@ -624,7 +713,7 @@ var getRequiredFieldsFromModel = function (model) {
624
713
  var validateModelRequestBody = function (model, options) {
625
714
  var _a, _b;
626
715
  var schema = (0, exports.getSchemaFromModel)(model);
627
- var requiredFields = getRequiredFieldsFromModel(model);
716
+ var requiredFields = (options === null || options === void 0 ? void 0 : options.partial) ? [] : getRequiredFieldsFromModel(model);
628
717
  if ((_a = options === null || options === void 0 ? void 0 : options.excludeFields) === null || _a === void 0 ? void 0 : _a.length) {
629
718
  var excluded_1 = new Set(options.excludeFields);
630
719
  schema = Object.fromEntries(Object.entries(schema).filter(function (_a) {
@@ -633,7 +722,7 @@ var validateModelRequestBody = function (model, options) {
633
722
  }));
634
723
  requiredFields = requiredFields.filter(function (f) { return !excluded_1.has(f); });
635
724
  }
636
- return (0, exports.validateRequestBody)(schema, __assign(__assign({}, options), { required: __spreadArray(__spreadArray([], __read(((_b = options === null || options === void 0 ? void 0 : options.required) !== null && _b !== void 0 ? _b : [])), false), __read(requiredFields), false) }));
725
+ return (0, exports.validateRequestBody)(schema, __assign(__assign({}, options), { required: (options === null || options === void 0 ? void 0 : options.partial) ? [] : __spreadArray(__spreadArray([], __read(((_b = options === null || options === void 0 ? void 0 : options.required) !== null && _b !== void 0 ? _b : [])), false), __read(requiredFields), false) }));
637
726
  };
638
727
  exports.validateModelRequestBody = validateModelRequestBody;
639
728
  /**
@@ -656,10 +745,78 @@ var createModelValidators = function (model, options) {
656
745
  enabled: options === null || options === void 0 ? void 0 : options.validateUpdate,
657
746
  onAdditionalPropertiesRemoved: options === null || options === void 0 ? void 0 : options.onAdditionalPropertiesRemoved,
658
747
  onError: options === null || options === void 0 ? void 0 : options.onError,
748
+ partial: true,
659
749
  }),
660
750
  };
661
751
  };
662
752
  exports.createModelValidators = createModelValidators;
753
+ var choiceEmptyInItemSchema = function (baseItem) {
754
+ if (baseItem.enum) {
755
+ return {
756
+ oneOf: [
757
+ { enum: baseItem.enum, type: "string" },
758
+ { enum: [adminTypes_1.ADMIN_LIST_CHOICE_EMPTY_VALUE], type: "string" },
759
+ ],
760
+ };
761
+ }
762
+ return {
763
+ oneOf: [
764
+ stripBooleanRequiredFlag(baseItem),
765
+ { enum: [adminTypes_1.ADMIN_LIST_CHOICE_EMPTY_VALUE], type: "string" },
766
+ ],
767
+ };
768
+ };
769
+ var buildInOperatorSchema = function (itemSchema) { return ({
770
+ additionalProperties: false,
771
+ properties: {
772
+ $in: {
773
+ items: itemSchema,
774
+ minItems: 1,
775
+ type: "array",
776
+ },
777
+ },
778
+ required: ["$in"],
779
+ type: "object",
780
+ }); };
781
+ var buildRegexOperatorSchema = function () { return ({
782
+ additionalProperties: false,
783
+ properties: {
784
+ $options: { enum: ["i"], type: "string" },
785
+ $regex: { escapedRegexLiteral: true, type: "string" },
786
+ },
787
+ required: ["$regex", "$options"],
788
+ type: "object",
789
+ }); };
790
+ var buildRangeOperatorSchema = function (valueSchema) { return ({
791
+ additionalProperties: false,
792
+ properties: {
793
+ $gt: valueSchema,
794
+ $gte: valueSchema,
795
+ $lt: valueSchema,
796
+ $lte: valueSchema,
797
+ },
798
+ type: "object",
799
+ }); };
800
+ /** Query schema for string/enum fields: scalar, `$in`, or escaped `$regex`. */
801
+ var buildStringListQueryFieldSchema = function (fieldSchema) {
802
+ var scalar = stripBooleanRequiredFlag(fieldSchema);
803
+ var inItems = fieldSchema.enum
804
+ ? choiceEmptyInItemSchema(fieldSchema)
805
+ : stripBooleanRequiredFlag(fieldSchema);
806
+ return {
807
+ oneOf: [scalar, buildInOperatorSchema(inItems), buildRegexOperatorSchema()],
808
+ };
809
+ };
810
+ exports.buildStringListQueryFieldSchema = buildStringListQueryFieldSchema;
811
+ /** Query schema for number/date fields: scalar or comparison operators. */
812
+ var buildNumericListQueryFieldSchema = function (fieldSchema) {
813
+ var scalar = stripBooleanRequiredFlag(fieldSchema);
814
+ var valueSchema = stripBooleanRequiredFlag(fieldSchema);
815
+ return {
816
+ oneOf: [scalar, buildRangeOperatorSchema(valueSchema)],
817
+ };
818
+ };
819
+ exports.buildNumericListQueryFieldSchema = buildNumericListQueryFieldSchema;
663
820
  /**
664
821
  * Build a query parameter schema from a model's Mongoose schema and queryFields array.
665
822
  * Always includes pagination parameters (limit, page, sort).
@@ -681,14 +838,19 @@ var buildQuerySchemaFromFields = function (model, queryFields) {
681
838
  for (var queryFields_1 = __values(queryFields), queryFields_1_1 = queryFields_1.next(); !queryFields_1_1.done; queryFields_1_1 = queryFields_1.next()) {
682
839
  var field = queryFields_1_1.value;
683
840
  var modelField = modelSchema[field];
684
- if (modelField) {
685
- // Use the model's type info, but mark as not required for queries
686
- querySchema[field] = __assign(__assign({}, modelField), { required: false });
841
+ if (!modelField) {
842
+ querySchema[field] = (0, exports.buildStringListQueryFieldSchema)({ type: "string" });
843
+ continue;
844
+ }
845
+ if (modelField.type === "boolean") {
846
+ querySchema[field] = stripBooleanRequiredFlag(modelField);
847
+ continue;
687
848
  }
688
- else {
689
- // Field not in model schema — allow as string
690
- querySchema[field] = { type: "string" };
849
+ if (modelField.type === "number" || modelField.format === "date-time") {
850
+ querySchema[field] = (0, exports.buildNumericListQueryFieldSchema)(modelField);
851
+ continue;
691
852
  }
853
+ querySchema[field] = (0, exports.buildStringListQueryFieldSchema)(modelField);
692
854
  }
693
855
  }
694
856
  catch (e_3_1) { e_3 = { error: e_3_1 }; }
@@ -0,0 +1,23 @@
1
+ import type { RequestHandler } from "express";
2
+ import type { User } from "../auth";
3
+ import type { MembershipDocument } from "../types/membership";
4
+ import type { OrganizationDocument } from "../types/organization";
5
+ export declare const ORGANIZATION_ID_HEADER = "x-organization-id";
6
+ export declare const ORGANIZATION_DISABLED_TITLE = "Organization is disabled";
7
+ export declare const PLATFORM_ORG_ROLE_NAMES: readonly ["operator", "superadmin"];
8
+ export interface ResolvedOrgContext {
9
+ membership?: MembershipDocument;
10
+ organization?: OrganizationDocument;
11
+ }
12
+ export declare const getOrgContext: () => ResolvedOrgContext | undefined;
13
+ export declare const runWithOrgContext: <T>(context: ResolvedOrgContext, fn: () => T) => T;
14
+ export declare const isPlatformOrgActor: (user?: User) => boolean;
15
+ export declare const assertOrganizationEnabled: (organization: OrganizationDocument) => void;
16
+ export declare const resolveOrgContext: (args: {
17
+ organizationId?: string;
18
+ required: boolean;
19
+ user?: User;
20
+ }) => Promise<ResolvedOrgContext>;
21
+ export declare const orgContextMiddleware: (options?: {
22
+ required?: boolean;
23
+ }) => RequestHandler;
@@ -0,0 +1,198 @@
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
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ exports.orgContextMiddleware = exports.resolveOrgContext = exports.assertOrganizationEnabled = exports.isPlatformOrgActor = exports.runWithOrgContext = exports.getOrgContext = exports.PLATFORM_ORG_ROLE_NAMES = exports.ORGANIZATION_DISABLED_TITLE = exports.ORGANIZATION_ID_HEADER = void 0;
40
+ var node_async_hooks_1 = require("node:async_hooks");
41
+ var errors_1 = require("../errors");
42
+ var utils_1 = require("../utils");
43
+ var organizationModel_1 = require("./organizationModel");
44
+ exports.ORGANIZATION_ID_HEADER = "x-organization-id";
45
+ exports.ORGANIZATION_DISABLED_TITLE = "Organization is disabled";
46
+ exports.PLATFORM_ORG_ROLE_NAMES = ["operator", "superadmin"];
47
+ var orgContextAls = new node_async_hooks_1.AsyncLocalStorage();
48
+ var getOrgContext = function () {
49
+ return orgContextAls.getStore();
50
+ };
51
+ exports.getOrgContext = getOrgContext;
52
+ var runWithOrgContext = function (context, fn) {
53
+ return orgContextAls.run(context, fn);
54
+ };
55
+ exports.runWithOrgContext = runWithOrgContext;
56
+ var isPlatformOrgActor = function (user) {
57
+ var _a;
58
+ if (!user) {
59
+ return false;
60
+ }
61
+ var roles = (_a = user.roles) !== null && _a !== void 0 ? _a : [];
62
+ return roles.includes("operator") || roles.includes("superadmin");
63
+ };
64
+ exports.isPlatformOrgActor = isPlatformOrgActor;
65
+ var readOrganizationIdHeader = function (req) {
66
+ var raw = req.header("X-Organization-Id");
67
+ if (typeof raw !== "string") {
68
+ return undefined;
69
+ }
70
+ var trimmed = raw.trim();
71
+ if (!trimmed) {
72
+ return undefined;
73
+ }
74
+ return trimmed;
75
+ };
76
+ var userIdForMembership = function (user) {
77
+ if (user._id) {
78
+ return String(user._id);
79
+ }
80
+ return user.id;
81
+ };
82
+ var loadOrganization = function (id) { return __awaiter(void 0, void 0, void 0, function () {
83
+ var organization;
84
+ return __generator(this, function (_a) {
85
+ switch (_a.label) {
86
+ case 0:
87
+ if (!(0, utils_1.isValidObjectId)(id)) {
88
+ throw new errors_1.BadRequestError("Invalid organization id");
89
+ }
90
+ return [4 /*yield*/, organizationModel_1.Organization.findOneOrNone({ _id: id })];
91
+ case 1:
92
+ organization = _a.sent();
93
+ if (!organization) {
94
+ throw new errors_1.NotFoundError("Organization not found");
95
+ }
96
+ return [2 /*return*/, organization];
97
+ }
98
+ });
99
+ }); };
100
+ var assertOrganizationEnabled = function (organization) {
101
+ if (organization.disabled) {
102
+ throw new errors_1.ForbiddenError(exports.ORGANIZATION_DISABLED_TITLE);
103
+ }
104
+ };
105
+ exports.assertOrganizationEnabled = assertOrganizationEnabled;
106
+ var resolveOrgContext = function (args) { return __awaiter(void 0, void 0, void 0, function () {
107
+ var user, platform, organization, membership, active, adminMemberships, membership, organization;
108
+ return __generator(this, function (_a) {
109
+ switch (_a.label) {
110
+ case 0:
111
+ user = args.user;
112
+ if (!(user === null || user === void 0 ? void 0 : user.id)) {
113
+ if (args.required) {
114
+ throw new errors_1.APIError({ status: 401, title: "Unauthorized" });
115
+ }
116
+ return [2 /*return*/, {}];
117
+ }
118
+ platform = (0, exports.isPlatformOrgActor)(user);
119
+ if (!args.organizationId) return [3 /*break*/, 3];
120
+ return [4 /*yield*/, loadOrganization(args.organizationId)];
121
+ case 1:
122
+ organization = _a.sent();
123
+ (0, exports.assertOrganizationEnabled)(organization);
124
+ return [4 /*yield*/, organizationModel_1.Membership.findOneOrNone({
125
+ organizationId: organization._id,
126
+ status: "active",
127
+ userId: userIdForMembership(user),
128
+ })];
129
+ case 2:
130
+ membership = _a.sent();
131
+ if (!platform && !membership) {
132
+ throw new errors_1.ForbiddenError("Not a member of this organization");
133
+ }
134
+ return [2 /*return*/, { membership: membership !== null && membership !== void 0 ? membership : undefined, organization: organization }];
135
+ case 3:
136
+ if (!args.required) {
137
+ return [2 /*return*/, {}];
138
+ }
139
+ if (platform) {
140
+ throw new errors_1.BadRequestError("Organization context required");
141
+ }
142
+ return [4 /*yield*/, organizationModel_1.Membership.findActiveForUser(userIdForMembership(user))];
143
+ case 4:
144
+ active = _a.sent();
145
+ adminMemberships = active.filter(function (row) {
146
+ return row.roleName === "org-admin";
147
+ });
148
+ if (!(adminMemberships.length === 1)) return [3 /*break*/, 6];
149
+ membership = adminMemberships[0];
150
+ if (!membership) {
151
+ throw new errors_1.ForbiddenError("Organization context required");
152
+ }
153
+ return [4 /*yield*/, organizationModel_1.Organization.findExactlyOne({ _id: membership.organizationId })];
154
+ case 5:
155
+ organization = _a.sent();
156
+ (0, exports.assertOrganizationEnabled)(organization);
157
+ return [2 /*return*/, { membership: membership, organization: organization }];
158
+ case 6:
159
+ if (adminMemberships.length > 1) {
160
+ throw new errors_1.BadRequestError("Select an organization");
161
+ }
162
+ throw new errors_1.ForbiddenError("Organization context required");
163
+ }
164
+ });
165
+ }); };
166
+ exports.resolveOrgContext = resolveOrgContext;
167
+ var orgContextMiddleware = function (options) {
168
+ var _a;
169
+ var required = (_a = options === null || options === void 0 ? void 0 : options.required) !== null && _a !== void 0 ? _a : false;
170
+ return function (req, _res, next) { return __awaiter(void 0, void 0, void 0, function () {
171
+ var context, error_1;
172
+ return __generator(this, function (_a) {
173
+ switch (_a.label) {
174
+ case 0:
175
+ _a.trys.push([0, 2, , 3]);
176
+ return [4 /*yield*/, (0, exports.resolveOrgContext)({
177
+ organizationId: readOrganizationIdHeader(req),
178
+ required: required,
179
+ user: req.user,
180
+ })];
181
+ case 1:
182
+ context = _a.sent();
183
+ req.organization = context.organization;
184
+ req.membership = context.membership;
185
+ orgContextAls.run(context, function () {
186
+ next();
187
+ });
188
+ return [3 /*break*/, 3];
189
+ case 2:
190
+ error_1 = _a.sent();
191
+ next(error_1);
192
+ return [3 /*break*/, 3];
193
+ case 3: return [2 /*return*/];
194
+ }
195
+ });
196
+ }); };
197
+ };
198
+ exports.orgContextMiddleware = orgContextMiddleware;
@@ -0,0 +1,4 @@
1
+ import type { User } from "../auth";
2
+ import type { PermissionMethod } from "../permissions";
3
+ export declare const OrgQueryFilter: (_user?: User, _query?: Record<string, unknown>) => Record<string, unknown>;
4
+ export declare const isOrgMemberPermission: PermissionMethod<unknown>;
@@ -0,0 +1,77 @@
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
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ exports.isOrgMemberPermission = exports.OrgQueryFilter = void 0;
40
+ var errors_1 = require("../errors");
41
+ var organizationModel_1 = require("./organizationModel");
42
+ var orgContext_1 = require("./orgContext");
43
+ var OrgQueryFilter = function (_user, _query) {
44
+ var context = (0, orgContext_1.getOrgContext)();
45
+ if (!(context === null || context === void 0 ? void 0 : context.organization)) {
46
+ throw new errors_1.BadRequestError("Organization context required");
47
+ }
48
+ return { organizationId: context.organization._id };
49
+ };
50
+ exports.OrgQueryFilter = OrgQueryFilter;
51
+ var isOrgMemberPermission = function (_method, user, obj) { return __awaiter(void 0, void 0, void 0, function () {
52
+ var organizationId, context;
53
+ return __generator(this, function (_a) {
54
+ if (!obj) {
55
+ return [2 /*return*/, true];
56
+ }
57
+ if (!user) {
58
+ return [2 /*return*/, false];
59
+ }
60
+ organizationId = obj.organizationId;
61
+ if (!organizationId) {
62
+ return [2 /*return*/, false];
63
+ }
64
+ context = (0, orgContext_1.getOrgContext)();
65
+ if (!(context === null || context === void 0 ? void 0 : context.organization)) {
66
+ return [2 /*return*/, false];
67
+ }
68
+ if (String(context.organization._id) !== String(organizationId)) {
69
+ return [2 /*return*/, false];
70
+ }
71
+ if ((0, orgContext_1.isPlatformOrgActor)(user)) {
72
+ return [2 /*return*/, true];
73
+ }
74
+ return [2 /*return*/, organizationModel_1.Membership.isMember(user.id, String(organizationId))];
75
+ });
76
+ }); };
77
+ exports.isOrgMemberPermission = isOrgMemberPermission;
@@ -0,0 +1,13 @@
1
+ import mongoose, { type Schema } from "mongoose";
2
+ export interface OrgScoped {
3
+ organizationId: mongoose.Types.ObjectId;
4
+ }
5
+ export declare const ORGANIZATION_ID_IMMUTABLE_TITLE = "organizationId cannot be changed";
6
+ /** Rejects post-create changes to an existing `organizationId` schema path. */
7
+ export declare const organizationIdImmutabilityPlugin: (schema: Schema) => void;
8
+ /**
9
+ * Adds a required indexed `organizationId` so tenant-scoped consumer models cannot be saved
10
+ * without an organization. After creation, `organizationId` is immutable for REST, admin,
11
+ * sync, and direct saves.
12
+ */
13
+ export declare const orgScopedPlugin: (schema: Schema) => void;