@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,30 +1,4 @@
1
1
  "use strict";
2
- var __extends = (this && this.__extends) || (function () {
3
- var extendStatics = function (d, b) {
4
- extendStatics = Object.setPrototypeOf ||
5
- ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
6
- function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
7
- return extendStatics(d, b);
8
- };
9
- return function (d, b) {
10
- if (typeof b !== "function" && b !== null)
11
- throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
12
- extendStatics(d, b);
13
- function __() { this.constructor = d; }
14
- d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
15
- };
16
- })();
17
- var __assign = (this && this.__assign) || function () {
18
- __assign = Object.assign || function(t) {
19
- for (var s, i = 1, n = arguments.length; i < n; i++) {
20
- s = arguments[i];
21
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
22
- t[p] = s[p];
23
- }
24
- return t;
25
- };
26
- return __assign.apply(this, arguments);
27
- };
28
2
  var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
29
3
  if (k2 === undefined) k2 = k;
30
4
  var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -58,107 +32,35 @@ var __importStar = (this && this.__importStar) || (function () {
58
32
  return result;
59
33
  };
60
34
  })();
61
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
62
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
63
- return new (P || (P = Promise))(function (resolve, reject) {
64
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
65
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
66
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
67
- step((generator = generator.apply(thisArg, _arguments || [])).next());
68
- });
69
- };
70
- var __generator = (this && this.__generator) || function (thisArg, body) {
71
- 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);
72
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
73
- function verb(n) { return function (v) { return step([n, v]); }; }
74
- function step(op) {
75
- if (f) throw new TypeError("Generator is already executing.");
76
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
77
- 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;
78
- if (y = 0, t) op = [op[0] & 2, t.value];
79
- switch (op[0]) {
80
- case 0: case 1: t = op; break;
81
- case 4: _.label++; return { value: op[1], done: false };
82
- case 5: _.label++; y = op[1]; op = [0]; continue;
83
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
84
- default:
85
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
86
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
87
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
88
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
89
- if (t[2]) _.ops.pop();
90
- _.trys.pop(); continue;
91
- }
92
- op = body.call(thisArg, _);
93
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
94
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
95
- }
96
- };
97
- var __values = (this && this.__values) || function(o) {
98
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
99
- if (m) return m.call(o);
100
- if (o && typeof o.length === "number") return {
101
- next: function () {
102
- if (o && i >= o.length) o = void 0;
103
- return { value: o && o[i++], done: !o };
104
- }
105
- };
106
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
107
- };
108
- var __read = (this && this.__read) || function (o, n) {
109
- var m = typeof Symbol === "function" && o[Symbol.iterator];
110
- if (!m) return o;
111
- var i = m.call(o), r, ar = [], e;
112
- try {
113
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
114
- }
115
- catch (error) { e = { error: error }; }
116
- finally {
117
- try {
118
- if (r && !r.done && (m = i["return"])) m.call(i);
119
- }
120
- finally { if (e) throw e.error; }
121
- }
122
- return ar;
123
- };
124
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
125
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
126
- if (ar || !(i in from)) {
127
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
128
- ar[i] = from[i];
129
- }
130
- }
131
- return to.concat(ar || Array.prototype.slice.call(from));
132
- };
133
35
  Object.defineProperty(exports, "__esModule", { value: true });
134
36
  exports.BackgroundTask = exports.TaskCancelledError = exports.parseScriptArgs = exports.createScriptArgs = void 0;
