@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,81 +1,9 @@
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
- var __values = (this && this.__values) || function(o) {
39
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
- if (m) return m.call(o);
41
- if (o && typeof o.length === "number") return {
42
- next: function () {
43
- if (o && i >= o.length) o = void 0;
44
- return { value: o && o[i++], done: !o };
45
- }
46
- };
47
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
- };
49
- var __read = (this && this.__read) || function (o, n) {
50
- var m = typeof Symbol === "function" && o[Symbol.iterator];
51
- if (!m) return o;
52
- var i = m.call(o), r, ar = [], e;
53
- try {
54
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
55
- }
56
- catch (error) { e = { error: error }; }
57
- finally {
58
- try {
59
- if (r && !r.done && (m = i["return"])) m.call(i);
60
- }
61
- finally { if (e) throw e.error; }
62
- }
63
- return ar;
64
- };
65
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
66
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
67
- if (ar || !(i in from)) {
68
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
69
- ar[i] = from[i];
70
- }
71
- }
72
- return to.concat(ar || Array.prototype.slice.call(from));
73
- };
74
2
  Object.defineProperty(exports, "__esModule", { value: true });
75
3
  exports.configurationPlugin = exports.flattenToDotPaths = void 0;
76
- var errors_1 = require("./errors");
77
- var logger_1 = require("./logger");
78
- var plugins_1 = require("./plugins");
4
+ const errors_1 = require("./errors");
5
+ const logger_1 = require("./logger");
6
+ const plugins_1 = require("./plugins");
79
7
  // ---------------------------------------------------------------------------
80
8
  // Helpers
81
9
  // ---------------------------------------------------------------------------
@@ -86,32 +14,20 @@ var plugins_1 = require("./plugins");
86
14
  * @example
87
15
  * flattenToDotPaths({a: {b: 1}}) // => [["a.b", 1]]
88
16
  */
