@ttt-productions/query-core 0.14.22 → 0.14.23

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

@@ -4,25 +4,6 @@ export interface FirestoreProviderProps {
     db: Firestore;
     children: ReactNode;
 }
-/**
- * Provides Firestore instance to all useFirestore* hooks.
- * Wrap your app with this provider alongside QueryProvider.
- *
- * @example
- * ```tsx
- * import { db } from '@/lib/firebase';
- *
- * <QueryProvider>
- *   <FirestoreProvider db={db}>
- *     {children}
- *   </FirestoreProvider>
- * </QueryProvider>
- * ```
- */
 export declare function FirestoreProvider({ db, children }: FirestoreProviderProps): import("react").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/react/firestore/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/react/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,+BAEzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,SAAS,CAS1C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/react/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,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,sBAAsB,+BAEzE;AAED,wBAAgB,cAAc,IAAI,SAAS,CAS1C"}

package/dist/react/firestore/context.js

@@ -2,28 +2,9 @@
 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 QueryProvider.
- *
- * @example
- * ```tsx
- * import { db } from '@/lib/firebase';
- *
- * <QueryProvider>
- *   <FirestoreProvider db={db}>
- *     {children}
- *   </FirestoreProvider>
- * </QueryProvider>
- * ```
- */
 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) {

package/dist/react/firestore/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/react/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,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,EAAE,EAAE,YAAG,QAAQ,GAA6B,CAAC;AAC1F,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;YACxD,iDAAiD,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,EAAE,CAAC;AACpB,CAAC","sourcesContent":["'use client';\n\nimport { createContext, useContext, type ReactNode } from 'react';\nimport type { Firestore } from 'firebase/firestore';\n\ninterface FirestoreContextValue {\n  db: Firestore;\n}\n\nconst FirestoreContext = createContext<FirestoreContextValue | null>(null);\n\nexport interface FirestoreProviderProps {\n  db: Firestore;\n  children: ReactNode;\n}\n\n/**\n * Provides Firestore instance to all useFirestore* hooks.\n * Wrap your app with this provider alongside QueryProvider.\n *\n * @example\n * ```tsx\n * import { db } from '@/lib/firebase';\n *\n * <QueryProvider>\n *   <FirestoreProvider db={db}>\n *     {children}\n *   </FirestoreProvider>\n * </QueryProvider>\n * ```\n */\nexport function FirestoreProvider({ db, children }: FirestoreProviderProps) {\n  return <FirestoreContext.Provider value={{ db }}>{children}</FirestoreContext.Provider>;\n}\n\n/**\n * Access the Firestore instance from context.\n * Throws if used outside of FirestoreProvider.\n */\nexport function useFirestoreDb(): Firestore {\n  const context = useContext(FirestoreContext);\n  if (!context) {\n    throw new Error(\n      'useFirestoreDb must be used within a FirestoreProvider. ' +\n        'Wrap your app with <FirestoreProvider db={db}>.',\n    );\n  }\n  return context.db;\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/react/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,MAAM,UAAU,iBAAiB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAA0B;IACxE,OAAO,KAAC,gBAAgB,CAAC,QAAQ,IAAC,KAAK,EAAE,EAAE,EAAE,EAAE,YAAG,QAAQ,GAA6B,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,0DAA0D;YACxD,iDAAiD,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,EAAE,CAAC;AACpB,CAAC","sourcesContent":["'use client';\n\nimport { createContext, useContext, type ReactNode } from 'react';\nimport type { Firestore } from 'firebase/firestore';\n\ninterface FirestoreContextValue {\n  db: Firestore;\n}\n\nconst FirestoreContext = createContext<FirestoreContextValue | null>(null);\n\nexport interface FirestoreProviderProps {\n  db: Firestore;\n  children: ReactNode;\n}\n\nexport function FirestoreProvider({ db, children }: FirestoreProviderProps) {\n  return <FirestoreContext.Provider value={{ db }}>{children}</FirestoreContext.Provider>;\n}\n\nexport function useFirestoreDb(): Firestore {\n  const context = useContext(FirestoreContext);\n  if (!context) {\n    throw new Error(\n      'useFirestoreDb must be used within a FirestoreProvider. ' +\n        'Wrap your app with <FirestoreProvider db={db}>.',\n    );\n  }\n  return context.db;\n}\n"]}

package/dist/react/firestore/doc-subscription-registry.d.ts

@@ -1,39 +1,16 @@
 import { type Firestore } from 'firebase/firestore';
 import type { QueryClient } from '@tanstack/react-query';
-/**
- * True while a shared listener owns `[queryKeyPrefix, id]` for this client.
- *
- * A one-shot read that was already in flight when a consumer entered subscribe mode would
- * otherwise resolve AFTER the listener's first snapshot and overwrite it — and `onSnapshot`
- * does not re-emit until the document actually changes, so the stale value would stick.
- * The one-shot `queryFn` consults this after its read and yields to the listener's value.
- */
 export declare function isListenerOwned(queryClient: QueryClient, queryKeyPrefix: string, id: string): boolean;
-/**
- * The error of the shared listener that owns `[queryKeyPrefix, id]`, or `null` when no listener
- * owns the key or it has not errored. The listener writes `null` to the key when it errors, so a
- * one-shot reader of the same key consults this before taking that `null` as a missing document.
- */
 export declare function listenerErrorOf(queryClient: QueryClient, queryKeyPrefix: string, id: string): Error | null;
 export interface SubscribeDocParams {
     queryClient: QueryClient;
     db: Firestore;
-    /** Top-level/full collection path the doc lives in (e.g. 'publicUsers'). */
     collectionPath: string;
-    /** Cache key prefix; the doc is cached at `[queryKeyPrefix, id]`. */
     queryKeyPrefix: string;
     id: string;
-    /** Called whenever a snapshot (data or missing) lands, so the caller can re-render. */
     onUpdate: () => void;
-    /** Called on listener error — and at once on joining a listener that has already errored. */
     onError?: (error: Error) => void;
 }
-/**
- * Subscribe to a single document via a shared, reference-counted listener.
- * Returns an idempotent unsubscribe function; the underlying Firestore listener is
- * detached only when the last subscriber for that id unsubscribes.
- */
 export declare function subscribeDoc(params: SubscribeDocParams): () => void;
-/** Test-only: number of active shared listeners for a QueryClient. */
 export declare function __activeListenerCount(queryClient: QueryClient): number;
 //# sourceMappingURL=doc-subscription-registry.d.ts.map

package/dist/react/firestore/doc-subscription-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-subscription-registry.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/doc-subscription-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA8CzD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAET;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,GACT,KAAK,GAAG,IAAI,CAEd;AAWD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,EAAE,EAAE,SAAS,CAAC;IACd,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,uFAAuF;IACvF,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,IAAI,CA4DnE;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEtE"}
+{"version":3,"file":"doc-subscription-registry.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/doc-subscription-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAmBzD,wBAAgB,eAAe,CAC7B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,GACT,OAAO,CAET;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,EACtB,EAAE,EAAE,MAAM,GACT,KAAK,GAAG,IAAI,CAEd;AAWD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,EAAE,EAAE,SAAS,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAuDnE;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAEtE"}

package/dist/react/firestore/doc-subscription-registry.js

@@ -1,26 +1,12 @@
 'use client';
 import { doc, onSnapshot } from 'firebase/firestore';
-// Per-QueryClient registry. WeakMap so a discarded QueryClient (and its entries) is GC'd.
 const registries = new WeakMap();
 function registryKey(queryKeyPrefix, id) {
     return `${queryKeyPrefix} ${id}`;
 }
-/**
- * True while a shared listener owns `[queryKeyPrefix, id]` for this client.
- *
- * A one-shot read that was already in flight when a consumer entered subscribe mode would
- * otherwise resolve AFTER the listener's first snapshot and overwrite it — and `onSnapshot`
- * does not re-emit until the document actually changes, so the stale value would stick.
- * The one-shot `queryFn` consults this after its read and yields to the listener's value.
- */
 export function isListenerOwned(queryClient, queryKeyPrefix, id) {
     return registries.get(queryClient)?.has(registryKey(queryKeyPrefix, id)) ?? false;
 }
-/**
- * The error of the shared listener that owns `[queryKeyPrefix, id]`, or `null` when no listener
- * owns the key or it has not errored. The listener writes `null` to the key when it errors, so a
- * one-shot reader of the same key consults this before taking that `null` as a missing document.
- */
 export function listenerErrorOf(queryClient, queryKeyPrefix, id) {
     return registries.get(queryClient)?.get(registryKey(queryKeyPrefix, id))?.error ?? null;
 }
@@ -32,11 +18,6 @@ function getRegistry(queryClient) {
     }
     return registry;
 }
-/**
- * Subscribe to a single document via a shared, reference-counted listener.
- * Returns an idempotent unsubscribe function; the underlying Firestore listener is
- * detached only when the last subscriber for that id unsubscribes.
- */
 export function subscribeDoc(params) {
     const { queryClient, db, collectionPath, queryKeyPrefix, id, onUpdate, onError } = params;
     const registry = getRegistry(queryClient);
@@ -57,9 +38,6 @@ export function subscribeDoc(params) {
             for (const sub of [...subscribers])
                 sub.onUpdate();
         }, (error) => {
-            // Write `null` so the id resolves — as a failure, through the kept error — instead
-            // of loading forever: subscribe-mode loading ("no cache entry yet") would otherwise
-            // stay true for ids whose listener can never land a snapshot.
             created.error = error;
             queryClient.setQueryData([queryKeyPrefix, id], null, { updatedAt: Date.now() });
             for (const sub of [...subscribers])
@@ -84,15 +62,12 @@ export function subscribeDoc(params) {
         if (current.subscribers.size === 0) {
             current.unsubscribe();
             registry.delete(key);
-            // A failed listener's `null` is a placeholder, not a read: once nothing owns the key,
-            // mark it stale so a remaining one-shot reader reads the document for itself.
             if (current.error) {
                 void queryClient.invalidateQueries({ queryKey: [queryKeyPrefix, id], exact: true });
             }
         }
     };
 }
-/** Test-only: number of active shared listeners for a QueryClient. */
 export function __activeListenerCount(queryClient) {
     return registries.get(queryClient)?.size ?? 0;
 }

package/dist/react/firestore/doc-subscription-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"doc-subscription-registry.js","sourceRoot":"","sources":["../../../src/react/firestore/doc-subscription-registry.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { doc, onSnapshot, type Firestore } from 'firebase/firestore';\nimport type { QueryClient } from '@tanstack/react-query';\n\n/**\n * Reference-counted, real-time document subscription registry.\n *\n * Backs the `subscribe` mode of {@link useBatchFirestoreDocs}. The problem it solves:\n * many components on a page resolve the SAME document id (e.g. the same author rendered\n * in a feed card, a comment, and a mention). Without sharing, each would open its own\n * `onSnapshot` listener. This registry keeps exactly ONE Firestore listener per\n * `(queryClient, queryKeyPrefix, id)` and fans its updates out to every subscriber, so N\n * components showing the same id cost one listener.\n *\n * The single listener writes the document straight into the React Query cache at\n * `[queryKeyPrefix, id]` — `{ id, ...data }` when the doc exists, or `null` when it does\n * not (negative caching, so a missing/lagging doc resolves the instant it appears instead\n * of staying blank until staleTime). A listener ERROR also negative-caches the id: a\n * rules-denied doc (hidden, or non-existent when the rule references `resource.data`) is\n * resolved, not forever-loading — consumers see `data: null` plus the error instead\n * of an eternal spinner. Firestore ends a listener that errors, so the entry keeps that error\n * for as long as the entry lives (until its last subscriber leaves; a later snapshot, were one\n * to arrive, clears it): a subscriber that joins an errored listener receives the error too,\n * and a one-shot reader of the same key reads it through `listenerErrorOf`, so neither takes\n * the cached `null` as a missing document. The registry is keyed per `QueryClient` (a WeakMap),\n * which in practice means per browser tab, so each tab listens independently and stays\n * consistent without cross-tab plumbing.\n */\n\ntype Subscriber = {\n  onUpdate: () => void;\n  onError?: (error: Error) => void;\n};\n\ntype Entry = {\n  unsubscribe: () => void;\n  subscribers: Set<Subscriber>;\n  /** The listener's last error, cleared by the next snapshot. */\n  error: Error | null;\n};\n\n// Per-QueryClient registry. WeakMap so a discarded QueryClient (and its entries) is GC'd.\nconst registries = new WeakMap<QueryClient, Map<string, Entry>>();\n\nfunction registryKey(queryKeyPrefix: string, id: string): string {\n  return `${queryKeyPrefix} ${id}`;\n}\n\n/**\n * True while a shared listener owns `[queryKeyPrefix, id]` for this client.\n *\n * A one-shot read that was already in flight when a consumer entered subscribe mode would\n * otherwise resolve AFTER the listener's first snapshot and overwrite it — and `onSnapshot`\n * does not re-emit until the document actually changes, so the stale value would stick.\n * The one-shot `queryFn` consults this after its read and yields to the listener's value.\n */\nexport function isListenerOwned(\n  queryClient: QueryClient,\n  queryKeyPrefix: string,\n  id: string,\n): boolean {\n  return registries.get(queryClient)?.has(registryKey(queryKeyPrefix, id)) ?? false;\n}\n\n/**\n * The error of the shared listener that owns `[queryKeyPrefix, id]`, or `null` when no listener\n * owns the key or it has not errored. The listener writes `null` to the key when it errors, so a\n * one-shot reader of the same key consults this before taking that `null` as a missing document.\n */\nexport function listenerErrorOf(\n  queryClient: QueryClient,\n  queryKeyPrefix: string,\n  id: string,\n): Error | null {\n  return registries.get(queryClient)?.get(registryKey(queryKeyPrefix, id))?.error ?? null;\n}\n\nfunction getRegistry(queryClient: QueryClient): Map<string, Entry> {\n  let registry = registries.get(queryClient);\n  if (!registry) {\n    registry = new Map();\n    registries.set(queryClient, registry);\n  }\n  return registry;\n}\n\nexport interface SubscribeDocParams {\n  queryClient: QueryClient;\n  db: Firestore;\n  /** Top-level/full collection path the doc lives in (e.g. 'publicUsers'). */\n  collectionPath: string;\n  /** Cache key prefix; the doc is cached at `[queryKeyPrefix, id]`. */\n  queryKeyPrefix: string;\n  id: string;\n  /** Called whenever a snapshot (data or missing) lands, so the caller can re-render. */\n  onUpdate: () => void;\n  /** Called on listener error — and at once on joining a listener that has already errored. */\n  onError?: (error: Error) => void;\n}\n\n/**\n * Subscribe to a single document via a shared, reference-counted listener.\n * Returns an idempotent unsubscribe function; the underlying Firestore listener is\n * detached only when the last subscriber for that id unsubscribes.\n */\nexport function subscribeDoc(params: SubscribeDocParams): () => void {\n  const { queryClient, db, collectionPath, queryKeyPrefix, id, onUpdate, onError } = params;\n  const registry = getRegistry(queryClient);\n  const key = registryKey(queryKeyPrefix, id);\n\n  let entry = registry.get(key);\n  if (!entry) {\n    const created: Entry = {\n      unsubscribe: () => {},\n      subscribers: new Set<Subscriber>(),\n      error: null,\n    };\n    const subscribers = created.subscribers;\n    const ref = doc(db, collectionPath, id);\n    created.unsubscribe = onSnapshot(\n      ref,\n      (snapshot) => {\n        created.error = null;\n        queryClient.setQueryData(\n          [queryKeyPrefix, id],\n          snapshot.exists() ? { id: snapshot.id, ...snapshot.data() } : null,\n          { updatedAt: Date.now() },\n        );\n        // Copy before iterating: an onUpdate could (re-entrantly) unsubscribe.\n        for (const sub of [...subscribers]) sub.onUpdate();\n      },\n      (error) => {\n        // Write `null` so the id resolves — as a failure, through the kept error — instead\n        // of loading forever: subscribe-mode loading (\"no cache entry yet\") would otherwise\n        // stay true for ids whose listener can never land a snapshot.\n        created.error = error;\n        queryClient.setQueryData([queryKeyPrefix, id], null, { updatedAt: Date.now() });\n        for (const sub of [...subscribers]) sub.onError?.(error);\n      },\n    );\n    entry = created;\n    registry.set(key, entry);\n  }\n\n  const subscriber: Subscriber = { onUpdate, onError };\n  entry.subscribers.add(subscriber);\n  if (entry.error) onError?.(entry.error);\n\n  let released = false;\n  return () => {\n    if (released) return;\n    released = true;\n    const current = registry.get(key);\n    if (!current) return;\n    current.subscribers.delete(subscriber);\n    if (current.subscribers.size === 0) {\n      current.unsubscribe();\n      registry.delete(key);\n      // A failed listener's `null` is a placeholder, not a read: once nothing owns the key,\n      // mark it stale so a remaining one-shot reader reads the document for itself.\n      if (current.error) {\n        void queryClient.invalidateQueries({ queryKey: [queryKeyPrefix, id], exact: true });\n      }\n    }\n  };\n}\n\n/** Test-only: number of active shared listeners for a QueryClient. */\nexport function __activeListenerCount(queryClient: QueryClient): number {\n  return registries.get(queryClient)?.size ?? 0;\n}\n"]}
+{"version":3,"file":"doc-subscription-registry.js","sourceRoot":"","sources":["../../../src/react/firestore/doc-subscription-registry.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { doc, onSnapshot, type Firestore } from 'firebase/firestore';\nimport type { QueryClient } from '@tanstack/react-query';\n\ntype Subscriber = {\n  onUpdate: () => void;\n  onError?: (error: Error) => void;\n};\n\ntype Entry = {\n  unsubscribe: () => void;\n  subscribers: Set<Subscriber>;\n  error: Error | null;\n};\n\nconst registries = new WeakMap<QueryClient, Map<string, Entry>>();\n\nfunction registryKey(queryKeyPrefix: string, id: string): string {\n  return `${queryKeyPrefix} ${id}`;\n}\n\nexport function isListenerOwned(\n  queryClient: QueryClient,\n  queryKeyPrefix: string,\n  id: string,\n): boolean {\n  return registries.get(queryClient)?.has(registryKey(queryKeyPrefix, id)) ?? false;\n}\n\nexport function listenerErrorOf(\n  queryClient: QueryClient,\n  queryKeyPrefix: string,\n  id: string,\n): Error | null {\n  return registries.get(queryClient)?.get(registryKey(queryKeyPrefix, id))?.error ?? null;\n}\n\nfunction getRegistry(queryClient: QueryClient): Map<string, Entry> {\n  let registry = registries.get(queryClient);\n  if (!registry) {\n    registry = new Map();\n    registries.set(queryClient, registry);\n  }\n  return registry;\n}\n\nexport interface SubscribeDocParams {\n  queryClient: QueryClient;\n  db: Firestore;\n  collectionPath: string;\n  queryKeyPrefix: string;\n  id: string;\n  onUpdate: () => void;\n  onError?: (error: Error) => void;\n}\n\nexport function subscribeDoc(params: SubscribeDocParams): () => void {\n  const { queryClient, db, collectionPath, queryKeyPrefix, id, onUpdate, onError } = params;\n  const registry = getRegistry(queryClient);\n  const key = registryKey(queryKeyPrefix, id);\n\n  let entry = registry.get(key);\n  if (!entry) {\n    const created: Entry = {\n      unsubscribe: () => {},\n      subscribers: new Set<Subscriber>(),\n      error: null,\n    };\n    const subscribers = created.subscribers;\n    const ref = doc(db, collectionPath, id);\n    created.unsubscribe = onSnapshot(\n      ref,\n      (snapshot) => {\n        created.error = null;\n        queryClient.setQueryData(\n          [queryKeyPrefix, id],\n          snapshot.exists() ? { id: snapshot.id, ...snapshot.data() } : null,\n          { updatedAt: Date.now() },\n        );\n        // Copy before iterating: an onUpdate could (re-entrantly) unsubscribe.\n        for (const sub of [...subscribers]) sub.onUpdate();\n      },\n      (error) => {\n        created.error = error;\n        queryClient.setQueryData([queryKeyPrefix, id], null, { updatedAt: Date.now() });\n        for (const sub of [...subscribers]) sub.onError?.(error);\n      },\n    );\n    entry = created;\n    registry.set(key, entry);\n  }\n\n  const subscriber: Subscriber = { onUpdate, onError };\n  entry.subscribers.add(subscriber);\n  if (entry.error) onError?.(entry.error);\n\n  let released = false;\n  return () => {\n    if (released) return;\n    released = true;\n    const current = registry.get(key);\n    if (!current) return;\n    current.subscribers.delete(subscriber);\n    if (current.subscribers.size === 0) {\n      current.unsubscribe();\n      registry.delete(key);\n      if (current.error) {\n        void queryClient.invalidateQueries({ queryKey: [queryKeyPrefix, id], exact: true });\n      }\n    }\n  };\n}\n\nexport function __activeListenerCount(queryClient: QueryClient): number {\n  return registries.get(queryClient)?.size ?? 0;\n}\n"]}

package/dist/react/firestore/infinite-helpers.d.ts

@@ -1,20 +1,8 @@
 import type { WithId } from '../../firestore/types.js';
 import type { InfinitePage } from './types.js';
-/**
- * Flatten infinite query pages into a single array of items.
- *
- * @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;

package/dist/react/firestore/infinite-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"infinite-helpers.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/infinite-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;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,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,GAAG,SAAS,GAAG,MAAM,CAG9F"}
+{"version":3,"file":"infinite-helpers.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/infinite-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,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,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,GAAG,SAAS,GAAG,MAAM,CAG9F"}

package/dist/react/firestore/infinite-helpers.js

@@ -1,20 +1,8 @@
-/**
- * Flatten infinite query pages into a single array of items.
- *
- * @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;

package/dist/react/firestore/infinite-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"infinite-helpers.js","sourceRoot":"","sources":["../../../src/react/firestore/infinite-helpers.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA8C;IAE9C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAI,IAA8C;IACpF,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC","sourcesContent":["import type { WithId } from '../../firestore/types.js';\nimport type { InfinitePage } from './types.js';\n\n/**\n * Flatten infinite query pages into a single array of items.\n *\n * @example\n * ```tsx\n * const { data } = useFirestoreInfinite<Post>({ ... });\n * const posts = flattenInfiniteData(data);\n * ```\n */\nexport function flattenInfiniteData<T>(\n  data: { pages: InfinitePage<T>[] } | undefined,\n): WithId<T>[] {\n  if (!data) return [];\n  return data.pages.flatMap((page) => page.items);\n}\n\n/**\n * Get total count of items across all loaded pages.\n */\nexport function getInfiniteDataCount<T>(data: { pages: InfinitePage<T>[] } | undefined): number {\n  if (!data) return 0;\n  return data.pages.reduce((sum, page) => sum + page.items.length, 0);\n}\n"]}
+{"version":3,"file":"infinite-helpers.js","sourceRoot":"","sources":["../../../src/react/firestore/infinite-helpers.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CACjC,IAA8C;IAE9C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,IAA8C;IACpF,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC","sourcesContent":["import type { WithId } from '../../firestore/types.js';\nimport type { InfinitePage } from './types.js';\n\nexport function flattenInfiniteData<T>(\n  data: { pages: InfinitePage<T>[] } | undefined,\n): WithId<T>[] {\n  if (!data) return [];\n  return data.pages.flatMap((page) => page.items);\n}\n\nexport function getInfiniteDataCount<T>(data: { pages: InfinitePage<T>[] } | undefined): number {\n  if (!data) return 0;\n  return data.pages.reduce((sum, page) => sum + page.items.length, 0);\n}\n"]}

package/dist/react/firestore/resubscribe.d.ts

@@ -1,23 +1,3 @@
-/**
- * Bounded resubscribe ladder for realtime Firestore listeners.
- *
- * A subscription that dies on a `permission-denied` listener error never retries on
- * its own. In practice this fires transiently mid-session: the App Check token
- * expires ~1h in and the SDK's silent refresh mint can fail (e.g. the refresh hits
- * the reCAPTCHA bot-score throttle), so an active `onSnapshot` errors with
- * `permission-denied` even though the user is still authorized. Without a retry the
- * widget stays permanently dead until a full reload.
- *
- * These delays (ms) are the backoff between resubscribe attempts. After the last
- * one the error surfaces exactly as it did before. While the ladder runs the
- * consumer keeps its last-known data and reads `sourceState: 'connecting'`; a
- * healthy snapshot resets the ladder so a later blip gets a fresh window.
- */
 export declare const RESUBSCRIBE_DELAYS_MS: readonly [5000, 15000, 45000];
-/**
- * True for a Firestore `permission-denied` listener error — the only code the
- * subscription hooks bounded-retry (a failed token refresh heals within seconds).
- * Keys off the `FirestoreError.code`, never the message.
- */
 export declare function isPermissionDeniedError(error: unknown): boolean;
 //# sourceMappingURL=resubscribe.d.ts.map

package/dist/react/firestore/resubscribe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resubscribe.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/resubscribe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,+BAAmC,CAAC;AAEtE;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/D"}
+{"version":3,"file":"resubscribe.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/resubscribe.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,+BAAmC,CAAC;AAEtE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/D"}

package/dist/react/firestore/resubscribe.js

@@ -1,24 +1,4 @@
-/**
- * Bounded resubscribe ladder for realtime Firestore listeners.
- *
- * A subscription that dies on a `permission-denied` listener error never retries on
- * its own. In practice this fires transiently mid-session: the App Check token
- * expires ~1h in and the SDK's silent refresh mint can fail (e.g. the refresh hits
- * the reCAPTCHA bot-score throttle), so an active `onSnapshot` errors with
- * `permission-denied` even though the user is still authorized. Without a retry the
- * widget stays permanently dead until a full reload.
- *
- * These delays (ms) are the backoff between resubscribe attempts. After the last
- * one the error surfaces exactly as it did before. While the ladder runs the
- * consumer keeps its last-known data and reads `sourceState: 'connecting'`; a
- * healthy snapshot resets the ladder so a later blip gets a fresh window.
- */
 export const RESUBSCRIBE_DELAYS_MS = [5_000, 15_000, 45_000];
-/**
- * True for a Firestore `permission-denied` listener error — the only code the
- * subscription hooks bounded-retry (a failed token refresh heals within seconds).
- * Keys off the `FirestoreError.code`, never the message.
- */
 export function isPermissionDeniedError(error) {
     return error?.code === 'permission-denied';
 }

package/dist/react/firestore/resubscribe.js.map

@@ -1 +1 @@
-{"version":3,"file":"resubscribe.js","sourceRoot":"","sources":["../../../src/react/firestore/resubscribe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAEtE;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAQ,KAA8C,EAAE,IAAI,KAAK,mBAAmB,CAAC;AACvF,CAAC","sourcesContent":["/**\n * Bounded resubscribe ladder for realtime Firestore listeners.\n *\n * A subscription that dies on a `permission-denied` listener error never retries on\n * its own. In practice this fires transiently mid-session: the App Check token\n * expires ~1h in and the SDK's silent refresh mint can fail (e.g. the refresh hits\n * the reCAPTCHA bot-score throttle), so an active `onSnapshot` errors with\n * `permission-denied` even though the user is still authorized. Without a retry the\n * widget stays permanently dead until a full reload.\n *\n * These delays (ms) are the backoff between resubscribe attempts. After the last\n * one the error surfaces exactly as it did before. While the ladder runs the\n * consumer keeps its last-known data and reads `sourceState: 'connecting'`; a\n * healthy snapshot resets the ladder so a later blip gets a fresh window.\n */\nexport const RESUBSCRIBE_DELAYS_MS = [5_000, 15_000, 45_000] as const;\n\n/**\n * True for a Firestore `permission-denied` listener error — the only code the\n * subscription hooks bounded-retry (a failed token refresh heals within seconds).\n * Keys off the `FirestoreError.code`, never the message.\n */\nexport function isPermissionDeniedError(error: unknown): boolean {\n  return (error as { code?: string } | null | undefined)?.code === 'permission-denied';\n}\n"]}
+{"version":3,"file":"resubscribe.js","sourceRoot":"","sources":["../../../src/react/firestore/resubscribe.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAEtE,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAQ,KAA8C,EAAE,IAAI,KAAK,mBAAmB,CAAC;AACvF,CAAC","sourcesContent":["export const RESUBSCRIBE_DELAYS_MS = [5_000, 15_000, 45_000] as const;\n\nexport function isPermissionDeniedError(error: unknown): boolean {\n  return (error as { code?: string } | null | undefined)?.code === 'permission-denied';\n}\n"]}

package/dist/react/firestore/subscription-status.d.ts

@@ -1,10 +1,7 @@
 import type { UseQueryResult } from '@tanstack/react-query';
 import type { FirestoreSourceState, WithSourceState } from '../../firestore/types.js';
-/** A restart a subscribed result's `refetch()` asked for, open until the listener's first snapshot or its next error. */
 interface PendingRestart {
-    /** The listener had failed when the restart was asked for. */
     fromError: boolean;
-    /** That failure, kept beside the held data while the restart is open, as a one-shot refetch keeps it. */
     failure: Error | null;
 }
 interface SubscriptionStatus {
@@ -12,19 +9,9 @@ interface SubscriptionStatus {
     error: Error | null;
     sourceState: FirestoreSourceState;
     restart: PendingRestart | null;
-    /** Bumped by every restart; the listener effect depends on it, so a bump re-opens the listener. */
     restarts: number;
 }
 type StatusPatch = Partial<Omit<SubscriptionStatus, 'identity' | 'restarts'>>;
-/**
- * A realtime listener's source state and error, tagged to the subscription identity that
- * produced them. A new identity reads `connecting` with no error from its first render;
- * writes made for a retired identity are dropped once the new identity's listener has
- * started (it calls `reset`).
- *
- * `restart()` clears the error and bumps `restarts`; the listener effect re-opens on the bump,
- * and its first snapshot or next surfaced error ends the restart (`settled` in the patch).
- */
 export declare function useSubscriptionStatus(identity: string): {
     error: Error | null;
     sourceState: FirestoreSourceState;
@@ -35,22 +22,6 @@ export declare function useSubscriptionStatus(identity: string): {
     restart: () => boolean;
 };
 type SubscriptionStatusApi = ReturnType<typeof useSubscriptionStatus>;
-/**
- * The subscribed hooks' result: the query's own result, with the listener's error and source
- * state merged in. In subscribe mode `refetch()` re-opens the listener (clearing its error, with a
- * fresh resubscribe ladder) and resolves once the re-opened listener delivers its first snapshot or
- * surfaces its next error; until then the result reports fetching.
- *
- * A listener that fails after it answered keeps its last snapshot as `data` beside the failure, the
- * way a one-shot read that fails a refetch keeps its data: `status: 'error'` and `isRefetchError`
- * say the rows are not current, and a consumer can keep what it showed instead of tearing it down.
- * A restart from that failure keeps both — the held data and the failure — until the re-opened
- * listener answers. A listener that failed before it ever answered has no data to hold.
- *
- * A `permission-denied` failure holds nothing: the reader lost access, and a snapshot it may no
- * longer read is never presented as readable. It reads like a failure before any answer, and so
- * does its restart.
- */
 export declare function useSubscribedResult<TData>(query: UseQueryResult<TData, Error>, subscribe: boolean, enabled: boolean, status: SubscriptionStatusApi): WithSourceState<UseQueryResult<TData, Error>>;
 export {};
 //# sourceMappingURL=subscription-status.d.ts.map

package/dist/react/firestore/subscription-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscription-status.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/subscription-status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAuC,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGtF,yHAAyH;AACzH,UAAU,cAAc;IACtB,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,yGAAyG;IACzG,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;CACvB;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,mGAAmG;IACnG,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC;AAM9E;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM;;;;;;oBAc1C,WAAW,GAAG,CAAC,CAAC,IAAI,EAAE,kBAAkB,KAAK,WAAW,CAAC;mBAkBnC,OAAO;EA2BxC;AAED,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAQtE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EACvC,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,EACnC,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,qBAAqB,GAC5B,eAAe,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CA6H/C"}
+{"version":3,"file":"subscription-status.d.ts","sourceRoot":"","sources":["../../../src/react/firestore/subscription-status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAuC,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGtF,UAAU,cAAc;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;CACvB;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC;AAM9E,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM;;;;;;oBAc1C,WAAW,GAAG,CAAC,CAAC,IAAI,EAAE,kBAAkB,KAAK,WAAW,CAAC;mBAenC,OAAO;EA2BxC;AAED,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAQtE,wBAAgB,mBAAmB,CAAC,KAAK,EACvC,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,EACnC,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,qBAAqB,GAC5B,eAAe,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAwH/C"}

package/dist/react/firestore/subscription-status.js

@@ -4,15 +4,6 @@ import { isPermissionDeniedError } from './resubscribe.js';
 function freshStatus(identity) {
     return { identity, error: null, sourceState: 'connecting', restart: null, restarts: 0 };
 }
-/**
- * A realtime listener's source state and error, tagged to the subscription identity that
- * produced them. A new identity reads `connecting` with no error from its first render;
- * writes made for a retired identity are dropped once the new identity's listener has
- * started (it calls `reset`).
- *
- * `restart()` clears the error and bumps `restarts`; the listener effect re-opens on the bump,
- * and its first snapshot or next surfaced error ends the restart (`settled` in the patch).
- */
 export function useSubscriptionStatus(identity) {
     const [status, setStatus] = useState(() => freshStatus(identity));
     const current = status.identity === identity ? status : freshStatus(identity);
@@ -29,13 +20,10 @@ export function useSubscriptionStatus(identity) {
             return { ...prev, ...next };
         });
     }, [identity]);
-    // The identity the hook renders now. A `restart` captured under an earlier identity must not
-    // touch the current one's status, or every write the current listener makes would be dropped.
     const renderedIdentity = useRef(identity);
     useEffect(() => {
         renderedIdentity.current = identity;
     }, [identity]);
-    /** Re-opens the listener; false (and nothing changes) when this identity is no longer rendered. */
     const restart = useCallback(() => {
         if (renderedIdentity.current !== identity)
             return false;
@@ -64,22 +52,6 @@ export function useSubscriptionStatus(identity) {
         restart,
     };
 }
-/**
- * The subscribed hooks' result: the query's own result, with the listener's error and source
- * state merged in. In subscribe mode `refetch()` re-opens the listener (clearing its error, with a
- * fresh resubscribe ladder) and resolves once the re-opened listener delivers its first snapshot or
- * surfaces its next error; until then the result reports fetching.
- *
- * A listener that fails after it answered keeps its last snapshot as `data` beside the failure, the
- * way a one-shot read that fails a refetch keeps its data: `status: 'error'` and `isRefetchError`
- * say the rows are not current, and a consumer can keep what it showed instead of tearing it down.
- * A restart from that failure keeps both — the held data and the failure — until the re-opened
- * listener answers. A listener that failed before it ever answered has no data to hold.
- *
- * A `permission-denied` failure holds nothing: the reader lost access, and a snapshot it may no
- * longer read is never presented as readable. It reads like a failure before any answer, and so
- * does its restart.
- */
 export function useSubscribedResult(query, subscribe, enabled, status) {
     const { error, sourceState, pendingRestart, restart } = status;
     const waiters = useRef([]);
@@ -87,8 +59,6 @@ export function useSubscribedResult(query, subscribe, enabled, status) {
     const mounted = useRef(true);
     const active = subscribe && enabled;
     const refetch = useCallback((options) => {
-        // An unmounted hook, or a refetch captured under an identity the hook has left, re-opens
-        // nothing: it settles at once rather than waiting on a listener that will never report.
         if (!active || !mounted.current)
             return Promise.resolve(latest.current);
         return new Promise((resolve, reject) => {
@@ -167,9 +137,7 @@ export function useSubscribedResult(query, subscribe, enabled, status) {
         };
     }
     else if (active && query.isPending) {
-        // The listener has not delivered its first snapshot. The query underneath is disabled in
-        // subscribe mode, so it reports pending but not loading; the read IS loading, exactly like a
-        // one-shot read's first fetch — never an answered absence.
+        // The query underneath is disabled in subscribe mode, so it reports pending but not loading.
         result = {
             ...query,
             isLoading: true,
@@ -195,7 +163,6 @@ export function useSubscribedResult(query, subscribe, enabled, status) {
                 waiter.resolve(result);
         }
     });
-    // A refetch still open when the hook unmounts resolves with the last result instead of hanging.
     useEffect(() => {
         mounted.current = true;
         return () => {

package/dist/react/firestore/subscription-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscription-status.js","sourceRoot":"","sources":["../../../src/react/firestore/subscription-status.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport type { QueryObserverResult, RefetchOptions, UseQueryResult } from '@tanstack/react-query';\nimport type { FirestoreSourceState, WithSourceState } from '../../firestore/types.js';\nimport { isPermissionDeniedError } from './resubscribe.js';\n\n/** A restart a subscribed result's `refetch()` asked for, open until the listener's first snapshot or its next error. */\ninterface PendingRestart {\n  /** The listener had failed when the restart was asked for. */\n  fromError: boolean;\n  /** That failure, kept beside the held data while the restart is open, as a one-shot refetch keeps it. */\n  failure: Error | null;\n}\n\ninterface SubscriptionStatus {\n  identity: string;\n  error: Error | null;\n  sourceState: FirestoreSourceState;\n  restart: PendingRestart | null;\n  /** Bumped by every restart; the listener effect depends on it, so a bump re-opens the listener. */\n  restarts: number;\n}\n\ntype StatusPatch = Partial<Omit<SubscriptionStatus, 'identity' | 'restarts'>>;\n\nfunction freshStatus(identity: string): SubscriptionStatus {\n  return { identity, error: null, sourceState: 'connecting', restart: null, restarts: 0 };\n}\n\n/**\n * A realtime listener's source state and error, tagged to the subscription identity that\n * produced them. A new identity reads `connecting` with no error from its first render;\n * writes made for a retired identity are dropped once the new identity's listener has\n * started (it calls `reset`).\n *\n * `restart()` clears the error and bumps `restarts`; the listener effect re-opens on the bump,\n * and its first snapshot or next surfaced error ends the restart (`settled` in the patch).\n */\nexport function useSubscriptionStatus(identity: string) {\n  const [status, setStatus] = useState<SubscriptionStatus>(() => freshStatus(identity));\n\n  const current: SubscriptionStatus = status.identity === identity ? status : freshStatus(identity);\n\n  const reset = useCallback(() => {\n    setStatus((prev) =>\n      prev.identity === identity\n        ? { ...prev, error: null, sourceState: 'connecting' }\n        : freshStatus(identity),\n    );\n  }, [identity]);\n\n  const update = useCallback(\n    (patch: StatusPatch | ((prev: SubscriptionStatus) => StatusPatch)) => {\n      setStatus((prev) => {\n        if (prev.identity !== identity) return prev;\n        const next = typeof patch === 'function' ? patch(prev) : patch;\n        return { ...prev, ...next };\n      });\n    },\n    [identity],\n  );\n\n  // The identity the hook renders now. A `restart` captured under an earlier identity must not\n  // touch the current one's status, or every write the current listener makes would be dropped.\n  const renderedIdentity = useRef(identity);\n  useEffect(() => {\n    renderedIdentity.current = identity;\n  }, [identity]);\n\n  /** Re-opens the listener; false (and nothing changes) when this identity is no longer rendered. */\n  const restart = useCallback((): boolean => {\n    if (renderedIdentity.current !== identity) return false;\n    setStatus((prev) => {\n      const base = prev.identity === identity ? prev : freshStatus(identity);\n      return {\n        ...base,\n        error: null,\n        sourceState: 'connecting',\n        restart: {\n          fromError: base.error !== null || base.restart?.fromError === true,\n          failure: base.error ?? base.restart?.failure ?? null,\n        },\n        restarts: base.restarts + 1,\n      };\n    });\n    return true;\n  }, [identity]);\n\n  return {\n    error: current.error,\n    sourceState: current.sourceState,\n    pendingRestart: current.restart,\n    restarts: current.restarts,\n    reset,\n    update,\n    restart,\n  };\n}\n\ntype SubscriptionStatusApi = ReturnType<typeof useSubscriptionStatus>;\n\ninterface RefetchWaiter<TData> {\n  resolve: (result: QueryObserverResult<TData, Error>) => void;\n  reject: (error: Error) => void;\n  throwOnError: boolean;\n}\n\n/**\n * The subscribed hooks' result: the query's own result, with the listener's error and source\n * state merged in. In subscribe mode `refetch()` re-opens the listener (clearing its error, with a\n * fresh resubscribe ladder) and resolves once the re-opened listener delivers its first snapshot or\n * surfaces its next error; until then the result reports fetching.\n *\n * A listener that fails after it answered keeps its last snapshot as `data` beside the failure, the\n * way a one-shot read that fails a refetch keeps its data: `status: 'error'` and `isRefetchError`\n * say the rows are not current, and a consumer can keep what it showed instead of tearing it down.\n * A restart from that failure keeps both — the held data and the failure — until the re-opened\n * listener answers. A listener that failed before it ever answered has no data to hold.\n *\n * A `permission-denied` failure holds nothing: the reader lost access, and a snapshot it may no\n * longer read is never presented as readable. It reads like a failure before any answer, and so\n * does its restart.\n */\nexport function useSubscribedResult<TData>(\n  query: UseQueryResult<TData, Error>,\n  subscribe: boolean,\n  enabled: boolean,\n  status: SubscriptionStatusApi,\n): WithSourceState<UseQueryResult<TData, Error>> {\n  const { error, sourceState, pendingRestart, restart } = status;\n  const waiters = useRef<RefetchWaiter<TData>[]>([]);\n  const latest = useRef(query as QueryObserverResult<TData, Error>);\n  const mounted = useRef(true);\n  const active = subscribe && enabled;\n\n  const refetch = useCallback(\n    (options?: RefetchOptions): Promise<QueryObserverResult<TData, Error>> => {\n      // An unmounted hook, or a refetch captured under an identity the hook has left, re-opens\n      // nothing: it settles at once rather than waiting on a listener that will never report.\n      if (!active || !mounted.current) return Promise.resolve(latest.current);\n      return new Promise((resolve, reject) => {\n        if (!restart()) {\n          resolve(latest.current);\n          return;\n        }\n        waiters.current.push({ resolve, reject, throwOnError: options?.throwOnError === true });\n      });\n    },\n    [active, restart],\n  );\n\n  const denied = isPermissionDeniedError(error ?? pendingRestart?.failure);\n  const holdable = query.data !== undefined && !denied;\n\n  let result: UseQueryResult<TData, Error>;\n  if (!subscribe) {\n    result = query;\n  } else if (error) {\n    const held = holdable;\n    result = {\n      ...query,\n      data: held ? query.data : undefined,\n      error,\n      isError: true,\n      isLoadingError: !held,\n      isRefetchError: held,\n      isSuccess: false,\n      isPending: false,\n      isLoading: false,\n      status: 'error',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else if (pendingRestart?.fromError && holdable) {\n    result = {\n      ...query,\n      error: pendingRestart.failure,\n      isError: pendingRestart.failure !== null,\n      isLoadingError: false,\n      isRefetchError: pendingRestart.failure !== null,\n      isSuccess: false,\n      isPending: false,\n      isLoading: false,\n      isFetching: true,\n      isRefetching: true,\n      status: pendingRestart.failure !== null ? 'error' : query.status,\n      fetchStatus: 'fetching',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else if (pendingRestart?.fromError) {\n    result = {\n      ...query,\n      data: undefined,\n      error: null,\n      isError: false,\n      isLoadingError: false,\n      isRefetchError: false,\n      isSuccess: false,\n      isPending: true,\n      isLoading: true,\n      isFetching: true,\n      isRefetching: false,\n      status: 'pending',\n      fetchStatus: 'fetching',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else if (pendingRestart) {\n    result = {\n      ...query,\n      isFetching: true,\n      isLoading: query.isPending,\n      isRefetching: !query.isPending,\n      fetchStatus: 'fetching',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else if (active && query.isPending) {\n    // The listener has not delivered its first snapshot. The query underneath is disabled in\n    // subscribe mode, so it reports pending but not loading; the read IS loading, exactly like a\n    // one-shot read's first fetch — never an answered absence.\n    result = {\n      ...query,\n      isLoading: true,\n      isFetching: true,\n      fetchStatus: 'fetching',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else {\n    result = { ...query, refetch } as UseQueryResult<TData, Error>;\n  }\n\n  const restartOpen = pendingRestart !== null;\n  useEffect(() => {\n    latest.current = result as QueryObserverResult<TData, Error>;\n    if (restartOpen || waiters.current.length === 0) return;\n    const settled = waiters.current;\n    waiters.current = [];\n    for (const waiter of settled) {\n      if (waiter.throwOnError && result.error) waiter.reject(result.error);\n      else waiter.resolve(result as QueryObserverResult<TData, Error>);\n    }\n  });\n\n  // A refetch still open when the hook unmounts resolves with the last result instead of hanging.\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n      const settled = waiters.current;\n      waiters.current = [];\n      for (const waiter of settled) waiter.resolve(latest.current);\n    };\n  }, []);\n\n  return { ...result, sourceState } as WithSourceState<UseQueryResult<TData, Error>>;\n}\n"]}
+{"version":3,"file":"subscription-status.js","sourceRoot":"","sources":["../../../src/react/firestore/subscription-status.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport type { QueryObserverResult, RefetchOptions, UseQueryResult } from '@tanstack/react-query';\nimport type { FirestoreSourceState, WithSourceState } from '../../firestore/types.js';\nimport { isPermissionDeniedError } from './resubscribe.js';\n\ninterface PendingRestart {\n  fromError: boolean;\n  failure: Error | null;\n}\n\ninterface SubscriptionStatus {\n  identity: string;\n  error: Error | null;\n  sourceState: FirestoreSourceState;\n  restart: PendingRestart | null;\n  restarts: number;\n}\n\ntype StatusPatch = Partial<Omit<SubscriptionStatus, 'identity' | 'restarts'>>;\n\nfunction freshStatus(identity: string): SubscriptionStatus {\n  return { identity, error: null, sourceState: 'connecting', restart: null, restarts: 0 };\n}\n\nexport function useSubscriptionStatus(identity: string) {\n  const [status, setStatus] = useState<SubscriptionStatus>(() => freshStatus(identity));\n\n  const current: SubscriptionStatus = status.identity === identity ? status : freshStatus(identity);\n\n  const reset = useCallback(() => {\n    setStatus((prev) =>\n      prev.identity === identity\n        ? { ...prev, error: null, sourceState: 'connecting' }\n        : freshStatus(identity),\n    );\n  }, [identity]);\n\n  const update = useCallback(\n    (patch: StatusPatch | ((prev: SubscriptionStatus) => StatusPatch)) => {\n      setStatus((prev) => {\n        if (prev.identity !== identity) return prev;\n        const next = typeof patch === 'function' ? patch(prev) : patch;\n        return { ...prev, ...next };\n      });\n    },\n    [identity],\n  );\n\n  const renderedIdentity = useRef(identity);\n  useEffect(() => {\n    renderedIdentity.current = identity;\n  }, [identity]);\n\n  const restart = useCallback((): boolean => {\n    if (renderedIdentity.current !== identity) return false;\n    setStatus((prev) => {\n      const base = prev.identity === identity ? prev : freshStatus(identity);\n      return {\n        ...base,\n        error: null,\n        sourceState: 'connecting',\n        restart: {\n          fromError: base.error !== null || base.restart?.fromError === true,\n          failure: base.error ?? base.restart?.failure ?? null,\n        },\n        restarts: base.restarts + 1,\n      };\n    });\n    return true;\n  }, [identity]);\n\n  return {\n    error: current.error,\n    sourceState: current.sourceState,\n    pendingRestart: current.restart,\n    restarts: current.restarts,\n    reset,\n    update,\n    restart,\n  };\n}\n\ntype SubscriptionStatusApi = ReturnType<typeof useSubscriptionStatus>;\n\ninterface RefetchWaiter<TData> {\n  resolve: (result: QueryObserverResult<TData, Error>) => void;\n  reject: (error: Error) => void;\n  throwOnError: boolean;\n}\n\nexport function useSubscribedResult<TData>(\n  query: UseQueryResult<TData, Error>,\n  subscribe: boolean,\n  enabled: boolean,\n  status: SubscriptionStatusApi,\n): WithSourceState<UseQueryResult<TData, Error>> {\n  const { error, sourceState, pendingRestart, restart } = status;\n  const waiters = useRef<RefetchWaiter<TData>[]>([]);\n  const latest = useRef(query as QueryObserverResult<TData, Error>);\n  const mounted = useRef(true);\n  const active = subscribe && enabled;\n\n  const refetch = useCallback(\n    (options?: RefetchOptions): Promise<QueryObserverResult<TData, Error>> => {\n      if (!active || !mounted.current) return Promise.resolve(latest.current);\n      return new Promise((resolve, reject) => {\n        if (!restart()) {\n          resolve(latest.current);\n          return;\n        }\n        waiters.current.push({ resolve, reject, throwOnError: options?.throwOnError === true });\n      });\n    },\n    [active, restart],\n  );\n\n  const denied = isPermissionDeniedError(error ?? pendingRestart?.failure);\n  const holdable = query.data !== undefined && !denied;\n\n  let result: UseQueryResult<TData, Error>;\n  if (!subscribe) {\n    result = query;\n  } else if (error) {\n    const held = holdable;\n    result = {\n      ...query,\n      data: held ? query.data : undefined,\n      error,\n      isError: true,\n      isLoadingError: !held,\n      isRefetchError: held,\n      isSuccess: false,\n      isPending: false,\n      isLoading: false,\n      status: 'error',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else if (pendingRestart?.fromError && holdable) {\n    result = {\n      ...query,\n      error: pendingRestart.failure,\n      isError: pendingRestart.failure !== null,\n      isLoadingError: false,\n      isRefetchError: pendingRestart.failure !== null,\n      isSuccess: false,\n      isPending: false,\n      isLoading: false,\n      isFetching: true,\n      isRefetching: true,\n      status: pendingRestart.failure !== null ? 'error' : query.status,\n      fetchStatus: 'fetching',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else if (pendingRestart?.fromError) {\n    result = {\n      ...query,\n      data: undefined,\n      error: null,\n      isError: false,\n      isLoadingError: false,\n      isRefetchError: false,\n      isSuccess: false,\n      isPending: true,\n      isLoading: true,\n      isFetching: true,\n      isRefetching: false,\n      status: 'pending',\n      fetchStatus: 'fetching',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else if (pendingRestart) {\n    result = {\n      ...query,\n      isFetching: true,\n      isLoading: query.isPending,\n      isRefetching: !query.isPending,\n      fetchStatus: 'fetching',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else if (active && query.isPending) {\n    // The query underneath is disabled in subscribe mode, so it reports pending but not loading.\n    result = {\n      ...query,\n      isLoading: true,\n      isFetching: true,\n      fetchStatus: 'fetching',\n      refetch,\n    } as UseQueryResult<TData, Error>;\n  } else {\n    result = { ...query, refetch } as UseQueryResult<TData, Error>;\n  }\n\n  const restartOpen = pendingRestart !== null;\n  useEffect(() => {\n    latest.current = result as QueryObserverResult<TData, Error>;\n    if (restartOpen || waiters.current.length === 0) return;\n    const settled = waiters.current;\n    waiters.current = [];\n    for (const waiter of settled) {\n      if (waiter.throwOnError && result.error) waiter.reject(result.error);\n      else waiter.resolve(result as QueryObserverResult<TData, Error>);\n    }\n  });\n\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n      const settled = waiters.current;\n      waiters.current = [];\n      for (const waiter of settled) waiter.resolve(latest.current);\n    };\n  }, []);\n\n  return { ...result, sourceState } as WithSourceState<UseQueryResult<TData, Error>>;\n}\n"]}