@ttt-productions/query-core 0.2.1 → 0.3.2

package/dist/firestore/context.d.ts

@@ -0,0 +1,28 @@
+import { type ReactNode } from 'react';
+import type { Firestore } from 'firebase/firestore';
+export interface FirestoreProviderProps {
+    db: Firestore;
+    children: ReactNode;
+}
+/**
+ * Provides Firestore instance to all useFirestore* hooks.
+ * Wrap your app with this provider alongside TTTQueryProvider.
+ *
+ * @example
+ * ```tsx
+ * import { db } from '@/lib/firebase';
+ *
+ * <TTTQueryProvider>
+ *   <FirestoreProvider db={db}>
+ *     {children}
+ *   </FirestoreProvider>
+ * </TTTQueryProvider>
+ * ```
+ */
+export declare function FirestoreProvider({ db, children }: FirestoreProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Access the Firestore instance from context.
+ * Throws if used outside of FirestoreProvider.
+ */
+export declare function useFirestoreDb(): Firestore;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/firestore/context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQpD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,SAAS,CAAC;IACd,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,sBAAsB,2CAMzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,CAS1C"}

package/dist/firestore/context.js

@@ -0,0 +1,35 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+const FirestoreContext = createContext(null);
+/**
+ * Provides Firestore instance to all useFirestore* hooks.
+ * Wrap your app with this provider alongside TTTQueryProvider.
+ *
+ * @example
+ * ```tsx
+ * import { db } from '@/lib/firebase';
+ *
+ * <TTTQueryProvider>
+ *   <FirestoreProvider db={db}>
+ *     {children}
+ *   </FirestoreProvider>
+ * </TTTQueryProvider>
+ * ```
+ */
+export function FirestoreProvider({ db, children }) {
+    return (_jsx(FirestoreContext.Provider, { value: { db }, children: children }));
+}
+/**
+ * Access the Firestore instance from context.
+ * Throws if used outside of FirestoreProvider.
+ */
+export function useFirestoreDb() {
+    const context = useContext(FirestoreContext);
+    if (!context) {
+        throw new Error('useFirestoreDb must be used within a FirestoreProvider. ' +
+            'Wrap your app with <FirestoreProvider db={db}>.');
+    }
+    return context.db;
+}
+//# sourceMappingURL=context.js.map

package/dist/firestore/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/firestore/context.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAOlE,MAAM,gBAAgB,GAAG,aAAa,CAA+B,IAAI,CAAC,CAAC;AAO3E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAA0B;IACxE,OAAO,CACL,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,EAAE,EAAE,YACrC,QAAQ,GACiB,CAC7B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,0DAA0D;YAC1D,iDAAiD,CAClD,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,EAAE,CAAC;AACpB,CAAC"}

package/dist/firestore/index.d.ts

@@ -0,0 +1,11 @@
+export { FirestoreProvider, useFirestoreDb } from './context';
+export type { FirestoreProviderProps } from './context';
+export type { WithId, FirestoreBaseOptions, FirestoreDocOptions, FirestoreCollectionOptions, FirestoreInfiniteOptions, FirestorePaginatedOptions, InfinitePage, PaginatedResult, MutationOperation, FirestoreMutationOptions, FirestoreBatchOptions, } from './types';
+export { docWithId } from './types';
+export { useFirestoreDoc } from './use-firestore-doc';
+export { useFirestoreCollection } from './use-firestore-collection';
+export { useFirestoreInfinite, flattenInfiniteData, getInfiniteDataCount } from './use-firestore-infinite';
+export { useFirestorePaginated } from './use-firestore-paginated';
+export type { UseFirestorePaginatedResult } from './use-firestore-paginated';
+export { useFirestoreSet, useFirestoreUpdate, useFirestoreDelete, useFirestoreBatch, } from './use-firestore-mutations';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/firestore/index.js

@@ -0,0 +1,11 @@
+// Context & Provider
+export { FirestoreProvider, useFirestoreDb } from './context';
+export { docWithId } from './types';
+// Query Hooks
+export { useFirestoreDoc } from './use-firestore-doc';
+export { useFirestoreCollection } from './use-firestore-collection';
+export { useFirestoreInfinite, flattenInfiniteData, getInfiniteDataCount } from './use-firestore-infinite';
+export { useFirestorePaginated } from './use-firestore-paginated';
+// Mutation Hooks
+export { useFirestoreSet, useFirestoreUpdate, useFirestoreDelete, useFirestoreBatch, } from './use-firestore-mutations';
+//# sourceMappingURL=index.js.map

package/dist/firestore/index.js.map

@@ -0,0 +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"}

package/dist/firestore/types.d.ts

@@ -0,0 +1,142 @@
+import type { DocumentData, DocumentSnapshot, QueryDocumentSnapshot, QueryConstraint } from 'firebase/firestore';
+/**
+ * Document with ID included in the data object.
+ */
+export type WithId<T> = T & {
+    id: string;
+};
+/**
+ * Extract document data with ID from a QueryDocumentSnapshot.
+ */
+export declare function docWithId<T extends DocumentData>(snap: QueryDocumentSnapshot<T>): WithId<T>;
+/**
+ * Base options shared across all Firestore hooks.
+ */
+export interface FirestoreBaseOptions {
+    /** React Query cache key */
+    queryKey: readonly unknown[];
+    /** Enable/disable the query */
+    enabled?: boolean;
+    /** Stale time override (ms) */
+    staleTime?: number;
+    /** Garbage collection time override (ms) */
+    gcTime?: number;
+}
+/**
+ * Options for single document queries.
+ */
+export interface FirestoreDocOptions<T> extends FirestoreBaseOptions {
+    /** Full document path (e.g., 'users/abc123') */
+    docPath: string;
+    /** Enable realtime updates via onSnapshot (default: false) */
+    subscribe?: boolean;
+    /** Transform function applied to document data. Receives data WITH id included. */
+    select?: (data: DocumentData & {
+        id: string;
+    }) => T;
+}
+/**
+ * Options for collection queries.
+ */
+export interface FirestoreCollectionOptions<T> extends FirestoreBaseOptions {
+    /** Collection path (e.g., 'users' or 'projects/abc/members') */
+    collectionPath: string;
+    /** Firestore query constraints (where, orderBy, etc.) */
+    constraints?: QueryConstraint[];
+    /** Enable realtime updates via onSnapshot (default: false) */
+    subscribe?: boolean;
+    /** Transform function applied to each document. Receives data WITH id included. */
+    select?: (data: DocumentData & {
+        id: string;
+    }) => T;
+}
+/**
+ * Options for infinite scroll queries.
+ */
+export interface FirestoreInfiniteOptions<T> extends FirestoreBaseOptions {
+    /** Collection path */
+    collectionPath: string;
+    /** Firestore query constraints (where, orderBy - required for pagination) */
+    constraints?: QueryConstraint[];
+    /** Number of items per page (default: 20) */
+    pageSize?: number;
+    /** Transform function applied to each document. Receives data WITH id included. */
+    select?: (data: DocumentData & {
+        id: string;
+    }) => T;
+}
+/**
+ * Options for paginated queries with page numbers.
+ */
+export interface FirestorePaginatedOptions<T> extends FirestoreBaseOptions {
+    /** Collection path */
+    collectionPath: string;
+    /** Firestore query constraints */
+    constraints?: QueryConstraint[];
+    /** Number of items per page (default: 10) */
+    pageSize?: number;
+    /** Initial page number (default: 1) */
+    initialPage?: number;
+    /** Transform function applied to each document. Receives data WITH id included. */
+    select?: (data: DocumentData & {
+        id: string;
+    }) => T;
+}
+/**
+ * Result page for infinite queries.
+ */
+export interface InfinitePage<T> {
+    items: WithId<T>[];
+    lastDoc: DocumentSnapshot | null;
+    size: number;
+}
+/**
+ * Result for paginated queries.
+ */
+export interface PaginatedResult<T> {
+    items: WithId<T>[];
+    cursors: DocumentSnapshot[];
+    hasMore: boolean;
+}
+/**
+ * Mutation operation types for batch mutations.
+ */
+export type MutationOperation = {
+    type: 'set';
+    docPath: string;
+    data: DocumentData;
+    merge?: boolean;
+} | {
+    type: 'update';
+    docPath: string;
+    data: DocumentData;
+} | {
+    type: 'delete';
+    docPath: string;
+};
+/**
+ * Options for document mutations.
+ */
+export interface FirestoreMutationOptions<T> {
+    /** Document path for single-doc mutations */
+    docPath?: string;
+    /** Query keys to invalidate on success */
+    invalidateKeys?: readonly unknown[][];
+    /** Enable optimistic updates */
+    optimistic?: {
+        /** Query key of the cache to update */
+        queryKey: readonly unknown[];
+        /** How to update the cached data */
+        updater: (oldData: T | undefined, newData: Partial<T>) => T;
+    };
+}
+/**
+ * Options for batch mutations.
+ */
+export interface FirestoreBatchOptions {
+    /** Query keys to invalidate on success */
+    invalidateKeys?: readonly unknown[][];
+    /** Max operations per batch (default: 450) */
+    batchSize?: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/firestore/types.js

@@ -0,0 +1,7 @@
+/**
+ * Extract document data with ID from a QueryDocumentSnapshot.
+ */
+export function docWithId(snap) {
+    return { id: snap.id, ...snap.data() };
+}
+//# sourceMappingURL=types.js.map

package/dist/firestore/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/firestore/types.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,IAA8B;IAE9B,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;AACzC,CAAC"}

package/dist/firestore/use-firestore-collection.d.ts

@@ -0,0 +1,27 @@
+import { type UseQueryResult } from '@tanstack/react-query';
+import { type DocumentData } from 'firebase/firestore';
+import type { FirestoreCollectionOptions, WithId } from './types';
+/**
+ * Fetch all documents from a Firestore collection with optional realtime updates.
+ * Use this for small collections where you need all documents at once.
+ * For large collections, use useFirestoreInfinite or useFirestorePaginated.
+ *
+ * @example
+ * ```tsx
+ * // Fetch all channels in a project
+ * const { data: channels } = useFirestoreCollection<Channel>({
+ *   collectionPath: `projects/${projectId}/channels`,
+ *   queryKey: ['channels', projectId],
+ *   constraints: [orderBy('createdAt', 'asc')],
+ * });
+ *
+ * // With realtime updates
+ * const { data: members } = useFirestoreCollection<Member>({
+ *   collectionPath: `projects/${projectId}/members`,
+ *   queryKey: ['members', projectId],
+ *   subscribe: true,
+ * });
+ * ```
+ */
+export declare function useFirestoreCollection<T extends DocumentData = DocumentData>({ collectionPath, queryKey, constraints, enabled, subscribe, staleTime, gcTime, select, }: FirestoreCollectionOptions<T>): UseQueryResult<WithId<T>[], Error>;
+//# sourceMappingURL=use-firestore-collection.d.ts.map

package/dist/firestore/use-firestore-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-firestore-collection.d.ts","sourceRoot":"","sources":["../../src/firestore/use-firestore-collection.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,EAC5E,cAAc,EACd,QAAQ,EACR,WAAgB,EAChB,OAAc,EACd,SAAiB,EACjB,SAAS,EACT,MAAM,EACN,MAAM,GACP,EAAE,0BAA0B,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,CAsDpE"}

package/dist/firestore/use-firestore-collection.js

@@ -0,0 +1,74 @@
+'use client';
+import { useEffect } from 'react';
+import { useQuery, useQueryClient } from '@tanstack/react-query';
+import { collection, query, getDocs, onSnapshot, } from 'firebase/firestore';
+import { useFirestoreDb } from './context';
+/**
+ * Fetch all documents from a Firestore collection with optional realtime updates.
+ * Use this for small collections where you need all documents at once.
+ * For large collections, use useFirestoreInfinite or useFirestorePaginated.
+ *
+ * @example
+ * ```tsx
+ * // Fetch all channels in a project
+ * const { data: channels } = useFirestoreCollection<Channel>({
+ *   collectionPath: `projects/${projectId}/channels`,
+ *   queryKey: ['channels', projectId],
+ *   constraints: [orderBy('createdAt', 'asc')],
+ * });
+ *
+ * // With realtime updates
+ * const { data: members } = useFirestoreCollection<Member>({
+ *   collectionPath: `projects/${projectId}/members`,
+ *   queryKey: ['members', projectId],
+ *   subscribe: true,
+ * });
+ * ```
+ */
+export function useFirestoreCollection({ collectionPath, queryKey, constraints = [], enabled = true, subscribe = false, staleTime, gcTime, select, }) {
+    const db = useFirestoreDb();
+    const queryClient = useQueryClient();
+    // Set up realtime subscription
+    useEffect(() => {
+        if (!subscribe || !enabled)
+            return;
+        const collectionRef = collection(db, collectionPath);
+        const q = constraints.length > 0
+            ? query(collectionRef, ...constraints)
+            : collectionRef;
+        const unsubscribe = onSnapshot(q, (snapshot) => {
+            const items = snapshot.docs.map((docSnap) => {
+                const rawData = docSnap.data();
+                // Include id in data passed to select, so it can be renamed/transformed
+                const dataWithId = { id: docSnap.id, ...rawData };
+                const data = select ? select(dataWithId) : dataWithId;
+                return data;
+            });
+            queryClient.setQueryData(queryKey, items);
+        }, (error) => {
+            console.error('[useFirestoreCollection] Subscription error:', error);
+        });
+        return () => unsubscribe();
+    }, [db, collectionPath, queryKey, constraints, enabled, subscribe, select, queryClient]);
+    return useQuery({
+        queryKey,
+        queryFn: async () => {
+            const collectionRef = collection(db, collectionPath);
+            const q = constraints.length > 0
+                ? query(collectionRef, ...constraints)
+                : collectionRef;
+            const snapshot = await getDocs(q);
+            return snapshot.docs.map((docSnap) => {
+                const rawData = docSnap.data();
+                // Include id in data passed to select, so it can be renamed/transformed
+                const dataWithId = { id: docSnap.id, ...rawData };
+                const data = select ? select(dataWithId) : dataWithId;
+                return data;
+            });
+        },
+        enabled: enabled && !subscribe,
+        staleTime: subscribe ? Infinity : staleTime,
+        gcTime,
+    });
+}
+//# sourceMappingURL=use-firestore-collection.js.map

package/dist/firestore/use-firestore-collection.js.map

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

package/dist/firestore/use-firestore-doc.d.ts

@@ -0,0 +1,31 @@
+import { type UseQueryResult } from '@tanstack/react-query';
+import { type DocumentData } from 'firebase/firestore';
+import type { FirestoreDocOptions, WithId } from './types';
+/**
+ * Fetch a single Firestore document with optional realtime updates.
+ *
+ * @example
+ * ```tsx
+ * // Simple fetch
+ * const { data: user } = useFirestoreDoc<User>({
+ *   docPath: `users/${userId}`,
+ *   queryKey: ['user', userId],
+ * });
+ *
+ * // With realtime updates
+ * const { data: project } = useFirestoreDoc<Project>({
+ *   docPath: `projects/${projectId}`,
+ *   queryKey: ['project', projectId],
+ *   subscribe: true,
+ * });
+ *
+ * // Conditional fetch
+ * const { data: profile } = useFirestoreDoc<Profile>({
+ *   docPath: `profiles/${userId}`,
+ *   queryKey: ['profile', userId],
+ *   enabled: !!userId,
+ * });
+ * ```
+ */
+export declare function useFirestoreDoc<T extends DocumentData = DocumentData>({ docPath, queryKey, enabled, subscribe, staleTime, gcTime, select, }: FirestoreDocOptions<T>): UseQueryResult<WithId<T> | null, Error>;
+//# sourceMappingURL=use-firestore-doc.d.ts.map

package/dist/firestore/use-firestore-doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-firestore-doc.d.ts","sourceRoot":"","sources":["../../src/firestore/use-firestore-doc.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,EACrE,OAAO,EACP,QAAQ,EACR,OAAc,EACd,SAAiB,EACjB,SAAS,EACT,MAAM,EACN,MAAM,GACP,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAkDlE"}

package/dist/firestore/use-firestore-doc.js

@@ -0,0 +1,75 @@
+'use client';
+import { useEffect } from 'react';
+import { useQuery, useQueryClient } from '@tanstack/react-query';
+import { doc, getDoc, onSnapshot } from 'firebase/firestore';
+import { useFirestoreDb } from './context';
+/**
+ * Fetch a single Firestore document with optional realtime updates.
+ *
+ * @example
+ * ```tsx
+ * // Simple fetch
+ * const { data: user } = useFirestoreDoc<User>({
+ *   docPath: `users/${userId}`,
+ *   queryKey: ['user', userId],
+ * });
+ *
+ * // With realtime updates
+ * const { data: project } = useFirestoreDoc<Project>({
+ *   docPath: `projects/${projectId}`,
+ *   queryKey: ['project', projectId],
+ *   subscribe: true,
+ * });
+ *
+ * // Conditional fetch
+ * const { data: profile } = useFirestoreDoc<Profile>({
+ *   docPath: `profiles/${userId}`,
+ *   queryKey: ['profile', userId],
+ *   enabled: !!userId,
+ * });
+ * ```
+ */
+export function useFirestoreDoc({ docPath, queryKey, enabled = true, subscribe = false, staleTime, gcTime, select, }) {
+    const db = useFirestoreDb();
+    const queryClient = useQueryClient();
+    // Set up realtime subscription
+    useEffect(() => {
+        if (!subscribe || !enabled)
+            return;
+        const docRef = doc(db, docPath);
+        const unsubscribe = onSnapshot(docRef, (snapshot) => {
+            if (snapshot.exists()) {
+                const rawData = snapshot.data();
+                // Include id in data passed to select, so it can be renamed/transformed
+                const dataWithId = { id: snapshot.id, ...rawData };
+                const data = select ? select(dataWithId) : dataWithId;
+                queryClient.setQueryData(queryKey, data);
+            }
+            else {
+                queryClient.setQueryData(queryKey, null);
+            }
+        }, (error) => {
+            console.error('[useFirestoreDoc] Subscription error:', error);
+        });
+        return () => unsubscribe();
+    }, [db, docPath, queryKey, enabled, subscribe, select, queryClient]);
+    return useQuery({
+        queryKey,
+        queryFn: async () => {
+            const docRef = doc(db, docPath);
+            const snapshot = await getDoc(docRef);
+            if (!snapshot.exists()) {
+                return null;
+            }
+            const rawData = snapshot.data();
+            // Include id in data passed to select, so it can be renamed/transformed
+            const dataWithId = { id: snapshot.id, ...rawData };
+            const data = select ? select(dataWithId) : dataWithId;
+            return data;
+        },
+        enabled: enabled && !subscribe, // Don't fetch if subscribing (snapshot handles it)
+        staleTime: subscribe ? Infinity : staleTime, // Realtime data is always fresh
+        gcTime,
+    });
+}
+//# sourceMappingURL=use-firestore-doc.js.map

package/dist/firestore/use-firestore-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-firestore-doc.js","sourceRoot":"","sources":["../../src/firestore/use-firestore-doc.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAuB,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAqB,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,eAAe,CAAwC,EACrE,OAAO,EACP,QAAQ,EACR,OAAO,GAAG,IAAI,EACd,SAAS,GAAG,KAAK,EACjB,SAAS,EACT,MAAM,EACN,MAAM,GACiB;IACvB,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,+BAA+B;IAC/B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO;YAAE,OAAO;QAEnC,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,UAAU,CAC5B,MAAM,EACN,CAAC,QAAQ,EAAE,EAAE;YACX,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,wEAAwE;gBACxE,MAAM,UAAU,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC;gBACnD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;gBACtD,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAiB,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;QAChE,CAAC,CACF,CAAC;QAEF,OAAO,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAErE,OAAO,QAAQ,CAAC;QACd,QAAQ;QACR,OAAO,EAAE,KAAK,IAA+B,EAAE;YAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;YAEtC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChC,wEAAwE;YACxE,MAAM,UAAU,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YACtD,OAAO,IAAiB,CAAC;QAC3B,CAAC;QACD,OAAO,EAAE,OAAO,IAAI,CAAC,SAAS,EAAE,mDAAmD;QACnF,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,gCAAgC;QAC7E,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/firestore/use-firestore-infinite.d.ts

@@ -0,0 +1,55 @@
+import { type UseInfiniteQueryResult } from '@tanstack/react-query';
+import { type DocumentData, type DocumentSnapshot } from 'firebase/firestore';
+import type { FirestoreInfiniteOptions, InfinitePage, WithId } from './types';
+/**
+ * Infinite scroll pagination for Firestore collections.
+ * Automatically handles cursor-based pagination with React Query.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   data,
+ *   fetchNextPage,
+ *   hasNextPage,
+ *   isFetchingNextPage,
+ *   isLoading,
+ * } = useFirestoreInfinite<Post>({
+ *   collectionPath: 'posts',
+ *   queryKey: ['posts', 'feed'],
+ *   constraints: [
+ *     where('status', '==', 'published'),
+ *     orderBy('createdAt', 'desc'),
+ *   ],
+ *   pageSize: 20,
+ * });
+ *
+ * // Flatten pages for rendering
+ * const posts = data?.pages.flatMap(page => page.items) ?? [];
+ *
+ * // Load more on scroll
+ * <InfiniteScroll onLoadMore={fetchNextPage} hasMore={hasNextPage} />
+ * ```
+ */
+export declare function useFirestoreInfinite<T extends DocumentData = DocumentData>({ collectionPath, queryKey, constraints, pageSize, enabled, staleTime, gcTime, select, }: FirestoreInfiniteOptions<T>): UseInfiniteQueryResult<{
+    pages: InfinitePage<T>[];
+    pageParams: (DocumentSnapshot | null)[];
+}, Error>;
+/**
+ * Helper to flatten infinite query pages into a single array.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useFirestoreInfinite<Post>({ ... });
+ * const posts = flattenInfiniteData(data);
+ * ```
+ */
+export declare function flattenInfiniteData<T>(data: {
+    pages: InfinitePage<T>[];
+} | undefined): WithId<T>[];
+/**
+ * Get total count of items across all loaded pages.
+ */
+export declare function getInfiniteDataCount<T>(data: {
+    pages: InfinitePage<T>[];
+} | undefined): number;
+//# sourceMappingURL=use-firestore-infinite.d.ts.map

package/dist/firestore/use-firestore-infinite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-firestore-infinite.d.ts","sourceRoot":"","sources":["../../src/firestore/use-firestore-infinite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAI9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,EAC1E,cAAc,EACd,QAAQ,EACR,WAAgB,EAChB,QAA4B,EAC5B,OAAc,EACd,SAAS,EACT,MAAM,EACN,MAAM,GACP,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC;IAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,CAAA;CAAE,EAAE,KAAK,CAAC,CA0CpI;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,IAAI,EAAE;IAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,GAAG,SAAS,GAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,CAGb;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,IAAI,EAAE;IAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,GAAG,SAAS,GAC7C,MAAM,CAGR"}

package/dist/firestore/use-firestore-infinite.js

@@ -0,0 +1,96 @@
+'use client';
+import { useInfiniteQuery } from '@tanstack/react-query';
+import { collection, query, getDocs, limit, startAfter, } from 'firebase/firestore';
+import { useFirestoreDb } from './context';
+const DEFAULT_PAGE_SIZE = 20;
+/**
+ * Infinite scroll pagination for Firestore collections.
+ * Automatically handles cursor-based pagination with React Query.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   data,
+ *   fetchNextPage,
+ *   hasNextPage,
+ *   isFetchingNextPage,
+ *   isLoading,
+ * } = useFirestoreInfinite<Post>({
+ *   collectionPath: 'posts',
+ *   queryKey: ['posts', 'feed'],
+ *   constraints: [
+ *     where('status', '==', 'published'),
+ *     orderBy('createdAt', 'desc'),
+ *   ],
+ *   pageSize: 20,
+ * });
+ *
+ * // Flatten pages for rendering
+ * const posts = data?.pages.flatMap(page => page.items) ?? [];
+ *
+ * // Load more on scroll
+ * <InfiniteScroll onLoadMore={fetchNextPage} hasMore={hasNextPage} />
+ * ```
+ */
+export function useFirestoreInfinite({ collectionPath, queryKey, constraints = [], pageSize = DEFAULT_PAGE_SIZE, enabled = true, staleTime, gcTime, select, }) {
+    const db = useFirestoreDb();
+    return useInfiniteQuery({
+        queryKey,
+        queryFn: async ({ pageParam }) => {
+            const collectionRef = collection(db, collectionPath);
+            // Build query with constraints
+            const queryConstraints = [
+                ...constraints,
+                ...(pageParam ? [startAfter(pageParam)] : []),
+                limit(pageSize),
+            ];
+            const q = query(collectionRef, ...queryConstraints);
+            const snapshot = await getDocs(q);
+            const items = snapshot.docs.map((docSnap) => {
+                const rawData = docSnap.data();
+                // Include id in data passed to select, so it can be renamed/transformed
+                const dataWithId = { id: docSnap.id, ...rawData };
+                const data = select ? select(dataWithId) : dataWithId;
+                return data;
+            });
+            return {
+                items,
+                lastDoc: snapshot.docs[snapshot.docs.length - 1] ?? null,
+                size: snapshot.docs.length,
+            };
+        },
+        initialPageParam: null,
+        getNextPageParam: (lastPage) => {
+            // If we got fewer items than requested, there are no more pages
+            if (lastPage.size < pageSize)
+                return undefined;
+            return lastPage.lastDoc;
+        },
+        enabled,
+        staleTime,
+        gcTime,
+    });
+}
+/**
+ * Helper to flatten infinite query pages into a single array.
+ *
+ * @example
+ * ```tsx
+ * const { data } = useFirestoreInfinite<Post>({ ... });
+ * const posts = flattenInfiniteData(data);
+ * ```
+ */
+export function flattenInfiniteData(data) {
+    if (!data)
+        return [];
+    return data.pages.flatMap((page) => page.items);
+}
+/**
+ * Get total count of items across all loaded pages.
+ */
+export function getInfiniteDataCount(data) {
+    if (!data)
+        return 0;
+    return data.pages.reduce((sum, page) => sum + page.items.length, 0);
+}
+//# sourceMappingURL=use-firestore-infinite.js.map

package/dist/firestore/use-firestore-infinite.js.map

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

package/dist/firestore/use-firestore-mutations.d.ts

@@ -0,0 +1,38 @@
+import { type QueryKey, type UseMutationResult } from '@tanstack/react-query';
+import { type DocumentData } from 'firebase/firestore';
+import type { FirestoreMutationOptions, FirestoreBatchOptions, MutationOperation } from './types';
+interface SetResult<T> {
+    id: string;
+    data: T;
+}
+export declare function useFirestoreSet<T extends DocumentData>({ invalidateKeys, }?: Pick<FirestoreMutationOptions<T>, 'invalidateKeys'>): UseMutationResult<SetResult<T>, Error, {
+    docPath: string;
+    data: T;
+    merge?: boolean;
+}>;
+export declare function useFirestoreUpdate<T extends DocumentData>({ invalidateKeys, optimistic, }?: FirestoreMutationOptions<T>): UseMutationResult<Partial<T>, Error, {
+    docPath: string;
+    data: Partial<T>;
+}, {
+    previousData: T | undefined;
+} | undefined>;
+export declare function useFirestoreDelete<T = unknown>({ invalidateKeys, optimistic, }?: {
+    invalidateKeys?: readonly QueryKey[];
+    optimistic?: {
+        queryKey: QueryKey;
+        updater: (oldData: T | undefined, docPath: string) => T;
+    };
+}): UseMutationResult<string, Error, {
+    docPath: string;
+}, {
+    previousData: T | undefined;
+} | undefined>;
+interface BatchResult {
+    committed: number;
+    batches: number;
+}
+export declare function useFirestoreBatch({ invalidateKeys, batchSize, }?: FirestoreBatchOptions): UseMutationResult<BatchResult, Error, {
+    operations: MutationOperation[];
+}>;
+export {};
+//# sourceMappingURL=use-firestore-mutations.d.ts.map

package/dist/firestore/use-firestore-mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-firestore-mutations.d.ts","sourceRoot":"","sources":["../../src/firestore/use-firestore-mutations.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC3G,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIlG,UAAU,SAAS,CAAC,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;CACT;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,EACtD,cAAmB,GACpB,GAAE,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAM,GAAG,iBAAiB,CAC7E,SAAS,CAAC,CAAC,CAAC,EACZ,KAAK,EACL;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAC9C,CAwBA;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,EAAE,EACzD,cAAmB,EACnB,UAAU,GACX,GAAE,wBAAwB,CAAC,CAAC,CAAM,GAAG,iBAAiB,CACrD,OAAO,CAAC,CAAC,CAAC,EACV,KAAK,EACL;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAAE,EACrC;IAAE,YAAY,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CAC5C,CA0CA;AAED,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,EAC9C,cAAmB,EACnB,UAAU,GACX,GAAE;IACD,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,QAAQ,CAAC;QACnB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC,CAAC;KACzD,CAAC;CACE,GAAG,iBAAiB,CACxB,MAAM,EACN,KAAK,EACL;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EACnB;IAAE,YAAY,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,GAAG,SAAS,CAC5C,CAoCA;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,cAAmB,EACnB,SAA8B,GAC/B,GAAE,qBAA0B,GAAG,iBAAiB,CAC/C,WAAW,EACX,KAAK,EACL;IAAE,UAAU,EAAE,iBAAiB,EAAE,CAAA;CAAE,CACpC,CAuDA"}

package/dist/firestore/use-firestore-mutations.js

@@ -0,0 +1,132 @@
+'use client';
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { doc, setDoc, updateDoc, deleteDoc, writeBatch, } from 'firebase/firestore';
+import { useFirestoreDb } from './context';
+const DEFAULT_BATCH_SIZE = 450;
+export function useFirestoreSet({ invalidateKeys = [], } = {}) {
+    const db = useFirestoreDb();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ docPath, data, merge = false, }) => {
+            const docRef = doc(db, docPath);
+            await setDoc(docRef, data, { merge });
+            return { id: docRef.id, data };
+        },
+        onSuccess: () => {
+            invalidateKeys.forEach((key) => {
+                queryClient.invalidateQueries({ queryKey: key });
+            });
+        },
+    });
+}
+export function useFirestoreUpdate({ invalidateKeys = [], optimistic, } = {}) {
+    const db = useFirestoreDb();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ docPath, data, }) => {
+            const docRef = doc(db, docPath);
+            await updateDoc(docRef, data);
+            return data;
+        },
+        onMutate: async ({ data }) => {
+            if (!optimistic)
+                return undefined;
+            await queryClient.cancelQueries({ queryKey: optimistic.queryKey });
+            const previousData = queryClient.getQueryData(optimistic.queryKey);
+            queryClient.setQueryData(optimistic.queryKey, (old) => optimistic.updater(old, data));
+            return { previousData };
+        },
+        onError: (_error, _variables, context) => {
+            if (optimistic && context?.previousData !== undefined) {
+                queryClient.setQueryData(optimistic.queryKey, context.previousData);
+            }
+        },
+        onSettled: () => {
+            invalidateKeys.forEach((key) => {
+                queryClient.invalidateQueries({ queryKey: key });
+            });
+            if (optimistic) {
+                queryClient.invalidateQueries({ queryKey: optimistic.queryKey });
+            }
+        },
+    });
+}
+export function useFirestoreDelete({ invalidateKeys = [], optimistic, } = {}) {
+    const db = useFirestoreDb();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ docPath }) => {
+            const docRef = doc(db, docPath);
+            await deleteDoc(docRef);
+            return docPath;
+        },
+        onMutate: async ({ docPath }) => {
+            if (!optimistic)
+                return undefined;
+            await queryClient.cancelQueries({ queryKey: optimistic.queryKey });
+            const previousData = queryClient.getQueryData(optimistic.queryKey);
+            queryClient.setQueryData(optimistic.queryKey, (old) => optimistic.updater(old, docPath));
+            return { previousData };
+        },
+        onError: (_error, _variables, context) => {
+            if (optimistic && context?.previousData !== undefined) {
+                queryClient.setQueryData(optimistic.queryKey, context.previousData);
+            }
+        },
+        onSettled: () => {
+            invalidateKeys.forEach((key) => {
+                queryClient.invalidateQueries({ queryKey: key });
+            });
+            if (optimistic) {
+                queryClient.invalidateQueries({ queryKey: optimistic.queryKey });
+            }
+        },
+    });
+}
+export function useFirestoreBatch({ invalidateKeys = [], batchSize = DEFAULT_BATCH_SIZE, } = {}) {
+    const db = useFirestoreDb();
+    const queryClient = useQueryClient();
+    return useMutation({
+        mutationFn: async ({ operations, }) => {
+            const chunks = [];
+            for (let i = 0; i < operations.length; i += batchSize) {
+                chunks.push(operations.slice(i, i + batchSize));
+            }
+            let totalCommitted = 0;
+            for (const chunk of chunks) {
+                const batch = writeBatch(db);
+                for (const op of chunk) {
+                    const docRef = doc(db, op.docPath);
+                    switch (op.type) {
+                        case 'set':
+                            if (op.merge) {
+                                batch.set(docRef, op.data, { merge: true });
+                            }
+                            else {
+                                batch.set(docRef, op.data);
+                            }
+                            break;
+                        case 'update':
+                            batch.update(docRef, op.data);
+                            break;
+                        case 'delete':
+                            batch.delete(docRef);
+                            break;
+                    }
+                }
+                await batch.commit();
+                totalCommitted += chunk.length;
+            }
+            return {
+                committed: totalCommitted,
+                batches: chunks.length,
+            };
+        },
+        onSuccess: () => {
+            invalidateKeys.forEach((key) => {
+                queryClient.invalidateQueries({ queryKey: key });
+            });
+        },
+    });
+}
+//# sourceMappingURL=use-firestore-mutations.js.map

