@ttt-productions/query-core 0.3.8 → 0.3.10

package/dist/firestore/index.d.ts

@@ -8,4 +8,5 @@ export { useFirestoreInfinite, flattenInfiniteData, getInfiniteDataCount } from
 export { useFirestorePaginated } from './use-firestore-paginated';
 export type { UseFirestorePaginatedResult } from './use-firestore-paginated';
 export { useFirestoreSet, useFirestoreUpdate, useFirestoreDelete, useFirestoreBatch, } from './use-firestore-mutations';
+export { useBatchFirestoreDocs, type BatchFirestoreDocsOptions, type BatchFirestoreDocsResult, } from './useBatchFirestoreDocs';
 //# sourceMappingURL=index.d.ts.map

package/dist/firestore/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/firestore/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAGxD,YAAY,EACV,MAAM,EACN,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAG7E,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/firestore/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC9D,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAGxD,YAAY,EACV,MAAM,EACN,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAG7E,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC"}

package/dist/firestore/index.js

@@ -8,4 +8,5 @@ export { useFirestoreInfinite, flattenInfiniteData, getInfiniteDataCount } from
 export { useFirestorePaginated } from './use-firestore-paginated';
 // Mutation Hooks
 export { useFirestoreSet, useFirestoreUpdate, useFirestoreDelete, useFirestoreBatch, } from './use-firestore-mutations';
+export { useBatchFirestoreDocs, } from './useBatchFirestoreDocs';
 //# sourceMappingURL=index.js.map

package/dist/firestore/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/firestore/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAiB9D,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,cAAc;AACd,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/firestore/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAiB9D,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,cAAc;AACd,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,qBAAqB,GAGtB,MAAM,yBAAyB,CAAC"}

package/dist/firestore/useBatchFirestoreDocs.d.ts

@@ -0,0 +1,79 @@
+import { type Firestore } from 'firebase/firestore';
+export type BatchFirestoreDocsOptions = {
+    /**
+     * Firestore instance to use for queries
+     */
+    db: Firestore;
+    /**
+     * Full collection path (e.g., 'publicUsers', 'projects/public')
+     */
+    collectionPath: string;
+    /**
+     * Array of document IDs to fetch
+     */
+    ids: string[];
+    /**
+     * Query key prefix for individual document cache entries
+     * Each document will be cached as [queryKeyPrefix, docId]
+     * @example 'publicUser' -> ['publicUser', 'user123']
+     */
+    queryKeyPrefix: string;
+    /**
+     * Time in milliseconds to consider data fresh (default: 30 minutes)
+     */
+    staleTime?: number;
+    /**
+     * Time in milliseconds to keep unused data in cache (default: 1 hour)
+     */
+    gcTime?: number;
+    /**
+     * Whether queries should be enabled (default: true)
+     */
+    enabled?: boolean;
+};
+export type BatchFirestoreDocsResult<T> = {
+    /**
+     * Map of docId -> document data
+     * Only includes documents that exist in Firestore
+     */
+    data: Record<string, T>;
+    /**
+     * True if any batch queries are still loading
+     */
+    isLoading: boolean;
+    /**
+     * True if any batch queries have errored
+     */
+    isError: boolean;
+    /**
+     * First error from batch queries, if any
+     */
+    error: Error | null;
+    /**
+     * Refetch all documents (even cached ones)
+     */
+    refetch: () => Promise<void>;
+};
+/**
+ * Efficiently batch fetch Firestore documents with individual caching
+ *
+ * Features:
+ * - Each document is cached individually for maximum reuse
+ * - Only fetches documents that are missing or stale
+ * - Respects Firestore's 30-item limit for 'in' queries
+ * - Returns combined result as Record<docId, data>
+ *
+ * @example
+ * ```typescript
+ * const { data: users, isLoading } = useBatchFirestoreDocs<PublicUser>({
+ *   db,
+ *   collectionPath: 'publicUsers',
+ *   ids: ['user1', 'user2', 'user3'],
+ *   queryKeyPrefix: 'publicUser',
+ *   staleTime: 30 * 60 * 1000, // 30 minutes
+ * });
+ * // users = { user1: {...}, user2: {...}, user3: {...} }
+ * ```
+ */
+export declare function useBatchFirestoreDocs<T extends Record<string, any>>({ db, collectionPath, ids, queryKeyPrefix, staleTime, gcTime, enabled, }: BatchFirestoreDocsOptions): BatchFirestoreDocsResult<T>;
+//# sourceMappingURL=useBatchFirestoreDocs.d.ts.map

