@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,70 +1,12 @@
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 __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
14
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
15
- return new (P || (P = Promise))(function (resolve, reject) {
16
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
17
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
18
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
19
- step((generator = generator.apply(thisArg, _arguments || [])).next());
20
- });
21
- };
22
- var __generator = (this && this.__generator) || function (thisArg, body) {
23
- 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);
24
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
- function verb(n) { return function (v) { return step([n, v]); }; }
26
- function step(op) {
27
- if (f) throw new TypeError("Generator is already executing.");
28
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
29
- 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;
30
- if (y = 0, t) op = [op[0] & 2, t.value];
31
- switch (op[0]) {
32
- case 0: case 1: t = op; break;
33
- case 4: _.label++; return { value: op[1], done: false };
34
- case 5: _.label++; y = op[1]; op = [0]; continue;
35
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
36
- default:
37
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
38
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
39
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
40
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
41
- if (t[2]) _.ops.pop();
42
- _.trys.pop(); continue;
43
- }
44
- op = body.call(thisArg, _);
45
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
46
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
47
- }
48
- };
49
- var __values = (this && this.__values) || function(o) {
50
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
51
- if (m) return m.call(o);
52
- if (o && typeof o.length === "number") return {
53
- next: function () {
54
- if (o && i >= o.length) o = void 0;
55
- return { value: o && o[i++], done: !o };
56
- }
57
- };
58
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
59
- };
60
2
  var __importDefault = (this && this.__importDefault) || function (mod) {
61
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
62
4
  };
63
5
  Object.defineProperty(exports, "__esModule", { value: true });
64
6
  exports.createAuthenticatedClient = exports.withApiErrorHandling = exports.normalizeApiError = exports.markRetryUnsafe = void 0;
65
- var axios_1 = __importDefault(require("axios"));
66
- var errors_1 = require("./errors");
67
- var logger_1 = require("./logger");
7
+ const axios_1 = __importDefault(require("axios"));
8
+ const errors_1 = require("./errors");
9
+ const logger_1 = require("./logger");
68
10
  /**
69
11
  * Opts a non-idempotent request (POST/PUT/PATCH/DELETE) into the retry policy of a
70
12
  * createAuthenticatedClient instance: `client.axios.post(url, body, markRetryUnsafe())`.
@@ -72,12 +14,11 @@ var logger_1 = require("./logger");
72
14
  * replayable — JSON objects are fine, but streams/FormData are consumed on first send.
73
15
  * Has no effect on axios instances not created by createAuthenticatedClient.
74
16
  */
