@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,105 +1,9 @@
1
1
  "use strict";
2
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
- if (k2 === undefined) k2 = k;
4
- var desc = Object.getOwnPropertyDescriptor(m, k);
5
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
- desc = { enumerable: true, get: function() { return m[k]; } };
7
- }
8
- Object.defineProperty(o, k2, desc);
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
- Object.defineProperty(o, "default", { enumerable: true, value: v });
15
- }) : function(o, v) {
16
- o["default"] = v;
17
- });
18
- var __importStar = (this && this.__importStar) || (function () {
19
- var ownKeys = function(o) {
20
- ownKeys = Object.getOwnPropertyNames || function (o) {
21
- var ar = [];
22
- for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
- return ar;
24
- };
25
- return ownKeys(o);
26
- };
27
- return function (mod) {
28
- if (mod && mod.__esModule) return mod;
29
- var result = {};
30
- if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
- __setModuleDefault(result, mod);
32
- return result;
33
- };
34
- })();
35
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
36
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
37
- return new (P || (P = Promise))(function (resolve, reject) {
38
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
39
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
40
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
41
- step((generator = generator.apply(thisArg, _arguments || [])).next());
42
- });
43
- };
44
- var __generator = (this && this.__generator) || function (thisArg, body) {
45
- 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);
46
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
47
- function verb(n) { return function (v) { return step([n, v]); }; }
48
- function step(op) {
49
- if (f) throw new TypeError("Generator is already executing.");
50
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
51
- 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;
52
- if (y = 0, t) op = [op[0] & 2, t.value];
53
- switch (op[0]) {
54
- case 0: case 1: t = op; break;
55
- case 4: _.label++; return { value: op[1], done: false };
56
- case 5: _.label++; y = op[1]; op = [0]; continue;
57
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
58
- default:
59
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
60
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
61
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
62
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
63
- if (t[2]) _.ops.pop();
64
- _.trys.pop(); continue;
65
- }
66
- op = body.call(thisArg, _);
67
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
68
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
69
- }
70
- };
71
- var __read = (this && this.__read) || function (o, n) {
72
- var m = typeof Symbol === "function" && o[Symbol.iterator];
73
- if (!m) return o;
74
- var i = m.call(o), r, ar = [], e;
75
- try {
76
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
77
- }
78
- catch (error) { e = { error: error }; }
79
- finally {
80
- try {
81
- if (r && !r.done && (m = i["return"])) m.call(i);
82
- }
83
- finally { if (e) throw e.error; }
84
- }
85
- return ar;
86
- };
87
- var __values = (this && this.__values) || function(o) {
88
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
89
- if (m) return m.call(o);
90
- if (o && typeof o.length === "number") return {
91
- next: function () {
92
- if (o && i >= o.length) o = void 0;
93
- return { value: o && o[i++], done: !o };
94
- }
95
- };
96
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
97
- };
98
2
  Object.defineProperty(exports, "__esModule", { value: true });
99
3
  exports.CachingSecretProvider = exports.CompositeSecretProvider = exports.GcpSecretProvider = exports.EnvSecretProvider = void 0;
100
- var luxon_1 = require("luxon");
101
- var errors_1 = require("./errors");
102
- var logger_1 = require("./logger");
4
+ const luxon_1 = require("luxon");
5
+ const errors_1 = require("./errors");
6
+ const logger_1 = require("./logger");
103
7
  /**
104
8
  * Secret provider that reads secrets from environment variables.
105
9
  * Useful for local development and testing.
@@ -114,30 +18,22 @@ var logger_1 = require("./logger");
114
18
  * const key = await provider.getSecret("openai-api-key");
115
19
  * ```
116
20
  */