package/dist/firestore/use-firestore-mutations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-firestore-mutations.js","sourceRoot":"","sources":["../../src/firestore/use-firestore-mutations.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,cAAc,EAAyC,MAAM,uBAAuB,CAAC;AAC3G,OAAO,EACL,GAAG,EACH,MAAM,EACN,SAAS,EACT,SAAS,EACT,UAAU,GAEX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAO/B,MAAM,UAAU,eAAe,CAAyB,EACtD,cAAc,GAAG,EAAE,MACoC,EAAE;IAKzD,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,KAAK,EAAE,EACjB,OAAO,EACP,IAAI,EACJ,KAAK,GAAG,KAAK,GAKd,EAAE,EAAE;YACH,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACtC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC7B,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAyB,EACzD,cAAc,GAAG,EAAE,EACnB,UAAU,MACqB,EAAE;IAMjC,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,KAAK,EAAE,EACjB,OAAO,EACP,IAAI,GAIL,EAAE,EAAE;YACH,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM,SAAS,CAAC,MAAM,EAAE,IAAoB,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;YAC3B,IAAI,CAAC,UAAU;gBAAE,OAAO,SAAS,CAAC;YAElC,MAAM,WAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnE,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,CAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;YAEtE,WAAW,CAAC,YAAY,CAAI,UAAU,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CACvD,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,IAAkB,CAAC,CAC5C,CAAC;YAEF,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;YACvC,IAAI,UAAU,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;gBACtD,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC7B,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YACH,IAAI,UAAU,EAAE,CAAC;gBACf,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAc,EAC9C,cAAc,GAAG,EAAE,EACnB,UAAU,MAOR,EAAE;IAMJ,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,KAAK,EAAE,EAAE,OAAO,EAAuB,EAAE,EAAE;YACrD,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;YACxB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC9B,IAAI,CAAC,UAAU;gBAAE,OAAO,SAAS,CAAC;YAElC,MAAM,WAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnE,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,CAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;YAEtE,WAAW,CAAC,YAAY,CAAI,UAAU,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CACvD,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CACjC,CAAC;YAEF,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;YACvC,IAAI,UAAU,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;gBACtD,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC7B,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YACH,IAAI,UAAU,EAAE,CAAC;gBACf,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAOD,MAAM,UAAU,iBAAiB,CAAC,EAChC,cAAc,GAAG,EAAE,EACnB,SAAS,GAAG,kBAAkB,MACL,EAAE;IAK3B,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,OAAO,WAAW,CAAC;QACjB,UAAU,EAAE,KAAK,EAAE,EACjB,UAAU,GAGX,EAAE,EAAE;YACH,MAAM,MAAM,GAA0B,EAAE,CAAC;YACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;YAClD,CAAC;YAED,IAAI,cAAc,GAAG,CAAC,CAAC;YAEvB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;gBAE7B,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;oBACvB,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;oBAEnC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;wBAChB,KAAK,KAAK;4BACR,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;gCACb,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;4BAC9C,CAAC;iCAAM,CAAC;gCACN,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;4BAC7B,CAAC;4BACD,MAAM;wBACR,KAAK,QAAQ;4BACX,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;4BAC9B,MAAM;wBACR,KAAK,QAAQ;4BACX,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;4BACrB,MAAM;oBACV,CAAC;gBACH,CAAC;gBAED,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;gBACrB,cAAc,IAAI,KAAK,CAAC,MAAM,CAAC;YACjC,CAAC;YAED,OAAO;gBACL,SAAS,EAAE,cAAc;gBACzB,OAAO,EAAE,MAAM,CAAC,MAAM;aACvB,CAAC;QACJ,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC7B,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/firestore/use-firestore-paginated.d.ts

