@allurereport/aql 3.1.0

package/dist/parser/index.js

@@ -0,0 +1,497 @@
+/* eslint-disable @typescript-eslint/no-shadow */
+/**
+ * Parser for AQL (Allure Query Language)
+ */
+import { AqlErrors } from "../errors/index.js";
+import { AqlLogicalOperator, AqlOperation } from "../model.js";
+import { AqlTokenizer } from "../tokenizer/index.js";
+/**
+ * Parser for AQL (Allure Query Language) expressions.
+ * Converts AQL strings into abstract syntax trees (AST).
+ */
+export class AqlParser {
+    /**
+     * Creates a new AQL parser instance.
+     *
+     * @param input - The AQL string to parse
+     * @param context - Optional context map for function values (e.g., `now()`, `currentUser()`)
+     * @param config - Optional parser configuration to restrict available features
+     * @throws {AqlParserError} If input is not a non-empty string
+     */
+    constructor(input, context = undefined, config = {}) {
+        this.tokens = [];
+        this.position = 0;
+        if (!input || typeof input !== "string") {
+            throw AqlErrors.invalidInput("Input must be a non-empty string");
+        }
+        const tokenizer = new AqlTokenizer(input);
+        this.tokens = tokenizer.tokenize();
+        // Use provided context or create empty Map only when needed
+        this.context = context;
+        this.config = config;
+    }
+    /**
+     * Parses the AQL string into an abstract syntax tree.
+     *
+     * @returns The parse result containing the expression or null if input is empty
+     * @throws {AqlParserError} If the AQL string is invalid or uses forbidden features
+     *
+     * @example
+     * ```typescript
+     * const parser = new AqlParser('status = "passed"');
+     * const result = parser.parse();
+     * console.log(result.expression); // AqlConditionExpression
+     * ```
+     */
+    parse() {
+        if (this.reachedEOL) {
+            return { expression: null };
+        }
+        const expression = this.parseOrExpression();
+        this.expect("EOL");
+        return { expression };
+    }
+    parseOrExpression() {
+        let left = this.parseAndExpression();
+        while (this.match("OR")) {
+            const operator = AqlLogicalOperator.OR;
+            this.validateLogicalOperator(operator, this.previous.position);
+            const right = this.parseAndExpression();
+            left = {
+                type: "binary",
+                left,
+                operator,
+                right,
+            };
+        }
+        return left;
+    }
+    parseAndExpression() {
+        let left = this.parseNotExpression();
+        while (this.match("AND")) {
+            const operator = AqlLogicalOperator.AND;
+            this.validateLogicalOperator(operator, this.previous.position);
+            const right = this.parseNotExpression();
+            left = {
+                type: "binary",
+                left,
+                operator,
+                right,
+            };
+        }
+        return left;
+    }
+    parseNotExpression() {
+        if (this.match("NOT")) {
+            const position = this.previous.position;
+            this.validateLogicalOperator(AqlLogicalOperator.NOT, position);
+            const expression = this.parseNotExpression();
+            return {
+                type: "not",
+                expression,
+            };
+        }
+        return this.parsePrimaryExpression();
+    }
+    parsePrimaryExpression() {
+        /**
+         * Parentheses
+         */
+        if (this.match("LPAREN")) {
+            const position = this.previous.position;
+            if (this.config.parentheses === false) {
+                throw AqlErrors.forbiddenParentheses(position);
+            }
+            const expression = this.parseOrExpression();
+            this.expect("RPAREN");
+            return {
+                type: "paren",
+                expression,
+            };
+        }
+        /**
+         * Boolean value
+         */
+        if (this.match("BOOLEAN")) {
+            const value = this.previous.value.toLowerCase() === "true"; // BOOLEAN always has value
+            return {
+                type: "boolean",
+                value,
+            };
+        }
+        /**
+         * Condition or array condition
+         */
+        const left = this.parseAccessor();
+        /**
+         * Array condition (IN)
+         */
+        if (this.match("IN")) {
+            const position = this.previous.position;
+            const operator = AqlOperation.IN;
+            this.validateOperation(operator, position);
+            const right = this.parseArray();
+            return {
+                type: "arrayCondition",
+                left,
+                operator,
+                right,
+            };
+        }
+        /**
+         * Regular condition
+         */
+        const operator = this.parseOperation();
+        const right = this.parseValue();
+        return {
+            type: "condition",
+            left,
+            operator,
+            right,
+        };
+    }
+    parseAccessor() {
+        this.expect("IDENTIFIER");
+        const identifier = this.previous.value; // IDENTIFIER always has value
+        const position = this.previous.position;
+        /**
+         * Validate identifier format (only Latin letters and underscores)
+         */
+        this.validateIdentifierFormat(identifier, position);
+        /**
+         * Validate field name (configuration-based)
+         */
+        this.validateIdentifier(identifier, position);
+        /**
+         * Access to array element or object property
+         */
+        if (this.match("LBRACKET")) {
+            if (this.config.indexAccess === false) {
+                throw AqlErrors.forbiddenBracketAccess(this.previous.position);
+            }
+            let param;
+            if (this.match("STRING")) {
+                const stringValue = this.previous.value; // STRING always has value
+                const unquoted = this.unquoteString(stringValue);
+                param = { value: unquoted, type: "string" };
+            }
+            else if (this.match("NUMBER")) {
+                const numberValue = this.previous.value; // NUMBER always has value
+                param = { value: parseFloat(numberValue), type: "number" };
+            }
+            else {
+                throw AqlErrors.expectedAccessor(this.current.position);
+            }
+            this.expect("RBRACKET");
+            return { identifier, param };
+        }
+        return { identifier };
+    }
+    parseOperation() {
+        const position = this.current.position;
+        let operation = null;
+        if (this.match("GT")) {
+            operation = AqlOperation.GT;
+        }
+        else if (this.match("GE")) {
+            operation = AqlOperation.GE;
+        }
+        else if (this.match("LT")) {
+            operation = AqlOperation.LT;
+        }
+        else if (this.match("LE")) {
+            operation = AqlOperation.LE;
+        }
+        else if (this.match("EQ")) {
+            operation = AqlOperation.EQ;
+        }
+        else if (this.match("NEQ")) {
+            operation = AqlOperation.NEQ;
+        }
+        else if (this.match("CONTAINS")) {
+            operation = AqlOperation.CONTAINS;
+        }
+        if (operation) {
+            this.validateOperation(operation, position);
+            return operation;
+        }
+        throw AqlErrors.expectedOperation(position);
+    }
+    parseValue() {
+        const position = this.current.position;
+        if (this.match("NULL")) {
+            const valueType = "NULL";
+            this.validateValueType(valueType, position);
+            return { value: "null", type: valueType };
+        }
+        if (this.match("BOOLEAN")) {
+            const value = this.previous.value; // BOOLEAN always has value
+            const valueType = "BOOLEAN";
+            this.validateValueType(valueType, position);
+            return { value, type: valueType };
+        }
+        if (this.match("NUMBER")) {
+            const value = this.previous.value; // NUMBER always has value
+            const valueType = "NUMBER";
+            this.validateValueType(valueType, position);
+            return { value, type: valueType };
+        }
+        if (this.match("STRING")) {
+            const value = this.previous.value; // STRING always has value
+            const unquoted = this.unquoteString(value);
+            const valueType = "STRING";
+            this.validateValueType(valueType, position);
+            return { value: unquoted, type: valueType };
+        }
+        if (this.match("FUNCTION")) {
+            const key = this.previous.value; // FUNCTION always has value
+            const valueType = "FUNCTION";
+            this.validateValueType(valueType, position);
+            if (!this.context || this.context.size === 0) {
+                return { value: "null", type: "NULL" };
+            }
+            const contextValue = this.context.get(key);
+            if (contextValue === null || contextValue === undefined) {
+                return { value: "null", type: "NULL" };
+            }
+            if (typeof contextValue === "number") {
+                return { value: String(contextValue), type: "NUMBER" };
+            }
+            if (typeof contextValue === "boolean") {
+                return { value: String(contextValue), type: "BOOLEAN" };
+            }
+            return { value: String(contextValue), type: "STRING" };
+        }
+        throw AqlErrors.expectedValue(position);
+    }
+    parseArray() {
+        this.expect("LBRACKET");
+        const values = [];
+        if (!this.match("RBRACKET")) {
+            do {
+                values.push(this.parseValue());
+            } while (this.match("COMMA"));
+            this.expect("RBRACKET");
+        }
+        return values;
+    }
+    match(type) {
+        if (this.check(type)) {
+            this.advance();
+            return true;
+        }
+        return false;
+    }
+    check(type) {
+        if (this.reachedEOL) {
+            return type === "EOL";
+        }
+        return this.current.type === type;
+    }
+    expect(type) {
+        if (!this.match(type)) {
+            const current = this.current;
+            const context = this.getErrorContext(current.position);
+            throw AqlErrors.expectedToken(type, current.type, current.position, context ?? undefined);
+        }
+    }
+    getErrorContext(position) {
+        if (position < 0 || position >= this.tokens.length) {
+            return null;
+        }
+        const start = Math.max(0, position - 2);
+        const end = Math.min(this.tokens.length, position + 3);
+        // Build context string directly without creating intermediate arrays
+        const parts = [];
+        for (let i = start; i < end; i++) {
+            const token = this.tokens[i];
+            parts.push(token.value ?? token.type);
+        }
+        return parts.join(" ");
+    }
+    advance() {
+        if (!this.reachedEOL) {
+            this.position++;
+        }
+    }
+    get reachedEOL() {
+        return this.current.type === "EOL";
+    }
+    get current() {
+        return this.tokens[this.position] || this.tokens[this.tokens.length - 1];
+    }
+    get previous() {
+        return this.tokens[this.position - 1];
+    }
+    unquoteString(quoted) {
+        if (quoted.length < 2 || quoted[0] !== '"' || quoted[quoted.length - 1] !== '"') {
+            return quoted;
+        }
+        // Optimize: process escape sequences in a single pass instead of multiple replace() calls
+        const chars = [];
+        for (let i = 1; i < quoted.length - 1; i++) {
+            const char = quoted[i];
+            if (char === "\\" && i + 1 < quoted.length - 1) {
+                const next = quoted[i + 1];
+                switch (next) {
+                    case "n":
+                        chars.push("\n");
+                        i++; // Skip next character as it's part of escape sequence
+                        continue;
+                    case "t":
+                        chars.push("\t");
+                        i++;
+                        continue;
+                    case "r":
+                        chars.push("\r");
+                        i++;
+                        continue;
+                    case '"':
+                        chars.push('"');
+                        i++;
+                        continue;
+                    case "\\":
+                        chars.push("\\");
+                        i++;
+                        continue;
+                    default:
+                        // Unknown escape sequence - add both backslash and next char as-is
+                        chars.push(char);
+                        chars.push(next);
+                        i++;
+                        continue;
+                }
+            }
+            else {
+                chars.push(char);
+            }
+        }
+        return chars.join("");
+    }
+    /**
+     * Validates that the identifier format is correct (only Latin letters and underscores).
+     *
+     * @param identifier - The identifier to validate
+     * @param position - The position in the input string where the identifier was found
+     * @throws {AqlParserError} If the identifier format is invalid
+     * @private
+     */
+    validateIdentifierFormat(identifier, position) {
+        /**
+         * Check if identifier contains only Latin letters (a-z, A-Z) and underscores (_)
+         */
+        if (!/^[a-zA-Z_]+$/.test(identifier)) {
+            throw AqlErrors.invalidIdentifier(identifier, position);
+        }
+    }
+    /**
+     * Validates that the logical operator is allowed according to the configuration.
+     *
+     * @param operator - The logical operator to validate (AND, OR, NOT)
+     * @param position - The position in the input string where the operator was found
+     * @throws {AqlParserError} If the operator is not allowed
+     * @private
+     */
+    validateLogicalOperator(operator, position) {
+        if (this.config.logicalOperators === undefined) {
+            return; // All operators allowed
+        }
+        if (!this.config.logicalOperators.includes(operator)) {
+            throw AqlErrors.forbiddenLogicalOperator(operator, position);
+        }
+    }
+    /**
+     * Validates that the operation is allowed according to the configuration.
+     *
+     * @param operation - The operation to validate (GT, GE, LT, LE, EQ, NEQ, CONTAINS, IN)
+     * @param position - The position in the input string where the operation was found
+     * @throws {AqlParserError} If the operation is not allowed
+     * @private
+     */
+    validateOperation(operation, position) {
+        if (this.config.operations === undefined) {
+            return; // All operations allowed
+        }
+        if (!this.config.operations.includes(operation)) {
+            throw AqlErrors.forbiddenOperation(operation, position);
+        }
+    }
+    /**
+     * Validates that the identifier is allowed according to the configuration.
+     *
+     * @param identifier - The identifier to validate
+     * @param position - The position in the input string where the identifier was found
+     * @throws {AqlParserError} If the identifier is not allowed
+     * @private
+     */
+    validateIdentifier(identifier, position) {
+        if (this.config.identifiers === undefined) {
+            return; // All identifiers allowed
+        }
+        if (Array.isArray(this.config.identifiers)) {
+            if (!this.config.identifiers.includes(identifier)) {
+                throw AqlErrors.forbiddenIdentifier(identifier, position);
+            }
+        }
+        else if (typeof this.config.identifiers === "function") {
+            if (!this.config.identifiers(identifier)) {
+                throw AqlErrors.forbiddenIdentifier(identifier, position);
+            }
+        }
+    }
+    /**
+     * Validates that the value type is allowed according to the configuration.
+     *
+     * @param valueType - The value type to validate (NULL, BOOLEAN, NUMBER, STRING, FUNCTION)
+     * @param position - The position in the input string where the value was found
+     * @throws {AqlParserError} If the value type is not allowed
+     * @private
+     */
+    validateValueType(valueType, position) {
+        if (this.config.valueTypes === undefined) {
+            return; // All value types allowed
+        }
+        if (!this.config.valueTypes.includes(valueType)) {
+            throw AqlErrors.forbiddenValueType(valueType, position);
+        }
+    }
+}
+/**
+ * Convenience function for parsing AQL string.
+ *
+ * @param aql - The AQL string to parse
+ * @param context - Optional context map or object for function values (e.g., `now()`, `currentUser()`)
+ * @param config - Optional parser configuration to restrict available features
+ * @returns The parse result containing the expression or null if input is empty
+ * @throws {AqlParserError} If the AQL string is invalid or uses forbidden features
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const result = parseAql('status = "passed"');
+ *
+ * // With context
+ * const result = parseAql('createdDate >= now()', { "now()": Date.now() });
+ *
+ * // With configuration
+ * import { AqlOperation } from "./types";
+ * const config = { operations: [AqlOperation.EQ, AqlOperation.NEQ], identifiers: ["status"] };
+ * const result = parseAql('status = "passed"', undefined, config);
+ * ```
+ */
+export function parseAql(aql, context, config) {
+    if (!aql || typeof aql !== "string") {
+        return { expression: null };
+    }
+    let contextMap;
+    if (context instanceof Map) {
+        contextMap = context;
+    }
+    else if (context && typeof context === "object") {
+        // Convert plain object to Map, but avoid creating Map for Map instances (handled above)
+        contextMap = new Map(Object.entries(context));
+    }
+    const parser = new AqlParser(aql, contextMap, config);
+    return parser.parse();
+}
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"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"}

