@codeleap/query 7.0.2 → 7.1.1

package/dist/lib/QueryOperations/index.js

@@ -1,17 +1,5 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueryOperations = void 0;
-const react_query_1 = require("@tanstack/react-query");
-const QueryClientEnhanced_1 = require("../QueryClientEnhanced");
+import { useMutation, useQuery } from '@tanstack/react-query';
+import { QueryClientEnhanced } from '../QueryClientEnhanced';
 /**
  * Builder class for creating type-safe query and mutation operations
  * @template TMutations - Record type containing all registered mutation functions
@@ -28,7 +16,10 @@ const QueryClientEnhanced_1 = require("../QueryClientEnhanced");
  * - Type-safe React hooks generation
  * - Immutable operation registration (returns new instances)
  */
-class QueryOperations {
+export class QueryOperations {
+    _options;
+    _mutations;
+    _queries;
     /**
      * Creates a new QueryOperations instance
      * @param _options - Configuration options including QueryClient
@@ -48,7 +39,7 @@ class QueryOperations {
         return this._mutations;
     }
     get queryClient() {
-        if (this._options.queryClient instanceof QueryClientEnhanced_1.QueryClientEnhanced) {
+        if (this._options.queryClient instanceof QueryClientEnhanced) {
             return this._options.queryClient.client;
         }
         return this._options.queryClient;
@@ -81,7 +72,7 @@ class QueryOperations {
      * ```
      */
     mutation(name, fn) {
-        return new QueryOperations(this._options, Object.assign(Object.assign({}, this._mutations), { [name]: fn }), this._queries);
+        return new QueryOperations(this._options, { ...this._mutations, [name]: fn }, this._queries);
     }
     /**
      * Registers a new query function
@@ -104,7 +95,7 @@ class QueryOperations {
      * ```
      */
     query(name, fn) {
-        return new QueryOperations(this._options, this._mutations, Object.assign(Object.assign({}, this._queries), { [name]: fn }));
+        return new QueryOperations(this._options, this._mutations, { ...this._queries, [name]: fn });
     }
     /**
      * React hook for executing mutations with full type safety
@@ -133,12 +124,16 @@ class QueryOperations {
      */
     useMutation(mutationKey, options) {
         const mutationFn = this._mutations[mutationKey];
-        return (0, react_query_1.useMutation)(Object.assign({ mutationKey: this.getMutationKey(mutationKey), mutationFn: (data) => __awaiter(this, void 0, void 0, function* () {
+        return useMutation({
+            mutationKey: this.getMutationKey(mutationKey),
+            mutationFn: async (data) => {
                 if (!mutationFn) {
                     throw new Error(`Mutation "${String(mutationKey)}" not found`);
                 }
                 return mutationFn(data);
-            }) }, options));
+            },
+            ...options
+        });
     }
     /**
      * React hook for executing queries with full type safety
@@ -171,12 +166,16 @@ class QueryOperations {
      */
     useQuery(queryKey, params, options) {
         const queryFn = this._queries[queryKey];
-        return (0, react_query_1.useQuery)(Object.assign({ queryKey: this.getQueryKey(queryKey, params), queryFn: () => __awaiter(this, void 0, void 0, function* () {
+        return useQuery({
+            queryKey: this.getQueryKey(queryKey, params),
+            queryFn: async () => {
                 if (!queryFn) {
                     throw new Error(`Query "${String(queryKey)}" not found`);
                 }
                 return queryFn(params);
-            }) }, options));
+            },
+            ...options
+        });
     }
     /**
      * Generates a properly typed query key for React Query
@@ -242,7 +241,11 @@ class QueryOperations {
     prefetchQuery(queryKey, params, options) {
         const prefetchQueryKey = this.getQueryKey(queryKey, params);
         const queryFn = this._queries[queryKey];
-        return this.queryClient.prefetchQuery(Object.assign({ queryKey: prefetchQueryKey, queryFn: queryFn }, options));
+        return this.queryClient.prefetchQuery({
+            queryKey: prefetchQueryKey,
+            queryFn: queryFn,
+            ...options,
+        });
     }
     /**
      * Retrieves cached query data if it exists
@@ -273,16 +276,13 @@ class QueryOperations {
      * }
      * ```
      */
-    getQueryData(queryKey, params, options) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const prefetchQueryKey = this.getQueryKey(queryKey, params);
-            const cachedData = this.queryClient.getQueryData(prefetchQueryKey);
-            if (!cachedData) {
-                yield this.prefetchQuery(queryKey, params, options);
-            }
-            return this.queryClient.getQueryData(prefetchQueryKey);
-        });
+    async getQueryData(queryKey, params, options) {
+        const prefetchQueryKey = this.getQueryKey(queryKey, params);
+        const cachedData = this.queryClient.getQueryData(prefetchQueryKey);
+        if (!cachedData) {
+            await this.prefetchQuery(queryKey, params, options);
+        }
+        return this.queryClient.getQueryData(prefetchQueryKey);
     }
 }