@@ -0,0 +1,44 @@
+import { type UseQueryResult } from '@tanstack/react-query';
+import { type DocumentData } from 'firebase/firestore';
+import type { FirestorePaginatedOptions, WithId } from './types';
+/**
+ * Return type for useFirestorePaginated hook
+ */
+export type UseFirestorePaginatedResult<T> = UseQueryResult<WithId<T>[], Error> & {
+    page: number;
+    pageSize: number;
+    hasNextPage: boolean;
+    hasPrevPage: boolean;
+    setPage: (page: number) => void;
+    nextPage: () => void;
+    prevPage: () => void;
+    resetToFirstPage: () => void;
+};
+/**
+ * Page-based pagination for Firestore collections.
+ * Supports navigating to specific pages (1, 2, 3...) rather than infinite scroll.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   data,
+ *   page,
+ *   setPage,
+ *   hasNextPage,
+ *   hasPrevPage,
+ *   isLoading,
+ * } = useFirestorePaginated<Task>({
+ *   collectionPath: 'tasks',
+ *   queryKey: ['tasks', 'list'],
+ *   constraints: [where('status', '==', 'active'), orderBy('createdAt', 'desc')],
+ *   pageSize: 10,
+ * });
+ *
+ * // Render pagination controls
+ * <button onClick={() => setPage(page - 1)} disabled={!hasPrevPage}>Previous</button>
+ * <span>Page {page}</span>
+ * <button onClick={() => setPage(page + 1)} disabled={!hasNextPage}>Next</button>
+ * ```
+ */
+export declare function useFirestorePaginated<T extends DocumentData = DocumentData>({ collectionPath, queryKey, constraints, pageSize, initialPage, enabled, staleTime, gcTime, select, }: FirestorePaginatedOptions<T>): UseFirestorePaginatedResult<T>;
+//# sourceMappingURL=use-firestore-paginated.d.ts.map

