@quickql/server 1.0.0

package/dist/server/src/executor.js

@@ -0,0 +1,121 @@
+/**
+ * QuickQL Query Executor
+ *
+ * Handles the actual fetching, filtering, and field-level mapping
+ * between the schema and the raw data sources.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { RelationEngine } from './relations';
+import { FilterEngine } from './filters';
+export class QueryExecutor {
+    schema;
+    features;
+    directives;
+    relationEngine;
+    constructor(schema, features = {
+        smartCollectionMatching: true,
+        superSelection: true,
+        smartRelationDiscovery: true
+    }, directives = []) {
+        this.schema = schema;
+        this.features = features;
+        this.directives = directives;
+        this.relationEngine = new RelationEngine(schema, this.execute.bind(this), features);
+    }
+    collectionCache = new Map();
+    resolveCollectionName(input) {
+        if (this.collectionCache.has(input))
+            return this.collectionCache.get(input);
+        if (this.schema[input])
+            return input;
+        if (this.features.smartCollectionMatching) {
+            const candidates = Object.keys(this.schema);
+            const exactMatch = candidates.find(c => c === input ||
+                c === `${input}s` ||
+                c === `${input}es` ||
+                c === input.replace(/s$/, ''));
+            if (exactMatch) {
+                this.collectionCache.set(input, exactMatch);
+                return exactMatch;
+            }
+            const suggestion = candidates.find(c => c.startsWith(input.substring(0, 3)) ||
+                input.startsWith(c.substring(0, 3)));
+            if (suggestion) {
+                console.warn(`[QuickQL] WARNING: Collection '${input}' not found. Using '${suggestion}' automatically.`);
+                this.collectionCache.set(input, suggestion);
+                return suggestion;
+            }
+        }
+        this.collectionCache.set(input, null);
+        return null;
+    }
+    async execute(query, depth = 0, ctx) {
+        const resolvedName = this.resolveCollectionName(query.from);
+        if (!resolvedName)
+            return [];
+        query.from = resolvedName;
+        const collection = this.schema[resolvedName];
+        // 1. Fetch raw data from resolver - Now passing CTX for ORM access!
+        let results = await collection.resolver(query, ctx);
+        // 2. Apply filters (Standard WHERE engine logic)
+        results = FilterEngine.applyFilters(results, query.where);
+        // 3. Resolve relations (Nested included data)
+        if (query.include && collection.relations) {
+            results = await this.relationEngine.resolve(results, query.include, collection.relations, depth);
+        }
+        // Apply selection and field aliasing
+        if (query.select && query.select.length > 0) {
+            results = this.applySelection(results, query.select, query.include, query);
+        }
+        // Process @directives if defined
+        if (this.directives.length > 0 && query.directives) {
+            for (const [name, args] of Object.entries(query.directives)) {
+                const handler = this.directives.find(d => d.name === name)?.handler;
+                if (handler) {
+                    results = await handler(results, args, ctx);
+                }
+            }
+        }
+        return results;
+    }
+    async executeMutation(mutation, ctx) {
+        const collection = this.schema[mutation.collection];
+        if (!collection || !collection.mutationResolver)
+            return null;
+        return collection.mutationResolver(mutation, ctx);
+    }
+    applySelection(results, select, include, query) {
+        if (results.length === 0)
+            return [];
+        // Pre-calculate selection logic once
+        const firstItem = results[0];
+        const realSelect = (select.includes('*') && this.features.superSelection)
+            ? [...new Set([...select.filter(s => s !== '*'), ...Object.keys(firstItem)])]
+            : select;
+        const selections = realSelect.map(s => {
+            const parts = s.split(':');
+            return {
+                original: parts[0].trim(),
+                alias: (parts[1] || parts[0]).trim()
+            };
+        });
+        const includeKeys = include ? Object.keys(include) : [];
+        return results.map(item => {
+            const selected = {};
+            for (const { original, alias } of selections) {
+                const val = item[original];
+                selected[alias] = val !== undefined ? val : null;
+            }
+            for (const key of includeKeys) {
+                if (item[key] !== undefined) {
+                    selected[key] = item[key];
+                }
+            }
+            return selected;
+        });
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/server/src/executor.js.map

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

package/dist/server/src/filters.d.ts

@@ -0,0 +1,10 @@
+import { WhereClause, LogicalCondition } from '@quickql/core';
+export declare class FilterEngine {
+    /**
+     * Simple in-memory filtering helper for resolvers that don't support native filtering.
+     */
+    static applyFilters(items: any[], where?: WhereClause | LogicalCondition): any[];
+    private static evaluate;
+    private static match;
+}
+//# sourceMappingURL=filters.d.ts.map

