@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
@@ -6,64 +6,17 @@
6
6
  * Provides admin CRUD for consent forms, read-only access to responses, and user-facing
7
7
  * endpoints for fetching pending consents and submitting responses.
8
8
  */
9
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
10
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
11
- return new (P || (P = Promise))(function (resolve, reject) {
12
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
13
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
14
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
15
- step((generator = generator.apply(thisArg, _arguments || [])).next());
16
- });
17
- };
18
- var __generator = (this && this.__generator) || function (thisArg, body) {
19
- 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);
20
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
21
- function verb(n) { return function (v) { return step([n, v]); }; }
22
- function step(op) {
23
- if (f) throw new TypeError("Generator is already executing.");
24
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
25
- 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;
26
- if (y = 0, t) op = [op[0] & 2, t.value];
27
- switch (op[0]) {
28
- case 0: case 1: t = op; break;
29
- case 4: _.label++; return { value: op[1], done: false };
30
- case 5: _.label++; y = op[1]; op = [0]; continue;
31
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
32
- default:
33
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
34
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
35
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
36
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
37
- if (t[2]) _.ops.pop();
38
- _.trys.pop(); continue;
39
- }
40
- op = body.call(thisArg, _);
41
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
42
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
43
- }
44
- };
45
- var __values = (this && this.__values) || function(o) {
46
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
47
- if (m) return m.call(o);
48
- if (o && typeof o.length === "number") return {
49
- next: function () {
50
- if (o && i >= o.length) o = void 0;
51
- return { value: o && o[i++], done: !o };
52
- }
53
- };
54
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
55
- };
56
9
  Object.defineProperty(exports, "__esModule", { value: true });
57
10
  exports.ConsentApp = exports.consentResponsePopulatePaths = void 0;
58
- var express_1 = require("express");
59
- var luxon_1 = require("luxon");
60
- var api_1 = require("./api");
61
- var auth_1 = require("./auth");
62
- var errors_1 = require("./errors");
63
- var logger_1 = require("./logger");
64
- var consentForm_1 = require("./models/consentForm");
65
- var consentResponse_1 = require("./models/consentResponse");
66
- var permissions_1 = require("./permissions");
11
+ const express_1 = require("express");
12
+ const luxon_1 = require("luxon");
13
+ const api_1 = require("./api");
14
+ const auth_1 = require("./auth");
15
+ const errors_1 = require("./errors");
16
+ const logger_1 = require("./logger");
17
+ const consentForm_1 = require("./models/consentForm");
18
+ const consentResponse_1 = require("./models/consentResponse");
19
+ const permissions_1 = require("./permissions");
67
20
  /** Shared populate config for consent response list/read endpoints. */
