@quickql/angular 1.0.0

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

@@ -0,0 +1,36 @@
+/**
+ * QuickQL Angular Bindings
+ *
+ * Provides Angular Services (QuickQLService) and Reactive Data fetching
+ * using RxJS observables for Angular v21+ applications.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+import { InjectionToken } from '@angular/core';
+import { QuickQLClient, ClientOptions, Query, QuickQLResponse } from '@quickql/core';
+import { Observable } from 'rxjs';
+export declare const QUICKQL_OPTIONS: InjectionToken<ClientOptions>;
+export declare class QuickQLService {
+    private options;
+    private client;
+    constructor(options: ClientOptions);
+    /**
+     * Return the internal QuickQL client instance for direct usage.
+     */
+    getClient(): QuickQLClient;
+    /**
+     * Executes a query as an RxJS Observable.
+     */
+    query<T = any>(query: Query, alias?: string): Observable<QuickQLResponse<T>>;
+    /**
+     * Executes a mutation as an RxJS Observable.
+     */
+    mutation<T = any>(mutation: any, alias?: string): Observable<QuickQLResponse<T>>;
+    /**
+     * Executes a batch request as an RxJS Observable.
+     */
+    batch(items: (Query | any)[]): Observable<QuickQLResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAsB,cAAc,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,UAAU,EAAQ,MAAM,MAAM,CAAC;AAExC,eAAO,MAAM,eAAe,+BAAuD,CAAC;AAEpF,qBAGa,cAAc;IAIE,OAAO,CAAC,OAAO;IAH1C,OAAO,CAAC,MAAM,CAAgB;gBAGK,OAAO,EAAE,aAAa;IAKzD;;OAEG;IACH,SAAS,IAAI,aAAa;IAI1B;;OAEG;IACH,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,MAAe,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAIpF;;OAEG;IACH,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,GAAE,MAAe,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAIxF;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,GAAG,UAAU,CAAC,eAAe,CAAC;CAG3D"}

package/dist/angular/src/index.js

@@ -0,0 +1,67 @@
+/**
+ * QuickQL Angular Bindings
+ *
+ * Provides Angular Services (QuickQLService) and Reactive Data fetching
+ * using RxJS observables for Angular v21+ applications.
+ *
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Injectable, Inject, InjectionToken } from '@angular/core';
+import { QuickQLClient } from '@quickql/core';
+import { from } from 'rxjs';
+export const QUICKQL_OPTIONS = new InjectionToken('QUICKQL_OPTIONS');
+let QuickQLService = class QuickQLService {
+    options;
+    client;
+    constructor(options) {
+        this.options = options;
+        this.client = new QuickQLClient(options);
+    }
+    /**
+     * Return the internal QuickQL client instance for direct usage.
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Executes a query as an RxJS Observable.
+     */
+    query(query, alias = 'data') {
+        return from(this.client.query(query, alias));
+    }
+    /**
+     * Executes a mutation as an RxJS Observable.
+     */
+    mutation(mutation, alias = 'data') {
+        return from(this.client.mutation(mutation, alias));
+    }
+    /**
+     * Executes a batch request as an RxJS Observable.
+     */
+    batch(items) {
+        return from(this.client.batch(items));
+    }
+};
+QuickQLService = __decorate([
+    Injectable({
+        providedIn: 'root'
+    }),
+    __param(0, Inject(QUICKQL_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], QuickQLService);
+export { QuickQLService };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;;;;;;;;;;;;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,aAAa,EAAyC,MAAM,eAAe,CAAC;AACrF,OAAO,EAAc,IAAI,EAAE,MAAM,MAAM,CAAC;AAExC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,cAAc,CAAgB,iBAAiB,CAAC,CAAC;AAK7E,IAAM,cAAc,GAApB,MAAM,cAAc;IAIU;IAH3B,MAAM,CAAgB;IAE9B,YACmC,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;QAEvD,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAU,KAAY,EAAE,QAAgB,MAAM;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAI,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAU,QAAa,EAAE,QAAgB,MAAM;QACpD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAI,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAsB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;CACF,CAAA;AApCY,cAAc;IAH1B,UAAU,CAAC;QACV,UAAU,EAAE,MAAM;KACnB,CAAC;IAKG,WAAA,MAAM,CAAC,eAAe,CAAC,CAAA;;GAJf,cAAc,CAoC1B"}

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":"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"}

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/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@quickql/angular",
+  "version": "1.0.0",
+  "description": "Angular Services and RxJS integration 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",
+    "rxjs": "^7.8.2"
+  },
+  "peerDependencies": {
+    "@angular/core": "^21.x"
+  }
+}

package/src/index.ts

@@ -0,0 +1,57 @@
+/**
+ * QuickQL Angular Bindings
+ * 
+ * Provides Angular Services (QuickQLService) and Reactive Data fetching 
+ * using RxJS observables for Angular v21+ applications.
+ * 
+ * (c) 2024-2026 Udinmo Inc. All rights reserved.
+ * Author: Udinmo Inc. <engineering@udinmo.com>
+ * License: MIT
+ */
+
+import { Injectable, Inject, InjectionToken } from '@angular/core';
+import { QuickQLClient, ClientOptions, Query, QuickQLResponse } from '@quickql/core';
+import { Observable, from } from 'rxjs';
+
+export const QUICKQL_OPTIONS = new InjectionToken<ClientOptions>('QUICKQL_OPTIONS');
+
+@Injectable({
+  providedIn: 'root'
+})
+export class QuickQLService {
+  private client: QuickQLClient;
+
+  constructor(
+    @Inject(QUICKQL_OPTIONS) private options: ClientOptions
+  ) {
+    this.client = new QuickQLClient(options);
+  }
+
+  /**
+   * Return the internal QuickQL client instance for direct usage.
+   */
+  getClient(): QuickQLClient {
+    return this.client;
+  }
+
+  /**
+   * Executes a query as an RxJS Observable.
+   */
+  query<T = any>(query: Query, alias: string = 'data'): Observable<QuickQLResponse<T>> {
+    return from(this.client.query<T>(query, alias));
+  }
+
+  /**
+   * Executes a mutation as an RxJS Observable.
+   */
+  mutation<T = any>(mutation: any, alias: string = 'data'): Observable<QuickQLResponse<T>> {
+     return from(this.client.mutation<T>(mutation, alias));
+  }
+
+  /**
+   * Executes a batch request as an RxJS Observable.
+   */
+  batch(items: (Query | any)[]): Observable<QuickQLResponse> {
+     return from(this.client.batch(items));
+  }
+}

package/tsconfig.json

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