89
- var flattenToDotPaths = function (obj, prefix) {
90
- var e_1, _a;
91
- if (prefix === void 0) { prefix = ""; }
92
- var out = [];
93
- try {
94
- for (var _b = __values(Object.entries(obj)), _c = _b.next(); !_c.done; _c = _b.next()) {
95
- var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
96
- var path = prefix ? "".concat(prefix, ".").concat(key) : key;
97
- var isPlainObject = value !== null &&
98
- typeof value === "object" &&
99
- !Array.isArray(value) &&
100
- Object.getPrototypeOf(value) === Object.prototype;
101
- if (isPlainObject) {
102
- out.push.apply(out, __spreadArray([], __read((0, exports.flattenToDotPaths)(value, path)), false));
103
- }
104
- else {
105
- out.push([path, value]);
106
- }
17
+ const flattenToDotPaths = (obj, prefix = "") => {
18
+ const out = [];
19
+ for (const [key, value] of Object.entries(obj)) {
20
+ const path = prefix ? `${prefix}.${key}` : key;
21
+ const isPlainObject = value !== null &&
22
+ typeof value === "object" &&
23
+ !Array.isArray(value) &&
24
+ Object.getPrototypeOf(value) === Object.prototype;
25
+ if (isPlainObject) {
26
+ out.push(...(0, exports.flattenToDotPaths)(value, path));
107
27
  }
108
- }
109
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
110
- finally {
111
- try {
112
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
28
+ else {
29
+ out.push([path, value]);
113
30
  }
114
- finally { if (e_1) throw e_1.error; }
115
31
  }
116
32
  return out;
117
33
  };
@@ -121,7 +37,7 @@ exports.flattenToDotPaths = flattenToDotPaths;
121
37
  * soft-delete aware (has a `deleted` path, e.g. via `isDeletedPlugin`), the
122
38
  * singleton is "the one non-deleted document"; otherwise any document matches.
123
39
  */
124
- var buildSingletonFilter = function (schema) {
40
+ const buildSingletonFilter = (schema) => {
125
41
  return schema.path("deleted") ? { deleted: false } : {};
126
42
  };
127
43
  // ---------------------------------------------------------------------------
@@ -161,8 +77,8 @@ var buildSingletonFilter = function (schema) {
161
77
  * configSchema.plugin(configurationPlugin, {secretProvider: new EnvSecretProvider()});
162
78
  * ```
163
79
  */
164
- var configurationPlugin = function (schema, options) {
165
- var pluginOptions = options !== null && options !== void 0 ? options : {};
80
+ const configurationPlugin = (schema, options) => {
81
+ const pluginOptions = options ?? {};
166
82
  // Apply findOneOrNone so the singleton lookup avoids bare Model.findOne (idempotent).
167
83
  (0, plugins_1.findOneOrNone)(schema);
168
84
  // Optionally add a sentinel field with a unique index to enforce the singleton
@@ -184,172 +100,114 @@ var configurationPlugin = function (schema, options) {
184
100
  // Enforce singleton: only one non-deleted document allowed (application-level
185
101
  // guard). Soft-delete-aware: a soft-deleted document does not block creating a
186
102
  // new singleton.
187
- schema.pre("save", function () {
188
- return __awaiter(this, void 0, void 0, function () {
189
- var filter, existing;
190
- return __generator(this, function (_a) {
191
- switch (_a.label) {
192
- case 0:
193
- if (!this.isNew) return [3 /*break*/, 2];
194
- filter = buildSingletonFilter(schema);
195
- return [4 /*yield*/, this.constructor.exists(filter)];
196
- case 1:
197
- existing = _a.sent();
198
- if (existing) {
199
- throw new errors_1.APIError({
200
- status: 409,
201
- title: "Only one configuration document is allowed. Use updateConfig() instead.",
202
- });
203
- }
204
- _a.label = 2;
205
- case 2: return [2 /*return*/];
206
- }
207
- });
208
- });
103
+ schema.pre("save", async function () {
104
+ if (this.isNew) {
105
+ const filter = buildSingletonFilter(schema);
106
+ // Cheap existence check — no document needs to be returned.
107
+ const existing = await this.constructor.exists(filter);
108
+ if (existing) {
109
+ throw new errors_1.APIError({
110
+ status: 409,
111
+ title: "Only one configuration document is allowed. Use updateConfig() instead.",
112
+ });
113
+ }
114
+ }
209
115
  });
210
116
  // Prevent hard deletion of the singleton (soft deletes via isDeletedPlugin still work)
211
- var createHardDeleteError = function () {
212
- return new errors_1.APIError({
213
- status: 400,
214
- title: "Cannot hard-delete the configuration document. Use updateConfig() or soft delete instead.",
215
- });
216
- };
217
- schema.pre("deleteOne", { document: true, query: true }, function () {
117
+ const createHardDeleteError = () => new errors_1.APIError({
118
+ status: 400,
119
+ title: "Cannot hard-delete the configuration document. Use updateConfig() or soft delete instead.",
120
+ });
121
+ schema.pre("deleteOne", { document: true, query: true }, () => {
218
122
  throw createHardDeleteError();
219
123
  });
220
- schema.pre("deleteMany", function () {
124
+ schema.pre("deleteMany", () => {
221
125
  throw createHardDeleteError();
222
126
  });
223
- schema.pre("findOneAndDelete", function () {
127
+ schema.pre("findOneAndDelete", () => {
224
128
  throw createHardDeleteError();
225
129
  });
226
130
  // Static: get the singleton configuration document or a value at a path (race-safe via upsert)
227
- schema.statics.getConfig = function (key) {
228
- return __awaiter(this, void 0, void 0, function () {
229
- var singletonFilter, findSingleton, config, created, err_1, parts, value, parts_1, parts_1_1, part;
230
- var e_2, _a;
231
- var _this = this;
232
- return __generator(this, function (_b) {
233
- switch (_b.label) {
234
- case 0:
235
- singletonFilter = buildSingletonFilter(this.schema);
236
- findSingleton = function () {
237
- return _this.findOneOrNone(singletonFilter);
238
- };
239
- return [4 /*yield*/, findSingleton()];
240
- case 1:
241
- config = _b.sent();
242
- if (!!config) return [3 /*break*/, 8];
243
- _b.label = 2;
244
- case 2:
245
- _b.trys.push([2, 4, , 8]);
246
- created = new this();
247
- return [4 /*yield*/, created.save()];
248
- case 3:
249
- _b.sent();
250
- config = created;
251
- return [3 /*break*/, 8];
252
- case 4:
253
- err_1 = _b.sent();
254
- if (!((err_1 === null || err_1 === void 0 ? void 0 : err_1.status) === 409)) return [3 /*break*/, 6];
255
- return [4 /*yield*/, findSingleton()];
256
- case 5:
257
- config = _b.sent();
258
- return [3 /*break*/, 7];
259
- case 6: throw err_1;
260
- case 7: return [3 /*break*/, 8];
261
- case 8:
262
- if (key === undefined) {
263
- return [2 /*return*/, config];
264
- }
265
- parts = key.split(".");
266
- value = config === null || config === void 0 ? void 0 : config.toObject();
267
- try {
268
- for (parts_1 = __values(parts), parts_1_1 = parts_1.next(); !parts_1_1.done; parts_1_1 = parts_1.next()) {
269
- part = parts_1_1.value;
270
- if (value == null || typeof value !== "object") {
271
- return [2 /*return*/, undefined];
272
- }
273
- value = value[part];
274
- }
275
- }
276
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
277
- finally {
278
- try {
279
- if (parts_1_1 && !parts_1_1.done && (_a = parts_1.return)) _a.call(parts_1);
280
- }
281
- finally { if (e_2) throw e_2.error; }
282
- }
283
- return [2 /*return*/, value];
131
+ schema.statics.getConfig = async function (key) {
132
+ const singletonFilter = buildSingletonFilter(this.schema);
133
+ const findSingleton = () => this.findOneOrNone(singletonFilter);
134
+ let config = await findSingleton();
135
+ if (!config) {
136
+ try {
137
+ // Use `new` + `save` instead of `create({})` so Mongoose initializes
138
+ // nested subdocument defaults (create({}) skips them).
139
+ const created = new this();
140
+ await created.save();
141
+ config = created;
142
+ }
143
+ catch (err) {
144
+ // If another process created the document between the lookup and create,
145
+ // the pre-save hook will throw a 409. Just fetch the existing one.
146
+ if (err?.status === 409) {
147
+ config = await findSingleton();
284
148
  }
285
- });
286
- });
149
+ else {
150
+ throw err;
151
+ }
152
+ }
153
+ }
154
+ if (key === undefined) {
155
+ return config;
156
+ }
157
+ // Resolve dot-notation key into the document
158
+ const parts = key.split(".");
159
+ let value = config?.toObject();
160
+ for (const part of parts) {
161
+ if (value == null || typeof value !== "object") {
162
+ return undefined;
163
+ }
164
+ value = value[part];
165
+ }
166
+ return value;
287
167
  };
288
168
  // Static: update the singleton configuration document via $set dotted paths.
289
169
  // Flattening to dotted paths preserves sibling subdoc fields and tolerates
290
170
  // legacy/out-of-schema fields already persisted on the document.
291
- schema.statics.updateConfig = function (updates) {
292
- return __awaiter(this, void 0, void 0, function () {
293
- var singletonFilter, setFields, _a, _b, _c, path, value, updated;
294
- var e_3, _d;
295
- return __generator(this, function (_e) {
296
- switch (_e.label) {
297
- case 0:
298
- singletonFilter = buildSingletonFilter(this.schema);
299
- setFields = {};
300
- try {
301
- for (_a = __values((0, exports.flattenToDotPaths)(updates)), _b = _a.next(); !_b.done; _b = _a.next()) {
302
- _c = __read(_b.value, 2), path = _c[0], value = _c[1];
303
- setFields[path] = value;
304
- }
305
- }
306
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
307
- finally {
308
- try {
309
- if (_b && !_b.done && (_d = _a.return)) _d.call(_a);
310
- }
311
- finally { if (e_3) throw e_3.error; }
312
- }
313
- // Nothing to set — return the current singleton (creating it if missing).
314
- if (Object.keys(setFields).length === 0) {
315
- return [2 /*return*/, this.getConfig()];
316
- }
317
- return [4 /*yield*/, this.findOneAndUpdate(singletonFilter, { $set: setFields }, { returnDocument: "after", runValidators: true })];
318
- case 1:
319
- updated = _e.sent();
320
- if (updated) {
321
- return [2 /*return*/, updated];
322
- }
323
- // No singleton yet — create one (with subdocument defaults applied), then
324
- // apply the patch.
325
- return [4 /*yield*/, this.getConfig()];
326
- case 2:
327
- // No singleton yet — create one (with subdocument defaults applied), then
328
- // apply the patch.
329
- _e.sent();
330
- return [2 /*return*/, this.findOneAndUpdate(singletonFilter, { $set: setFields }, { returnDocument: "after", runValidators: true }).orFail()];
331
- }
332
- });
333
- });
171
+ schema.statics.updateConfig = async function (updates) {
172
+ const singletonFilter = buildSingletonFilter(this.schema);
173
+ const setFields = {};
174
+ for (const [path, value] of (0, exports.flattenToDotPaths)(updates)) {
175
+ setFields[path] = value;
176
+ }
177
+ // Nothing to set — return the current singleton (creating it if missing).
178
+ if (Object.keys(setFields).length === 0) {
179
+ return this.getConfig();
180
+ }
181
+ // runValidators keeps schema validation (enum/min/custom validators) on the
182
+ // patched paths, matching the prior doc.save() behavior. Legacy/out-of-schema
183
+ // fields already on the document are untouched (not in $set), so they are not
184
+ // re-validated.
185
+ const updated = await this.findOneAndUpdate(singletonFilter, { $set: setFields }, { returnDocument: "after", runValidators: true });
186
+ if (updated) {
187
+ return updated;
188
+ }
189
+ // No singleton yet — create one (with subdocument defaults applied), then
190
+ // apply the patch.
191
+ await this.getConfig();
192
+ return this.findOneAndUpdate(singletonFilter, { $set: setFields }, { returnDocument: "after", runValidators: true }).orFail();
334
193
  };
335
194
  // Static: discover secret fields from schema options
336
195
  schema.statics.getSecretFields = function () {
337
- var secrets = [];
338
- var discoverSecrets = function (s, prefix) {
339
- s.eachPath(function (pathName, schemaType) {
340
- var _a;
341
- var opts = schemaType.options;
342
- if ((opts === null || opts === void 0 ? void 0 : opts.secret) === true) {
196
+ const secrets = [];
197
+ const discoverSecrets = (s, prefix) => {
198
+ s.eachPath((pathName, schemaType) => {
199
+ const opts = schemaType.options;
200
+ if (opts?.secret === true) {
343
201
  secrets.push({
344
- path: prefix ? "".concat(prefix, ".").concat(pathName) : pathName,
345
- secretName: (_a = opts.secretName) !== null && _a !== void 0 ? _a : pathName,
202
+ path: prefix ? `${prefix}.${pathName}` : pathName,
203
+ secretName: opts.secretName ?? pathName,
346
204
  secretProvider: opts.secretProvider,
347
205
  version: opts.secretVersion,
348
206
  });
349
207
  }
350
208
  // Recurse into subschemas
351
209
  if (schemaType.schema) {
352
- discoverSecrets(schemaType.schema, prefix ? "".concat(prefix, ".").concat(pathName) : pathName);
210
+ discoverSecrets(schemaType.schema, prefix ? `${prefix}.${pathName}` : pathName);
353
211
  }
354
212
  });
355
213
  };
@@ -357,64 +215,34 @@ var configurationPlugin = function (schema, options) {
357
215
  return secrets;
358
216
  };
359
217
  // Static: resolve secret values from a provider
360
- schema.statics.resolveSecrets = function (provider) {
361
- return __awaiter(this, void 0, void 0, function () {
362
- var resolvedProvider, secrets, resolved, results, failCount, results_1, results_1_1, result;
363
- var e_4, _a;
364
- var _this = this;
365
- return __generator(this, function (_b) {
366
- switch (_b.label) {
367
- case 0:
368
- resolvedProvider = provider !== null && provider !== void 0 ? provider : pluginOptions.secretProvider;
369
- if (!resolvedProvider) {
370
- logger_1.logger.warn("resolveSecrets called with no provider. Pass a SecretProvider to resolveSecrets() or configurationPlugin options.");
371
- return [2 /*return*/, new Map()];
372
- }
373
- secrets = this.getSecretFields();
374
- resolved = new Map();
375
- return [4 /*yield*/, Promise.allSettled(secrets.map(function (meta) { return __awaiter(_this, void 0, void 0, function () {
376
- var value;
377
- return __generator(this, function (_a) {
378
- switch (_a.label) {
379
- case 0: return [4 /*yield*/, resolvedProvider.getSecret(meta.secretName, meta.version)];
380
- case 1:
381
- value = _a.sent();
382
- if (value !== null) {
383
- resolved.set(meta.path, value);
384
- }
385
- return [2 /*return*/];
386
- }
387
- });
388
- }); }))];
389
- case 1:
390
- results = _b.sent();
391
- failCount = 0;
392
- try {
393
- for (results_1 = __values(results), results_1_1 = results_1.next(); !results_1_1.done; results_1_1 = results_1.next()) {
394
- result = results_1_1.value;
395
- if (result.status === "rejected") {
396
- failCount++;
397
- logger_1.logger.error("Failed to resolve secret: ".concat(result.reason));
398
- }
399
- }
400
- }
401
- catch (e_4_1) { e_4 = { error: e_4_1 }; }
402
- finally {
403
- try {
404
- if (results_1_1 && !results_1_1.done && (_a = results_1.return)) _a.call(results_1);
405
- }
406
- finally { if (e_4) throw e_4.error; }
407
- }
408
- if (failCount > 0) {
409
- logger_1.logger.warn("".concat(failCount, "/").concat(secrets.length, " secrets failed to resolve"));
410
- }
411
- else if (secrets.length > 0) {
412
- logger_1.logger.info("Resolved ".concat(resolved.size, "/").concat(secrets.length, " secrets from ").concat(resolvedProvider.name));
413
- }
414
- return [2 /*return*/, resolved];
415
- }
416
- });
417
- });
218
+ schema.statics.resolveSecrets = async function (provider) {
219
+ const resolvedProvider = provider ?? pluginOptions.secretProvider;
220
+ if (!resolvedProvider) {
221
+ logger_1.logger.warn("resolveSecrets called with no provider. Pass a SecretProvider to resolveSecrets() or configurationPlugin options.");
222
+ return new Map();
223
+ }
224
+ const secrets = this.getSecretFields();
225
+ const resolved = new Map();
226
+ const results = await Promise.allSettled(secrets.map(async (meta) => {
227
+ const value = await resolvedProvider.getSecret(meta.secretName, meta.version);
228
+ if (value !== null) {
229
+ resolved.set(meta.path, value);
230
+ }
231
+ }));
232
+ let failCount = 0;
233
+ for (const result of results) {
234
+ if (result.status === "rejected") {
235
+ failCount++;
236
+ logger_1.logger.error(`Failed to resolve secret: ${result.reason}`);
237
+ }
238
+ }
239
+ if (failCount > 0) {
240
+ logger_1.logger.warn(`${failCount}/${secrets.length} secrets failed to resolve`);
241
+ }
242
+ else if (secrets.length > 0) {
243
+ logger_1.logger.info(`Resolved ${resolved.size}/${secrets.length} secrets from ${resolvedProvider.name}`);
244
+ }
245
+ return resolved;
418
246
  };
419
247
  };
420
248
  exports.configurationPlugin = configurationPlugin;