68
21
  exports.consentResponsePopulatePaths = [
69
22
  {
@@ -75,17 +28,17 @@ exports.consentResponsePopulatePaths = [
75
28
  path: "userId",
76
29
  },
77
30
  ];
78
- var requireAdmin = function (user) {
79
- if (!(user === null || user === void 0 ? void 0 : user.admin)) {
31
+ const requireAdmin = (user) => {
32
+ if (!user?.admin) {
80
33
  throw new errors_1.APIError({ status: 403, title: "Admin access required" });
81
34
  }
82
35
  };
83
- var ConsentApp = /** @class */ (function () {
84
- function ConsentApp(options) {
85
- if (options === void 0) { options = {}; }
36
+ class ConsentApp {
37
+ options;
38
+ constructor(options = {}) {
86
39
  this.options = options;
87
40
  }
88
- ConsentApp.prototype.adminContribution = function () {
41
+ adminContribution() {
89
42
  return {
90
43
  models: [
91
44
  {
@@ -182,126 +135,95 @@ var ConsentApp = /** @class */ (function () {
182
135
  },
183
136
  ],
184
137
  };
185
- };
186
- ConsentApp.prototype.register = function (app) {
187
- var _this = this;
188
- var _a = this.options, auditTrail = _a.auditTrail, resolveConsentForms = _a.resolveConsentForms, aiConfig = _a.aiConfig;
189
- var collectionActions = {};
138
+ }
139
+ register(app) {
140
+ const { auditTrail, resolveConsentForms, aiConfig } = this.options;
141
+ const collectionActions = {};
190
142
  if (aiConfig) {
191
143
  collectionActions.generate = {
192
- handler: function (_a) { return __awaiter(_this, [_a], void 0, function (_b) {
193
- var typedBody, locale, content;
194
- var _c;
195
- var body = _b.body, user = _b.user;
196
- return __generator(this, function (_d) {
197
- switch (_d.label) {
198
- case 0:
199
- requireAdmin(user);
200
- typedBody = body;
201
- if (!typedBody.type) {
202
- throw new errors_1.APIError({ status: 400, title: "type is required" });
203
- }
204
- if (!typedBody.description) {
205
- throw new errors_1.APIError({ status: 400, title: "description is required" });
206
- }
207
- locale = (_c = typedBody.locale) !== null && _c !== void 0 ? _c : "en";
208
- return [4 /*yield*/, aiConfig.generateContent({
209
- description: typedBody.description,
210
- locale: locale,
211
- type: typedBody.type,
212
- })];
213
- case 1:
214
- content = _d.sent();
215
- logger_1.logger.info("ConsentForm content generated", { locale: locale, type: typedBody.type });
216
- return [2 /*return*/, { content: content }];
217
- }
144
+ handler: async ({ body, user }) => {
145
+ requireAdmin(user);
146
+ const typedBody = body;
147
+ if (!typedBody.type) {
148
+ throw new errors_1.APIError({ status: 400, title: "type is required" });
149
+ }
150
+ if (!typedBody.description) {
151
+ throw new errors_1.APIError({ status: 400, title: "description is required" });
152
+ }
153
+ const locale = typedBody.locale ?? "en";
154
+ const content = await aiConfig.generateContent({
155
+ description: typedBody.description,
156
+ locale,
157
+ type: typedBody.type,
218
158
  });
219
- }); },
159
+ logger_1.logger.info("ConsentForm content generated", { locale, type: typedBody.type });
160
+ return { content };
161
+ },
220
162
  method: "POST",
221
163
  permissions: [permissions_1.Permissions.IsAuthenticated],
222
164
  summary: "Generate consent form content with AI",
223
165
  };
224
166
  collectionActions.translate = {
225
- handler: function (_a) { return __awaiter(_this, [_a], void 0, function (_b) {
226
- var typedBody, translated;
227
- var body = _b.body, user = _b.user;
228
- return __generator(this, function (_c) {
229
- switch (_c.label) {
230
- case 0:
231
- requireAdmin(user);
232
- typedBody = body;
233
- if (!typedBody.content) {
234
- throw new errors_1.APIError({ status: 400, title: "content is required" });
235
- }
236
- if (!typedBody.fromLocale) {
237
- throw new errors_1.APIError({ status: 400, title: "fromLocale is required" });
238
- }
239
- if (!typedBody.toLocale) {
240
- throw new errors_1.APIError({ status: 400, title: "toLocale is required" });
241
- }
242
- return [4 /*yield*/, aiConfig.translateContent({
243
- content: typedBody.content,
244
- fromLocale: typedBody.fromLocale,
245
- toLocale: typedBody.toLocale,
246
- })];
247
- case 1:
248
- translated = _c.sent();
249
- logger_1.logger.info("ConsentForm content translated", {
250
- fromLocale: typedBody.fromLocale,
251
- toLocale: typedBody.toLocale,
252
- });
253
- return [2 /*return*/, { content: translated }];
254
- }
167
+ handler: async ({ body, user }) => {
168
+ requireAdmin(user);
169
+ const typedBody = body;
170
+ if (!typedBody.content) {
171
+ throw new errors_1.APIError({ status: 400, title: "content is required" });
172
+ }
173
+ if (!typedBody.fromLocale) {
174
+ throw new errors_1.APIError({ status: 400, title: "fromLocale is required" });
175
+ }
176
+ if (!typedBody.toLocale) {
177
+ throw new errors_1.APIError({ status: 400, title: "toLocale is required" });
178
+ }
179
+ const translated = await aiConfig.translateContent({
180
+ content: typedBody.content,
181
+ fromLocale: typedBody.fromLocale,
182
+ toLocale: typedBody.toLocale,
255
183
  });
256
- }); },
184
+ logger_1.logger.info("ConsentForm content translated", {
185
+ fromLocale: typedBody.fromLocale,
186
+ toLocale: typedBody.toLocale,
187
+ });
188
+ return { content: translated };
189
+ },
257
190
  method: "POST",
258
191
  permissions: [permissions_1.Permissions.IsAuthenticated],
259
192
  summary: "Translate consent form content with AI",
260
193
  };
261
194
  }
262
195
  app.use("/consent-forms", (0, api_1.modelRouter)(consentForm_1.ConsentForm, {
263
- collectionActions: collectionActions,
196
+ collectionActions,
264
197
  instanceActions: {
265
198
  publish: {
266
- handler: function (_a) { return __awaiter(_this, [_a], void 0, function (_b) {
267
- var form, newFormData, newForm;
268
- var doc = _b.doc, user = _b.user;
269
- return __generator(this, function (_c) {
270
- switch (_c.label) {
271
- case 0:
272
- requireAdmin(user);
273
- form = doc;
274
- newFormData = {
275
- active: true,
276
- agreeButtonText: form.agreeButtonText,
277
- allowDecline: form.allowDecline,
278
- captureSignature: form.captureSignature,
279
- checkboxes: form.checkboxes,
280
- content: form.content,
281
- declineButtonText: form.declineButtonText,
282
- defaultLocale: form.defaultLocale,
283
- order: form.order,
284
- required: form.required,
285
- requireScrollToBottom: form.requireScrollToBottom,
286
- slug: form.slug,
287
- title: form.title,
288
- type: form.type,
289
- version: form.version + 1,
290
- };
291
- return [4 /*yield*/, consentForm_1.ConsentForm.create(newFormData)];
292
- case 1:
293
- newForm = _c.sent();
294
- return [4 /*yield*/, consentForm_1.ConsentForm.updateMany({ _id: { $ne: newForm._id }, slug: form.slug }, { active: false })];
295
- case 2:
296
- _c.sent();
297
- logger_1.logger.info("ConsentForm published", {
298
- newVersion: newForm.version,
299
- slug: newForm.slug,
300
- });
301
- return [2 /*return*/, newForm];
302
- }
199
+ handler: async ({ doc, user }) => {
200
+ requireAdmin(user);
201
+ const form = doc;
202
+ const newFormData = {
203
+ active: true,
204
+ agreeButtonText: form.agreeButtonText,
205
+ allowDecline: form.allowDecline,
206
+ captureSignature: form.captureSignature,
207
+ checkboxes: form.checkboxes,
208
+ content: form.content,
209
+ declineButtonText: form.declineButtonText,
210
+ defaultLocale: form.defaultLocale,
211
+ order: form.order,
212
+ required: form.required,
213
+ requireScrollToBottom: form.requireScrollToBottom,
214
+ slug: form.slug,
215
+ title: form.title,
216
+ type: form.type,
217
+ version: form.version + 1,
218
+ };
219
+ const newForm = await consentForm_1.ConsentForm.create(newFormData);
220
+ await consentForm_1.ConsentForm.updateMany({ _id: { $ne: newForm._id }, slug: form.slug }, { active: false });
221
+ logger_1.logger.info("ConsentForm published", {
222
+ newVersion: newForm.version,
223
+ slug: newForm.slug,
303
224
  });
304
- }); },
225
+ return newForm;
226
+ },
305
227
  method: "POST",
306
228
  permissions: [permissions_1.Permissions.IsAuthenticated],
307
229
  summary: "Publish a new version of a consent form",
@@ -329,277 +251,210 @@ var ConsentApp = /** @class */ (function () {
329
251
  populatePaths: exports.consentResponsePopulatePaths,
330
252
  }));
331
253
  // User-facing consent endpoints
332
- var router = (0, express_1.Router)();
254
+ const router = (0, express_1.Router)();
333
255
  // GET /consents/pending - fetch pending consent forms for the current user
334
- router.get("/pending", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(_this, void 0, void 0, function () {
335
- var user, activeForms, resolvedForms, existingResponses, respondedFormVersions, existingResponses_1, existingResponses_1_1, response, formId, respondedFormIds, respondedForms, formVersionByFormId, respondedForms_1, respondedForms_1_1, form, pendingForms, filteredOutByResolverCount, filteredOutByResponsesCount;
336
- var e_1, _a, e_2, _b;
337
- var _c;
338
- return __generator(this, function (_d) {
339
- switch (_d.label) {
340
- case 0:
341
- user = req.user;
342
- if (!user) {
343
- throw new errors_1.APIError({ status: 401, title: "Authentication required" });
344
- }
345
- logger_1.logger.debug("Fetching pending consent forms", { userId: user.id });
346
- return [4 /*yield*/, consentForm_1.ConsentForm.find({ active: true }).sort({ order: 1 })];
347
- case 1:
348
- activeForms = _d.sent();
349
- if (!resolveConsentForms) return [3 /*break*/, 3];
350
- return [4 /*yield*/, resolveConsentForms(user, activeForms)];
351
- case 2:
352
- resolvedForms = _d.sent();
353
- logger_1.logger.debug("resolveConsentForms applied", {
354
- activeFormCount: activeForms.length,
355
- resolvedFormCount: resolvedForms.length,
356
- userAdmin: Boolean(user.admin),
357
- userId: user.id,
358
- });
359
- return [3 /*break*/, 4];
360
- case 3:
361
- resolvedForms = activeForms;
362
- _d.label = 4;
363
- case 4: return [4 /*yield*/, consentResponse_1.ConsentResponse.find({ userId: user.id })];
364
- case 5:
365
- existingResponses = _d.sent();
366
- respondedFormVersions = new Map();
367
- try {
368
- for (existingResponses_1 = __values(existingResponses), existingResponses_1_1 = existingResponses_1.next(); !existingResponses_1_1.done; existingResponses_1_1 = existingResponses_1.next()) {
369
- response = existingResponses_1_1.value;
370
- formId = response.consentFormId.toString();
371
- respondedFormVersions.set(formId, (_c = response.formVersionSnapshot) !== null && _c !== void 0 ? _c : 0);
372
- }
373
- }
374
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
375
- finally {
376
- try {
377
- if (existingResponses_1_1 && !existingResponses_1_1.done && (_a = existingResponses_1.return)) _a.call(existingResponses_1);
378
- }
379
- finally { if (e_1) throw e_1.error; }
380
- }
381
- respondedFormIds = existingResponses.map(function (r) { return r.consentFormId; });
382
- return [4 /*yield*/, consentForm_1.ConsentForm.find({ _id: { $in: respondedFormIds } })];
383
- case 6:
384
- respondedForms = _d.sent();
385
- formVersionByFormId = new Map();
386
- try {
387
- for (respondedForms_1 = __values(respondedForms), respondedForms_1_1 = respondedForms_1.next(); !respondedForms_1_1.done; respondedForms_1_1 = respondedForms_1.next()) {
388
- form = respondedForms_1_1.value;
389
- formVersionByFormId.set(form._id.toString(), form.version);
390
- }
391
- }
392
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
393
- finally {
394
- try {
395
- if (respondedForms_1_1 && !respondedForms_1_1.done && (_b = respondedForms_1.return)) _b.call(respondedForms_1);
396
- }
397
- finally { if (e_2) throw e_2.error; }
398
- }
399
- pendingForms = resolvedForms.filter(function (form) {
400
- var formId = form._id.toString();
401
- var matchingResponses = existingResponses.filter(function (r) { return r.consentFormId.toString() === formId; });
402
- if (matchingResponses.length === 0) {
403
- return true;
404
- }
405
- return !matchingResponses.some(function (r) { return r.formVersionSnapshot === form.version; });
406
- });
407
- filteredOutByResolverCount = Math.max(activeForms.length - resolvedForms.length, 0);
408
- filteredOutByResponsesCount = Math.max(resolvedForms.length - pendingForms.length, 0);
409
- logger_1.logger.info("Pending consent forms fetched", {
410
- activeFormCount: activeForms.length,
411
- filteredOutByResolverCount: filteredOutByResolverCount,
412
- filteredOutByResponsesCount: filteredOutByResponsesCount,
413
- pendingFormCount: pendingForms.length,
414
- resolvedFormCount: resolvedForms.length,
415
- responseCount: existingResponses.length,
416
- userAdmin: Boolean(user.admin),
417
- userId: user.id,
418
- });
419
- return [2 /*return*/, res.json({ data: pendingForms })];
256
+ router.get("/pending", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(async (req, res) => {
257
+ const user = req.user;
258
+ if (!user) {
259
+ throw new errors_1.APIError({ status: 401, title: "Authentication required" });
260
+ }
261
+ logger_1.logger.debug("Fetching pending consent forms", { userId: user.id });
262
+ const activeForms = await consentForm_1.ConsentForm.find({ active: true }).sort({ order: 1 });
263
+ let resolvedForms;
264
+ if (resolveConsentForms) {
265
+ resolvedForms = await resolveConsentForms(user, activeForms);
266
+ logger_1.logger.debug("resolveConsentForms applied", {
267
+ activeFormCount: activeForms.length,
268
+ resolvedFormCount: resolvedForms.length,
269
+ userAdmin: Boolean(user.admin),
270
+ userId: user.id,
271
+ });
272
+ }
273
+ else {
274
+ resolvedForms = activeForms;
275
+ }
276
+ const existingResponses = await consentResponse_1.ConsentResponse.find({ userId: user.id });
277
+ const respondedFormVersions = new Map();
278
+ for (const response of existingResponses) {
279
+ const formId = response.consentFormId.toString();
280
+ respondedFormVersions.set(formId, response.formVersionSnapshot ?? 0);
281
+ }
282
+ const respondedFormIds = existingResponses.map((r) => r.consentFormId);
283
+ const respondedForms = await consentForm_1.ConsentForm.find({ _id: { $in: respondedFormIds } });
284
+ const formVersionByFormId = new Map();
285
+ for (const form of respondedForms) {
286
+ formVersionByFormId.set(form._id.toString(), form.version);
287
+ }
288
+ const pendingForms = resolvedForms.filter((form) => {
289
+ const formId = form._id.toString();
290
+ const matchingResponses = existingResponses.filter((r) => r.consentFormId.toString() === formId);
291
+ if (matchingResponses.length === 0) {
292
+ return true;
420
293
  }
294
+ return !matchingResponses.some((r) => r.formVersionSnapshot === form.version);
421
295
  });
422
- }); }));
296
+ const filteredOutByResolverCount = Math.max(activeForms.length - resolvedForms.length, 0);
297
+ const filteredOutByResponsesCount = Math.max(resolvedForms.length - pendingForms.length, 0);
298
+ logger_1.logger.info("Pending consent forms fetched", {
299
+ activeFormCount: activeForms.length,
300
+ filteredOutByResolverCount,
301
+ filteredOutByResponsesCount,
302
+ pendingFormCount: pendingForms.length,
303
+ resolvedFormCount: resolvedForms.length,
304
+ responseCount: existingResponses.length,
305
+ userAdmin: Boolean(user.admin),
306
+ userId: user.id,
307
+ });
308
+ return res.json({ data: pendingForms });
309
+ }));
423
310
  // POST /consents/respond - submit a consent response
424
- router.post("/respond", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(_this, void 0, void 0, function () {
425
- var user, _a, agreed, checkboxValues, consentFormId, locale, signature, form, values, i, checkbox, responseData, response;
426
- var _b;
427
- return __generator(this, function (_c) {
428
- switch (_c.label) {
429
- case 0:
430
- user = req.user;
431
- if (!user) {
432
- throw new errors_1.APIError({ status: 401, title: "Authentication required" });
433
- }
434
- _a = req.body, agreed = _a.agreed, checkboxValues = _a.checkboxValues, consentFormId = _a.consentFormId, locale = _a.locale, signature = _a.signature;
435
- if (!consentFormId) {
436
- throw new errors_1.APIError({ status: 400, title: "consentFormId is required" });
437
- }
438
- if (agreed === undefined || agreed === null) {
439
- throw new errors_1.APIError({ status: 400, title: "agreed field is required" });
440
- }
441
- if (!locale) {
442
- throw new errors_1.APIError({ status: 400, title: "locale is required" });
443
- }
444
- return [4 /*yield*/, consentForm_1.ConsentForm.findExactlyOne({ _id: consentFormId }, { status: 404, title: "Consent form not found" })];
445
- case 1:
446
- form = _c.sent();
447
- if (!form.active) {
448
- throw new errors_1.APIError({ status: 400, title: "Consent form is not active" });
449
- }
450
- if (form.captureSignature && agreed && !signature) {
451
- throw new errors_1.APIError({
452
- status: 400,
453
- title: "Signature is required for this consent form",
454
- });
455
- }
456
- if (agreed && form.checkboxes.length > 0) {
457
- values = checkboxValues !== null && checkboxValues !== void 0 ? checkboxValues : {};
458
- for (i = 0; i < form.checkboxes.length; i++) {
459
- checkbox = form.checkboxes[i];
460
- if (checkbox.required && !values[i.toString()]) {
461
- throw new errors_1.APIError({
462
- status: 400,
463
- title: "Required checkbox \"".concat(checkbox.label, "\" must be checked"),
464
- });
465
- }
466
- }
467
- }
468
- responseData = {
469
- agreed: agreed,
470
- agreedAt: luxon_1.DateTime.now().toJSDate(),
471
- consentFormId: form._id,
472
- locale: locale,
473
- userId: user.id,
474
- };
475
- if (checkboxValues !== undefined) {
476
- responseData.checkboxValues = checkboxValues;
477
- }
478
- if (signature) {
479
- responseData.signature = signature;
480
- responseData.signedAt = luxon_1.DateTime.now().toJSDate();
481
- }
482
- if (auditTrail) {
483
- responseData.ipAddress = req.ip;
484
- responseData.userAgent = req.headers["user-agent"];
485
- responseData.contentSnapshot =
486
- (_b = form.content.get(locale)) !== null && _b !== void 0 ? _b : form.content.get(form.defaultLocale);
487
- responseData.formVersionSnapshot = form.version;
488
- }
489
- else {
490
- responseData.formVersionSnapshot = form.version;
491
- }
492
- return [4 /*yield*/, consentResponse_1.ConsentResponse.create(responseData)];
493
- case 2:
494
- response = _c.sent();
495
- logger_1.logger.info("Consent response recorded", {
496
- agreed: agreed,
497
- consentFormId: form._id.toString(),
498
- locale: locale,
499
- userId: user.id,
311
+ router.post("/respond", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(async (req, res) => {
312
+ const user = req.user;
313
+ if (!user) {
314
+ throw new errors_1.APIError({ status: 401, title: "Authentication required" });
315
+ }
316
+ const { agreed, checkboxValues, consentFormId, locale, signature } = req.body;
317
+ if (!consentFormId) {
318
+ throw new errors_1.APIError({ status: 400, title: "consentFormId is required" });
319
+ }
320
+ if (agreed === undefined || agreed === null) {
321
+ throw new errors_1.APIError({ status: 400, title: "agreed field is required" });
322
+ }
323
+ if (!locale) {
324
+ throw new errors_1.APIError({ status: 400, title: "locale is required" });
325
+ }
326
+ const form = await consentForm_1.ConsentForm.findExactlyOne({ _id: consentFormId }, { status: 404, title: "Consent form not found" });
327
+ if (!form.active) {
328
+ throw new errors_1.APIError({ status: 400, title: "Consent form is not active" });
329
+ }
330
+ if (form.captureSignature && agreed && !signature) {
331
+ throw new errors_1.APIError({
332
+ status: 400,
333
+ title: "Signature is required for this consent form",
334
+ });
335
+ }
336
+ if (agreed && form.checkboxes.length > 0) {
337
+ const values = checkboxValues ?? {};
338
+ for (let i = 0; i < form.checkboxes.length; i++) {
339
+ const checkbox = form.checkboxes[i];
340
+ if (checkbox.required && !values[i.toString()]) {
341
+ throw new errors_1.APIError({
342
+ status: 400,
343
+ title: `Required checkbox "${checkbox.label}" must be checked`,
500
344
  });
501
- return [2 /*return*/, res.json({ data: response })];
345
+ }
502
346
  }
347
+ }
348
+ const responseData = {
349
+ agreed,
350
+ agreedAt: luxon_1.DateTime.now().toJSDate(),
351
+ consentFormId: form._id,
352
+ locale,
353
+ userId: user.id,
354
+ };
355
+ if (checkboxValues !== undefined) {
356
+ responseData.checkboxValues = checkboxValues;
357
+ }
358
+ if (signature) {
359
+ responseData.signature = signature;
360
+ responseData.signedAt = luxon_1.DateTime.now().toJSDate();
361
+ }
362
+ if (auditTrail) {
363
+ responseData.ipAddress = req.ip;
364
+ responseData.userAgent = req.headers["user-agent"];
365
+ responseData.contentSnapshot =
366
+ form.content.get(locale) ?? form.content.get(form.defaultLocale);
367
+ responseData.formVersionSnapshot = form.version;
368
+ }
369
+ else {
370
+ responseData.formVersionSnapshot = form.version;
371
+ }
372
+ const response = await consentResponse_1.ConsentResponse.create(responseData);
373
+ logger_1.logger.info("Consent response recorded", {
374
+ agreed,
375
+ consentFormId: form._id.toString(),
376
+ locale,
377
+ userId: user.id,
503
378
  });
504
- }); }));
379
+ return res.json({ data: response });
380
+ }));
505
381
  // GET /consents/my - fetch the current user's consent responses with form data
506
- router.get("/my", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(_this, void 0, void 0, function () {
507
- var user, responses, formIds, forms, formMap, data;
508
- return __generator(this, function (_a) {
509
- switch (_a.label) {
510
- case 0:
511
- user = req.user;
512
- if (!user) {
513
- throw new errors_1.APIError({ status: 401, title: "Authentication required" });
382
+ router.get("/my", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(async (req, res) => {
383
+ const user = req.user;
384
+ if (!user) {
385
+ throw new errors_1.APIError({ status: 401, title: "Authentication required" });
386
+ }
387
+ const responses = await consentResponse_1.ConsentResponse.find({ userId: user.id }).sort({ agreedAt: -1 });
388
+ const formIds = responses.map((r) => r.consentFormId);
389
+ const forms = await consentForm_1.ConsentForm.find({ _id: { $in: formIds } });
390
+ const formMap = new Map(forms.map((f) => [f._id.toString(), f]));
391
+ const data = responses.map((response) => {
392
+ const form = formMap.get(response.consentFormId.toString());
393
+ return {
394
+ _id: response._id,
395
+ agreed: response.agreed,
396
+ agreedAt: response.agreedAt,
397
+ checkboxValues: response.checkboxValues,
398
+ contentSnapshot: response.contentSnapshot,
399
+ form: form
400
+ ? {
401
+ captureSignature: form.captureSignature,
402
+ checkboxes: form.checkboxes,
403
+ slug: form.slug,
404
+ title: form.title,
405
+ type: form.type,
406
+ version: form.version,
514
407
  }
515
- return [4 /*yield*/, consentResponse_1.ConsentResponse.find({ userId: user.id }).sort({ agreedAt: -1 })];
516
- case 1:
517
- responses = _a.sent();
518
- formIds = responses.map(function (r) { return r.consentFormId; });
519
- return [4 /*yield*/, consentForm_1.ConsentForm.find({ _id: { $in: formIds } })];
520
- case 2:
521
- forms = _a.sent();
522
- formMap = new Map(forms.map(function (f) { return [f._id.toString(), f]; }));
523
- data = responses.map(function (response) {
524
- var form = formMap.get(response.consentFormId.toString());
525
- return {
526
- _id: response._id,
527
- agreed: response.agreed,
528
- agreedAt: response.agreedAt,
529
- checkboxValues: response.checkboxValues,
530
- contentSnapshot: response.contentSnapshot,
531
- form: form
532
- ? {
533
- captureSignature: form.captureSignature,
534
- checkboxes: form.checkboxes,
535
- slug: form.slug,
536
- title: form.title,
537
- type: form.type,
538
- version: form.version,
539
- }
540
- : null,
541
- formVersionSnapshot: response.formVersionSnapshot,
542
- ipAddress: response.ipAddress,
543
- locale: response.locale,
544
- signature: response.signature,
545
- signedAt: response.signedAt,
546
- userAgent: response.userAgent,
547
- };
548
- });
549
- return [2 /*return*/, res.json({ data: data })];
550
- }
408
+ : null,
409
+ formVersionSnapshot: response.formVersionSnapshot,
410
+ ipAddress: response.ipAddress,
411
+ locale: response.locale,
412
+ signature: response.signature,
413
+ signedAt: response.signedAt,
414
+ userAgent: response.userAgent,
415
+ };
551
416
  });
552
- }); }));
417
+ return res.json({ data });
418
+ }));
553
419
  if (auditTrail) {
554
- router.get("/audit/:userId", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(_this, void 0, void 0, function () {
555
- var user, responses, formIds, forms, formMap, auditEntries;
556
- return __generator(this, function (_a) {
557
- switch (_a.label) {
558
- case 0:
559
- user = req.user;
560
- if (!(user === null || user === void 0 ? void 0 : user.admin)) {
561
- throw new errors_1.APIError({ status: 403, title: "Admin access required" });
420
+ router.get("/audit/:userId", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(async (req, res) => {
421
+ const user = req.user;
422
+ if (!user?.admin) {
423
+ throw new errors_1.APIError({ status: 403, title: "Admin access required" });
424
+ }
425
+ const responses = await consentResponse_1.ConsentResponse.find({ userId: req.params.userId }).sort({
426
+ agreedAt: -1,
427
+ });
428
+ const formIds = responses.map((r) => r.consentFormId);
429
+ const forms = await consentForm_1.ConsentForm.find({ _id: { $in: formIds } });
430
+ const formMap = new Map(forms.map((f) => [f._id.toString(), f]));
431
+ const auditEntries = responses.map((response) => {
432
+ const form = formMap.get(response.consentFormId.toString());
433
+ return {
434
+ agreed: response.agreed,
435
+ agreedAt: response.agreedAt,
436
+ contentSnapshot: response.contentSnapshot,
437
+ form: form
438
+ ? {
439
+ slug: form.slug,
440
+ title: form.title,
441
+ type: form.type,
442
+ version: form.version,
562
443
  }
563
- return [4 /*yield*/, consentResponse_1.ConsentResponse.find({ userId: req.params.userId }).sort({
564
- agreedAt: -1,
565
- })];
566
- case 1:
567
- responses = _a.sent();
568
- formIds = responses.map(function (r) { return r.consentFormId; });
569
- return [4 /*yield*/, consentForm_1.ConsentForm.find({ _id: { $in: formIds } })];
570
- case 2:
571
- forms = _a.sent();
572
- formMap = new Map(forms.map(function (f) { return [f._id.toString(), f]; }));
573
- auditEntries = responses.map(function (response) {
574
- var form = formMap.get(response.consentFormId.toString());
575
- return {
576
- agreed: response.agreed,
577
- agreedAt: response.agreedAt,
578
- contentSnapshot: response.contentSnapshot,
579
- form: form
580
- ? {
581
- slug: form.slug,
582
- title: form.title,
583
- type: form.type,
584
- version: form.version,
585
- }
586
- : null,
587
- formVersionSnapshot: response.formVersionSnapshot,
588
- ipAddress: response.ipAddress,
589
- locale: response.locale,
590
- responseId: response._id,
591
- signedAt: response.signedAt,
592
- userAgent: response.userAgent,
593
- };
594
- });
595
- return [2 /*return*/, res.json({ data: auditEntries })];
596
- }
444
+ : null,
445
+ formVersionSnapshot: response.formVersionSnapshot,
446
+ ipAddress: response.ipAddress,
447
+ locale: response.locale,
448
+ responseId: response._id,
449
+ signedAt: response.signedAt,
450
+ userAgent: response.userAgent,
451
+ };
597
452
  });
598
- }); }));
453
+ return res.json({ data: auditEntries });
454
+ }));
599
455
  }
600
456
  app.use("/consents", router);
601
457
  logger_1.logger.info("ConsentApp registered", { auditTrail: Boolean(auditTrail) });
602
- };
603
- return ConsentApp;
604
- }());
458
+ }
459
+ }
605
460
  exports.ConsentApp = ConsentApp;