package/dist/server/src/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../../src/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAA4B,MAAM,eAAe,CAAC;AAExF,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,gBAAgB,GAAG,GAAG,EAAE;IAKhF,OAAO,CAAC,MAAM,CAAC,QAAQ;IAmBvB,OAAO,CAAC,MAAM,CAAC,KAAK;CAoBrB"}

package/dist/server/src/filters.js

@@ -0,0 +1,47 @@
+export class FilterEngine {
+    /**
+     * Simple in-memory filtering helper for resolvers that don't support native filtering.
+     */
+    static applyFilters(items, where) {
+        if (!where)
+            return items;
+        return items.filter(item => this.evaluate(item, where));
+    }
+    static evaluate(item, condition) {
+        // Check for logical operators AND / OR
+        if ('AND' in condition && Array.isArray(condition.AND)) {
+            return condition.AND.every(sub => typeof sub === 'object' && this.evaluate(item, sub));
+        }
+        if ('OR' in condition && Array.isArray(condition.OR)) {
+            return condition.OR.some(sub => typeof sub === 'object' && this.evaluate(item, sub));
+        }
+        // Default: AND behavior for multiple fields in a WhereClause
+        return Object.entries(condition).every(([field, check]) => {
+            // Skip if it was actually AND/OR in a mixed object (not ideal but safe)
+            if (field === 'AND' || field === 'OR')
+                return true;
+            const value = item[field];
+            return this.match(value, check);
+        });
+    }
+    static match(value, condition) {
+        if (typeof condition !== 'object' || condition === null || Array.isArray(condition)) {
+            return value === condition;
+        }
+        const checks = Object.entries(condition);
+        return checks.every(([operator, expected]) => {
+            switch (operator) {
+                case 'eq': return value === expected;
+                case 'ne': return value !== expected;
+                case 'gt': return value > expected;
+                case 'lt': return value < expected;
+                case 'in': return Array.isArray(expected) && expected.includes(value);
+                case 'contains': return typeof value === 'string' && value.includes(expected);
+                case 'startsWith': return typeof value === 'string' && value.startsWith(expected);
+                case 'endsWith': return typeof value === 'string' && value.endsWith(expected);
+                default: return false;
+            }
+        });
+    }
+}
+//# sourceMappingURL=filters.js.map

package/dist/server/src/filters.js.map

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

package/dist/server/src/handler.d.ts

@@ -0,0 +1,12 @@
+import { QuickQLServer } from './engine';
+export interface HandlerOptions {
+    server: QuickQLServer;
+    endpoint?: string;
+    version?: string;
+}
+/**
+ * Creates a universal handler for QuickQL that manages both
+ * the Playground Shell (GET) and the Query Engine (POST).
+ */
+export declare function createQuickQLHandler(options: HandlerOptions): (req: any, res: any) => Promise<any>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/server/src/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AASzC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,IAI5C,KAAK,GAAG,EAAE,KAAK,GAAG,kBA8HjC"}

package/dist/server/src/handler.js

