reqon-dsl 0.2.0 → 0.3.0

package/src/parser/parser.test.ts

@@ -1,739 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { ReqonLexer } from '../lexer/index.js';
-import { ReqonParser } from './parser.js';
-
-describe('ReqonParser', () => {
-  function parse(source: string) {
-    const lexer = new ReqonLexer(source);
-    const tokens = lexer.tokenize();
-    const parser = new ReqonParser(tokens);
-    return parser.parse();
-  }
-
-  it('parses a simple mission', () => {
-    const source = `
-      mission TestMission {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store items: memory("items")
-
-        action FetchItems {
-          get "/items"
-
-          store response -> items {
-            key: .id
-          }
-        }
-
-        run FetchItems
-      }
-    `;
-
-    const program = parse(source);
-
-    expect(program.type).toBe('ReqonProgram');
-    expect(program.statements).toHaveLength(1);
-
-    const mission = program.statements[0];
-    expect(mission.type).toBe('MissionDefinition');
-
-    if (mission.type === 'MissionDefinition') {
-      expect(mission.name).toBe('TestMission');
-      expect(mission.sources).toHaveLength(1);
-      expect(mission.stores).toHaveLength(1);
-      expect(mission.actions).toHaveLength(1);
-      expect(mission.pipeline.stages).toHaveLength(1);
-    }
-  });
-
-  it('parses fetch with pagination', () => {
-    const source = `
-      mission PaginatedFetch {
-        source API {
-          auth: oauth2,
-          base: "https://api.example.com"
-        }
-
-        store items: memory("items")
-
-        action FetchAll {
-          get "/items" {
-            paginate: offset(page, 50),
-            until: response.items.length == 0
-          }
-
-          store response.items -> items {
-            key: .id
-          }
-        }
-
-        run FetchAll
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      const action = mission.actions[0];
-      const fetchStep = action.steps[0];
-
-      if (fetchStep.type === 'FetchStep') {
-        expect(fetchStep.paginate).toBeDefined();
-        expect(fetchStep.paginate?.type).toBe('offset');
-        expect(fetchStep.paginate?.pageSize).toBe(50);
-        expect(fetchStep.until).toBeDefined();
-      }
-    }
-  });
-
-  it('parses for loops with conditions', () => {
-    const source = `
-      mission IterateItems {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store items: memory("items")
-
-        action ProcessItems {
-          for item in items where .status == "pending" {
-            get "/items/{item.id}"
-
-            store response -> items {
-              key: .id,
-              upsert: true
-            }
-          }
-        }
-
-        run ProcessItems
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      const action = mission.actions[0];
-      const forStep = action.steps[0];
-
-      if (forStep.type === 'ForStep') {
-        expect(forStep.variable).toBe('item');
-        expect(forStep.condition).toBeDefined();
-        expect(forStep.steps).toHaveLength(2);
-      }
-    }
-  });
-
-  it('parses map steps with match expressions', () => {
-    const source = `
-      mission MapItems {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store raw: memory("raw")
-        store normalized: memory("normalized")
-
-        action Normalize {
-          for item in raw {
-            map item -> StandardItem {
-              id: .external_id,
-              status: match .state {
-                "active" => "enabled",
-                "inactive" => "disabled",
-                _ => "unknown"
-              }
-            }
-
-            store response -> normalized {
-              key: .id
-            }
-          }
-        }
-
-        run Normalize
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      const action = mission.actions[0];
-      const forStep = action.steps[0];
-
-      if (forStep.type === 'ForStep') {
-        const mapStep = forStep.steps[0];
-        if (mapStep.type === 'MapStep') {
-          expect(mapStep.targetSchema).toBe('StandardItem');
-          expect(mapStep.mappings).toHaveLength(2);
-        }
-      }
-    }
-  });
-
-  it('parses validation steps', () => {
-    const source = `
-      mission ValidateData {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store data: memory("data")
-
-        action Fetch {
-          get "/data"
-
-          validate response {
-            assume length(.items) > 0,
-            assume .count > 0
-          }
-
-          store response.items -> data {
-            key: .id
-          }
-        }
-
-        run Fetch
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      const action = mission.actions[0];
-      const validateStep = action.steps[1];
-
-      if (validateStep.type === 'ValidateStep') {
-        expect(validateStep.constraints).toHaveLength(2);
-      }
-    }
-  });
-
-  it('parses pipeline with multiple stages', () => {
-    const source = `
-      mission MultiStage {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store data: memory("data")
-
-        action Step1 {
-          get "/step1"
-          store response -> data { key: .id }
-        }
-
-        action Step2 {
-          get "/step2"
-          store response -> data { key: .id }
-        }
-
-        action Step3 {
-          get "/step3"
-          store response -> data { key: .id }
-        }
-
-        run Step1 then Step2 then Step3
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      expect(mission.pipeline.stages).toHaveLength(3);
-      expect(mission.pipeline.stages[0].action).toBe('Step1');
-      expect(mission.pipeline.stages[1].action).toBe('Step2');
-      expect(mission.pipeline.stages[2].action).toBe('Step3');
-    }
-  });
-
-  it('parses parallel stages with bracket syntax', () => {
-    const source = `
-      mission ParallelSync {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store orders: memory("orders")
-        store payments: memory("payments")
-        store reconciled: memory("reconciled")
-
-        action FetchOrders {
-          get "/orders"
-          store response -> orders { key: .id }
-        }
-
-        action FetchPayments {
-          get "/payments"
-          store response -> payments { key: .id }
-        }
-
-        action Reconcile {
-          get "/reconcile"
-          store response -> reconciled { key: .id }
-        }
-
-        run [FetchOrders, FetchPayments] then Reconcile
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      expect(mission.pipeline.stages).toHaveLength(2);
-
-      // First stage is parallel
-      const parallelStage = mission.pipeline.stages[0];
-      expect(parallelStage.actions).toBeDefined();
-      expect(parallelStage.actions).toEqual(['FetchOrders', 'FetchPayments']);
-      expect(parallelStage.action).toBeUndefined();
-
-      // Second stage is sequential
-      const sequentialStage = mission.pipeline.stages[1];
-      expect(sequentialStage.action).toBe('Reconcile');
-      expect(sequentialStage.actions).toBeUndefined();
-    }
-  });
-
-  it('parses multiple parallel stages', () => {
-    const source = `
-      mission ComplexPipeline {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store data: memory("data")
-
-        action A { get "/a" }
-        action B { get "/b" }
-        action C { get "/c" }
-        action D { get "/d" }
-        action E { get "/e" }
-
-        run A then [B, C, D] then E
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      expect(mission.pipeline.stages).toHaveLength(3);
-
-      expect(mission.pipeline.stages[0].action).toBe('A');
-      expect(mission.pipeline.stages[1].actions).toEqual(['B', 'C', 'D']);
-      expect(mission.pipeline.stages[2].action).toBe('E');
-    }
-  });
-
-  it('parses parallel stage with three actions', () => {
-    const source = `
-      mission TripleParallel {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store data: memory("data")
-
-        action X { get "/x" }
-        action Y { get "/y" }
-        action Z { get "/z" }
-
-        run [X, Y, Z]
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      expect(mission.pipeline.stages).toHaveLength(1);
-      expect(mission.pipeline.stages[0].actions).toEqual(['X', 'Y', 'Z']);
-    }
-  });
-
-  it('parses let statements in actions', () => {
-    const source = `
-      mission TestLet {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store items: memory("items")
-
-        action ProcessItems {
-          let baseUrl = "https://api.example.com"
-          let pageSize = 50
-          let config = { enabled: true }
-
-          get "/items"
-
-          let itemCount = length(response.items)
-
-          store response -> items {
-            key: .id
-          }
-        }
-
-        run ProcessItems
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      const action = mission.actions[0];
-      expect(action.steps).toHaveLength(5);
-
-      const letStep1 = action.steps[0];
-      expect(letStep1.type).toBe('LetStep');
-      if (letStep1.type === 'LetStep') {
-        expect(letStep1.name).toBe('baseUrl');
-      }
-
-      const letStep2 = action.steps[1];
-      expect(letStep2.type).toBe('LetStep');
-      if (letStep2.type === 'LetStep') {
-        expect(letStep2.name).toBe('pageSize');
-      }
-
-      const letStep3 = action.steps[2];
-      expect(letStep3.type).toBe('LetStep');
-      if (letStep3.type === 'LetStep') {
-        expect(letStep3.name).toBe('config');
-      }
-
-      const fetchStep = action.steps[3];
-      expect(fetchStep.type).toBe('FetchStep');
-
-      const letStep4 = action.steps[4];
-      expect(letStep4.type).toBe('LetStep');
-      if (letStep4.type === 'LetStep') {
-        expect(letStep4.name).toBe('itemCount');
-      }
-    }
-  });
-
-  it('parses let statements in for loops', () => {
-    const source = `
-      mission TestLetInLoop {
-        source API {
-          auth: bearer,
-          base: "https://api.example.com"
-        }
-
-        store items: memory("items")
-
-        action ProcessItems {
-          for item in items {
-            let itemId = item.id
-            get "/items/{itemId}"
-          }
-        }
-
-        run ProcessItems
-      }
-    `;
-
-    const program = parse(source);
-    const mission = program.statements[0];
-
-    if (mission.type === 'MissionDefinition') {
-      const action = mission.actions[0];
-      const forStep = action.steps[0];
-
-      if (forStep.type === 'ForStep') {
-        expect(forStep.steps).toHaveLength(2);
-
-        const letStep = forStep.steps[0];
-        expect(letStep.type).toBe('LetStep');
-        if (letStep.type === 'LetStep') {
-          expect(letStep.name).toBe('itemId');
-        }
-      }
-    }
-  });
-
-  // ============================================
-  // Parse-time validation tests
-  // ============================================
-
-  describe('parse-time validation', () => {
-    it('throws error for undefined store reference', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-
-          action FetchItems {
-            get "/items"
-            store response -> nonexistent { key: .id }
-          }
-
-          run FetchItems
-        }
-      `;
-
-      expect(() => parse(source)).toThrow(/Store 'nonexistent' is not defined/);
-    });
-
-    it('throws error for undefined action in pipeline', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-
-          action FetchItems {
-            get "/items"
-            store response -> items { key: .id }
-          }
-
-          run NonexistentAction
-        }
-      `;
-
-      expect(() => parse(source)).toThrow(/Action 'NonexistentAction' is not defined/);
-    });
-
-    it('throws error for undefined action in parallel pipeline', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-
-          action FetchItems {
-            get "/items"
-            store response -> items { key: .id }
-          }
-
-          run [FetchItems, MissingAction]
-        }
-      `;
-
-      expect(() => parse(source)).toThrow(/Action 'MissingAction' is not defined/);
-    });
-
-    it('throws error for undefined source in fetch step', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-
-          action FetchItems {
-            get "/items" {
-              source: NonexistentSource
-            }
-            store response -> items { key: .id }
-          }
-
-          run FetchItems
-        }
-      `;
-
-      expect(() => parse(source)).toThrow(/Source 'NonexistentSource' is not defined/);
-    });
-
-    it('throws error for undefined source in call step operationRef', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-
-          action FetchItems {
-            call NonexistentSource.getItems
-            store response -> items { key: .id }
-          }
-
-          run FetchItems
-        }
-      `;
-
-      expect(() => parse(source)).toThrow(/Source 'NonexistentSource' is not defined/);
-    });
-
-    it('throws error for undefined store in nested for loop', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-
-          action ProcessItems {
-            for item in items {
-              get "/item/{item.id}"
-              store response -> missing_store { key: .id }
-            }
-          }
-
-          run ProcessItems
-        }
-      `;
-
-      expect(() => parse(source)).toThrow(/Store 'missing_store' is not defined/);
-    });
-
-    it('includes available stores in error message', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-          store users: memory("users")
-
-          action FetchItems {
-            get "/items"
-            store response -> nonexistent { key: .id }
-          }
-
-          run FetchItems
-        }
-      `;
-
-      expect(() => parse(source)).toThrow(/Available stores: items, users/);
-    });
-
-    it('includes available actions in error message', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-
-          action FetchItems {
-            get "/items"
-            store response -> items { key: .id }
-          }
-
-          action ProcessItems {
-            get "/process"
-          }
-
-          run MissingAction
-        }
-      `;
-
-      expect(() => parse(source)).toThrow(/Available actions: FetchItems, ProcessItems/);
-    });
-
-    it('accepts valid store references', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-          store processed: memory("processed")
-
-          action FetchAndStore {
-            get "/items"
-            store response -> items { key: .id }
-            store response -> processed { key: .id }
-          }
-
-          run FetchAndStore
-        }
-      `;
-
-      expect(() => parse(source)).not.toThrow();
-    });
-
-    it('accepts valid action references in complex pipeline', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          store items: memory("items")
-
-          action Step1 { get "/1" }
-          action Step2 { get "/2" }
-          action Step3 { get "/3" }
-
-          run Step1 then [Step2, Step3]
-        }
-      `;
-
-      expect(() => parse(source)).not.toThrow();
-    });
-
-    it('accepts valid source reference in fetch step', () => {
-      const source = `
-        mission TestMission {
-          source API {
-            auth: bearer,
-            base: "https://api.example.com"
-          }
-
-          source OtherAPI {
-            auth: bearer,
-            base: "https://other.example.com"
-          }
-
-          store items: memory("items")
-
-          action FetchItems {
-            get "/items" {
-              source: OtherAPI
-            }
-            store response -> items { key: .id }
-          }
-
-          run FetchItems
-        }
-      `;
-
-      expect(() => parse(source)).not.toThrow();
-    });
-  });
-});