reqon-dsl 0.2.0 → 0.3.0

package/src/errors/errors.test.ts

@@ -1,234 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import {
-  ReqonError,
-  ParseError,
-  LexerError,
-  RuntimeError,
-  ValidationError,
-  formatErrors,
-  getSourceLine,
-  getSourceContext,
-} from './index.js';
-import { ReqonLexer } from '../lexer/index.js';
-import { ReqonParser } from '../parser/index.js';
-
-describe('Error classes', () => {
-  describe('ReqonError', () => {
-    it('should format error with location', () => {
-      const error = new ReqonError('Something went wrong', { line: 5, column: 10 });
-      const formatted = error.format();
-
-      expect(formatted).toContain('ReqonError: Something went wrong');
-      expect(formatted).toContain('5:10');
-    });
-
-    it('should format error with source context', () => {
-      const source = `mission Test {
-  source API {
-    auth: bearer,
-    base: "https://api.example.com"
-  }
-}`;
-      const error = new ReqonError('Unexpected token', { line: 3, column: 5 }, { source });
-      const formatted = error.format();
-
-      expect(formatted).toContain('auth: bearer,');
-      expect(formatted).toContain('3 |');
-      expect(formatted).toContain('^');
-    });
-
-    it('should include file path when provided', () => {
-      const error = new ReqonError(
-        'Test error',
-        { line: 1, column: 1 },
-        { source: 'test', filePath: '/path/to/file.reqon' }
-      );
-      const formatted = error.format();
-
-      expect(formatted).toContain('/path/to/file.reqon:');
-    });
-  });
-
-  describe('ParseError', () => {
-    it('should include token value in format', () => {
-      const error = new ParseError(
-        "Expected '{'",
-        { line: 2, column: 15 },
-        undefined,
-        'identifier'
-      );
-      const formatted = error.format();
-
-      expect(formatted).toContain("found: 'identifier'");
-    });
-
-    it('should format with source context and pointer', () => {
-      const source = `mission Test {
-  source API auth: bearer
-}`;
-      const error = new ParseError(
-        "Expected '{'",
-        { line: 2, column: 14 },
-        { source },
-        'auth'
-      );
-      const formatted = error.format();
-
-      expect(formatted).toContain('ParseError');
-      expect(formatted).toContain('2:14');
-      expect(formatted).toContain('source API auth: bearer');
-      expect(formatted).toContain('^');
-    });
-  });
-
-  describe('LexerError', () => {
-    it('should format with source context', () => {
-      const source = 'mission Test { @ }';
-      const error = new LexerError(
-        "Unexpected character '@'",
-        { line: 1, column: 16 },
-        { source }
-      );
-      const formatted = error.format();
-
-      expect(formatted).toContain('LexerError');
-      expect(formatted).toContain("Unexpected character '@'");
-    });
-  });
-
-  describe('RuntimeError', () => {
-    it('should include action and step info', () => {
-      const error = new RuntimeError(
-        'Request failed with status 404',
-        { line: 5, column: 3 },
-        undefined,
-        { action: 'FetchData', stepType: 'fetch' }
-      );
-      const formatted = error.format();
-
-      expect(formatted).toContain('in action: FetchData');
-      expect(formatted).toContain('at step: fetch');
-    });
-  });
-
-  describe('ValidationError', () => {
-    it('should include severity', () => {
-      const error = new ValidationError(
-        'Value must be positive',
-        { line: 10, column: 5 },
-        undefined,
-        { severity: 'warning' }
-      );
-
-      expect(error.severity).toBe('warning');
-    });
-  });
-});
-
-describe('formatErrors', () => {
-  it('should format multiple errors', () => {
-    const errors = [
-      new ParseError('Error 1', { line: 1, column: 1 }),
-      new ParseError('Error 2', { line: 5, column: 10 }),
-    ];
-
-    const formatted = formatErrors(errors);
-
-    expect(formatted).toContain('Error 1');
-    expect(formatted).toContain('Error 2');
-    expect(formatted).toContain('1:1');
-    expect(formatted).toContain('5:10');
-  });
-});
-
-describe('getSourceLine', () => {
-  it('should return the correct line', () => {
-    const source = 'line1\nline2\nline3';
-
-    expect(getSourceLine(source, 1)).toBe('line1');
-    expect(getSourceLine(source, 2)).toBe('line2');
-    expect(getSourceLine(source, 3)).toBe('line3');
-  });
-
-  it('should return undefined for out of range', () => {
-    const source = 'line1\nline2';
-
-    expect(getSourceLine(source, 5)).toBeUndefined();
-  });
-});
-
-describe('getSourceContext', () => {
-  it('should return surrounding lines', () => {
-    const source = 'line1\nline2\nline3\nline4\nline5';
-    const context = getSourceContext(source, 3, 1);
-
-    expect(context.lines).toHaveLength(3);
-    expect(context.lines[0]).toEqual({ num: 2, text: 'line2' });
-    expect(context.lines[1]).toEqual({ num: 3, text: 'line3' });
-    expect(context.lines[2]).toEqual({ num: 4, text: 'line4' });
-    expect(context.errorLineIndex).toBe(1);
-  });
-});
-
-describe('Integration with parser', () => {
-  it('should produce ParseError with source context', () => {
-    const source = `mission Test {
-  source API {
-    auth: bearer
-  }
-
-  action Fetch {
-    get "/items
-  }
-
-  run Fetch
-}`;
-
-    const lexer = new ReqonLexer(source);
-
-    expect(() => lexer.tokenize()).toThrow();
-
-    try {
-      lexer.tokenize();
-    } catch (e) {
-      expect(e).toBeInstanceOf(Error);
-      const error = e as Error;
-      expect(error.message).toContain('Unterminated string');
-    }
-  });
-
-  it('should produce ParseError for syntax errors', () => {
-    const source = `mission Test {
-  source API {
-    auth: bearer,
-    base: "https://api.example.com"
-  }
-
-  action Fetch
-    get "/items"
-  }
-
-  run Fetch
-}`;
-
-    const lexer = new ReqonLexer(source);
-    const tokens = lexer.tokenize();
-    const parser = new ReqonParser(tokens, source, 'test.reqon');
-
-    expect(() => parser.parse()).toThrow();
-
-    try {
-      parser.parse();
-    } catch (e) {
-      expect(e).toBeInstanceOf(ParseError);
-      const error = e as ParseError;
-      expect(error.location.line).toBeGreaterThan(0);
-      expect(error.context?.source).toBe(source);
-      expect(error.context?.filePath).toBe('test.reqon');
-
-      const formatted = error.format();
-      expect(formatted).toContain('test.reqon:');
-      expect(formatted).toContain('ParseError');
-    }
-  });
-});