@@ -0,0 +1,138 @@
+import { renderPlayground } from './playground/html';
+import { formatError, getHttpStatusCode } from './errors';
+import { EventEmitter } from 'events';
+// Global Event Hub for Real-time
+const hub = new EventEmitter();
+hub.setMaxListeners(100);
+/**
+ * Creates a universal handler for QuickQL that manages both
+ * the Playground Shell (GET) and the Query Engine (POST).
+ */
+export function createQuickQLHandler(options) {
+    const { server, endpoint = '/quickql', version } = options;
+    const config = server.getOptions();
+    return async (req, res) => {
+        const method = req.method?.toUpperCase();
+        // 0. Handle CORS
+        if (config.cors) {
+            if (typeof res.setHeader === 'function') {
+                res.setHeader('Access-Control-Allow-Origin', '*');
+                res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+                res.setHeader('Access-Control-Allow-Headers', 'Content-Type, X-QuickQL-Key, Authorization');
+                res.setHeader('Access-Control-Expose-Headers', 'X-QuickQL-Version, X-QuickQL-Complexity');
+            }
+        }
+        if (method === 'OPTIONS') {
+            if (typeof res.status === 'function')
+                res.status(204);
+            if (typeof res.end === 'function')
+                return res.end();
+            return;
+        }
+        // 1. Handle GET: Playground UI or Schema
+        if (method === 'GET') {
+            const url = new URL(req.url || '', `http://${req.headers?.host || 'localhost'}`);
+            // Return schema metadata directly if requested
+            if (url.searchParams.get('schema') === 'true') {
+                const schema = server.getSchemaSummary();
+                if (typeof res.status === 'function')
+                    res.status(200);
+                if (typeof res.json === 'function')
+                    return res.json(schema);
+                if (typeof res.setHeader === 'function')
+                    res.setHeader('Content-Type', 'application/json');
+                return JSON.stringify(schema);
+            }
+            // 3. New: Real-time SSE Stream
+            const isStream = url.searchParams.get('stream') === 'true' || req.url?.includes('/stream');
+            if (isStream) {
+                if (typeof res.setHeader === 'function') {
+                    res.setHeader('Content-Type', 'text/event-stream');
+                    res.setHeader('Cache-Control', 'no-cache');
+                    res.setHeader('Connection', 'keep-alive');
+                }
+                const listener = (data) => {
+                    res.write(`data: ${JSON.stringify(data)}\n\n`);
+                };
+                hub.on('mutation', listener);
+                req.on('close', () => hub.off('mutation', listener));
+                res.write('retry: 10000\n');
+                res.write('event: connected\ndata: {"status":"active"}\n\n');
+                return;
+            }
+            if (config.debug && config.playground) {
+                const playgroundConfig = typeof config.playground === 'object' ? config.playground : {};
+                const html = renderPlayground({
+                    endpoint: playgroundConfig.endpoint || endpoint,
+                    debug: playgroundConfig.debug ?? config.debug
+                });
+                if (typeof res.status === 'function')
+                    res.status(200);
+                if (typeof res.setHeader === 'function')
+                    res.setHeader('Content-Type', 'text/html');
+                if (typeof res.end === 'function')
+                    return res.end(html);
+                return html;
+            }
+            // Security: Hidden in production
+            const errorMsg = 'QuickQL Playground is disabled in production.';
+            if (typeof res.status === 'function')
+                res.status(404);
+            if (typeof res.json === 'function')
+                return res.json({ error: errorMsg });
+            if (typeof res.end === 'function')
+                return res.end(errorMsg);
+            return { error: errorMsg };
+        }
+        // 2. Handle POST: Query Processing
+        if (method === 'POST') {
+            try {
+                const body = req.body || {};
+                const requestInput = body.query || body;
+                const response = await server.handleRequest(requestInput, req);
+                const statusCode = getHttpStatusCode(response);
+                // 4. New: Auto-Cache Metadata
+                if (config.debug && typeof res.setHeader === 'function') {
+                    const cacheDirective = requestInput.directives?.cache || 0;
+                    if (cacheDirective > 0) {
+                        res.setHeader('Cache-Control', `public, max-age=${cacheDirective}`);
+                    }
+                }
+                // Trigger real-time hub on successful mutations
+                if (requestInput.mutations || (requestInput.batch && requestInput.batch.some((b) => b.type))) {
+                    hub.emit('mutation', {
+                        timestamp: Date.now(),
+                        collection: requestInput.mutations ? Object.keys(requestInput.mutations) : 'batch'
+                    });
+                }
+                if (typeof res.status === 'function') {
+                    res.status(statusCode);
+                }
+                else {
+                    res.statusCode = statusCode;
+                }
+                if (typeof res.json === 'function')
+                    return res.json(response);
+                return response;
+            }
+            catch (err) {
+                const errorResponse = formatError(err, config.debug);
+                const statusCode = getHttpStatusCode(errorResponse);
+                if (typeof res.status === 'function') {
+                    res.status(statusCode);
+                }
+                else {
+                    res.statusCode = statusCode;
+                }
+                if (typeof res.json === 'function')
+                    return res.json(errorResponse);
+                return errorResponse;
+            }
+        }
+        // 3. Method Not Allowed
+        if (typeof res.status === 'function')
+            res.status(405);
+        return { error: 'METHOD_NOT_ALLOWED' };
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/server/src/handler.js.map

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

package/dist/server/src/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * QuickQL Server
+ *
+ * Performance-first, schema-driven API engine with native relational mapping.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+export * from './engine';
+export * from './types';
+export * from './errors';
+export * from './validator';
+export * from './executor';
+export * from './filters';
+export * from './relations';
+export * from './security';
+export * from './handler';
+export * from './parser/types';
+export * from './parser/tokenizer';
+export * from './parser/parser';
+export * from './parser/transformer';
+export * from './schema/builder';
+export type { QuickQLSchema, SchemaOptions, CollectionDefinition, RelationDefinition, FieldDefinition, FieldType, CustomMutation } from './schema/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kBAAkB,CAAC;AACjC,YAAY,EACV,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,cAAc,EACf,MAAM,gBAAgB,CAAC"}

package/dist/server/src/index.js

@@ -0,0 +1,26 @@
+/**
+ * QuickQL Server
+ *
+ * Performance-first, schema-driven API engine with native relational mapping.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+export * from './engine';
+export * from './types';
+export * from './errors';
+export * from './validator';
+export * from './executor';
+export * from './filters';
+export * from './relations';
+export * from './security';
+export * from './handler';
+// Parser & Syntax
+export * from './parser/types';
+export * from './parser/tokenizer';
+export * from './parser/parser';
+export * from './parser/transformer';
+// Schema & ORM
+export * from './schema/builder';
+//# sourceMappingURL=index.js.map

package/dist/server/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAE1B,kBAAkB;AAClB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AAErC,eAAe;AACf,cAAc,kBAAkB,CAAC"}

package/dist/server/src/parser/parser.d.ts

@@ -0,0 +1,21 @@
+/**
+ * QuickQL Syntax Parser
+ *
+ * Recursive descent parser that transforms token streams into Abstract
+ * Syntax Trees (AST) representing QuickQL queries and mutations.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { Token, ASTNode } from './types';
+export declare class Parser {
+    private tokens;
+    private cursor;
+    constructor(tokens: Token[]);
+    private peek;
+    private consume;
+    parse(): Record<string, ASTNode>;
+    private parseNode;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/server/src/parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/parser/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAa,OAAO,EAAE,MAAM,SAAS,CAAC;AAEpD,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,MAAM,CAAK;gBAEP,MAAM,EAAE,KAAK,EAAE;IAI3B,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,OAAO;IASf,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAShC,OAAO,CAAC,SAAS;CAgElB"}

package/dist/server/src/parser/parser.js

@@ -0,0 +1,99 @@
+/**
+ * QuickQL Syntax Parser
+ *
+ * Recursive descent parser that transforms token streams into Abstract
+ * Syntax Trees (AST) representing QuickQL queries and mutations.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+export class Parser {
+    tokens;
+    cursor = 0;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    peek() {
+        return this.tokens[this.cursor];
+    }
+    consume(type) {
+        const token = this.peek();
+        if (token.type !== type) {
+            throw new Error(`Expected token ${type}, but got ${token.type} ('${token.value}') at position ${this.cursor}`);
+        }
+        this.cursor++;
+        return token;
+    }
+    parse() {
+        const nodes = {};
+        while (this.peek().type === 'NAME') {
+            const node = this.parseNode();
+            nodes[node.alias || node.name] = node;
+        }
+        return nodes;
+    }
+    parseNode() {
+        let name = this.consume('NAME').value;
+        let alias;
+        // Support alias: myAlias: myField
+        if (this.peek().type === 'COLON') {
+            this.consume('COLON');
+            alias = name;
+            name = this.consume('NAME').value;
+        }
+        const node = { name, alias };
+        // Support arguments: (id: "1", type: "post")
+        if (this.peek().type === 'LPAREN') {
+            this.consume('LPAREN');
+            const args = {};
+            while (this.peek().type !== 'RPAREN') {
+                const argName = this.consume('NAME').value;
+                this.consume('COLON');
+                const token = this.peek();
+                let value;
+                if (token.type === 'STRING') {
+                    value = this.consume('STRING').value;
+                }
+                else if (token.type === 'NUMBER') {
+                    value = Number(this.consume('NUMBER').value);
+                }
+                else {
+                    throw new Error('Unsupported argument value type');
+                }
+                args[argName] = value;
+                if (this.peek().type === 'COMMA')
+                    this.consume('COMMA'); // Optional commas
+            }
+            this.consume('RPAREN');
+            node.arguments = args;
+        }
+        // Support selection set: { id name posts { title } }
+        if (this.peek().type === 'LBRACE') {
+            this.consume('LBRACE');
+            const fields = [];
+            while (this.peek().type !== 'RBRACE') {
+                const fieldName = this.peek().value;
+                // Check if it has a selection set or arguments → it's a nested node
+                const nextToken = this.tokens[this.cursor + 1];
+                // Advanced lookahead for nested nodes or aliases
+                const isNested = nextToken && (nextToken.type === 'LBRACE' || nextToken.type === 'LPAREN' || nextToken.type === 'COLON');
+                if (isNested) {
+                    fields.push(this.parseNode());
+                }
+                else if (this.peek().type === 'STAR') {
+                    this.consume('STAR');
+                    fields.push('*');
+                }
+                else {
+                    this.consume('NAME');
+                    fields.push(this.tokens[this.cursor - 1].value);
+                }
+            }
+            this.consume('RBRACE');
+            node.fields = fields;
+        }
+        return node;
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/server/src/parser/parser.js.map

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

package/dist/server/src/parser/tokenizer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * QuickQL Lexer (Tokenizer)
+ *
+ * Scans raw QuickQL string input and produces a stream of tokens
+ * for the syntax parser.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { Token } from './types';
+export declare class Tokenizer {
+    private input;
+    private cursor;
+    constructor(input: string);
+    tokenize(): Token[];
+}
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/server/src/parser/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../../src/parser/tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAa,MAAM,SAAS,CAAC;AAE3C,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAK;gBAEP,KAAK,EAAE,MAAM;IAIzB,QAAQ,IAAI,KAAK,EAAE;CAmFpB"}