package/dist/firestore/useBatchFirestoreDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBatchFirestoreDocs.d.ts","sourceRoot":"","sources":["../../src/firestore/useBatchFirestoreDocs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiD,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAInG,MAAM,MAAM,yBAAyB,GAAG;IACtC;;OAEG;IACH,EAAE,EAAE,SAAS,CAAC;IAEd;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,GAAG,EAAE,MAAM,EAAE,CAAC;IAEd;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI;IACxC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAExB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EACnE,EAAE,EACF,cAAc,EACd,GAAG,EACH,cAAc,EACd,SAA0B,EAC1B,MAAuB,EACvB,OAAc,GACf,EAAE,yBAAyB,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAoHzD"}

package/dist/firestore/useBatchFirestoreDocs.js

@@ -0,0 +1,118 @@
+import { useMemo } from 'react';
+import { useQueries, useQueryClient } from '@tanstack/react-query';
+import { collection, getDocs, query, where, documentId } from 'firebase/firestore';
+const FIRESTORE_IN_LIMIT = 30;
+/**
+ * Efficiently batch fetch Firestore documents with individual caching
+ *
+ * Features:
+ * - Each document is cached individually for maximum reuse
+ * - Only fetches documents that are missing or stale
+ * - Respects Firestore's 30-item limit for 'in' queries
+ * - Returns combined result as Record<docId, data>
+ *
+ * @example
+ * ```typescript
+ * const { data: users, isLoading } = useBatchFirestoreDocs<PublicUser>({
+ *   db,
+ *   collectionPath: 'publicUsers',
+ *   ids: ['user1', 'user2', 'user3'],
+ *   queryKeyPrefix: 'publicUser',
+ *   staleTime: 30 * 60 * 1000, // 30 minutes
+ * });
+ * // users = { user1: {...}, user2: {...}, user3: {...} }
+ * ```
+ */
+export function useBatchFirestoreDocs({ db, collectionPath, ids, queryKeyPrefix, staleTime = 30 * 60 * 1000, gcTime = 60 * 60 * 1000, enabled = true, }) {
+    const queryClient = useQueryClient();
+    // Deduplicate and filter out empty IDs
+    const uniqueIds = useMemo(() => {
+        return Array.from(new Set(ids.filter(Boolean)));
+    }, [ids]);
+    // Separate IDs into cached/fresh vs needs-fetch
+    const { cachedIds, fetchIds } = useMemo(() => {
+        if (!enabled) {
+            return { cachedIds: [], fetchIds: [] };
+        }
+        const cached = [];
+        const needsFetch = [];
+        for (const id of uniqueIds) {
+            const queryKey = [queryKeyPrefix, id];
+            const state = queryClient.getQueryState(queryKey);
+            // Check if data exists and is still fresh
+            if (state?.data && state.dataUpdatedAt && Date.now() - state.dataUpdatedAt < staleTime) {
+                cached.push(id);
+            }
+            else {
+                needsFetch.push(id);
+            }
+        }
+        return { cachedIds: cached, fetchIds: needsFetch };
+    }, [uniqueIds, queryKeyPrefix, queryClient, staleTime, enabled]);
+    // Batch the fetchIds into groups of 30
+    const batches = useMemo(() => {
+        const result = [];
+        for (let i = 0; i < fetchIds.length; i += FIRESTORE_IN_LIMIT) {
+            result.push(fetchIds.slice(i, i + FIRESTORE_IN_LIMIT));
+        }
+        return result;
+    }, [fetchIds]);
+    // Fetch each batch and populate individual cache entries
+    const batchQueries = useQueries({
+        queries: batches.map((batch, batchIndex) => ({
+            queryKey: [queryKeyPrefix, 'batch', batchIndex, ...batch.sort()],
+            queryFn: async () => {
+                if (batch.length === 0)
+                    return [];
+                const q = query(collection(db, collectionPath), where(documentId(), 'in', batch));
+                const snapshot = await getDocs(q);
+                const docs = [];
+                // Process each document and update individual cache entries
+                snapshot.forEach((doc) => {
+                    const data = { id: doc.id, ...doc.data() };
+                    docs.push(data);
+                    // Populate individual cache entry
+                    queryClient.setQueryData([queryKeyPrefix, doc.id], data, { updatedAt: Date.now() });
+                });
+                return docs;
+            },
+            staleTime,
+            gcTime,
+            enabled: enabled && batch.length > 0,
+        })),
+    });
+    // Combine results
+    const isLoading = batchQueries.some(q => q.isLoading);
+    const isError = batchQueries.some(q => q.isError);
+    const error = batchQueries.find(q => q.error)?.error || null;
+    const data = useMemo(() => {
+        const combined = {};
+        // Add cached data
+        for (const id of cachedIds) {
+            const cached = queryClient.getQueryData([queryKeyPrefix, id]);
+            if (cached) {
+                combined[id] = cached;
+            }
+        }
+        // Add freshly fetched data
+        for (const batchQuery of batchQueries) {
+            if (batchQuery.data) {
+                for (const doc of batchQuery.data) {
+                    combined[doc.id] = doc;
+                }
+            }
+        }
+        return combined;
+    }, [cachedIds, batchQueries, queryClient, queryKeyPrefix]);
+    const refetch = async () => {
+        await Promise.all(batchQueries.map(q => q.refetch()));
+    };
+    return {
+        data,
+        isLoading,
+        isError,
+        error: error,
+        refetch,
+    };
+}
+//# sourceMappingURL=useBatchFirestoreDocs.js.map

