reqon-dsl 0.2.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 (388) hide show
  1. package/.claude/settings.local.json +31 -0
  2. package/.claude/skills/api-integration.md +125 -0
  3. package/.claude/skills/database-schema.md +51 -0
  4. package/.claude/skills/dsl-design.md +80 -0
  5. package/.claude/skills/property-testing.md +143 -0
  6. package/.claude/skills/reqon/SKILL.md +44 -0
  7. package/.claude/skills/reqon/references/examples.md +206 -0
  8. package/.claude/skills/reqon/references/syntax.md +263 -0
  9. package/.claude/skills/vscode-extension.md +113 -0
  10. package/.github/dependabot.yml +32 -0
  11. package/.github/pull_request_template.md +21 -0
  12. package/.github/workflows/ci.yml +174 -0
  13. package/.github/workflows/release.yml +73 -0
  14. package/CLAUDE.md +72 -0
  15. package/CONTRIBUTING.md +161 -0
  16. package/README.md +235 -0
  17. package/TODO.md +51 -0
  18. package/dist/ast/index.d.ts +1 -0
  19. package/dist/ast/index.js +1 -0
  20. package/dist/ast/nodes.d.ts +237 -0
  21. package/dist/ast/nodes.js +12 -0
  22. package/dist/auth/auth.test.d.ts +1 -0
  23. package/dist/auth/auth.test.js +255 -0
  24. package/dist/auth/circuit-breaker.d.ts +115 -0
  25. package/dist/auth/circuit-breaker.js +267 -0
  26. package/dist/auth/credentials.d.ts +91 -0
  27. package/dist/auth/credentials.js +169 -0
  28. package/dist/auth/index.d.ts +5 -0
  29. package/dist/auth/index.js +8 -0
  30. package/dist/auth/oauth2-provider.d.ts +41 -0
  31. package/dist/auth/oauth2-provider.js +131 -0
  32. package/dist/auth/rate-limiter.d.ts +61 -0
  33. package/dist/auth/rate-limiter.js +380 -0
  34. package/dist/auth/token-store.d.ts +30 -0
  35. package/dist/auth/token-store.js +148 -0
  36. package/dist/auth/types.d.ts +142 -0
  37. package/dist/auth/types.js +1 -0
  38. package/dist/cli.d.ts +2 -0
  39. package/dist/cli.js +270 -0
  40. package/dist/errors/errors.test.d.ts +1 -0
  41. package/dist/errors/errors.test.js +165 -0
  42. package/dist/errors/index.d.ts +83 -0
  43. package/dist/errors/index.js +159 -0
  44. package/dist/execution/execution.test.d.ts +1 -0
  45. package/dist/execution/execution.test.js +246 -0
  46. package/dist/execution/index.d.ts +4 -0
  47. package/dist/execution/index.js +2 -0
  48. package/dist/execution/state.d.ts +136 -0
  49. package/dist/execution/state.js +82 -0
  50. package/dist/execution/store.d.ts +52 -0
  51. package/dist/execution/store.js +120 -0
  52. package/dist/index.d.ts +27 -0
  53. package/dist/index.js +57 -0
  54. package/dist/integration.test.d.ts +1 -0
  55. package/dist/integration.test.js +168 -0
  56. package/dist/interpreter/context.d.ts +15 -0
  57. package/dist/interpreter/context.js +29 -0
  58. package/dist/interpreter/evaluator.d.ts +5 -0
  59. package/dist/interpreter/evaluator.js +223 -0
  60. package/dist/interpreter/evaluator.test.d.ts +1 -0
  61. package/dist/interpreter/evaluator.test.js +512 -0
  62. package/dist/interpreter/executor.d.ts +131 -0
  63. package/dist/interpreter/executor.js +663 -0
  64. package/dist/interpreter/fetch-handler.d.ts +43 -0
  65. package/dist/interpreter/fetch-handler.js +203 -0
  66. package/dist/interpreter/http.d.ts +57 -0
  67. package/dist/interpreter/http.js +210 -0
  68. package/dist/interpreter/http.test.d.ts +1 -0
  69. package/dist/interpreter/http.test.js +299 -0
  70. package/dist/interpreter/index.d.ts +7 -0
  71. package/dist/interpreter/index.js +7 -0
  72. package/dist/interpreter/pagination.d.ts +63 -0
  73. package/dist/interpreter/pagination.js +155 -0
  74. package/dist/interpreter/progress.test.d.ts +1 -0
  75. package/dist/interpreter/progress.test.js +216 -0
  76. package/dist/interpreter/schema-matcher.d.ts +16 -0
  77. package/dist/interpreter/schema-matcher.js +136 -0
  78. package/dist/interpreter/schema-matcher.test.d.ts +1 -0
  79. package/dist/interpreter/schema-matcher.test.js +122 -0
  80. package/dist/interpreter/signals.d.ts +57 -0
  81. package/dist/interpreter/signals.js +73 -0
  82. package/dist/interpreter/step-handlers/for-handler.d.ts +17 -0
  83. package/dist/interpreter/step-handlers/for-handler.js +51 -0
  84. package/dist/interpreter/step-handlers/index.d.ts +8 -0
  85. package/dist/interpreter/step-handlers/index.js +8 -0
  86. package/dist/interpreter/step-handlers/map-handler.d.ts +10 -0
  87. package/dist/interpreter/step-handlers/map-handler.js +20 -0
  88. package/dist/interpreter/step-handlers/match-handler.d.ts +27 -0
  89. package/dist/interpreter/step-handlers/match-handler.js +61 -0
  90. package/dist/interpreter/step-handlers/store-handler.d.ts +13 -0
  91. package/dist/interpreter/step-handlers/store-handler.js +66 -0
  92. package/dist/interpreter/step-handlers/types.d.ts +15 -0
  93. package/dist/interpreter/step-handlers/types.js +1 -0
  94. package/dist/interpreter/step-handlers/validate-handler.d.ts +10 -0
  95. package/dist/interpreter/step-handlers/validate-handler.js +26 -0
  96. package/dist/interpreter/step-handlers/webhook-handler.d.ts +36 -0
  97. package/dist/interpreter/step-handlers/webhook-handler.js +104 -0
  98. package/dist/lexer/index.d.ts +10 -0
  99. package/dist/lexer/index.js +12 -0
  100. package/dist/lexer/lexer.d.ts +24 -0
  101. package/dist/lexer/lexer.js +264 -0
  102. package/dist/lexer/lexer.test.d.ts +1 -0
  103. package/dist/lexer/lexer.test.js +259 -0
  104. package/dist/lexer/tokens.d.ts +69 -0
  105. package/dist/lexer/tokens.js +146 -0
  106. package/dist/loader/index.d.ts +36 -0
  107. package/dist/loader/index.js +220 -0
  108. package/dist/loader/loader.test.d.ts +1 -0
  109. package/dist/loader/loader.test.js +287 -0
  110. package/dist/oas/index.d.ts +4 -0
  111. package/dist/oas/index.js +2 -0
  112. package/dist/oas/loader.d.ts +21 -0
  113. package/dist/oas/loader.js +82 -0
  114. package/dist/oas/oas.test.d.ts +1 -0
  115. package/dist/oas/oas.test.js +218 -0
  116. package/dist/oas/validator.d.ts +12 -0
  117. package/dist/oas/validator.js +227 -0
  118. package/dist/parser/base.d.ts +33 -0
  119. package/dist/parser/base.js +97 -0
  120. package/dist/parser/expressions.d.ts +27 -0
  121. package/dist/parser/expressions.js +248 -0
  122. package/dist/parser/expressions.test.d.ts +1 -0
  123. package/dist/parser/expressions.test.js +378 -0
  124. package/dist/parser/index.d.ts +3 -0
  125. package/dist/parser/index.js +3 -0
  126. package/dist/parser/match.test.d.ts +1 -0
  127. package/dist/parser/match.test.js +254 -0
  128. package/dist/parser/parser.d.ts +68 -0
  129. package/dist/parser/parser.js +1229 -0
  130. package/dist/parser/parser.test.d.ts +1 -0
  131. package/dist/parser/parser.test.js +333 -0
  132. package/dist/parser/schedule.test.d.ts +1 -0
  133. package/dist/parser/schedule.test.js +241 -0
  134. package/dist/plugin.d.ts +35 -0
  135. package/dist/plugin.js +68 -0
  136. package/dist/scheduler/cron-parser.d.ts +32 -0
  137. package/dist/scheduler/cron-parser.js +198 -0
  138. package/dist/scheduler/cron-parser.test.d.ts +1 -0
  139. package/dist/scheduler/cron-parser.test.js +188 -0
  140. package/dist/scheduler/index.d.ts +3 -0
  141. package/dist/scheduler/index.js +2 -0
  142. package/dist/scheduler/scheduler.d.ts +81 -0
  143. package/dist/scheduler/scheduler.js +376 -0
  144. package/dist/scheduler/types.d.ts +65 -0
  145. package/dist/scheduler/types.js +1 -0
  146. package/dist/stores/factory.d.ts +36 -0
  147. package/dist/stores/factory.js +73 -0
  148. package/dist/stores/file.d.ts +60 -0
  149. package/dist/stores/file.js +173 -0
  150. package/dist/stores/file.test.d.ts +1 -0
  151. package/dist/stores/file.test.js +165 -0
  152. package/dist/stores/index.d.ts +6 -0
  153. package/dist/stores/index.js +5 -0
  154. package/dist/stores/memory.d.ts +19 -0
  155. package/dist/stores/memory.js +51 -0
  156. package/dist/stores/memory.test.d.ts +1 -0
  157. package/dist/stores/memory.test.js +157 -0
  158. package/dist/stores/postgrest.d.ts +55 -0
  159. package/dist/stores/postgrest.js +217 -0
  160. package/dist/stores/stores.test.d.ts +1 -0
  161. package/dist/stores/stores.test.js +158 -0
  162. package/dist/stores/types.d.ts +31 -0
  163. package/dist/stores/types.js +26 -0
  164. package/dist/sync/index.d.ts +4 -0
  165. package/dist/sync/index.js +2 -0
  166. package/dist/sync/state.d.ts +69 -0
  167. package/dist/sync/state.js +66 -0
  168. package/dist/sync/store.d.ts +49 -0
  169. package/dist/sync/store.js +93 -0
  170. package/dist/sync/sync.test.d.ts +1 -0
  171. package/dist/sync/sync.test.js +221 -0
  172. package/dist/utils/async.d.ts +7 -0
  173. package/dist/utils/async.js +9 -0
  174. package/dist/utils/file.d.ts +38 -0
  175. package/dist/utils/file.js +92 -0
  176. package/dist/utils/index.d.ts +4 -0
  177. package/dist/utils/index.js +4 -0
  178. package/dist/utils/logger.d.ts +34 -0
  179. package/dist/utils/logger.js +39 -0
  180. package/dist/utils/path.d.ts +12 -0
  181. package/dist/utils/path.js +41 -0
  182. package/dist/webhook/index.d.ts +8 -0
  183. package/dist/webhook/index.js +7 -0
  184. package/dist/webhook/server.d.ts +84 -0
  185. package/dist/webhook/server.js +319 -0
  186. package/dist/webhook/store.d.ts +67 -0
  187. package/dist/webhook/store.js +193 -0
  188. package/dist/webhook/types.d.ts +88 -0
  189. package/dist/webhook/types.js +6 -0
  190. package/docusaurus/README.md +41 -0
  191. package/docusaurus/docs/advanced/execution-state.md +283 -0
  192. package/docusaurus/docs/advanced/extending-reqon.md +388 -0
  193. package/docusaurus/docs/advanced/multi-file-missions.md +250 -0
  194. package/docusaurus/docs/advanced/parallel-execution.md +353 -0
  195. package/docusaurus/docs/api-reference.md +443 -0
  196. package/docusaurus/docs/authentication/api-key.md +339 -0
  197. package/docusaurus/docs/authentication/basic.md +276 -0
  198. package/docusaurus/docs/authentication/bearer.md +282 -0
  199. package/docusaurus/docs/authentication/oauth2.md +317 -0
  200. package/docusaurus/docs/authentication/overview.md +251 -0
  201. package/docusaurus/docs/cli.md +229 -0
  202. package/docusaurus/docs/core-concepts/actions.md +286 -0
  203. package/docusaurus/docs/core-concepts/missions.md +264 -0
  204. package/docusaurus/docs/core-concepts/schemas.md +353 -0
  205. package/docusaurus/docs/core-concepts/sources.md +339 -0
  206. package/docusaurus/docs/core-concepts/stores.md +332 -0
  207. package/docusaurus/docs/dsl-syntax/expressions.md +361 -0
  208. package/docusaurus/docs/dsl-syntax/fetch.md +293 -0
  209. package/docusaurus/docs/dsl-syntax/for-loops.md +324 -0
  210. package/docusaurus/docs/dsl-syntax/map.md +345 -0
  211. package/docusaurus/docs/dsl-syntax/match.md +387 -0
  212. package/docusaurus/docs/dsl-syntax/pipelines.md +397 -0
  213. package/docusaurus/docs/dsl-syntax/validate.md +401 -0
  214. package/docusaurus/docs/error-handling/dead-letter-queues.md +399 -0
  215. package/docusaurus/docs/error-handling/flow-control.md +337 -0
  216. package/docusaurus/docs/error-handling/retry-strategies.md +368 -0
  217. package/docusaurus/docs/examples.md +488 -0
  218. package/docusaurus/docs/getting-started.md +256 -0
  219. package/docusaurus/docs/http/circuit-breaker.md +401 -0
  220. package/docusaurus/docs/http/incremental-sync.md +394 -0
  221. package/docusaurus/docs/http/pagination.md +361 -0
  222. package/docusaurus/docs/http/rate-limiting.md +383 -0
  223. package/docusaurus/docs/http/requests.md +328 -0
  224. package/docusaurus/docs/http/retry.md +402 -0
  225. package/docusaurus/docs/intro.md +90 -0
  226. package/docusaurus/docs/openapi/loading-specs.md +305 -0
  227. package/docusaurus/docs/openapi/operation-calls.md +314 -0
  228. package/docusaurus/docs/openapi/overview.md +212 -0
  229. package/docusaurus/docs/openapi/response-validation.md +344 -0
  230. package/docusaurus/docs/scheduling/cron.md +305 -0
  231. package/docusaurus/docs/scheduling/daemon-mode.md +317 -0
  232. package/docusaurus/docs/scheduling/intervals.md +289 -0
  233. package/docusaurus/docs/scheduling/overview.md +231 -0
  234. package/docusaurus/docs/stores/custom-adapters.md +376 -0
  235. package/docusaurus/docs/stores/file.md +236 -0
  236. package/docusaurus/docs/stores/memory.md +193 -0
  237. package/docusaurus/docs/stores/overview.md +274 -0
  238. package/docusaurus/docs/stores/postgrest.md +316 -0
  239. package/docusaurus/docusaurus.config.ts +148 -0
  240. package/docusaurus/package-lock.json +18029 -0
  241. package/docusaurus/package.json +47 -0
  242. package/docusaurus/sidebars.ts +155 -0
  243. package/docusaurus/src/components/HomepageFeatures/index.tsx +105 -0
  244. package/docusaurus/src/components/HomepageFeatures/styles.module.css +12 -0
  245. package/docusaurus/src/css/custom.css +169 -0
  246. package/docusaurus/src/pages/index.module.css +48 -0
  247. package/docusaurus/src/pages/index.tsx +110 -0
  248. package/docusaurus/src/pages/markdown-page.md +7 -0
  249. package/docusaurus/static/.nojekyll +0 -0
  250. package/docusaurus/static/img/docusaurus-social-card.jpg +0 -0
  251. package/docusaurus/static/img/docusaurus.png +0 -0
  252. package/docusaurus/static/img/favicon.ico +0 -0
  253. package/docusaurus/static/img/logo.svg +10 -0
  254. package/docusaurus/static/img/undraw_docusaurus_mountain.svg +171 -0
  255. package/docusaurus/static/img/undraw_docusaurus_react.svg +170 -0
  256. package/docusaurus/static/img/undraw_docusaurus_tree.svg +40 -0
  257. package/docusaurus/tsconfig.json +8 -0
  258. package/examples/README.md +112 -0
  259. package/examples/error-handling/README.md +150 -0
  260. package/examples/error-handling/payment-processor.vague +287 -0
  261. package/examples/github-sync/README.md +74 -0
  262. package/examples/github-sync/fetch-issues.vague +47 -0
  263. package/examples/github-sync/fetch-prs.vague +40 -0
  264. package/examples/github-sync/mission.vague +101 -0
  265. package/examples/github-sync/normalize.vague +70 -0
  266. package/examples/jsonplaceholder/README.md +28 -0
  267. package/examples/jsonplaceholder/posts.vague +48 -0
  268. package/examples/petstore/README.md +35 -0
  269. package/examples/petstore/openapi.yaml +97 -0
  270. package/examples/petstore/sync.vague +52 -0
  271. package/examples/temporal-comparison/README.md +297 -0
  272. package/examples/temporal-comparison/reconciliation.vague +355 -0
  273. package/examples/temporal-comparison/temporal/activities/index.ts +8 -0
  274. package/examples/temporal-comparison/temporal/activities/shipstation.ts +225 -0
  275. package/examples/temporal-comparison/temporal/activities/shopify.ts +257 -0
  276. package/examples/temporal-comparison/temporal/activities/storage.ts +198 -0
  277. package/examples/temporal-comparison/temporal/activities/stripe.ts +169 -0
  278. package/examples/temporal-comparison/temporal/activities/validation.ts +205 -0
  279. package/examples/temporal-comparison/temporal/client/schedule.ts +218 -0
  280. package/examples/temporal-comparison/temporal/config/retry.ts +63 -0
  281. package/examples/temporal-comparison/temporal/types/index.ts +129 -0
  282. package/examples/temporal-comparison/temporal/workers/main.ts +130 -0
  283. package/examples/temporal-comparison/temporal/workflows/orderReconciliation.ts +262 -0
  284. package/examples/xero/README.md +88 -0
  285. package/examples/xero/invoices.vague +189 -0
  286. package/package.json +40 -0
  287. package/src/api-integration.test.ts +954 -0
  288. package/src/ast/index.ts +1 -0
  289. package/src/ast/nodes.ts +310 -0
  290. package/src/auth/auth.test.ts +326 -0
  291. package/src/auth/circuit-breaker.test.ts +390 -0
  292. package/src/auth/circuit-breaker.ts +379 -0
  293. package/src/auth/credentials.test.ts +273 -0
  294. package/src/auth/credentials.ts +246 -0
  295. package/src/auth/index.ts +40 -0
  296. package/src/auth/oauth2-provider.ts +177 -0
  297. package/src/auth/rate-limiter.ts +459 -0
  298. package/src/auth/token-store.ts +177 -0
  299. package/src/auth/types.ts +159 -0
  300. package/src/benchmark/e2e.bench.ts +288 -0
  301. package/src/benchmark/evaluator.bench.ts +331 -0
  302. package/src/benchmark/fixtures.ts +295 -0
  303. package/src/benchmark/index.ts +108 -0
  304. package/src/benchmark/lexer.bench.ts +69 -0
  305. package/src/benchmark/parser.bench.ts +103 -0
  306. package/src/benchmark/resilience.bench.ts +193 -0
  307. package/src/benchmark/store.bench.ts +147 -0
  308. package/src/benchmark/utils.ts +230 -0
  309. package/src/cli.ts +313 -0
  310. package/src/errors/errors.test.ts +234 -0
  311. package/src/errors/index.ts +223 -0
  312. package/src/execution/execution.test.ts +307 -0
  313. package/src/execution/index.ts +21 -0
  314. package/src/execution/state.ts +207 -0
  315. package/src/execution/store.ts +188 -0
  316. package/src/index.ts +169 -0
  317. package/src/integration.test.ts +192 -0
  318. package/src/interpreter/context.ts +57 -0
  319. package/src/interpreter/evaluator.test.ts +796 -0
  320. package/src/interpreter/evaluator.ts +245 -0
  321. package/src/interpreter/executor.ts +946 -0
  322. package/src/interpreter/fetch-handler.ts +302 -0
  323. package/src/interpreter/http.test.ts +423 -0
  324. package/src/interpreter/http.ts +308 -0
  325. package/src/interpreter/index.ts +32 -0
  326. package/src/interpreter/pagination.ts +207 -0
  327. package/src/interpreter/progress.test.ts +276 -0
  328. package/src/interpreter/schema-matcher.test.ts +160 -0
  329. package/src/interpreter/schema-matcher.ts +168 -0
  330. package/src/interpreter/signals.ts +73 -0
  331. package/src/interpreter/step-handlers/for-handler.ts +65 -0
  332. package/src/interpreter/step-handlers/index.ts +17 -0
  333. package/src/interpreter/step-handlers/map-handler.ts +24 -0
  334. package/src/interpreter/step-handlers/match-handler.ts +101 -0
  335. package/src/interpreter/step-handlers/store-handler.ts +78 -0
  336. package/src/interpreter/step-handlers/types.ts +17 -0
  337. package/src/interpreter/step-handlers/validate-handler.ts +30 -0
  338. package/src/interpreter/step-handlers/webhook-handler.ts +142 -0
  339. package/src/lexer/index.ts +18 -0
  340. package/src/lexer/lexer.test.ts +316 -0
  341. package/src/lexer/tokens.ts +179 -0
  342. package/src/loader/index.ts +288 -0
  343. package/src/loader/loader.test.ts +360 -0
  344. package/src/oas/index.ts +4 -0
  345. package/src/oas/loader.ts +126 -0
  346. package/src/oas/oas.test.ts +254 -0
  347. package/src/oas/validator.ts +299 -0
  348. package/src/parser/base.ts +124 -0
  349. package/src/parser/expressions.test.ts +525 -0
  350. package/src/parser/expressions.ts +314 -0
  351. package/src/parser/index.ts +3 -0
  352. package/src/parser/match.test.ts +296 -0
  353. package/src/parser/parser.test.ts +739 -0
  354. package/src/parser/parser.ts +1469 -0
  355. package/src/parser/schedule.test.ts +287 -0
  356. package/src/parser/webhook.test.ts +248 -0
  357. package/src/plugin.ts +83 -0
  358. package/src/scheduler/cron-parser.test.ts +236 -0
  359. package/src/scheduler/cron-parser.ts +236 -0
  360. package/src/scheduler/index.ts +10 -0
  361. package/src/scheduler/scheduler.ts +443 -0
  362. package/src/scheduler/types.ts +71 -0
  363. package/src/stores/factory.ts +104 -0
  364. package/src/stores/file.test.ts +276 -0
  365. package/src/stores/file.ts +211 -0
  366. package/src/stores/index.ts +6 -0
  367. package/src/stores/memory.test.ts +238 -0
  368. package/src/stores/memory.ts +63 -0
  369. package/src/stores/postgrest.test.ts +488 -0
  370. package/src/stores/postgrest.ts +263 -0
  371. package/src/stores/stores.test.ts +197 -0
  372. package/src/stores/types.ts +58 -0
  373. package/src/sync/index.ts +16 -0
  374. package/src/sync/state.ts +126 -0
  375. package/src/sync/store.ts +139 -0
  376. package/src/sync/sync.test.ts +271 -0
  377. package/src/utils/async.ts +10 -0
  378. package/src/utils/file.ts +106 -0
  379. package/src/utils/index.ts +14 -0
  380. package/src/utils/logger.ts +53 -0
  381. package/src/utils/path.ts +47 -0
  382. package/src/webhook/index.ts +15 -0
  383. package/src/webhook/server.test.ts +253 -0
  384. package/src/webhook/server.ts +389 -0
  385. package/src/webhook/store.ts +239 -0
  386. package/src/webhook/types.ts +93 -0
  387. package/tsconfig.json +17 -0
  388. package/vitest.config.ts +39 -0
