@quickql/server 1.0.0

package/dist/server/src/engine.js

@@ -0,0 +1,422 @@
+/**
+ * QuickQL Server Engine
+ *
+ * Central orchestration layer for parsing, validating, and executing QuickQL requests.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { QueryValidator } from './validator';
+import { QueryExecutor } from './executor';
+import { SecurityEngine } from './security';
+import { formatError, QuickQLServiceError } from './errors';
+import { Tokenizer } from './parser/tokenizer';
+import { Parser } from './parser/parser';
+import { Transformer } from './parser/transformer';
+import { ResolverGenerator } from './resolver/generator';
+export class QuickQLServer {
+    options;
+    validator;
+    executor;
+    security;
+    cache = new Map();
+    activePlugins = [];
+    constructor(options) {
+        let finalSchema = options.schema || {};
+        if (options.schemaOptions) {
+            Object.entries(options.schemaOptions.collections).forEach(([key, col]) => {
+                finalSchema[key] = {
+                    fields: col.fields,
+                    relations: this.mapRelations(col),
+                    resolver: ResolverGenerator.generateResolver(col),
+                    mutationResolver: ResolverGenerator.generateMutationResolver(col)
+                };
+            });
+        }
+        this.options = {
+            schema: finalSchema,
+            schemaOptions: options.schemaOptions,
+            orm: options.orm,
+            maxDepth: options.maxDepth || 10,
+            rateLimit: options.rateLimit || 0,
+            maxComplexity: options.maxComplexity || 1000,
+            cors: options.cors ?? true,
+            plugins: options.plugins || [],
+            debug: options.debug ?? false,
+            playground: options.playground ?? true,
+            context: options.context || (async () => ({ orm: options.orm })),
+            auth: options.auth || {},
+            rbac: options.rbac || { roles: {} },
+            cache: options.cache || { enabled: true, ttl: 5000, maxItems: 1000 },
+            logging: options.logging || { level: 'info' },
+            directives: options.directives || [],
+            transformers: options.transformers || {},
+            errors: options.errors || { maskInternalErrors: false },
+            features: {
+                smartCollectionMatching: true,
+                smartRelationDiscovery: true,
+                superSelection: true,
+                smartHints: true,
+                ...options.features
+            },
+            transactionWrapper: options.transactionWrapper || (async (ctx, batch) => await batch(ctx.orm))
+        };
+        this.activePlugins = [...this.options.plugins];
+        this.security = new SecurityEngine({
+            maxDepth: this.options.maxDepth,
+            rateLimit: this.options.rateLimit,
+            maxComplexity: this.options.maxComplexity,
+            rbac: this.options.rbac,
+            auth: this.options.auth
+        });
+        this.validator = new QueryValidator(this.options.schema, this.options.maxDepth, this.options.schemaOptions, this.options.features);
+        this.executor = new QueryExecutor(this.options.schema, this.options.features, this.options.directives);
+    }
+    use(plugin) {
+        this.activePlugins.push(plugin);
+        return this;
+    }
+    getOptions() {
+        return this.options;
+    }
+    getSchemaSummary() {
+        return Object.entries(this.options.schema).map(([name, col]) => ({
+            name,
+            fields: col.fields,
+            relations: col.relations ? Object.entries(col.relations).map(([k, r]) => ({ name: k, target: r.from })) : []
+        }));
+    }
+    mapRelations(col) {
+        if (!col.relations)
+            return undefined;
+        const relations = {};
+        Object.entries(col.relations).forEach(([key, rel]) => {
+            relations[key] = {
+                from: rel.model,
+                isSingle: rel.type === 'one',
+                ...rel
+            };
+        });
+        return relations;
+    }
+    /**
+     * Main Entry Point with security enforcement and context building.
+     */
+    async handleRequest(requestInput, reqCtx) {
+        const startTime = Date.now();
+        const identifier = reqCtx?.ip || 'anon_user';
+        try {
+            // Apply global input transformations
+            const transformedInput = this.options.transformers?.onInput
+                ? this.options.transformers.onInput(requestInput)
+                : requestInput;
+            // Rate limiting enforcement
+            this.security.checkRateLimit(identifier);
+            // Build initial request context
+            const baseCtx = await this.options.context(transformedInput);
+            let ctx = {
+                ...baseCtx,
+                orm: this.options.orm,
+                ip: identifier
+            };
+            // Execute global authentication strategies
+            if (this.options.auth?.onAuth) {
+                const authResult = await this.options.auth.onAuth(ctx);
+                if (authResult === false) {
+                    throw new QuickQLServiceError('SECURITY', 'Authentication failed');
+                }
+                if (typeof authResult === 'object') {
+                    ctx = { ...ctx, ...authResult };
+                }
+            }
+            let request;
+            // Parsing syntax ... (omitted for brevity)
+            if (typeof transformedInput === 'string') {
+                const tokenizer = new Tokenizer(transformedInput);
+                const tokens = tokenizer.tokenize();
+                const parser = new Parser(tokens);
+                const ast = parser.parse();
+                request = Transformer.transformSchema(ast);
+                this.processSyntaxMutations(request);
+            }
+            else {
+                request = transformedInput;
+            }
+            // Handle operations with full context!
+            let response;
+            if (request.transaction && request.batch) {
+                // Execute batch as an atomic transaction
+                const results = await this.options.transactionWrapper(ctx, async (tx) => {
+                    const transactionalCtx = { ...ctx, orm: tx };
+                    return await Promise.all(request.batch.map(item => 'type' in item ? this.processMutation(item, transactionalCtx) : this.processQuery(item, transactionalCtx)));
+                });
+                response = { data: results };
+            }
+            else if (request.batch && Array.isArray(request.batch)) {
+                // Parallel batch execution with deduplication
+                const queryMap = new Map();
+                const results = await Promise.all(request.batch.map(async (item) => {
+                    const key = JSON.stringify(item);
+                    const existing = queryMap.get(key);
+                    if (existing)
+                        return existing;
+                    const execution = 'type' in item ? this.processMutation(item, ctx) : this.processQuery(item, ctx);
+                    queryMap.set(key, execution);
+                    return execution;
+                }));
+                response = { data: results };
+            }
+            else if (request.queries) {
+                const queryNames = Object.keys(request.queries);
+                if (queryNames.length === 1) {
+                    response = await this.processQuery(request.queries[queryNames[0]], ctx);
+                }
+                else {
+                    const dataResults = {};
+                    await Promise.all(queryNames.map(async (name) => {
+                        const resp = await this.processQuery(request.queries[name], ctx);
+                        dataResults[name] = resp.data;
+                    }));
+                    response = { data: dataResults };
+                }
+            }
+            else if (request.mutations) {
+                const mutationNames = Object.keys(request.mutations);
+                if (mutationNames.length === 1) {
+                    response = await this.processMutation(request.mutations[mutationNames[0]], ctx);
+                }
+                else {
+                    const dataResults = {};
+                    await Promise.all(mutationNames.map(async (name) => {
+                        const resp = await this.processMutation(request.mutations[name], ctx);
+                        dataResults[name] = resp.data;
+                    }));
+                    response = { data: dataResults };
+                }
+            }
+            else {
+                throw new QuickQLServiceError('VALIDATION', 'Empty or invalid request');
+            }
+            const executionTime = Date.now() - startTime;
+            const finalResponse = {
+                ...response,
+                meta: { ...response.meta, executionTime }
+            };
+            // 4. Global Output Transformer
+            const output = this.options.transformers?.onOutput
+                ? this.options.transformers.onOutput(finalResponse)
+                : finalResponse;
+            this.log(`DEBUG: Final Response in ${executionTime}ms`, output);
+            return output;
+        }
+        catch (e) {
+            await this.runOnErrorHook(e, { orm: this.options.orm }); // Minimal ctx if building failed
+            this.log('ERROR: Exception caught in handleRequest', e);
+            const standardError = formatError(e, this.options.debug);
+            if (this.options.errors?.format) {
+                return this.options.errors.format(standardError, this.options.debug);
+            }
+            return standardError;
+        }
+    }
+    processSyntaxMutations(request) {
+        // Already defined in previous version ...
+        if (request.queries && this.options.schemaOptions?.mutations) {
+            const mutations = request.mutations || {};
+            for (const [key, node] of Object.entries(request.queries)) {
+                if (this.options.schemaOptions.mutations[node.from]) {
+                    mutations[key] = { ...node, collection: node.from, type: 'update' };
+                    delete request.queries[key];
+                }
+            }
+            if (Object.keys(mutations).length > 0)
+                request.mutations = mutations;
+            if (Object.keys(request.queries).length === 0)
+                delete request.queries;
+        }
+    }
+    async processQuery(query, ctx) {
+        const cacheKey = JSON.stringify({ query, user: ctx.user?.id });
+        const cached = this.cache.get(cacheKey);
+        if (cached && cached.expiry > Date.now())
+            return cached.value;
+        try {
+            this.log('DEBUG: Processing Query', query);
+            // 1. Authorization & Security
+            const col = this.options.schemaOptions?.collections[query.from];
+            if (col) {
+                await this.security.validateAuth(query.from, col, ctx);
+            }
+            let processedQuery = this.security.sanitize(query);
+            processedQuery = await this.runBeforeQueryHook(processedQuery, ctx);
+            this.validator.validateQuery(processedQuery);
+            this.security.validateDepth(processedQuery);
+            // 2. Execute
+            const rawData = await this.executor.execute(processedQuery, 0, ctx);
+            // 3. Field level security / Private fields
+            let finalData = rawData;
+            if (col) {
+                finalData = await this.security.filterResults(col, rawData, ctx);
+            }
+            // 4. After Hook & Response
+            finalData = await this.runAfterQueryHook(finalData, ctx);
+            const response = {
+                data: finalData,
+                meta: {
+                    count: Array.isArray(finalData) ? finalData.length : 0,
+                    hints: this.options.features.smartHints ? this.generateSmartHints(query, finalData) : undefined
+                }
+            };
+            this.cache.set(cacheKey, { value: response, expiry: Date.now() + 5000 });
+            // Simple cache management
+            if (this.cache.size > 1000) {
+                const firstKey = this.cache.keys().next().value;
+                if (firstKey)
+                    this.cache.delete(firstKey);
+            }
+            return response;
+        }
+        catch (e) {
+            await this.runOnErrorHook(e, ctx);
+            return formatError(e, this.options.debug);
+        }
+    }
+    async processMutation(mutation, ctx) {
+        try {
+            this.log('DEBUG: Processing Mutation', mutation);
+            // 0. Plugin Transformation BEFORE anything
+            const processedMutation = await this.runBeforeMutationHook(mutation, ctx);
+            // 1. Global Custom Mutation Auth
+            const customMutation = this.options.schemaOptions?.mutations?.[processedMutation.collection];
+            if (customMutation) {
+                await this.security.validateAuth(processedMutation.collection, customMutation, ctx, true);
+                const data = await customMutation.resolve(processedMutation.data || processedMutation.where, ctx);
+                this.cache.clear();
+                await this.runOnMutationHook(processedMutation, ctx);
+                return { data: data };
+            }
+            // 2. Standard Collection Auth
+            const col = this.options.schemaOptions?.collections[processedMutation.collection];
+            if (col) {
+                await this.security.validateAuth(processedMutation.collection, col, ctx, true);
+            }
+            this.validator.validateMutation(processedMutation);
+            const data = await this.executor.executeMutation(processedMutation, ctx);
+            this.cache.clear();
+            await this.runOnMutationHook(processedMutation, ctx);
+            return { data: data };
+        }
+        catch (e) {
+            await this.runOnErrorHook(e, ctx);
+            return formatError(e, this.options.debug);
+        }
+    }
+    // Internal hook runners for plugin lifecycle management
+    async shouldRunHook(plugin, ctx) {
+        if (!plugin.when)
+            return true;
+        try {
+            return await plugin.when(ctx);
+        }
+        catch (e) {
+            return false;
+        }
+    }
+    async runBeforeQueryHook(query, ctx) {
+        let currentQuery = query;
+        for (const plugin of this.activePlugins) {
+            if (plugin.beforeQuery && await this.shouldRunHook(plugin, ctx)) {
+                const result = await plugin.beforeQuery(currentQuery, ctx);
+                if (result)
+                    currentQuery = result;
+            }
+        }
+        return currentQuery;
+    }
+    async runAfterQueryHook(data, ctx) {
+        let currentData = data;
+        for (const plugin of this.activePlugins) {
+            if (plugin.afterQuery && await this.shouldRunHook(plugin, ctx)) {
+                const result = await plugin.afterQuery(currentData, ctx);
+                if (result)
+                    currentData = result;
+            }
+        }
+        return currentData;
+    }
+    async runOnMutationHook(mutation, ctx) {
+        for (const plugin of this.activePlugins) {
+            if (plugin.onMutation && await this.shouldRunHook(plugin, ctx)) {
+                await plugin.onMutation(mutation, ctx);
+            }
+        }
+    }
+    async runBeforeMutationHook(mutation, ctx) {
+        let current = mutation;
+        for (const plugin of this.activePlugins) {
+            if (plugin.beforeMutation && await this.shouldRunHook(plugin, ctx)) {
+                const result = await plugin.beforeMutation(current, ctx);
+                if (result)
+                    current = result;
+            }
+        }
+        return current;
+    }
+    async runOnErrorHook(error, ctx) {
+        for (const plugin of this.activePlugins) {
+            if (plugin.onError && await this.shouldRunHook(plugin, ctx)) {
+                await plugin.onError(error, ctx);
+            }
+        }
+    }
+    generateSmartHints(query, results) {
+        const hints = [];
+        if (!query.limit || query.limit > 100) {
+            hints.push('TIP: Adding a "limit" can improve query performance.');
+        }
+        if (results.length > 50 && !query.orderBy) {
+            hints.push('WARN: Large un-ordered result set detected. Performance may degrade.');
+        }
+        if (query.include) {
+            const depth = JSON.stringify(query.include).split('include').length;
+            if (depth > 3) {
+                hints.push('INFO: Query complexity is high. Monitor execution time.');
+            }
+        }
+        return hints;
+    }
+    log(message, ...args) {
+        const config = this.options.logging;
+        if (config.level === 'none')
+            return;
+        const level = message.split(':')[0] || 'INFO';
+        const timestamp = new Date().toLocaleTimeString();
+        if (config.customLogger) {
+            config.customLogger(level, message, args);
+            return;
+        }
+        const colorMap = {
+            'DEBUG': '\x1b[36m',
+            'ERROR': '\x1b[31m',
+            'WARN': '\x1b[33m',
+            'INFO': '\x1b[32m'
+        };
+        const color = colorMap[level] || '\x1b[0m';
+        console.log(`${color}[QuickQL][${timestamp}]\x1b[0m ${message}`);
+        if (this.options.debug) {
+            args.forEach(arg => {
+                if (arg instanceof Error) {
+                    console.error(`\x1b[31m[Stacktrace]\x1b[0m ${arg.stack}`);
+                }
+                else {
+                    console.dir(arg, { depth: null, colors: true });
+                }
+            });
+        }
+    }
+}
+export function createServer(options) {
+    return new QuickQLServer(options);
+}
+//# sourceMappingURL=engine.js.map

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

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

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

