@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,18 +1,5 @@
1
1
  import type { ModelRouterOptions } from "../api";
2
2
  import type { MCPConfig, MCPToolArgs } from "./types";
3
- /** Args consumed by pagination/population, never treated as filters. */
4
- export declare const RESERVED_LIST_ARGS: Set<string>;
5
- /**
6
- * Top-level logical operators an MCP client may send. Mirrors the REST list endpoint,
7
- * which allows `$and` / `$or` and validates every nested key against `queryFields`.
8
- */
9
- export declare const ALLOWED_LOGICAL_OPERATORS: Set<string>;
10
- /**
11
- * Comparison operators allowed inside a field's value, e.g. `{completed: {$ne: true}}`.
12
- * Deliberately excludes evaluation operators that can run arbitrary code or ignore
13
- * indexes ($where, $expr, $function, $accumulator, $jsonSchema, $text).
14
- */
15
- export declare const ALLOWED_FIELD_OPERATORS: Set<string>;
16
3
  export interface BuildListQueryResult {
17
4
  query?: Record<string, unknown>;
18
5
  error?: string;
package/dist/mcp/query.js CHANGED
@@ -1,58 +1,20 @@
1
1
  "use strict";
2
- var __assign = (this && this.__assign) || function () {
3
- __assign = Object.assign || function(t) {
4
- for (var s, i = 1, n = arguments.length; i < n; i++) {
5
- s = arguments[i];
6
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
- t[p] = s[p];
8
- }
9
- return t;
10
- };
11
- return __assign.apply(this, arguments);
12
- };
13
- var __values = (this && this.__values) || function(o) {
14
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
15
- if (m) return m.call(o);
16
- if (o && typeof o.length === "number") return {
17
- next: function () {
18
- if (o && i >= o.length) o = void 0;
19
- return { value: o && o[i++], done: !o };
20
- }
21
- };
22
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
23
- };
24
- var __read = (this && this.__read) || function (o, n) {
25
- var m = typeof Symbol === "function" && o[Symbol.iterator];
26
- if (!m) return o;
27
- var i = m.call(o), r, ar = [], e;
28
- try {
29
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
30
- }
31
- catch (error) { e = { error: error }; }
32
- finally {
33
- try {
34
- if (r && !r.done && (m = i["return"])) m.call(i);
35
- }
36
- finally { if (e) throw e.error; }
37
- }
38
- return ar;
39
- };
40
2
  Object.defineProperty(exports, "__esModule", { value: true });
41
- exports.buildListQuery = exports.ALLOWED_FIELD_OPERATORS = exports.ALLOWED_LOGICAL_OPERATORS = exports.RESERVED_LIST_ARGS = void 0;
42
- var schemaGenerator_1 = require("./schemaGenerator");
3
+ exports.buildListQuery = void 0;
4
+ const schemaGenerator_1 = require("./schemaGenerator");
43
5
  /** Args consumed by pagination/population, never treated as filters. */
44
- exports.RESERVED_LIST_ARGS = new Set(["limit", "page", "populate", "sort"]);
6
+ const RESERVED_LIST_ARGS = new Set(["limit", "page", "populate", "sort"]);
45
7
  /**
46
8
  * Top-level logical operators an MCP client may send. Mirrors the REST list endpoint,
47
9
  * which allows `$and` / `$or` and validates every nested key against `queryFields`.
48
10
  */
49
- exports.ALLOWED_LOGICAL_OPERATORS = new Set(["$and", "$or"]);
11
+ const ALLOWED_LOGICAL_OPERATORS = new Set(["$and", "$or"]);
50
12
  /**
51
13
  * Comparison operators allowed inside a field's value, e.g. `{completed: {$ne: true}}`.
52
14
  * Deliberately excludes evaluation operators that can run arbitrary code or ignore
53
15
  * indexes ($where, $expr, $function, $accumulator, $jsonSchema, $text).
54
16
  */
55
- exports.ALLOWED_FIELD_OPERATORS = new Set([
17
+ const ALLOWED_FIELD_OPERATORS = new Set([
56
18
  "$all",
57
19
  "$eq",
58
20
  "$exists",
@@ -67,7 +29,7 @@ exports.ALLOWED_FIELD_OPERATORS = new Set([
67
29
  "$regex",
68
30
  "$size",
69
31
  ]);
70
- var isPlainObject = function (value) {
32
+ const isPlainObject = (value) => {
71
33
  return typeof value === "object" && value !== null && !Array.isArray(value);
72
34
  };
73
35
  /**
@@ -76,48 +38,27 @@ var isPlainObject = function (value) {
76
38
  *
77
39
  * @returns The offending operator name, or undefined when the value is safe.
78
40
  */
79
- var findDisallowedOperator = function (value) {
80
- var e_1, _a, e_2, _b;
41
+ const findDisallowedOperator = (value) => {
81
42
  if (Array.isArray(value)) {
82
- try {
83
- for (var value_1 = __values(value), value_1_1 = value_1.next(); !value_1_1.done; value_1_1 = value_1.next()) {
84
- var item = value_1_1.value;
85
- var found = findDisallowedOperator(item);
86
- if (found) {
87
- return found;
88
- }
89
- }
90
- }
91
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
92
- finally {
93
- try {
94
- if (value_1_1 && !value_1_1.done && (_a = value_1.return)) _a.call(value_1);
43
+ for (const item of value) {
44
+ const found = findDisallowedOperator(item);
45
+ if (found) {
46
+ return found;
95
47
  }
96
- finally { if (e_1) throw e_1.error; }
97
48
  }
98
49
  return undefined;
99
50
  }
100
51
  if (!isPlainObject(value)) {
101
52
  return undefined;
102
53
  }
103
- try {
104
- for (var _c = __values(Object.entries(value)), _d = _c.next(); !_d.done; _d = _c.next()) {
105
- var _e = __read(_d.value, 2), key = _e[0], nested = _e[1];
106
- if (key.startsWith("$") && !exports.ALLOWED_FIELD_OPERATORS.has(key)) {
107
- return key;
108
- }
109
- var found = findDisallowedOperator(nested);
110
- if (found) {
111
- return found;
112
- }
54
+ for (const [key, nested] of Object.entries(value)) {
55
+ if (key.startsWith("$") && !ALLOWED_FIELD_OPERATORS.has(key)) {
56
+ return key;
113
57
  }
114
- }
115
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
116
- finally {
117
- try {
118
- if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
58
+ const found = findDisallowedOperator(nested);
59
+ if (found) {
60
+ return found;
119
61
  }
120
- finally { if (e_2) throw e_2.error; }
121
62
  }
122
63
  return undefined;
123
64
  };
@@ -125,60 +66,38 @@ var findDisallowedOperator = function (value) {
125
66
  * Validate one branch of a `$and` / `$or` clause. Every key must either be another
126
67
  * logical operator or a field listed in `queryFields`, matching REST's behavior.
127
68
  */
128
- var validateLogicalBranch = function (branch, allowedQueryFields) {
129
- var e_3, _a;
69
+ const validateLogicalBranch = (branch, allowedQueryFields) => {
130
70
  if (!isPlainObject(branch)) {
131
71
  return "Logical operators ($and/$or) take an array of filter objects";
132
72
  }
133
- try {
134
- for (var _b = __values(Object.entries(branch)), _c = _b.next(); !_c.done; _c = _b.next()) {
135
- var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
136
- if (exports.ALLOWED_LOGICAL_OPERATORS.has(key)) {
137
- var error = validateLogicalClause(key, value, allowedQueryFields);
138
- if (error) {
139
- return error;
140
- }
141
- continue;
142
- }
143
- if (!allowedQueryFields.has(key)) {
144
- return "".concat(key, " is not allowed as a filter field");
145
- }
146
- var disallowed = findDisallowedOperator(value);
147
- if (disallowed) {
148
- return "".concat(disallowed, " is not an allowed query operator");
73
+ for (const [key, value] of Object.entries(branch)) {
74
+ if (ALLOWED_LOGICAL_OPERATORS.has(key)) {
75
+ const error = validateLogicalClause(key, value, allowedQueryFields);
76
+ if (error) {
77
+ return error;
149
78
  }
79
+ continue;
150
80
  }
151
- }
152
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
153
- finally {
154
- try {
155
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
81
+ if (!allowedQueryFields.has(key)) {
82
+ return `${key} is not allowed as a filter field`;
83
+ }
84
+ const disallowed = findDisallowedOperator(value);
85
+ if (disallowed) {
86
+ return `${disallowed} is not an allowed query operator`;
156
87
  }
157
- finally { if (e_3) throw e_3.error; }
158
88
  }
159
89
  return undefined;
160
90
  };
161
- var validateLogicalClause = function (operator, value, allowedQueryFields) {
162
- var e_4, _a;
91
+ const validateLogicalClause = (operator, value, allowedQueryFields) => {
163
92
  if (!Array.isArray(value) || value.length === 0) {
164
- return "".concat(operator, " takes a non-empty array of filter objects");
93
+ return `${operator} takes a non-empty array of filter objects`;
165
94
  }
166
- try {
167
- for (var value_2 = __values(value), value_2_1 = value_2.next(); !value_2_1.done; value_2_1 = value_2.next()) {
168
- var branch = value_2_1.value;
169
- var error = validateLogicalBranch(branch, allowedQueryFields);
170
- if (error) {
171
- return error;
172
- }
95
+ for (const branch of value) {
96
+ const error = validateLogicalBranch(branch, allowedQueryFields);
97
+ if (error) {
98
+ return error;
173
99
  }
174
100
  }
175
- catch (e_4_1) { e_4 = { error: e_4_1 }; }
176
- finally {
177
- try {
178
- if (value_2_1 && !value_2_1.done && (_a = value_2.return)) _a.call(value_2);
179
- }
180
- finally { if (e_4) throw e_4.error; }
181
- }
182
101
  return undefined;
183
102
  };
184
103
  /**
@@ -189,44 +108,31 @@ var validateLogicalClause = function (operator, value, allowedQueryFields) {
189
108
  * Anything else is rejected rather than silently dropped so the calling LLM can correct
190
109
  * itself instead of receiving results for a query it did not ask for.
191
110
  */
192
- var buildListQuery = function (_a) {
193
- var e_5, _b;
194
- var _c, _d, _e;
195
- var args = _a.args, config = _a.config, options = _a.options;
196
- var query = __assign({}, ((_c = options.defaultQueryParams) !== null && _c !== void 0 ? _c : {}));
197
- var excludeFields = (_d = config.excludeFields) !== null && _d !== void 0 ? _d : [];
198
- var allowedQueryFields = new Set(((_e = options.queryFields) !== null && _e !== void 0 ? _e : []).filter(function (field) { return !(0, schemaGenerator_1.isFieldExcluded)(field, excludeFields); }));
199
- try {
200
- for (var _f = __values(Object.entries(args)), _g = _f.next(); !_g.done; _g = _f.next()) {
201
- var _h = __read(_g.value, 2), key = _h[0], value = _h[1];
202
- if (exports.RESERVED_LIST_ARGS.has(key) || value === undefined) {
203
- continue;
204
- }
205
- if (exports.ALLOWED_LOGICAL_OPERATORS.has(key)) {
206
- var error = validateLogicalClause(key, value, allowedQueryFields);
207
- if (error) {
208
- return { error: error };
209
- }
210
- query[key] = value;
211
- continue;
212
- }
213
- if (!allowedQueryFields.has(key)) {
214
- continue;
215
- }
216
- var disallowed = findDisallowedOperator(value);
217
- if (disallowed) {
218
- return { error: "".concat(disallowed, " is not an allowed query operator") };
111
+ const buildListQuery = ({ args, config, options, }) => {
112
+ const query = { ...(options.defaultQueryParams ?? {}) };
113
+ const excludeFields = config.excludeFields ?? [];
114
+ const allowedQueryFields = new Set((options.queryFields ?? []).filter((field) => !(0, schemaGenerator_1.isFieldExcluded)(field, excludeFields)));
115
+ for (const [key, value] of Object.entries(args)) {
116
+ if (RESERVED_LIST_ARGS.has(key) || value === undefined) {
117
+ continue;
118
+ }
119
+ if (ALLOWED_LOGICAL_OPERATORS.has(key)) {
120
+ const error = validateLogicalClause(key, value, allowedQueryFields);
121
+ if (error) {
122
+ return { error };
219
123
  }
220
124
  query[key] = value;
125
+ continue;
221
126
  }
222
- }
223
- catch (e_5_1) { e_5 = { error: e_5_1 }; }
224
- finally {
225
- try {
226
- if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
127
+ if (!allowedQueryFields.has(key)) {
128
+ continue;
129
+ }
130
+ const disallowed = findDisallowedOperator(value);
131
+ if (disallowed) {
132
+ return { error: `${disallowed} is not an allowed query operator` };
227
133
  }
228
- finally { if (e_5) throw e_5.error; }
134
+ query[key] = value;
229
135
  }
230
- return { query: query };
136
+ return { query };
231
137
  };
232
138
  exports.buildListQuery = buildListQuery;
@@ -1,41 +1,28 @@
1
1
  "use strict";
2
- var __assign = (this && this.__assign) || function () {
3
- __assign = Object.assign || function(t) {
4
- for (var s, i = 1, n = arguments.length; i < n; i++) {
5
- s = arguments[i];
6
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
- t[p] = s[p];
8
- }
9
- return t;
10
- };
11
- return __assign.apply(this, arguments);
12
- };
13
2
  Object.defineProperty(exports, "__esModule", { value: true });
14
3
  exports.clearMCPRegistry = exports.getMCPCustomTools = exports.getMCPRegistry = exports.registerMCPTool = exports.updateMCPRegistryOptions = exports.registerMCPModel = void 0;
15
- var collectionRegistry_1 = require("../collectionRegistry");
16
- var mcpCustomTools = [];
17
- var findCollectionByModelName = function (modelName) {
18
- return (0, collectionRegistry_1.listCollections)().find(function (record) { return record.model.modelName === modelName; });
19
- };
20
- var mcpRoutePathForModel = function (model) { var _a, _b; return (_b = (_a = findCollectionByModelName(model.modelName)) === null || _a === void 0 ? void 0 : _a.routePath) !== null && _b !== void 0 ? _b : "/_mcp/".concat(model.modelName); };
21
- var registerMCPModel = function (model, config, options) {
4
+ const collectionRegistry_1 = require("../collectionRegistry");
5
+ const mcpCustomTools = [];
6
+ const findCollectionByModelName = (modelName) => (0, collectionRegistry_1.listCollections)().find((record) => record.model.modelName === modelName);
7
+ const mcpRoutePathForModel = (model) => findCollectionByModelName(model.modelName)?.routePath ?? `/_mcp/${model.modelName}`;
8
+ const registerMCPModel = (model, config, options) => {
22
9
  (0, collectionRegistry_1.registerCollection)({
23
- model: model,
24
- options: __assign(__assign({}, options), { mcp: config }),
10
+ model,
11
+ options: { ...options, mcp: config },
25
12
  routePath: mcpRoutePathForModel(model),
26
13
  });
27
14
  };
28
15
  exports.registerMCPModel = registerMCPModel;
29
- var updateMCPRegistryOptions = function (modelName, options) {
30
- var existing = findCollectionByModelName(modelName);
16
+ const updateMCPRegistryOptions = (modelName, options) => {
17
+ const existing = findCollectionByModelName(modelName);
31
18
  if (!existing) {
32
19
  return;
33
20
  }
34
21
  (0, collectionRegistry_1.replaceCollectionOptions)(existing.routePath, options);
35
22
  };
36
23
  exports.updateMCPRegistryOptions = updateMCPRegistryOptions;
37
- var registerMCPTool = function (tool) {
38
- var existingIndex = mcpCustomTools.findIndex(function (registered) { return registered.name === tool.name; });
24
+ const registerMCPTool = (tool) => {
25
+ const existingIndex = mcpCustomTools.findIndex((registered) => registered.name === tool.name);
39
26
  if (existingIndex >= 0) {
40
27
  mcpCustomTools[existingIndex] = tool;
41
28
  return;
@@ -43,22 +30,22 @@ var registerMCPTool = function (tool) {
43
30
  mcpCustomTools.push(tool);
44
31
  };
45
32
  exports.registerMCPTool = registerMCPTool;
46
- var getMCPRegistry = function () {
33
+ const getMCPRegistry = () => {
47
34
  return (0, collectionRegistry_1.listCollections)()
48
- .filter(function (record) { return record.surfaces.mcp; })
49
- .map(function (record) { return ({
35
+ .filter((record) => record.surfaces.mcp)
36
+ .map((record) => ({
50
37
  config: record.options.mcp,
51
38
  model: record.model,
52
39
  modelName: record.model.modelName,
53
40
  options: record.options,
54
- }); });
41
+ }));
55
42
  };
56
43
  exports.getMCPRegistry = getMCPRegistry;
57
- var getMCPCustomTools = function () {
44
+ const getMCPCustomTools = () => {
58
45
  return mcpCustomTools;
59
46
  };
60
47
  exports.getMCPCustomTools = getMCPCustomTools;
61
- var clearMCPRegistry = function () {
48
+ const clearMCPRegistry = () => {
62
49
  (0, collectionRegistry_1.clearCollectionRegistry)();
63
50
  mcpCustomTools.length = 0;
64
51
  };