@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
@@ -4,46 +4,45 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
6
  exports.hmacSignature = void 0;
7
- var node_crypto_1 = __importDefault(require("node:crypto"));
8
- var luxon_1 = require("luxon");
9
- var headerValue_1 = require("../headerValue");
10
- var timingSafeEqual_1 = require("../timingSafeEqual");
7
+ const node_crypto_1 = __importDefault(require("node:crypto"));
8
+ const luxon_1 = require("luxon");
9
+ const headerValue_1 = require("../headerValue");
10
+ const timingSafeEqual_1 = require("../timingSafeEqual");
11
11
  /**
12
12
  * Verifies `header` against HMAC of `req.rawBody`.
13
13
  * When `timestampHeader` is set, the MAC is HMAC(`${timestamp}.${rawBody}`) and
14
14
  * timestamps outside `toleranceSec` (default 300) are rejected.
15
15
  */
16
- var hmacSignature = function (options) {
17
- var _a, _b, _c;
18
- var algorithm = (_a = options.algorithm) !== null && _a !== void 0 ? _a : "sha256";
19
- var encoding = (_b = options.encoding) !== null && _b !== void 0 ? _b : "hex";
20
- var toleranceSec = (_c = options.toleranceSec) !== null && _c !== void 0 ? _c : 300;
21
- return function (req) {
22
- var provided = (0, headerValue_1.headerValue)(req, options.header);
16
+ const hmacSignature = (options) => {
17
+ const algorithm = options.algorithm ?? "sha256";
18
+ const encoding = options.encoding ?? "hex";
19
+ const toleranceSec = options.toleranceSec ?? 300;
20
+ return (req) => {
21
+ const provided = (0, headerValue_1.headerValue)(req, options.header);
23
22
  if (!provided) {
24
23
  return false;
25
24
  }
26
25
  if (!req.rawBody) {
27
26
  return false;
28
27
  }
29
- var mac = node_crypto_1.default.createHmac(algorithm, options.secret);
28
+ const mac = node_crypto_1.default.createHmac(algorithm, options.secret);
30
29
  if (options.timestampHeader) {
31
- var timestampRaw = (0, headerValue_1.headerValue)(req, options.timestampHeader);
30
+ const timestampRaw = (0, headerValue_1.headerValue)(req, options.timestampHeader);
32
31
  if (!timestampRaw) {
33
32
  return false;
34
33
  }
35
- var timestamp = Number(timestampRaw);
34
+ const timestamp = Number(timestampRaw);
36
35
  if (!Number.isFinite(timestamp)) {
37
36
  return false;
38
37
  }
39
- var nowSec = luxon_1.DateTime.utc().toUnixInteger();
38
+ const nowSec = luxon_1.DateTime.utc().toUnixInteger();
40
39
  if (Math.abs(nowSec - timestamp) > toleranceSec) {
41
40
  return false;
42
41
  }
43
- mac.update("".concat(timestampRaw, "."));
42
+ mac.update(`${timestampRaw}.`);
44
43
  }
45
- var expected = mac.update(req.rawBody).digest(encoding);
46
- return (0, timingSafeEqual_1.timingSafeEqualUtf8)({ expected: expected, provided: provided });
44
+ const expected = mac.update(req.rawBody).digest(encoding);
45
+ return (0, timingSafeEqual_1.timingSafeEqualUtf8)({ expected, provided });
47
46
  };
48
47
  };
49
48
  exports.hmacSignature = hmacSignature;
@@ -4,51 +4,49 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
6
  exports.sendgridEventSignature = void 0;
7
- var node_crypto_1 = __importDefault(require("node:crypto"));
8
- var luxon_1 = require("luxon");
9
- var headerValue_1 = require("../headerValue");
10
- var PEM_HEADER = "-----BEGIN PUBLIC KEY-----";
11
- var PEM_FOOTER = "-----END PUBLIC KEY-----";
12
- var toPem = function (publicKey) {
13
- var _a, _b;
14
- var trimmed = publicKey.trim();
7
+ const node_crypto_1 = __importDefault(require("node:crypto"));
8
+ const luxon_1 = require("luxon");
9
+ const headerValue_1 = require("../headerValue");
10
+ const PEM_HEADER = "-----BEGIN PUBLIC KEY-----";
11
+ const PEM_FOOTER = "-----END PUBLIC KEY-----";
12
+ const toPem = (publicKey) => {
13
+ const trimmed = publicKey.trim();
15
14
  if (trimmed.includes(PEM_HEADER)) {
16
15
  return trimmed;
17
16
  }
18
- var body = trimmed.replace(/\s+/g, "");
19
- var wrapped = (_b = (_a = body.match(/.{1,64}/g)) === null || _a === void 0 ? void 0 : _a.join("\n")) !== null && _b !== void 0 ? _b : body;
20
- return "".concat(PEM_HEADER, "\n").concat(wrapped, "\n").concat(PEM_FOOTER);
17
+ const body = trimmed.replace(/\s+/g, "");
18
+ const wrapped = body.match(/.{1,64}/g)?.join("\n") ?? body;
19
+ return `${PEM_HEADER}\n${wrapped}\n${PEM_FOOTER}`;
21
20
  };
22
21
  /**
23
22
  * Verifies SendGrid Event Webhook ECDSA P-256 over `${timestamp}${rawBody}`.
24
23
  * Timestamps outside `toleranceSec` (default 300) are rejected.
25
24
  */
26
- var sendgridEventSignature = function (options) {
27
- var _a;
28
- var pem = toPem(options.publicKey);
29
- var toleranceSec = (_a = options.toleranceSec) !== null && _a !== void 0 ? _a : 300;
30
- return function (req) {
31
- var signature = (0, headerValue_1.headerValue)(req, "X-Twilio-Email-Event-Webhook-Signature");
32
- var timestampRaw = (0, headerValue_1.headerValue)(req, "X-Twilio-Email-Event-Webhook-Timestamp");
25
+ const sendgridEventSignature = (options) => {
26
+ const pem = toPem(options.publicKey);
27
+ const toleranceSec = options.toleranceSec ?? 300;
28
+ return (req) => {
29
+ const signature = (0, headerValue_1.headerValue)(req, "X-Twilio-Email-Event-Webhook-Signature");
30
+ const timestampRaw = (0, headerValue_1.headerValue)(req, "X-Twilio-Email-Event-Webhook-Timestamp");
33
31
  if (!signature || !timestampRaw || !req.rawBody) {
34
32
  return false;
35
33
  }
36
- var timestamp = Number(timestampRaw);
34
+ const timestamp = Number(timestampRaw);
37
35
  if (!Number.isFinite(timestamp)) {
38
36
  return false;
39
37
  }
40
- var nowSec = luxon_1.DateTime.utc().toUnixInteger();
38
+ const nowSec = luxon_1.DateTime.utc().toUnixInteger();
41
39
  if (Math.abs(nowSec - timestamp) > toleranceSec) {
42
40
  return false;
43
41
  }
44
42
  try {
45
- var verifier = node_crypto_1.default.createVerify("SHA256");
43
+ const verifier = node_crypto_1.default.createVerify("SHA256");
46
44
  verifier.update(timestampRaw);
47
45
  verifier.update(req.rawBody);
48
46
  verifier.end();
49
47
  return verifier.verify(pem, signature, "base64");
50
48
  }
51
- catch (_a) {
49
+ catch {
52
50
  return false;
53
51
  }
54
52
  };
@@ -1,97 +1,63 @@
1
1
  "use strict";
2
- var __values = (this && this.__values) || function(o) {
3
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
4
- if (m) return m.call(o);
5
- if (o && typeof o.length === "number") return {
6
- next: function () {
7
- if (o && i >= o.length) o = void 0;
8
- return { value: o && o[i++], done: !o };
9
- }
10
- };
11
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
12
- };
13
2
  var __importDefault = (this && this.__importDefault) || function (mod) {
14
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
15
4
  };
16
5
  Object.defineProperty(exports, "__esModule", { value: true });
17
6
  exports.stripeSignature = void 0;
18
- var node_crypto_1 = __importDefault(require("node:crypto"));
19
- var luxon_1 = require("luxon");
20
- var headerValue_1 = require("../headerValue");
21
- var timingSafeEqual_1 = require("../timingSafeEqual");
22
- var parseStripeSignature = function (header) {
23
- var e_1, _a;
24
- var timestamp;
25
- var v1 = [];
26
- try {
27
- for (var _b = __values(header.split(",")), _c = _b.next(); !_c.done; _c = _b.next()) {
28
- var part = _c.value;
29
- var separator = part.indexOf("=");
30
- if (separator <= 0) {
31
- continue;
32
- }
33
- var key = part.slice(0, separator).trim();
34
- var value = part.slice(separator + 1).trim();
35
- if (key === "t") {
36
- timestamp = value;
37
- }
38
- else if (key === "v1") {
39
- v1.push(value);
40
- }
7
+ const node_crypto_1 = __importDefault(require("node:crypto"));
8
+ const luxon_1 = require("luxon");
9
+ const headerValue_1 = require("../headerValue");
10
+ const timingSafeEqual_1 = require("../timingSafeEqual");
11
+ const parseStripeSignature = (header) => {
12
+ let timestamp;
13
+ const v1 = [];
14
+ for (const part of header.split(",")) {
15
+ const separator = part.indexOf("=");
16
+ if (separator <= 0) {
17
+ continue;
41
18
  }
42
- }
43
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
44
- finally {
45
- try {
46
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
19
+ const key = part.slice(0, separator).trim();
20
+ const value = part.slice(separator + 1).trim();
21
+ if (key === "t") {
22
+ timestamp = value;
23
+ }
24
+ else if (key === "v1") {
25
+ v1.push(value);
47
26
  }
48
- finally { if (e_1) throw e_1.error; }
49
27
  }
50
- return { timestamp: timestamp, v1: v1 };
28
+ return { timestamp, v1 };
51
29
  };
52
30
  /**
53
31
  * Verifies Stripe `Stripe-Signature` (`t=` / `v1=`) against HMAC-SHA256 of `${t}.${rawBody}`.
54
32
  */
55
- var stripeSignature = function (options) {
56
- var _a;
57
- var toleranceSec = (_a = options.toleranceSec) !== null && _a !== void 0 ? _a : 300;
58
- return function (req) {
59
- var e_2, _a;
60
- var header = (0, headerValue_1.headerValue)(req, "Stripe-Signature");
33
+ const stripeSignature = (options) => {
34
+ const toleranceSec = options.toleranceSec ?? 300;
35
+ return (req) => {
36
+ const header = (0, headerValue_1.headerValue)(req, "Stripe-Signature");
61
37
  if (!header || !req.rawBody) {
62
38
  return false;
63
39
  }
64
- var parsed = parseStripeSignature(header);
40
+ const parsed = parseStripeSignature(header);
65
41
  if (!parsed.timestamp || parsed.v1.length === 0) {
66
42
  return false;
67
43
  }
68
- var timestamp = Number(parsed.timestamp);
44
+ const timestamp = Number(parsed.timestamp);
69
45
  if (!Number.isFinite(timestamp)) {
70
46
  return false;
71
47
  }
72
- var nowSec = luxon_1.DateTime.utc().toUnixInteger();
48
+ const nowSec = luxon_1.DateTime.utc().toUnixInteger();
73
49
  if (Math.abs(nowSec - timestamp) > toleranceSec) {
74
50
  return false;
75
51
  }
76
- var expected = node_crypto_1.default
52
+ const expected = node_crypto_1.default
77
53
  .createHmac("sha256", options.secret)
78
- .update("".concat(parsed.timestamp, "."))
54
+ .update(`${parsed.timestamp}.`)
79
55
  .update(req.rawBody)
80
56
  .digest("hex");
81
- try {
82
- for (var _b = __values(parsed.v1), _c = _b.next(); !_c.done; _c = _b.next()) {
83
- var provided = _c.value;
84
- if ((0, timingSafeEqual_1.timingSafeEqualUtf8)({ expected: expected, provided: provided })) {
85
- return true;
86
- }
87
- }
88
- }
89
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
90
- finally {
91
- try {
92
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
57
+ for (const provided of parsed.v1) {
58
+ if ((0, timingSafeEqual_1.timingSafeEqualUtf8)({ expected, provided })) {
59
+ return true;
93
60
  }
94
- finally { if (e_2) throw e_2.error; }
95
61
  }
96
62
  return false;
97
63
  };
@@ -1,45 +1,17 @@
1
1
  "use strict";
2
- var __values = (this && this.__values) || function(o) {
3
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
4
- if (m) return m.call(o);
5
- if (o && typeof o.length === "number") return {
6
- next: function () {
7
- if (o && i >= o.length) o = void 0;
8
- return { value: o && o[i++], done: !o };
9
- }
10
- };
11
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
12
- };
13
- var __read = (this && this.__read) || function (o, n) {
14
- var m = typeof Symbol === "function" && o[Symbol.iterator];
15
- if (!m) return o;
16
- var i = m.call(o), r, ar = [], e;
17
- try {
18
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
19
- }
20
- catch (error) { e = { error: error }; }
21
- finally {
22
- try {
23
- if (r && !r.done && (m = i["return"])) m.call(i);
24
- }
25
- finally { if (e) throw e.error; }
26
- }
27
- return ar;
28
- };
29
2
  var __importDefault = (this && this.__importDefault) || function (mod) {
30
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
31
4
  };
32
5
  Object.defineProperty(exports, "__esModule", { value: true });
33
6
  exports.twilioSignature = void 0;
34
- var node_crypto_1 = __importDefault(require("node:crypto"));
35
- var headerValue_1 = require("../headerValue");
36
- var timingSafeEqual_1 = require("../timingSafeEqual");
37
- var isUrlencoded = function (req) {
38
- var _a;
39
- var contentType = (_a = (0, headerValue_1.headerValue)(req, "content-type")) !== null && _a !== void 0 ? _a : "";
7
+ const node_crypto_1 = __importDefault(require("node:crypto"));
8
+ const headerValue_1 = require("../headerValue");
9
+ const timingSafeEqual_1 = require("../timingSafeEqual");
10
+ const isUrlencoded = (req) => {
11
+ const contentType = (0, headerValue_1.headerValue)(req, "content-type") ?? "";
40
12
  return contentType.toLowerCase().includes("application/x-www-form-urlencoded");
41
13
  };
42
- var resolveUrl = function (req, url) {
14
+ const resolveUrl = (req, url) => {
43
15
  if (typeof url === "function") {
44
16
  return url(req);
45
17
  }
@@ -48,65 +20,43 @@ var resolveUrl = function (req, url) {
48
20
  }
49
21
  return undefined;
50
22
  };
51
- var formParams = function (body) {
52
- var e_1, _a;
23
+ const formParams = (body) => {
53
24
  if (!body || typeof body !== "object" || Array.isArray(body)) {
54
25
  return undefined;
55
26
  }
56
- var params = {};
57
- try {
58
- for (var _b = __values(Object.entries(body)), _c = _b.next(); !_c.done; _c = _b.next()) {
59
- var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
60
- if (typeof value !== "string") {
61
- return undefined;
62
- }
63
- params[key] = value;
27
+ const params = {};
28
+ for (const [key, value] of Object.entries(body)) {
29
+ if (typeof value !== "string") {
30
+ return undefined;
64
31
  }
65
- }
66
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
67
- finally {
68
- try {
69
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
70
- }
71
- finally { if (e_1) throw e_1.error; }
32
+ params[key] = value;
72
33
  }
73
34
  return params;
74
35
  };
75
36
  /**
76
37
  * Verifies Twilio `X-Twilio-Signature` (HMAC-SHA1 of callback URL + sorted POST fields).
77
38
  */
78
- var twilioSignature = function (options) {
79
- return function (req) {
80
- var e_2, _a;
39
+ const twilioSignature = (options) => {
40
+ return (req) => {
81
41
  if (!isUrlencoded(req) || !req.rawBody) {
82
42
  return false;
83
43
  }
84
- var provided = (0, headerValue_1.headerValue)(req, "X-Twilio-Signature");
85
- var callbackUrl = resolveUrl(req, options.url);
86
- var params = formParams(req.body);
44
+ const provided = (0, headerValue_1.headerValue)(req, "X-Twilio-Signature");
45
+ const callbackUrl = resolveUrl(req, options.url);
46
+ const params = formParams(req.body);
87
47
  if (!provided || !callbackUrl || !params) {
88
48
  return false;
89
49
  }
90
- var keys = Object.keys(params).sort();
91
- var data = callbackUrl;
92
- try {
93
- for (var keys_1 = __values(keys), keys_1_1 = keys_1.next(); !keys_1_1.done; keys_1_1 = keys_1.next()) {
94
- var key = keys_1_1.value;
95
- data += key + params[key];
96
- }
97
- }
98
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
99
- finally {
100
- try {
101
- if (keys_1_1 && !keys_1_1.done && (_a = keys_1.return)) _a.call(keys_1);
102
- }
103
- finally { if (e_2) throw e_2.error; }
50
+ const keys = Object.keys(params).sort();
51
+ let data = callbackUrl;
52
+ for (const key of keys) {
53
+ data += key + params[key];
104
54
  }
105
- var expected = node_crypto_1.default
55
+ const expected = node_crypto_1.default
106
56
  .createHmac("sha1", options.authToken)
107
57
  .update(data, "utf8")
108
58
  .digest("base64");
109
- return (0, timingSafeEqual_1.timingSafeEqualUtf8)({ expected: expected, provided: provided });
59
+ return (0, timingSafeEqual_1.timingSafeEqualUtf8)({ expected, provided });
110
60
  };
111
61
  };
112
62
  exports.twilioSignature = twilioSignature;