@@ -0,0 +1,31 @@
+import { QuickQLError, QuickQLResponse } from '@quickql/core';
+/**
+ * Built-in QuickQL Server Exception
+ */
+export declare class QuickQLServiceError extends Error implements QuickQLError {
+    type: QuickQLError['type'];
+    message: string;
+    code?: string | undefined;
+    path?: string[] | undefined;
+    constructor(type: QuickQLError['type'], message: string, code?: string | undefined, path?: string[] | undefined);
+    toJSON(includeStack?: boolean): {
+        type: "VALIDATION" | "NETWORK" | "AUTH" | "INTERNAL" | "NOT_FOUND" | "SECURITY";
+        message: string;
+        code: string;
+        path: string[] | undefined;
+        stack: string | undefined;
+    };
+}
+/**
+ * Global Error Formatter
+ */
+export declare function formatError(error: unknown, debug?: boolean): QuickQLResponse;
+export declare const createValidationError: (message: string, path?: string[]) => QuickQLServiceError;
+export declare const createNotFoundError: (message: string, path?: string[]) => QuickQLServiceError;
+export declare const createSecurityError: (message: string, path?: string[]) => QuickQLServiceError;
+export declare const createAuthError: (message: string, path?: string[]) => QuickQLServiceError;
+/**
+ * Maps QuickQL error types to HTTP status codes
+ */
+export declare function getHttpStatusCode(response: QuickQLResponse): number;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE9D;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAM,YAAW,YAAY;IAE3D,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM;IACf,IAAI,CAAC,EAAE,MAAM;IACb,IAAI,CAAC,EAAE,MAAM,EAAE;gBAHf,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAC1B,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,IAAI,CAAC,EAAE,MAAM,EAAE,YAAA;IASxB,MAAM,CAAC,YAAY,GAAE,OAAe;;;;;;;CASrC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,OAAe,GAAG,eAAe,CAkBnF;AAED,eAAO,MAAM,qBAAqB,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,EAAE,wBACK,CAAC;AAE5E,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,EAAE,wBACO,CAAC;AAE5E,eAAO,MAAM,mBAAmB,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,EAAE,wBACM,CAAC;AAE3E,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,EAAE,wBACA,CAAC;AAEjE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAUnE"}

