blendsdk 5.33.0

package/dist/expression/core/parameter-manager.js

@@ -0,0 +1,164 @@
+/**
+ * Parameter manager for handling SQL parameters
+ * Manages parameter generation, validation, and serialization
+ */
+import { SqlDialect } from './types.js';
+/**
+ * Parameter manager class
+ */
+export class ParameterManager {
+    parameterCount = 0;
+    parameters = new Map();
+    dialect;
+    constructor(dialect = SqlDialect.PostgreSQL) {
+        this.dialect = dialect;
+    }
+    /**
+     * Generate a new unique parameter name
+     */
+    generateParameterName() {
+        this.parameterCount++;
+        return this.formatParameterName(this.parameterCount);
+    }
+    /**
+     * Add a parameter with a specific name
+     */
+    addParameter(name, value) {
+        // Serialize the value before storing (normalizes undefined to null)
+        const serialized = this.serializeParameter(value);
+        this.parameters.set(name, serialized);
+    }
+    /**
+     * Add a parameter and return its name
+     */
+    addParameterWithValue(value) {
+        const name = this.generateParameterName();
+        this.addParameter(name, value);
+        return name;
+    }
+    /**
+     * Get parameter value by name
+     */
+    getParameter(name) {
+        return this.parameters.get(name);
+    }
+    /**
+     * Check if parameter exists
+     */
+    hasParameter(name) {
+        return this.parameters.has(name);
+    }
+    /**
+     * Get all parameters as a record
+     */
+    getParameters() {
+        const result = {};
+        this.parameters.forEach((value, key) => {
+            result[key] = value;
+        });
+        return result;
+    }
+    /**
+     * Get parameter count
+     */
+    getParameterCount() {
+        return this.parameterCount;
+    }
+    /**
+     * Reset parameter manager
+     */
+    reset() {
+        this.parameterCount = 0;
+        this.parameters.clear();
+    }
+    /**
+     * Format parameter name with a sequential index.
+     * Currently all dialects use the same naming convention (p1, p2, p3, etc.).
+     *
+     * @param index - The sequential parameter index
+     * @returns The formatted parameter name (e.g., "p1", "p2")
+     */
+    formatParameterName(index) {
+        return `p${index}`;
+    }
+    /**
+     * Format parameter placeholder for SQL
+     */
+    formatParameterPlaceholder(name) {
+        switch (this.dialect) {
+            case SqlDialect.PostgreSQL:
+                return `:${name}`;
+            case SqlDialect.MySQL:
+            case SqlDialect.SQLite:
+                return `?`;
+            case SqlDialect.MSSQL:
+                return `@${name}`;
+            default:
+                return `:${name}`;
+        }
+    }
+    /**
+     * Serialize parameter value for SQL.
+     * Normalizes undefined to null and handles Date, array, and object types.
+     *
+     * @param value - The value to serialize
+     * @returns The serialized value suitable for SQL parameterization
+     */
+    serializeParameter(value) {
+        // Normalize undefined to null
+        if (value === undefined) {
+            return null;
+        }
+        if (value === null) {
+            return null;
+        }
+        // Handle dates (must come before object check)
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        // Handle arrays - keep as-is for PostgreSQL array/jsonb support
+        if (Array.isArray(value)) {
+            return value;
+        }
+        // Handle objects - keep as-is for PostgreSQL jsonb support
+        // The database driver will handle JSON serialization
+        if (typeof value === 'object') {
+            return value;
+        }
+        return value;
+    }
+    /**
+     * Deduplicate parameters with same value.
+     * Uses JSON.stringify for deep comparison so objects and arrays
+     * are correctly deduplicated (not just compared by reference).
+     *
+     * @param value - The parameter value to look for
+     * @returns The existing parameter name if a duplicate is found, null otherwise
+     */
+    deduplicateParameter(value) {
+        const serialized = JSON.stringify(this.serializeParameter(value));
+        // Find existing parameter with same value using deep comparison
+        for (const [name, paramValue] of this.parameters.entries()) {
+            if (JSON.stringify(this.serializeParameter(paramValue)) === serialized) {
+                return name;
+            }
+        }
+        return null;
+    }
+    /**
+     * Clone parameter manager
+     */
+    clone() {
+        const cloned = new ParameterManager(this.dialect);
+        cloned.parameterCount = this.parameterCount;
+        cloned.parameters = new Map(this.parameters);
+        return cloned;
+    }
+}
+/**
+ * Create a new parameter manager
+ */
+export function createParameterManager(dialect = SqlDialect.PostgreSQL) {
+    return new ParameterManager(dialect);
+}
+//# sourceMappingURL=parameter-manager.js.map

