@quickql/vue 1.0.0

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/vue/src/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * QuickQL Vue Bindings
+ *
+ * Provides Vue 3 Composition API utilities (useQuickQL) and Plugin
+ * integration (createQuickQL) for reactive data fetching in Vue applications.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { QuickQLClient, ClientOptions, QuickQLError } from '@quickql/core';
+/**
+ * Universal QuickQL Plugin for Vue Apps
+ */
+export declare const createQuickQL: (options: ClientOptions | QuickQLClient) => {
+    install(app: any): void;
+    client: QuickQLClient;
+};
+export declare const useQuickQLClient: () => QuickQLClient;
+/**
+ * Hook to fetch data in Vue Components using Composition API.
+ */
+export declare const useQuickQL: <T = any>(query: any, config?: {
+    enabled?: boolean;
+}) => {
+    data: [T | null] extends [import("vue").Ref<any, any>] ? import("@vue/shared").IfAny<import("vue").Ref<any, any> & T, import("vue").Ref<import("vue").Ref<any, any> & T, import("vue").Ref<any, any> & T>, import("vue").Ref<any, any> & T> : import("vue").Ref<import("vue").UnwrapRef<T> | null, T | import("vue").UnwrapRef<T> | null>;
+    loading: import("vue").Ref<boolean, boolean>;
+    error: import("vue").Ref<{
+        type: "VALIDATION" | "NETWORK" | "AUTH" | "INTERNAL" | "NOT_FOUND" | "SECURITY";
+        message: string;
+        code?: string | undefined;
+        path?: string[] | undefined;
+        stack?: string | undefined;
+    }[] | null, QuickQLError[] | {
+        type: "VALIDATION" | "NETWORK" | "AUTH" | "INTERNAL" | "NOT_FOUND" | "SECURITY";
+        message: string;
+        code?: string | undefined;
+        path?: string[] | undefined;
+        stack?: string | undefined;
+    }[] | null>;
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,aAAa,EAAE,aAAa,EAA0B,YAAY,EAAE,MAAM,eAAe,CAAC;AAInG;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,aAAa,GAAG,aAAa;iBAInD,GAAG;;CAKnB,CAAC;AAEF,eAAO,MAAM,gBAAgB,qBAM5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,SAAQ;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;;;;;;;;;;;;;CAoCjF,CAAC"}

package/dist/vue/src/index.js

@@ -0,0 +1,72 @@
+/**
+ * QuickQL Vue Bindings
+ *
+ * Provides Vue 3 Composition API utilities (useQuickQL) and Plugin
+ * integration (createQuickQL) for reactive data fetching in Vue applications.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { ref, watch, inject, isRef } from 'vue';
+import { QuickQLClient } from '@quickql/core';
+const QUICKQL_CLIENT_KEY = Symbol('quickql-client');
+/**
+ * Universal QuickQL Plugin for Vue Apps
+ */
+export const createQuickQL = (options) => {
+    const client = options instanceof QuickQLClient ? options : new QuickQLClient(options);
+    return {
+        install(app) {
+            app.provide(QUICKQL_CLIENT_KEY, client);
+        },
+        client
+    };
+};
+export const useQuickQLClient = () => {
+    const client = inject(QUICKQL_CLIENT_KEY);
+    if (!client) {
+        throw new Error('useQuickQL must be used with a QuickQL instance installed via app.use().');
+    }
+    return client;
+};
+/**
+ * Hook to fetch data in Vue Components using Composition API.
+ */
+export const useQuickQL = (query, config = {}) => {
+    const client = useQuickQLClient();
+    const data = ref(null);
+    const loading = ref(false);
+    const error = ref(null);
+    const fetchData = async () => {
+        // Resolve query value if it's a function or a Ref
+        const q = isRef(query) ? query.value : (typeof query === 'function' ? query() : query);
+        if (!q)
+            return;
+        loading.value = true;
+        error.value = null;
+        try {
+            const response = await client.query(q);
+            if (response.errors) {
+                error.value = response.errors;
+            }
+            else {
+                data.value = response.data;
+            }
+        }
+        catch (e) {
+            error.value = [{ type: 'INTERNAL', message: e.message || 'Vue Hook Error' }];
+        }
+        finally {
+            loading.value = false;
+        }
+    };
+    // Watch for changes in the query or enabled status
+    watch([() => (isRef(query) ? query.value : (typeof query === 'function' ? query() : query)), () => config.enabled], () => {
+        if (config.enabled !== false) {
+            fetchData();
+        }
+    }, { immediate: true, deep: true });
+    return { data, loading, error, refetch: fetchData };
+};
+//# sourceMappingURL=index.js.map

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

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

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@quickql/vue",
+  "version": "1.0.0",
+  "description": "Vue 3 Composition API for QuickQL by Udinmo Inc.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "author": "Udinmo Inc. <engineering@udinmo.com>",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@quickql/core": "^1.0.0"
+  },
+  "peerDependencies": {
+    "vue": "^3.x"
+  }
+}

package/src/index.ts

@@ -0,0 +1,78 @@
+/**
+ * QuickQL Vue Bindings
+ * 
+ * Provides Vue 3 Composition API utilities (useQuickQL) and Plugin 
+ * integration (createQuickQL) for reactive data fetching in Vue applications.
+ * 
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+
+import { ref, watch, onUnmounted, InjectionKey, inject, provide, onMounted, computed, isRef } from 'vue';
+import { QuickQLClient, ClientOptions, Query, QuickQLResponse, QuickQLError } from '@quickql/core';
+
+const QUICKQL_CLIENT_KEY = Symbol('quickql-client') as InjectionKey<QuickQLClient>;
+
+/**
+ * Universal QuickQL Plugin for Vue Apps
+ */
+export const createQuickQL = (options: ClientOptions | QuickQLClient) => {
+  const client = options instanceof QuickQLClient ? options : new QuickQLClient(options);
+  
+  return {
+    install(app: any) {
+      app.provide(QUICKQL_CLIENT_KEY, client);
+    },
+    client
+  };
+};
+
+export const useQuickQLClient = () => {
+  const client = inject(QUICKQL_CLIENT_KEY);
+  if (!client) {
+    throw new Error('useQuickQL must be used with a QuickQL instance installed via app.use().');
+  }
+  return client;
+};
+
+/**
+ * Hook to fetch data in Vue Components using Composition API.
+ */
+export const useQuickQL = <T = any>(query: any, config: { enabled?: boolean } = {}) => {
+  const client = useQuickQLClient();
+  
+  const data = ref<T | null>(null);
+  const loading = ref(false);
+  const error = ref<QuickQLError[] | null>(null);
+
+  const fetchData = async () => {
+    // Resolve query value if it's a function or a Ref
+    const q = isRef(query) ? query.value : (typeof query === 'function' ? query() : query);
+    if (!q) return;
+
+    loading.value = true;
+    error.value = null;
+    try {
+      const response = await client.query<T>(q);
+      if (response.errors) {
+        error.value = response.errors;
+      } else {
+        data.value = response.data;
+      }
+    } catch (e: any) {
+      error.value = [{ type: 'INTERNAL', message: e.message || 'Vue Hook Error' }];
+    } finally {
+       loading.value = false;
+    }
+  };
+
+  // Watch for changes in the query or enabled status
+  watch([() => (isRef(query) ? query.value : (typeof query === 'function' ? query() : query)), () => config.enabled], () => {
+    if (config.enabled !== false) {
+      fetchData();
+    }
+  }, { immediate: true, deep: true });
+
+  return { data, loading, error, refetch: fetchData };
+};

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist"
+  },
+  "include": ["src"]
+}