package/src/errors/index.ts

@@ -1,223 +0,0 @@
-export interface SourceLocation {
-  line: number;
-  column: number;
-  /** End column (optional, for ranges) */
-  endColumn?: number;
-}
-
-export interface ErrorContext {
-  /** The source code being parsed/executed */
-  source?: string;
-  /** File path if available */
-  filePath?: string;
-}
-
-/**
- * Base class for Reqon errors with source location info
- */
-export class ReqonError extends Error {
-  readonly location: SourceLocation;
-  readonly context?: ErrorContext;
-
-  constructor(message: string, location: SourceLocation, context?: ErrorContext) {
-    super(message);
-    this.name = 'ReqonError';
-    this.location = location;
-    this.context = context;
-  }
-
-  /**
-   * Format the error with source context for display
-   */
-  format(): string {
-    const lines: string[] = [];
-
-    // Header with location
-    const fileInfo = this.context?.filePath ? `${this.context.filePath}:` : '';
-    lines.push(`${this.name}: ${this.message}`);
-    lines.push(`  --> ${fileInfo}${this.location.line}:${this.location.column}`);
-
-    // Show source context if available
-    if (this.context?.source) {
-      const sourceLines = this.context.source.split('\n');
-      const errorLine = sourceLines[this.location.line - 1];
-
-      if (errorLine !== undefined) {
-        const lineNum = this.location.line.toString();
-        const padding = ' '.repeat(lineNum.length);
-
-        lines.push(`${padding} |`);
-        lines.push(`${lineNum} | ${errorLine}`);
-
-        // Underline the error position
-        const underlineStart = this.location.column - 1;
-        const underlineLength = this.location.endColumn
-          ? this.location.endColumn - this.location.column
-          : 1;
-        const underline = ' '.repeat(underlineStart) + '^'.repeat(Math.max(1, underlineLength));
-        lines.push(`${padding} | ${underline}`);
-      }
-    }
-
-    return lines.join('\n');
-  }
-
-  toString(): string {
-    return this.format();
-  }
-}
-
-/**
- * Error during lexical analysis
- */
-export class LexerError extends ReqonError {
-  constructor(message: string, location: SourceLocation, context?: ErrorContext) {
-    super(message, location, context);
-    this.name = 'LexerError';
-  }
-}
-
-/**
- * Error during parsing
- */
-export class ParseError extends ReqonError {
-  /** The token value that caused the error */
-  readonly tokenValue?: string;
-
-  constructor(
-    message: string,
-    location: SourceLocation,
-    context?: ErrorContext,
-    tokenValue?: string
-  ) {
-    super(message, location, context);
-    this.name = 'ParseError';
-    this.tokenValue = tokenValue;
-  }
-
-  format(): string {
-    const base = super.format();
-    if (this.tokenValue) {
-      return `${base}\n  found: '${this.tokenValue}'`;
-    }
-    return base;
-  }
-}
-
-/**
- * Error during runtime evaluation
- */
-export class RuntimeError extends ReqonError {
-  /** The action/step where the error occurred */
-  readonly action?: string;
-  /** The step type (fetch, map, validate, etc.) */
-  readonly stepType?: string;
-
-  constructor(
-    message: string,
-    location: SourceLocation,
-    context?: ErrorContext,
-    options?: { action?: string; stepType?: string }
-  ) {
-    super(message, location, context);
-    this.name = 'RuntimeError';
-    this.action = options?.action;
-    this.stepType = options?.stepType;
-  }
-
-  format(): string {
-    const lines: string[] = [];
-
-    // Header
-    lines.push(`${this.name}: ${this.message}`);
-
-    if (this.action) {
-      lines.push(`  in action: ${this.action}`);
-    }
-    if (this.stepType) {
-      lines.push(`  at step: ${this.stepType}`);
-    }
-
-    // Location
-    const fileInfo = this.context?.filePath ? `${this.context.filePath}:` : '';
-    lines.push(`  --> ${fileInfo}${this.location.line}:${this.location.column}`);
-
-    // Source context
-    if (this.context?.source) {
-      const sourceLines = this.context.source.split('\n');
-      const errorLine = sourceLines[this.location.line - 1];
-
-      if (errorLine !== undefined) {
-        const lineNum = this.location.line.toString();
-        const padding = ' '.repeat(lineNum.length);
-
-        lines.push(`${padding} |`);
-        lines.push(`${lineNum} | ${errorLine}`);
-
-        const underlineStart = this.location.column - 1;
-        const underline = ' '.repeat(underlineStart) + '^';
-        lines.push(`${padding} | ${underline}`);
-      }
-    }
-
-    return lines.join('\n');
-  }
-}
-
-/**
- * Error during validation
- */
-export class ValidationError extends ReqonError {
-  readonly constraint?: string;
-  readonly severity: 'error' | 'warning';
-
-  constructor(
-    message: string,
-    location: SourceLocation,
-    context?: ErrorContext,
-    options?: { constraint?: string; severity?: 'error' | 'warning' }
-  ) {
-    super(message, location, context);
-    this.name = 'ValidationError';
-    this.constraint = options?.constraint;
-    this.severity = options?.severity ?? 'error';
-  }
-}
-
-/**
- * Format multiple errors for display
- */
-export function formatErrors(errors: ReqonError[]): string {
-  return errors.map(e => e.format()).join('\n\n');
-}
-
-/**
- * Get the source line at a given line number
- */
-export function getSourceLine(source: string, lineNumber: number): string | undefined {
-  const lines = source.split('\n');
-  return lines[lineNumber - 1];
-}
-
-/**
- * Get surrounding context lines
- */
-export function getSourceContext(
-  source: string,
-  lineNumber: number,
-  contextLines: number = 2
-): { lines: Array<{ num: number; text: string }>; errorLineIndex: number } {
-  const allLines = source.split('\n');
-  const start = Math.max(0, lineNumber - 1 - contextLines);
-  const end = Math.min(allLines.length, lineNumber + contextLines);
-
-  const lines: Array<{ num: number; text: string }> = [];
-  for (let i = start; i < end; i++) {
-    lines.push({ num: i + 1, text: allLines[i] });
-  }
-
-  return {
-    lines,
-    errorLineIndex: lineNumber - 1 - start,
-  };
-}