package/dist/server/src/errors.js

@@ -0,0 +1,73 @@
+/**
+ * Built-in QuickQL Server Exception
+ */
+export class QuickQLServiceError extends Error {
+    type;
+    message;
+    code;
+    path;
+    constructor(type, message, code, path) {
+        super(message);
+        this.type = type;
+        this.message = message;
+        this.code = code;
+        this.path = path;
+        this.name = 'QuickQLServiceError';
+        // Ensure the prototype is correct for instanceof checks
+        Object.setPrototypeOf(this, QuickQLServiceError.prototype);
+    }
+    toJSON(includeStack = false) {
+        return {
+            type: this.type,
+            message: this.message,
+            code: this.code || this.name,
+            path: this.path,
+            stack: includeStack ? this.stack : undefined
+        };
+    }
+}
+/**
+ * Global Error Formatter
+ */
+export function formatError(error, debug = false) {
+    if (error instanceof QuickQLServiceError) {
+        return {
+            data: null,
+            errors: [error.toJSON(debug)]
+        };
+    }
+    const err = error;
+    return {
+        data: null,
+        errors: [{
+                type: 'INTERNAL',
+                message: err.message || 'An unknown internal error occurred',
+                code: 'INTERNAL_SERVER_ERROR',
+                stack: debug ? err.stack : undefined
+            }]
+    };
+}
+export const createValidationError = (message, path) => new QuickQLServiceError('VALIDATION', message, 'VALIDATION_FAILED', path);
+export const createNotFoundError = (message, path) => new QuickQLServiceError('NOT_FOUND', message, 'RESOURCE_NOT_FOUND', path);
+export const createSecurityError = (message, path) => new QuickQLServiceError('SECURITY', message, 'SECURITY_VIOLATION', path);
+export const createAuthError = (message, path) => new QuickQLServiceError('AUTH', message, 'UNAUTHORIZED', path);
+/**
+ * Maps QuickQL error types to HTTP status codes
+ */
+export function getHttpStatusCode(response) {
+    if (!response.errors || response.errors.length === 0)
+        return 200;
+    const types = response.errors.map(e => e.type);
+    if (types.includes('INTERNAL'))
+        return 500;
+    if (types.includes('AUTH'))
+        return 401;
+    if (types.includes('SECURITY'))
+        return 403;
+    if (types.includes('NOT_FOUND'))
+        return 404;
+    if (types.includes('VALIDATION'))
+        return 400;
+    return 444; // Edge case
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAEnC;IACA;IACA;IACA;IAJT,YACS,IAA0B,EAC1B,OAAe,EACf,IAAa,EACb,IAAe;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QALR,SAAI,GAAJ,IAAI,CAAsB;QAC1B,YAAO,GAAP,OAAO,CAAQ;QACf,SAAI,GAAJ,IAAI,CAAS;QACb,SAAI,GAAJ,IAAI,CAAW;QAGtB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAElC,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,eAAwB,KAAK;QAClC,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SAC7C,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,QAAiB,KAAK;IAChE,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;SAC9B,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,KAAc,CAAC;IAC3B,OAAO;QACL,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,CAAC;gBACP,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,oCAAoC;gBAC5D,IAAI,EAAE,uBAAuB;gBAC7B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACrC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAe,EAAE,IAAe,EAAE,EAAE,CACxE,IAAI,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,IAAe,EAAE,EAAE,CACtE,IAAI,mBAAmB,CAAC,WAAW,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAE,IAAe,EAAE,EAAE,CACtE,IAAI,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAAE,IAAe,EAAE,EAAE,CAClE,IAAI,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAyB;IACzD,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAEjE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,GAAG,CAAC;IACvC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5C,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,GAAG,CAAC;IAC7C,OAAO,GAAG,CAAC,CAAC,YAAY;AAC1B,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * 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 { Query, Mutation } from '@quickql/core';
+import { SchemaConfig, ServerFeatures, DirectiveConfig } from './types';
+export declare class QueryExecutor {
+    private schema;
+    private features;
+    private directives;
+    private relationEngine;
+    constructor(schema: SchemaConfig, features?: ServerFeatures, directives?: DirectiveConfig[]);
+    private collectionCache;
+    private resolveCollectionName;
+    execute(query: Query, depth?: number, ctx?: any): Promise<Record<string, unknown>[]>;
+    executeMutation(mutation: Mutation, ctx?: any): Promise<Record<string, unknown> | null>;
+    private applySelection;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAIxE,qBAAa,aAAa;IAItB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,UAAU;IATpB,OAAO,CAAC,cAAc,CAAiB;gBAG7B,MAAM,EAAE,YAAY,EACpB,QAAQ,GAAE,cAIjB,EACO,UAAU,GAAE,eAAe,EAAO;IAK5C,OAAO,CAAC,eAAe,CAAoC;IAE3D,OAAO,CAAC,qBAAqB;IAmCvB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,SAAI,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAoC/E,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAM7F,OAAO,CAAC,cAAc;CAyCvB"}