117
- var EnvSecretProvider = /** @class */ (function () {
118
- function EnvSecretProvider() {
119
- this.name = "env";
120
- }
21
+ class EnvSecretProvider {
22
+ name = "env";
121
23
  /**
122
24
  * Resolve a secret from an environment variable. Environment variables have no
123
25
  * versions, so the optional `version` parameter is ignored.
124
26
  */
125
- EnvSecretProvider.prototype.getSecret = function (secretName, _version) {
126
- return __awaiter(this, void 0, void 0, function () {
127
- var envKey, value;
128
- var _a;
129
- return __generator(this, function (_b) {
130
- envKey = secretName.replace(/[-.]/g, "_").toUpperCase();
131
- value = (_a = process.env[envKey]) !== null && _a !== void 0 ? _a : null;
132
- if (value === null) {
133
- logger_1.logger.debug("EnvSecretProvider: no env var found for ".concat(secretName, " (tried ").concat(envKey, ")"));
134
- }
135
- return [2 /*return*/, value];
136
- });
137
- });
138
- };
139
- return EnvSecretProvider;
140
- }());
27
+ async getSecret(secretName, _version) {
28
+ // Convert secret name to env var format: "openai-api-key" → "OPENAI_API_KEY"
29
+ const envKey = secretName.replace(/[-.]/g, "_").toUpperCase();
30
+ const value = process.env[envKey] ?? null;
31
+ if (value === null) {
32
+ logger_1.logger.debug(`EnvSecretProvider: no env var found for ${secretName} (tried ${envKey})`);
33
+ }
34
+ return value;
35
+ }
36
+ }
141
37
  exports.EnvSecretProvider = EnvSecretProvider;
142
38
  /**
143
39
  * Secret provider that reads secrets from Google Cloud Secret Manager.
@@ -152,56 +48,44 @@ exports.EnvSecretProvider = EnvSecretProvider;
152
48
  * const key = await provider.getSecret("openai-api-key");
153
49
  * ```
154
50
  */