package/dist/firestore/useBatchFirestoreDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBatchFirestoreDocs.js","sourceRoot":"","sources":["../../src/firestore/useBatchFirestoreDocs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAkB,MAAM,oBAAoB,CAAC;AAEnG,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAqE9B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,qBAAqB,CAAgC,EACnE,EAAE,EACF,cAAc,EACd,GAAG,EACH,cAAc,EACd,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAC1B,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EACvB,OAAO,GAAG,IAAI,GACY;IAC1B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,uCAAuC;IACvC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEV,gDAAgD;IAChD,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACzC,CAAC;QAED,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAElD,0CAA0C;YAC1C,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,aAAa,GAAG,SAAS,EAAE,CAAC;gBACvF,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IACrD,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEjE,uCAAuC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,kBAAkB,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,yDAAyD;IACzD,MAAM,YAAY,GAAG,UAAU,CAAC;QAC9B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;YAC3C,QAAQ,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAChE,OAAO,EAAE,KAAK,IAAkB,EAAE;gBAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAElC,MAAM,CAAC,GAAG,KAAK,CACb,UAAU,CAAC,EAAE,EAAE,cAAc,CAAC,EAC9B,KAAK,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CACjC,CAAC;gBAEF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;gBAClC,MAAM,IAAI,GAAQ,EAAE,CAAC;gBAErB,4DAA4D;gBAC5D,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;oBACvB,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,EAAkB,CAAC;oBAC3D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAEhB,kCAAkC;oBAClC,WAAW,CAAC,YAAY,CACtB,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC,EACxB,IAAI,EACJ,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAC1B,CAAC;gBACJ,CAAC,CAAC,CAAC;gBAEH,OAAO,IAAI,CAAC;YACd,CAAC;YACD,SAAS;YACT,MAAM;YACN,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;SACrC,CAAC,CAAC;KACJ,CAAC,CAAC;IAEH,kBAAkB;IAClB,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;IAE7D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;QACxB,MAAM,QAAQ,GAAsB,EAAE,CAAC;QAEvC,kBAAkB;QAClB,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,CAAI,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC;YACjE,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;YACxB,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;gBACpB,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;oBAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;IAE3D,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,SAAS;QACT,OAAO;QACP,KAAK,EAAE,KAAqB;QAC5B,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export type { QueryKey } from './keys';
 export { invalidateByPrefix, removeByPrefix, updateQueryData } from './cache-helpers';
 export { TTTQueryProvider } from './provider';
 export type { TTTQueryProviderProps } from './provider';