-exports.QueryOperations = QueryOperations;
 //# sourceMappingURL=index.js.map

package/dist/lib/QueryOperations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/QueryOperations/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/QueryOperations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAoE,MAAM,uBAAuB,CAAA;AAE/H,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,eAAe;IAWhB;IACA;IACA;IATV;;;;;OAKG;IACH,YACU,QAAgC,EAChC,aAAyB,EAAgB,EACzC,WAAqB,EAAc;QAFnC,aAAQ,GAAR,QAAQ,CAAwB;QAChC,eAAU,GAAV,UAAU,CAA+B;QACzC,aAAQ,GAAR,QAAQ,CAA2B;IACzC,CAAC;IAEL;;;OAGG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;IAED,IAAI,WAAW;QACb,IAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,YAAY,mBAAmB,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAA;QACzC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAA;IAClC,CAAC;IAED;;;OAGG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CACN,IAAO,EACP,EAAoB;QAEpB,OAAO,IAAI,eAAe,CACxB,IAAI,CAAC,QAAQ,EACb,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAA8C,EAC9E,IAAI,CAAC,QAAQ,CACd,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CACH,IAAO,EACP,EAAiB;QAEjB,OAAO,IAAI,eAAe,CACxB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,EACf,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAyC,CACxE,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,WAAW,CACT,WAAc,EACd,OAOC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAe,CAAA;QAK7D,OAAO,WAAW,CAA2B;YAC3C,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;YAC7C,UAAU,EAAE,KAAK,EAAE,IAAgB,EAAkB,EAAE;gBACrD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAA;gBAChE,CAAC;gBACD,OAAO,UAAU,CAAC,IAAI,CAAmB,CAAA;YAC3C,CAAC;YACD,GAAG,OAAO;SACX,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,QAAQ,CACN,QAAW,EACX,MAAsC,EACtC,OAQC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAY,CAAA;QAIlD,OAAO,QAAQ,CAA4B;YACzC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC;YAC5C,OAAO,EAAE,KAAK,IAAoB,EAAE;gBAClC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;gBAC1D,CAAC;gBACD,OAAO,OAAO,CAAC,MAAa,CAAmB,CAAA;YACjD,CAAC;YACD,GAAG,OAAO;SACJ,CAAC,CAAA;IACX,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,CACT,QAAW,EACX,MAAsC;QAEtC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAa,CAAA;IAC7E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,cAAc,CAA6B,WAAc;QACvD,OAAO,CAAC,WAAW,CAAa,CAAA;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,CACX,QAAW,EACX,MAAsC,EACtC,OAAqF;QAErF,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAE3D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAY,CAAA;QAElD,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAoD;YACvF,QAAQ,EAAE,gBAAgB;YAC1B,OAAO,EAAE,OAAO;YAChB,GAAG,OAAO;SACX,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,YAAY,CAChB,QAAW,EACX,MAAsC,EACtC,OAAqF;QAErF,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAE3D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAc,gBAAgB,CAAC,CAAA;QAE/E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QACrD,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,YAAY,CAAc,gBAAgB,CAAC,CAAA;IACrE,CAAC;CACF"}

