leangraph 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import type { GraphDBOptions, GraphDBClient } from "./types.js";
+export type { GraphDBOptions, GraphDBClient, QueryResponse, HealthResponse, NodeResult, } from "./types.js";
+export { GraphDBError } from "./types.js";
+export { parse } from "./parser.js";
+export type { Query, Clause, CreateClause, MatchClause, MergeClause, SetClause, DeleteClause, ReturnClause, NodePattern, RelationshipPattern, EdgePattern, WhereCondition, Expression, PropertyValue, ParameterRef, ParseResult, ParseError, } from "./parser.js";
+export { translate, Translator } from "./translator.js";
+export type { SqlStatement, TranslationResult } from "./translator.js";
+export { GraphDatabase, DatabaseManager } from "./db.js";
+export type { Node, Edge, NodeRow, EdgeRow, QueryResult } from "./db.js";
+export { Executor, executeQuery } from "./executor.js";
+export type { ExecutionResult, ExecutionError, QueryResponse as ServerQueryResponse, } from "./executor.js";
+export { createApp, createServer } from "./routes.js";
+export type { QueryRequest, ServerOptions } from "./routes.js";
+export { BackupManager } from "./backup.js";
+export type { BackupResult, BackupStatus, BackupAllOptions } from "./backup.js";
+export { ApiKeyStore, authMiddleware, generateApiKey } from "./auth.js";
+export type { ApiKeyConfig, ValidationResult, KeyInfo } from "./auth.js";
+export declare const VERSION: string;
+/**
+ * Create a GraphDB client.
+ *
+ * All options support environment variable defaults:
+ * - `url`: GRAPHDB_URL (default: 'https://leangraph.io')
+ * - `project`: GRAPHDB_PROJECT (required)
+ * - `env`: NODE_ENV (default: 'production')
+ * - `apiKey`: GRAPHDB_API_KEY
+ * - `dataPath`: GRAPHDB_DATA_PATH (default: './data')
+ *
+ * **Development Mode** (NODE_ENV=development):
+ * - Uses a local SQLite database
+ * - `url` and `apiKey` are ignored
+ * - Data is stored at `dataPath/{env}/{project}.db`
+ *
+ * **Production Mode** (NODE_ENV=production or unset):
+ * - Connects to a remote server via HTTP
+ *
+ * @example
+ * ```typescript
+ * import { GraphDB } from 'leangraph';
+ *
+ * // Using environment variables (set GRAPHDB_PROJECT, GRAPHDB_API_KEY)
+ * const db = await GraphDB();
+ *
+ * // Or with explicit options
+ * const db = await GraphDB({
+ *   project: 'myapp',
+ *   apiKey: process.env.GRAPHDB_API_KEY,
+ * });
+ *
+ * // Create nodes
+ * await db.execute('CREATE (n:User {name: "Alice"})');
+ *
+ * // Query
+ * const users = await db.query('MATCH (n:User) RETURN n');
+ *
+ * // Always close when done
+ * db.close();
+ * ```
+ */
+export declare function GraphDB(options?: GraphDBOptions): Promise<GraphDBClient>;
+export default GraphDB;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAShE,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,YAAY,EACV,KAAK,EACL,MAAM,EACN,YAAY,EACZ,WAAW,EACX,WAAW,EACX,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGvE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACzD,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGzE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,IAAI,mBAAmB,GACrC,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG/D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGhF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzE,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AAM3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAUlF;AAGD,eAAe,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,86 @@
+// LeanGraph - Unified Package
+// A lightweight graph database with Cypher query support, powered by SQLite.
+import { createRequire } from "module";
+import { createRemoteClient } from "./remote.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+export { GraphDBError } from "./types.js";
+// ============================================================================
+// Re-export Server Components (for advanced usage)
+// ============================================================================
+// Parser
+export { parse } from "./parser.js";
+// Translator
+export { translate, Translator } from "./translator.js";
+// Database
+export { GraphDatabase, DatabaseManager } from "./db.js";
+// Executor
+export { Executor, executeQuery } from "./executor.js";
+// Routes / Server
+export { createApp, createServer } from "./routes.js";
+// Backup
+export { BackupManager } from "./backup.js";
+// Auth
+export { ApiKeyStore, authMiddleware, generateApiKey } from "./auth.js";
+// ============================================================================
+// Version
+// ============================================================================
+export const VERSION = pkg.version;
+// ============================================================================
+// Main Factory Function
+// ============================================================================
+/**
+ * Create a GraphDB client.
+ *
+ * All options support environment variable defaults:
+ * - `url`: GRAPHDB_URL (default: 'https://leangraph.io')
+ * - `project`: GRAPHDB_PROJECT (required)
+ * - `env`: NODE_ENV (default: 'production')
+ * - `apiKey`: GRAPHDB_API_KEY
+ * - `dataPath`: GRAPHDB_DATA_PATH (default: './data')
+ *
+ * **Development Mode** (NODE_ENV=development):
+ * - Uses a local SQLite database
+ * - `url` and `apiKey` are ignored
+ * - Data is stored at `dataPath/{env}/{project}.db`
+ *
+ * **Production Mode** (NODE_ENV=production or unset):
+ * - Connects to a remote server via HTTP
+ *
+ * @example
+ * ```typescript
+ * import { GraphDB } from 'leangraph';
+ *
+ * // Using environment variables (set GRAPHDB_PROJECT, GRAPHDB_API_KEY)
+ * const db = await GraphDB();
+ *
+ * // Or with explicit options
+ * const db = await GraphDB({
+ *   project: 'myapp',
+ *   apiKey: process.env.GRAPHDB_API_KEY,
+ * });
+ *
+ * // Create nodes
+ * await db.execute('CREATE (n:User {name: "Alice"})');
+ *
+ * // Query
+ * const users = await db.query('MATCH (n:User) RETURN n');
+ *
+ * // Always close when done
+ * db.close();
+ * ```
+ */
+export async function GraphDB(options = {}) {
+    const isProduction = process.env.NODE_ENV === "production";
+    if (isProduction) {
+        return createRemoteClient(options);
+    }
+    else {
+        // Lazy-load local client to avoid requiring better-sqlite3 when not needed
+        const { createLocalClient } = await import("./local.js");
+        return createLocalClient(options);
+    }
+}
+// Default export
+export default GraphDB;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,6EAA6E;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAcvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,+EAA+E;AAC/E,mDAAmD;AACnD,+EAA+E;AAE/E,SAAS;AACT,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAqBpC,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGxD,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGzD,WAAW;AACX,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAOvD,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGtD,SAAS;AACT,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO;AACP,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGxE,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC;AAE3C,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,UAA0B,EAAE;IACxD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC;IAE3D,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,2EAA2E;QAC3E,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACzD,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,eAAe,OAAO,CAAC"}

