reqon-dsl 0.2.0 → 0.3.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 (396) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/README.md +22 -0
  3. package/dist/ast/nodes.d.ts +83 -4
  4. package/dist/ast/nodes.js +14 -0
  5. package/dist/auth/circuit-breaker.js +7 -6
  6. package/dist/auth/rate-limiter.d.ts +4 -0
  7. package/dist/auth/rate-limiter.js +9 -16
  8. package/dist/cli.d.ts +13 -0
  9. package/dist/cli.js +84 -4
  10. package/dist/config/constants.d.ts +141 -0
  11. package/dist/config/constants.js +128 -0
  12. package/dist/config/index.d.ts +4 -0
  13. package/dist/config/index.js +4 -0
  14. package/dist/control/index.d.ts +2 -0
  15. package/dist/control/index.js +1 -0
  16. package/dist/control/server.d.ts +88 -0
  17. package/dist/control/server.js +238 -0
  18. package/dist/control/types.d.ts +55 -0
  19. package/dist/control/types.js +7 -0
  20. package/dist/debug/cli-debugger.d.ts +17 -0
  21. package/dist/debug/cli-debugger.js +180 -0
  22. package/dist/debug/controller.d.ts +94 -0
  23. package/dist/debug/controller.js +45 -0
  24. package/dist/debug/index.d.ts +6 -0
  25. package/dist/debug/index.js +5 -0
  26. package/dist/errors/index.d.ts +67 -0
  27. package/dist/errors/index.js +89 -1
  28. package/dist/execution/index.d.ts +1 -1
  29. package/dist/execution/state.d.ts +24 -0
  30. package/dist/index.d.ts +21 -1
  31. package/dist/index.js +33 -2
  32. package/dist/interpreter/context.d.ts +14 -0
  33. package/dist/interpreter/context.js +15 -0
  34. package/dist/interpreter/evaluator.d.ts +63 -1
  35. package/dist/interpreter/evaluator.js +186 -39
  36. package/dist/interpreter/executor.d.ts +70 -14
  37. package/dist/interpreter/executor.js +503 -174
  38. package/dist/interpreter/fetch-handler.d.ts +9 -0
  39. package/dist/interpreter/fetch-handler.js +133 -24
  40. package/dist/interpreter/http.d.ts +5 -0
  41. package/dist/interpreter/http.js +26 -12
  42. package/dist/interpreter/index.d.ts +3 -1
  43. package/dist/interpreter/index.js +2 -0
  44. package/dist/interpreter/pagination.d.ts +11 -2
  45. package/dist/interpreter/pagination.js +95 -31
  46. package/dist/interpreter/signals.d.ts +8 -0
  47. package/dist/interpreter/signals.js +12 -0
  48. package/dist/interpreter/source-manager.d.ts +75 -0
  49. package/dist/interpreter/source-manager.js +157 -0
  50. package/dist/interpreter/step-handlers/apply-handler.d.ts +29 -0
  51. package/dist/interpreter/step-handlers/apply-handler.js +79 -0
  52. package/dist/interpreter/step-handlers/for-handler.d.ts +13 -0
  53. package/dist/interpreter/step-handlers/for-handler.js +71 -4
  54. package/dist/interpreter/step-handlers/index.d.ts +4 -2
  55. package/dist/interpreter/step-handlers/index.js +4 -2
  56. package/dist/interpreter/step-handlers/match-handler.d.ts +9 -0
  57. package/dist/interpreter/step-handlers/match-handler.js +43 -16
  58. package/dist/interpreter/step-handlers/pause-handler.d.ts +52 -0
  59. package/dist/interpreter/step-handlers/pause-handler.js +87 -0
  60. package/dist/interpreter/step-handlers/store-handler.d.ts +11 -1
  61. package/dist/interpreter/step-handlers/store-handler.js +45 -13
  62. package/dist/interpreter/step-handlers/types.d.ts +3 -0
  63. package/dist/interpreter/step-handlers/validate-handler.d.ts +2 -1
  64. package/dist/interpreter/step-handlers/validate-handler.js +4 -2
  65. package/dist/interpreter/step-handlers/webhook-handler.d.ts +3 -0
  66. package/dist/interpreter/step-handlers/webhook-handler.js +18 -2
  67. package/dist/interpreter/store-manager.d.ts +46 -0
  68. package/dist/interpreter/store-manager.js +66 -0
  69. package/dist/lexer/index.d.ts +11 -4
  70. package/dist/lexer/index.js +11 -4
  71. package/dist/lexer/tokens.d.ts +17 -1
  72. package/dist/lexer/tokens.js +36 -0
  73. package/dist/mcp/index.d.ts +11 -0
  74. package/dist/mcp/index.js +11 -0
  75. package/dist/mcp/server.d.ts +17 -0
  76. package/dist/mcp/server.js +451 -0
  77. package/dist/oas/index.d.ts +2 -0
  78. package/dist/oas/index.js +1 -0
  79. package/dist/oas/mock-generator.d.ts +12 -0
  80. package/dist/oas/mock-generator.js +187 -0
  81. package/dist/observability/events.d.ts +244 -0
  82. package/dist/observability/events.js +90 -0
  83. package/dist/observability/index.d.ts +15 -0
  84. package/dist/observability/index.js +12 -0
  85. package/dist/observability/logger.d.ts +106 -0
  86. package/dist/observability/logger.js +259 -0
  87. package/dist/observability/otel.d.ts +135 -0
  88. package/dist/observability/otel.js +386 -0
  89. package/dist/parser/action-parser.d.ts +105 -0
  90. package/dist/parser/action-parser.js +645 -0
  91. package/dist/parser/expressions.d.ts +13 -0
  92. package/dist/parser/expressions.js +72 -2
  93. package/dist/parser/fetch-parser.d.ts +27 -0
  94. package/dist/parser/fetch-parser.js +269 -0
  95. package/dist/parser/index.d.ts +17 -0
  96. package/dist/parser/index.js +17 -0
  97. package/dist/parser/parser.d.ts +44 -46
  98. package/dist/parser/parser.js +122 -1070
  99. package/dist/parser/pipeline-parser.d.ts +12 -0
  100. package/dist/parser/pipeline-parser.js +52 -0
  101. package/dist/parser/schedule-parser.d.ts +7 -0
  102. package/dist/parser/schedule-parser.js +137 -0
  103. package/dist/parser/source-parser.d.ts +9 -0
  104. package/dist/parser/source-parser.js +151 -0
  105. package/dist/pause/index.d.ts +14 -0
  106. package/dist/pause/index.js +11 -0
  107. package/dist/pause/manager.d.ts +118 -0
  108. package/dist/pause/manager.js +245 -0
  109. package/dist/pause/state.d.ts +93 -0
  110. package/dist/pause/state.js +103 -0
  111. package/dist/pause/store.d.ts +61 -0
  112. package/dist/pause/store.js +156 -0
  113. package/dist/plugin.d.ts +9 -12
  114. package/dist/plugin.js +10 -13
  115. package/dist/stores/factory.d.ts +1 -1
  116. package/dist/stores/factory.js +3 -2
  117. package/dist/stores/file.d.ts +26 -0
  118. package/dist/stores/file.js +64 -10
  119. package/dist/stores/index.d.ts +16 -1
  120. package/dist/stores/index.js +16 -1
  121. package/dist/stores/memory.d.ts +4 -0
  122. package/dist/stores/memory.js +11 -0
  123. package/dist/stores/types.d.ts +17 -0
  124. package/dist/stores/types.js +12 -0
  125. package/dist/trace/index.d.ts +16 -0
  126. package/dist/trace/index.js +12 -0
  127. package/dist/trace/recorder.d.ts +71 -0
  128. package/dist/trace/recorder.js +144 -0
  129. package/dist/trace/replay.d.ts +132 -0
  130. package/dist/trace/replay.js +264 -0
  131. package/dist/trace/state.d.ts +102 -0
  132. package/dist/trace/state.js +86 -0
  133. package/dist/trace/store.d.ts +69 -0
  134. package/dist/trace/store.js +225 -0
  135. package/dist/utils/index.d.ts +1 -0
  136. package/dist/utils/index.js +1 -0
  137. package/dist/utils/type-guards.d.ts +58 -0
  138. package/dist/utils/type-guards.js +92 -0
  139. package/dist/webhook/server.js +7 -6
  140. package/package.json +55 -6
  141. package/.claude/settings.local.json +0 -31
  142. package/.claude/skills/api-integration.md +0 -125
  143. package/.claude/skills/database-schema.md +0 -51
  144. package/.claude/skills/dsl-design.md +0 -80
  145. package/.claude/skills/property-testing.md +0 -143
  146. package/.claude/skills/reqon/SKILL.md +0 -44
  147. package/.claude/skills/reqon/references/examples.md +0 -206
  148. package/.claude/skills/reqon/references/syntax.md +0 -263
  149. package/.claude/skills/vscode-extension.md +0 -113
  150. package/.github/dependabot.yml +0 -32
  151. package/.github/pull_request_template.md +0 -21
  152. package/.github/workflows/ci.yml +0 -174
  153. package/.github/workflows/release.yml +0 -73
  154. package/CLAUDE.md +0 -72
  155. package/CONTRIBUTING.md +0 -161
  156. package/TODO.md +0 -51
  157. package/dist/auth/auth.test.d.ts +0 -1
  158. package/dist/auth/auth.test.js +0 -255
  159. package/dist/errors/errors.test.d.ts +0 -1
  160. package/dist/errors/errors.test.js +0 -165
  161. package/dist/execution/execution.test.d.ts +0 -1
  162. package/dist/execution/execution.test.js +0 -246
  163. package/dist/integration.test.d.ts +0 -1
  164. package/dist/integration.test.js +0 -168
  165. package/dist/interpreter/evaluator.test.d.ts +0 -1
  166. package/dist/interpreter/evaluator.test.js +0 -512
  167. package/dist/interpreter/http.test.d.ts +0 -1
  168. package/dist/interpreter/http.test.js +0 -299
  169. package/dist/interpreter/progress.test.d.ts +0 -1
  170. package/dist/interpreter/progress.test.js +0 -216
  171. package/dist/interpreter/schema-matcher.test.d.ts +0 -1
  172. package/dist/interpreter/schema-matcher.test.js +0 -122
  173. package/dist/lexer/lexer.d.ts +0 -24
  174. package/dist/lexer/lexer.js +0 -264
  175. package/dist/lexer/lexer.test.d.ts +0 -1
  176. package/dist/lexer/lexer.test.js +0 -259
  177. package/dist/loader/loader.test.d.ts +0 -1
  178. package/dist/loader/loader.test.js +0 -287
  179. package/dist/oas/oas.test.d.ts +0 -1
  180. package/dist/oas/oas.test.js +0 -218
  181. package/dist/parser/expressions.test.d.ts +0 -1
  182. package/dist/parser/expressions.test.js +0 -378
  183. package/dist/parser/match.test.d.ts +0 -1
  184. package/dist/parser/match.test.js +0 -254
  185. package/dist/parser/parser.test.d.ts +0 -1
  186. package/dist/parser/parser.test.js +0 -333
  187. package/dist/parser/schedule.test.d.ts +0 -1
  188. package/dist/parser/schedule.test.js +0 -241
  189. package/dist/scheduler/cron-parser.test.d.ts +0 -1
  190. package/dist/scheduler/cron-parser.test.js +0 -188
  191. package/dist/stores/file.test.d.ts +0 -1
  192. package/dist/stores/file.test.js +0 -165
  193. package/dist/stores/memory.test.d.ts +0 -1
  194. package/dist/stores/memory.test.js +0 -157
  195. package/dist/stores/stores.test.d.ts +0 -1
  196. package/dist/stores/stores.test.js +0 -158
  197. package/dist/sync/sync.test.d.ts +0 -1
  198. package/dist/sync/sync.test.js +0 -221
  199. package/docusaurus/README.md +0 -41
  200. package/docusaurus/docs/advanced/execution-state.md +0 -283
  201. package/docusaurus/docs/advanced/extending-reqon.md +0 -388
  202. package/docusaurus/docs/advanced/multi-file-missions.md +0 -250
  203. package/docusaurus/docs/advanced/parallel-execution.md +0 -353
  204. package/docusaurus/docs/api-reference.md +0 -443
  205. package/docusaurus/docs/authentication/api-key.md +0 -339
  206. package/docusaurus/docs/authentication/basic.md +0 -276
  207. package/docusaurus/docs/authentication/bearer.md +0 -282
  208. package/docusaurus/docs/authentication/oauth2.md +0 -317
  209. package/docusaurus/docs/authentication/overview.md +0 -251
  210. package/docusaurus/docs/cli.md +0 -229
  211. package/docusaurus/docs/core-concepts/actions.md +0 -286
  212. package/docusaurus/docs/core-concepts/missions.md +0 -264
  213. package/docusaurus/docs/core-concepts/schemas.md +0 -353
  214. package/docusaurus/docs/core-concepts/sources.md +0 -339
  215. package/docusaurus/docs/core-concepts/stores.md +0 -332
  216. package/docusaurus/docs/dsl-syntax/expressions.md +0 -361
  217. package/docusaurus/docs/dsl-syntax/fetch.md +0 -293
  218. package/docusaurus/docs/dsl-syntax/for-loops.md +0 -324
  219. package/docusaurus/docs/dsl-syntax/map.md +0 -345
  220. package/docusaurus/docs/dsl-syntax/match.md +0 -387
  221. package/docusaurus/docs/dsl-syntax/pipelines.md +0 -397
  222. package/docusaurus/docs/dsl-syntax/validate.md +0 -401
  223. package/docusaurus/docs/error-handling/dead-letter-queues.md +0 -399
  224. package/docusaurus/docs/error-handling/flow-control.md +0 -337
  225. package/docusaurus/docs/error-handling/retry-strategies.md +0 -368
  226. package/docusaurus/docs/examples.md +0 -488
  227. package/docusaurus/docs/getting-started.md +0 -256
  228. package/docusaurus/docs/http/circuit-breaker.md +0 -401
  229. package/docusaurus/docs/http/incremental-sync.md +0 -394
  230. package/docusaurus/docs/http/pagination.md +0 -361
  231. package/docusaurus/docs/http/rate-limiting.md +0 -383
  232. package/docusaurus/docs/http/requests.md +0 -328
  233. package/docusaurus/docs/http/retry.md +0 -402
  234. package/docusaurus/docs/intro.md +0 -90
  235. package/docusaurus/docs/openapi/loading-specs.md +0 -305
  236. package/docusaurus/docs/openapi/operation-calls.md +0 -314
  237. package/docusaurus/docs/openapi/overview.md +0 -212
  238. package/docusaurus/docs/openapi/response-validation.md +0 -344
  239. package/docusaurus/docs/scheduling/cron.md +0 -305
  240. package/docusaurus/docs/scheduling/daemon-mode.md +0 -317
  241. package/docusaurus/docs/scheduling/intervals.md +0 -289
  242. package/docusaurus/docs/scheduling/overview.md +0 -231
  243. package/docusaurus/docs/stores/custom-adapters.md +0 -376
  244. package/docusaurus/docs/stores/file.md +0 -236
  245. package/docusaurus/docs/stores/memory.md +0 -193
  246. package/docusaurus/docs/stores/overview.md +0 -274
  247. package/docusaurus/docs/stores/postgrest.md +0 -316
  248. package/docusaurus/docusaurus.config.ts +0 -148
  249. package/docusaurus/package-lock.json +0 -18029
  250. package/docusaurus/package.json +0 -47
  251. package/docusaurus/sidebars.ts +0 -155
  252. package/docusaurus/src/components/HomepageFeatures/index.tsx +0 -105
  253. package/docusaurus/src/components/HomepageFeatures/styles.module.css +0 -12
  254. package/docusaurus/src/css/custom.css +0 -169
  255. package/docusaurus/src/pages/index.module.css +0 -48
  256. package/docusaurus/src/pages/index.tsx +0 -110
  257. package/docusaurus/src/pages/markdown-page.md +0 -7
  258. package/docusaurus/static/.nojekyll +0 -0
  259. package/docusaurus/static/img/docusaurus-social-card.jpg +0 -0
  260. package/docusaurus/static/img/docusaurus.png +0 -0
  261. package/docusaurus/static/img/favicon.ico +0 -0
  262. package/docusaurus/static/img/logo.svg +0 -10
  263. package/docusaurus/static/img/undraw_docusaurus_mountain.svg +0 -171
  264. package/docusaurus/static/img/undraw_docusaurus_react.svg +0 -170
  265. package/docusaurus/static/img/undraw_docusaurus_tree.svg +0 -40
  266. package/docusaurus/tsconfig.json +0 -8
  267. package/examples/README.md +0 -112
  268. package/examples/error-handling/README.md +0 -150
  269. package/examples/error-handling/payment-processor.vague +0 -287
  270. package/examples/github-sync/README.md +0 -74
  271. package/examples/github-sync/fetch-issues.vague +0 -47
  272. package/examples/github-sync/fetch-prs.vague +0 -40
  273. package/examples/github-sync/mission.vague +0 -101
  274. package/examples/github-sync/normalize.vague +0 -70
  275. package/examples/jsonplaceholder/README.md +0 -28
  276. package/examples/jsonplaceholder/posts.vague +0 -48
  277. package/examples/petstore/README.md +0 -35
  278. package/examples/petstore/openapi.yaml +0 -97
  279. package/examples/petstore/sync.vague +0 -52
  280. package/examples/temporal-comparison/README.md +0 -297
  281. package/examples/temporal-comparison/reconciliation.vague +0 -355
  282. package/examples/temporal-comparison/temporal/activities/index.ts +0 -8
  283. package/examples/temporal-comparison/temporal/activities/shipstation.ts +0 -225
  284. package/examples/temporal-comparison/temporal/activities/shopify.ts +0 -257
  285. package/examples/temporal-comparison/temporal/activities/storage.ts +0 -198
  286. package/examples/temporal-comparison/temporal/activities/stripe.ts +0 -169
  287. package/examples/temporal-comparison/temporal/activities/validation.ts +0 -205
  288. package/examples/temporal-comparison/temporal/client/schedule.ts +0 -218
  289. package/examples/temporal-comparison/temporal/config/retry.ts +0 -63
  290. package/examples/temporal-comparison/temporal/types/index.ts +0 -129
  291. package/examples/temporal-comparison/temporal/workers/main.ts +0 -130
  292. package/examples/temporal-comparison/temporal/workflows/orderReconciliation.ts +0 -262
  293. package/examples/xero/README.md +0 -88
  294. package/examples/xero/invoices.vague +0 -189
  295. package/src/api-integration.test.ts +0 -954
  296. package/src/ast/index.ts +0 -1
  297. package/src/ast/nodes.ts +0 -310
  298. package/src/auth/auth.test.ts +0 -326
  299. package/src/auth/circuit-breaker.test.ts +0 -390
  300. package/src/auth/circuit-breaker.ts +0 -379
  301. package/src/auth/credentials.test.ts +0 -273
  302. package/src/auth/credentials.ts +0 -246
  303. package/src/auth/index.ts +0 -40
  304. package/src/auth/oauth2-provider.ts +0 -177
  305. package/src/auth/rate-limiter.ts +0 -459
  306. package/src/auth/token-store.ts +0 -177
  307. package/src/auth/types.ts +0 -159
  308. package/src/benchmark/e2e.bench.ts +0 -288
  309. package/src/benchmark/evaluator.bench.ts +0 -331
  310. package/src/benchmark/fixtures.ts +0 -295
  311. package/src/benchmark/index.ts +0 -108
  312. package/src/benchmark/lexer.bench.ts +0 -69
  313. package/src/benchmark/parser.bench.ts +0 -103
  314. package/src/benchmark/resilience.bench.ts +0 -193
  315. package/src/benchmark/store.bench.ts +0 -147
  316. package/src/benchmark/utils.ts +0 -230
  317. package/src/cli.ts +0 -313
  318. package/src/errors/errors.test.ts +0 -234
  319. package/src/errors/index.ts +0 -223
  320. package/src/execution/execution.test.ts +0 -307
  321. package/src/execution/index.ts +0 -21
  322. package/src/execution/state.ts +0 -207
  323. package/src/execution/store.ts +0 -188
  324. package/src/index.ts +0 -169
  325. package/src/integration.test.ts +0 -192
  326. package/src/interpreter/context.ts +0 -57
  327. package/src/interpreter/evaluator.test.ts +0 -796
  328. package/src/interpreter/evaluator.ts +0 -245
  329. package/src/interpreter/executor.ts +0 -946
  330. package/src/interpreter/fetch-handler.ts +0 -302
  331. package/src/interpreter/http.test.ts +0 -423
  332. package/src/interpreter/http.ts +0 -308
  333. package/src/interpreter/index.ts +0 -32
  334. package/src/interpreter/pagination.ts +0 -207
  335. package/src/interpreter/progress.test.ts +0 -276
  336. package/src/interpreter/schema-matcher.test.ts +0 -160
  337. package/src/interpreter/schema-matcher.ts +0 -168
  338. package/src/interpreter/signals.ts +0 -73
  339. package/src/interpreter/step-handlers/for-handler.ts +0 -65
  340. package/src/interpreter/step-handlers/index.ts +0 -17
  341. package/src/interpreter/step-handlers/map-handler.ts +0 -24
  342. package/src/interpreter/step-handlers/match-handler.ts +0 -101
  343. package/src/interpreter/step-handlers/store-handler.ts +0 -78
  344. package/src/interpreter/step-handlers/types.ts +0 -17
  345. package/src/interpreter/step-handlers/validate-handler.ts +0 -30
  346. package/src/interpreter/step-handlers/webhook-handler.ts +0 -142
  347. package/src/lexer/index.ts +0 -18
  348. package/src/lexer/lexer.test.ts +0 -316
  349. package/src/lexer/tokens.ts +0 -179
  350. package/src/loader/index.ts +0 -288
  351. package/src/loader/loader.test.ts +0 -360
  352. package/src/oas/index.ts +0 -4
  353. package/src/oas/loader.ts +0 -126
  354. package/src/oas/oas.test.ts +0 -254
  355. package/src/oas/validator.ts +0 -299
  356. package/src/parser/base.ts +0 -124
  357. package/src/parser/expressions.test.ts +0 -525
  358. package/src/parser/expressions.ts +0 -314
  359. package/src/parser/index.ts +0 -3
  360. package/src/parser/match.test.ts +0 -296
  361. package/src/parser/parser.test.ts +0 -739
  362. package/src/parser/parser.ts +0 -1469
  363. package/src/parser/schedule.test.ts +0 -287
  364. package/src/parser/webhook.test.ts +0 -248
  365. package/src/plugin.ts +0 -83
  366. package/src/scheduler/cron-parser.test.ts +0 -236
  367. package/src/scheduler/cron-parser.ts +0 -236
  368. package/src/scheduler/index.ts +0 -10
  369. package/src/scheduler/scheduler.ts +0 -443
  370. package/src/scheduler/types.ts +0 -71
  371. package/src/stores/factory.ts +0 -104
  372. package/src/stores/file.test.ts +0 -276
  373. package/src/stores/file.ts +0 -211
  374. package/src/stores/index.ts +0 -6
  375. package/src/stores/memory.test.ts +0 -238
  376. package/src/stores/memory.ts +0 -63
  377. package/src/stores/postgrest.test.ts +0 -488
  378. package/src/stores/postgrest.ts +0 -263
  379. package/src/stores/stores.test.ts +0 -197
  380. package/src/stores/types.ts +0 -58
  381. package/src/sync/index.ts +0 -16
  382. package/src/sync/state.ts +0 -126
  383. package/src/sync/store.ts +0 -139
  384. package/src/sync/sync.test.ts +0 -271
  385. package/src/utils/async.ts +0 -10
  386. package/src/utils/file.ts +0 -106
  387. package/src/utils/index.ts +0 -14
  388. package/src/utils/logger.ts +0 -53
  389. package/src/utils/path.ts +0 -47
  390. package/src/webhook/index.ts +0 -15
  391. package/src/webhook/server.test.ts +0 -253
  392. package/src/webhook/server.ts +0 -389
  393. package/src/webhook/store.ts +0 -239
  394. package/src/webhook/types.ts +0 -93
  395. package/tsconfig.json +0 -17
  396. package/vitest.config.ts +0 -39