155
- var GcpSecretProvider = /** @class */ (function () {
156
- function GcpSecretProvider(options) {
157
- var _a;
158
- this.name = "gcp";
159
- this.client = null;
51
+ class GcpSecretProvider {
52
+ name = "gcp";
53
+ projectId;
54
+ client = null;
55
+ loadModule;
56
+ constructor(options) {
160
57
  this.projectId = options.projectId;
161
58
  this.loadModule =
162
- (_a = options.loadModule) !== null && _a !== void 0 ? _a : (function () {
163
- // Dynamic import — @google-cloud/secret-manager is an optional peer dependency
164
- var moduleName = "@google-cloud/secret-manager";
165
- return Promise.resolve("".concat(/* webpackIgnore: true */ moduleName)).then(function (s) { return __importStar(require(s)); });
166
- });
59
+ options.loadModule ??
60
+ (() => {
61
+ // Dynamic import — @google-cloud/secret-manager is an optional peer dependency
62
+ const moduleName = "@google-cloud/secret-manager";
63
+ return import(/* webpackIgnore: true */ moduleName);
64
+ });
65
+ }
66
+ async getClient() {
67
+ if (!this.client) {
68
+ let mod;
69
+ try {
70
+ mod = await this.loadModule();
71
+ }
72
+ catch {
73
+ throw new errors_1.APIError({
74
+ status: 500,
75
+ title: "GcpSecretProvider requires @google-cloud/secret-manager. Install it with: bun add @google-cloud/secret-manager",
76
+ });
77
+ }
78
+ const SecretManagerServiceClient = mod.SecretManagerServiceClient ?? mod.default?.SecretManagerServiceClient;
79
+ if (!SecretManagerServiceClient) {
80
+ throw new errors_1.APIError({
81
+ status: 500,
82
+ title: "SecretManagerServiceClient not found in @google-cloud/secret-manager module",
83
+ });
84
+ }
85
+ this.client = new SecretManagerServiceClient();
86
+ }
87
+ return this.client;
167
88
  }
168
- GcpSecretProvider.prototype.getClient = function () {
169
- return __awaiter(this, void 0, void 0, function () {
170
- var mod, _a, SecretManagerServiceClient;
171
- var _b, _c;
172
- return __generator(this, function (_d) {
173
- switch (_d.label) {
174
- case 0:
175
- if (!!this.client) return [3 /*break*/, 5];
176
- mod = void 0;
177
- _d.label = 1;
178
- case 1:
179
- _d.trys.push([1, 3, , 4]);
180
- return [4 /*yield*/, this.loadModule()];
181
- case 2:
182
- mod = _d.sent();
183
- return [3 /*break*/, 4];
184
- case 3:
185
- _a = _d.sent();
186
- throw new errors_1.APIError({
187
- status: 500,
188
- title: "GcpSecretProvider requires @google-cloud/secret-manager. Install it with: bun add @google-cloud/secret-manager",
189
- });
190
- case 4:
191
- SecretManagerServiceClient = (_b = mod.SecretManagerServiceClient) !== null && _b !== void 0 ? _b : (_c = mod.default) === null || _c === void 0 ? void 0 : _c.SecretManagerServiceClient;
192
- if (!SecretManagerServiceClient) {
193
- throw new errors_1.APIError({
194
- status: 500,
195
- title: "SecretManagerServiceClient not found in @google-cloud/secret-manager module",
196
- });
197
- }
198
- this.client = new SecretManagerServiceClient();
199
- _d.label = 5;
200
- case 5: return [2 /*return*/, this.client];
201
- }
202
- });
203
- });
204
- };
205
89
  /**
206
90
  * Resolve a secret from Google Cloud Secret Manager.
207
91
  *
@@ -212,52 +96,38 @@ var GcpSecretProvider = /** @class */ (function () {
212
96
  * (e.g. "3"). Defaults to "latest". Ignored when `secretName` already
213
97
  * contains an explicit `/versions/...` suffix.
214
98
  */
215
- GcpSecretProvider.prototype.getSecret = function (secretName, version) {
216
- return __awaiter(this, void 0, void 0, function () {
217
- var client, resolvedVersion, resourceName, _a, version_1, payload, error_1;
218
- var _b;
219
- return __generator(this, function (_c) {
220
- switch (_c.label) {
221
- case 0: return [4 /*yield*/, this.getClient()];
222
- case 1:
223
- client = _c.sent();
224
- resolvedVersion = version !== null && version !== void 0 ? version : "latest";
225
- if (secretName.startsWith("projects/")) {
226
- // Honor a full resource path. Only append a version when one is not present.
227
- resourceName = secretName.includes("/versions/")
228
- ? secretName
229
- : "".concat(secretName, "/versions/").concat(resolvedVersion);
230
- }
231
- else {
232
- resourceName = "projects/".concat(this.projectId, "/secrets/").concat(secretName, "/versions/").concat(resolvedVersion);
233
- }
234
- _c.label = 2;
235
- case 2:
236
- _c.trys.push([2, 4, , 5]);
237
- return [4 /*yield*/, client.accessSecretVersion({ name: resourceName })];
238
- case 3:
239
- _a = __read.apply(void 0, [_c.sent(), 1]), version_1 = _a[0];
240
- payload = (_b = version_1.payload) === null || _b === void 0 ? void 0 : _b.data;
241
- if (!payload) {
242
- logger_1.logger.warn("GcpSecretProvider: secret ".concat(secretName, " has no payload"));
243
- return [2 /*return*/, null];
244
- }
245
- return [2 /*return*/, typeof payload === "string" ? payload : new TextDecoder().decode(payload)];
246
- case 4:
247
- error_1 = _c.sent();
248
- if (error_1 instanceof Error && "code" in error_1 && error_1.code === 5) {
249
- // NOT_FOUND
250
- logger_1.logger.warn("GcpSecretProvider: secret ".concat(secretName, " not found"));
251
- return [2 /*return*/, null];
252
- }
253
- throw error_1;
254
- case 5: return [2 /*return*/];
255
- }
256
- });
257
- });
258
- };
259
- return GcpSecretProvider;
260
- }());
99
+ async getSecret(secretName, version) {
100
+ const client = await this.getClient();
101
+ const resolvedVersion = version ?? "latest";
102
+ let resourceName;
103
+ if (secretName.startsWith("projects/")) {
104
+ // Honor a full resource path. Only append a version when one is not present.
105
+ resourceName = secretName.includes("/versions/")
106
+ ? secretName
107
+ : `${secretName}/versions/${resolvedVersion}`;
108
+ }
109
+ else {
110
+ resourceName = `projects/${this.projectId}/secrets/${secretName}/versions/${resolvedVersion}`;
111
+ }
112
+ try {
113
+ const [version] = await client.accessSecretVersion({ name: resourceName });
114
+ const payload = version.payload?.data;
115
+ if (!payload) {
116
+ logger_1.logger.warn(`GcpSecretProvider: secret ${secretName} has no payload`);
117
+ return null;
118
+ }
119
+ return typeof payload === "string" ? payload : new TextDecoder().decode(payload);
120
+ }
121
+ catch (error) {
122
+ if (error instanceof Error && "code" in error && error.code === 5) {
123
+ // NOT_FOUND
124
+ logger_1.logger.warn(`GcpSecretProvider: secret ${secretName} not found`);
125
+ return null;
126
+ }
127
+ throw error;
128
+ }
129
+ }
130
+ }
261
131
  exports.GcpSecretProvider = GcpSecretProvider;
262
132
  /**
263
133
  * Secret provider that delegates to an ordered list of providers, returning the
@@ -277,8 +147,10 @@ exports.GcpSecretProvider = GcpSecretProvider;
277
147
  * const key = await provider.getSecret("openai-api-key");
278
148
  * ```
279
149
  */
280
- var CompositeSecretProvider = /** @class */ (function () {
281
- function CompositeSecretProvider(providers) {
150
+ class CompositeSecretProvider {
151
+ name;
152
+ providers;
153
+ constructor(providers) {
282
154
  if (!providers || providers.length === 0) {
283
155
  throw new errors_1.APIError({
284
156
  status: 500,
@@ -286,57 +158,25 @@ var CompositeSecretProvider = /** @class */ (function () {
286
158
  });
287
159
  }
288
160
  this.providers = providers;
289
- this.name = "composite(".concat(providers.map(function (p) { return p.name; }).join(","), ")");
161
+ this.name = `composite(${providers.map((p) => p.name).join(",")})`;
290
162
  }
291
- CompositeSecretProvider.prototype.getSecret = function (secretName, version) {
292
- return __awaiter(this, void 0, void 0, function () {
293
- var _a, _b, provider, value, error_2, message, e_1_1;
294
- var e_1, _c;
295
- return __generator(this, function (_d) {
296
- switch (_d.label) {
297
- case 0:
298
- _d.trys.push([0, 7, 8, 9]);
299
- _a = __values(this.providers), _b = _a.next();
300
- _d.label = 1;
301
- case 1:
302
- if (!!_b.done) return [3 /*break*/, 6];
303
- provider = _b.value;
304
- _d.label = 2;
305
- case 2:
306
- _d.trys.push([2, 4, , 5]);
307
- return [4 /*yield*/, provider.getSecret(secretName, version)];
308
- case 3:
309
- value = _d.sent();
310
- if (value !== null) {
311
- return [2 /*return*/, value];
312
- }
313
- return [3 /*break*/, 5];
314
- case 4:
315
- error_2 = _d.sent();
316
- message = error_2 instanceof Error ? error_2.message : String(error_2);
317
- logger_1.logger.warn("CompositeSecretProvider: provider ".concat(provider.name, " failed for secret ").concat(secretName, ": ").concat(message));
318
- return [3 /*break*/, 5];
319
- case 5:
320
- _b = _a.next();
321
- return [3 /*break*/, 1];
322
- case 6: return [3 /*break*/, 9];
323
- case 7:
324
- e_1_1 = _d.sent();
325
- e_1 = { error: e_1_1 };
326
- return [3 /*break*/, 9];
327
- case 8:
328
- try {
329
- if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
330
- }
331
- finally { if (e_1) throw e_1.error; }
332
- return [7 /*endfinally*/];
333
- case 9: return [2 /*return*/, null];
163
+ async getSecret(secretName, version) {
164
+ for (const provider of this.providers) {
165
+ try {
166
+ const value = await provider.getSecret(secretName, version);
167
+ if (value !== null) {
168
+ return value;
334
169
  }
335
- });
336
- });
337
- };
338
- return CompositeSecretProvider;
339
- }());
170
+ }
171
+ catch (error) {
172
+ // Never log the secret value — only the name and which provider failed.
173
+ const message = error instanceof Error ? error.message : String(error);
174
+ logger_1.logger.warn(`CompositeSecretProvider: provider ${provider.name} failed for secret ${secretName}: ${message}`);
175
+ }
176
+ }
177
+ return null;
178
+ }
179
+ }
340
180
  exports.CompositeSecretProvider = CompositeSecretProvider;
341
181
  /**
342
182
  * Secret provider that wraps any provider with an in-memory TTL cache.
@@ -357,46 +197,37 @@ exports.CompositeSecretProvider = CompositeSecretProvider;
357
197
  * );
358
198
  * ```
359
199
  */
360
- var CachingSecretProvider = /** @class */ (function () {
361
- function CachingSecretProvider(provider, options) {
362
- var _a;
363
- this.cache = new Map();
200
+ class CachingSecretProvider {
201
+ name;
202
+ provider;
203
+ ttlMs;
204
+ cache = new Map();
205
+ constructor(provider, options) {
364
206
  this.provider = provider;
365
- this.ttlMs = (_a = options === null || options === void 0 ? void 0 : options.ttlMs) !== null && _a !== void 0 ? _a : 60000;
366
- this.name = "caching(".concat(provider.name, ")");
207
+ this.ttlMs = options?.ttlMs ?? 60_000;
208
+ this.name = `caching(${provider.name})`;
209
+ }
210
+ cacheKey(secretName, version) {
211
+ return `${secretName}@${version ?? "latest"}`;
212
+ }
213
+ async getSecret(secretName, version) {
214
+ const key = this.cacheKey(secretName, version);
215
+ const now = luxon_1.DateTime.now().toMillis();
216
+ const cached = this.cache.get(key);
217
+ if (cached && cached.expiresAt > now) {
218
+ return cached.value;
219
+ }
220
+ const value = await this.provider.getSecret(secretName, version);
221
+ this.cache.set(key, { expiresAt: now + this.ttlMs, value });
222
+ return value;
367
223
  }
368
- CachingSecretProvider.prototype.cacheKey = function (secretName, version) {
369
- return "".concat(secretName, "@").concat(version !== null && version !== void 0 ? version : "latest");
370
- };
371
- CachingSecretProvider.prototype.getSecret = function (secretName, version) {
372
- return __awaiter(this, void 0, void 0, function () {
373
- var key, now, cached, value;
374
- return __generator(this, function (_a) {
375
- switch (_a.label) {
376
- case 0:
377
- key = this.cacheKey(secretName, version);
378
- now = luxon_1.DateTime.now().toMillis();
379
- cached = this.cache.get(key);
380
- if (cached && cached.expiresAt > now) {
381
- return [2 /*return*/, cached.value];
382
- }
383
- return [4 /*yield*/, this.provider.getSecret(secretName, version)];
384
- case 1:
385
- value = _a.sent();
386
- this.cache.set(key, { expiresAt: now + this.ttlMs, value: value });
387
- return [2 /*return*/, value];
388
- }
389
- });
390
- });
391
- };
392
224
  /** Clears the entire cache. Useful on secret rotation and in tests. */
393
- CachingSecretProvider.prototype.clear = function () {
225
+ clear() {
394
226
  this.cache.clear();
395
- };
227
+ }
396
228
  /** Invalidates a single cached secret by name (and optional version). */
397
- CachingSecretProvider.prototype.clearKey = function (secretName, version) {
229
+ clearKey(secretName, version) {
398
230
  this.cache.delete(this.cacheKey(secretName, version));
399
- };
400
- return CachingSecretProvider;
401
- }());
231
+ }
232
+ }
402
233
  exports.CachingSecretProvider = CachingSecretProvider;