@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,52 +1,16 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
- var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
- function verb(n) { return function (v) { return step([n, v]); }; }
15
- function step(op) {
16
- if (f) throw new TypeError("Generator is already executing.");
17
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
- if (y = 0, t) op = [op[0] & 2, t.value];
20
- switch (op[0]) {
21
- case 0: case 1: t = op; break;
22
- case 4: _.label++; return { value: op[1], done: false };
23
- case 5: _.label++; y = op[1]; op = [0]; continue;
24
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
- default:
26
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
- if (t[2]) _.ops.pop();
31
- _.trys.pop(); continue;
32
- }
33
- op = body.call(thisArg, _);
34
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
- }
37
- };
38
2
  var __importDefault = (this && this.__importDefault) || function (mod) {
39
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
40
4
  };
41
5
  Object.defineProperty(exports, "__esModule", { value: true });
42
6
  exports.addGitHubAuthRoutes = exports.setupGitHubAuth = exports.githubUserPlugin = void 0;
43
- var express_1 = require("express");
44
- var passport_1 = __importDefault(require("passport"));
45
- var passport_github2_1 = require("passport-github2");
46
- var auth_1 = require("./auth");
47
- var errors_1 = require("./errors");
48
- var logger_1 = require("./logger");
49
- var plugins_1 = require("./plugins");
7
+ const express_1 = require("express");
8
+ const passport_1 = __importDefault(require("passport"));
9
+ const passport_github2_1 = require("passport-github2");
10
+ const auth_1 = require("./auth");
11
+ const errors_1 = require("./errors");
12
+ const logger_1 = require("./logger");
13
+ const plugins_1 = require("./plugins");
50
14
  /**
51
15
  * Plugin to add GitHub authentication fields to a user schema.
52
16
  * Apply this plugin to your User schema if you want to enable GitHub auth.
@@ -60,7 +24,7 @@ var plugins_1 = require("./plugins");
60
24
  */
61
25
  // noExplicitAny: Schema generics must be loose to accept arbitrary consumer schemas
62
26
  // biome-ignore lint/suspicious/noExplicitAny: Schema generics must be loose to accept arbitrary consumer schemas
