@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,81 +1,20 @@
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
- var __read = (this && this.__read) || function (o, n) {
39
- var m = typeof Symbol === "function" && o[Symbol.iterator];
40
- if (!m) return o;
41
- var i = m.call(o), r, ar = [], e;
42
- try {
43
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
44
- }
45
- catch (error) { e = { error: error }; }
46
- finally {
47
- try {
48
- if (r && !r.done && (m = i["return"])) m.call(i);
49
- }
50
- finally { if (e) throw e.error; }
51
- }
52
- return ar;
53
- };
54
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
55
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
56
- if (ar || !(i in from)) {
57
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
58
- ar[i] = from[i];
59
- }
60
- }
61
- return to.concat(ar || Array.prototype.slice.call(from));
62
- };
63
2
  var __importDefault = (this && this.__importDefault) || function (mod) {
64
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
65
4
  };
66
5
  Object.defineProperty(exports, "__esModule", { value: true });
67
6
  exports.addMcpServiceTokenRoutes = exports.resolveMcpServiceTokensOption = exports.MAX_ACTIVE_MCP_SERVICE_TOKENS = void 0;
68
- var luxon_1 = require("luxon");
69
- var mongoose_1 = __importDefault(require("mongoose"));
70
- var api_1 = require("../api");
71
- var auth_1 = require("../auth");
72
- var errors_1 = require("../errors");
73
- var mcpServiceToken_1 = require("../models/mcpServiceToken");
74
- var openApiBuilder_1 = require("../openApiBuilder");
7
+ const luxon_1 = require("luxon");
8
+ const mongoose_1 = __importDefault(require("mongoose"));
9
+ const api_1 = require("../api");
10
+ const auth_1 = require("../auth");
11
+ const errors_1 = require("../errors");
12
+ const mcpServiceToken_1 = require("../models/mcpServiceToken");
13
+ const openApiBuilder_1 = require("../openApiBuilder");
75
14
  exports.MAX_ACTIVE_MCP_SERVICE_TOKENS = 10;