package/dist/local.d.ts

@@ -0,0 +1,7 @@
+import type { GraphDBClient, GraphDBOptions } from "./types.js";
+/**
+ * Create a local embedded GraphDB client.
+ * This client uses SQLite directly without any HTTP layer.
+ */
+export declare function createLocalClient(options?: GraphDBOptions): GraphDBClient;
+//# sourceMappingURL=local.d.ts.map

package/dist/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../src/local.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EAIf,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAqJ7E"}

package/dist/local.js

@@ -0,0 +1,119 @@
+// LeanGraph - Local Embedded Client
+// Uses SQLite directly without HTTP
+import * as fs from "fs";
+import * as path from "path";
+import { GraphDatabase } from "./db.js";
+import { Executor } from "./executor.js";
+import { GraphDBError } from "./types.js";
+/**
+ * Create a local embedded GraphDB client.
+ * This client uses SQLite directly without any HTTP layer.
+ */
+export function createLocalClient(options = {}) {
+    const dataPath = options.dataPath ?? process.env.GRAPHDB_DATA_PATH ?? "./data";
+    const project = options.project ?? process.env.GRAPHDB_PROJECT;
+    const env = options.env ?? process.env.NODE_ENV ?? "production";
+    if (!project) {
+        throw new Error("Project is required. Set via options.project or GRAPHDB_PROJECT env var.");
+    }
+    // Determine database path
+    let dbPath;
+    if (dataPath === ":memory:") {
+        dbPath = ":memory:";
+    }
+    else {
+        // Ensure directory exists
+        const dir = path.join(dataPath, env);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        dbPath = path.join(dir, `${project}.db`);
+    }
+    // Create and initialize database
+    const db = new GraphDatabase(dbPath);
+    db.initialize();
+    const executor = new Executor(db);
+    return {
+        async query(cypher, params = {}) {
+            const result = executor.execute(cypher, params);
+            if (!result.success) {
+                throw new GraphDBError(result.error.message, {
+                    position: result.error.position,
+                    line: result.error.line,
+                    column: result.error.column,
+                });
+            }
+            return result.data;
+        },
+        async queryRaw(cypher, params = {}) {
+            const result = executor.execute(cypher, params);
+            if (!result.success) {
+                throw new GraphDBError(result.error.message, {
+                    position: result.error.position,
+                    line: result.error.line,
+                    column: result.error.column,
+                });
+            }
+            return {
+                success: true,
+                data: result.data,
+                meta: result.meta,
+            };
+        },
+        async execute(cypher, params = {}) {
+            const result = executor.execute(cypher, params);
+            if (!result.success) {
+                throw new GraphDBError(result.error.message, {
+                    position: result.error.position,
+                    line: result.error.line,
+                    column: result.error.column,
+                });
+            }
+        },
+        async createNode(label, properties = {}) {
+            const propKeys = Object.keys(properties);
+            const propAssignments = propKeys.map((k) => `${k}: $${k}`).join(", ");
+            const cypher = `CREATE (n:${label} {${propAssignments}}) RETURN id(n) as id`;
+            const result = await this.query(cypher, properties);
+            return result[0]?.id;
+        },
+        async createEdge(sourceId, type, targetId, properties = {}) {
+            const propKeys = Object.keys(properties);
+            const propAssignments = propKeys.length > 0
+                ? ` {${propKeys.map((k) => `${k}: $${k}`).join(", ")}}`
+                : "";
+            const cypher = `
+        MATCH (source), (target)
+        WHERE id(source) = $sourceId AND id(target) = $targetId
+        MERGE (source)-[:${type}${propAssignments}]->(target)
+      `;
+            await this.execute(cypher, { sourceId, targetId, ...properties });
+        },
+        async getNode(label, filter) {
+            const filterKeys = Object.keys(filter);
+            const filterProps = filterKeys.map((k) => `${k}: $${k}`).join(", ");
+            const cypher = `MATCH (n:${label} {${filterProps}}) RETURN n LIMIT 1`;
+            const result = await this.query(cypher, filter);
+            return result.length > 0 ? result[0].n : null;
+        },
+        async deleteNode(id) {
+            await this.execute("MATCH (n) WHERE id(n) = $id DETACH DELETE n", { id });
+        },
+        async updateNode(id, properties) {
+            const propKeys = Object.keys(properties);
+            const setClause = propKeys.map((k) => `n.${k} = $${k}`).join(", ");
+            const cypher = `MATCH (n) WHERE id(n) = $id SET ${setClause}`;
+            await this.execute(cypher, { id, ...properties });
+        },
+        async health() {
+            return {
+                status: "ok",
+                timestamp: new Date().toISOString(),
+            };
+        },
+        close() {
+            db.close();
+        },
+    };
+}
+//# sourceMappingURL=local.js.map