75
- var markRetryUnsafe = function (config) {
76
- if (config === void 0) { config = {}; }
77
- return __assign(__assign({}, config), { retryUnsafe: true });
17
+ const markRetryUnsafe = (config = {}) => {
18
+ return { ...config, retryUnsafe: true };
78
19
  };
79
20
  exports.markRetryUnsafe = markRetryUnsafe;
80
- var classifyStatusCode = function (statusCode) {
21
+ const classifyStatusCode = (statusCode) => {
81
22
  if (statusCode === 429) {
82
23
  return "rateLimited";
83
24
  }
@@ -97,51 +38,40 @@ var classifyStatusCode = function (statusCode) {
97
38
  };
98
39
  // Plain-string bodies (HTML error pages, proxy text) are truncated to this length so an
99
40
  // unbounded — and potentially sensitive — payload never reaches the logger whole.
100
- var MAX_STRING_BODY_MESSAGE_LENGTH = 500;
41
+ const MAX_STRING_BODY_MESSAGE_LENGTH = 500;
101
42
  /**
102
43
  * Extracts human-readable messages from common API error response body shapes:
103
44
  * plain strings (truncated), `{message}`, and JSONAPI-style `{errors: [{title, detail}]}`.
104
45
  * Returns an empty array when the body has no recognizable message.
105
46
  */
106
- var extractBodyMessages = function (data) {
107
- var e_1, _a;
47
+ const extractBodyMessages = (data) => {
108
48
  if (typeof data === "string" && data.length > 0) {
109
49
  if (data.length > MAX_STRING_BODY_MESSAGE_LENGTH) {
110
- return ["".concat(data.slice(0, MAX_STRING_BODY_MESSAGE_LENGTH), "\u2026")];
50
+ return [`${data.slice(0, MAX_STRING_BODY_MESSAGE_LENGTH)}…`];
111
51
  }
112
52
  return [data];
113
53
  }
114
54
  if (data && typeof data === "object") {
115
- var body = data;
55
+ const body = data;
116
56
  if (typeof body.message === "string" && body.message.length > 0) {
117
57
  return [body.message];
118
58
  }
119
59
  if (Array.isArray(body.errors)) {
120
- var messages = [];
121
- try {
122
- for (var _b = __values(body.errors), _c = _b.next(); !_c.done; _c = _b.next()) {
123
- var entry = _c.value;
124
- if (entry && typeof entry === "object") {
125
- var _d = entry, title = _d.title, detail = _d.detail;
126
- if (typeof title === "string" && typeof detail === "string") {
127
- messages.push("".concat(title, ": ").concat(detail));
128
- }
129
- else if (typeof title === "string") {
130
- messages.push(title);
131
- }
132
- else if (typeof detail === "string") {
133
- messages.push(detail);
134
- }
60
+ const messages = [];
61
+ for (const entry of body.errors) {
62
+ if (entry && typeof entry === "object") {
63
+ const { title, detail } = entry;
64
+ if (typeof title === "string" && typeof detail === "string") {
65
+ messages.push(`${title}: ${detail}`);
66
+ }
67
+ else if (typeof title === "string") {
68
+ messages.push(title);
69
+ }
70
+ else if (typeof detail === "string") {
71
+ messages.push(detail);
135
72
  }
136
73
  }
137
74
  }
138
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
139
- finally {
140
- try {
141
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
142
- }
143
- finally { if (e_1) throw e_1.error; }
144
- }
145
75
  if (messages.length > 0) {
146
76
  return messages;
147
77
  }
@@ -161,18 +91,35 @@ var extractBodyMessages = function (data) {
161
91
  * put sensitive data inside those message fields should additionally use a redactError
162
92
  * hook.
163
93
  */
164
- var normalizeApiError = function (error, context) {
165
- var _a, _b;
166
- var base = { apiName: context.apiName, operation: context.operation };
94
+ const normalizeApiError = (error, context) => {
95
+ const base = { apiName: context.apiName, operation: context.operation };
167
96
  if (axios_1.default.isAxiosError(error)) {
168
- var statusCode = (_a = error.response) === null || _a === void 0 ? void 0 : _a.status;
97
+ const statusCode = error.response?.status;
169
98
  if (statusCode === undefined) {
170
- return __assign(__assign({}, base), { classification: "network", isAxios: true, messages: [error.message], statusCode: undefined });
99
+ return {
100
+ ...base,
101
+ classification: "network",
102
+ isAxios: true,
103
+ messages: [error.message],
104
+ statusCode: undefined,
105
+ };
171
106
  }
172
- var bodyMessages = extractBodyMessages((_b = error.response) === null || _b === void 0 ? void 0 : _b.data);
173
- return __assign(__assign({}, base), { classification: classifyStatusCode(statusCode), isAxios: true, messages: bodyMessages.length > 0 ? bodyMessages : [error.message], statusCode: statusCode });
107
+ const bodyMessages = extractBodyMessages(error.response?.data);
108
+ return {
109
+ ...base,
110
+ classification: classifyStatusCode(statusCode),
111
+ isAxios: true,
112
+ messages: bodyMessages.length > 0 ? bodyMessages : [error.message],
113
+ statusCode,
114
+ };
174
115
  }
175
- return __assign(__assign({}, base), { classification: "unknown", isAxios: false, messages: [error instanceof Error ? error.message : String(error)], statusCode: undefined });
116
+ return {
117
+ ...base,
118
+ classification: "unknown",
119
+ isAxios: false,
120
+ messages: [error instanceof Error ? error.message : String(error)],
121
+ statusCode: undefined,
122
+ };
176
123
  };
177
124
  exports.normalizeApiError = normalizeApiError;
178
125
  /**
@@ -185,60 +132,50 @@ exports.normalizeApiError = normalizeApiError;
185
132
  * APIError with a stable title (per-occurrence text goes in `detail`) and stays silent
186
133
  * itself — apiErrorMiddleware logs APIErrors, so logging here too would double-log.
187
134
  */
188
- var withApiErrorHandling = function (fn, options) { return __awaiter(void 0, void 0, void 0, function () {
189
- var log, error_1, normalized, statusCode;
190
- var _a, _b;
191
- return __generator(this, function (_c) {
192
- switch (_c.label) {
193
- case 0:
194
- log = (_a = options.logger) !== null && _a !== void 0 ? _a : logger_1.logger;
195
- _c.label = 1;
196
- case 1:
197
- _c.trys.push([1, 3, , 4]);
198
- return [4 /*yield*/, fn()];
199
- case 2: return [2 /*return*/, _c.sent()];
200
- case 3:
201
- error_1 = _c.sent();
202
- normalized = (0, exports.normalizeApiError)(error_1, {
203
- apiName: options.apiName,
204
- operation: options.operation,
205
- });
206
- if (options.redactError) {
207
- normalized = options.redactError(normalized);
208
- }
209
- if (options.rethrowAs === "apiError") {
210
- statusCode = normalized.statusCode;
211
- throw new errors_1.APIError({
212
- cause: error_1,
213
- code: "http-client-error",
214
- detail: (_b = normalized.messages[0]) !== null && _b !== void 0 ? _b : "unknown error",
215
- meta: { classification: normalized.classification },
216
- status: statusCode !== undefined && statusCode >= 400 ? statusCode : 500,
217
- title: "".concat(options.apiName, " ").concat(options.operation, " request failed"),
218
- });
219
- }
220
- log.error("[".concat(options.apiName, "] ").concat(options.operation, " failed"), normalized);
221
- throw error_1;
222
- case 4: return [2 /*return*/];
135
+ const withApiErrorHandling = async (fn, options) => {
136
+ const log = options.logger ?? logger_1.logger;
137
+ try {
138
+ return await fn();
139
+ }
140
+ catch (error) {
141
+ let normalized = (0, exports.normalizeApiError)(error, {
142
+ apiName: options.apiName,
143
+ operation: options.operation,
144
+ });
145
+ if (options.redactError) {
146
+ normalized = options.redactError(normalized);
223
147
  }
224
- });
225
- }); };
148
+ if (options.rethrowAs === "apiError") {
149
+ const statusCode = normalized.statusCode;
150
+ throw new errors_1.APIError({
151
+ cause: error,
152
+ code: "http-client-error",
153
+ detail: normalized.messages[0] ?? "unknown error",
154
+ meta: { classification: normalized.classification },
155
+ status: statusCode !== undefined && statusCode >= 400 ? statusCode : 500,
156
+ title: `${options.apiName} ${options.operation} request failed`,
157
+ });
158
+ }
159
+ log.error(`[${options.apiName}] ${options.operation} failed`, normalized);
160
+ throw error;
161
+ }
162
+ };
226
163
  exports.withApiErrorHandling = withApiErrorHandling;
227
- var DEFAULT_RETRY_POLICY = {
164
+ const DEFAULT_RETRY_POLICY = {
228
165
  baseDelayMs: 250,
229
166
  maxAttempts: 3,
230
- maxDelayMs: 30000,
167
+ maxDelayMs: 30_000,
231
168
  retryOn: ["rateLimited", "server", "network"],
232
169
  };
233
170
  // Retries apply only to these methods unless a request opts in via markRetryUnsafe() —
234
171
  // repeating a failed POST against an external service can duplicate side effects.
235
- var IDEMPOTENT_METHODS = ["get", "head", "options"];
236
- var sleep = function (ms) { return new Promise(function (resolve) { return setTimeout(resolve, ms); }); };
237
- var parseRetryAfterMs = function (headerValue) {
172
+ const IDEMPOTENT_METHODS = ["get", "head", "options"];
173
+ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
174
+ const parseRetryAfterMs = (headerValue) => {
238
175
  if (typeof headerValue !== "string" || headerValue.trim() === "") {
239
176
  return undefined;
240
177
  }
241
- var seconds = Number(headerValue);
178
+ const seconds = Number(headerValue);
242
179
  if (Number.isFinite(seconds) && seconds >= 0) {
243
180
  return seconds * 1000;
244
181
  }
@@ -263,154 +200,129 @@ var parseRetryAfterMs = function (headerValue) {
263
200
  * rejects with the original axios error — error-level logging is left to the call site
264
201
  * (typically via withApiErrorHandling) so composed usage logs each failure exactly once.
265
202
  */
266
- var createAuthenticatedClient = function (options) {
267
- var _a, _b;
268
- var log = (_a = options.logger) !== null && _a !== void 0 ? _a : logger_1.logger;
269
- var apiName = (_b = options.apiName) !== null && _b !== void 0 ? _b : options.baseURL;
270
- var retryPolicy = __assign(__assign({}, DEFAULT_RETRY_POLICY), options.retry);
203
+ const createAuthenticatedClient = (options) => {
204
+ const log = options.logger ?? logger_1.logger;
205
+ const apiName = options.apiName ?? options.baseURL;
206
+ const retryPolicy = { ...DEFAULT_RETRY_POLICY, ...options.retry };
271
207
  // The in-flight promise is cached (not the resolved value) so concurrent first
272
208
  // requests share a single token fetch. resolvedToken tracks the last issued token so
273
209
  // a 401 only invalidates the cache if a newer token hasn't already replaced it.
274
- var tokenPromise;
275
- var resolvedToken;
276
- var fetchToken = function () { return __awaiter(void 0, void 0, void 0, function () {
277
- var auth, response, accessToken;
278
- var _a;
279
- return __generator(this, function (_b) {
280
- switch (_b.label) {
281
- case 0:
282
- auth = options.auth;
283
- if (auth.type === "bearer") {
284
- return [2 /*return*/, auth.getToken()];
285
- }
286
- if (auth.type === "apiKey") {
287
- return [2 /*return*/, auth.getKey()];
288
- }
289
- return [4 /*yield*/, axios_1.default.post(auth.tokenUrl, new URLSearchParams({ grant_type: "client_credentials" }), {
290
- auth: { password: auth.credentials.clientSecret, username: auth.credentials.clientId },
291
- headers: { "Content-Type": "application/x-www-form-urlencoded" },
292
- })];
293
- case 1:
294
- response = _b.sent();
295
- accessToken = (_a = response.data) === null || _a === void 0 ? void 0 : _a.access_token;
296
- if (typeof accessToken !== "string" || accessToken.length === 0) {
297
- throw new errors_1.InternalServerError({
298
- code: "http-client-error",
299
- detail: "".concat(apiName, " token response has no access_token"),
300
- title: "[httpClient] token response has no access_token",
301
- });
302
- }
303
- return [2 /*return*/, accessToken];
304
- }
210
+ let tokenPromise;
211
+ let resolvedToken;
212
+ const fetchToken = async () => {
213
+ const { auth } = options;
214
+ if (auth.type === "bearer") {
215
+ return auth.getToken();
216
+ }
217
+ if (auth.type === "apiKey") {
218
+ return auth.getKey();
219
+ }
220
+ const response = await axios_1.default.post(auth.tokenUrl, new URLSearchParams({ grant_type: "client_credentials" }), {
221
+ auth: { password: auth.credentials.clientSecret, username: auth.credentials.clientId },
222
+ headers: { "Content-Type": "application/x-www-form-urlencoded" },
305
223
  });
306
- }); };
307
- var invalidateToken = function () {
224
+ const accessToken = response.data?.access_token;
225
+ if (typeof accessToken !== "string" || accessToken.length === 0) {
226
+ throw new errors_1.InternalServerError({
227
+ code: "http-client-error",
228
+ detail: `${apiName} token response has no access_token`,
229
+ title: "[httpClient] token response has no access_token",
230
+ });
231
+ }
232
+ return accessToken;
233
+ };
234
+ const invalidateToken = () => {
308
235
  tokenPromise = undefined;
309
236
  resolvedToken = undefined;
310
237
  };
311
- var getCachedToken = function () {
238
+ const getCachedToken = () => {
312
239
  if (!tokenPromise) {
313
240
  // The promise-identity checks below keep an out-of-order resolution (a fetch that
314
241
  // was invalidated and replaced while in flight) from clobbering the newer fetch's
315
242
  // cache state.
316
- var thisPromise_1 = fetchToken().then(function (token) {
317
- if (tokenPromise === thisPromise_1) {
243
+ const thisPromise = fetchToken().then((token) => {
244
+ if (tokenPromise === thisPromise) {
318
245
  resolvedToken = token;
319
246
  }
320
247
  return token;
321
- }, function (error) {
248
+ }, (error) => {
322
249
  // Clear the failed fetch so the next request retries, and wrap the failure in
323
250
  // a plain Error. The wrapping is what keeps the raw token-request AxiosError
324
251
  // out of the response interceptor's refresh/retry logic (a wrapped error fails
325
252
  // the isAxiosError guard); __httpClientManaged is defense-in-depth behind it.
326
- if (tokenPromise === thisPromise_1) {
253
+ if (tokenPromise === thisPromise) {
327
254
  invalidateToken();
328
255
  }
329
- var normalized = (0, exports.normalizeApiError)(error, { apiName: apiName, operation: "token fetch" });
330
- var wrapped = new Error("[httpClient] ".concat(apiName, " token fetch failed: ").concat(normalized.messages[0]));
256
+ const normalized = (0, exports.normalizeApiError)(error, { apiName, operation: "token fetch" });
257
+ const wrapped = new Error(`[httpClient] ${apiName} token fetch failed: ${normalized.messages[0]}`);
331
258
  wrapped.cause = error;
332
259
  throw wrapped;
333
260
  });
334
- tokenPromise = thisPromise_1;
261
+ tokenPromise = thisPromise;
335
262
  }
336
263
  return tokenPromise;
337
264
  };
338
- var instance = axios_1.default.create({ baseURL: options.baseURL });
339
- instance.interceptors.request.use(function (config) { return __awaiter(void 0, void 0, void 0, function () {
340
- var token;
341
- return __generator(this, function (_a) {
342
- switch (_a.label) {
343
- case 0:
344
- config.__httpClientManaged = true;
345
- return [4 /*yield*/, getCachedToken()];
346
- case 1:
347
- token = _a.sent();
348
- if (options.auth.type === "apiKey") {
349
- config.headers.set(options.auth.header, token);
350
- }
351
- else {
352
- config.headers.set("Authorization", "Bearer ".concat(token));
353
- }
354
- return [2 /*return*/, config];
355
- }
265
+ const instance = axios_1.default.create({ baseURL: options.baseURL });
266
+ instance.interceptors.request.use(async (config) => {
267
+ config.__httpClientManaged = true;
268
+ const token = await getCachedToken();
269
+ if (options.auth.type === "apiKey") {
270
+ config.headers.set(options.auth.header, token);
271
+ }
272
+ else {
273
+ config.headers.set("Authorization", `Bearer ${token}`);
274
+ }
275
+ return config;
276
+ });
277
+ instance.interceptors.response.use(undefined, async (error) => {
278
+ if (!axios_1.default.isAxiosError(error) || !error.config) {
279
+ throw error;
280
+ }
281
+ const config = error.config;
282
+ // Errors from configs this client didn't manage (e.g. a failing token POST) must
283
+ // propagate untouched — refreshing or retrying them can loop forever.
284
+ if (!config.__httpClientManaged) {
285
+ throw error;
286
+ }
287
+ let normalized = (0, exports.normalizeApiError)(error, {
288
+ apiName,
289
+ operation: `${config.method ?? "request"} ${config.url ?? ""}`,
356
290
  });
357
- }); });
358
- instance.interceptors.response.use(undefined, function (error) { return __awaiter(void 0, void 0, void 0, function () {
359
- var config, normalized, sentAuthorization, method, isRetryableMethod, attemptsSoFar, backoffMs, retryAfterMs, delayMs;
360
- var _a, _b, _c, _d, _e, _f, _g;
361
- return __generator(this, function (_h) {
362
- switch (_h.label) {
363
- case 0:
364
- if (!axios_1.default.isAxiosError(error) || !error.config) {
365
- throw error;
366
- }
367
- config = error.config;
368
- // Errors from configs this client didn't manage (e.g. a failing token POST) must
369
- // propagate untouched — refreshing or retrying them can loop forever.
370
- if (!config.__httpClientManaged) {
371
- throw error;
372
- }
373
- normalized = (0, exports.normalizeApiError)(error, {
374
- apiName: apiName,
375
- operation: "".concat((_a = config.method) !== null && _a !== void 0 ? _a : "request", " ").concat((_b = config.url) !== null && _b !== void 0 ? _b : ""),
376
- });
377
- if (options.redactError) {
378
- normalized = options.redactError(normalized);
379
- }
380
- // One-shot token refresh on 401 for oauth2 strategies.
381
- if (options.auth.type === "oauth2" &&
382
- options.auth.refreshOn401 &&
383
- ((_c = error.response) === null || _c === void 0 ? void 0 : _c.status) === 401 &&
384
- !config.__httpClientDidAuthRefresh) {
385
- config.__httpClientDidAuthRefresh = true;
386
- sentAuthorization = config.headers.get("Authorization");
387
- if (resolvedToken === undefined || sentAuthorization === "Bearer ".concat(resolvedToken)) {
388
- invalidateToken();
389
- }
390
- log.debug("[".concat(apiName, "] ").concat(normalized.operation, " got 401, refreshing token and retrying"));
391
- return [2 /*return*/, instance.request(config)];
392
- }
393
- method = ((_d = config.method) !== null && _d !== void 0 ? _d : "get").toLowerCase();
394
- isRetryableMethod = IDEMPOTENT_METHODS.includes(method) || config.retryUnsafe === true;
395
- attemptsSoFar = ((_e = config.__httpClientRetryCount) !== null && _e !== void 0 ? _e : 0) + 1;
396
- if (!retryPolicy.retryOn.includes(normalized.classification) ||
397
- !isRetryableMethod ||
398
- attemptsSoFar >= retryPolicy.maxAttempts) {
399
- throw error;
400
- }
401
- config.__httpClientRetryCount = attemptsSoFar;
402
- backoffMs = retryPolicy.baseDelayMs * Math.pow(2, (attemptsSoFar - 1)) * (1 + Math.random() * 0.5);
403
- retryAfterMs = parseRetryAfterMs((_g = (_f = error.response) === null || _f === void 0 ? void 0 : _f.headers) === null || _g === void 0 ? void 0 : _g["retry-after"]);
404
- delayMs = Math.min(retryAfterMs !== null && retryAfterMs !== void 0 ? retryAfterMs : backoffMs, retryPolicy.maxDelayMs);
405
- log.debug("[".concat(apiName, "] ").concat(normalized.operation, " failed (").concat(normalized.classification, "), ") +
406
- "retrying attempt ".concat(attemptsSoFar + 1, "/").concat(retryPolicy.maxAttempts, " in ").concat(Math.round(delayMs), "ms"));
407
- return [4 /*yield*/, sleep(delayMs)];
408
- case 1:
409
- _h.sent();
410
- return [2 /*return*/, instance.request(config)];
291
+ if (options.redactError) {
292
+ normalized = options.redactError(normalized);
293
+ }
294
+ // One-shot token refresh on 401 for oauth2 strategies.
295
+ if (options.auth.type === "oauth2" &&
296
+ options.auth.refreshOn401 &&
297
+ error.response?.status === 401 &&
298
+ !config.__httpClientDidAuthRefresh) {
299
+ config.__httpClientDidAuthRefresh = true;
300
+ // Only invalidate if this request failed with the current token — a concurrent
301
+ // request may have already refreshed it.
302
+ const sentAuthorization = config.headers.get("Authorization");
303
+ if (resolvedToken === undefined || sentAuthorization === `Bearer ${resolvedToken}`) {
304
+ invalidateToken();
411
305
  }
412
- });
413
- }); });
414
- return { axios: instance, invalidateToken: invalidateToken };
306
+ log.debug(`[${apiName}] ${normalized.operation} got 401, refreshing token and retrying`);
307
+ return instance.request(config);
308
+ }
309
+ const method = (config.method ?? "get").toLowerCase();
310
+ const isRetryableMethod = IDEMPOTENT_METHODS.includes(method) || config.retryUnsafe === true;
311
+ const attemptsSoFar = (config.__httpClientRetryCount ?? 0) + 1;
312
+ if (!retryPolicy.retryOn.includes(normalized.classification) ||
313
+ !isRetryableMethod ||
314
+ attemptsSoFar >= retryPolicy.maxAttempts) {
315
+ throw error;
316
+ }
317
+ config.__httpClientRetryCount = attemptsSoFar;
318
+ const backoffMs = retryPolicy.baseDelayMs * 2 ** (attemptsSoFar - 1) * (1 + Math.random() * 0.5);
319
+ const retryAfterMs = parseRetryAfterMs(error.response?.headers?.["retry-after"]);
320
+ const delayMs = Math.min(retryAfterMs ?? backoffMs, retryPolicy.maxDelayMs);
321
+ log.debug(`[${apiName}] ${normalized.operation} failed (${normalized.classification}), ` +
322
+ `retrying attempt ${attemptsSoFar + 1}/${retryPolicy.maxAttempts} in ${Math.round(delayMs)}ms`);
323
+ await sleep(delayMs);
324
+ return instance.request(config);
325
+ });
326
+ return { axios: instance, invalidateToken };
415
327
  };
416
328
  exports.createAuthenticatedClient = createAuthenticatedClient;
package/dist/index.d.ts CHANGED
@@ -1,12 +1,18 @@
1
1
  export * from "./actions";
2
2
  export * from "./adminTypes";
3
3
  export * from "./api";
4
+ export { AuditApp, type AuditAppOptions } from "./audit/auditApp";
5
+ export { type AuditEventDocument, type AuditEventModel, type AuditEventOperation, type AuditEventSource, type AuditEventVerb, createAuditEventModel, } from "./audit/auditEventModel";
6
+ export { AUDIT_SECRET_HEADER, auditEnqueueFromEnv, type CloudTasksAuditEnqueueOptions, createCloudTasksAuditEnqueue, } from "./audit/cloudTasksEnqueue";
7
+ export { persistRbacAuditToAuditEvent } from "./audit/rbacSink";
8
+ export { type AuditEnqueue, type AuditEventWrite, type AuditRecorderOptions, flushAuditRecorderForTests, isAuditRecorderInstalled, type ModelRouterAuditConfig, type ModelRouterAuditOptions, maybeRecordAdminAudit, persistEnqueuedAuditEvent, recordAuditEvent, resetAuditRecorderForTests, } from "./audit/record";
4
9
  export * from "./auth";
5
10
  export * from "./authRecovery";
6
11
  export * from "./authTokens";
7
12
  export * from "./betterAuth";
8
13
  export * from "./betterAuthApp";
9
14
  export * from "./betterAuthSetup";
15
+ export * from "./browserLogsRoute";
10
16
  export * from "./config";
11
17
  export * from "./configurationApp";
12
18
  export * from "./configurationPlugin";
@@ -14,6 +20,7 @@ export * from "./consentApp";
14
20
  export * from "./envConfigurationPlugin";
15
21
  export * from "./errors";
16
22
  export * from "./expressServer";
23
+ export { FRAMEWORK_MODEL_PUBLIC_NAMES, type FrameworkModelCompiledName, type FrameworkModelPublicName, publicFrameworkModelName, } from "./frameworkModelNames";
17
24
  export * from "./githubAuth";
18
25
  export * from "./httpClient";
19
26
  export * from "./logger";
@@ -26,10 +33,21 @@ export { addMcpServiceTokenRoutes, MAX_ACTIVE_MCP_SERVICE_TOKENS, type McpServic
26
33
  export { generateAllTools, generateToolsForEntry, getAllMCPTools, type MCPToolDefinition, } from "./mcp/toolGenerator";
27
34
  export type { MCPConfig, MCPMethod, MCPRegistryEntry, MCPRequest, MCPToolArgs, MCPToolResult, } from "./mcp/types";
28
35
  export * from "./middleware";
36
+ export * from "./migrations/generate";
37
+ export * from "./migrations/load";
38
+ export * from "./migrations/lock";
39
+ export * from "./migrations/runner";
40
+ export * from "./migrations/schemaCatalog";
41
+ export * from "./migrations/types";
29
42
  export * from "./models/consentForm";
30
43
  export * from "./models/consentResponse";
31
44
  export * from "./models/mcpServiceToken";
45
+ export * from "./models/notification";
46
+ export * from "./models/notificationPreference";
32
47
  export * from "./models/versionConfig";
48
+ export { configureNotificationService, createNotificationService, getNotificationService, type NotificationService, type NotificationServiceOptions, type NotificationsCommsService, } from "./notifications/notificationService";
49
+ export { NotificationsApp, type NotificationsAppOptions, } from "./notifications/notificationsApp";
50
+ export { type NotificationsBeforeSendChannel, type NotificationsBeforeSendContext, type NotificationsBeforeSendResult, notificationsBeforeSend, } from "./notifications/notificationsBeforeSend";
33
51
  export * from "./notifiers/googleChatNotifier";
34
52
  export * from "./notifiers/slackNotifier";
35
53
  export * from "./notifiers/zoomNotifier";
@@ -37,6 +55,12 @@ export * from "./openApiBuilder";
37
55
  export * from "./openApiCompat";
38
56
  export * from "./openApiEtag";
39
57
  export * from "./openApiValidator";
58
+ export * from "./orgs/organizationModel";
59
+ export * from "./orgs/organizationSettings";
60
+ export * from "./orgs/orgContext";
61
+ export * from "./orgs/orgPermissions";
62
+ export * from "./orgs/orgPlugin";
63
+ export * from "./orgs/orgsApp";
40
64
  export * from "./permissions";
41
65
  export * from "./plugins";
42
66
  export * from "./populate";
@@ -47,9 +71,10 @@ export { assertAllowed } from "./rbac/assertAllowed";
47
71
  export { createRbacAuditModel, type RbacAuditDocument, recordRbacAudit, } from "./rbac/auditModel";
48
72
  export { type BackfillAdminsOptions, type BackfillAdminsResult, backfillAdmins, } from "./rbac/backfillAdmins";
49
73
  export * from "./rbac/fieldViews";
74
+ export { MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME, membershipOrgAdminPermissionSource, ORG_ADMIN_PERMISSION_BUNDLE, } from "./rbac/membershipOrgAdminSource";
50
75
  export * from "./rbac/middleware";
51
76
  export * from "./rbac/permissionUtils";
52
- export { createRbacRoleModel, expandRolePermissions, type RbacRoleDocument, type RbacRoleModel, READ_ONLY_ROLE_PERMISSIONS, type RoleDefinition, terrenoDefaultRoles, } from "./rbac/roleModel";
77
+ export { createRbacRoleModel, expandRolePermissions, organizationOperatorRole, type RbacRoleDocument, type RbacRoleModel, READ_ONLY_ROLE_PERMISSIONS, type RoleDefinition, terrenoDefaultRoles, } from "./rbac/roleModel";
53
78
  export { type RbacRouterOptions, rbacRouter } from "./rbac/routes";
54
79
  export * from "./rbac/scopes";
55
80
  export * from "./rbac/statements";
@@ -70,6 +95,8 @@ export * from "./scriptRunner";
70
95
  export { adminBodyFieldsToStrip, scrubAdminFields, stripAdminBodyFields } from "./scrubAdminFields";
71
96
  export * from "./secretProviders";
72
97
  export * from "./seedRunner";
98
+ export * from "./sync/adminBroadcastScope";
99
+ export * from "./sync/adminWindowMutation";
73
100
  export * from "./sync/executors";
74
101
  export * from "./sync/models";
75
102
  export * from "./sync/mutationHandler";