@@ -1,239 +0,0 @@
1
- /**
2
- * Webhook Store
3
- *
4
- * Stores webhook registrations and received events.
5
- * Supports both in-memory and file-based persistence.
6
- */
7
-
8
- import { mkdir, readFile, writeFile, readdir, unlink } from 'node:fs/promises';
9
- import { join } from 'node:path';
10
- import type { WebhookRegistration, WebhookEvent } from './types.js';
11
-
12
- /**
13
- * Interface for webhook storage
14
- */
15
- export interface WebhookStore {
16
- /** Save a webhook registration */
17
- saveRegistration(registration: WebhookRegistration): Promise<void>;
18
- /** Get a registration by ID */
19
- getRegistration(id: string): Promise<WebhookRegistration | undefined>;
20
- /** Get a registration by path */
21
- getRegistrationByPath(path: string): Promise<WebhookRegistration | undefined>;
22
- /** Delete a registration */
23
- deleteRegistration(id: string): Promise<void>;
24
- /** List all registrations */
25
- listRegistrations(): Promise<WebhookRegistration[]>;
26
- /** Save a webhook event */
27
- saveEvent(event: WebhookEvent): Promise<void>;
28
- /** Get events for a registration */
29
- getEvents(registrationId: string): Promise<WebhookEvent[]>;
30
- /** Delete events for a registration */
31
- deleteEvents(registrationId: string): Promise<void>;
32
- /** Clean up expired registrations */
33
- cleanupExpired(): Promise<number>;
34
- }
35
-
36
- /**
37
- * In-memory webhook store
38
- */
39
- export class MemoryWebhookStore implements WebhookStore {
40
- private registrations: Map<string, WebhookRegistration> = new Map();
41
- private events: Map<string, WebhookEvent[]> = new Map();
42
- private pathIndex: Map<string, string> = new Map(); // path -> registrationId
43
-
44
- async saveRegistration(registration: WebhookRegistration): Promise<void> {
45
- this.registrations.set(registration.id, registration);
46
- this.pathIndex.set(registration.path, registration.id);
47
- }
48
-
49
- async getRegistration(id: string): Promise<WebhookRegistration | undefined> {
50
- return this.registrations.get(id);
51
- }
52
-
53
- async getRegistrationByPath(path: string): Promise<WebhookRegistration | undefined> {
54
- const id = this.pathIndex.get(path);
55
- if (!id) return undefined;
56
- return this.registrations.get(id);
57
- }
58
-
59
- async deleteRegistration(id: string): Promise<void> {
60
- const reg = this.registrations.get(id);
61
- if (reg) {
62
- this.pathIndex.delete(reg.path);
63
- }
64
- this.registrations.delete(id);
65
- }
66
-
67
- async listRegistrations(): Promise<WebhookRegistration[]> {
68
- return Array.from(this.registrations.values());
69
- }
70
-
71
- async saveEvent(event: WebhookEvent): Promise<void> {
72
- const events = this.events.get(event.registrationId) ?? [];
73
- events.push(event);
74
- this.events.set(event.registrationId, events);
75
- }
76
-
77
- async getEvents(registrationId: string): Promise<WebhookEvent[]> {
78
- return this.events.get(registrationId) ?? [];
79
- }
80
-
81
- async deleteEvents(registrationId: string): Promise<void> {
82
- this.events.delete(registrationId);
83
- }
84
-
85
- async cleanupExpired(): Promise<number> {
86
- const now = new Date();
87
- let cleaned = 0;
88
-
89
- for (const [id, reg] of this.registrations) {
90
- if (reg.expiresAt < now) {
91
- await this.deleteRegistration(id);
92
- await this.deleteEvents(id);
93
- cleaned++;
94
- }
95
- }
96
-
97
- return cleaned;
98
- }
99
- }
100
-
101
- /**
102
- * File-based webhook store for persistence across restarts
103
- */
104
- export class FileWebhookStore implements WebhookStore {
105
- private baseDir: string;
106
- private registrationsDir: string;
107
- private eventsDir: string;
108
- private initialized = false;
109
-
110
- constructor(baseDir = '.reqon-data/webhooks') {
111
- this.baseDir = baseDir;
112
- this.registrationsDir = join(baseDir, 'registrations');
113
- this.eventsDir = join(baseDir, 'events');
114
- }
115
-
116
- private async ensureInit(): Promise<void> {
117
- if (this.initialized) return;
118
- await mkdir(this.registrationsDir, { recursive: true });
119
- await mkdir(this.eventsDir, { recursive: true });
120
- this.initialized = true;
121
- }
122
-
123
- async saveRegistration(registration: WebhookRegistration): Promise<void> {
124
- await this.ensureInit();
125
- const filePath = join(this.registrationsDir, `${registration.id}.json`);
126
- await writeFile(filePath, JSON.stringify(registration, null, 2));
127
- }
128
-
129
- async getRegistration(id: string): Promise<WebhookRegistration | undefined> {
130
- await this.ensureInit();
131
- try {
132
- const filePath = join(this.registrationsDir, `${id}.json`);
133
- const content = await readFile(filePath, 'utf-8');
134
- const data = JSON.parse(content);
135
- return {
136
- ...data,
137
- createdAt: new Date(data.createdAt),
138
- expiresAt: new Date(data.expiresAt),
139
- };
140
- } catch {
141
- return undefined;
142
- }
143
- }
144
-
145
- async getRegistrationByPath(path: string): Promise<WebhookRegistration | undefined> {
146
- const registrations = await this.listRegistrations();
147
- return registrations.find((r) => r.path === path);
148
- }
149
-
150
- async deleteRegistration(id: string): Promise<void> {
151
- await this.ensureInit();
152
- try {
153
- const filePath = join(this.registrationsDir, `${id}.json`);
154
- await unlink(filePath);
155
- } catch {
156
- // Ignore if file doesn't exist
157
- }
158
- }
159
-
160
- async listRegistrations(): Promise<WebhookRegistration[]> {
161
- await this.ensureInit();
162
- try {
163
- const files = await readdir(this.registrationsDir);
164
- const registrations: WebhookRegistration[] = [];
165
-
166
- for (const file of files) {
167
- if (!file.endsWith('.json')) continue;
168
- const id = file.replace('.json', '');
169
- const reg = await this.getRegistration(id);
170
- if (reg) registrations.push(reg);
171
- }
172
-
173
- return registrations;
174
- } catch {
175
- return [];
176
- }
177
- }
178
-
179
- async saveEvent(event: WebhookEvent): Promise<void> {
180
- await this.ensureInit();
181
- const eventDir = join(this.eventsDir, event.registrationId);
182
- await mkdir(eventDir, { recursive: true });
183
- const filePath = join(eventDir, `${event.id}.json`);
184
- await writeFile(filePath, JSON.stringify(event, null, 2));
185
- }
186
-
187
- async getEvents(registrationId: string): Promise<WebhookEvent[]> {
188
- await this.ensureInit();
189
- try {
190
- const eventDir = join(this.eventsDir, registrationId);
191
- const files = await readdir(eventDir);
192
- const events: WebhookEvent[] = [];
193
-
194
- for (const file of files) {
195
- if (!file.endsWith('.json')) continue;
196
- const filePath = join(eventDir, file);
197
- const content = await readFile(filePath, 'utf-8');
198
- const data = JSON.parse(content);
199
- events.push({
200
- ...data,
201
- receivedAt: new Date(data.receivedAt),
202
- });
203
- }
204
-
205
- return events.sort((a, b) => a.receivedAt.getTime() - b.receivedAt.getTime());
206
- } catch {
207
- return [];
208
- }
209
- }
210
-
211
- async deleteEvents(registrationId: string): Promise<void> {
212
- await this.ensureInit();
213
- try {
214
- const eventDir = join(this.eventsDir, registrationId);
215
- const files = await readdir(eventDir);
216
- for (const file of files) {
217
- await unlink(join(eventDir, file));
218
- }
219
- } catch {
220
- // Ignore if directory doesn't exist
221
- }
222
- }
223
-
224
- async cleanupExpired(): Promise<number> {
225
- const now = new Date();
226
- const registrations = await this.listRegistrations();
227
- let cleaned = 0;
228
-
229
- for (const reg of registrations) {
230
- if (reg.expiresAt < now) {
231
- await this.deleteRegistration(reg.id);
232
- await this.deleteEvents(reg.id);
233
- cleaned++;
234
- }
235
- }
236
-
237
- return cleaned;
238
- }
239
- }
@@ -1,93 +0,0 @@
1
- /**
2
- * Webhook Module Types
3
- *
4
- * Types for webhook server and storage components.
5
- */
6
-
7
- /**
8
- * Represents a pending webhook registration
9
- */
10
- export interface WebhookRegistration {
11
- /** Unique ID for this webhook registration */
12
- id: string;
13
- /** Execution ID that registered this webhook */
14
- executionId: string;
15
- /** Path for the webhook endpoint */
16
- path: string;
17
- /** When the registration was created */
18
- createdAt: Date;
19
- /** When the registration expires */
20
- expiresAt: Date;
21
- /** Number of events expected */
22
- expectedEvents: number;
23
- /** Number of events received so far */
24
- receivedEvents: number;
25
- /** Filter expression (serialized) */
26
- filter?: string;
27
- }
28
-
29
- /**
30
- * Represents a received webhook event
31
- */
32
- export interface WebhookEvent {
33
- /** Unique ID for this event */
34
- id: string;
35
- /** Registration ID this event belongs to */
36
- registrationId: string;
37
- /** Received timestamp */
38
- receivedAt: Date;
39
- /** HTTP method used */
40
- method: string;
41
- /** Request headers */
42
- headers: Record<string, string>;
43
- /** Request body (parsed if JSON) */
44
- body: unknown;
45
- /** Raw body string */
46
- rawBody: string;
47
- /** Query parameters */
48
- query: Record<string, string>;
49
- }
50
-
51
- /**
52
- * Configuration for the webhook server
53
- */
54
- export interface WebhookServerConfig {
55
- /** Port to listen on (default: 3000) */
56
- port?: number;
57
- /** Host to bind to (default: '0.0.0.0') */
58
- host?: string;
59
- /** Base URL for webhook endpoints (e.g., 'https://example.com/webhooks') */
60
- baseUrl?: string;
61
- /** Default timeout for webhook registrations in ms (default: 300000 = 5 min) */
62
- defaultTimeout?: number;
63
- /** Enable verbose logging */
64
- verbose?: boolean;
65
- }
66
-
67
- /**
68
- * Callbacks for webhook server events
69
- */
70
- export interface WebhookServerCallbacks {
71
- /** Called when a webhook is received */
72
- onWebhookReceived?: (event: WebhookEvent) => void;
73
- /** Called when a registration is created */
74
- onRegistrationCreated?: (registration: WebhookRegistration) => void;
75
- /** Called when a registration expires */
76
- onRegistrationExpired?: (registration: WebhookRegistration) => void;
77
- /** Called when all expected events are received */
78
- onRegistrationComplete?: (registration: WebhookRegistration, events: WebhookEvent[]) => void;
79
- }
80
-
81
- /**
82
- * Result of waiting for webhook events
83
- */
84
- export interface WaitResult {
85
- /** Whether the wait was successful */
86
- success: boolean;
87
- /** Events received */
88
- events: WebhookEvent[];
89
- /** Error message if failed */
90
- error?: string;
91
- /** Whether timed out */
92
- timedOut?: boolean;
93
- }
package/tsconfig.json DELETED
@@ -1,17 +0,0 @@
1
- {
2
- "compilerOptions": {
3
- "target": "ES2022",
4
- "module": "NodeNext",
5
- "moduleResolution": "NodeNext",
6
- "declaration": true,
7
- "outDir": "./dist",
8
- "rootDir": "./src",
9
- "strict": true,
10
- "esModuleInterop": true,
11
- "skipLibCheck": true,
12
- "forceConsistentCasingInFileNames": true,
13
- "resolveJsonModule": true
14
- },
15
- "include": ["src/**/*"],
16
- "exclude": ["node_modules", "dist", "src/benchmark/**/*", "src/**/*.test.ts"]
17
- }
package/vitest.config.ts DELETED
@@ -1,39 +0,0 @@
1
- import { defineConfig } from 'vitest/config';
2
-
3
- export default defineConfig({
4
- test: {
5
- // Test file patterns
6
- include: ['src/**/*.test.ts'],
7
-
8
- // Coverage configuration
9
- coverage: {
10
- provider: 'v8',
11
- reporter: ['text', 'text-summary', 'html'],
12
- reportsDirectory: './coverage',
13
-
14
- // Include all source files
15
- include: ['src/**/*.ts'],
16
-
17
- // Exclude test files and index re-exports
18
- exclude: [
19
- 'src/**/*.test.ts',
20
- 'src/**/index.ts',
21
- 'src/cli.ts', // CLI is hard to test
22
- ],
23
-
24
- // Thresholds (can be made stricter over time)
25
- thresholds: {
26
- statements: 50,
27
- branches: 40,
28
- functions: 50,
29
- lines: 50,
30
- },
31
- },
32
-
33
- // Global test timeout
34
- testTimeout: 10000,
35
-
36
- // Environment
37
- environment: 'node',
38
- },
39
- });