-export { FirestoreProvider, useFirestoreDb, useFirestoreDoc, useFirestoreCollection, useFirestoreInfinite, useFirestorePaginated, useFirestoreSet, useFirestoreUpdate, useFirestoreDelete, useFirestoreBatch, flattenInfiniteData, getInfiniteDataCount, docWithId, } from './firestore';
-export type { FirestoreProviderProps, WithId, FirestoreBaseOptions, FirestoreDocOptions, FirestoreCollectionOptions, FirestoreInfiniteOptions, FirestorePaginatedOptions, InfinitePage, PaginatedResult, MutationOperation, FirestoreMutationOptions, FirestoreBatchOptions, } from './firestore';
+export { FirestoreProvider, useFirestoreDb, useFirestoreDoc, useFirestoreCollection, useFirestoreInfinite, useFirestorePaginated, useFirestoreSet, useFirestoreUpdate, useFirestoreDelete, useFirestoreBatch, flattenInfiniteData, getInfiniteDataCount, docWithId, useBatchFirestoreDocs, } from './firestore';
+export type { FirestoreProviderProps, WithId, FirestoreBaseOptions, FirestoreDocOptions, FirestoreCollectionOptions, FirestoreInfiniteOptions, FirestorePaginatedOptions, InfinitePage, PaginatedResult, MutationOperation, FirestoreMutationOptions, FirestoreBatchOptions, BatchFirestoreDocsOptions, BatchFirestoreDocsResult, } from './firestore';
 export { useFirestoreSearch, SEARCH_CONFIGS, } from './search';
 export type { FirestoreSearchConfig, FirestoreSearchOptions, } from './search';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAEL,iBAAiB,EACjB,cAAc,EAEd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EAErB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAEjB,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,YAAY,EAEV,sBAAsB,EAEtB,MAAM,EACN,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAEL,iBAAiB,EACjB,cAAc,EAEd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EAErB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAEjB,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,EAET,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,YAAY,EAEV,sBAAsB,EAEtB,MAAM,EACN,oBAAoB,EACpB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,cAAc,GACf,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -15,7 +15,9 @@ useFirestoreDoc, useFirestoreCollection, useFirestoreInfinite, useFirestorePagin
 // Mutation Hooks
 useFirestoreSet, useFirestoreUpdate, useFirestoreDelete, useFirestoreBatch, 
 // Helpers
-flattenInfiniteData, getInfiniteDataCount, docWithId, } from './firestore';
+flattenInfiniteData, getInfiniteDataCount, docWithId, 
+//Batch query cache
+useBatchFirestoreDocs, } from './firestore';
 // Search Integration
 export { useFirestoreSearch, SEARCH_CONFIGS, } from './search';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG9C,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtF,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,wBAAwB;AACxB,OAAO;AACL,WAAW;AACX,iBAAiB,EACjB,cAAc;AACd,cAAc;AACd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB;AACrB,iBAAiB;AACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB;AACjB,UAAU;AACV,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,GACV,MAAM,aAAa,CAAC;AAmBrB,qBAAqB;AACrB,OAAO,EACL,kBAAkB,EAClB,cAAc,GACf,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG9C,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtF,WAAW;AACX,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,wBAAwB;AACxB,OAAO;AACL,WAAW;AACX,iBAAiB,EACjB,cAAc;AACd,cAAc;AACd,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB;AACrB,iBAAiB;AACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB;AACjB,UAAU;AACV,mBAAmB,EACnB,oBAAoB,EACpB,SAAS;AACT,mBAAmB;AACnB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAqBrB,qBAAqB;AACrB,OAAO,EACL,kBAAkB,EAClB,cAAc,GACf,MAAM,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ttt-productions/query-core",
-    "version": "0.3.8",
+    "version": "0.3.10",
     "description": "Shared TanStack Query (React Query) client defaults, query key helpers, and Firestore integration hooks for TTT Productions apps",
     "repository": {
         "type": "git",