@@ -0,0 +1,796 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import type { Expression } from 'vague-lang';
3
+ import { evaluate, evaluateToString, interpolatePath } from './evaluator.js';
4
+ import { createContext, childContext, setVariable } from './context.js';
5
+
6
+ describe('evaluate', () => {
7
+ describe('literals', () => {
8
+ it('evaluates number literal', () => {
9
+ const ctx = createContext();
10
+ const expr: Expression = { type: 'Literal', value: 42, dataType: 'number' };
11
+
12
+ expect(evaluate(expr, ctx)).toBe(42);
13
+ });
14
+
15
+ it('evaluates string literal', () => {
16
+ const ctx = createContext();
17
+ const expr: Expression = { type: 'Literal', value: 'hello', dataType: 'string' };
18
+
19
+ expect(evaluate(expr, ctx)).toBe('hello');
20
+ });
21
+
22
+ it('evaluates boolean literal', () => {
23
+ const ctx = createContext();
24
+ const trueExpr: Expression = { type: 'Literal', value: true, dataType: 'boolean' };
25
+ const falseExpr: Expression = { type: 'Literal', value: false, dataType: 'boolean' };
26
+
27
+ expect(evaluate(trueExpr, ctx)).toBe(true);
28
+ expect(evaluate(falseExpr, ctx)).toBe(false);
29
+ });
30
+
31
+ it('evaluates null literal', () => {
32
+ const ctx = createContext();
33
+ const expr: Expression = { type: 'Literal', value: null, dataType: 'null' };
34
+
35
+ expect(evaluate(expr, ctx)).toBe(null);
36
+ });
37
+ });
38
+
39
+ describe('identifiers', () => {
40
+ it('resolves variable from context', () => {
41
+ const ctx = createContext();
42
+ setVariable(ctx, 'myVar', 'hello');
43
+ const expr: Expression = { type: 'Identifier', name: 'myVar' };
44
+
45
+ expect(evaluate(expr, ctx)).toBe('hello');
46
+ });
47
+
48
+ it('resolves response special identifier', () => {
49
+ const ctx = createContext();
50
+ ctx.response = { data: 'test' };
51
+ const expr: Expression = { type: 'Identifier', name: 'response' };
52
+
53
+ expect(evaluate(expr, ctx)).toEqual({ data: 'test' });
54
+ });
55
+
56
+ it('resolves field from current object', () => {
57
+ const ctx = createContext();
58
+ const current = { name: 'Alice', age: 30 };
59
+ const expr: Expression = { type: 'Identifier', name: 'name' };
60
+
61
+ expect(evaluate(expr, ctx, current)).toBe('Alice');
62
+ });
63
+
64
+ it('resolves field from response when no current object', () => {
65
+ const ctx = createContext();
66
+ ctx.response = { name: 'Response Name' };
67
+ const expr: Expression = { type: 'Identifier', name: 'name' };
68
+
69
+ expect(evaluate(expr, ctx)).toBe('Response Name');
70
+ });
71
+
72
+ it('returns undefined for non-existent variable', () => {
73
+ const ctx = createContext();
74
+ const expr: Expression = { type: 'Identifier', name: 'nonExistent' };
75
+
76
+ expect(evaluate(expr, ctx)).toBeUndefined();
77
+ });
78
+ });
79
+
80
+ describe('qualified names (property access)', () => {
81
+ it('resolves nested properties from current', () => {
82
+ const ctx = createContext();
83
+ const current = { user: { profile: { name: 'Alice' } } };
84
+ const expr: Expression = {
85
+ type: 'QualifiedName',
86
+ parts: ['user', 'profile', 'name'],
87
+ };
88
+
89
+ expect(evaluate(expr, ctx, current)).toBe('Alice');
90
+ });
91
+
92
+ it('resolves from response when no current', () => {
93
+ const ctx = createContext();
94
+ ctx.response = { data: { items: [1, 2, 3] } };
95
+ const expr: Expression = {
96
+ type: 'QualifiedName',
97
+ parts: ['data', 'items'],
98
+ };
99
+
100
+ expect(evaluate(expr, ctx)).toEqual([1, 2, 3]);
101
+ });
102
+
103
+ it('resolves from variables', () => {
104
+ const ctx = createContext();
105
+ setVariable(ctx, 'config', { settings: { theme: 'dark' } });
106
+ const expr: Expression = {
107
+ type: 'QualifiedName',
108
+ parts: ['config', 'settings', 'theme'],
109
+ };
110
+
111
+ expect(evaluate(expr, ctx)).toBe('dark');
112
+ });
113
+ });
114
+
115
+ describe('binary expressions', () => {
116
+ it('evaluates addition', () => {
117
+ const ctx = createContext();
118
+ const expr: Expression = {
119
+ type: 'BinaryExpression',
120
+ operator: '+',
121
+ left: { type: 'Literal', value: 5, dataType: 'number' },
122
+ right: { type: 'Literal', value: 3, dataType: 'number' },
123
+ };
124
+
125
+ expect(evaluate(expr, ctx)).toBe(8);
126
+ });
127
+
128
+ it('evaluates subtraction', () => {
129
+ const ctx = createContext();
130
+ const expr: Expression = {
131
+ type: 'BinaryExpression',
132
+ operator: '-',
133
+ left: { type: 'Literal', value: 10, dataType: 'number' },
134
+ right: { type: 'Literal', value: 4, dataType: 'number' },
135
+ };
136
+
137
+ expect(evaluate(expr, ctx)).toBe(6);
138
+ });
139
+
140
+ it('evaluates multiplication', () => {
141
+ const ctx = createContext();
142
+ const expr: Expression = {
143
+ type: 'BinaryExpression',
144
+ operator: '*',
145
+ left: { type: 'Literal', value: 6, dataType: 'number' },
146
+ right: { type: 'Literal', value: 7, dataType: 'number' },
147
+ };
148
+
149
+ expect(evaluate(expr, ctx)).toBe(42);
150
+ });
151
+
152
+ it('evaluates division', () => {
153
+ const ctx = createContext();
154
+ const expr: Expression = {
155
+ type: 'BinaryExpression',
156
+ operator: '/',
157
+ left: { type: 'Literal', value: 20, dataType: 'number' },
158
+ right: { type: 'Literal', value: 4, dataType: 'number' },
159
+ };
160
+
161
+ expect(evaluate(expr, ctx)).toBe(5);
162
+ });
163
+
164
+ it('evaluates equality', () => {
165
+ const ctx = createContext();
166
+ const expr: Expression = {
167
+ type: 'BinaryExpression',
168
+ operator: '==',
169
+ left: { type: 'Literal', value: 5, dataType: 'number' },
170
+ right: { type: 'Literal', value: 5, dataType: 'number' },
171
+ };
172
+
173
+ expect(evaluate(expr, ctx)).toBe(true);
174
+ });
175
+
176
+ it('evaluates inequality', () => {
177
+ const ctx = createContext();
178
+ const expr: Expression = {
179
+ type: 'BinaryExpression',
180
+ operator: '!=',
181
+ left: { type: 'Literal', value: 5, dataType: 'number' },
182
+ right: { type: 'Literal', value: 3, dataType: 'number' },
183
+ };
184
+
185
+ expect(evaluate(expr, ctx)).toBe(true);
186
+ });
187
+
188
+ it('evaluates less than', () => {
189
+ const ctx = createContext();
190
+ const expr: Expression = {
191
+ type: 'BinaryExpression',
192
+ operator: '<',
193
+ left: { type: 'Literal', value: 3, dataType: 'number' },
194
+ right: { type: 'Literal', value: 5, dataType: 'number' },
195
+ };
196
+
197
+ expect(evaluate(expr, ctx)).toBe(true);
198
+ });
199
+
200
+ it('evaluates greater than or equal', () => {
201
+ const ctx = createContext();
202
+ const expr: Expression = {
203
+ type: 'BinaryExpression',
204
+ operator: '>=',
205
+ left: { type: 'Literal', value: 5, dataType: 'number' },
206
+ right: { type: 'Literal', value: 5, dataType: 'number' },
207
+ };
208
+
209
+ expect(evaluate(expr, ctx)).toBe(true);
210
+ });
211
+ });
212
+
213
+ describe('logical expressions', () => {
214
+ it('evaluates and (true && true)', () => {
215
+ const ctx = createContext();
216
+ const expr: Expression = {
217
+ type: 'LogicalExpression',
218
+ operator: 'and',
219
+ left: { type: 'Literal', value: true, dataType: 'boolean' },
220
+ right: { type: 'Literal', value: true, dataType: 'boolean' },
221
+ };
222
+
223
+ expect(evaluate(expr, ctx)).toBe(true);
224
+ });
225
+
226
+ it('evaluates and (true && false)', () => {
227
+ const ctx = createContext();
228
+ const expr: Expression = {
229
+ type: 'LogicalExpression',
230
+ operator: 'and',
231
+ left: { type: 'Literal', value: true, dataType: 'boolean' },
232
+ right: { type: 'Literal', value: false, dataType: 'boolean' },
233
+ };
234
+
235
+ expect(evaluate(expr, ctx)).toBe(false);
236
+ });
237
+
238
+ it('short-circuits and on falsy left', () => {
239
+ const ctx = createContext();
240
+ // If short-circuiting works, the right side should not be evaluated
241
+ const expr: Expression = {
242
+ type: 'LogicalExpression',
243
+ operator: 'and',
244
+ left: { type: 'Literal', value: false, dataType: 'boolean' },
245
+ right: { type: 'Literal', value: true, dataType: 'boolean' },
246
+ };
247
+
248
+ expect(evaluate(expr, ctx)).toBe(false);
249
+ });
250
+
251
+ it('evaluates or (false || true)', () => {
252
+ const ctx = createContext();
253
+ const expr: Expression = {
254
+ type: 'LogicalExpression',
255
+ operator: 'or',
256
+ left: { type: 'Literal', value: false, dataType: 'boolean' },
257
+ right: { type: 'Literal', value: true, dataType: 'boolean' },
258
+ };
259
+
260
+ expect(evaluate(expr, ctx)).toBe(true);
261
+ });
262
+
263
+ it('short-circuits or on truthy left', () => {
264
+ const ctx = createContext();
265
+ const expr: Expression = {
266
+ type: 'LogicalExpression',
267
+ operator: 'or',
268
+ left: { type: 'Literal', value: true, dataType: 'boolean' },
269
+ right: { type: 'Literal', value: false, dataType: 'boolean' },
270
+ };
271
+
272
+ expect(evaluate(expr, ctx)).toBe(true);
273
+ });
274
+ });
275
+
276
+ describe('not expression', () => {
277
+ it('negates true to false', () => {
278
+ const ctx = createContext();
279
+ const expr: Expression = {
280
+ type: 'NotExpression',
281
+ operand: { type: 'Literal', value: true, dataType: 'boolean' },
282
+ };
283
+
284
+ expect(evaluate(expr, ctx)).toBe(false);
285
+ });
286
+
287
+ it('negates false to true', () => {
288
+ const ctx = createContext();
289
+ const expr: Expression = {
290
+ type: 'NotExpression',
291
+ operand: { type: 'Literal', value: false, dataType: 'boolean' },
292
+ };
293
+
294
+ expect(evaluate(expr, ctx)).toBe(true);
295
+ });
296
+ });
297
+
298
+ describe('unary expressions', () => {
299
+ it('negates a number', () => {
300
+ const ctx = createContext();
301
+ const expr: Expression = {
302
+ type: 'UnaryExpression',
303
+ operator: '-',
304
+ operand: { type: 'Literal', value: 5, dataType: 'number' },
305
+ };
306
+
307
+ expect(evaluate(expr, ctx)).toBe(-5);
308
+ });
309
+
310
+ it('positive unary has no effect', () => {
311
+ const ctx = createContext();
312
+ const expr: Expression = {
313
+ type: 'UnaryExpression',
314
+ operator: '+',
315
+ operand: { type: 'Literal', value: 5, dataType: 'number' },
316
+ };
317
+
318
+ expect(evaluate(expr, ctx)).toBe(5);
319
+ });
320
+ });
321
+
322
+ describe('ternary expressions', () => {
323
+ it('returns consequent when condition is true', () => {
324
+ const ctx = createContext();
325
+ const expr: Expression = {
326
+ type: 'TernaryExpression',
327
+ condition: { type: 'Literal', value: true, dataType: 'boolean' },
328
+ consequent: { type: 'Literal', value: 'yes', dataType: 'string' },
329
+ alternate: { type: 'Literal', value: 'no', dataType: 'string' },
330
+ };
331
+
332
+ expect(evaluate(expr, ctx)).toBe('yes');
333
+ });
334
+
335
+ it('returns alternate when condition is false', () => {
336
+ const ctx = createContext();
337
+ const expr: Expression = {
338
+ type: 'TernaryExpression',
339
+ condition: { type: 'Literal', value: false, dataType: 'boolean' },
340
+ consequent: { type: 'Literal', value: 'yes', dataType: 'string' },
341
+ alternate: { type: 'Literal', value: 'no', dataType: 'string' },
342
+ };
343
+
344
+ expect(evaluate(expr, ctx)).toBe('no');
345
+ });
346
+ });
347
+
348
+ describe('match expressions', () => {
349
+ it('matches value and returns result', () => {
350
+ const ctx = createContext();
351
+ const expr: Expression = {
352
+ type: 'MatchExpression',
353
+ value: { type: 'Literal', value: 'A', dataType: 'string' },
354
+ arms: [
355
+ {
356
+ pattern: { type: 'Literal', value: 'A', dataType: 'string' },
357
+ result: { type: 'Literal', value: 'active', dataType: 'string' },
358
+ },
359
+ {
360
+ pattern: { type: 'Literal', value: 'I', dataType: 'string' },
361
+ result: { type: 'Literal', value: 'inactive', dataType: 'string' },
362
+ },
363
+ ],
364
+ };
365
+
366
+ expect(evaluate(expr, ctx)).toBe('active');
367
+ });
368
+
369
+ it('matches wildcard pattern', () => {
370
+ const ctx = createContext();
371
+ const expr: Expression = {
372
+ type: 'MatchExpression',
373
+ value: { type: 'Literal', value: 'X', dataType: 'string' },
374
+ arms: [
375
+ {
376
+ pattern: { type: 'Literal', value: 'A', dataType: 'string' },
377
+ result: { type: 'Literal', value: 'active', dataType: 'string' },
378
+ },
379
+ {
380
+ pattern: { type: 'Identifier', name: '_' },
381
+ result: { type: 'Literal', value: 'unknown', dataType: 'string' },
382
+ },
383
+ ],
384
+ };
385
+
386
+ expect(evaluate(expr, ctx)).toBe('unknown');
387
+ });
388
+
389
+ it('returns undefined when no match', () => {
390
+ const ctx = createContext();
391
+ const expr: Expression = {
392
+ type: 'MatchExpression',
393
+ value: { type: 'Literal', value: 'X', dataType: 'string' },
394
+ arms: [
395
+ {
396
+ pattern: { type: 'Literal', value: 'A', dataType: 'string' },
397
+ result: { type: 'Literal', value: 'active', dataType: 'string' },
398
+ },
399
+ ],
400
+ };
401
+
402
+ expect(evaluate(expr, ctx)).toBeUndefined();
403
+ });
404
+ });
405
+
406
+ describe('call expressions (built-in functions)', () => {
407
+ it('evaluates length function', () => {
408
+ const ctx = createContext();
409
+ const expr: Expression = {
410
+ type: 'CallExpression',
411
+ callee: 'length',
412
+ arguments: [{
413
+ type: 'OrderedSequenceType',
414
+ elements: [
415
+ { type: 'Literal', value: 1, dataType: 'number' },
416
+ { type: 'Literal', value: 2, dataType: 'number' },
417
+ { type: 'Literal', value: 3, dataType: 'number' },
418
+ { type: 'Literal', value: 4, dataType: 'number' },
419
+ { type: 'Literal', value: 5, dataType: 'number' },
420
+ ],
421
+ }],
422
+ };
423
+
424
+ expect(evaluate(expr, ctx)).toBe(5);
425
+ });
426
+
427
+ it('evaluates sum function', () => {
428
+ const ctx = createContext();
429
+ const expr: Expression = {
430
+ type: 'CallExpression',
431
+ callee: 'sum',
432
+ arguments: [{
433
+ type: 'OrderedSequenceType',
434
+ elements: [
435
+ { type: 'Literal', value: 10, dataType: 'number' },
436
+ { type: 'Literal', value: 20, dataType: 'number' },
437
+ { type: 'Literal', value: 30, dataType: 'number' },
438
+ ],
439
+ }],
440
+ };
441
+
442
+ expect(evaluate(expr, ctx)).toBe(60);
443
+ });
444
+
445
+ it('evaluates first function', () => {
446
+ const ctx = createContext();
447
+ const expr: Expression = {
448
+ type: 'CallExpression',
449
+ callee: 'first',
450
+ arguments: [{
451
+ type: 'OrderedSequenceType',
452
+ elements: [
453
+ { type: 'Literal', value: 'a', dataType: 'string' },
454
+ { type: 'Literal', value: 'b', dataType: 'string' },
455
+ { type: 'Literal', value: 'c', dataType: 'string' },
456
+ ],
457
+ }],
458
+ };
459
+
460
+ expect(evaluate(expr, ctx)).toBe('a');
461
+ });
462
+
463
+ it('evaluates last function', () => {
464
+ const ctx = createContext();
465
+ const expr: Expression = {
466
+ type: 'CallExpression',
467
+ callee: 'last',
468
+ arguments: [{
469
+ type: 'OrderedSequenceType',
470
+ elements: [
471
+ { type: 'Literal', value: 'a', dataType: 'string' },
472
+ { type: 'Literal', value: 'b', dataType: 'string' },
473
+ { type: 'Literal', value: 'c', dataType: 'string' },
474
+ ],
475
+ }],
476
+ };
477
+
478
+ expect(evaluate(expr, ctx)).toBe('c');
479
+ });
480
+
481
+ it('evaluates round function', () => {
482
+ const ctx = createContext();
483
+ const expr: Expression = {
484
+ type: 'CallExpression',
485
+ callee: 'round',
486
+ arguments: [{ type: 'Literal', value: 3.7, dataType: 'number' }],
487
+ };
488
+
489
+ expect(evaluate(expr, ctx)).toBe(4);
490
+ });
491
+
492
+ it('evaluates floor function', () => {
493
+ const ctx = createContext();
494
+ const expr: Expression = {
495
+ type: 'CallExpression',
496
+ callee: 'floor',
497
+ arguments: [{ type: 'Literal', value: 3.9, dataType: 'number' }],
498
+ };
499
+
500
+ expect(evaluate(expr, ctx)).toBe(3);
501
+ });
502
+
503
+ it('evaluates ceil function', () => {
504
+ const ctx = createContext();
505
+ const expr: Expression = {
506
+ type: 'CallExpression',
507
+ callee: 'ceil',
508
+ arguments: [{ type: 'Literal', value: 3.1, dataType: 'number' }],
509
+ };
510
+
511
+ expect(evaluate(expr, ctx)).toBe(4);
512
+ });
513
+
514
+ it('throws on unknown function', () => {
515
+ const ctx = createContext();
516
+ const expr: Expression = {
517
+ type: 'CallExpression',
518
+ callee: 'unknownFn',
519
+ arguments: [],
520
+ };
521
+
522
+ expect(() => evaluate(expr, ctx)).toThrow('Unknown function: unknownFn');
523
+ });
524
+ });
525
+
526
+ describe('is expressions (type checking)', () => {
527
+ it('checks is array - true case', () => {
528
+ const ctx = createContext();
529
+ ctx.response = [1, 2, 3];
530
+ const expr = {
531
+ type: 'IsExpression',
532
+ operand: { type: 'Identifier', name: 'response' },
533
+ typeCheck: 'array',
534
+ };
535
+
536
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
537
+ });
538
+
539
+ it('checks is array - false case', () => {
540
+ const ctx = createContext();
541
+ ctx.response = { items: [1, 2, 3] };
542
+ const expr = {
543
+ type: 'IsExpression',
544
+ operand: { type: 'Identifier', name: 'response' },
545
+ typeCheck: 'array',
546
+ };
547
+
548
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(false);
549
+ });
550
+
551
+ it('checks is object - true case', () => {
552
+ const ctx = createContext();
553
+ ctx.response = { name: 'test' };
554
+ const expr = {
555
+ type: 'IsExpression',
556
+ operand: { type: 'Identifier', name: 'response' },
557
+ typeCheck: 'object',
558
+ };
559
+
560
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
561
+ });
562
+
563
+ it('checks is object - false for array', () => {
564
+ const ctx = createContext();
565
+ ctx.response = [1, 2, 3];
566
+ const expr = {
567
+ type: 'IsExpression',
568
+ operand: { type: 'Identifier', name: 'response' },
569
+ typeCheck: 'object',
570
+ };
571
+
572
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(false);
573
+ });
574
+
575
+ it('checks is string', () => {
576
+ const ctx = createContext();
577
+ setVariable(ctx, 'name', 'Alice');
578
+ const expr = {
579
+ type: 'IsExpression',
580
+ operand: { type: 'Identifier', name: 'name' },
581
+ typeCheck: 'string',
582
+ };
583
+
584
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
585
+ });
586
+
587
+ it('checks is number', () => {
588
+ const ctx = createContext();
589
+ setVariable(ctx, 'count', 42);
590
+ const expr = {
591
+ type: 'IsExpression',
592
+ operand: { type: 'Identifier', name: 'count' },
593
+ typeCheck: 'number',
594
+ };
595
+
596
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
597
+ });
598
+
599
+ it('checks is int - true for integer', () => {
600
+ const ctx = createContext();
601
+ setVariable(ctx, 'value', 42);
602
+ const expr = {
603
+ type: 'IsExpression',
604
+ operand: { type: 'Identifier', name: 'value' },
605
+ typeCheck: 'int',
606
+ };
607
+
608
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
609
+ });
610
+
611
+ it('checks is int - false for decimal', () => {
612
+ const ctx = createContext();
613
+ setVariable(ctx, 'value', 42.5);
614
+ const expr = {
615
+ type: 'IsExpression',
616
+ operand: { type: 'Identifier', name: 'value' },
617
+ typeCheck: 'int',
618
+ };
619
+
620
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(false);
621
+ });
622
+
623
+ it('checks is boolean', () => {
624
+ const ctx = createContext();
625
+ setVariable(ctx, 'flag', true);
626
+ const expr = {
627
+ type: 'IsExpression',
628
+ operand: { type: 'Identifier', name: 'flag' },
629
+ typeCheck: 'boolean',
630
+ };
631
+
632
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
633
+ });
634
+
635
+ it('checks is null', () => {
636
+ const ctx = createContext();
637
+ setVariable(ctx, 'value', null);
638
+ const expr = {
639
+ type: 'IsExpression',
640
+ operand: { type: 'Identifier', name: 'value' },
641
+ typeCheck: 'null',
642
+ };
643
+
644
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
645
+ });
646
+
647
+ it('checks is undefined', () => {
648
+ const ctx = createContext();
649
+ const expr = {
650
+ type: 'IsExpression',
651
+ operand: { type: 'Identifier', name: 'nonExistent' },
652
+ typeCheck: 'undefined',
653
+ };
654
+
655
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
656
+ });
657
+
658
+ it('checks is date - Date object', () => {
659
+ const ctx = createContext();
660
+ setVariable(ctx, 'timestamp', new Date());
661
+ const expr = {
662
+ type: 'IsExpression',
663
+ operand: { type: 'Identifier', name: 'timestamp' },
664
+ typeCheck: 'date',
665
+ };
666
+
667
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
668
+ });
669
+
670
+ it('checks is date - ISO string', () => {
671
+ const ctx = createContext();
672
+ setVariable(ctx, 'timestamp', '2025-01-15T10:30:00Z');
673
+ const expr = {
674
+ type: 'IsExpression',
675
+ operand: { type: 'Identifier', name: 'timestamp' },
676
+ typeCheck: 'date',
677
+ };
678
+
679
+ expect(evaluate(expr as unknown as Expression, ctx)).toBe(true);
680
+ });
681
+
682
+ it('throws on unknown type', () => {
683
+ const ctx = createContext();
684
+ setVariable(ctx, 'value', 'test');
685
+ const expr = {
686
+ type: 'IsExpression',
687
+ operand: { type: 'Identifier', name: 'value' },
688
+ typeCheck: 'unknownType',
689
+ };
690
+
691
+ expect(() => evaluate(expr as unknown as Expression, ctx)).toThrow("Unknown type for 'is' check: unknownType");
692
+ });
693
+ });
694
+ });
695
+
696
+ describe('evaluateToString', () => {
697
+ it('converts number to string', () => {
698
+ const ctx = createContext();
699
+ const expr: Expression = { type: 'Literal', value: 42, dataType: 'number' };
700
+
701
+ expect(evaluateToString(expr, ctx)).toBe('42');
702
+ });
703
+
704
+ it('converts null to empty string', () => {
705
+ const ctx = createContext();
706
+ const expr: Expression = { type: 'Literal', value: null, dataType: 'null' };
707
+
708
+ expect(evaluateToString(expr, ctx)).toBe('');
709
+ });
710
+
711
+ it('converts undefined to empty string', () => {
712
+ const ctx = createContext();
713
+ const expr: Expression = { type: 'Identifier', name: 'nonExistent' };
714
+
715
+ expect(evaluateToString(expr, ctx)).toBe('');
716
+ });
717
+ });
718
+
719
+ describe('interpolatePath', () => {
720
+ it('interpolates simple variables', () => {
721
+ const ctx = createContext();
722
+ const current = { id: '123' };
723
+
724
+ const result = interpolatePath('/users/{id}', ctx, current);
725
+
726
+ expect(result).toBe('/users/123');
727
+ });
728
+
729
+ it('interpolates nested properties', () => {
730
+ const ctx = createContext();
731
+ const current = { user: { profile: { id: 'abc' } } };
732
+
733
+ const result = interpolatePath('/profiles/{user.profile.id}', ctx, current);
734
+
735
+ expect(result).toBe('/profiles/abc');
736
+ });
737
+
738
+ it('interpolates from context variables', () => {
739
+ const ctx = createContext();
740
+ setVariable(ctx, 'userId', '456');
741
+
742
+ const result = interpolatePath('/users/{userId}', ctx);
743
+
744
+ expect(result).toBe('/users/456');
745
+ });
746
+
747
+ it('handles multiple interpolations', () => {
748
+ const ctx = createContext();
749
+ const current = { org: 'acme', project: 'widget' };
750
+
751
+ const result = interpolatePath('/orgs/{org}/projects/{project}', ctx, current);
752
+
753
+ expect(result).toBe('/orgs/acme/projects/widget');
754
+ });
755
+
756
+ it('handles missing values as empty string', () => {
757
+ const ctx = createContext();
758
+
759
+ const result = interpolatePath('/users/{nonExistent}', ctx, {});
760
+
761
+ expect(result).toBe('/users/');
762
+ });
763
+ });
764
+
765
+ describe('context variable resolution', () => {
766
+ it('resolves variables from parent context', () => {
767
+ const parent = createContext();
768
+ setVariable(parent, 'parentVar', 'from parent');
769
+
770
+ const child = childContext(parent);
771
+ const expr: Expression = { type: 'Identifier', name: 'parentVar' };
772
+
773
+ expect(evaluate(expr, child)).toBe('from parent');
774
+ });
775
+
776
+ it('child variables shadow parent variables', () => {
777
+ const parent = createContext();
778
+ setVariable(parent, 'sharedVar', 'parent value');
779
+
780
+ const child = childContext(parent);
781
+ setVariable(child, 'sharedVar', 'child value');
782
+
783
+ const expr: Expression = { type: 'Identifier', name: 'sharedVar' };
784
+
785
+ expect(evaluate(expr, child)).toBe('child value');
786
+ expect(evaluate(expr, parent)).toBe('parent value');
787
+ });
788
+
789
+ it('shares stores between parent and child', () => {
790
+ const parent = createContext();
791
+ const child = childContext(parent);
792
+
793
+ expect(child.stores).toBe(parent.stores);
794
+ expect(child.sources).toBe(parent.sources);
795
+ });
796
+ });