@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,195 +1,96 @@
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
2
  Object.defineProperty(exports, "__esModule", { value: true });
50
3
  exports.WebhooksApp = void 0;
51
- var api_1 = require("../api");
52
- var errors_1 = require("../errors");
53
- var logger_1 = require("../logger");
54
- var memoryStore_1 = require("./idempotency/memoryStore");
55
- var mongoStore_1 = require("./idempotency/mongoStore");
56
- var WebhooksApp = /** @class */ (function () {
57
- function WebhooksApp(options) {
58
- if (options === void 0) { options = {}; }
59
- var _this = this;
60
- var _a, _b, _c;
61
- this.routes = [];
62
- this.claim = function (args) { return __awaiter(_this, void 0, void 0, function () {
63
- return __generator(this, function (_a) {
64
- return [2 /*return*/, this.store.claim(args)];
65
- });
66
- }); };
67
- this.release = function (args) { return __awaiter(_this, void 0, void 0, function () {
68
- return __generator(this, function (_a) {
69
- switch (_a.label) {
70
- case 0: return [4 /*yield*/, this.store.release(args)];
71
- case 1:
72
- _a.sent();
73
- return [2 /*return*/];
74
- }
75
- });
76
- }); };
77
- this.dispatch = function (_a) { return __awaiter(_this, [_a], void 0, function (_b) {
78
- var isValid, eventId, log, claimResult, error_1;
79
- var req = _b.req, res = _b.res, route = _b.route;
80
- return __generator(this, function (_c) {
81
- switch (_c.label) {
82
- case 0:
83
- if (!req.rawBody) {
84
- throw new errors_1.APIError({
85
- code: "webhook-body-missing",
86
- disableExternalErrorTracking: true,
87
- status: 400,
88
- title: "Missing webhook body",
89
- });
90
- }
91
- return [4 /*yield*/, route.verify(req)];
92
- case 1:
93
- isValid = _c.sent();
94
- if (!isValid) {
95
- throw new errors_1.APIError({
96
- code: "webhook-signature-invalid",
97
- disableExternalErrorTracking: true,
98
- status: 401,
99
- title: "Invalid webhook signature",
100
- });
101
- }
102
- eventId = route.eventId ? route.eventId(req) : "";
103
- log = (0, logger_1.createScopedLogger)({
104
- labels: { eventId: eventId || "none", source: route.source },
105
- prefix: "[Webhook]",
106
- });
107
- if (!!eventId) return [3 /*break*/, 2];
108
- log.warn("Empty eventId; skipping idempotency claim");
109
- return [3 /*break*/, 4];
110
- case 2: return [4 /*yield*/, this.claim({ eventId: eventId, source: route.source })];
111
- case 3:
112
- claimResult = _c.sent();
113
- if (claimResult === "duplicate") {
114
- log.info("Duplicate webhook event");
115
- res.status(200).json({ duplicate: true, received: true });
116
- return [2 /*return*/];
117
- }
118
- _c.label = 4;
119
- case 4:
120
- _c.trys.push([4, 6, , 9]);
121
- return [4 /*yield*/, route.handler({
122
- body: req.body,
123
- eventId: eventId,
124
- headers: req.headers,
125
- rawBody: req.rawBody,
126
- })];
127
- case 5:
128
- _c.sent();
129
- return [3 /*break*/, 9];
130
- case 6:
131
- error_1 = _c.sent();
132
- if (!eventId) return [3 /*break*/, 8];
133
- return [4 /*yield*/, this.release({ eventId: eventId, source: route.source })];
134
- case 7:
135
- _c.sent();
136
- _c.label = 8;
137
- case 8:
138
- if ((0, errors_1.isAPIError)(error_1)) {
139
- throw error_1;
140
- }
141
- throw new errors_1.APIError({
142
- cause: error_1,
143
- status: 500,
144
- title: "Webhook handler failed",
145
- });
146
- case 9:
147
- res.status(200).json({ received: true });
148
- return [2 /*return*/];
149
- }
150
- });
151
- }); };
152
- var storeKind = (_b = (_a = options.idempotency) === null || _a === void 0 ? void 0 : _a.store) !== null && _b !== void 0 ? _b : "memory";
4
+ const api_1 = require("../api");
5
+ const errors_1 = require("../errors");
6
+ const logger_1 = require("../logger");
7
+ const memoryStore_1 = require("./idempotency/memoryStore");
8
+ const mongoStore_1 = require("./idempotency/mongoStore");
9
+ class WebhooksApp {
10
+ routes = [];
11
+ store;
12
+ constructor(options = {}) {
13
+ const storeKind = options.idempotency?.store ?? "memory";
153
14
  if (storeKind === "mongo") {
154
- this.store = (0, mongoStore_1.createMongoIdempotencyStore)({ ttlDays: (_c = options.idempotency) === null || _c === void 0 ? void 0 : _c.ttlDays });
15
+ this.store = (0, mongoStore_1.createMongoIdempotencyStore)({ ttlDays: options.idempotency?.ttlDays });
155
16
  }
156
17
  else {
157
18
  this.store = (0, memoryStore_1.createMemoryIdempotencyStore)();
158
19
  }
159
20
  }
160
- WebhooksApp.prototype.route = function (options) {
21
+ route(options) {
161
22
  this.routes.push(options);
162
23
  return this;
24
+ }
25
+ claim = async (args) => {
26
+ return this.store.claim(args);
163
27
  };
164
- WebhooksApp.prototype.register = function (app) {
165
- var e_1, _a;
166
- var _this = this;
167
- var _loop_1 = function (route) {
168
- app.post(route.path, (0, api_1.asyncHandler)(function (req, res) { return __awaiter(_this, void 0, void 0, function () {
169
- return __generator(this, function (_a) {
170
- switch (_a.label) {
171
- case 0: return [4 /*yield*/, this.dispatch({ req: req, res: res, route: route })];
172
- case 1:
173
- _a.sent();
174
- return [2 /*return*/];
175
- }
176
- });
177
- }); }));
178
- };
179
- try {
180
- for (var _b = __values(this.routes), _c = _b.next(); !_c.done; _c = _b.next()) {
181
- var route = _c.value;
182
- _loop_1(route);
28
+ release = async (args) => {
29
+ await this.store.release(args);
30
+ };
31
+ register(app) {
32
+ for (const route of this.routes) {
33
+ app.post(route.path, (0, api_1.asyncHandler)(async (req, res) => {
34
+ await this.dispatch({ req, res, route });
35
+ }));
36
+ }
37
+ }
38
+ dispatch = async ({ req, res, route, }) => {
39
+ if (!req.rawBody) {
40
+ throw new errors_1.APIError({
41
+ code: "webhook-body-missing",
42
+ disableExternalErrorTracking: true,
43
+ status: 400,
44
+ title: "Missing webhook body",
45
+ });
46
+ }
47
+ const isValid = await route.verify(req);
48
+ if (!isValid) {
49
+ throw new errors_1.APIError({
50
+ code: "webhook-signature-invalid",
51
+ disableExternalErrorTracking: true,
52
+ status: 401,
53
+ title: "Invalid webhook signature",
54
+ });
55
+ }
56
+ const eventId = route.eventId ? route.eventId(req) : "";
57
+ const log = (0, logger_1.createScopedLogger)({
58
+ labels: { eventId: eventId || "none", source: route.source },
59
+ prefix: "[Webhook]",
60
+ });
61
+ if (!eventId) {
62
+ log.warn("Empty eventId; skipping idempotency claim");
63
+ }
64
+ else {
65
+ const claimResult = await this.claim({ eventId, source: route.source });
66
+ if (claimResult === "duplicate") {
67
+ log.info("Duplicate webhook event");
68
+ res.status(200).json({ duplicate: true, received: true });
69
+ return;
183
70
  }
184
71
  }
185
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
186
- finally {
187
- try {
188
- if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
72
+ try {
73
+ await route.handler({
74
+ body: req.body,
75
+ eventId,
76
+ headers: req.headers,
77
+ rawBody: req.rawBody,
78
+ });
79
+ }
80
+ catch (error) {
81
+ if (eventId) {
82
+ await this.release({ eventId, source: route.source });
189
83
  }
190
- finally { if (e_1) throw e_1.error; }
84
+ if ((0, errors_1.isAPIError)(error)) {
85
+ throw error;
86
+ }
87
+ throw new errors_1.APIError({
88
+ cause: error,
89
+ status: 500,
90
+ title: "Webhook handler failed",
91
+ });
191
92
  }
93
+ res.status(200).json({ received: true });
192
94
  };
193
- return WebhooksApp;
194
- }());
95
+ }
195
96
  exports.WebhooksApp = WebhooksApp;
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.z = void 0;
4
- var zod_to_openapi_1 = require("@asteasolutions/zod-to-openapi");
5
- var zod_1 = require("zod");
4
+ const zod_to_openapi_1 = require("@asteasolutions/zod-to-openapi");
5
+ const zod_1 = require("zod");
6
6
  Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
7
7
  (0, zod_to_openapi_1.extendZodWithOpenApi)(zod_1.z);
package/package.json CHANGED
@@ -1,15 +1,17 @@
1
1
  {
2
2
  "author": "Josh Gachnang",
3
+ "bin": {
4
+ "terreno-migrate": "./src/migrations/cli.ts"
5
+ },
3
6
  "bugs": {
4
- "url": "https://github.com/FlourishHealth/terreno/issues"
7
+ "url": "https://github.com/TerrenoLabs/terreno/issues"
5
8
  },
6
9
  "dependencies": {
7
10
  "@asteasolutions/zod-to-openapi": "^8.5.0",
8
11
  "@modelcontextprotocol/node": "^2.0.0",
9
12
  "@modelcontextprotocol/server": "^2.0.0",
10
13
  "@sentry/bun": "^10.39.0",
11
- "@sentry/profiling-node": "^10.25.0",
12
- "@terreno/test": "57.3.0",
14
+ "@terreno/test": "57.6.0",
13
15
  "@thream/socketio-jwt": "^3.1.4",
14
16
  "@types/qs": "^6.14.0",
15
17
  "ajv": "8.20.0",
@@ -20,7 +22,6 @@
20
22
  "cors": "^2.8.5",
21
23
  "cron": "^4.3.4",
22
24
  "express": "^5.2.1",
23
- "generaterr": "^1.5.0",
24
25
  "http-errors": "^2.0.0",
25
26
  "jsonwebtoken": "^9.0.2",
26
27
  "lodash": "^4.18.1",
@@ -33,11 +34,9 @@
33
34
  "passport-github2": "^0.1.12",
34
35
  "passport-jwt": "^4.0.0",
35
36
  "passport-local": "^1.0.0",
36
- "passport-local-mongoose": "^9.0.1",
37
37
  "path-to-regexp": "^8.4.2",
38
38
  "qs": "^6.15.0",
39
39
  "router": "^2.2.0",
40
- "scmp": "^2.1.0",
41
40
  "serve-static": "^2.2.1",
42
41
  "socket.io": "^4.8.1",
43
42
  "swagger-parser": "^10.0.3",
@@ -49,11 +48,9 @@
49
48
  "devDependencies": {
50
49
  "@biomejs/biome": "^2.3.6",
51
50
  "@modelcontextprotocol/client": "^2.0.0",
52
- "@terreno/syncdb": "57.3.0",
53
- "@types/bcrypt": "^6.0.0",
51
+ "@terreno/syncdb": "57.6.0",
54
52
  "@types/bun": "^1.4.0",
55
53
  "@types/cors": "^2.8.17",
56
- "@types/cron": "^2.4.3",
57
54
  "@types/express": "^5.0.6",
58
55
  "@types/jsonwebtoken": "^9.0.9",
59
56
  "@types/lodash": "^4.17.17",
@@ -64,16 +61,25 @@
64
61
  "@types/passport-github2": "^1.2.9",
65
62
  "@types/passport-jwt": "^4.0.1",
66
63
  "@types/passport-local": "^1.0.38",
67
- "@types/sinon": "^21.0.0",
68
64
  "@types/supertest": "^7.2.0",
69
65
  "mongodb-memory-server": "^11.0.1",
70
66
  "mongoose": "9.7.4",
71
- "sinon": "^22.0.0",
67
+ "passport-local-mongoose": "^9.0.1",
72
68
  "supertest": "^7.2.2",
73
69
  "typescript": "~6.0.3",
74
70
  "zod": "^4.4.3"
75
71
  },
76
- "homepage": "https://github.com/FlourishHealth/terreno#readme",
72
+ "exports": {
73
+ ".": {
74
+ "default": "./dist/index.js",
75
+ "types": "./dist/index.d.ts"
76
+ },
77
+ "./testing": {
78
+ "default": "./dist/tests.js",
79
+ "types": "./dist/tests.d.ts"
80
+ }
81
+ },
82
+ "homepage": "https://github.com/TerrenoLabs/terreno#readme",
77
83
  "keywords": [
78
84
  "rest",
79
85
  "api",
@@ -82,27 +88,27 @@
82
88
  ],
83
89
  "license": "MIT",
84
90
  "main": "dist/index.js",
85
- "exports": {
86
- ".": {
87
- "types": "./dist/index.d.ts",
88
- "default": "./dist/index.js"
91
+ "name": "@terreno/api",
92
+ "peerDependencies": {
93
+ "ioredis": "^5.11.0",
94
+ "mongoose": "^8.0.0 || ^9.0.0",
95
+ "passport-local-mongoose": "^9.0.1",
96
+ "zod": "^4.3.6"
97
+ },
98
+ "peerDependenciesMeta": {
99
+ "ioredis": {
100
+ "optional": true
89
101
  },
90
- "./testing": {
91
- "types": "./dist/tests.d.ts",
92
- "default": "./dist/tests.js"
102
+ "passport-local-mongoose": {
103
+ "optional": true
93
104
  }
94
105
  },
95
- "name": "@terreno/api",
96
106
  "publishConfig": {
97
107
  "access": "public"
98
108
  },
99
- "peerDependencies": {
100
- "mongoose": "^8.0.0 || ^9.0.0",
101
- "zod": "^4.3.6"
102
- },
103
109
  "repository": {
104
110
  "type": "git",
105
- "url": "git+ssh://git@github.com/FlourishHealth/terreno.git"
111
+ "url": "git+ssh://git@github.com/TerrenoLabs/terreno.git"
106
112
  },
107
113
  "resolutions": {
108
114
  "json5": "2.2.3"
@@ -118,13 +124,13 @@
118
124
  "load": "bun src/sync/loadHarness.ts",
119
125
  "test": "bun test --update-snapshots",
120
126
  "test:agent": "AGENT=1 bun test --only-failures",
121
- "test:ci": "bun test",
122
- "test:coverage": "bun run ../scripts/check-coverage.ts",
123
127
  "test:cache:clean": "bun ./src/tests/mongoTestSetup.ts clean",
124
128
  "test:cache:setup": "bun ./src/tests/mongoTestSetup.ts setup",
125
129
  "test:cache:status": "bun ./src/tests/mongoTestSetup.ts status",
130
+ "test:ci": "bun test",
131
+ "test:coverage": "bun run ../scripts/check-coverage.ts",
126
132
  "updateSnapshot": "bun test --update-snapshots"
127
133
  },
128
134
  "types": "dist/index.d.ts",
129
- "version": "57.3.0"
135
+ "version": "57.6.0"
130
136
  }