package/dist/lib/QueryOperations/types.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=types.js.map

package/dist/lib/index.js

@@ -1,22 +1,6 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./QueryClientEnhanced"), exports);
-__exportStar(require("./QueryKeys"), exports);
-__exportStar(require("./Mutations"), exports);
-__exportStar(require("./QueryManager"), exports);
-__exportStar(require("./QueryOperations"), exports);
+export * from './QueryClientEnhanced';
+export * from './QueryKeys';
+export * from './Mutations';
+export * from './QueryManager';
+export * from './QueryOperations';
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAqC;AACrC,8CAA2B;AAC3B,8CAA2B;AAC3B,iDAA8B;AAC9B,oDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA"}

package/dist/types/core.d.ts

@@ -8,11 +8,24 @@ export type QueryItem = {
 export type PageParam = number;
 /** Raw page payload returned by `listFn` — a flat array of items for one page. */
 export type ListPaginationResponse<T extends QueryItem> = T[];
-/** Constructor options for `QueryManager`. All `*Fn` fields are optional; omitting one disables the corresponding operation and its generated hooks. */
-export type QueryManagerOptions<T extends QueryItem, F> = {
+/** Extra metadata from a paginated API response (everything except the items array). */
+export type ListResponseMeta = Record<string, unknown>;
+/** Envelope returned by `listFn` when it includes metadata beyond the items array. `listItems` holds the page items; all other fields are treated as metadata. */
+export type ListPaginationEnvelope<T extends QueryItem, M extends ListResponseMeta = ListResponseMeta> = {
+    listItems: T[];
+} & M;
+/** What `listFn` is allowed to return: a flat array (backward compat) or an envelope with metadata. */
+export type ListFnResponse<T extends QueryItem, M extends ListResponseMeta = ListResponseMeta> = T[] | ListPaginationEnvelope<T, M>;
+/**
+ * Constructor options for `QueryManager`. All `*Fn` fields are optional; omitting one disables the corresponding operation and its generated hooks.
+ * @template T - The query item type that extends QueryItem
+ * @template F - The filter type used for list queries
+ * @template M - Optional metadata shape returned alongside list items (e.g. `{ count: number }`). Defaults to `Record<string, unknown>`.
+ */
+export type QueryManagerOptions<T extends QueryItem, F, M extends ListResponseMeta = ListResponseMeta> = {
     name: string;
     queryClient: ReturnType<typeof useQueryClient> | QueryClientEnhanced;
-    listFn?: (limit: number, offset: number, filters: F) => Promise<ListPaginationResponse<T>>;
+    listFn?: (limit: number, offset: number, filters: F) => Promise<ListFnResponse<T, M>>;
     /** Page size sent to `listFn`. Defaults to 10 when omitted. */
     listLimit?: number;
     /** Side-effect hook called on every render with the current infinite-list query result. Useful for syncing list state into external stores. */
@@ -20,6 +33,7 @@ export type QueryManagerOptions<T extends QueryItem, F> = {
         pageParams: number[];
         pages: ListPaginationResponse<T>[];
         allItems: T[];
+        meta: M | null;
     }, Error>) => void;
     retrieveFn?: (id: T['id']) => Promise<T>;
     createFn?: (data: Partial<T>) => Promise<T>;

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

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAE5C,qEAAqE;AACrE,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CACpB,CAAA;AAED,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B,kFAAkF;AAClF,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,EAAE,CAAA;AAE7D,wJAAwJ;AACxJ,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,IAAI;IACxD,IAAI,EAAE,MAAM,CAAA;IAEZ,WAAW,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,GAAG,mBAAmB,CAAA;IAEpE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAA;IAE1F,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,+IAA+I;IAC/I,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,sBAAsB,CAAC;QACjD,UAAU,EAAE,MAAM,EAAE,CAAA;QACpB,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAA;QAClC,QAAQ,EAAE,CAAC,EAAE,CAAA;KACd,EAAE,KAAK,CAAC,KAAK,IAAI,CAAA;IAElB,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAExC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAE3C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAE3C,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;CAC7C,CAAA"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAE5C,qEAAqE;AACrE,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CACpB,CAAA;AAED,8EAA8E;AAC9E,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B,kFAAkF;AAClF,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,EAAE,CAAA;AAE7D,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEtD,kKAAkK;AAClK,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI;IACvG,SAAS,EAAE,CAAC,EAAE,CAAA;CACf,GAAG,CAAC,CAAA;AAEL,uGAAuG;AACvG,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IACzF,CAAC,EAAE,GACH,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAEhC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI;IACvG,IAAI,EAAE,MAAM,CAAA;IAEZ,WAAW,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,GAAG,mBAAmB,CAAA;IAEpE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAErF,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,+IAA+I;IAC/I,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,sBAAsB,CAAC;QACjD,UAAU,EAAE,MAAM,EAAE,CAAA;QACpB,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAA;QAClC,QAAQ,EAAE,CAAC,EAAE,CAAA;QACb,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;KACf,EAAE,KAAK,CAAC,KAAK,IAAI,CAAA;IAElB,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAExC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAE3C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAE3C,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;CAC7C,CAAA"}

package/dist/types/core.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=core.js.map

package/dist/types/create.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=create.js.map

package/dist/types/delete.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=delete.js.map

package/dist/types/index.js

@@ -1,24 +1,8 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./core"), exports);
-__exportStar(require("./list"), exports);
-__exportStar(require("./utility"), exports);
-__exportStar(require("./retrieve"), exports);
-__exportStar(require("./create"), exports);
-__exportStar(require("./update"), exports);
-__exportStar(require("./delete"), exports);
+export * from './core';
+export * from './list';
+export * from './utility';
+export * from './retrieve';
+export * from './create';
+export * from './update';
+export * from './delete';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB;AACtB,yCAAsB;AACtB,4CAAyB;AACzB,6CAA0B;AAC1B,2CAAwB;AACxB,2CAAwB;AACxB,2CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA"}

package/dist/types/list.d.ts

@@ -1,17 +1,19 @@
 import { QueryKey, UseInfiniteQueryOptions } from '@tanstack/react-query';
-import { ListPaginationResponse, PageParam, QueryItem } from './core';
+import { ListPaginationResponse, ListResponseMeta, PageParam, QueryItem } from './core';
 /**
  * Normalised shape of the infinite-query cache entry.
  * `allItems` is a convenience flat-merge of every page's items — use it for rendering; use `pages` when you need per-page boundaries.
+ * `meta` holds extra data from the most recent `listFn` response (e.g. total count), or `null` when `listFn` returns a plain array.
  */
-export type ListSelector<T extends QueryItem> = {
+export type ListSelector<T extends QueryItem, M extends ListResponseMeta = ListResponseMeta> = {
     pageParams: PageParam[];
     pages: ListPaginationResponse<T>[];
     allItems: T[];
+    meta: M | null;
 };
-type InfiniteQueryOptions<T extends QueryItem> = UseInfiniteQueryOptions<ListPaginationResponse<T>, Error, ListSelector<T>, QueryKey, PageParam>;
+type InfiniteQueryOptions<T extends QueryItem, M extends ListResponseMeta = ListResponseMeta> = UseInfiniteQueryOptions<ListPaginationResponse<T>, Error, ListSelector<T, M>, QueryKey, PageParam>;
 /** Options accepted by the generated `useList` hook. Extends React Query's infinite-query options; `limit` and `filters` are forwarded to `listFn`. */
-export type ListQueryOptions<T extends QueryItem, F> = Partial<InfiniteQueryOptions<T>> & {
+export type ListQueryOptions<T extends QueryItem, F, M extends ListResponseMeta = ListResponseMeta> = Partial<InfiniteQueryOptions<T, M>> & {
     limit?: number;
     filters?: F;
 };

package/dist/types/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/types/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,sBAAsB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAErE;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,IAAI;IAC9C,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAA;IAClC,QAAQ,EAAE,CAAC,EAAE,CAAA;CACd,CAAA;AAED,KAAK,oBAAoB,CAAC,CAAC,SAAS,SAAS,IAAI,uBAAuB,CACtE,sBAAsB,CAAC,CAAC,CAAC,EACzB,KAAK,EACL,YAAY,CAAC,CAAC,CAAC,EACf,QAAQ,EACR,SAAS,CACV,CAAA;AAED,uJAAuJ;AACvJ,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,GAAG;IACxF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,CAAC,CAAA;CACZ,CAAA"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/types/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACzE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAEvF;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI;IAC7F,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAA;IAClC,QAAQ,EAAE,CAAC,EAAE,CAAA;IACb,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;CACf,CAAA;AAED,KAAK,oBAAoB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,uBAAuB,CACrH,sBAAsB,CAAC,CAAC,CAAC,EACzB,KAAK,EACL,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,QAAQ,EACR,SAAS,CACV,CAAA;AAED,uJAAuJ;AACvJ,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG;IAC1I,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,CAAC,CAAA;CACZ,CAAA"}

package/dist/types/list.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=list.js.map

package/dist/types/retrieve.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=retrieve.js.map

package/dist/types/update.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=update.js.map

package/dist/types/utility.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=utility.js.map

package/dist/utils/index.js

@@ -1,18 +1,2 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./misc"), exports);
+export * from './misc';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA"}

package/dist/utils/misc.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateTempId = exports.tempIdPrefix = void 0;
 function uuidV4() {
     function randomHex() {
         return Math.floor(Math.random() * 16).toString(16);
@@ -30,10 +27,9 @@ function uuidV4() {
     return uuid;
 }
 /** Prefix used on every optimistically-created item id. Check `id.startsWith(tempIdPrefix)` to distinguish placeholder items from server-assigned ids. */
-exports.tempIdPrefix = 'temp-id';
+export const tempIdPrefix = 'temp-id';
 /** Returns a unique placeholder id for optimistic creates. The format is `temp-id-<uuidv4>` and is guaranteed never to collide with server-assigned ids. */
-const generateTempId = () => {
-    return exports.tempIdPrefix + '-' + uuidV4();
+export const generateTempId = () => {
+    return tempIdPrefix + '-' + uuidV4();
 };
-exports.generateTempId = generateTempId;
 //# sourceMappingURL=misc.js.map

package/dist/utils/misc.js.map

@@ -1 +1 @@
-{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../src/utils/misc.ts"],"names":[],"mappings":";;;AAAA,SAAS,MAAM;IACb,SAAS,SAAS;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,IAAI,GAAG,EAAE,CAAA;IAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IAED,IAAI,IAAI,GAAG,CAAA;IAEX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IAED,IAAI,IAAI,GAAG,CAAA;IAEX,IAAI,IAAI,GAAG,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IACD,IAAI,IAAI,GAAG,CAAA;IAEX,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IACD,IAAI,IAAI,GAAG,CAAA;IAEX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,0JAA0J;AAC7I,QAAA,YAAY,GAAG,SAAS,CAAA;AAErC,4JAA4J;AACrJ,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,OAAO,oBAAY,GAAG,GAAG,GAAG,MAAM,EAAE,CAAA;AACtC,CAAC,CAAA;AAFY,QAAA,cAAc,kBAE1B"}
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../src/utils/misc.ts"],"names":[],"mappings":"AAAA,SAAS,MAAM;IACb,SAAS,SAAS;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,IAAI,GAAG,EAAE,CAAA;IAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IAED,IAAI,IAAI,GAAG,CAAA;IAEX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IAED,IAAI,IAAI,GAAG,CAAA;IAEX,IAAI,IAAI,GAAG,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IACD,IAAI,IAAI,GAAG,CAAA;IAEX,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IACD,IAAI,IAAI,GAAG,CAAA;IAEX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,IAAI,SAAS,EAAE,CAAA;IACrB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,0JAA0J;AAC1J,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAA;AAErC,4JAA4J;AAC5J,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE;IACjC,OAAO,YAAY,GAAG,GAAG,GAAG,MAAM,EAAE,CAAA;AACtC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeleap/query",
-  "version": "7.0.2",
+  "version": "7.1.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -22,9 +22,9 @@
     "directory": "packages/query"
   },
   "devDependencies": {
-    "@codeleap/config": "7.0.1",
-    "@codeleap/types": "7.0.1",
-    "@codeleap/utils": "7.0.1",
+    "@codeleap/config": "7.0.2",
+    "@codeleap/types": "7.0.2",
+    "@codeleap/utils": "7.0.2",
     "ts-node-dev": "1.1.8"
   },
   "scripts": {
@@ -32,7 +32,7 @@
     "typecheck": "bun tsc --noEmit -p ./tsconfig.json"
   },
   "peerDependencies": {
-    "@codeleap/types": "7.0.1",
+    "@codeleap/types": "7.0.2",
     "typescript": "6.0.3",
     "@tanstack/react-query": "5.100.9"
   },

package/src/factors/createQueryManager.ts

@@ -1,27 +1,18 @@
 import { QueryManager } from '../lib'
-import { QueryItem, QueryManagerOptions } from '../types'
+import { ListResponseMeta, QueryItem, QueryManagerOptions } from '../types'
 
 /**
  * Factory function to create a new QueryManager instance
  * @template T - The query item type that extends QueryItem
  * @template F - The filter type used for list queries
+ * @template M - Optional metadata shape returned alongside list items (e.g. `{ count: number }`). Defaults to `Record<string, unknown>`.
  * @param options - Configuration options for the query manager
  * @returns New QueryManager instance
- * 
+ *
  * @example
  * ```typescript
- * interface User extends QueryItem {
- *   name: string
- *   email: string
- *   status: 'active' | 'inactive'
- * }
- * 
- * interface UserFilters {
- *   status?: 'active' | 'inactive'
- *   search?: string
- * }
- * 
- * const userQueryManager = createQueryManager<User, UserFilters>({
+ * // Without list metadata (backward compatible)
+ * const userManager = createQueryManager<User, UserFilters>({
  *   name: 'users',
  *   queryClient,
  *   listFn: (limit, offset, filters) => api.getUsers({ limit, offset, ...filters }),
@@ -31,8 +22,20 @@ import { QueryItem, QueryManagerOptions } from '../types'
  *   deleteFn: (id) => api.deleteUser(id),
  *   listLimit: 20
  * })
+ *
+ * // With list metadata
+ * const postManager = createQueryManager<Post, PostFilters, { count: number }>({
+ *   name: 'posts',
+ *   queryClient,
+ *   listFn: async (limit, offset, filters) => {
+ *     const { data } = await api.get('/posts/', { limit, offset, ...filters })
+ *     return { listItems: data.results, count: data.count }
+ *   },
+ * })
+ * // In a component: const { items, meta } = postManager.useList({ filters })
+ * // meta?.count is typed as number
  * ```
  */
-export const createQueryManager = <T extends QueryItem, F = {}>(options: QueryManagerOptions<T, F>) => {
-  return new QueryManager<T, F>(options)
+export const createQueryManager = <T extends QueryItem, F = {}, M extends ListResponseMeta = ListResponseMeta>(options: QueryManagerOptions<T, F, M>) => {
+  return new QueryManager<T, F, M>(options)
 }