@ttt-productions/query-core 0.14.22 → 0.14.24

package/README.md

@@ -1,10 +1,10 @@
 # @ttt-productions/query-core
 
-Shared TanStack Query (React Query) setup for TTT Productions apps.
+Shared TanStack Query (React Query) setup and Firestore read hooks for consuming apps.
 
-- `createTTTQueryClient()` factory with safe defaults
-- `keys` query key helpers
-- invalidation + cache update helpers
-- `TTTQueryProvider` for Next.js/React apps
+- `createQueryClient()` factory with safe defaults and `QueryProvider` (`./react`)
+- `STALE_TIMES` presets and the search rule (root)
+- `keys` query key helpers (`./keys`)
+- the Firestore hooks, invalidation, and cache update helpers (`./react`)
 
-No app business logic. No Firebase.
+No app business logic. See `docs/packages/query-core.md`.

package/dist/defaults.d.ts

@@ -1,18 +1,3 @@
-/**
- * Named `staleTime` presets (milliseconds) for React Query call sites.
- *
- * Use a preset instead of a magic number so every query self-documents how
- * fresh its data must be:
- * - `short`   (30s) — frequently-changing counts/lists; matches the client default.
- * - `medium`  (5m)  — semi-dynamic data that tolerates a few minutes of staleness.
- * - `long`    (30m) — rarely-changing data (public profiles, detail docs).
- * - `forever` (∞)   — immutable for the session, OR data whose freshness is driven
- *                     entirely by explicit cache invalidation (a domain event), never
- *                     by elapsed time. Do NOT use `forever` for data with no
- *                     invalidation path — it will never refetch.
- *
- * Generic time buckets, not app-specific presets — safe to live in this package.
- */
 export declare const STALE_TIMES: {
     readonly short: 30000;
     readonly medium: number;

package/dist/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;CAKd,CAAC"}

package/dist/defaults.js

@@ -1,18 +1,3 @@
-/**
- * Named `staleTime` presets (milliseconds) for React Query call sites.
- *
- * Use a preset instead of a magic number so every query self-documents how
- * fresh its data must be:
- * - `short`   (30s) — frequently-changing counts/lists; matches the client default.
- * - `medium`  (5m)  — semi-dynamic data that tolerates a few minutes of staleness.
- * - `long`    (30m) — rarely-changing data (public profiles, detail docs).
- * - `forever` (∞)   — immutable for the session, OR data whose freshness is driven
- *                     entirely by explicit cache invalidation (a domain event), never
- *                     by elapsed time. Do NOT use `forever` for data with no
- *                     invalidation path — it will never refetch.
- *
- * Generic time buckets, not app-specific presets — safe to live in this package.
- */
 export const STALE_TIMES = {
     short: 30_000,
     medium: 5 * 60_000,

package/dist/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,CAAC,GAAG,MAAM;IAClB,IAAI,EAAE,EAAE,GAAG,MAAM;IACjB,OAAO,EAAE,MAAM,CAAC,iBAAiB;CACzB,CAAC","sourcesContent":["/**\n * Named `staleTime` presets (milliseconds) for React Query call sites.\n *\n * Use a preset instead of a magic number so every query self-documents how\n * fresh its data must be:\n * - `short`   (30s) — frequently-changing counts/lists; matches the client default.\n * - `medium`  (5m)  — semi-dynamic data that tolerates a few minutes of staleness.\n * - `long`    (30m) — rarely-changing data (public profiles, detail docs).\n * - `forever` (∞)   — immutable for the session, OR data whose freshness is driven\n *                     entirely by explicit cache invalidation (a domain event), never\n *                     by elapsed time. Do NOT use `forever` for data with no\n *                     invalidation path — it will never refetch.\n *\n * Generic time buckets, not app-specific presets — safe to live in this package.\n */\nexport const STALE_TIMES = {\n  short: 30_000,\n  medium: 5 * 60_000,\n  long: 30 * 60_000,\n  forever: Number.POSITIVE_INFINITY,\n} as const;\n"]}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,CAAC,GAAG,MAAM;IAClB,IAAI,EAAE,EAAE,GAAG,MAAM;IACjB,OAAO,EAAE,MAAM,CAAC,iBAAiB;CACzB,CAAC","sourcesContent":["export const STALE_TIMES = {\n  short: 30_000,\n  medium: 5 * 60_000,\n  long: 30 * 60_000,\n  forever: Number.POSITIVE_INFINITY,\n} as const;\n"]}

package/dist/firestore/types.d.ts

@@ -1,44 +1,20 @@
-/**
- * Document with ID included in the data object.
- */
 export type WithId<T> = T & {
     id: string;
 };
-/**
- * Metadata-derived liveness of a realtime subscription. Firestore serves cached
- * snapshots offline WITHOUT firing the error callback, so error-only detection
- * renders a stale cached empty result as "live". This four-state is derived from
- * `snapshot.metadata.fromCache` (server-confirmed vs cache) plus the listener
- * error callback:
- * - `connecting` — no server-confirmed snapshot yet (initial, or only cache-first data).
- * - `live` — at least one server-confirmed snapshot (`fromCache === false`).
- * - `offline` — only cached data after having been live (connectivity loss).
- * - `error` — the listener error callback fired (e.g. permission loss).
- *
- * Meaningful only for `subscribe: true`; a non-subscribed hook stays `connecting`.
- */
+/** Firestore serves cached snapshots offline without firing the error callback, so liveness is read from `metadata.fromCache`. */
 export type FirestoreSourceState = 'connecting' | 'live' | 'offline' | 'error';
-/** A query-hook result augmented with the metadata-derived subscription source state. */
 export type WithSourceState<R> = R & {
     sourceState: FirestoreSourceState;
 };
-/**
- * One requested id's answer from `useBatchFirestoreDocs`:
- * - `loading` — no answer yet (nothing cached for the id, or the hook is disabled).
- * - `present` — the document exists and is readable; `data` is it.
- * - `absent` — the read succeeded and the document does not exist.
- * - `failed` — the read (or, in subscribe mode, the listener) errored; `error` is the cause.
- *   A failure is never reported as `absent`, and a document cached before the failure is
- *   not reported as `present`. What a failure means for a given collection (a rules denial
- *   that stands for "not there for this reader", say) is the consumer's to decide from `error`.
- * - A failed id stays `failed` through a retry of it, with the failure it showed and `retrying`
- *   true while the retry runs; an answer replaces it, a new failure replaces its `error`.
- */
 export type BatchFirestoreDocOutcome<T> = {
     status: 'loading';
 } | {
     status: 'present';
     data: T;
+    failure?: {
+        error: Error;
+        retrying: boolean;
+    };
 } | {
     status: 'absent';
 } | {
@@ -46,42 +22,22 @@ export type BatchFirestoreDocOutcome<T> = {
     error: Error;
     retrying: boolean;
 };
-/**
- * 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 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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/firestore/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/E,yFAAyF;AACzF,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,WAAW,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAE3E;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAClC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC;IACtC,gCAAgC;IAChC,UAAU,CAAC,EAAE;QACX,uCAAuC;QACvC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;QAC7B,oCAAoC;QACpC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;KAC7D,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC;IACtC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/firestore/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,kIAAkI;AAClI,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/E,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,WAAW,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAClC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC7E;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC;IACtC,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;KAC7D,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/firestore/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/firestore/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Document with ID included in the data object.\n */\nexport type WithId<T> = T & { id: string };\n\n/**\n * Metadata-derived liveness of a realtime subscription. Firestore serves cached\n * snapshots offline WITHOUT firing the error callback, so error-only detection\n * renders a stale cached empty result as \"live\". This four-state is derived from\n * `snapshot.metadata.fromCache` (server-confirmed vs cache) plus the listener\n * error callback:\n * - `connecting` — no server-confirmed snapshot yet (initial, or only cache-first data).\n * - `live` — at least one server-confirmed snapshot (`fromCache === false`).\n * - `offline` — only cached data after having been live (connectivity loss).\n * - `error` — the listener error callback fired (e.g. permission loss).\n *\n * Meaningful only for `subscribe: true`; a non-subscribed hook stays `connecting`.\n */\nexport type FirestoreSourceState = 'connecting' | 'live' | 'offline' | 'error';\n\n/** A query-hook result augmented with the metadata-derived subscription source state. */\nexport type WithSourceState<R> = R & { sourceState: FirestoreSourceState };\n\n/**\n * One requested id's answer from `useBatchFirestoreDocs`:\n * - `loading` — no answer yet (nothing cached for the id, or the hook is disabled).\n * - `present` — the document exists and is readable; `data` is it.\n * - `absent` — the read succeeded and the document does not exist.\n * - `failed` — the read (or, in subscribe mode, the listener) errored; `error` is the cause.\n *   A failure is never reported as `absent`, and a document cached before the failure is\n *   not reported as `present`. What a failure means for a given collection (a rules denial\n *   that stands for \"not there for this reader\", say) is the consumer's to decide from `error`.\n * - A failed id stays `failed` through a retry of it, with the failure it showed and `retrying`\n *   true while the retry runs; an answer replaces it, a new failure replaces its `error`.\n */\nexport type BatchFirestoreDocOutcome<T> =\n  | { status: 'loading' }\n  | { status: 'present'; data: T }\n  | { status: 'absent' }\n  | { status: 'failed'; error: Error; retrying: boolean };\n\n/**\n * Base options shared across all Firestore hooks.\n */\nexport interface FirestoreBaseOptions {\n  /** React Query cache key */\n  queryKey: readonly unknown[];\n  /** Enable/disable the query */\n  enabled?: boolean;\n  /** Stale time override (ms) */\n  staleTime?: number;\n  /** Garbage collection time override (ms) */\n  gcTime?: number;\n}\n\n/**\n * Options for document mutations.\n */\nexport interface FirestoreMutationOptions<T> {\n  /** Document path for single-doc mutations */\n  docPath?: string;\n  /** Query keys to invalidate on success */\n  invalidateKeys?: readonly unknown[][];\n  /** Enable optimistic updates */\n  optimistic?: {\n    /** Query key of the cache to update */\n    queryKey: readonly unknown[];\n    /** How to update the cached data */\n    updater: (oldData: T | undefined, newData: Partial<T>) => T;\n  };\n}\n\n/**\n * Options for batch mutations.\n */\nexport interface FirestoreBatchOptions {\n  /** Query keys to invalidate on success */\n  invalidateKeys?: readonly unknown[][];\n  /** Max operations per batch (default: 450) */\n  batchSize?: number;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/firestore/types.ts"],"names":[],"mappings":"","sourcesContent":["export type WithId<T> = T & { id: string };\n\n/** Firestore serves cached snapshots offline without firing the error callback, so liveness is read from `metadata.fromCache`. */\nexport type FirestoreSourceState = 'connecting' | 'live' | 'offline' | 'error';\n\nexport type WithSourceState<R> = R & { sourceState: FirestoreSourceState };\n\nexport type BatchFirestoreDocOutcome<T> =\n  | { status: 'loading' }\n  | { status: 'present'; data: T; failure?: { error: Error; retrying: boolean } }\n  | { status: 'absent' }\n  | { status: 'failed'; error: Error; retrying: boolean };\n\nexport interface FirestoreBaseOptions {\n  queryKey: readonly unknown[];\n  enabled?: boolean;\n  staleTime?: number;\n  gcTime?: number;\n}\n\nexport interface FirestoreMutationOptions<T> {\n  docPath?: string;\n  invalidateKeys?: readonly unknown[][];\n  optimistic?: {\n    queryKey: readonly unknown[];\n    updater: (oldData: T | undefined, newData: Partial<T>) => T;\n  };\n}\n\nexport interface FirestoreBatchOptions {\n  invalidateKeys?: readonly unknown[][];\n  batchSize?: number;\n}\n"]}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,4 +1,3 @@
-// Query defaults & staleTime presets (server-safe — plain constants, no React runtime)
 export { STALE_TIMES } from './defaults.js';
 export { FIRESTORE_SEARCH_MIN_LENGTH, isSearchableText, normalizeSearchText, } from './search/rule.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC","sourcesContent":["// Query defaults & staleTime presets (server-safe — plain constants, no React runtime)\nexport { STALE_TIMES } from './defaults.js';\n\n// Search Types\nexport type { FirestoreSearchConfig, SearchEqualityFilter } from './search/types.js';\nexport {\n  FIRESTORE_SEARCH_MIN_LENGTH,\n  isSearchableText,\n  normalizeSearchText,\n} from './search/rule.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC","sourcesContent":["export { STALE_TIMES } from './defaults.js';\n\nexport type { FirestoreSearchConfig, SearchEqualityFilter } from './search/types.js';\nexport {\n  FIRESTORE_SEARCH_MIN_LENGTH,\n  isSearchableText,\n  normalizeSearchText,\n} from './search/rule.js';\n"]}

package/dist/keys.d.ts

@@ -1,21 +1,3 @@
-/**
- * Lightweight, stable, Firestore-safe query key helpers.
- *
- * All keys are arrays of `string | number | boolean | null` so they can
- * be written into Firestore docs (used by the unified upload pipeline's
- * `result.invalidate` field) and read back by the frontend hook to call
- * `queryClient.invalidateQueries`. Both sides produce structurally
- * identical arrays.
- *
- * Convention:
- * - `keys.user.all` => ['user']
- * - `keys.user.detail(id)` => ['user', 'detail', id]
- * - `keys.user.list(param?)` => ['user', 'list', param?]
- * - `keys.user.custom('accountStatus', id)` => ['user', 'accountStatus', id]
- *
- * For list filters that need multiple discriminators, use `custom`:
- *   keys.feedback.custom('list', filter, sortBy)
- */
 type SerializedKeyPart = string | number | boolean | null | undefined;
 export type QueryKey = ReadonlyArray<string | number | boolean | null>;
 export declare const keys: {
@@ -81,10 +63,6 @@ export declare const keys: {
     };
     readonly custom: (...parts: SerializedKeyPart[]) => QueryKey;
 };
-/**
- * Utility for apps that want to define their own scoped key sets
- * while following the same conventions.
- */
 export declare function createKeyScope(scope: string): {
     readonly all: QueryKey;
     readonly detail: (id: string) => QueryKey;

package/dist/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtE,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;AAOvE,eAAO,MAAM,IAAI;;;8BAGA,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;gCAErB,iBAAiB,EAAE;CAC9B,CAAC;AAEX;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM;;0BAG3B,MAAM;4BACJ,iBAAiB;gCACb,iBAAiB,EAAE;EAEzC"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtE,MAAM,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;AAOvE,eAAO,MAAM,IAAI;;;8BAGA,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;;;8BAIzB,MAAM;gCACJ,iBAAiB;oCACb,iBAAiB,EAAE;;gCAErB,iBAAiB,EAAE;CAC9B,CAAC;AAEX,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM;;0BAG3B,MAAM;4BACJ,iBAAiB;gCACb,iBAAiB,EAAE;EAEzC"}

package/dist/keys.js

@@ -65,10 +65,6 @@ export const keys = {
     },
     custom: (...parts) => withScope('custom', ...parts),
 };
-/**
- * Utility for apps that want to define their own scoped key sets
- * while following the same conventions.
- */
 export function createKeyScope(scope) {
     return {
         all: withScope(scope),

package/dist/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Lightweight, stable, Firestore-safe query key helpers.\n *\n * All keys are arrays of `string | number | boolean | null` so they can\n * be written into Firestore docs (used by the unified upload pipeline's\n * `result.invalidate` field) and read back by the frontend hook to call\n * `queryClient.invalidateQueries`. Both sides produce structurally\n * identical arrays.\n *\n * Convention:\n * - `keys.user.all` => ['user']\n * - `keys.user.detail(id)` => ['user', 'detail', id]\n * - `keys.user.list(param?)` => ['user', 'list', param?]\n * - `keys.user.custom('accountStatus', id)` => ['user', 'accountStatus', id]\n *\n * For list filters that need multiple discriminators, use `custom`:\n *   keys.feedback.custom('list', filter, sortBy)\n */\ntype SerializedKeyPart = string | number | boolean | null | undefined;\n\nexport type QueryKey = ReadonlyArray<string | number | boolean | null>;\n\nfunction withScope(scope: string, ...parts: SerializedKeyPart[]): QueryKey {\n  const cleaned = parts.filter((p): p is Exclude<SerializedKeyPart, undefined> => p !== undefined);\n  return [scope, ...cleaned] as const;\n}\n\nexport const keys = {\n  user: {\n    all: withScope('user'),\n    detail: (id: string) => withScope('user', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('user', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('user', ...parts),\n  },\n  follows: {\n    all: withScope('follows'),\n    detail: (id: string) => withScope('follows', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('follows', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('follows', ...parts),\n  },\n  entities: {\n    all: withScope('entities'),\n    detail: (id: string) => withScope('entities', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('entities', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('entities', ...parts),\n  },\n  messages: {\n    all: withScope('messages'),\n    detail: (id: string) => withScope('messages', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('messages', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('messages', ...parts),\n  },\n  admin: {\n    all: withScope('admin'),\n    detail: (id: string) => withScope('admin', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('admin', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('admin', ...parts),\n  },\n  chat: {\n    all: withScope('chat'),\n    detail: (id: string) => withScope('chat', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('chat', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('chat', ...parts),\n  },\n  notifications: {\n    all: withScope('notifications'),\n    detail: (id: string) => withScope('notifications', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('notifications', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('notifications', ...parts),\n  },\n  shortLinks: {\n    all: withScope('shortLinks'),\n    detail: (id: string) => withScope('shortLinks', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('shortLinks', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('shortLinks', ...parts),\n  },\n  mentions: {\n    all: withScope('mentions'),\n    detail: (id: string) => withScope('mentions', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('mentions', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('mentions', ...parts),\n  },\n  feedback: {\n    all: withScope('feedback'),\n    detail: (id: string) => withScope('feedback', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('feedback', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('feedback', ...parts),\n  },\n  custom: (...parts: SerializedKeyPart[]) => withScope('custom', ...parts),\n} as const;\n\n/**\n * Utility for apps that want to define their own scoped key sets\n * while following the same conventions.\n */\nexport function createKeyScope(scope: string) {\n  return {\n    all: withScope(scope),\n    detail: (id: string) => withScope(scope, 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope(scope, 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope(scope, ...parts),\n  } as const;\n}\n"]}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"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","sourcesContent":["type SerializedKeyPart = string | number | boolean | null | undefined;\n\nexport type QueryKey = ReadonlyArray<string | number | boolean | null>;\n\nfunction withScope(scope: string, ...parts: SerializedKeyPart[]): QueryKey {\n  const cleaned = parts.filter((p): p is Exclude<SerializedKeyPart, undefined> => p !== undefined);\n  return [scope, ...cleaned] as const;\n}\n\nexport const keys = {\n  user: {\n    all: withScope('user'),\n    detail: (id: string) => withScope('user', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('user', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('user', ...parts),\n  },\n  follows: {\n    all: withScope('follows'),\n    detail: (id: string) => withScope('follows', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('follows', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('follows', ...parts),\n  },\n  entities: {\n    all: withScope('entities'),\n    detail: (id: string) => withScope('entities', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('entities', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('entities', ...parts),\n  },\n  messages: {\n    all: withScope('messages'),\n    detail: (id: string) => withScope('messages', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('messages', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('messages', ...parts),\n  },\n  admin: {\n    all: withScope('admin'),\n    detail: (id: string) => withScope('admin', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('admin', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('admin', ...parts),\n  },\n  chat: {\n    all: withScope('chat'),\n    detail: (id: string) => withScope('chat', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('chat', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('chat', ...parts),\n  },\n  notifications: {\n    all: withScope('notifications'),\n    detail: (id: string) => withScope('notifications', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('notifications', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('notifications', ...parts),\n  },\n  shortLinks: {\n    all: withScope('shortLinks'),\n    detail: (id: string) => withScope('shortLinks', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('shortLinks', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('shortLinks', ...parts),\n  },\n  mentions: {\n    all: withScope('mentions'),\n    detail: (id: string) => withScope('mentions', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('mentions', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('mentions', ...parts),\n  },\n  feedback: {\n    all: withScope('feedback'),\n    detail: (id: string) => withScope('feedback', 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope('feedback', 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope('feedback', ...parts),\n  },\n  custom: (...parts: SerializedKeyPart[]) => withScope('custom', ...parts),\n} as const;\n\nexport function createKeyScope(scope: string) {\n  return {\n    all: withScope(scope),\n    detail: (id: string) => withScope(scope, 'detail', id),\n    list: (param?: SerializedKeyPart) => withScope(scope, 'list', param),\n    custom: (...parts: SerializedKeyPart[]) => withScope(scope, ...parts),\n  } as const;\n}\n"]}

package/dist/react/cache-helpers.d.ts

@@ -1,48 +1,16 @@
 import type { InfiniteData, QueryClient, QueryKey } from '@tanstack/react-query';
-/** Invalidate everything that matches a key prefix. */
 export declare function invalidateByPrefix(client: QueryClient, prefix: QueryKey): Promise<void>;
-/** Remove everything that matches a key prefix (drops cached data). */
 export declare function removeByPrefix(client: QueryClient, prefix: QueryKey): void;
-/**
- * Generic cache update helper.
- * Useful for optimistic updates without baking in business logic.
- */
 export declare function updateQueryData<T>(client: QueryClient, key: QueryKey, updater: (prev: T | undefined) => T): void;
-/** The cache key of page `page` of a `useFirestorePaginated` list keyed `queryKey`. */
 export declare function paginatedPageKey(queryKey: QueryKey, page: number): QueryKey;
-/**
- * Patch rows in place across every cached page of a `useFirestorePaginated` list
- * (`queryKey` is the base key the hook was given). Return the same row to leave it
- * unchanged; a page with no changed row keeps its identity. Cursors and has-more are
- * untouched, so paging stays aligned with the server.
- */
 export declare function mapPaginatedItems<T>(client: QueryClient, queryKey: QueryKey, mapItem: (item: T) => T): void;
-/**
- * Put a just-created row at the top of page 1 of a `useFirestorePaginated` list, only
- * when page 1 is cached. Use it only for a list ordered newest-first. Page 1 keeps its
- * cursor, so it shows one extra row and page 2 keeps its place until page 1 is next read;
- * that read moves page 1's cursor, and the hook then re-reads page 2 from the new cursor
- * before showing it.
- */
 export declare function prependToFirstPaginatedPage<T>(client: QueryClient, queryKey: QueryKey, item: T): void;
-/** How `placeRowInPages` reads and writes one infinite list's pages. */
 export interface PagedRows<P, T> {
     rowsOf: (page: P) => readonly T[];
     withRows: (page: P, rows: T[]) => P;
-    /** True when `candidate` is the row being placed (its id). */
     isRow: (candidate: T) => boolean;
-    /** True when `a` comes before `b` in the list's own order. */
     sortsBefore: (a: T, b: T) => boolean;
-    /** True when this page is not the last one the source holds (a next page exists). */
     hasMoreAfter: (page: P) => boolean;
 }
-/**
- * Place, move, or drop ONE row in a cached infinite list's loaded pages, in place: the row leaves
- * wherever it sits and, when `belongs`, joins at its position in the list's own order. A row that
- * sorts after every loaded row is added only when no further page exists; otherwise the next page
- * read returns it, so placing it here would list it twice. Every other row, every page, and every
- * cursor stays put; a list the row neither left nor joined is returned as it was. Never a reset to the
- * first page.
- */
 export declare function placeRowInPages<P, T, TParam = unknown>(data: InfiniteData<P, TParam> | undefined, row: T, belongs: boolean, how: PagedRows<P, T>): InfiniteData<P, TParam> | undefined;
 //# sourceMappingURL=cache-helpers.d.ts.map

package/dist/react/cache-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-helpers.d.ts","sourceRoot":"","sources":["../../src/react/cache-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjF,uDAAuD;AACvD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,iBAE7E;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,QAEnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,QAGpC;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE3E;AAeD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GACtB,IAAI,CAWN;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,CAAC,GACN,IAAI,CAKN;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;IAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACpC,8DAA8D;IAC9D,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,OAAO,CAAC;IACjC,8DAA8D;IAC9D,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IACrC,qFAAqF;IACrF,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,EACpD,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,SAAS,EACzC,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,SAAS,CA2BrC"}
+{"version":3,"file":"cache-helpers.d.ts","sourceRoot":"","sources":["../../src/react/cache-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjF,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,iBAE7E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,QAEnE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,QAGpC;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE3E;AAeD,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GACtB,IAAI,CAWN;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,CAAC,GACN,IAAI,CAKN;AAED,MAAM,WAAW,SAAS,CAAC,CAAC,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;IAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACpC,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,OAAO,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IACrC,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;CACpC;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,EACpD,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,SAAS,EACzC,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,SAAS,CA2BrC"}

package/dist/react/cache-helpers.js

@@ -1,19 +1,12 @@
-/** Invalidate everything that matches a key prefix. */
 export async function invalidateByPrefix(client, prefix) {
     return client.invalidateQueries({ queryKey: prefix, exact: false });
 }
-/** Remove everything that matches a key prefix (drops cached data). */
 export function removeByPrefix(client, prefix) {
     return client.removeQueries({ queryKey: prefix, exact: false });
 }
-/**
- * Generic cache update helper.
- * Useful for optimistic updates without baking in business logic.
- */
 export function updateQueryData(client, key, updater) {
     client.setQueryData(key, (prev) => updater(prev));
 }
-/** The cache key of page `page` of a `useFirestorePaginated` list keyed `queryKey`. */
 export function paginatedPageKey(queryKey, page) {
     return [...queryKey, 'page', page];
 }
@@ -26,12 +19,6 @@ function isPaginatedPage(value) {
 function isPageKey(baseKey, key) {
     return key.length === baseKey.length + 2 && key[baseKey.length] === 'page';
 }
-/**
- * Patch rows in place across every cached page of a `useFirestorePaginated` list
- * (`queryKey` is the base key the hook was given). Return the same row to leave it
- * unchanged; a page with no changed row keeps its identity. Cursors and has-more are
- * untouched, so paging stays aligned with the server.
- */
 export function mapPaginatedItems(client, queryKey, mapItem) {
     for (const [key, value] of client.getQueriesData({ queryKey })) {
         if (!isPageKey(queryKey, key) || !isPaginatedPage(value))
@@ -47,13 +34,6 @@ export function mapPaginatedItems(client, queryKey, mapItem) {
             client.setQueryData(key, { ...value, items });
     }
 }
-/**
- * Put a just-created row at the top of page 1 of a `useFirestorePaginated` list, only
- * when page 1 is cached. Use it only for a list ordered newest-first. Page 1 keeps its
- * cursor, so it shows one extra row and page 2 keeps its place until page 1 is next read;
- * that read moves page 1's cursor, and the hook then re-reads page 2 from the new cursor
- * before showing it.
- */
 export function prependToFirstPaginatedPage(client, queryKey, item) {
     const key = paginatedPageKey(queryKey, 1);
     const value = client.getQueryData(key);
@@ -61,14 +41,6 @@ export function prependToFirstPaginatedPage(client, queryKey, item) {
         return;
     client.setQueryData(key, { ...value, items: [item, ...value.items] });
 }
-/**
- * Place, move, or drop ONE row in a cached infinite list's loaded pages, in place: the row leaves
- * wherever it sits and, when `belongs`, joins at its position in the list's own order. A row that
- * sorts after every loaded row is added only when no further page exists; otherwise the next page
- * read returns it, so placing it here would list it twice. Every other row, every page, and every
- * cursor stays put; a list the row neither left nor joined is returned as it was. Never a reset to the
- * first page.
- */
 export function placeRowInPages(data, row, belongs, how) {
     if (!data || data.pages.length === 0)
         return data;

package/dist/react/cache-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-helpers.js","sourceRoot":"","sources":["../../src/react/cache-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InfiniteData, QueryClient, QueryKey } from '@tanstack/react-query';\nimport type { PaginatedPage } from './firestore/types.js';\n\n/** Invalidate everything that matches a key prefix. */\nexport async function invalidateByPrefix(client: QueryClient, prefix: QueryKey) {\n  return client.invalidateQueries({ queryKey: prefix, exact: false });\n}\n\n/** Remove everything that matches a key prefix (drops cached data). */\nexport function removeByPrefix(client: QueryClient, prefix: QueryKey) {\n  return client.removeQueries({ queryKey: prefix, exact: false });\n}\n\n/**\n * Generic cache update helper.\n * Useful for optimistic updates without baking in business logic.\n */\nexport function updateQueryData<T>(\n  client: QueryClient,\n  key: QueryKey,\n  updater: (prev: T | undefined) => T,\n) {\n  client.setQueryData<T>(key, (prev) => updater(prev));\n}\n\n/** The cache key of page `page` of a `useFirestorePaginated` list keyed `queryKey`. */\nexport function paginatedPageKey(queryKey: QueryKey, page: number): QueryKey {\n  return [...queryKey, 'page', page];\n}\n\nfunction isPaginatedPage(value: unknown): value is PaginatedPage<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    Array.isArray((value as { items?: unknown }).items) &&\n    typeof (value as { hasMore?: unknown }).hasMore === 'boolean'\n  );\n}\n\nfunction isPageKey(baseKey: QueryKey, key: QueryKey): boolean {\n  return key.length === baseKey.length + 2 && key[baseKey.length] === 'page';\n}\n\n/**\n * Patch rows in place across every cached page of a `useFirestorePaginated` list\n * (`queryKey` is the base key the hook was given). Return the same row to leave it\n * unchanged; a page with no changed row keeps its identity. Cursors and has-more are\n * untouched, so paging stays aligned with the server.\n */\nexport function mapPaginatedItems<T>(\n  client: QueryClient,\n  queryKey: QueryKey,\n  mapItem: (item: T) => T,\n): void {\n  for (const [key, value] of client.getQueriesData<PaginatedPage<T>>({ queryKey })) {\n    if (!isPageKey(queryKey, key) || !isPaginatedPage(value)) continue;\n    let changed = false;\n    const items = value.items.map((item) => {\n      const next = mapItem(item as T);\n      if (next !== item) changed = true;\n      return next;\n    });\n    if (changed) client.setQueryData<PaginatedPage<T>>(key, { ...value, items });\n  }\n}\n\n/**\n * Put a just-created row at the top of page 1 of a `useFirestorePaginated` list, only\n * when page 1 is cached. Use it only for a list ordered newest-first. Page 1 keeps its\n * cursor, so it shows one extra row and page 2 keeps its place until page 1 is next read;\n * that read moves page 1's cursor, and the hook then re-reads page 2 from the new cursor\n * before showing it.\n */\nexport function prependToFirstPaginatedPage<T>(\n  client: QueryClient,\n  queryKey: QueryKey,\n  item: T,\n): void {\n  const key = paginatedPageKey(queryKey, 1);\n  const value = client.getQueryData<PaginatedPage<T>>(key);\n  if (!isPaginatedPage(value)) return;\n  client.setQueryData<PaginatedPage<T>>(key, { ...value, items: [item, ...value.items] });\n}\n\n/** How `placeRowInPages` reads and writes one infinite list's pages. */\nexport interface PagedRows<P, T> {\n  rowsOf: (page: P) => readonly T[];\n  withRows: (page: P, rows: T[]) => P;\n  /** True when `candidate` is the row being placed (its id). */\n  isRow: (candidate: T) => boolean;\n  /** True when `a` comes before `b` in the list's own order. */\n  sortsBefore: (a: T, b: T) => boolean;\n  /** True when this page is not the last one the source holds (a next page exists). */\n  hasMoreAfter: (page: P) => boolean;\n}\n\n/**\n * Place, move, or drop ONE row in a cached infinite list's loaded pages, in place: the row leaves\n * wherever it sits and, when `belongs`, joins at its position in the list's own order. A row that\n * sorts after every loaded row is added only when no further page exists; otherwise the next page\n * read returns it, so placing it here would list it twice. Every other row, every page, and every\n * cursor stays put; a list the row neither left nor joined is returned as it was. Never a reset to the\n * first page.\n */\nexport function placeRowInPages<P, T, TParam = unknown>(\n  data: InfiniteData<P, TParam> | undefined,\n  row: T,\n  belongs: boolean,\n  how: PagedRows<P, T>,\n): InfiniteData<P, TParam> | undefined {\n  if (!data || data.pages.length === 0) return data;\n  let changed = false;\n  const rows = data.pages.map((page) => {\n    const kept = how.rowsOf(page).filter((candidate) => !how.isRow(candidate));\n    if (kept.length !== how.rowsOf(page).length) changed = true;\n    return kept;\n  });\n  if (belongs) {\n    let placed = false;\n    for (const pageRows of rows) {\n      const index = pageRows.findIndex((candidate) => how.sortsBefore(row, candidate));\n      if (index !== -1) {\n        pageRows.splice(index, 0, row);\n        placed = true;\n        break;\n      }\n    }\n    const lastIndex = data.pages.length - 1;\n    if (!placed && !how.hasMoreAfter(data.pages[lastIndex])) {\n      rows[lastIndex].push(row);\n      placed = true;\n    }\n    changed = changed || placed;\n  }\n  if (!changed) return data;\n  return { ...data, pages: data.pages.map((page, i) => how.withRows(page, rows[i])) };\n}\n"]}
+{"version":3,"file":"cache-helpers.js","sourceRoot":"","sources":["../../src/react/cache-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InfiniteData, QueryClient, QueryKey } from '@tanstack/react-query';\nimport type { PaginatedPage } from './firestore/types.js';\n\nexport async function invalidateByPrefix(client: QueryClient, prefix: QueryKey) {\n  return client.invalidateQueries({ queryKey: prefix, exact: false });\n}\n\nexport function removeByPrefix(client: QueryClient, prefix: QueryKey) {\n  return client.removeQueries({ queryKey: prefix, exact: false });\n}\n\nexport function updateQueryData<T>(\n  client: QueryClient,\n  key: QueryKey,\n  updater: (prev: T | undefined) => T,\n) {\n  client.setQueryData<T>(key, (prev) => updater(prev));\n}\n\nexport function paginatedPageKey(queryKey: QueryKey, page: number): QueryKey {\n  return [...queryKey, 'page', page];\n}\n\nfunction isPaginatedPage(value: unknown): value is PaginatedPage<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    Array.isArray((value as { items?: unknown }).items) &&\n    typeof (value as { hasMore?: unknown }).hasMore === 'boolean'\n  );\n}\n\nfunction isPageKey(baseKey: QueryKey, key: QueryKey): boolean {\n  return key.length === baseKey.length + 2 && key[baseKey.length] === 'page';\n}\n\nexport function mapPaginatedItems<T>(\n  client: QueryClient,\n  queryKey: QueryKey,\n  mapItem: (item: T) => T,\n): void {\n  for (const [key, value] of client.getQueriesData<PaginatedPage<T>>({ queryKey })) {\n    if (!isPageKey(queryKey, key) || !isPaginatedPage(value)) continue;\n    let changed = false;\n    const items = value.items.map((item) => {\n      const next = mapItem(item as T);\n      if (next !== item) changed = true;\n      return next;\n    });\n    if (changed) client.setQueryData<PaginatedPage<T>>(key, { ...value, items });\n  }\n}\n\nexport function prependToFirstPaginatedPage<T>(\n  client: QueryClient,\n  queryKey: QueryKey,\n  item: T,\n): void {\n  const key = paginatedPageKey(queryKey, 1);\n  const value = client.getQueryData<PaginatedPage<T>>(key);\n  if (!isPaginatedPage(value)) return;\n  client.setQueryData<PaginatedPage<T>>(key, { ...value, items: [item, ...value.items] });\n}\n\nexport interface PagedRows<P, T> {\n  rowsOf: (page: P) => readonly T[];\n  withRows: (page: P, rows: T[]) => P;\n  isRow: (candidate: T) => boolean;\n  sortsBefore: (a: T, b: T) => boolean;\n  hasMoreAfter: (page: P) => boolean;\n}\n\nexport function placeRowInPages<P, T, TParam = unknown>(\n  data: InfiniteData<P, TParam> | undefined,\n  row: T,\n  belongs: boolean,\n  how: PagedRows<P, T>,\n): InfiniteData<P, TParam> | undefined {\n  if (!data || data.pages.length === 0) return data;\n  let changed = false;\n  const rows = data.pages.map((page) => {\n    const kept = how.rowsOf(page).filter((candidate) => !how.isRow(candidate));\n    if (kept.length !== how.rowsOf(page).length) changed = true;\n    return kept;\n  });\n  if (belongs) {\n    let placed = false;\n    for (const pageRows of rows) {\n      const index = pageRows.findIndex((candidate) => how.sortsBefore(row, candidate));\n      if (index !== -1) {\n        pageRows.splice(index, 0, row);\n        placed = true;\n        break;\n      }\n    }\n    const lastIndex = data.pages.length - 1;\n    if (!placed && !how.hasMoreAfter(data.pages[lastIndex])) {\n      rows[lastIndex].push(row);\n      placed = true;\n    }\n    changed = changed || placed;\n  }\n  if (!changed) return data;\n  return { ...data, pages: data.pages.map((page, i) => how.withRows(page, rows[i])) };\n}\n"]}

package/dist/react/callables/create-callables.d.ts

@@ -0,0 +1,40 @@
+import type { UseMutationResult } from '@tanstack/react-query';
+import type { ExpectedCallableAnswerCode } from '@ttt-productions/firebase-helpers';
+import { type FunctionsProvider } from '@ttt-productions/firebase-helpers/client';
+import { type SessionMutationOptions } from '../session-mutation.js';
+export interface CallableErrorRouting {
+    showErrorToast: boolean;
+    answeredRefusals: readonly ExpectedCallableAnswerCode[];
+    isAnswerSurfacedByCaller?: (error: unknown) => boolean;
+}
+export type CallableCaptureContext = Record<string, unknown>;
+export interface CallablePolicy {
+    getFunctions: FunctionsProvider;
+    timeoutMs: number;
+    resolveLimitedUseAppCheck: (requested: boolean) => boolean;
+    captureFault: (error: unknown, context: CallableCaptureContext) => void;
+    captureRecoveredFallback: (error: unknown, context: CallableCaptureContext) => void;
+    onActionError: (error: unknown, routing: CallableErrorRouting) => void;
+}
+export interface CallableDeclaration {
+    limitedUseAppCheck?: true;
+}
+interface CallableTransportOptions extends Partial<CallableErrorRouting> {
+    captureFaults?: boolean;
+}
+export type CallableMutationOptions<TInput, TResult, TOnMutateResult = unknown> = Omit<SessionMutationOptions<TResult, Error, TInput, TOnMutateResult>, 'mutationFn' | 'retry'> & Pick<CallableTransportOptions, 'showErrorToast' | 'answeredRefusals' | 'isAnswerSurfacedByCaller' | 'captureFaults'>;
+export declare const MAX_RESUMABLE_CALLS = 12;
+export type ResumableOutcome<TResult> = TResult & {
+    interruption: Error | null;
+};
+export interface Callables {
+    createCallableHook<TInput, TResult>(functionName: string, declaration?: CallableDeclaration): <TOnMutateResult = unknown>(options?: CallableMutationOptions<TInput, TResult, TOnMutateResult>) => UseMutationResult<TResult, Error, TInput, TOnMutateResult>;
+    createResumableCallableHook<TInput, TResult extends {
+        complete: boolean;
+    }>(functionName: string, merge: (earlier: TResult, later: TResult) => TResult, declaration?: CallableDeclaration): <TOnMutateResult = unknown>(options?: CallableMutationOptions<TInput, ResumableOutcome<TResult>, TOnMutateResult>) => UseMutationResult<ResumableOutcome<TResult>, Error, TInput, TOnMutateResult>;
+    createCallableReader<TInput, TResult>(functionName: string, declaration?: CallableDeclaration): () => (input: TInput) => Promise<TResult>;
+    createCallableInvoker<TInput, TResult>(functionName: string, declaration?: CallableDeclaration): () => (input: TInput) => Promise<TResult>;
+}
+export declare function createCallables(policy: CallablePolicy): Callables;
+export {};
+//# sourceMappingURL=create-callables.d.ts.map

package/dist/react/callables/create-callables.d.ts.map

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

package/dist/react/callables/create-callables.js

@@ -0,0 +1,101 @@
+'use client';
+import { useCallback, useMemo, useRef } from 'react';
+import { callCallable, isRecoveredFallbackReport, } from '@ttt-productions/firebase-helpers/client';
+import { useMutationSessionCapture, useSessionMutation, } from '../session-mutation.js';
+export const MAX_RESUMABLE_CALLS = 12;
+export function createCallables(policy) {
+    function useCallableTransport(functionName, declaration, options) {
+        const optionsRef = useRef(options);
+        optionsRef.current = options;
+        const limitedUseAppCheck = policy.resolveLimitedUseAppCheck(declaration.limitedUseAppCheck === true);
+        return useCallback((input, session) => callCallable(policy.getFunctions, functionName, input, {
+            captureException: (error, context) => {
+                if (optionsRef.current.captureFaults !== false)
+                    policy.captureFault(error, context);
+                else if (isRecoveredFallbackReport(context))
+                    policy.captureRecoveredFallback(error, context);
+            },
+            onError: (error) => {
+                if (!session.isCurrent())
+                    return;
+                const { showErrorToast = true, answeredRefusals = [], isAnswerSurfacedByCaller, } = optionsRef.current;
+                policy.onActionError(error, {
+                    showErrorToast,
+                    answeredRefusals,
+                    isAnswerSurfacedByCaller,
+                });
+            },
+        }, { timeoutMs: policy.timeoutMs, limitedUseAppCheck }), [functionName, limitedUseAppCheck]);
+    }
+    function useSessionBoundCall(call) {
+        const captureSession = useMutationSessionCapture();
+        return useMemo(() => (input) => call(input, captureSession()), [call, captureSession]);
+    }
+    return {
+        createCallableHook(functionName, declaration = {}) {
+            return function useNamedCallable(options = {}) {
+                const { showErrorToast, answeredRefusals, isAnswerSurfacedByCaller, captureFaults, ...mutationOptions } = options;
+                const call = useCallableTransport(functionName, declaration, {
+                    showErrorToast,
+                    answeredRefusals,
+                    isAnswerSurfacedByCaller,
+                    captureFaults,
+                });
+                // `retry: false` comes last so nothing overrides it: a deadline expiry is an unknown outcome,
+                // and a retry after a committed first attempt writes twice.
+                return useSessionMutation({
+                    ...mutationOptions,
+                    retry: false,
+                    mutationFn: (input, { session }) => call(input, session),
+                });
+            };
+        },
+        createResumableCallableHook(functionName, merge, declaration = {}) {
+            return function useNamedResumableCallable(options = {}) {
+                const { showErrorToast, answeredRefusals, isAnswerSurfacedByCaller, captureFaults, ...mutationOptions } = options;
+                const call = useCallableTransport(functionName, declaration, {
+                    showErrorToast,
+                    answeredRefusals,
+                    isAnswerSurfacedByCaller,
+                    captureFaults,
+                });
+                return useSessionMutation({
+                    ...mutationOptions,
+                    retry: false,
+                    mutationFn: async (input, { session }) => {
+                        let progress = await call(input, session);
+                        for (let calls = 1; !progress.complete && calls < MAX_RESUMABLE_CALLS; calls += 1) {
+                            session.assertCurrent();
+                            let later;
+                            try {
+                                later = await call(input, session);
+                            }
+                            catch (error) {
+                                const interruption = error instanceof Error ? error : new Error(String(error));
+                                return { ...progress, complete: false, interruption };
+                            }
+                            progress = merge(progress, later);
+                        }
+                        return { ...progress, interruption: null };
+                    },
+                });
+            };
+        },
+        createCallableReader(functionName, declaration = {}) {
+            return function useNamedCallableReader() {
+                const call = useCallableTransport(functionName, declaration, {
+                    showErrorToast: false,
+                    captureFaults: false,
+                });
+                return useSessionBoundCall(call);
+            };
+        },
+        createCallableInvoker(functionName, declaration = {}) {
+            return function useNamedCallableInvoker() {
+                const call = useCallableTransport(functionName, declaration, {});
+                return useSessionBoundCall(call);
+            };
+        },
+    };
+}
+//# sourceMappingURL=create-callables.js.map