@quickql/server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Udinmo Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# @quickql/server
+
+A high-performance, schema-driven API engine with native relational mapping and enterprise security by **Udinmo Inc.**
+
+## Features
+
+- **🚀 Ultra-Fast Relations**: Native $O(N+M)$ relation resolver that eliminates the N+1 problem without DataLoaders.
+- **🔐 Enterprise Security**: Integrated RBAC (Role-Based Access Control), depth limiting, and complexity scoring.
+- **🛠️ Zero-Boilerplate**: Fully automated resolver mapping for Prisma and other standard ORMs.
+- **📦 Multi-Strategy Auth**: Built-in hooks for JWT, API Keys, and custom authentication.
+- **🎨 Supreme Console**: A premium browser IDE for exploring your schema, traversing data relations, and testing queries.
+- **⚡ Atomic Transactions**: Native support for batch mutation transactions at the engine level.
+
+## Getting Started
+
+### Installation
+
+```bash
+npm install @quickql/server
+```
+
+### Basic Server Initialization
+
+```typescript
+import { createServer } from '@quickql/server';
+import { PrismaClient } from '@prisma/client';
+
+const orm = new PrismaClient();
+
+const server = createServer({
+  orm,
+  schema: {
+    users: {
+      model: 'User',
+      fields: ['id', 'email', 'name'],
+      relations: {
+        posts: { type: 'many', model: 'Post', foreignKey: 'userId' }
+      }
+    }
+  },
+  auth: {
+    secret: 'udinmo-secret-123'
+  },
+  rbac: {
+    roles: {
+      'admin': { can: ['*'], write: ['*'] },
+      'user': { can: ['users', 'posts'] }
+    }
+  }
+});
+
+// Use it with any HTTP framework (e.g. Express)
+app.post('/quickql', async (req, res) => {
+  const result = await server.handleRequest(req.body, { ip: req.ip });
+  res.json(result);
+});
+```
+
+## Advanced Customization
+
+### Directives
+Extend the query language with custom `@tags`:
+
+```typescript
+const server = createServer({
+  directives: [
+    {
+      name: 'upper',
+      handler: (results) => results.map(row => ({ ...row, name: row.name?.toUpperCase() }))
+    }
+  ]
+});
+```
+
+### Lifecycle Hooks (Plugins)
+Intercept any part of the execution flow:
+
+```typescript
+server.use({
+  name: 'audit-plugin',
+  onMutation: async (m, ctx) => {
+    console.log(`[AUDIT] Created ${m.collection} by ${ctx.user.id}`);
+  }
+});
+```
+
+## License
+
+(c) 2024-2026 Udinmo Inc. All rights reserved.
+MIT Licensed — see LICENSE for details.
+Author: [Udinmo Inc.](https://udinmo.com)

package/dist/core/src/client.d.ts

@@ -0,0 +1,57 @@
+/**
+ * QuickQL Core Client
+ *
+ * Standard HTTP client for interacting with QuickQL servers across
+ * all JavaScript environments. Handles batching, caching, and plugins.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { Query, Mutation, QuickQLRequest, QuickQLResponse, QuickQLError } from './types';
+export interface ClientOptions {
+    endpoint: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    retry?: number;
+    cacheTTL?: number;
+    plugins?: QuickQLPlugin[];
+}
+export type LifecycleHook = 'beforeRequest' | 'afterResponse' | 'onError';
+export interface QuickQLPlugin {
+    name: string;
+    onBeforeRequest?: (request: QuickQLRequest, context: any) => QuickQLRequest | Promise<QuickQLRequest>;
+    onAfterResponse?: (response: QuickQLResponse, context: any) => QuickQLResponse | Promise<QuickQLResponse>;
+    onError?: (error: QuickQLError, context: any) => void | Promise<void>;
+}
+/**
+ * Universal QuickQL Client for Browser and Node.js
+ */
+export declare class QuickQLClient {
+    private cache;
+    private options;
+    constructor(options: ClientOptions);
+    /**
+     * Main Query operation.
+     */
+    query<T = any>(query: Query, alias?: string): Promise<QuickQLResponse<T>>;
+    /**
+     * Main Mutation operation.
+     */
+    mutation<T = any>(mutation: Mutation, alias?: string): Promise<QuickQLResponse<T>>;
+    /**
+     * Batch multiple queries and mutations.
+     */
+    batch(items: (Query | Mutation)[], transaction?: boolean): Promise<QuickQLResponse<any>>;
+    /**
+     * Low-level execution logic with plugin support.
+     */
+    private execute;
+    private handleError;
+    private getCacheKey;
+    private getFromCache;
+    private setInCache;
+    clearCache(): void;
+    setHeaders(headers: Record<string, string>): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/core/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../core/src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAC/D,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACtG,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1G,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAqD;IAClE,OAAO,CAAC,OAAO,CAA0B;gBAE7B,OAAO,EAAE,aAAa;IAelC;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,MAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAoBvF;;OAEG;IACG,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAWhG;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAS5F;;OAEG;YACW,OAAO;IAgDrB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,UAAU;IASX,UAAU;IAIV,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGlD"}

package/dist/core/src/client.js

@@ -0,0 +1,164 @@
+/**
+ * QuickQL Core Client
+ *
+ * Standard HTTP client for interacting with QuickQL servers across
+ * all JavaScript environments. Handles batching, caching, and plugins.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+/**
+ * Universal QuickQL Client for Browser and Node.js
+ */
+export class QuickQLClient {
+    cache = new Map();
+    options;
+    constructor(options) {
+        this.options = {
+            endpoint: options.endpoint,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-QuickQL-Version': '1.0.0',
+                ...(options.headers || {})
+            },
+            timeout: options.timeout || 15000,
+            retry: options.retry || 1,
+            cacheTTL: options.cacheTTL || 0,
+            plugins: options.plugins || []
+        };
+    }
+    /**
+     * Main Query operation.
+     */
+    async query(query, alias = 'data') {
+        const key = this.getCacheKey({ query, alias });
+        const cached = this.getFromCache(key);
+        if (cached)
+            return cached;
+        try {
+            const response = await this.execute({
+                queries: { [alias]: query }
+            });
+            const res = response;
+            if (res.data && !res.errors) {
+                this.setInCache(key, res);
+            }
+            return res;
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    /**
+     * Main Mutation operation.
+     */
+    async mutation(mutation, alias = 'data') {
+        try {
+            const response = await this.execute({
+                mutations: { [alias]: mutation }
+            });
+            return response;
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    /**
+     * Batch multiple queries and mutations.
+     */
+    async batch(items, transaction = false) {
+        try {
+            const response = await this.execute({ batch: items, transaction });
+            return response;
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    /**
+     * Low-level execution logic with plugin support.
+     */
+    async execute(request, retries = this.options.retry) {
+        let currentRequest = request;
+        // Trigger onBeforeRequest hooks
+        for (const plugin of this.options.plugins) {
+            if (plugin.onBeforeRequest) {
+                currentRequest = await plugin.onBeforeRequest(currentRequest, this);
+            }
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.options.timeout);
+        try {
+            const response = await fetch(this.options.endpoint, {
+                method: 'POST',
+                headers: this.options.headers,
+                body: JSON.stringify(currentRequest),
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`QuickQL Client Error: ${response.status} ${response.statusText}`);
+            }
+            let data = await response.json();
+            // Trigger onAfterResponse hooks
+            for (const plugin of this.options.plugins) {
+                if (plugin.onAfterResponse) {
+                    data = await plugin.onAfterResponse(data, this);
+                }
+            }
+            return data;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (retries > 0 && error.name !== 'AbortError') {
+                return this.execute(request, retries - 1);
+            }
+            throw error;
+        }
+    }
+    handleError(error) {
+        const isTimeout = error.name === 'AbortError';
+        const quickError = {
+            type: isTimeout ? 'NETWORK' : 'INTERNAL',
+            message: error.message || 'Unknown QuickQL Client error',
+            code: isTimeout ? 'TIMEOUT' : 'CLIENT_EXCEPTION'
+        };
+        // Trigger plugins
+        for (const plugin of this.options.plugins) {
+            if (plugin.onError) {
+                plugin.onError(quickError, this);
+            }
+        }
+        return {
+            data: null,
+            errors: [quickError]
+        };
+    }
+    getCacheKey(request) {
+        return JSON.stringify(request);
+    }
+    getFromCache(key) {
+        const cached = this.cache.get(key);
+        if (cached && cached.expiry > Date.now()) {
+            return cached.value;
+        }
+        this.cache.delete(key);
+        return null;
+    }
+    setInCache(key, value) {
+        if (this.options.cacheTTL > 0) {
+            this.cache.set(key, {
+                value,
+                expiry: Date.now() + this.options.cacheTTL
+            });
+        }
+    }
+    clearCache() {
+        this.cache.clear();
+    }
+    setHeaders(headers) {
+        this.options.headers = { ...this.options.headers, ...headers };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/core/src/client.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * QuickQL Core SDK
+ *
+ * Shared logic and client for the QuickQL ecosystem.
+ * Managed by Udinmo Inc.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+export * from './types';
+export * from './client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/dist/core/src/index.js

@@ -0,0 +1,13 @@
+/**
+ * QuickQL Core SDK
+ *
+ * Shared logic and client for the QuickQL ecosystem.
+ * Managed by Udinmo Inc.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+export * from './types';
+export * from './client';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../core/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * QuickQL Core Types
+ *
+ * Shared type definitions for queries, mutations, and responses.
+ * Ensured parity between server and client expectations.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+/**
+ * QuickQL Core Types - Refined for Production
+ */
+export type Operator = 'eq' | 'ne' | 'gt' | 'lt' | 'in' | 'contains' | 'startsWith' | 'endsWith';
+export type WhereValue = string | number | boolean | Array<string | number | boolean> | null;
+export type WhereCondition = {
+    [operator in Operator]?: WhereValue;
+} | WhereValue;
+export type LogicalCondition = {
+    AND?: (WhereClause | LogicalCondition)[];
+    OR?: (WhereClause | LogicalCondition)[];
+};
+export type WhereClause = {
+    [field: string]: WhereCondition | LogicalCondition;
+};
+export type IncludeClause = {
+    [relation: string]: Partial<Query>;
+};
+export type OrderDirection = 'asc' | 'desc';
+export type OrderBy = {
+    [field: string]: OrderDirection;
+};
+export interface Query {
+    from: string;
+    select?: string[];
+    alias?: string;
+    where?: WhereClause | LogicalCondition;
+    include?: IncludeClause;
+    limit?: number;
+    offset?: number;
+    orderBy?: OrderBy;
+    aggregate?: {
+        count?: boolean;
+        sum?: string;
+        avg?: string;
+        max?: string;
+        min?: string;
+    };
+    directives?: Record<string, any>;
+}
+export type MutationType = 'create' | 'update' | 'delete';
+export interface Mutation {
+    type: MutationType;
+    collection: string;
+    data?: Record<string, unknown>;
+    where?: WhereClause | LogicalCondition;
+    select?: string[];
+}
+export interface QuickQLRequest {
+    queries?: Record<string, Query>;
+    mutations?: Record<string, Mutation>;
+    batch?: (Query | Mutation)[];
+    transaction?: boolean;
+}
+export interface QuickQLError {
+    type: 'VALIDATION' | 'NETWORK' | 'AUTH' | 'INTERNAL' | 'NOT_FOUND' | 'SECURITY';
+    message: string;
+    code?: string;
+    path?: string[];
+    stack?: string;
+}
+export interface QuickQLResponse<T = unknown> {
+    data: T | null;
+    errors?: QuickQLError[];
+    meta?: {
+        count?: number;
+        total?: number;
+        executionTime?: number;
+        hints?: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../core/src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;AAEjG,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;AAE7F,MAAM,MAAM,cAAc,GAAG;KAC1B,QAAQ,IAAI,QAAQ,CAAC,CAAC,EAAE,UAAU;CACpC,GAAG,UAAU,CAAC;AAEf,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,EAAE,CAAC,WAAW,GAAG,gBAAgB,CAAC,EAAE,CAAC;IACzC,EAAE,CAAC,EAAE,CAAC,WAAW,GAAG,gBAAgB,CAAC,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,gBAAgB,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAC;AAE5C,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,GAAG,gBAAgB,CAAC;IACvC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,WAAW,GAAG,gBAAgB,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH"}

package/dist/core/src/types.js

@@ -0,0 +1,12 @@
+/**
+ * QuickQL Core Types
+ *
+ * Shared type definitions for queries, mutations, and responses.
+ * Ensured parity between server and client expectations.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/src/types.js.map

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

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

@@ -0,0 +1,55 @@
+/**
+ * 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 { QuickQLResponse, QuickQLRequest } from '@quickql/core';
+import { SchemaConfig, ServerOptions, QuickQLPlugin, ServerFeatures } from './types';
+import { SchemaOptions } from './schema/types';
+export interface ExtendedServerOptions extends Partial<ServerOptions> {
+    schema?: SchemaConfig;
+    orm?: any;
+    schemaOptions?: SchemaOptions;
+    features?: ServerFeatures;
+}
+export declare class QuickQLServer {
+    private options;
+    private validator;
+    private executor;
+    private security;
+    private cache;
+    private activePlugins;
+    constructor(options: ExtendedServerOptions);
+    use(plugin: QuickQLPlugin): this;
+    getOptions(): Required<ExtendedServerOptions>;
+    getSchemaSummary(): {
+        name: string;
+        fields: string[] | Record<string, any>;
+        relations: {
+            name: string;
+            target: string;
+        }[];
+    }[];
+    private mapRelations;
+    /**
+     * Main Entry Point with security enforcement and context building.
+     */
+    handleRequest(requestInput: QuickQLRequest | string, reqCtx?: any): Promise<QuickQLResponse>;
+    private processSyntaxMutations;
+    private processQuery;
+    private processMutation;
+    private shouldRunHook;
+    private runBeforeQueryHook;
+    private runAfterQueryHook;
+    private runOnMutationHook;
+    private runBeforeMutationHook;
+    private runOnErrorHook;
+    private generateSmartHints;
+    private log;
+}
+export declare function createServer(options: ExtendedServerOptions): QuickQLServer;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAmB,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAwB,cAAc,EAAE,MAAM,SAAS,CAAC;AAS3G,OAAO,EAAE,aAAa,EAAwB,MAAM,gBAAgB,CAAC;AAErE,MAAM,WAAW,qBAAsB,SAAQ,OAAO,CAAC,aAAa,CAAC;IACnE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAiE;IAC9E,OAAO,CAAC,aAAa,CAAuB;gBAEhC,OAAO,EAAE,qBAAqB;IA4DnC,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAKhC,UAAU,IAAI,QAAQ,CAAC,qBAAqB,CAAC;IAI7C,gBAAgB;;;;;;;;IAQvB,OAAO,CAAC,YAAY;IAapB;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,cAAc,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAkIlG,OAAO,CAAC,sBAAsB;YAehB,YAAY;YAuDZ,eAAe;YAsCf,aAAa;YAKb,kBAAkB;YAWlB,iBAAiB;YAWjB,iBAAiB;YAQjB,qBAAqB;YAWrB,cAAc;IAQ5B,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,GAAG;CAgCZ;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,CAE1E"}