package/dist/firestore/use-firestore-paginated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-firestore-paginated.d.ts","sourceRoot":"","sources":["../../src/firestore/use-firestore-paginated.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAML,KAAK,YAAY,EAElB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjE;;GAEG;AACH,MAAM,MAAM,2BAA2B,CAAC,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,EAC3E,cAAc,EACd,QAAQ,EACR,WAAgB,EAChB,QAA4B,EAC5B,WAAe,EACf,OAAc,EACd,SAAS,EACT,MAAM,EACN,MAAM,GACP,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,CAAC,CAAC,CAmG/D"}

package/dist/firestore/use-firestore-paginated.js

@@ -0,0 +1,117 @@
+'use client';
+import { useState, useCallback, useMemo } from 'react';
+import { useQuery, useQueryClient } from '@tanstack/react-query';
+import { collection, query, getDocs, limit, startAfter, } from 'firebase/firestore';
+import { useFirestoreDb } from './context';
+const DEFAULT_PAGE_SIZE = 10;
+/**
+ * Page-based pagination for Firestore collections.
+ * Supports navigating to specific pages (1, 2, 3...) rather than infinite scroll.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   data,
+ *   page,
+ *   setPage,
+ *   hasNextPage,
+ *   hasPrevPage,
+ *   isLoading,
+ * } = useFirestorePaginated<Task>({
+ *   collectionPath: 'tasks',
+ *   queryKey: ['tasks', 'list'],
+ *   constraints: [where('status', '==', 'active'), orderBy('createdAt', 'desc')],
+ *   pageSize: 10,
+ * });
+ *
+ * // Render pagination controls
+ * <button onClick={() => setPage(page - 1)} disabled={!hasPrevPage}>Previous</button>
+ * <span>Page {page}</span>
+ * <button onClick={() => setPage(page + 1)} disabled={!hasNextPage}>Next</button>
+ * ```
+ */
+export function useFirestorePaginated({ collectionPath, queryKey, constraints = [], pageSize = DEFAULT_PAGE_SIZE, initialPage = 1, enabled = true, staleTime, gcTime, select, }) {
+    const db = useFirestoreDb();
+    const queryClient = useQueryClient();
+    const [page, setPageInternal] = useState(initialPage);
+    const [cursors, setCursors] = useState(new Map());
+    const [hasMore, setHasMore] = useState(true);
+    // Create a stable query key that includes the page
+    const pageQueryKey = useMemo(() => [...queryKey, 'page', page], [queryKey, page]);
+    const queryResult = useQuery({
+        queryKey: pageQueryKey,
+        queryFn: async () => {
+            const collectionRef = collection(db, collectionPath);
+            // Get cursor for current page (if not page 1)
+            const cursor = page > 1 ? cursors.get(page - 1) : undefined;
+            // Build query
+            const queryConstraints = [
+                ...constraints,
+                ...(cursor ? [startAfter(cursor)] : []),
+                limit(pageSize),
+            ];
+            const q = query(collectionRef, ...queryConstraints);
+            const snapshot = await getDocs(q);
+            // Store the last doc as cursor for next page
+            if (snapshot.docs.length > 0) {
+                const lastDoc = snapshot.docs[snapshot.docs.length - 1];
+                setCursors((prev) => {
+                    const next = new Map(prev);
+                    next.set(page, lastDoc);
+                    return next;
+                });
+            }
+            // Determine if there are more pages
+            setHasMore(snapshot.docs.length === pageSize);
+            return snapshot.docs.map((docSnap) => {
+                const rawData = docSnap.data();
+                // Include id in data passed to select, so it can be renamed/transformed
+                const dataWithId = { id: docSnap.id, ...rawData };
+                const data = select ? select(dataWithId) : dataWithId;
+                return data;
+            });
+        },
+        enabled,
+        staleTime,
+        gcTime,
+    });
+    const setPage = useCallback((newPage) => {
+        if (newPage < 1)
+            return;
+        // Can only go forward one page at a time if cursor doesn't exist
+        if (newPage > page + 1 && !cursors.has(newPage - 1)) {
+            console.warn('[useFirestorePaginated] Cannot skip pages. Navigate sequentially.');
+            return;
+        }
+        setPageInternal(newPage);
+    }, [page, cursors]);
+    const nextPage = useCallback(() => {
+        if (hasMore)
+            setPage(page + 1);
+    }, [page, hasMore, setPage]);
+    const prevPage = useCallback(() => {
+        if (page > 1)
+            setPage(page - 1);
+    }, [page, setPage]);
+    const resetToFirstPage = useCallback(() => {
+        setCursors(new Map());
+        setPageInternal(1);
+        setHasMore(true);
+        // Invalidate all cached pages
+        queryClient.invalidateQueries({ queryKey, exact: false });
+    }, [queryClient, queryKey]);
+    return {
+        ...queryResult,
+        // Pagination state
+        page,
+        pageSize,
+        hasNextPage: hasMore,
+        hasPrevPage: page > 1,
+        // Navigation functions
+        setPage,
+        nextPage,
+        prevPage,
+        resetToFirstPage,
+    };
+}
+//# sourceMappingURL=use-firestore-paginated.js.map