76
- var DEFAULT_LIST_LIMIT = 100;
77
- var MAX_LIST_LIMIT = 100;
78
- var resolveMcpServiceTokensOption = function (option) {
15
+ const DEFAULT_LIST_LIMIT = 100;
16
+ const MAX_LIST_LIMIT = 100;
17
+ const resolveMcpServiceTokensOption = (option) => {
79
18
  if (option === true) {
80
19
  return { enabled: true };
81
20
  }
@@ -85,8 +24,8 @@ var resolveMcpServiceTokensOption = function (option) {
85
24
  return { enabled: false };
86
25
  };
87
26
  exports.resolveMcpServiceTokensOption = resolveMcpServiceTokensOption;
88
- var bearerFromRequest = function (req) {
89
- var authorization = req.headers.authorization;
27
+ const bearerFromRequest = (req) => {
28
+ const authorization = req.headers.authorization;
90
29
  if (typeof authorization !== "string") {
91
30
  return undefined;
92
31
  }
@@ -95,39 +34,39 @@ var bearerFromRequest = function (req) {
95
34
  }
96
35
  return authorization;
97
36
  };
98
- var rejectMcpServiceTokenBearer = function (req, _res, next) {
99
- var token = bearerFromRequest(req);
100
- if (token === null || token === void 0 ? void 0 : token.startsWith("mcp_")) {
37
+ const rejectMcpServiceTokenBearer = (req, _res, next) => {
38
+ const token = bearerFromRequest(req);
39
+ if (token?.startsWith("mcp_")) {
101
40
  next(new errors_1.UnauthorizedError("MCP service tokens cannot manage service tokens"));
102
41
  return;
103
42
  }
104
43
  next();
105
44
  };
106
- var requireAuthenticatedUser = function (req) {
107
- var user = req.user;
108
- if (!(user === null || user === void 0 ? void 0 : user._id)) {
45
+ const requireAuthenticatedUser = (req) => {
46
+ const user = req.user;
47
+ if (!user?._id) {
109
48
  throw new errors_1.UnauthorizedError("Unauthorized");
110
49
  }
111
50
  return user;
112
51
  };
113
- var parseName = function (value) {
52
+ const parseName = (value) => {
114
53
  if (typeof value !== "string") {
115
54
  throw new errors_1.BadRequestError({ title: "name is required" });
116
55
  }
117
- var name = value.trim();
56
+ const name = value.trim();
118
57
  if (!name) {
119
58
  throw new errors_1.BadRequestError({ title: "name is required" });
120
59
  }
121
60
  return name;
122
61
  };
123
- var parseExpiresAt = function (value) {
62
+ const parseExpiresAt = (value) => {
124
63
  if (value === undefined || value === null || value === "") {
125
64
  return undefined;
126
65
  }
127
66
  if (typeof value !== "string") {
128
67
  throw new errors_1.BadRequestError({ title: "expiresAt must be an ISO-8601 datetime string" });
129
68
  }
130
- var parsed = luxon_1.DateTime.fromISO(value, { setZone: true });
69
+ const parsed = luxon_1.DateTime.fromISO(value, { setZone: true });
131
70
  if (!parsed.isValid) {
132
71
  throw new errors_1.BadRequestError({ title: "expiresAt must be an ISO-8601 datetime string" });
133
72
  }
@@ -136,40 +75,39 @@ var parseExpiresAt = function (value) {
136
75
  }
137
76
  return parsed.toUTC().toJSDate();
138
77
  };
139
- var parsePage = function (value) {
78
+ const parsePage = (value) => {
140
79
  if (value === undefined) {
141
80
  return 1;
142
81
  }
143
- var page = Number(value);
82
+ const page = Number(value);
144
83
  if (!Number.isInteger(page) || page < 1) {
145
84
  throw new errors_1.BadRequestError({ code: "invalid-page", title: "Invalid page" });
146
85
  }
147
86
  return page;
148
87
  };
149
- var parseLimit = function (value) {
88
+ const parseLimit = (value) => {
150
89
  if (value === undefined) {
151
90
  return DEFAULT_LIST_LIMIT;
152
91
  }
153
- var limit = Number(value);
92
+ const limit = Number(value);
154
93
  if (!Number.isInteger(limit) || limit < 1) {
155
94
  throw new errors_1.BadRequestError({ title: "Invalid limit" });
156
95
  }
157
96
  return Math.min(limit, MAX_LIST_LIMIT);
158
97
  };
159
- var resolveMcpUrl = function (req, publicMcpUrl) {
160
- var _a;
161
- var configured = publicMcpUrl !== null && publicMcpUrl !== void 0 ? publicMcpUrl : process.env.BETTER_AUTH_URL;
98
+ const resolveMcpUrl = (req, publicMcpUrl) => {
99
+ const configured = publicMcpUrl ?? process.env.BETTER_AUTH_URL;
162
100
  if (configured) {
163
- var base = configured.replace(/\/$/, "");
101
+ const base = configured.replace(/\/$/, "");
164
102
  if (base.endsWith("/mcp")) {
165
103
  return base;
166
104
  }
167
- return "".concat(base, "/mcp");
105
+ return `${base}/mcp`;
168
106
  }
169
- var host = (_a = req.get("host")) !== null && _a !== void 0 ? _a : "localhost";
170
- return "".concat(req.protocol, "://").concat(host, "/mcp");
107
+ const host = req.get("host") ?? "localhost";
108
+ return `${req.protocol}://${host}/mcp`;
171
109
  };
172
- var toListItem = function (doc) {
110
+ const toListItem = (doc) => {
173
111
  return {
174
112
  created: doc.created.toISOString(),
175
113
  expiresAt: doc.expiresAt ? doc.expiresAt.toISOString() : null,
@@ -180,8 +118,8 @@ var toListItem = function (doc) {
180
118
  tokenPrefix: doc.tokenPrefix,
181
119
  };
182
120
  };
183
- var serviceTokenGuards = [rejectMcpServiceTokenBearer, (0, auth_1.authenticateMiddleware)()];
184
- var createdTokenFields = {
121
+ const serviceTokenGuards = [rejectMcpServiceTokenBearer, (0, auth_1.authenticateMiddleware)()];
122
+ const createdTokenFields = {
185
123
  created: { type: "string" },
186
124
  expiresAt: { type: "string" },
187
125
  id: { type: "string" },
@@ -190,10 +128,10 @@ var createdTokenFields = {
190
128
  token: { type: "string" },
191
129
  tokenPrefix: { type: "string" },
192
130
  };
193
- var addMcpServiceTokenRoutes = function (app, options) {
194
- if (options === void 0) { options = {}; }
195
- var openApiOptions = { openApi: options.openApi };
196
- app.post("/mcp/service-tokens", __spreadArray(__spreadArray([], __read(serviceTokenGuards), false), [
131
+ const addMcpServiceTokenRoutes = (app, options = {}) => {
132
+ const openApiOptions = { openApi: options.openApi };
133
+ app.post("/mcp/service-tokens", [
134
+ ...serviceTokenGuards,
197
135
  (0, openApiBuilder_1.createOpenApiBuilder)(openApiOptions)
198
136
  .withTags(["mcp"])
199
137
  .withOperationId("createMcpServiceToken")
@@ -217,43 +155,33 @@ var addMcpServiceTokenRoutes = function (app, options) {
217
155
  },
218
156
  })
219
157
  .build(),
220
- ], false), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
221
- var user, name, expiresAt, activeCount, issued;
222
- var _a, _b;
223
- return __generator(this, function (_c) {
224
- switch (_c.label) {
225
- case 0:
226
- user = requireAuthenticatedUser(req);
227
- name = parseName((_a = req.body) === null || _a === void 0 ? void 0 : _a.name);
228
- expiresAt = parseExpiresAt((_b = req.body) === null || _b === void 0 ? void 0 : _b.expiresAt);
229
- return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.countActiveForUser(new mongoose_1.default.Types.ObjectId(String(user._id)))];
230
- case 1:
231
- activeCount = _c.sent();
232
- if (activeCount >= exports.MAX_ACTIVE_MCP_SERVICE_TOKENS) {
233
- throw new errors_1.BadRequestError({
234
- title: "Maximum of ".concat(exports.MAX_ACTIVE_MCP_SERVICE_TOKENS, " active MCP service tokens"),
235
- });
236
- }
237
- return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.issueFor({ _id: user._id }, { expiresAt: expiresAt, name: name })];
238
- case 2:
239
- issued = _c.sent();
240
- return [2 /*return*/, res.json({
241
- data: {
242
- created: issued.mcpServiceToken.created.toISOString(),
243
- expiresAt: issued.mcpServiceToken.expiresAt
244
- ? issued.mcpServiceToken.expiresAt.toISOString()
245
- : null,
246
- id: String(issued.mcpServiceToken._id),
247
- mcpUrl: resolveMcpUrl(req, options.publicMcpUrl),
248
- name: issued.mcpServiceToken.name,
249
- token: issued.token,
250
- tokenPrefix: issued.mcpServiceToken.tokenPrefix,
251
- },
252
- })];
253
- }
158
+ ], (0, api_1.asyncHandler)(async (req, res) => {
159
+ const user = requireAuthenticatedUser(req);
160
+ const name = parseName(req.body?.name);
161
+ const expiresAt = parseExpiresAt(req.body?.expiresAt);
162
+ const activeCount = await mcpServiceToken_1.McpServiceToken.countActiveForUser(new mongoose_1.default.Types.ObjectId(String(user._id)));
163
+ if (activeCount >= exports.MAX_ACTIVE_MCP_SERVICE_TOKENS) {
164
+ throw new errors_1.BadRequestError({
165
+ title: `Maximum of ${exports.MAX_ACTIVE_MCP_SERVICE_TOKENS} active MCP service tokens`,
166
+ });
167
+ }
168
+ const issued = await mcpServiceToken_1.McpServiceToken.issueFor({ _id: user._id }, { expiresAt, name });
169
+ return res.json({
170
+ data: {
171
+ created: issued.mcpServiceToken.created.toISOString(),
172
+ expiresAt: issued.mcpServiceToken.expiresAt
173
+ ? issued.mcpServiceToken.expiresAt.toISOString()
174
+ : null,
175
+ id: String(issued.mcpServiceToken._id),
176
+ mcpUrl: resolveMcpUrl(req, options.publicMcpUrl),
177
+ name: issued.mcpServiceToken.name,
178
+ token: issued.token,
179
+ tokenPrefix: issued.mcpServiceToken.tokenPrefix,
180
+ },
254
181
  });
255
- }); }));
256
- app.get("/mcp/service-tokens", __spreadArray(__spreadArray([], __read(serviceTokenGuards), false), [
182
+ }));
183
+ app.get("/mcp/service-tokens", [
184
+ ...serviceTokenGuards,
257
185
  (0, openApiBuilder_1.createOpenApiBuilder)(openApiOptions)
258
186
  .withTags(["mcp"])
259
187
  .withOperationId("listMcpServiceTokens")
@@ -269,37 +197,28 @@ var addMcpServiceTokenRoutes = function (app, options) {
269
197
  total: { type: "number" },
270
198
  })
271
199
  .build(),
272
- ], false), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
273
- var user, page, limit, filter, total, docs, more, pageDocs;
274
- return __generator(this, function (_a) {
275
- switch (_a.label) {
276
- case 0:
277
- user = requireAuthenticatedUser(req);
278
- page = parsePage(req.query.page);
279
- limit = parseLimit(req.query.limit);
280
- filter = { userId: new mongoose_1.default.Types.ObjectId(String(user._id)) };
281
- return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.countDocuments(filter)];
282
- case 1:
283
- total = _a.sent();
284
- return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.find(filter)
285
- .sort("-created")
286
- .skip((page - 1) * limit)
287
- .limit(limit + 1)];
288
- case 2:
289
- docs = _a.sent();
290
- more = docs.length > limit;
291
- pageDocs = more ? docs.slice(0, limit) : docs;
292
- return [2 /*return*/, res.json({
293
- data: pageDocs.map(toListItem),
294
- limit: limit,
295
- more: more,
296
- page: page,
297
- total: total,
298
- })];
299
- }
200
+ ], (0, api_1.asyncHandler)(async (req, res) => {
201
+ const user = requireAuthenticatedUser(req);
202
+ const page = parsePage(req.query.page);
203
+ const limit = parseLimit(req.query.limit);
204
+ const filter = { userId: new mongoose_1.default.Types.ObjectId(String(user._id)) };
205
+ const total = await mcpServiceToken_1.McpServiceToken.countDocuments(filter);
206
+ const docs = await mcpServiceToken_1.McpServiceToken.find(filter)
207
+ .sort("-created")
208
+ .skip((page - 1) * limit)
209
+ .limit(limit + 1);
210
+ const more = docs.length > limit;
211
+ const pageDocs = more ? docs.slice(0, limit) : docs;
212
+ return res.json({
213
+ data: pageDocs.map(toListItem),
214
+ limit,
215
+ more,
216
+ page,
217
+ total,
300
218
  });
301
- }); }));
302
- app.delete("/mcp/service-tokens/:id", __spreadArray(__spreadArray([], __read(serviceTokenGuards), false), [
219
+ }));
220
+ app.delete("/mcp/service-tokens/:id", [
221
+ ...serviceTokenGuards,
303
222
  (0, openApiBuilder_1.createOpenApiBuilder)(openApiOptions)
304
223
  .withTags(["mcp"])
305
224
  .withOperationId("revokeMcpServiceToken")
@@ -316,30 +235,22 @@ var addMcpServiceTokenRoutes = function (app, options) {
316
235
  },
317
236
  })
318
237
  .build(),
319
- ], false), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
320
- var user, tokenId, revoked;
321
- return __generator(this, function (_a) {
322
- switch (_a.label) {
323
- case 0:
324
- user = requireAuthenticatedUser(req);
325
- tokenId = req.params.id;
326
- if (!mongoose_1.default.Types.ObjectId.isValid(tokenId)) {
327
- throw new errors_1.NotFoundError("MCP service token not found");
328
- }
329
- return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.revokeForUser({ _id: user._id }, new mongoose_1.default.Types.ObjectId(tokenId))];
330
- case 1:
331
- revoked = _a.sent();
332
- if (!revoked) {
333
- throw new errors_1.NotFoundError("MCP service token not found");
334
- }
335
- return [2 /*return*/, res.json({
336
- data: {
337
- id: String(revoked._id),
338
- revokedAt: revoked.revokedAt ? revoked.revokedAt.toISOString() : null,
339
- },
340
- })];
341
- }
238
+ ], (0, api_1.asyncHandler)(async (req, res) => {
239
+ const user = requireAuthenticatedUser(req);
240
+ const tokenId = req.params.id;
241
+ if (!mongoose_1.default.Types.ObjectId.isValid(tokenId)) {
242
+ throw new errors_1.NotFoundError("MCP service token not found");
243
+ }
244
+ const revoked = await mcpServiceToken_1.McpServiceToken.revokeForUser({ _id: user._id }, new mongoose_1.default.Types.ObjectId(tokenId));
245
+ if (!revoked) {
246
+ throw new errors_1.NotFoundError("MCP service token not found");
247
+ }
248
+ return res.json({
249
+ data: {
250
+ id: String(revoked._id),
251
+ revokedAt: revoked.revokedAt ? revoked.revokedAt.toISOString() : null,
252
+ },
342
253
  });
343
- }); }));
254
+ }));
344
255
  };
345
256
  exports.addMcpServiceTokenRoutes = addMcpServiceTokenRoutes;