135
- var luxon_1 = require("luxon");
136
- var mongoose_1 = __importStar(require("mongoose"));
137
- var plugins_1 = require("./plugins");
138
- var coerceArgValue = function (value, type) {
37
+ const luxon_1 = require("luxon");
38
+ const mongoose_1 = __importStar(require("mongoose"));
39
+ const plugins_1 = require("./plugins");
40
+ const coerceArgValue = (value, type) => {
139
41
  if (type === "number") {
140
- var num = typeof value === "number" ? value : Number(Array.isArray(value) ? value[0] : value);
42
+ const num = typeof value === "number" ? value : Number(Array.isArray(value) ? value[0] : value);
141
43
  if (Number.isNaN(num)) {
142
- return { error: "expected a number but received \"".concat(String(value), "\""), value: value };
44
+ return { error: `expected a number but received "${String(value)}"`, value };
143
45
  }
144
46
  return { value: num };
145
47
  }
146
48
  if (type === "boolean") {
147
49
  if (typeof value === "boolean") {
148
- return { value: value };
50
+ return { value };
149
51
  }
150
- var normalized = String(Array.isArray(value) ? value[0] : value).toLowerCase();
52
+ const normalized = String(Array.isArray(value) ? value[0] : value).toLowerCase();
151
53
  if (["true", "1", "yes", "on"].includes(normalized)) {
152
54
  return { value: true };
153
55
  }
154
56
  if (["false", "0", "no", "off"].includes(normalized)) {
155
57
  return { value: false };
156
58
  }
157
- return { error: "expected a boolean but received \"".concat(String(value), "\""), value: value };
59
+ return { error: `expected a boolean but received "${String(value)}"`, value };
158
60
  }
159
- return { value: value };
61
+ return { value };
160
62
  };
161
- var toStringValue = function (value) {
63
+ const toStringValue = (value) => {
162
64
  if (value === undefined) {
163
65
  return undefined;
164
66
  }
@@ -172,63 +74,49 @@ var toStringValue = function (value) {
172
74
  * Applies declared defaults, coerces declared types, and validates required args.
173
75
  * Returns the accessor plus any validation errors (callers decide how to surface them).
174
76
  */
175
- var createScriptArgs = function (_a) {
176
- var e_1, _b;
177
- var values = _a.values, _c = _a.positional, positional = _c === void 0 ? [] : _c, _d = _a.defs, defs = _d === void 0 ? [] : _d;
178
- var errors = [];
179
- var raw = __assign({}, values);
180
- try {
181
- for (var defs_1 = __values(defs), defs_1_1 = defs_1.next(); !defs_1_1.done; defs_1_1 = defs_1.next()) {
182
- var def = defs_1_1.value;
183
- if (raw[def.name] === undefined) {
184
- if (def.default !== undefined) {
185
- raw[def.name] = def.default;
186
- }
187
- else if (def.required) {
188
- errors.push("Missing required argument: --".concat(def.name, " (").concat(def.description, ")"));
189
- }
190
- continue;
77
+ const createScriptArgs = ({ values, positional = [], defs = [], }) => {
78
+ const errors = [];
79
+ const raw = { ...values };
80
+ for (const def of defs) {
81
+ if (raw[def.name] === undefined) {
82
+ if (def.default !== undefined) {
83
+ raw[def.name] = def.default;
191
84
  }
192
- var coerced = coerceArgValue(raw[def.name], def.type);
193
- if (coerced.error) {
194
- errors.push("Invalid argument --".concat(def.name, ": ").concat(coerced.error));
195
- continue;
85
+ else if (def.required) {
86
+ errors.push(`Missing required argument: --${def.name} (${def.description})`);
196
87
  }
197
- raw[def.name] = coerced.value;
88
+ continue;
198
89
  }
199
- }
200
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
201
- finally {
202
- try {
203
- if (defs_1_1 && !defs_1_1.done && (_b = defs_1.return)) _b.call(defs_1);
90
+ const coerced = coerceArgValue(raw[def.name], def.type);
91
+ if (coerced.error) {
92
+ errors.push(`Invalid argument --${def.name}: ${coerced.error}`);
93
+ continue;
204
94
  }
205
- finally { if (e_1) throw e_1.error; }
95
+ raw[def.name] = coerced.value;
206
96
  }
207
- var args = {
208
- getBoolean: function (name, fallback) {
209
- var _a;
210
- if (fallback === void 0) { fallback = false; }
211
- var value = raw[name];
97
+ const args = {
98
+ getBoolean: (name, fallback = false) => {
99
+ const value = raw[name];
212
100
  if (value === undefined) {
213
101
  return fallback;
214
102
  }
215
103
  if (typeof value === "boolean") {
216
104
  return value;
217
105
  }
218
- var normalized = (_a = toStringValue(value)) === null || _a === void 0 ? void 0 : _a.toLowerCase();
106
+ const normalized = toStringValue(value)?.toLowerCase();
219
107
  return normalized !== undefined && ["true", "1", "yes", "on"].includes(normalized);
220
108
  },
221
- getNumber: function (name, fallback) {
222
- var value = raw[name];
109
+ getNumber: (name, fallback) => {
110
+ const value = raw[name];
223
111
  if (value === undefined) {
224
112
  return fallback;
225
113
  }
226
- var num = typeof value === "number" ? value : Number(toStringValue(value));
114
+ const num = typeof value === "number" ? value : Number(toStringValue(value));
227
115
  return Number.isNaN(num) ? fallback : num;
228
116
  },
229
- getString: function (name, fallback) { var _a; return (_a = toStringValue(raw[name])) !== null && _a !== void 0 ? _a : fallback; },
230
- getStringArray: function (name) {
231
- var value = raw[name];
117
+ getString: (name, fallback) => toStringValue(raw[name]) ?? fallback,
118
+ getStringArray: (name) => {
119
+ const value = raw[name];
232
120
  if (value === undefined) {
233
121
  return [];
234
122
  }
@@ -237,11 +125,11 @@ var createScriptArgs = function (_a) {
237
125
  }
238
126
  return [String(value)];
239
127
  },
240
- has: function (name) { return raw[name] !== undefined; },
241
- positional: positional,
242
- raw: raw,
128
+ has: (name) => raw[name] !== undefined,
129
+ positional,
130
+ raw,
243
131
  };
244
- return { args: args, errors: errors };
132
+ return { args, errors };
245
133
  };
246
134
  exports.createScriptArgs = createScriptArgs;
247
135
  /**
@@ -257,74 +145,50 @@ exports.createScriptArgs = createScriptArgs;
257
145
  * When {@link ScriptArgDef declarations} are supplied, values are coerced to the
258
146
  * declared type, defaults are applied, and required args are validated.
259
147
  */
260
- var parseScriptArgs = function (tokens, defs) {
261
- var e_2, _a, e_3, _b;
262
- var _c, _d, _e;
263
- if (defs === void 0) { defs = []; }
264
- var aliasToName = new Map();
265
- var defByName = new Map();
266
- try {
267
- for (var defs_2 = __values(defs), defs_2_1 = defs_2.next(); !defs_2_1.done; defs_2_1 = defs_2.next()) {
268
- var def = defs_2_1.value;
269
- defByName.set(def.name, def);
270
- try {
271
- for (var _f = (e_3 = void 0, __values((_c = def.aliases) !== null && _c !== void 0 ? _c : [])), _g = _f.next(); !_g.done; _g = _f.next()) {
272
- var alias = _g.value;
273
- aliasToName.set(alias, def.name);
274
- }
275
- }
276
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
277
- finally {
278
- try {
279
- if (_g && !_g.done && (_b = _f.return)) _b.call(_f);
280
- }
281
- finally { if (e_3) throw e_3.error; }
282
- }
283
- }
284
- }
285
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
286
- finally {
287
- try {
288
- if (defs_2_1 && !defs_2_1.done && (_a = defs_2.return)) _a.call(defs_2);
148
+ const parseScriptArgs = (tokens, defs = []) => {
149
+ const aliasToName = new Map();
150
+ const defByName = new Map();
151
+ for (const def of defs) {
152
+ defByName.set(def.name, def);
153
+ for (const alias of def.aliases ?? []) {
154
+ aliasToName.set(alias, def.name);
289
155
  }
290
- finally { if (e_2) throw e_2.error; }
291
156
  }
292
- var values = {};
293
- var positional = [];
294
- var missingValueErrors = [];
295
- var assign = function (key, value) {
296
- var _a;
297
- var name = (_a = aliasToName.get(key)) !== null && _a !== void 0 ? _a : key;
298
- var existing = values[name];
157
+ const values = {};
158
+ const positional = [];
159
+ const missingValueErrors = [];
160
+ const assign = (key, value) => {
161
+ const name = aliasToName.get(key) ?? key;
162
+ const existing = values[name];
299
163
  if (existing === undefined) {
300
164
  values[name] = value;
301
165
  return;
302
166
  }
303
167
  // Repeated flag: collapse into an array of strings.
304
- var asArray = Array.isArray(existing) ? existing : [String(existing)];
305
- values[name] = __spreadArray(__spreadArray([], __read(asArray), false), [String(value)], false);
168
+ const asArray = Array.isArray(existing) ? existing : [String(existing)];
169
+ values[name] = [...asArray, String(value)];
306
170
  };
307
- for (var i = 0; i < tokens.length; i++) {
308
- var token = tokens[i];
171
+ for (let i = 0; i < tokens.length; i++) {
172
+ const token = tokens[i];
309
173
  if (!token.startsWith("-") || token === "-") {
310
174
  positional.push(token);
311
175
  continue;
312
176
  }
313
- var flag = token.replace(/^-+/, "");
177
+ const flag = token.replace(/^-+/, "");
314
178
  if (flag.startsWith("no-") && !flag.includes("=")) {
315
179
  assign(flag.slice(3), false);
316
180
  continue;
317
181
  }
318
- var eqIndex = flag.indexOf("=");
182
+ const eqIndex = flag.indexOf("=");
319
183
  if (eqIndex !== -1) {
320
184
  assign(flag.slice(0, eqIndex), flag.slice(eqIndex + 1));
321
185
  continue;
322
186
  }
323
- var canonical = (_d = aliasToName.get(flag)) !== null && _d !== void 0 ? _d : flag;
324
- var def = defByName.get(canonical);
325
- var next = tokens[i + 1];
326
- var nextIsValue = next !== undefined && (next === "-" || !next.startsWith("-"));
327
- if ((def === null || def === void 0 ? void 0 : def.type) === "boolean") {
187
+ const canonical = aliasToName.get(flag) ?? flag;
188
+ const def = defByName.get(canonical);
189
+ const next = tokens[i + 1];
190
+ const nextIsValue = next !== undefined && (next === "-" || !next.startsWith("-"));
191
+ if (def?.type === "boolean") {
328
192
  assign(flag, true);
329
193
  continue;
330
194
  }
@@ -332,7 +196,7 @@ var parseScriptArgs = function (tokens, defs) {
332
196
  // A declared string/number flag was given without a value. Record an error
333
197
  // instead of silently storing `true` (which would coerce to 1 / "true").
334
198
  if (def) {
335
- missingValueErrors.push("Argument --".concat(canonical, " expects a ").concat((_e = def.type) !== null && _e !== void 0 ? _e : "string", " value"));
199
+ missingValueErrors.push(`Argument --${canonical} expects a ${def.type ?? "string"} value`);
336
200
  continue;
337
201
  }
338
202
  assign(flag, true);
@@ -341,26 +205,23 @@ var parseScriptArgs = function (tokens, defs) {
341
205
  assign(flag, next);
342
206
  i++;
343
207
  }
344
- var _h = (0, exports.createScriptArgs)({ defs: defs, positional: positional, values: values }), args = _h.args, errors = _h.errors;
345
- return { args: args, errors: __spreadArray(__spreadArray([], __read(missingValueErrors), false), __read(errors), false) };
208
+ const { args, errors } = (0, exports.createScriptArgs)({ defs, positional, values });
209
+ return { args, errors: [...missingValueErrors, ...errors] };
346
210
  };
347
211
  exports.parseScriptArgs = parseScriptArgs;
348
- var TaskCancelledError = /** @class */ (function (_super) {
349
- __extends(TaskCancelledError, _super);
350
- function TaskCancelledError(taskId) {
351
- var _this = _super.call(this, "Task ".concat(taskId, " was cancelled")) || this;
352
- _this.name = "TaskCancelledError";
353
- return _this;
212
+ class TaskCancelledError extends Error {
213
+ constructor(taskId) {
214
+ super(`Task ${taskId} was cancelled`);
215
+ this.name = "TaskCancelledError";
354
216
  }
355
- return TaskCancelledError;
356
- }(Error));
217
+ }
357
218
  exports.TaskCancelledError = TaskCancelledError;
358
- var progressSchema = new mongoose_1.Schema({
219
+ const progressSchema = new mongoose_1.Schema({
359
220
  message: { description: "Human-readable progress message", type: String },
360
221
  percentage: { description: "Progress percentage from 0 to 100", max: 100, min: 0, type: Number },
361
222
  stage: { description: "Current stage of the task", type: String },
362
223
  }, { _id: false, strict: "throw" });
363
- var logSchema = new mongoose_1.Schema({
224
+ const logSchema = new mongoose_1.Schema({
364
225
  level: {
365
226
  description: "Log level",
366
227
  enum: ["info", "warn", "error"],
@@ -370,7 +231,7 @@ var logSchema = new mongoose_1.Schema({
370
231
  message: { description: "Log message", required: true, type: String },
371
232
  timestamp: { description: "When this log entry was created", required: true, type: Date },
372
233
  }, { _id: false, strict: "throw" });
373
- var backgroundTaskSchema = new mongoose_1.Schema({
234
+ const backgroundTaskSchema = new mongoose_1.Schema({
374
235
  completedAt: {
375
236
  description: "When the task completed (success or failure)",
376
237
  type: Date,
@@ -419,63 +280,32 @@ var backgroundTaskSchema = new mongoose_1.Schema({
419
280
  },
420
281
  }, { strict: "throw", toJSON: { virtuals: true }, toObject: { virtuals: true } });
421
282
  backgroundTaskSchema.methods = {
422
- addLog: function (level, message) {
423
- return __awaiter(this, void 0, void 0, function () {
424
- return __generator(this, function (_a) {
425
- switch (_a.label) {
426
- case 0:
427
- if (!this.logs) {
428
- this.logs = [];
429
- }
430
- this.logs.push({
431
- level: level,
432
- message: message,
433
- timestamp: luxon_1.DateTime.now().toJSDate(),
434
- });
435
- return [4 /*yield*/, this.save()];
436
- case 1:
437
- _a.sent();
438
- return [2 /*return*/];
439
- }
440
- });
283
+ async addLog(level, message) {
284
+ if (!this.logs) {
285
+ this.logs = [];
286
+ }
287
+ this.logs.push({
288
+ level,
289
+ message,
290
+ timestamp: luxon_1.DateTime.now().toJSDate(),
441
291
  });
292
+ await this.save();
442
293
  },
443
- updateProgress: function (percentage, stage, message) {
444
- return __awaiter(this, void 0, void 0, function () {
445
- var _a, _b;
446
- return __generator(this, function (_c) {
447
- switch (_c.label) {
448
- case 0:
449
- this.progress = {
450
- message: message !== null && message !== void 0 ? message : (_a = this.progress) === null || _a === void 0 ? void 0 : _a.message,
451
- percentage: percentage,
452
- stage: stage !== null && stage !== void 0 ? stage : (_b = this.progress) === null || _b === void 0 ? void 0 : _b.stage,
453
- };
454
- return [4 /*yield*/, this.save()];
455
- case 1:
456
- _c.sent();
457
- return [2 /*return*/];
458
- }
459
- });
460
- });
294
+ async updateProgress(percentage, stage, message) {
295
+ this.progress = {
296
+ message: message ?? this.progress?.message,
297
+ percentage,
298
+ stage: stage ?? this.progress?.stage,
299
+ };
300
+ await this.save();
461
301
  },
462
302
  };
463
303
  backgroundTaskSchema.statics = {
464
- checkCancellation: function (taskId) {
465
- return __awaiter(this, void 0, void 0, function () {
466
- var task;
467
- return __generator(this, function (_a) {
468
- switch (_a.label) {
469
- case 0: return [4 /*yield*/, this.findById(taskId).select("status").lean()];
470
- case 1:
471
- task = _a.sent();
472
- if ((task === null || task === void 0 ? void 0 : task.status) === "cancelled") {
473
- throw new TaskCancelledError(taskId);
474
- }
475
- return [2 /*return*/];
476
- }
477
- });
478
- });
304
+ async checkCancellation(taskId) {
305
+ const task = await this.findById(taskId).select("status").lean();
306
+ if (task?.status === "cancelled") {
307
+ throw new TaskCancelledError(taskId);
308
+ }
479
309
  },
480
310
  };
481
311
  backgroundTaskSchema.index({ createdBy: 1, status: 1 });