package/dist/firestore/use-firestore-paginated.js.map

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

package/dist/index.d.ts

@@ -5,4 +5,6 @@ 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';
 //# 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":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,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,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"}

package/dist/index.js

@@ -1,5 +1,19 @@
+// Query Client
 export { createTTTQueryClient } from './query-client';
+// Query Keys
 export { keys, createKeyScope } from './keys';
+// Cache Helpers
 export { invalidateByPrefix, removeByPrefix, updateQueryData } from './cache-helpers';
+// Provider
 export { TTTQueryProvider } from './provider';
+// Firestore Integration
+export { 
+// Provider
+FirestoreProvider, useFirestoreDb, 
+// Query Hooks
+useFirestoreDoc, useFirestoreCollection, useFirestoreInfinite, useFirestorePaginated, 
+// Mutation Hooks
+useFirestoreSet, useFirestoreUpdate, useFirestoreDelete, useFirestoreBatch, 
+// Helpers
+flattenInfiniteData, getInfiniteDataCount, docWithId, } from './firestore';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,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,GACV,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@ttt-productions/query-core",
-    "version": "0.2.1",
-    "description": "Shared TanStack Query (React Query) client defaults + query key helpers for TTT Productions apps",
+    "version": "0.3.2",
+    "description": "Shared TanStack Query (React Query) client defaults, query key helpers, and Firestore integration hooks for TTT Productions apps",
     "repository": {
         "type": "git",
         "url": "git+https://github.com/ttt-productions/ttt-packages.git",
@@ -29,13 +29,20 @@
     },
     "peerDependencies": {
         "@tanstack/react-query": ">=5.0.0",
-        "react": ">=19.0.0",
-        "react-dom": ">=19.0.0"
+        "firebase": ">=10.0.0",
+        "react": ">=18.0.0",
+        "react-dom": ">=18.0.0"
+    },
+    "peerDependenciesMeta": {
+        "firebase": {
+            "optional": true
+        }
     },
     "devDependencies": {
         "@tanstack/react-query": "^5.0.0",
         "@types/react": "^19.0.0",
         "@types/react-dom": "^19.0.0",
+        "firebase": "^11.0.0",
         "react": "^19.2.0",
         "react-dom": "^19.2.0",
         "typescript": "^5.8.3"