package/dist/tokenizer/index.d.ts

@@ -0,0 +1,89 @@
+import type { AqlToken } from "../model.js";
+/**
+ * Tokenizer for AQL (Allure Query Language).
+ * Converts AQL strings into tokens for parsing.
+ */
+export declare class AqlTokenizer {
+    private input;
+    private position;
+    private tokens;
+    /**
+     * Creates a new AQL tokenizer instance.
+     *
+     * @param input - The AQL string to tokenize
+     */
+    constructor(input: string);
+    /**
+     * Tokenizes the input string into an array of tokens.
+     *
+     * @returns Array of tokens representing the AQL string
+     * @throws {AqlTokenizerError} If the input contains invalid characters or unterminated strings
+     */
+    tokenize(): AqlToken[];
+    private nextToken;
+    private readWhitespace;
+    /**
+     * Reads a string token.
+     * Supports all Unicode characters including Chinese, Japanese, Korean, etc.
+     * String values can contain any Unicode characters, not just identifiers.
+     * Correctly handles brackets (), [], operators (>=, <=, etc.), and other special
+     * characters inside strings - they are treated as regular characters, not as tokens.
+     * Only the closing quote (") terminates the string.
+     */
+    private readString;
+    private readNumber;
+    private readIdentifier;
+    /**
+     * Case-insensitive comparison helper for short strings (optimized for keywords)
+     * Compares characters directly by their codes to avoid creating new strings
+     */
+    private equalsIgnoreCase;
+    /**
+     * Check if first character matches (case-insensitive) without creating new string
+     */
+    private firstCharMatches;
+    /**
+     * Check if identifier is "and" keyword
+     */
+    private isKeywordAnd;
+    /**
+     * Check if identifier is "or" keyword
+     */
+    private isKeywordOr;
+    /**
+     * Check if identifier is "not" keyword
+     */
+    private isKeywordNot;
+    /**
+     * Check if identifier is "in" keyword
+     */
+    private isKeywordIn;
+    /**
+     * Check if identifier is "is" keyword
+     */
+    private isKeywordIs;
+    /**
+     * Check if identifier is boolean keyword ("true" or "false")
+     */
+    private isKeywordBoolean;
+    /**
+     * Check if identifier is null keyword ("null" or "empty")
+     */
+    private isKeywordNull;
+    private currentChar;
+    private peek;
+    private advance;
+    private match;
+    private isWhitespace;
+    private isDigit;
+    /**
+     * Checks if character can start an identifier.
+     * Supports: Latin letters (a-z, A-Z) and underscore (_).
+     */
+    private isIdentifierStart;
+    /**
+     * Checks if character can be part of an identifier.
+     * Supports: Latin letters (a-z, A-Z) and underscore (_).
+     */
+    private isIdentifierChar;
+}