package/dist/expression/core/parameter-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-manager.js","sourceRoot":"","sources":["../../src/core/parameter-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,cAAc,GAAW,CAAC,CAAC;IAC3B,UAAU,GAAqB,IAAI,GAAG,EAAE,CAAC;IAChC,OAAO,CAAa;IAErC,YAAY,UAAsB,UAAU,CAAC,UAAU;QACrD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,qBAAqB;QAC1B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,IAAY,EAAE,KAAU;QAC1C,oEAAoE;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACI,qBAAqB,CAAC,KAAU;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,YAAY,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,aAAa;QAClB,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACK,mBAAmB,CAAC,KAAa;QACvC,OAAO,IAAI,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,0BAA0B,CAAC,IAAY;QAC5C,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,UAAU,CAAC,UAAU;gBACxB,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,KAAK,UAAU,CAAC,KAAK,CAAC;YACtB,KAAK,UAAU,CAAC,MAAM;gBACpB,OAAO,GAAG,CAAC;YACb,KAAK,UAAU,CAAC,KAAK;gBACnB,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB;gBACE,OAAO,IAAI,IAAI,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,kBAAkB,CAAC,KAAU;QAClC,8BAA8B;QAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,+CAA+C;QAC/C,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC;QAED,gEAAgE;QAChE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,2DAA2D;QAC3D,qDAAqD;QACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;OAOG;IACI,oBAAoB,CAAC,KAAU;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;QAElE,gEAAgE;QAChE,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3D,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;gBACvE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,KAAK;QACV,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC5C,MAAM,CAAC,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAsB,UAAU,CAAC,UAAU;IAChF,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/expression/core/query-builder-interfaces.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Query builder interfaces
+ * Defines the fluent API for building SQL WHERE clauses
+ */
+import { ASTNode, CompileResult, SearchOptions } from './types.js';
+/**
+ * Comparison builder interface
+ * Provides methods for building comparison expressions
+ */
+export interface ComparisonBuilder<TSchema, K extends keyof TSchema> {
+    /**
+     * Equal comparison (=)
+     */
+    equals(value: TSchema[K]): QueryBuilder<TSchema>;
+    /**
+     * Not equal comparison (<>)
+     */
+    notEquals(value: TSchema[K]): QueryBuilder<TSchema>;
+    /**
+     * Greater than comparison (>)
+     */
+    greaterThan(value: TSchema[K]): QueryBuilder<TSchema>;
+    /**
+     * Greater than or equal comparison (>=)
+     */
+    greaterThanOrEqual(value: TSchema[K]): QueryBuilder<TSchema>;
+    /**
+     * Less than comparison (<)
+     */
+    lessThan(value: TSchema[K]): QueryBuilder<TSchema>;
+    /**
+     * Less than or equal comparison (<=)
+     */
+    lessThanOrEqual(value: TSchema[K]): QueryBuilder<TSchema>;
+    /**
+     * Between comparison (BETWEEN min AND max)
+     */
+    between(min: TSchema[K], max: TSchema[K]): QueryBuilder<TSchema>;
+    /**
+     * Not between comparison (NOT BETWEEN min AND max)
+     */
+    notBetween(min: TSchema[K], max: TSchema[K]): QueryBuilder<TSchema>;
+    /**
+     * IN comparison (IN (value1, value2, ...))
+     */
+    in(values: TSchema[K][]): QueryBuilder<TSchema>;
+    /**
+     * NOT IN comparison (NOT IN (value1, value2, ...))
+     */
+    notIn(values: TSchema[K][]): QueryBuilder<TSchema>;
+    /**
+     * LIKE comparison (LIKE pattern)
+     */
+    like(pattern: string): QueryBuilder<TSchema>;
+    /**
+     * ILIKE comparison (ILIKE pattern) - PostgreSQL only
+     */
+    ilike(pattern: string): QueryBuilder<TSchema>;
+    /**
+     * IS NULL check
+     */
+    isNull(): QueryBuilder<TSchema>;
+    /**
+     * IS NOT NULL check
+     */
+    isNotNull(): QueryBuilder<TSchema>;
+    /**
+     * Starts with (sugar for LIKE 'value%')
+     */
+    startsWith(value: string): QueryBuilder<TSchema>;
+    /**
+     * Ends with (sugar for LIKE '%value')
+     */
+    endsWith(value: string): QueryBuilder<TSchema>;
+    /**
+     * Contains (sugar for LIKE '%value%')
+     */
+    contains(value: string): QueryBuilder<TSchema>;
+    /**
+     * JSON contains (PostgreSQL @> operator)
+     */
+    jsonContains(value: any): QueryBuilder<TSchema>;
+    /**
+     * JSON contained by (PostgreSQL <@ operator)
+     */
+    jsonContainedBy(value: any): QueryBuilder<TSchema>;
+    /**
+     * JSON has key (PostgreSQL ? operator)
+     */
+    jsonHasKey(key: string): QueryBuilder<TSchema>;
+    /**
+     * JSON has any key (PostgreSQL ?| operator)
+     */
+    jsonHasAnyKey(keys: string[]): QueryBuilder<TSchema>;
+    /**
+     * JSON has all keys (PostgreSQL ?& operator)
+     */
+    jsonHasAllKeys(keys: string[]): QueryBuilder<TSchema>;
+    /**
+     * JSON path exists (PostgreSQL @? operator)
+     */
+    jsonPathExists(path: string): QueryBuilder<TSchema>;
+    /**
+     * Full-text search
+     */
+    search(query: string, options?: SearchOptions): QueryBuilder<TSchema>;
+    /**
+     * EXISTS with subquery
+     */
+    exists(subquery: QueryBuilder<any>): QueryBuilder<TSchema>;
+    /**
+     * NOT EXISTS with subquery
+     */
+    notExists(subquery: QueryBuilder<any>): QueryBuilder<TSchema>;
+    /**
+     * IN with subquery
+     */
+    inSubquery(subquery: QueryBuilder<any>): QueryBuilder<TSchema>;
+    /**
+     * NOT IN with subquery
+     */
+    notInSubquery(subquery: QueryBuilder<any>): QueryBuilder<TSchema>;
+    /**
+     * Compare with column (for correlated subqueries)
+     */
+    equalsColumn(column: string): QueryBuilder<TSchema>;
+}
+/**
+ * Main query builder interface
+ * Provides the fluent API for building queries
+ */
+export interface QueryBuilder<TSchema = Record<string, any>> {
+    /**
+     * Start a WHERE clause with a column
+     */
+    where<K extends keyof TSchema>(column: K): ComparisonBuilder<TSchema, K>;
+    /**
+     * Start a WHERE clause with a callback for grouping
+     */
+    where(callback: (q: QueryBuilder<TSchema>) => QueryBuilder<TSchema>): QueryBuilder<TSchema>;
+    /**
+     * Add an AND condition with a column
+     */
+    and<K extends keyof TSchema>(column: K): ComparisonBuilder<TSchema, K>;
+    /**
+     * Add an AND condition with a callback for grouping
+     */
+    and(callback: (q: QueryBuilder<TSchema>) => QueryBuilder<TSchema>): QueryBuilder<TSchema>;
+    /**
+     * Add an OR condition with a column
+     */
+    or<K extends keyof TSchema>(column: K): ComparisonBuilder<TSchema, K>;
+    /**
+     * Add an OR condition with a callback for grouping
+     */
+    or(callback: (q: QueryBuilder<TSchema>) => QueryBuilder<TSchema>): QueryBuilder<TSchema>;
+    /**
+     * Full-text search across multiple columns
+     */
+    search(columns: string | string[], query: string, options?: SearchOptions): QueryBuilder<TSchema>;
+    /**
+     * Enable debug mode
+     */
+    debug(): QueryBuilder<TSchema>;
+    /**
+     * Compile the query to SQL
+     */
+    compile(): CompileResult;
+    /**
+     * Get the internal AST (for advanced use cases)
+     */
+    getAST(): ASTNode | null;
+}
+/**
+ * Subquery builder interface
+ * Used for building subqueries
+ */
+export interface SubqueryBuilder<TSchema = Record<string, any>> extends QueryBuilder<TSchema> {
+    /**
+     * Select columns for subquery
+     */
+    select(...columns: (keyof TSchema)[]): SubqueryBuilder<TSchema>;
+    /**
+     * Aggregate function for subquery
+     */
+    aggregate(func: 'avg' | 'sum' | 'count' | 'min' | 'max'): SubqueryBuilder<TSchema>;
+}
+//# sourceMappingURL=query-builder-interfaces.d.ts.map

