cloudflare-expression-lint 0.1.0

package/dist/parser.js

@@ -0,0 +1,320 @@
+/**
+ * Parser for Cloudflare expressions.
+ *
+ * Converts a token stream into an AST using recursive descent parsing.
+ * Handles operator precedence for logical operators:
+ *   1. not / !   (highest, unary)
+ *   2. and / &&
+ *   3. xor / ^^
+ *   4. or / ||   (lowest)
+ */
+import { tokenize } from './lexer.js';
+import { TokenType, } from './types.js';
+class Parser {
+    tokens;
+    pos = 0;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    peek() {
+        return this.tokens[this.pos] ?? this.eof();
+    }
+    peekType() {
+        return this.peek().type;
+    }
+    advance() {
+        const token = this.tokens[this.pos];
+        if (this.pos < this.tokens.length)
+            this.pos++;
+        return token;
+    }
+    expect(type, context) {
+        const token = this.peek();
+        if (token.type !== type) {
+            throw new Error(`Expected ${type}${context ? ' ' + context : ''} but got ${token.type} ("${token.value}") at position ${token.position}`);
+        }
+        return this.advance();
+    }
+    eof() {
+        const last = this.tokens[this.tokens.length - 1];
+        return last ?? { type: TokenType.EOF, value: '', position: 0, line: 1, column: 1 };
+    }
+    isAtEnd() {
+        return this.peekType() === TokenType.EOF;
+    }
+    /**
+     * Entry point: parse a full expression.
+     */
+    parse() {
+        if (this.isAtEnd()) {
+            throw new Error('Empty expression');
+        }
+        const node = this.parseOr();
+        if (!this.isAtEnd()) {
+            const token = this.peek();
+            throw new Error(`Unexpected token "${token.value}" at position ${token.position} after complete expression`);
+        }
+        return node;
+    }
+    // ── Logical Operators (precedence climbing) ────────────────────────
+    /** Lowest precedence: or / || */
+    parseOr() {
+        let left = this.parseXor();
+        while (this.matchLogical('or', '||')) {
+            const op = this.advance();
+            const right = this.parseXor();
+            left = { kind: 'Logical', left, operator: op.value, right, position: op.position };
+        }
+        return left;
+    }
+    /** xor / ^^ */
+    parseXor() {
+        let left = this.parseAnd();
+        while (this.matchLogical('xor', '^^')) {
+            const op = this.advance();
+            const right = this.parseAnd();
+            left = { kind: 'Logical', left, operator: op.value, right, position: op.position };
+        }
+        return left;
+    }
+    /** and / && */
+    parseAnd() {
+        let left = this.parseNot();
+        while (this.matchLogical('and', '&&')) {
+            const op = this.advance();
+            const right = this.parseNot();
+            left = { kind: 'Logical', left, operator: op.value, right, position: op.position };
+        }
+        return left;
+    }
+    /** Unary not / ! */
+    parseNot() {
+        if (this.matchLogical('not', '!')) {
+            const op = this.advance();
+            // Special case: "not FIELD in {LIST}" → InExpression with negated=true
+            // We need to look ahead: if next is a comparison-capable thing followed by 'in'
+            const saved = this.pos;
+            try {
+                const operand = this.parsePrimary();
+                if (this.peekType() === TokenType.ComparisonOp && this.peek().value === 'in') {
+                    this.advance(); // consume 'in'
+                    const values = this.parseInValues();
+                    return {
+                        kind: 'InExpression',
+                        field: operand,
+                        values,
+                        negated: true,
+                        position: op.position,
+                    };
+                }
+                // Not a "not X in Y" pattern — restore and parse normally
+                this.pos = saved;
+            }
+            catch {
+                this.pos = saved;
+            }
+            const operand = this.parseNot(); // right-recursive for chained not
+            return { kind: 'Not', operand, position: op.position };
+        }
+        return this.parseComparison();
+    }
+    // ── Comparison Expressions ─────────────────────────────────────────
+    parseComparison() {
+        const left = this.parsePrimary();
+        // Check for comparison operator
+        if (this.peekType() === TokenType.ComparisonOp) {
+            const op = this.advance();
+            // Special case: 'in' operator has special RHS syntax
+            if (op.value === 'in') {
+                const values = this.parseInValues();
+                return {
+                    kind: 'InExpression',
+                    field: left,
+                    values,
+                    negated: false,
+                    position: op.position,
+                };
+            }
+            const right = this.parsePrimary();
+            return {
+                kind: 'Comparison',
+                left,
+                operator: op.value,
+                right,
+                position: op.position,
+            };
+        }
+        return left;
+    }
+    // ── In-List Values ─────────────────────────────────────────────────
+    parseInValues() {
+        // Can be: { value1 value2 ... } or $named_list
+        if (this.peekType() === TokenType.NamedList) {
+            const token = this.advance();
+            return [{ kind: 'NamedList', name: token.value, position: token.position }];
+        }
+        this.expect(TokenType.LeftBrace, 'after "in"');
+        const values = [];
+        while (this.peekType() !== TokenType.RightBrace && !this.isAtEnd()) {
+            const token = this.peek();
+            if (token.type === TokenType.String || token.type === TokenType.RawString) {
+                this.advance();
+                values.push({ kind: 'StringLiteral', value: token.value, position: token.position });
+            }
+            else if (token.type === TokenType.Integer) {
+                this.advance();
+                // Check for range (..)
+                if (this.peekType() === TokenType.DotDot) {
+                    this.advance(); // consume ..
+                    const end = this.expect(TokenType.Integer, 'in range');
+                    values.push({ kind: 'IntegerLiteral', value: parseInt(token.value), position: token.position });
+                    values.push({ kind: 'IntegerLiteral', value: parseInt(end.value), position: end.position });
+                }
+                else {
+                    values.push({ kind: 'IntegerLiteral', value: parseInt(token.value), position: token.position });
+                }
+            }
+            else if (token.type === TokenType.IPAddress) {
+                this.advance();
+                // Check for CIDR /xx
+                if (this.peekType() === TokenType.Slash) {
+                    this.advance(); // consume /
+                    const bits = this.expect(TokenType.Integer, 'in CIDR');
+                    values.push({ kind: 'IPLiteral', value: token.value, cidr: parseInt(bits.value), position: token.position });
+                }
+                else if (this.peekType() === TokenType.DotDot) {
+                    // IP range
+                    this.advance(); // consume ..
+                    const endIP = this.expect(TokenType.IPAddress, 'in IP range');
+                    values.push({ kind: 'IPLiteral', value: token.value, position: token.position });
+                    values.push({ kind: 'IPLiteral', value: endIP.value, position: endIP.position });
+                }
+                else {
+                    values.push({ kind: 'IPLiteral', value: token.value, position: token.position });
+                }
+            }
+            else {
+                throw new Error(`Unexpected token "${token.value}" (${token.type}) in in-list at position ${token.position}`);
+            }
+        }
+        this.expect(TokenType.RightBrace, 'closing in-list');
+        return values;
+    }
+    // ── Primary Expressions ────────────────────────────────────────────
+    parsePrimary() {
+        const token = this.peek();
+        switch (token.type) {
+            case TokenType.LeftParen:
+                return this.parseGroup();
+            case TokenType.Boolean:
+                this.advance();
+                return { kind: 'BooleanLiteral', value: token.value === 'true', position: token.position };
+            case TokenType.String:
+            case TokenType.RawString:
+                this.advance();
+                return { kind: 'StringLiteral', value: token.value, position: token.position };
+            case TokenType.Integer:
+                this.advance();
+                return { kind: 'IntegerLiteral', value: parseInt(token.value), position: token.position };
+            case TokenType.IPAddress:
+                this.advance();
+                return { kind: 'IPLiteral', value: token.value, position: token.position };
+            case TokenType.NamedList:
+                this.advance();
+                return { kind: 'NamedList', name: token.value, position: token.position };
+            case TokenType.Function:
+                return this.parseFunctionCall();
+            case TokenType.Field:
+                return this.parseFieldAccess();
+            default:
+                throw new Error(`Unexpected token "${token.value}" (${token.type}) at position ${token.position}`);
+        }
+    }
+    // ── Grouped Expression ─────────────────────────────────────────────
+    parseGroup() {
+        const open = this.expect(TokenType.LeftParen);
+        const expr = this.parseOr();
+        this.expect(TokenType.RightParen, 'to close group');
+        return { kind: 'Group', expression: expr, position: open.position };
+    }
+    // ── Function Call ──────────────────────────────────────────────────
+    parseFunctionCall() {
+        const nameToken = this.expect(TokenType.Function);
+        this.expect(TokenType.LeftParen, `after function "${nameToken.value}"`);
+        const args = [];
+        if (this.peekType() !== TokenType.RightParen) {
+            args.push(this.parseOr());
+            while (this.peekType() === TokenType.Comma) {
+                this.advance(); // consume comma
+                args.push(this.parseOr());
+            }
+        }
+        this.expect(TokenType.RightParen, `to close function "${nameToken.value}"`);
+        let result = {
+            kind: 'FunctionCall',
+            name: nameToken.value,
+            args,
+            position: nameToken.position,
+        };
+        // Handle chained array unpacks and bracket access after function call
+        // e.g., lower(http.request.headers.names[*])[*]
+        while (this.peekType() === TokenType.ArrayUnpack || this.peekType() === TokenType.LeftBracket) {
+            if (this.peekType() === TokenType.ArrayUnpack) {
+                const unpack = this.advance();
+                result = { kind: 'ArrayUnpack', field: result, position: unpack.position };
+            }
+            else {
+                // Bracket access after function result - just consume it as part of the expression
+                this.advance(); // [
+                if (this.peekType() === TokenType.String || this.peekType() === TokenType.RawString || this.peekType() === TokenType.Integer) {
+                    this.advance(); // key/index
+                }
+                this.expect(TokenType.RightBracket);
+            }
+        }
+        return result;
+    }
+    // ── Field Access ───────────────────────────────────────────────────
+    parseFieldAccess() {
+        const fieldToken = this.expect(TokenType.Field);
+        let field = fieldToken.value;
+        let mapKey;
+        let arrayIndex;
+        // Handle bracket access: field["key"] or field[0]
+        while (this.peekType() === TokenType.LeftBracket) {
+            this.advance(); // consume [
+            const inner = this.peek();
+            if (inner.type === TokenType.String || inner.type === TokenType.RawString) {
+                mapKey = inner.value;
+                this.advance();
+            }
+            else if (inner.type === TokenType.Integer) {
+                arrayIndex = parseInt(inner.value);
+                this.advance();
+            }
+            this.expect(TokenType.RightBracket);
+        }
+        // Handle array unpack [*]
+        if (this.peekType() === TokenType.ArrayUnpack) {
+            const unpack = this.advance();
+            const fieldNode = { kind: 'FieldAccess', field, mapKey, position: fieldToken.position };
+            return { kind: 'ArrayUnpack', field: fieldNode, position: unpack.position };
+        }
+        return { kind: 'FieldAccess', field, mapKey, arrayIndex, position: fieldToken.position };
+    }
+    // ── Helpers ────────────────────────────────────────────────────────
+    matchLogical(...values) {
+        const token = this.peek();
+        return token.type === TokenType.LogicalOp && values.includes(token.value);
+    }
+}
+/**
+ * Parse a Cloudflare expression string into an AST.
+ * @throws Error on syntax errors
+ */
+export function parse(input) {
+    const tokens = tokenize(input);
+    const parser = new Parser(tokens);
+    return parser.parse();
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/schemas/fields.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Cloudflare expression fields registry.
+ *
+ * Reference: https://developers.cloudflare.com/ruleset-engine/rules-language/fields/reference/
+ *
+ * MAINTAINER NOTE: To add a new field, add it to the FIELDS array below.
+ * To deprecate a field, set `deprecated: true` and `replacement` to the new field name.
+ */
+import type { FieldType } from './operators.js';
+export interface FieldDef {
+    /** Full dotted field name (e.g., "http.request.uri.path") */
+    name: string;
+    /** Value type */
+    type: FieldType;
+    /** Whether this field is deprecated */
+    deprecated?: boolean;
+    /** Suggested replacement field for deprecated fields */
+    replacement?: string;
+    /** Phases where this field is available. Empty array = all phases. */
+    phases?: string[];
+    /** Human-readable notes */
+    notes?: string;
+}
+/**
+ * Master field registry.
+ *
+ * Phases key:
+ *   - Empty phases array or undefined = available in all phases
+ *   - Specific phase names = only available in those phases
+ *
+ * Response fields are only available in response phases.
+ */
+export declare const FIELDS: FieldDef[];
+/**
+ * Look up a field by name.
+ * Returns undefined if the field is not recognized.
+ */
+export declare function findField(name: string): FieldDef | undefined;
+/**
+ * Check if a field name could be a dynamic map/array access.
+ * E.g., "http.request.headers" is a Map field, so "http.request.headers["host"]" is valid.
+ * Returns the base field if found.
+ */
+export declare function findBaseField(name: string): FieldDef | undefined;