package/dist/local.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,365 @@
+export interface NodePattern {
+    variable?: string;
+    label?: string | string[];
+    properties?: Record<string, PropertyValue>;
+}
+export interface EdgePattern {
+    variable?: string;
+    type?: string;
+    types?: string[];
+    properties?: Record<string, PropertyValue>;
+    direction: "left" | "right" | "none";
+    minHops?: number;
+    maxHops?: number;
+}
+export interface RelationshipPattern {
+    source: NodePattern;
+    edge: EdgePattern;
+    target: NodePattern;
+}
+export interface PathExpression {
+    type: "path";
+    variable: string;
+    patterns: (NodePattern | RelationshipPattern)[];
+}
+export interface ParameterRef {
+    type: "parameter";
+    name: string;
+}
+export interface VariableRef {
+    type: "variable";
+    name: string;
+}
+export interface PropertyRef {
+    type: "property";
+    variable: string;
+    property: string;
+}
+export interface BinaryPropertyValue {
+    type: "binary";
+    operator: "+" | "-" | "*" | "/" | "%" | "^";
+    left: PropertyValue;
+    right: PropertyValue;
+}
+export interface FunctionPropertyValue {
+    type: "function";
+    name: string;
+    args: PropertyValue[];
+}
+export interface MapPropertyValue {
+    type: "map";
+    properties: Record<string, PropertyValue>;
+}
+export type PropertyValue = string | number | boolean | null | ParameterRef | VariableRef | PropertyRef | BinaryPropertyValue | MapPropertyValue | FunctionPropertyValue | PropertyValue[];
+export interface WhereCondition {
+    type: "comparison" | "and" | "or" | "not" | "contains" | "startsWith" | "endsWith" | "isNull" | "isNotNull" | "exists" | "in" | "listPredicate" | "patternMatch" | "expression";
+    left?: Expression;
+    right?: Expression;
+    operator?: "=" | "<>" | "<" | ">" | "<=" | ">=";
+    conditions?: WhereCondition[];
+    condition?: WhereCondition;
+    pattern?: NodePattern | RelationshipPattern;
+    patterns?: (NodePattern | RelationshipPattern)[];
+    list?: Expression;
+    predicateType?: "ALL" | "ANY" | "NONE" | "SINGLE";
+    variable?: string;
+    listExpr?: Expression;
+    filterCondition?: WhereCondition;
+}
+export interface CaseWhen {
+    condition: WhereCondition;
+    result: Expression;
+}
+export interface CaseExpression {
+    type: "case";
+    expression?: Expression;
+    whens: CaseWhen[];
+    elseExpr?: Expression;
+}
+export interface ObjectProperty {
+    key: string;
+    value: Expression;
+}
+export interface Expression {
+    type: "property" | "literal" | "parameter" | "variable" | "function" | "case" | "binary" | "object" | "comparison" | "listComprehension" | "listPredicate" | "patternComprehension" | "unary" | "labelPredicate" | "propertyAccess" | "indexAccess" | "in" | "stringOp";
+    variable?: string;
+    property?: string;
+    value?: PropertyValue;
+    raw?: string;
+    numberLiteralKind?: "integer" | "float";
+    name?: string;
+    functionName?: string;
+    args?: Expression[];
+    distinct?: boolean;
+    star?: boolean;
+    expression?: Expression;
+    whens?: CaseWhen[];
+    elseExpr?: Expression;
+    operator?: "+" | "-" | "*" | "/" | "%" | "^" | "AND" | "OR" | "XOR" | "NOT";
+    left?: Expression;
+    right?: Expression;
+    operand?: Expression;
+    comparisonOperator?: "=" | "<>" | "<" | ">" | "<=" | ">=" | "IS NULL" | "IS NOT NULL";
+    properties?: ObjectProperty[];
+    listExpr?: Expression;
+    filterCondition?: WhereCondition;
+    mapExpr?: Expression;
+    predicateType?: "ALL" | "ANY" | "NONE" | "SINGLE";
+    patterns?: (NodePattern | RelationshipPattern)[];
+    pathVariable?: string;
+    label?: string;
+    labels?: string[];
+    object?: Expression;
+    array?: Expression;
+    index?: Expression;
+    list?: Expression;
+    stringOperator?: "CONTAINS" | "STARTS WITH" | "ENDS WITH";
+}
+export interface ReturnItem {
+    expression: Expression;
+    alias?: string;
+}
+export interface SetAssignment {
+    variable: string;
+    property?: string;
+    value?: Expression;
+    labels?: string[];
+    replaceProps?: boolean;
+    mergeProps?: boolean;
+}
+export interface CreateClause {
+    type: "CREATE";
+    patterns: (NodePattern | RelationshipPattern)[];
+}
+export interface MatchClause {
+    type: "MATCH" | "OPTIONAL_MATCH";
+    patterns: (NodePattern | RelationshipPattern)[];
+    pathExpressions?: PathExpression[];
+    where?: WhereCondition;
+}
+export interface MergeClause {
+    type: "MERGE";
+    patterns: (NodePattern | RelationshipPattern)[];
+    pathExpressions?: PathExpression[];
+    onCreateSet?: SetAssignment[];
+    onMatchSet?: SetAssignment[];
+}
+export interface SetClause {
+    type: "SET";
+    assignments: SetAssignment[];
+}
+export interface DeleteClause {
+    type: "DELETE";
+    variables: string[];
+    expressions?: Expression[];
+    detach?: boolean;
+}
+export interface RemoveItem {
+    variable: string;
+    property?: string;
+    labels?: string[];
+}
+export interface RemoveClause {
+    type: "REMOVE";
+    items: RemoveItem[];
+}
+export interface ReturnClause {
+    type: "RETURN";
+    distinct?: boolean;
+    items: ReturnItem[];
+    orderBy?: {
+        expression: Expression;
+        direction: "ASC" | "DESC";
+    }[];
+    skip?: Expression;
+    limit?: Expression;
+}
+export interface WithClause {
+    type: "WITH";
+    distinct?: boolean;
+    items: ReturnItem[];
+    orderBy?: {
+        expression: Expression;
+        direction: "ASC" | "DESC";
+    }[];
+    skip?: Expression;
+    limit?: Expression;
+    where?: WhereCondition;
+}
+export interface UnwindClause {
+    type: "UNWIND";
+    expression: Expression;
+    alias: string;
+}
+export interface UnionClause {
+    type: "UNION";
+    all: boolean;
+    left: Query;
+    right: Query;
+}
+export interface CallClause {
+    type: "CALL";
+    procedure: string;
+    args: Expression[];
+    yields?: string[];
+    where?: WhereCondition;
+}
+export type Clause = CreateClause | MatchClause | MergeClause | SetClause | DeleteClause | RemoveClause | ReturnClause | WithClause | UnwindClause | UnionClause | CallClause;
+export interface Query {
+    clauses: Clause[];
+}
+export interface ParseError {
+    message: string;
+    position: number;
+    line: number;
+    column: number;
+}
+export type ParseResult = {
+    success: true;
+    query: Query;
+} | {
+    success: false;
+    error: ParseError;
+};
+export declare class Parser {
+    private tokens;
+    private pos;
+    private anonVarCounter;
+    /**
+     * Parse a number string, validating that integers are within int64 range.
+     * Throws SyntaxError for overflow.
+     */
+    private parseNumber;
+    parse(input: string): ParseResult;
+    private parseQuery;
+    private error;
+    private parseClause;
+    private parseCreate;
+    private parseMatch;
+    /**
+     * Parse either a regular pattern chain or a named path expression.
+     * Syntax: p = (a)-[r]->(b) or just (a)-[r]->(b)
+     */
+    private parsePatternOrPath;
+    private parseOptionalMatch;
+    /**
+     * Validate that no variable is used as both a node and a relationship in the same MATCH clause,
+     * and that no relationship variable is used more than once in the same pattern.
+     * These are invalid Cypher syntax.
+     */
+    private validateNoNodeRelationshipVariableConflict;
+    private parseMerge;
+    private parseSet;
+    private parseSetAssignments;
+    private parseRemove;
+    private parseDelete;
+    private parseDeleteTarget;
+    private parseReturn;
+    private parseWith;
+    private parseUnwind;
+    private parseUnwindExpression;
+    private parseCall;
+    /**
+     * Parse a pattern, which can be a single node or a chain of relationships.
+     * For chained patterns like (a)-[:R1]->(b)-[:R2]->(c), this returns multiple
+     * RelationshipPattern objects via parsePatternChain.
+     */
+    private parsePattern;
+    /**
+     * Parse a pattern chain, returning an array of patterns.
+     * Handles multi-hop patterns like (a)-[:R1]->(b)-[:R2]->(c).
+     */
+    private parsePatternChain;
+    private parseNodePattern;
+    private parseEdgePattern;
+    private parseVariableLengthSpec;
+    private parseProperties;
+    private parsePropertyValue;
+    private parsePrimaryPropertyValue;
+    private parseMapPropertyValue;
+    private parseArray;
+    private parseWhereCondition;
+    private parseOrCondition;
+    private parseAndCondition;
+    private parseNotCondition;
+    /**
+     * Detect if we're looking at a pattern (e.g., (a)-[:R]->(b)).
+     * A pattern starts with ( and after the matching ), we expect - or <- (not a keyword like AND, OR, etc).
+     */
+    private isPatternStart;
+    private parsePrimaryCondition;
+    private parseListPredicateCondition;
+    private parseExistsCondition;
+    private parseComparisonCondition;
+    private parseInListExpression;
+    private parseExpression;
+    private parseReturnExpression;
+    private parseOrExpression;
+    private parseXorExpression;
+    private parseAndExpression;
+    private parseNotExpression;
+    private parseComparisonExpression;
+    private parseIsNullExpression;
+    private parseAdditiveExpression;
+    private parseMultiplicativeExpression;
+    private parseExponentialExpression;
+    private parsePostfixExpression;
+    /**
+     * Parse an expression that can be used as a slice bound (start or end).
+     * This is similar to parseExpression but stops at ".." to allow slice syntax.
+     * It uses a modified postfix parser that detects ".." and stops before consuming it.
+     */
+    private parseSliceBoundExpression;
+    private parseSliceBoundAdditiveExpression;
+    private parseSliceBoundMultiplicativeExpression;
+    private parseSliceBoundExponentialExpression;
+    /**
+     * Parse postfix expression for slice bounds. This version detects ".."
+     * and stops before consuming it, allowing the slice syntax to be parsed correctly.
+     */
+    private parseSliceBoundPostfixExpression;
+    private parsePrimaryExpression;
+    private parseCaseExpression;
+    private parseObjectLiteral;
+    private parseListLiteralExpression;
+    /**
+     * Parse a list comprehension after [variable IN has been consumed.
+     * Full syntax: [variable IN listExpr WHERE filterCondition | mapExpr]
+     * - WHERE and | are both optional
+     */
+    private parseListComprehension;
+    /**
+     * Parse a pattern comprehension after [ has been consumed and we see (.
+     * Syntax: [(pattern) WHERE filterCondition | mapExpr]
+     * Or with named path: [p = (pattern) WHERE filterCondition | p]
+     * WHERE and | mapExpr are optional.
+     */
+    private parsePatternComprehension;
+    /**
+     * Parse a list predicate after PRED(variable IN has been consumed.
+     * Syntax: ALL/ANY/NONE/SINGLE(variable IN listExpr WHERE filterCondition)
+     * WHERE is required for list predicates.
+     */
+    private parseListPredicate;
+    /**
+     * Parse a condition in a list comprehension, where the variable can be used.
+     * Similar to parseWhereCondition but resolves variable references.
+     */
+    private parseListComprehensionCondition;
+    /**
+     * Parse an expression in a list comprehension map projection.
+     * Similar to parseExpression but the variable is in scope.
+     */
+    private parseListComprehensionExpression;
+    private peek;
+    private advance;
+    private isAtEnd;
+    private check;
+    private checkKeyword;
+    private expect;
+    private expectIdentifier;
+    private expectIdentifierOrKeyword;
+    private expectLabelOrType;
+}
+export declare function parse(input: string): ParseResult;
+//# sourceMappingURL=parser.d.ts.map