package/dist/expression/core/query-builder-interfaces.d.ts.map

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

package/dist/expression/core/query-builder-interfaces.js

@@ -0,0 +1,6 @@
+/**
+ * Query builder interfaces
+ * Defines the fluent API for building SQL WHERE clauses
+ */
+export {};
+//# sourceMappingURL=query-builder-interfaces.js.map

package/dist/expression/core/query-builder-interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder-interfaces.js","sourceRoot":"","sources":["../../src/core/query-builder-interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/expression/core/types.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Core type definitions for expression2
+ */
+/**
+ * SQL dialect enumeration
+ */
+export declare enum SqlDialect {
+    PostgreSQL = "postgresql",
+    MySQL = "mysql",
+    MSSQL = "mssql",
+    SQLite = "sqlite"
+}
+/**
+ * Query builder options
+ */
+export interface QueryOptions {
+    /**
+     * SQL dialect to use (default: PostgreSQL)
+     */
+    dialect?: SqlDialect;
+    /**
+     * Enable debug mode
+     */
+    debug?: boolean;
+}
+/**
+ * Result of compiling a query
+ */
+export interface CompileResult {
+    /**
+     * Generated SQL WHERE clause (without the WHERE keyword)
+     */
+    sql: string;
+    /**
+     * Parameter values keyed by parameter name
+     */
+    params: Record<string, any>;
+    /**
+     * Debug information (only present if debug mode is enabled)
+     */
+    debug?: DebugInfo;
+}
+/**
+ * Debug information about query compilation
+ */
+export interface DebugInfo {
+    /**
+     * Abstract syntax tree representation
+     */
+    ast: ASTNode;
+    /**
+     * List of optimizations applied
+     */
+    optimizations: string[];
+    /**
+     * Number of parameters in the query
+     */
+    parameterCount: number;
+    /**
+     * Time taken to compile the query (in milliseconds)
+     */
+    compilationTime: number;
+    /**
+     * Warnings or suggestions
+     */
+    warnings: string[];
+}
+/**
+ * Base AST node type
+ */
+export declare enum ASTNodeType {
+    Comparison = "comparison",
+    Logical = "logical",
+    Group = "group",
+    Json = "json",
+    FullText = "fulltext",
+    Subquery = "subquery"
+}
+/**
+ * Base interface for all AST nodes
+ */
+export interface ASTNode {
+    readonly type: ASTNodeType;
+    readonly id: string;
+}
+/**
+ * Comparison operators
+ */
+export declare enum ComparisonOperator {
+    Equal = "=",
+    NotEqual = "<>",
+    GreaterThan = ">",
+    GreaterThanOrEqual = ">=",
+    LessThan = "<",
+    LessThanOrEqual = "<=",
+    Like = "LIKE",
+    ILike = "ILIKE",
+    In = "IN",
+    NotIn = "NOT IN",
+    Between = "BETWEEN",
+    NotBetween = "NOT BETWEEN",
+    IsNull = "IS NULL",
+    IsNotNull = "IS NOT NULL"
+}
+/**
+ * Comparison AST node
+ */
+export interface ComparisonNode extends ASTNode {
+    readonly type: ASTNodeType.Comparison;
+    readonly column: string;
+    readonly operator: ComparisonOperator;
+    readonly value?: any;
+    readonly values?: any[];
+    readonly parameterNames?: string[];
+}
+/**
+ * Logical operators
+ */
+export declare enum LogicalOperator {
+    And = "AND",
+    Or = "OR"
+}
+/**
+ * Logical AST node (AND/OR)
+ */
+export interface LogicalNode extends ASTNode {
+    readonly type: ASTNodeType.Logical;
+    readonly operator: LogicalOperator;
+    readonly left: ASTNode;
+    readonly right: ASTNode;
+}
+/**
+ * Group AST node (for parentheses)
+ */
+export interface GroupNode extends ASTNode {
+    readonly type: ASTNodeType.Group;
+    readonly child: ASTNode;
+}
+/**
+ * JSON operators (PostgreSQL)
+ */
+export declare enum JsonOperator {
+    Contains = "@>",
+    ContainedBy = "<@",
+    HasKey = "?",
+    HasAnyKey = "?|",
+    HasAllKeys = "?&",
+    PathExists = "@?"
+}
+/**
+ * JSON AST node
+ */
+export interface JsonNode extends ASTNode {
+    readonly type: ASTNodeType.Json;
+    readonly column: string;
+    readonly operator: JsonOperator;
+    readonly value?: any;
+    readonly path?: string;
+    readonly keys?: string[];
+    readonly parameterName?: string;
+}
+/**
+ * Full-text search modes
+ */
+export declare enum FullTextMode {
+    Plain = "plain",
+    Phrase = "phrase",
+    WebSearch = "websearch"
+}
+/**
+ * Full-text search AST node
+ */
+export interface FullTextNode extends ASTNode {
+    readonly type: ASTNodeType.FullText;
+    readonly columns: string[];
+    readonly query: string;
+    readonly mode: FullTextMode;
+    readonly language: string;
+    readonly parameterName: string;
+}
+/**
+ * Subquery AST node
+ */
+export interface SubqueryNode extends ASTNode {
+    readonly type: ASTNodeType.Subquery;
+    readonly column?: string;
+    readonly operator: 'EXISTS' | 'NOT EXISTS' | 'IN' | 'NOT IN' | ComparisonOperator;
+    readonly subquery: ASTNode;
+}
+/**
+ * Search options for full-text search
+ */
+export interface SearchOptions {
+    /**
+     * Search mode (default: plain)
+     */
+    mode?: 'plain' | 'phrase' | 'websearch';
+    /**
+     * Language for text search (default: english)
+     */
+    language?: string;
+}
+/**
+ * Extract column names from a schema type
+ */
+export type ColumnName<TSchema> = keyof TSchema & string;
+/**
+ * Extract column type from a schema
+ */
+export type ColumnType<TSchema, K extends keyof TSchema> = TSchema[K];
+/**
+ * Type guard to check if a value is an ASTNode
+ */
+export declare function isASTNode(value: any): value is ASTNode;
+/**
+ * Type guard for ComparisonNode
+ */
+export declare function isComparisonNode(node: ASTNode): node is ComparisonNode;
+/**
+ * Type guard for LogicalNode
+ */
+export declare function isLogicalNode(node: ASTNode): node is LogicalNode;
+/**
+ * Type guard for GroupNode
+ */
+export declare function isGroupNode(node: ASTNode): node is GroupNode;
+/**
+ * Type guard for JsonNode
+ */
+export declare function isJsonNode(node: ASTNode): node is JsonNode;
+/**
+ * Type guard for FullTextNode
+ */
+export declare function isFullTextNode(node: ASTNode): node is FullTextNode;
+/**
+ * Type guard for SubqueryNode
+ */
+export declare function isSubqueryNode(node: ASTNode): node is SubqueryNode;
+//# sourceMappingURL=types.d.ts.map

package/dist/expression/core/types.d.ts.map

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