63
- var githubUserPlugin = function (schema) {
27
+ const githubUserPlugin = (schema) => {
64
28
  schema.add({
65
29
  githubAvatarUrl: { description: "GitHub avatar image URL", type: String },
66
30
  githubId: {
@@ -79,104 +43,94 @@ exports.githubUserPlugin = githubUserPlugin;
79
43
  * Sets up GitHub OAuth authentication strategy.
80
44
  * Call this after setupAuth() in your server initialization.
81
45
  */
82
- var setupGitHubAuth = function (_app, userModel, githubOptions) {
83
- var _a;
84
- var scope = (_a = githubOptions.scope) !== null && _a !== void 0 ? _a : ["user:email"];
46
+ const setupGitHubAuth = (_app, userModel, githubOptions) => {
47
+ const scope = githubOptions.scope ?? ["user:email"];
85
48
  passport_1.default.use("github", new passport_github2_1.Strategy({
86
49
  callbackURL: githubOptions.callbackURL,
87
50
  clientID: githubOptions.clientId,
88
51
  clientSecret: githubOptions.clientSecret,
89
52
  passReqToCallback: true,
90
- scope: scope,
91
- }, function (req, accessToken, refreshToken, profile, done) { return __awaiter(void 0, void 0, void 0, function () {
92
- var existingUser, user, githubId, existingGitHubUser, user, userWithGitHub, email, existingEmailUser, emailUserWithGitHub, newUser, error_1;
93
- var _a, _b, _c, _d, _e, _f, _g, _h;
94
- return __generator(this, function (_j) {
95
- switch (_j.label) {
96
- case 0:
97
- _j.trys.push([0, 13, , 14]);
98
- existingUser = req.user;
99
- if (!githubOptions.findOrCreateUser) return [3 /*break*/, 2];
100
- return [4 /*yield*/, githubOptions.findOrCreateUser(profile, accessToken, refreshToken, existingUser)];
101
- case 1:
102
- user = _j.sent();
103
- return [2 /*return*/, done(null, user)];
104
- case 2:
105
- githubId = profile.id;
106
- return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(userModel, { githubId: githubId })];
107
- case 3:
108
- existingGitHubUser = _j.sent();
109
- if (!existingUser) return [3 /*break*/, 7];
110
- if (!githubOptions.allowAccountLinking) {
111
- return [2 /*return*/, done(new errors_1.APIError({ status: 400, title: "Account linking is disabled" }))];
112
- }
113
- if (existingGitHubUser &&
114
- existingGitHubUser._id.toString() !== existingUser._id.toString()) {
115
- return [2 /*return*/, done(new errors_1.APIError({
116
- status: 400,
117
- title: "This GitHub account is already linked to another user",
118
- }))];
119
- }
120
- return [4 /*yield*/, userModel.findById(existingUser._id)];
121
- case 4:
122
- user = _j.sent();
123
- if (!user) return [3 /*break*/, 6];
124
- userWithGitHub = user;
53
+ scope,
54
+ }, async (req, accessToken, refreshToken, profile, done) => {
55
+ try {
56
+ const existingUser = req.user;
57
+ // If custom handler provided, use it
58
+ if (githubOptions.findOrCreateUser) {
59
+ const user = await githubOptions.findOrCreateUser(profile, accessToken, refreshToken, existingUser);
60
+ return done(null, user);
61
+ }
62
+ // Default implementation
63
+ const githubId = profile.id;
64
+ // Check if user with this GitHub ID already exists
65
+ const existingGitHubUser = await (0, plugins_1.findOneOrNoneFor)(userModel, { githubId });
66
+ // Case 1: User is authenticated and wants to link GitHub account
67
+ if (existingUser) {
68
+ if (!githubOptions.allowAccountLinking) {
69
+ return done(new errors_1.APIError({ status: 400, title: "Account linking is disabled" }));
70
+ }
71
+ if (existingGitHubUser &&
72
+ existingGitHubUser._id.toString() !== existingUser._id.toString()) {
73
+ return done(new errors_1.APIError({
74
+ status: 400,
75
+ title: "This GitHub account is already linked to another user",
76
+ }));
77
+ }
78
+ // Link GitHub to existing user
79
+ const user = await userModel.findById(existingUser._id);
80
+ if (user) {
81
+ const userWithGitHub = user;
125
82
  userWithGitHub.githubId = githubId;
126
83
  userWithGitHub.githubUsername = profile.username;
127
84
  userWithGitHub.githubProfileUrl = profile.profileUrl;
128
- userWithGitHub.githubAvatarUrl = (_b = (_a = profile.photos) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.value;
129
- return [4 /*yield*/, user.save()];
130
- case 5:
131
- _j.sent();
132
- return [2 /*return*/, done(null, user)];
133
- case 6: return [2 /*return*/, done(new errors_1.APIError({ status: 404, title: "User not found" }))];
134
- case 7:
135
- // Case 2: User with this GitHub ID exists - log them in
136
- if (existingGitHubUser) {
137
- return [2 /*return*/, done(null, existingGitHubUser)];
85
+ userWithGitHub.githubAvatarUrl = profile.photos?.[0]?.value;
86
+ await user.save();
87
+ return done(null, user);
88
+ }
89
+ return done(new errors_1.APIError({ status: 404, title: "User not found" }));
90
+ }
91
+ // Case 2: User with this GitHub ID exists - log them in
92
+ if (existingGitHubUser) {
93
+ return done(null, existingGitHubUser);
94
+ }
95
+ // Case 3: Create new user with GitHub credentials
96
+ const email = profile.emails?.[0]?.value;
97
+ // Check if user with this email already exists
98
+ if (email) {
99
+ const existingEmailUser = await (0, plugins_1.findOneOrNoneFor)(userModel, { email });
100
+ if (existingEmailUser) {
101
+ // If account linking is allowed, link GitHub to existing email account
102
+ if (githubOptions.allowAccountLinking !== false) {
103
+ const emailUserWithGitHub = existingEmailUser;
104
+ emailUserWithGitHub.githubId = githubId;
105
+ emailUserWithGitHub.githubUsername = profile.username;
106
+ emailUserWithGitHub.githubProfileUrl = profile.profileUrl;
107
+ emailUserWithGitHub.githubAvatarUrl = profile.photos?.[0]?.value;
108
+ await existingEmailUser.save();
109
+ return done(null, existingEmailUser);
138
110
  }
139
- email = (_d = (_c = profile.emails) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.value;
140
- if (!email) return [3 /*break*/, 11];
141
- return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(userModel, { email: email })];
142
- case 8:
143
- existingEmailUser = _j.sent();
144
- if (!existingEmailUser) return [3 /*break*/, 11];
145
- if (!(githubOptions.allowAccountLinking !== false)) return [3 /*break*/, 10];
146
- emailUserWithGitHub = existingEmailUser;
147
- emailUserWithGitHub.githubId = githubId;
148
- emailUserWithGitHub.githubUsername = profile.username;
149
- emailUserWithGitHub.githubProfileUrl = profile.profileUrl;
150
- emailUserWithGitHub.githubAvatarUrl = (_f = (_e = profile.photos) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.value;
151
- return [4 /*yield*/, existingEmailUser.save()];
152
- case 9:
153
- _j.sent();
154
- return [2 /*return*/, done(null, existingEmailUser)];
155
- case 10: return [2 /*return*/, done(new errors_1.APIError({
111
+ return done(new errors_1.APIError({
156
112
  status: 400,
157
113
  title: "An account with this email already exists. Please log in and link your GitHub account.",
158
- }))];
159
- case 11:
160
- newUser = new userModel({
161
- admin: false,
162
- email: email,
163
- githubAvatarUrl: (_h = (_g = profile.photos) === null || _g === void 0 ? void 0 : _g[0]) === null || _h === void 0 ? void 0 : _h.value,
164
- githubId: githubId,
165
- githubProfileUrl: profile.profileUrl,
166
- githubUsername: profile.username,
167
- });
168
- return [4 /*yield*/, newUser.save()];
169
- case 12:
170
- _j.sent();
171
- return [2 /*return*/, done(null, newUser)];
172
- case 13:
173
- error_1 = _j.sent();
174
- logger_1.logger.error("GitHub auth error: ".concat(error_1));
175
- return [2 /*return*/, done(error_1)];
176
- case 14: return [2 /*return*/];
114
+ }));
115
+ }
177
116
  }
178
- });
179
- }); }));
117
+ // Create new user
118
+ const newUser = new userModel({
119
+ admin: false,
120
+ email,
121
+ githubAvatarUrl: profile.photos?.[0]?.value,
122
+ githubId,
123
+ githubProfileUrl: profile.profileUrl,
124
+ githubUsername: profile.username,
125
+ });
126
+ await newUser.save();
127
+ return done(null, newUser);
128
+ }
129
+ catch (error) {
130
+ logger_1.logger.error(`GitHub auth error: ${error}`);
131
+ return done(error);
132
+ }
133
+ }));
180
134
  };
181
135
  exports.setupGitHubAuth = setupGitHubAuth;
182
136
  /**
@@ -188,16 +142,15 @@ exports.setupGitHubAuth = setupGitHubAuth;
188
142
  * - POST /auth/github/link - Links GitHub account to authenticated user (requires JWT auth)
189
143
  * - DELETE /auth/github/unlink - Unlinks GitHub account from authenticated user (requires JWT auth)
190
144
  */
191
- var addGitHubAuthRoutes = function (app, userModel, githubOptions, authOptions) {
192
- var router = (0, express_1.Router)();
145
+ const addGitHubAuthRoutes = (app, userModel, githubOptions, authOptions) => {
146
+ const router = (0, express_1.Router)();
193
147
  // Initiate GitHub OAuth flow
194
- router.get("/github", function (req, _res, next) {
195
- var _a;
148
+ router.get("/github", (req, _res, next) => {
196
149
  // Store the return URL in session or query for redirect after auth
197
- var returnTo = req.query.returnTo;
150
+ const returnTo = req.query.returnTo;
198
151
  if (returnTo) {
199
- var reqWithSession = req;
200
- reqWithSession.session = (_a = reqWithSession.session) !== null && _a !== void 0 ? _a : {};
152
+ const reqWithSession = req;
153
+ reqWithSession.session = reqWithSession.session ?? {};
201
154
  reqWithSession.session.returnTo = returnTo;
202
155
  }
203
156
  next();
@@ -206,52 +159,44 @@ var addGitHubAuthRoutes = function (app, userModel, githubOptions, authOptions)
206
159
  router.get("/github/callback", passport_1.default.authenticate("github", {
207
160
  failureRedirect: "/auth/github/failure",
208
161
  session: false,
209
- }), function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
210
- var tokens, returnTo, url, error_2;
211
- var _a, _b, _c, _d;
212
- return __generator(this, function (_e) {
213
- switch (_e.label) {
214
- case 0:
215
- _e.trys.push([0, 2, , 3]);
216
- return [4 /*yield*/, (0, auth_1.generateTokens)(req.user, authOptions)];
217
- case 1:
218
- tokens = _e.sent();
219
- returnTo = (_a = req.session) === null || _a === void 0 ? void 0 : _a.returnTo;
220
- // If there's a return URL, redirect with tokens as query params
221
- if (returnTo) {
222
- url = new URL(returnTo);
223
- url.searchParams.set("token", (_b = tokens.token) !== null && _b !== void 0 ? _b : "");
224
- if (tokens.refreshToken) {
225
- url.searchParams.set("refreshToken", tokens.refreshToken);
226
- }
227
- url.searchParams.set("userId", ((_c = req.user) === null || _c === void 0 ? void 0 : _c._id) ? String(req.user._id) : "");
228
- return [2 /*return*/, res.redirect(url.toString())];
229
- }
230
- // Otherwise return JSON response
231
- return [2 /*return*/, res.json({
232
- data: {
233
- refreshToken: tokens.refreshToken,
234
- token: tokens.token,
235
- userId: (_d = req.user) === null || _d === void 0 ? void 0 : _d._id,
236
- },
237
- })];
238
- case 2:
239
- error_2 = _e.sent();
240
- logger_1.logger.error("GitHub callback error: ".concat(error_2));
241
- return [2 /*return*/, res.status(500).json({ message: "Authentication failed" })];
242
- case 3: return [2 /*return*/];
162
+ }), async (req, res) => {
163
+ try {
164
+ const tokens = await (0, auth_1.generateTokens)(req.user, authOptions);
165
+ const returnTo = req.session
166
+ ?.returnTo;
167
+ // If there's a return URL, redirect with tokens as query params
168
+ if (returnTo) {
169
+ const url = new URL(returnTo);
170
+ url.searchParams.set("token", tokens.token ?? "");
171
+ if (tokens.refreshToken) {
172
+ url.searchParams.set("refreshToken", tokens.refreshToken);
173
+ }
174
+ url.searchParams.set("userId", req.user?._id ? String(req.user._id) : "");
175
+ return res.redirect(url.toString());
243
176
  }
244
- });
245
- }); });
177
+ // Otherwise return JSON response
178
+ return res.json({
179
+ data: {
180
+ refreshToken: tokens.refreshToken,
181
+ token: tokens.token,
182
+ userId: req.user?._id,
183
+ },
184
+ });
185
+ }
186
+ catch (error) {
187
+ logger_1.logger.error(`GitHub callback error: ${error}`);
188
+ return res.status(500).json({ message: "Authentication failed" });
189
+ }
190
+ });
246
191
  // GitHub auth failure handler
247
- router.get("/github/failure", function (_req, res) {
192
+ router.get("/github/failure", (_req, res) => {
248
193
  return res.status(401).json({ message: "GitHub authentication failed" });
249
194
  });
250
195
  // Link GitHub to existing authenticated user
251
196
  if (githubOptions.allowAccountLinking !== false) {
252
- router.get("/github/link", function (req, res, next) {
197
+ router.get("/github/link", (req, res, next) => {
253
198
  // Require JWT authentication for linking
254
- passport_1.default.authenticate("jwt", { session: false }, function (err, user) {
199
+ passport_1.default.authenticate("jwt", { session: false }, (err, user) => {
255
200
  if (err || !user) {
256
201
  res.status(401).json({ message: "Authentication required to link GitHub account" });
257
202
  return;
@@ -261,47 +206,38 @@ var addGitHubAuthRoutes = function (app, userModel, githubOptions, authOptions)
261
206
  })(req, res, next);
262
207
  }, passport_1.default.authenticate("github", { session: false }));
263
208
  // Unlink GitHub from user account
264
- router.delete("/github/unlink", passport_1.default.authenticate("jwt", { session: false }), function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
265
- var user, userWithAuth, hasPassword, userWithGitHub, error_3;
266
- return __generator(this, function (_a) {
267
- switch (_a.label) {
268
- case 0:
269
- if (!req.user) {
270
- return [2 /*return*/, res.status(401).json({ message: "Authentication required" })];
271
- }
272
- _a.label = 1;
273
- case 1:
274
- _a.trys.push([1, 4, , 5]);
275
- return [4 /*yield*/, userModel.findById(req.user._id).select("+hash +salt")];
276
- case 2:
277
- user = _a.sent();
278
- if (!user) {
279
- return [2 /*return*/, res.status(404).json({ message: "User not found" })];
280
- }
281
- userWithAuth = user;
282
- hasPassword = !!userWithAuth.hash || !!userWithAuth.salt;
283
- if (!hasPassword) {
284
- return [2 /*return*/, res.status(400).json({
285
- message: "Cannot unlink GitHub account without another authentication method. Set a password first.",
286
- })];
287
- }
288
- userWithGitHub = user;
289
- userWithGitHub.githubId = undefined;
290
- userWithGitHub.githubUsername = undefined;
291
- userWithGitHub.githubProfileUrl = undefined;
292
- userWithGitHub.githubAvatarUrl = undefined;
293
- return [4 /*yield*/, user.save()];
294
- case 3:
295
- _a.sent();
296
- return [2 /*return*/, res.json({ data: { message: "GitHub account unlinked successfully" } })];
297
- case 4:
298
- error_3 = _a.sent();
299
- logger_1.logger.error("GitHub unlink error: ".concat(error_3));
300
- return [2 /*return*/, res.status(500).json({ message: "Failed to unlink GitHub account" })];
301
- case 5: return [2 /*return*/];
209
+ router.delete("/github/unlink", passport_1.default.authenticate("jwt", { session: false }), async (req, res) => {
210
+ if (!req.user) {
211
+ return res.status(401).json({ message: "Authentication required" });
212
+ }
213
+ try {
214
+ // Explicitly select hash and salt fields which may be hidden by default
215
+ const user = await userModel.findById(req.user._id).select("+hash +salt");
216
+ if (!user) {
217
+ return res.status(404).json({ message: "User not found" });
302
218
  }
303
- });
304
- }); });
219
+ // Check if user has other authentication methods before unlinking
220
+ // passport-local-mongoose stores password in hash and salt fields
221
+ const userWithAuth = user;
222
+ const hasPassword = !!userWithAuth.hash || !!userWithAuth.salt;
223
+ if (!hasPassword) {
224
+ return res.status(400).json({
225
+ message: "Cannot unlink GitHub account without another authentication method. Set a password first.",
226
+ });
227
+ }
228
+ const userWithGitHub = user;
229
+ userWithGitHub.githubId = undefined;
230
+ userWithGitHub.githubUsername = undefined;
231
+ userWithGitHub.githubProfileUrl = undefined;
232
+ userWithGitHub.githubAvatarUrl = undefined;
233
+ await user.save();
234
+ return res.json({ data: { message: "GitHub account unlinked successfully" } });
235
+ }
236
+ catch (error) {
237
+ logger_1.logger.error(`GitHub unlink error: ${error}`);
238
+ return res.status(500).json({ message: "Failed to unlink GitHub account" });
239
+ }
240
+ });
305
241
  }
306
242
  app.use("/auth", router);
307
243
  };