@dereekb/firebase 13.0.5 → 13.0.7

package/index.esm.js

@@ -1,7 +1,7 @@
 import { increment, arrayRemove, arrayUnion, onSnapshot, getDoc, deleteDoc, setDoc, updateDoc, collection, collectionGroup, doc, writeBatch, runTransaction, getDocs, getCountFromServer, endBefore as endBefore$1, endAt as endAt$1, startAfter as startAfter$1, startAt as startAt$1, where as where$1, documentId, orderBy as orderBy$1, limitToLast as limitToLast$1, limit as limit$1, query } from 'firebase/firestore';
-import { cachedGetter, mergeModifiers, asArray, filterUndefinedValues, objectHasNoKeys, filterFalsyAndEmptyValues, build, wrapUseAsyncFunction, useAsync, runAsyncTasksForValues, filterMaybeArrayValues, performMakeLoop, makeWithFactory, toModelFieldConversions, makeModelMapFunctions, modifyModelMapFunctions, assignValuesToPOJOFunction, KeyValueTypleValueFilter, asObjectCopyFactory, transformStringFunctionConfig, transformStringFunction, passThrough, filterUniqueTransform, unique, transformNumberFunction, sortValuesFunctionOrMapIdentityWithSortRef, toModelMapFunctions, isEqualToValueDecisionFunction, filterFromPOJOFunction, mapObjectMap, copyObject, modelFieldMapFunctions, filterNullAndUndefinedValues, isDate, bitwiseSetDencoder, sortAscendingIndexNumberRefFunction, latLngStringFunction, DEFAULT_LAT_LNG_STRING_VALUE, mapObjectMapFunction, filterEmptyArrayValues, filterUniqueFunction, isMapIdentityFunction, chainMapSameFunctions, unixDateTimeSecondsNumberFromDate, dateFromDateOrTimeSecondsNumber, MAP_IDENTITY, pushItemOrArrayItemsIntoArray, separateValues, convertToArray, UTF_PRIVATE_USAGE_AREA_START, UTF_8_START_CHARACTER, mergeArraysIntoArray, lastValue, flattenArrayOrValueArray, allowValueOnceFilter, asGetter, getValueFromGetter, mapIdentityFunction, performTasksFromFactoryInParallelFunction, performAsyncTasks, batch, flattenArray, calculateExpirationDate, groupValues, forEachInIterable, arrayToObject, takeFront, stringContains, isOddNumber, objectToMap, ServerErrorResponse, toReadableError, capitalizeFirstLetter, lowercaseFirstLetter, toRelativeSlashPathStartType, mappedUseFunction, iterableToArray, setContainsAllValues, usePromise, slashPathFactory, errorMessageContainsString, bitwiseObjectDencoder, UNSET_INDEX_NUMBER, mergeObjectsFunction, mergeObjects, forEachKeyValue, updateMaybeValue, ModelRelationUtility, filterKeysOnPOJOFunction, areEqualPOJOValuesUsingPojoFilter, filterOnlyUndefinedValues, makeModelMap, isThrottled, MS_IN_HOUR, multiValueMapBuilder, mergeSlashPaths, slashPathDetails, toAbsoluteSlashPathStartType, SLASH_PATH_FILE_TYPE_SEPARATOR, slashPathPathMatcher, decisionFunction, slashPathSubPathMatcher } from '@dereekb/util';
+import { cachedGetter, mergeModifiers, asArray, filterUndefinedValues, objectHasNoKeys, filterFalsyAndEmptyValues, build, wrapUseAsyncFunction, useAsync, runAsyncTasksForValues, filterMaybeArrayValues, performMakeLoop, makeWithFactory, MAP_IDENTITY, toModelFieldConversions, makeModelMapFunctions, modifyModelMapFunctions, assignValuesToPOJOFunction, KeyValueTypleValueFilter, asObjectCopyFactory, transformStringFunctionConfig, transformStringFunction, passThrough, filterUniqueTransform, unique, transformNumberFunction, sortValuesFunctionOrMapIdentityWithSortRef, toModelMapFunctions, isEqualToValueDecisionFunction, filterFromPOJOFunction, mapObjectMap, copyObject, modelFieldMapFunctions, filterNullAndUndefinedValues, isDate, bitwiseSetDencoder, sortAscendingIndexNumberRefFunction, latLngStringFunction, DEFAULT_LAT_LNG_STRING_VALUE, mapObjectMapFunction, filterEmptyArrayValues, filterUniqueFunction, isMapIdentityFunction, chainMapSameFunctions, unixDateTimeSecondsNumberFromDate, dateFromDateOrTimeSecondsNumber, pushItemOrArrayItemsIntoArray, separateValues, convertToArray, UTF_PRIVATE_USAGE_AREA_START, UTF_8_START_CHARACTER, mergeArraysIntoArray, lastValue, flattenArrayOrValueArray, allowValueOnceFilter, asGetter, getValueFromGetter, mapIdentityFunction, performTasksFromFactoryInParallelFunction, performAsyncTasks, batch, flattenArray, calculateExpirationDate, groupValues, forEachInIterable, arrayToObject, takeFront, stringContains, isOddNumber, objectToMap, ServerErrorResponse, toReadableError, capitalizeFirstLetter, lowercaseFirstLetter, toRelativeSlashPathStartType, mappedUseFunction, iterableToArray, setContainsAllValues, usePromise, slashPathFactory, errorMessageContainsString, bitwiseObjectDencoder, UNSET_INDEX_NUMBER, mergeObjectsFunction, mergeObjects, forEachKeyValue, updateMaybeValue, ModelRelationUtility, filterKeysOnPOJOFunction, areEqualPOJOValuesUsingPojoFilter, filterOnlyUndefinedValues, makeModelMap, isThrottled, MS_IN_HOUR, multiValueMapBuilder, mergeSlashPaths, slashPathDetails, toAbsoluteSlashPathStartType, SLASH_PATH_FILE_TYPE_SEPARATOR, slashPathPathMatcher, decisionFunction, slashPathSubPathMatcher } from '@dereekb/util';
 import { filterMaybe, lazyFrom, itemAccumulator, ItemPageIterator, mappedPageItemIteration } from '@dereekb/rxjs';
-import { map, from, shareReplay, combineLatest, of, exhaustMap, Observable, switchMap, timer, skip } from 'rxjs';
+import { map, from, combineLatest, of, exhaustMap, Observable, switchMap, timer, skip, shareReplay } from 'rxjs';
 import { UNKNOWN_WEBSITE_LINK_TYPE, encodeWebsiteFileLinkToWebsiteLinkEncodedData, decodeWebsiteLinkEncodedDataToWebsiteFileLink, AbstractModelPermissionService, grantedRoleMapReader, noAccessRoleMap, fullAccessRoleMap, IsE164PhoneNumber } from '@dereekb/model';
 import { toISODateString, formatToISO8601DateString, toJsDate, isSameDate, dateRange, sortByDateFunction, yearWeekCode, UNKNOWN_YEAR_WEEK_CODE } from '@dereekb/date';
 import { httpsCallable } from 'firebase/functions';
@@ -660,31 +660,33 @@ function extendFirestoreCollectionWithSingleDocumentAccessor(x, singleItemIdenti
 }
 
 /**
- * Creates an array of new FirestoreDocument instances without creating them in Firestore.
+ * Creates an array of new {@link FirestoreDocument} instances without persisting them to Firestore.
  *
- * @template T - The document data type
- * @template D - The FirestoreDocument implementation type
- * @param documentAccessor - The document accessor to use for creating document instances
- * @param count - The number of document instances to create
- * @returns An array of new document instances
+ * Each document is allocated a unique auto-generated ID via {@link FirestoreDocumentAccessor.newDocument},
+ * but no data is written to the database. Useful for preparing document references in bulk before
+ * deciding what data to write.
+ *
+ * @param documentAccessor - Accessor that provides the `newDocument()` factory method
+ * @param count - Number of document instances to create
+ * @returns Array of `count` new document instances, each with a unique auto-generated ID
  */
 function newDocuments(documentAccessor, count) {
     return makeWithFactory(() => documentAccessor.newDocument(), count);
 }
 /**
- * Creates multiple documents in Firestore and returns the document instances.
+ * Creates and optionally persists multiple Firestore documents in sequence.
  *
- * For each document, this function:
- * 1. Creates a new document instance using the specified or default factory
- * 2. Calls the init function with the document instance
- * 3. If init returns data, creates the document in Firestore
- * 4. Returns all document instances, whether they were created in Firestore or not
+ * Uses {@link performMakeLoop} to iterate `count` times. For each iteration:
+ * 1. A new document instance is created (via `make.newDocument` or the default factory)
+ * 2. `make.init(i, document)` is awaited to produce initial data
+ * 3. If init returns non-nullish data, `document.accessor.create(data)` persists it
+ * 4. The document instance is collected regardless of whether it was persisted
  *
- * @template T - The document data type
- * @template D - The FirestoreDocument implementation type
- * @param documentAccessor - The document accessor to use for creating document instances
- * @param make - Parameters for document creation and initialization
- * @returns A promise that resolves to an array of document instances
+ * Documents are created sequentially (not in parallel) to allow index-dependent logic.
+ *
+ * @param documentAccessor - Accessor providing the document factory and collection context
+ * @param make - Configuration controlling count, factory, and initialization
+ * @returns Promise resolving to all created document instances (length === `make.count`)
  */
 function makeDocuments(documentAccessor, make) {
     const newDocumentFn = make.newDocument ?? (() => documentAccessor.newDocument());
@@ -701,65 +703,52 @@ function makeDocuments(documentAccessor, make) {
     });
 }
 /**
- * Retrieves DocumentSnapshots for an array of documents in parallel.
+ * Fetches {@link DocumentSnapshot}s for multiple documents in parallel using {@link runAsyncTasksForValues}.
  *
- * This is useful for fetching the current state of multiple documents at once.
+ * Each document's `accessor.get()` is called concurrently. The returned array preserves
+ * the same ordering as the input `documents` array.
  *
- * @template D - The FirestoreDocument implementation type
- * @param documents - Array of document instances to get snapshots for
- * @returns Promise that resolves to an array of DocumentSnapshots in the same order as the input documents
+ * @param documents - Documents to fetch snapshots for
+ * @returns Snapshots in the same order as the input array
  */
 function getDocumentSnapshots(documents) {
     return runAsyncTasksForValues(documents, (x) => x.accessor.get());
 }
 /**
- * Creates a document-snapshot pair from a document instance.
- *
- * Fetches the current snapshot of the document and returns both the original
- * document instance and the snapshot together.
+ * Fetches the current snapshot of a single document and pairs it with the document instance.
  *
- * @template D - The FirestoreDocument implementation type
- * @param document - The document instance to get a snapshot for
- * @returns Promise that resolves to a document-snapshot pair
+ * @param document - The document to fetch
+ * @returns A pair containing the document and its snapshot
  */
 function getDocumentSnapshotPair(document) {
     return document.accessor.get().then((snapshot) => ({ document, snapshot }));
 }
 /**
- * Creates document-snapshot pairs for an array of documents in parallel.
+ * Fetches snapshots for multiple documents in parallel and pairs each with its document instance.
  *
- * Fetches the current snapshot of each document and returns pairs containing both
- * the original document instances and their snapshots.
- *
- * @template D - The FirestoreDocument implementation type
- * @param documents - Array of document instances to get snapshots for
- * @returns Promise that resolves to an array of document-snapshot pairs in the same order as the input documents
+ * @param documents - Documents to fetch
+ * @returns Pairs in the same order as the input array
  */
 function getDocumentSnapshotPairs(documents) {
     return runAsyncTasksForValues(documents, getDocumentSnapshotPair);
 }
 /**
- * Creates a document-snapshot-data triplet from a document instance.
- *
- * Fetches the current snapshot of the document, extracts its data with ID and key fields,
- * and returns all three together in a single object.
+ * Fetches a document's snapshot, extracts its data with `id`/`key` fields, and returns all three as a triplet.
  *
- * @template D - The FirestoreDocument implementation type
- * @param document - The document instance to get data for
- * @returns Promise that resolves to a document-snapshot-data triplet
+ * @param document - The document to fetch
+ * @returns A triplet of document, snapshot, and data (data may be `undefined` if the document doesn't exist)
  */
 function getDocumentSnapshotDataPair(document) {
     return document.accessor.get().then((snapshot) => ({ document, snapshot, data: documentDataWithIdAndKey(snapshot) }));
 }
 /**
- * Creates document-snapshot-data triplets for an array of documents in parallel.
+ * Fetches snapshot-data triplets for multiple documents in parallel.
  *
- * Fetches the current snapshot of each document, extracts its data with ID and key fields,
- * and returns triplets containing all three components for each document.
+ * Processes up to 200 documents concurrently via {@link runAsyncTasksForValues}.
+ * The returned array preserves the same ordering as the input.
  *
- * @template D - The FirestoreDocument implementation type
- * @param documents - Array of document instances to get data for
- * @returns Promise that resolves to an array of document-snapshot-data triplets in the same order as the input documents
+ * @param documents - Documents to fetch
+ * @returns Triplets in the same order as the input array
  */
 function getDocumentSnapshotDataPairs(documents) {
     return runAsyncTasksForValues(documents, getDocumentSnapshotDataPair, {
@@ -767,18 +756,27 @@ function getDocumentSnapshotDataPairs(documents) {
     });
 }
 /**
- * Creates document-snapshot-data triplets for an array of documents and filters out those without data.
+ * Fetches snapshot-data triplets for multiple documents and filters out those that don't exist in Firestore.
  *
- * This is a convenience function that fetches data for all documents and then returns
- * only the triplets for documents that actually exist in Firestore.
+ * Convenience wrapper around {@link getDocumentSnapshotDataPairs} that removes entries where `data` is nullish,
+ * returning only {@link FirestoreDocumentSnapshotDataPairWithData} results.
  *
- * @template D - The FirestoreDocument implementation type
- * @param documents - Array of document instances to get data for
- * @returns Promise that resolves to an array of document-snapshot-data triplets for existing documents only
+ * @param documents - Documents to fetch
+ * @returns Triplets for documents that exist, in their original relative order
  */
 function getDocumentSnapshotDataPairsWithData(documents) {
     return getDocumentSnapshotDataPairs(documents).then((x) => x.filter((y) => !!y.data));
 }
+/**
+ * Fetches raw snapshot data tuples for multiple documents in parallel.
+ *
+ * Unlike {@link getDocumentSnapshotDataPairs}, this returns a lightweight `[document, data]` tuple
+ * and does not inject `id`/`key` fields onto the data. The `data` value is the raw result of
+ * `snapshot.data()` and may be `undefined` for non-existent documents.
+ *
+ * @param documents - Documents to fetch
+ * @returns Tuples in the same order as the input array
+ */
 function getDocumentSnapshotDataTuples(documents) {
     return runAsyncTasksForValues(documents, (document) => document.accessor.get().then((snapshot) => [document, snapshot.data()]));
 }
@@ -792,33 +790,109 @@ function getDataFromDocumentSnapshots(snapshots, withId = true) {
     const mapFn = documentDataFunction(withId);
     return filterMaybeArrayValues(snapshots.map(mapFn));
 }
+/**
+ * Creates {@link FirestoreDocument} instances for all documents in a {@link QuerySnapshot}.
+ *
+ * Maps each document in `snapshots.docs` to a loaded document via `accessor.loadDocument(ref)`.
+ * No additional data fetching occurs; the documents are loaded from their existing references.
+ *
+ * @param accessor - Accessor to load documents with
+ * @param snapshots - Query snapshot containing the document references
+ * @returns Document instances in the same order as the query results
+ */
 function loadDocumentsForSnapshots(accessor, snapshots) {
     return snapshots.docs.map((x) => accessor.loadDocument(x.ref));
 }
+/**
+ * Extracts {@link DocumentReference}s from arbitrary values and loads them as {@link FirestoreDocument} instances.
+ *
+ * Convenience function that maps values through `getRef` then delegates to {@link loadDocumentsForDocumentReferences}.
+ *
+ * @param accessor - Accessor to load documents with
+ * @param values - Source values to extract references from
+ * @param getRef - Extracts a document reference from each value
+ * @returns Document instances in the same order as the input values
+ */
 function loadDocumentsForDocumentReferencesFromValues(accessor, values, getRef) {
     return loadDocumentsForDocumentReferences(accessor, values.map(getRef));
 }
+/**
+ * Alias for {@link loadDocumentsForDocumentReferencesFromValues}.
+ */
 const loadDocumentsForValues = loadDocumentsForDocumentReferencesFromValues;
+/**
+ * Loads {@link FirestoreDocument} instances from an array of {@link DocumentReference}s.
+ *
+ * Each reference is passed to `accessor.loadDocument()` to create a document wrapper.
+ * No network calls are made; this only creates in-memory document instances bound to the given references.
+ *
+ * @param accessor - Accessor to load documents with
+ * @param refs - Document references to load
+ * @returns Document instances in the same order as the input references
+ */
 function loadDocumentsForDocumentReferences(accessor, refs) {
     return refs.map((x) => accessor.loadDocument(x));
 }
+/**
+ * Extracts {@link FirestoreModelKey}s from arbitrary values and loads them as {@link FirestoreDocument} instances.
+ *
+ * Convenience function that maps values through `getKey` then delegates to {@link loadDocumentsForKeys}.
+ *
+ * @param accessor - Accessor to load documents with
+ * @param values - Source values to extract keys from
+ * @param getKey - Extracts a model key (full Firestore path) from each value
+ * @returns Document instances in the same order as the input values
+ */
 function loadDocumentsForKeysFromValues(accessor, values, getKey) {
     return loadDocumentsForKeys(accessor, values.map(getKey));
 }
+/**
+ * Loads {@link FirestoreDocument} instances from an array of full Firestore document paths (keys).
+ *
+ * Each key is passed to `accessor.loadDocumentForKey()`. No network calls are made.
+ *
+ * @param accessor - Accessor to load documents with
+ * @param keys - Full Firestore document paths (e.g. `'users/abc123'`)
+ * @returns Document instances in the same order as the input keys
+ */
 function loadDocumentsForKeys(accessor, keys) {
     return keys.map((x) => accessor.loadDocumentForKey(x));
 }
+/**
+ * Extracts {@link FirestoreModelId}s from arbitrary values and loads them as {@link FirestoreDocument} instances.
+ *
+ * Convenience function that maps values through `getId` then delegates to {@link loadDocumentsForIds}.
+ * Requires a full {@link FirestoreDocumentAccessor} (not limited) because loading by ID requires collection context.
+ *
+ * @param accessor - Accessor to load documents with (must have collection context for ID resolution)
+ * @param values - Source values to extract IDs from
+ * @param getId - Extracts a model ID from each value
+ * @returns Document instances in the same order as the input values
+ */
 function loadDocumentsForIdsFromValues(accessor, values, getId) {
     return loadDocumentsForIds(accessor, values.map(getId));
 }
+/**
+ * Loads {@link FirestoreDocument} instances from an array of document IDs relative to the accessor's collection.
+ *
+ * Each ID is passed to `accessor.loadDocumentForId()`. Requires a full {@link FirestoreDocumentAccessor}
+ * because ID-based loading needs the collection reference to resolve the full path. No network calls are made.
+ *
+ * @param accessor - Accessor to load documents with (must have collection context)
+ * @param ids - Document IDs within the accessor's collection
+ * @returns Document instances in the same order as the input IDs
+ */
 function loadDocumentsForIds(accessor, ids) {
     return ids.map((x) => accessor.loadDocumentForId(x));
 }
 /**
- * Used to make a FirestoreDocumentLoader.
+ * Creates a {@link FirestoreDocumentLoader} from a {@link LimitedFirestoreDocumentAccessorContextExtension}.
  *
- * @param accessorContext
- * @returns
+ * The returned loader resolves the appropriate accessor based on whether a transaction is provided,
+ * then delegates to {@link loadDocumentsForDocumentReferences}.
+ *
+ * @param accessorContext - Context that provides accessors for both default and transactional use
+ * @returns A loader function that converts document references to document instances
  */
 function firestoreDocumentLoader(accessorContext) {
     return (references, transaction) => {
@@ -827,10 +901,16 @@ function firestoreDocumentLoader(accessorContext) {
     };
 }
 /**
- * Used to make a FirestoreDocumentSnapshotPairsLoader.
+ * Creates a {@link FirestoreDocumentSnapshotPairsLoader} from a {@link LimitedFirestoreDocumentAccessorContextExtension}.
  *
- * @param accessorContext
- * @returns
+ * The returned loader resolves the appropriate accessor based on whether a transaction is provided,
+ * then maps each snapshot to a {@link FirestoreDocumentSnapshotDataPair} using {@link firestoreDocumentSnapshotPairsLoaderInstance}.
+ *
+ * Also satisfies the {@link FirestoreQueryDocumentSnapshotPairsLoader} type since the implementation
+ * handles both {@link DocumentSnapshot} and {@link QueryDocumentSnapshot} inputs.
+ *
+ * @param accessorContext - Context that provides accessors for both default and transactional use
+ * @returns A loader function that converts snapshots to document-snapshot-data pairs
  */
 function firestoreDocumentSnapshotPairsLoader(accessorContext) {
     return (snapshots, transaction) => {
@@ -840,10 +920,15 @@ function firestoreDocumentSnapshotPairsLoader(accessorContext) {
     };
 }
 /**
- * Used to make a FirestoreDocumentSnapshotPairsLoader.
+ * Creates a {@link FirestoreDocumentSnapshotPairsLoaderInstance} bound to a specific accessor.
  *
- * @param accessorContext
- * @returns
+ * The returned function converts a snapshot into a {@link FirestoreDocumentSnapshotDataPair} by:
+ * 1. Extracting data with `id`/`key` fields via {@link documentDataWithIdAndKey}
+ * 2. Loading the document from the snapshot's reference via `accessor.loadDocument()`
+ * 3. Combining all three into a single pair object
+ *
+ * @param accessor - The accessor to bind for document loading
+ * @returns A reusable function that converts snapshots to pairs using the bound accessor
  */
 function firestoreDocumentSnapshotPairsLoaderInstance(accessor) {
     const fn = ((snapshot) => {
@@ -860,10 +945,10 @@ function firestoreDocumentSnapshotPairsLoaderInstance(accessor) {
     return fn;
 }
 /**
- * Used to make a FirestoreQueryDocumentSnapshotPairsLoader.
+ * Alias for {@link firestoreDocumentSnapshotPairsLoader}, typed specifically as a {@link FirestoreQueryDocumentSnapshotPairsLoader}.
  *
- * @param accessorContext
- * @returns
+ * Use this when you know all input snapshots are from a query and want the stronger return type
+ * that guarantees `data` is non-nullish.
  */
 const firestoreQueryDocumentSnapshotPairsLoader = firestoreDocumentSnapshotPairsLoader;
 function documentData(snapshot, withId = false) {
@@ -885,11 +970,14 @@ function documentDataWithIdAndKey(snapshot) {
     return data;
 }
 /**
- * Sets the id and key values from the snapshot onto the input data.
+ * Mutates the input data object to include `id` and `key` fields from a {@link DocumentSnapshot}.
  *
- * @param data
- * @param snapshot
- * @returns
+ * Sets `data.id` to `snapshot.id` and `data.key` to `snapshot.ref.path`. The data object
+ * is modified in-place and also returned for chaining convenience.
+ *
+ * @param data - The data object to augment (mutated in-place)
+ * @param snapshot - Source of the `id` and `key` values
+ * @returns The same data object, now typed as {@link DocumentDataWithIdAndKey}
  */
 function setIdAndKeyFromSnapshotOnDocumentData(data, snapshot) {
     const target = data;
@@ -898,11 +986,15 @@ function setIdAndKeyFromSnapshotOnDocumentData(data, snapshot) {
     return target;
 }
 /**
- * Sets the id and key values from the snapshot onto the input data.
+ * Mutates the input data object to include `id` and `key` fields from a model reference.
  *
- * @param data
- * @param snapshot
- * @returns
+ * Similar to {@link setIdAndKeyFromSnapshotOnDocumentData}, but sources the values from a
+ * {@link FirestoreModelKeyRef} & {@link FirestoreModelIdRef} instead of a snapshot.
+ * The data object is modified in-place and also returned for chaining convenience.
+ *
+ * @param data - The data object to augment (mutated in-place)
+ * @param modelRef - Source of the `id` and `key` values
+ * @returns The same data object, now typed as {@link DocumentDataWithIdAndKey}
  */
 function setIdAndKeyFromKeyIdRefOnDocumentData(data, modelRef) {
     const target = data;
@@ -911,47 +1003,156 @@ function setIdAndKeyFromKeyIdRefOnDocumentData(data, modelRef) {
     return target;
 }
 /**
- * MappedUseAsyncFunction to load a snapshot from the input document and use it.
+ * Fetches a document's snapshot and passes it to a `use` callback, following the {@link UseAsync} pattern.
  *
- * @param document
- * @param use
- * @param defaultValue
- * @returns
+ * If `document` is nullish, the `use` callback is not invoked and `defaultValue` is returned instead.
+ * If `document` exists but the snapshot is nullish (shouldn't happen in practice), `defaultValue` is also used.
+ *
+ * @param document - The document to fetch, or nullish to skip
+ * @param use - Callback that receives the fetched snapshot and returns a result
+ * @param defaultValue - Fallback value when `document` is nullish or the snapshot is unavailable
+ * @returns The result of `use`, or the default value
  */
 async function useDocumentSnapshot(document, use, defaultValue) {
     const snapshot = await document?.accessor.get();
     return useAsync(snapshot, use, defaultValue);
 }
 /**
- * MappedUseAsyncFunction to load snapshot data from the input document and use it.
+ * Fetches a document's snapshot data (via `snapshot.data()`) and passes it to a `use` callback.
+ *
+ * Wraps {@link useDocumentSnapshot} with a mapping step that extracts raw data from the snapshot.
+ * If the document doesn't exist (data is `undefined`), the `use` callback is not invoked
+ * and `defaultValue` is returned instead.
+ *
+ * @param document - The document to fetch, or nullish to skip
+ * @param use - Callback that receives the snapshot data and returns a result
+ * @param defaultValue - Fallback value when the document is nullish or doesn't exist
+ * @returns The result of `use`, or the default value
  */
 const useDocumentSnapshotData = wrapUseAsyncFunction(useDocumentSnapshot, (x) => x.data());
 // MARK: Key Accessors
+/**
+ * Extracts the document ID ({@link FirestoreModelId}) from a {@link FirestoreDocument}.
+ *
+ * Useful as a mapper function, e.g. `documents.map(firestoreModelIdFromDocument)`.
+ *
+ * @param document - The document to extract the ID from
+ * @returns The document's ID (the last segment of its Firestore path)
+ */
 function firestoreModelIdFromDocument(document) {
     return document.id;
 }
+/**
+ * Extracts document IDs from an array of {@link FirestoreDocument}s.
+ *
+ * @param documents - Documents to extract IDs from
+ * @returns Array of document IDs in the same order as the input
+ */
 function firestoreModelIdsFromDocuments(documents) {
     return documents.map(firestoreModelIdFromDocument);
 }
+/**
+ * Extracts the full Firestore path ({@link FirestoreModelKey}) from a {@link FirestoreDocument}.
+ *
+ * Useful as a mapper function, e.g. `documents.map(firestoreModelKeyFromDocument)`.
+ *
+ * @param document - The document to extract the key from
+ * @returns The document's full Firestore path (e.g. `'users/abc123'`)
+ */
 function firestoreModelKeyFromDocument(document) {
     return document.key;
 }
+/**
+ * Extracts full Firestore paths from an array of {@link FirestoreDocument}s.
+ *
+ * @param documents - Documents to extract keys from
+ * @returns Array of full Firestore paths in the same order as the input
+ */
 function firestoreModelKeysFromDocuments(documents) {
     return documents.map(firestoreModelKeyFromDocument);
 }
+/**
+ * Extracts the {@link DocumentReference} from a {@link FirestoreDocument}.
+ *
+ * Useful as a mapper function, e.g. `documents.map(documentReferenceFromDocument)`.
+ *
+ * @param document - The document to extract the reference from
+ * @returns The underlying Firestore document reference
+ */
 function documentReferenceFromDocument(document) {
     return document.documentRef;
 }
+/**
+ * Extracts {@link DocumentReference}s from an array of {@link FirestoreDocument}s.
+ *
+ * @param documents - Documents to extract references from
+ * @returns Array of document references in the same order as the input
+ */
 function documentReferencesFromDocuments(documents) {
     return documents.map(documentReferenceFromDocument);
 }
+/**
+ * Creates a {@link LimitedFirestoreDocumentAccessorSnapshotCache} that wraps the given accessor
+ * with an in-memory {@link Map} cache so that repeated loads for the same key return the cached
+ * promise instead of re-reading from Firestore.
+ *
+ * The cache stores the promise itself (not the resolved value), which means concurrent requests
+ * for the same key that arrive before the first read completes will also be deduplicated.
+ *
+ * The cache lives for the lifetime of the returned object and is never invalidated, so this is
+ * best suited for short-lived scopes (e.g. a single request or batch operation) where stale reads
+ * are acceptable.
+ *
+ * @param accessor - The accessor to wrap with caching behavior
+ * @returns A {@link LimitedFirestoreDocumentAccessorSnapshotCache} backed by the given accessor
+ *
+ * @example
+ * ```typescript
+ * const cache = limitedFirestoreDocumentAccessorSnapshotCache(accessor);
+ *
+ * // First call reads from Firestore; second call returns cached result
+ * const pair = await cache.getDocumentSnapshotDataPairForKey('users/abc123');
+ * const samePair = await cache.getDocumentSnapshotDataPairForKey('users/abc123');
+ *
+ * // Batch fetch with automatic deduplication
+ * const pairs = await cache.getDocumentSnapshotDataPairsWithDataForKeys(['users/abc', 'users/def']);
+ *
+ * // Access the underlying accessor directly
+ * const doc = cache.accessor.loadDocumentForKey('users/xyz');
+ * ```
+ */
+function limitedFirestoreDocumentAccessorSnapshotCache(accessor) {
+    const cache = new Map();
+    function getDocumentSnapshotDataPairForKey(key) {
+        let cached = cache.get(key);
+        if (!cached) {
+            const document = accessor.loadDocumentForKey(key);
+            cached = getDocumentSnapshotDataPair(document);
+            cache.set(key, cached);
+        }
+        return cached;
+    }
+    async function getDocumentSnapshotDataPairsForKeys(keys) {
+        return Promise.all(keys.map((key) => getDocumentSnapshotDataPairForKey(key)));
+    }
+    async function getDocumentSnapshotDataPairsWithDataForKeys(keys) {
+        const pairs = await getDocumentSnapshotDataPairsForKeys(keys);
+        return filterMaybeArrayValues(pairs.map((pair) => (pair.data != null ? pair : undefined)));
+    }
+    return {
+        accessor,
+        getDocumentSnapshotDataPairForKey,
+        getDocumentSnapshotDataPairsForKeys,
+        getDocumentSnapshotDataPairsWithDataForKeys
+    };
+}
 
 /**
  * Creates an Observable that emits arrays of document snapshots for multiple documents.
  *
  * This function streams the latest snapshots for each document in the provided array.
  * Each time any document in the array changes, a new array containing the latest snapshots
- * of all documents is emitted. Results are shared with multiple subscribers through shareReplay.
+ * of all documents is emitted.
  *
  * If the input array is empty, an Observable that emits an empty array is returned.
  *
@@ -960,7 +1161,25 @@ function documentReferencesFromDocuments(documents) {
  * @returns Observable that emits arrays of DocumentSnapshots whenever any document changes
  */
 function latestSnapshotsFromDocuments(documents) {
-    return documents.length ? combineLatest(documents.map((x) => x.accessor.stream())).pipe(shareReplay(1)) : of([]);
+    return mapLatestSnapshotsFromDocuments(documents, map(MAP_IDENTITY));
+}
+/**
+ * Creates an Observable that streams and transforms snapshots for multiple documents using `combineLatest`.
+ *
+ * Pipes each document's `accessor.stream()` through the provided `operator` before combining.
+ * This ensures the transformation runs per-document when only one document changes, rather than
+ * re-mapping all snapshots on every emission.
+ *
+ * {@link latestSnapshotsFromDocuments} delegates to this function with an identity operator.
+ *
+ * Returns `of([])` for an empty input array.
+ *
+ * @param documents - Documents to stream from
+ * @param operator - RxJS operator applied to each document's snapshot stream individually
+ * @returns Observable emitting an array of transformed values whenever any document changes
+ */
+function mapLatestSnapshotsFromDocuments(documents, operator) {
+    return documents.length ? combineLatest(documents.map((x) => x.accessor.stream().pipe(operator))) : of([]);
 }
 /**
  * Creates an Observable that emits arrays of document data for multiple documents.
@@ -968,7 +1187,7 @@ function latestSnapshotsFromDocuments(documents) {
  * This function streams the latest data for each document in the provided array.
  * Each time any document in the array changes, a new array containing the latest data
  * of all documents is emitted. Document data includes both the document content and
- * metadata like document ID and key. Results are shared with multiple subscribers.
+ * metadata like document ID and key.
  *
  * Non-existent documents are filtered out of the results automatically.
  *
@@ -976,8 +1195,8 @@ function latestSnapshotsFromDocuments(documents) {
  * @param documents - Array of document instances to stream data for
  * @returns Observable that emits arrays of document data whenever any document changes
  */
-function latestDataFromDocuments(documents) {
-    return latestSnapshotsFromDocuments(documents).pipe(dataFromDocumentSnapshots(), shareReplay(1));
+function streamDocumentSnapshotsData(documents) {
+    return latestSnapshotsFromDocuments(documents).pipe(dataFromDocumentSnapshots());
 }
 /**
  * Creates an RxJS operator that transforms arrays of DocumentSnapshots into arrays of document data.
@@ -992,6 +1211,53 @@ function latestDataFromDocuments(documents) {
 function dataFromDocumentSnapshots() {
     return map((x) => getDataFromDocumentSnapshots(x));
 }
+// MARK: Streaming Document Snapshot Pairs
+/**
+ * Streams {@link FirestoreDocumentSnapshotDataPair}s for multiple documents using `combineLatest`.
+ *
+ * Each document's `accessor.stream()` is individually piped to produce a `{ document, snapshot, data }` triplet,
+ * then all streams are combined via `combineLatest`. This ensures the mapping only runs for the document
+ * that actually changed. The `data` field has `id` and `key` fields injected via {@link documentDataWithIdAndKey},
+ * and will be `undefined` for documents that don't exist in Firestore.
+ *
+ * Returns `of([])` for an empty input array.
+ *
+ * This is the streaming equivalent of {@link import('./document.utility').getDocumentSnapshotDataPairs}.
+ *
+ * @param documents - Documents to stream snapshot-data pairs for
+ * @returns Observable emitting snapshot-data pairs whenever any document changes
+ */
+function streamDocumentSnapshotDataPairs(documents) {
+    return documents.length
+        ? combineLatest(documents.map((document) => document.accessor.stream().pipe(map((snapshot) => ({
+            document,
+            snapshot,
+            data: documentDataWithIdAndKey(snapshot)
+        })))))
+        : of([]);
+}
+/**
+ * Streams {@link FirestoreDocumentSnapshotDataPairWithData}s for multiple documents, filtering out non-existent documents.
+ *
+ * Builds on {@link streamDocumentSnapshotDataPairs} and filters each emission to include only pairs where
+ * `data` is non-nullish (i.e., the document exists in Firestore). The filtered array may be shorter than
+ * the input `documents` array and may change length over time as documents are created or deleted.
+ *
+ * Returns `of([])` for an empty input array.
+ *
+ * This is the streaming equivalent of {@link import('./document.utility').getDocumentSnapshotDataPairsWithData}.
+ *
+ * @param documents - Documents to stream snapshot-data pairs for
+ * @returns Observable emitting snapshot-data pairs for existing documents only, whenever any document changes
+ */
+function streamDocumentSnapshotDataPairsWithData(documents) {
+    return streamDocumentSnapshotDataPairs(documents).pipe(map((pairs) => pairs.filter((pair) => pair.data != null)));
+}
+// MARK: Compat
+/**
+ * @deprecated Use {@link streamDocumentSnapshotsData} instead.
+ */
+const latestDataFromDocuments = streamDocumentSnapshotsData;
 
 // A set of copied types from @google-cloud/firestore and firebase/firestore to allow cross-compatability.
 /* eslint-disable */
@@ -2147,20 +2413,14 @@ function firebaseQueryItemAccumulator(iteration, mapItem) {
 }
 
 /**
- * Creates a Firestore query constraint.
+ * Creates a {@link FirestoreQueryConstraint} with the given type identifier and data.
  *
- * @template T - Type of data stored in the constraint
- * @param type - The constraint type identifier
- * @param data - The constraint data
- * @returns A Firestore query constraint object
- */
-/**
- * Creates a Firestore query constraint.
+ * This is the low-level factory used by all constraint builder functions (e.g., {@link where},
+ * {@link limit}, {@link orderBy}). Most callers should use those typed builders instead.
  *
- * @template T - Type of data stored in the constraint
- * @param type - The constraint type identifier
- * @param data - The constraint data
- * @returns A Firestore query constraint object
+ * @param type - The constraint type identifier (e.g., 'where', 'limit')
+ * @param data - The constraint-specific configuration data
+ * @returns A typed constraint object
  */
 function firestoreQueryConstraint(type, data) {
     return {
@@ -2660,6 +2920,17 @@ function filterDisallowedFirestoreItemPageIteratorInputConstraints(constraints)
  * This value is used when no itemsPerPage is explicitly specified in the configuration.
  */
 const DEFAULT_FIRESTORE_ITEM_PAGE_ITERATOR_ITEMS_PER_PAGE = 50;
+/**
+ * Creates a {@link FirestoreItemPageIteratorDelegate} that handles cursor-based Firestore pagination.
+ *
+ * The delegate implements `loadItemsForPage` by:
+ * 1. Retrieving the cursor document from the previous page's results
+ * 2. Building a query with the configured constraints, `startAfter` cursor, and `limit`
+ * 3. Executing the query and wrapping the results in a {@link FirestoreItemPageQueryResult}
+ *    with `reload()` and `stream()` capabilities
+ *
+ * @returns A delegate instance for use with {@link ItemPageIterator}
+ */
 function makeFirestoreItemPageIteratorDelegate() {
     return {
         loadItemsForPage: (request) => {
@@ -2817,7 +3088,14 @@ function _firestoreItemPageIterationWithSnapshotIteration(snapshotIteration) {
     return result;
 }
 /**
- * Creates a FirestoreFixedItemPageIterationFactoryFunction.
+ * Creates a factory function for generating fixed-set Firestore pagination instances.
+ *
+ * The returned factory takes an array of document references and an optional filter,
+ * producing a pagination instance that iterates over those specific documents in pages.
+ *
+ * @param baseConfig - Base pagination configuration (query reference, driver, page size)
+ * @param documentAccessor - Accessor used to load document snapshots from the references
+ * @returns A factory function that creates fixed-set pagination instances
  */
 function firestoreFixedItemPageIterationFactory(baseConfig, documentAccessor) {
     return (items, filter) => {
@@ -2834,7 +3112,17 @@ function firestoreFixedItemPageIterationFactory(baseConfig, documentAccessor) {
     };
 }
 /**
- * Creates a FirestoreItemPageIterationInstance that iterates over the fixed
+ * Creates a pagination instance that iterates over a fixed set of document references.
+ *
+ * Unlike {@link firestoreItemPageIteration} which queries Firestore dynamically, this function
+ * paginates through a pre-determined list of document references. Each page loads the next
+ * slice of references via the document accessor and produces a synthetic {@link QuerySnapshot}.
+ *
+ * This is useful for paginating over known document sets (e.g., from a pre-computed list
+ * of references) without executing Firestore queries.
+ *
+ * @param config - Configuration including the document references, accessor, and pagination settings
+ * @returns A pagination instance that pages through the fixed reference set
  */
 function firestoreFixedItemPageIteration(config) {
     const { items, documentAccessor } = config;
@@ -3051,24 +3339,47 @@ function readFirestoreModelKeyFromDocumentSnapshot(snapshot) {
 /**
  * @module Firestore Query Iteration
  *
- * This module provides a comprehensive system for iterating through Firestore query results
- * with support for pagination, batching, and parallelism. It enables efficient processing of
- * large result sets by using cursor-based pagination (via "checkpoints") and various iteration
- * strategies.
+ * Provides a layered system for iterating through Firestore query results using
+ * cursor-based pagination ("checkpoints"). Each layer adds convenience on top of the
+ * one below:
+ *
+ * 1. **Checkpoints** ({@link iterateFirestoreDocumentSnapshotCheckpoints}) — core pagination engine
+ * 2. **Batches** ({@link iterateFirestoreDocumentSnapshotBatches}) — subdivides checkpoints into fixed-size batches
+ * 3. **Snapshots** ({@link iterateFirestoreDocumentSnapshots}) — processes individual snapshots
+ * 4. **Pairs** ({@link iterateFirestoreDocumentSnapshotPairs}) — loads typed document wrappers per snapshot
+ *
+ * Batch variants with document pairs are also available:
+ * - {@link iterateFirestoreDocumentSnapshotPairBatches} — batch processing with typed document access
+ *
+ * All functions support configurable limits (`limitPerCheckpoint`, `totalSnapshotsLimit`),
+ * concurrency (`maxParallelCheckpoints`), rate limiting (`waitBetweenCheckpoints`),
+ * snapshot filtering, and repeat cursor detection.
  */
 /**
- * Iterates through the results of a Firestore query by each FirestoreDocumentSnapshotDataPairWithData.
+ * Iterates through Firestore query results, loading each snapshot as a
+ * {@link FirestoreDocumentSnapshotDataPairWithData} before processing.
  *
- * This function efficiently handles pagination through potentially large result sets by using
- * the checkpoint system to load documents in batches. For each document snapshot, it loads the
- * associated data using the provided document accessor, then passes the combined pair to the
- * processing function.
+ * Built on {@link iterateFirestoreDocumentSnapshots}, this adds an automatic document
+ * loading step: each raw snapshot is resolved through the `documentAccessor` to produce
+ * a pair containing both the typed {@link FirestoreDocument} and its snapshot data.
+ * This is the highest-level iteration function — use it when your callback needs
+ * document-level operations (updates, deletes) alongside the snapshot data.
  *
- * @template T - The document data type
- * @template R - The result type of processing each snapshot pair
- * @template D - The FirestoreDocument implementation type (defaults to FirestoreDocument<T>)
- * @param config - Configuration for the iteration, including the document accessor and processing function
- * @returns A promise that resolves to the result of the iteration, including statistics about checkpoints and snapshots processed
+ * @param config - Iteration config including the document accessor and per-pair callback
+ * @returns Checkpoint-level statistics (total checkpoints, snapshots visited, limit status)
+ *
+ * @example
+ * ```typescript
+ * const result = await iterateFirestoreDocumentSnapshotPairs({
+ *   queryFactory,
+ *   constraintsFactory: [where('status', '==', 'pending')],
+ *   limitPerCheckpoint: 100,
+ *   documentAccessor: collection.documentAccessor(),
+ *   iterateSnapshotPair: async (pair) => {
+ *     await pair.document.accessor.set({ ...pair.data, status: 'processed' });
+ *   }
+ * });
+ * ```
  */
 async function iterateFirestoreDocumentSnapshotPairs(config) {
     const { iterateSnapshotPair, documentAccessor } = config;
@@ -3082,16 +3393,32 @@ async function iterateFirestoreDocumentSnapshotPairs(config) {
     });
 }
 /**
- * Iterates through the results of a Firestore query by each document snapshot by itself.
+ * Iterates through Firestore query results, processing each document snapshot individually.
  *
- * This function efficiently handles pagination through potentially large result sets by using
- * the checkpoint system to load documents in batches. Each document snapshot is then processed
- * individually using the provided processing function.
+ * Built on {@link iterateFirestoreDocumentSnapshotBatches} with `maxParallelCheckpoints: 1`,
+ * this unwraps each checkpoint's snapshots and processes them one-by-one via
+ * {@link performAsyncTasks} (sequential by default). Use `snapshotsPerformTasksConfig`
+ * to enable parallel snapshot processing within each checkpoint.
  *
- * @template T - The document data type
- * @template R - The result type of processing each snapshot
- * @param config - Configuration for the iteration, including the snapshot processing function
- * @returns A promise that resolves to the result of the iteration, including statistics about checkpoints and snapshots processed
+ * For document-level operations (needing the typed {@link FirestoreDocument} wrapper),
+ * use {@link iterateFirestoreDocumentSnapshotPairs} instead.
+ *
+ * @param config - Iteration config including the per-snapshot callback
+ * @returns Checkpoint-level statistics (total checkpoints, snapshots visited, limit status)
+ *
+ * @example
+ * ```typescript
+ * const result = await iterateFirestoreDocumentSnapshots({
+ *   queryFactory,
+ *   constraintsFactory: [where('active', '==', true)],
+ *   limitPerCheckpoint: 200,
+ *   totalSnapshotsLimit: 1000,
+ *   iterateSnapshot: async (snapshot) => {
+ *     const data = snapshot.data();
+ *     await externalApi.sync(data);
+ *   }
+ * });
+ * ```
  */
 async function iterateFirestoreDocumentSnapshots(config) {
     const { iterateSnapshot, performTasksConfig, snapshotsPerformTasksConfig } = config;
@@ -3108,10 +3435,32 @@ async function iterateFirestoreDocumentSnapshots(config) {
     });
 }
 /**
- * Iterates through the results of a Firestore query by each FirestoreDocumentSnapshotDataPair.
+ * Iterates through Firestore query results in batches, loading each batch as
+ * {@link FirestoreDocumentSnapshotDataPairWithData} instances before processing.
  *
- * @param config
- * @returns
+ * Built on {@link iterateFirestoreDocumentSnapshotBatches} with `maxParallelCheckpoints: 1`.
+ * Each batch of raw snapshots is resolved through the `documentAccessor` to produce
+ * typed document-snapshot pairs. Use this when you need batch-level operations with
+ * typed document access (e.g., bulk updates, batch writes).
+ *
+ * @param config - Iteration config including the document accessor and per-batch callback
+ * @returns Checkpoint-level statistics (total checkpoints, snapshots visited, limit status)
+ *
+ * @example
+ * ```typescript
+ * const result = await iterateFirestoreDocumentSnapshotPairBatches({
+ *   queryFactory,
+ *   constraintsFactory: [where('needsMigration', '==', true)],
+ *   limitPerCheckpoint: 500,
+ *   batchSize: 50,
+ *   documentAccessor: collection.documentAccessor(),
+ *   iterateSnapshotPairsBatch: async (pairs, batchIndex) => {
+ *     const writeBatch = firestore.batch();
+ *     pairs.forEach((pair) => writeBatch.update(pair.document.documentRef, { migrated: true }));
+ *     await writeBatch.commit();
+ *   }
+ * });
+ * ```
  */
 async function iterateFirestoreDocumentSnapshotPairBatches(config) {
     const { iterateSnapshotPairsBatch, documentAccessor } = config;
@@ -3132,10 +3481,32 @@ async function iterateFirestoreDocumentSnapshotPairBatches(config) {
  */
 const DEFAULT_ITERATE_FIRESTORE_DOCUMENT_SNAPSHOT_BATCHES_BATCH_SIZE = 25;
 /**
- * Iterates through the results of a Firestore query by each document snapshot.
+ * Iterates through Firestore query results by subdividing each checkpoint into smaller batches.
  *
- * @param config
- * @returns
+ * Built on {@link iterateFirestoreDocumentSnapshotCheckpoints}, this function takes each
+ * checkpoint's snapshots and splits them into batches (default size: 25). Batches are
+ * processed via {@link performAsyncTasks}, sequential by default. Use this when operations
+ * have size limits (e.g., Firestore batch writes) or benefit from controlled chunk sizes.
+ *
+ * For per-snapshot processing, use {@link iterateFirestoreDocumentSnapshots}.
+ * For batch processing with typed document pairs, use {@link iterateFirestoreDocumentSnapshotPairBatches}.
+ *
+ * @param config - Iteration config including batch size and per-batch callback
+ * @returns Checkpoint-level statistics (total checkpoints, snapshots visited, limit status)
+ *
+ * @example
+ * ```typescript
+ * const result = await iterateFirestoreDocumentSnapshotBatches({
+ *   queryFactory,
+ *   constraintsFactory: [where('type', '==', 'order')],
+ *   limitPerCheckpoint: 500,
+ *   batchSize: 100,
+ *   iterateSnapshotBatch: async (snapshots, batchIndex) => {
+ *     const data = snapshots.map((s) => s.data());
+ *     await analytics.trackBatch(data);
+ *   }
+ * });
+ * ```
  */
 async function iterateFirestoreDocumentSnapshotBatches(config) {
     const { iterateSnapshotBatch, batchSizeForSnapshots: inputBatchSizeForSnapshots, performTasksConfig, batchSize: inputBatchSize } = config;
@@ -3161,29 +3532,75 @@ async function iterateFirestoreDocumentSnapshotBatches(config) {
     });
 }
 /**
- * Creates a IterateFirestoreDocumentSnapshotCheckpointsFilterCheckpointSnapshotsFunction that filters out any repeat documents.
+ * Creates a checkpoint filter that deduplicates documents across checkpoints.
  *
- * Repeat documents can occur in cases where the document is updated and the query matches it again for a different reason.
- * This utility function creates a filter that prevents processing the same document multiple times.
+ * Repeat documents can appear when a document is updated during iteration and
+ * re-matches the query in a subsequent checkpoint. This factory returns a stateful
+ * filter that tracks seen document keys and removes duplicates.
  *
- * @param readKeyFunction - Function that extracts a unique key from a document snapshot, defaults to document ID
- * @returns A filter function that prevents duplicate document processing
+ * The filter maintains state across checkpoints — use a single instance for the
+ * entire iteration run. Pair with `handleRepeatCursor: false` to also terminate
+ * iteration when cursor-level repeats are detected.
+ *
+ * @param readKeyFunction - Extracts a unique key from each snapshot; defaults to `snapshot.id`
+ * @returns A stateful filter function suitable for `filterCheckpointSnapshots`
+ *
+ * @example
+ * ```typescript
+ * const result = await iterateFirestoreDocumentSnapshotCheckpoints({
+ *   queryFactory,
+ *   constraintsFactory: [orderBy('updatedAt')],
+ *   limitPerCheckpoint: 100,
+ *   filterCheckpointSnapshots: filterRepeatCheckpointSnapshots(),
+ *   handleRepeatCursor: false,
+ *   iterateCheckpoint: async (snapshots) => {
+ *     return snapshots.map((s) => s.data());
+ *   }
+ * });
+ * ```
  */
 function filterRepeatCheckpointSnapshots(readKeyFunction = (x) => x.id) {
     const allowOnceFilter = allowValueOnceFilter(readKeyFunction);
     return async (snapshots) => snapshots.filter(allowOnceFilter);
 }
 /**
- * Iterates through the results of a Firestore query in several batches.
+ * Core cursor-based pagination engine for iterating through Firestore query results.
  *
- * This is the core pagination function that handles cursor-based iteration through
- * potentially large Firestore query results. It manages cursor documents, checkpoint
- * processing, parallel execution, and various limit controls.
+ * This is the foundational function in the Firestore iteration hierarchy. It drives
+ * sequential cursor-based pagination: each "checkpoint" executes a Firestore query,
+ * uses the last document as a `startAfter` cursor for the next query, and passes
+ * results to the `iterateCheckpoint` callback.
  *
- * @template T - The document data type
- * @template R - The result type of the iteration
- * @param config - Complete configuration for the pagination and processing behavior
- * @returns Promise resolving to statistics about the iteration
+ * The iteration loop continues until one of these conditions is met:
+ * - A query returns no results (no more matching documents)
+ * - The `totalSnapshotsLimit` is reached
+ * - A repeat cursor is detected and `handleRepeatCursor` returns `false`
+ * - The effective `limitPerCheckpoint` calculates to 0 remaining
+ *
+ * Higher-level functions build on this:
+ * - {@link iterateFirestoreDocumentSnapshotBatches} — subdivides checkpoints into smaller batches
+ * - {@link iterateFirestoreDocumentSnapshots} — processes one snapshot at a time
+ * - {@link iterateFirestoreDocumentSnapshotPairs} — loads typed document wrappers per snapshot
+ *
+ * @param config - Complete configuration for pagination, processing, and termination behavior
+ * @returns Statistics including total checkpoints executed, snapshots visited, and whether the limit was hit
+ *
+ * @example
+ * ```typescript
+ * const result = await iterateFirestoreDocumentSnapshotCheckpoints({
+ *   queryFactory,
+ *   constraintsFactory: [where('createdAt', '<=', cutoffDate), orderBy('createdAt')],
+ *   limitPerCheckpoint: 200,
+ *   totalSnapshotsLimit: 5000,
+ *   handleRepeatCursor: false,
+ *   iterateCheckpoint: async (snapshots, querySnapshot) => {
+ *     return snapshots.map((s) => ({ id: s.id, data: s.data() }));
+ *   },
+ *   useCheckpointResult: (result) => {
+ *     console.log(`Checkpoint ${result.i}: processed ${result.docSnapshots.length} docs`);
+ *   }
+ * });
+ * ```
  */
 async function iterateFirestoreDocumentSnapshotCheckpoints(config) {
     const { iterateCheckpoint, filterCheckpointSnapshots: inputFilterCheckpointSnapshot, handleRepeatCursor: inputHandleRepeatCursor, waitBetweenCheckpoints, useCheckpointResult, constraintsFactory: inputConstraintsFactory, dynamicConstraints: inputDynamicConstraints, queryFactory, maxParallelCheckpoints = 1, limitPerCheckpoint: inputLimitPerCheckpoint, totalSnapshotsLimit: inputTotalSnapshotsLimit } = config;
@@ -3286,13 +3703,20 @@ async function iterateFirestoreDocumentSnapshotCheckpoints(config) {
 }
 // MARK: Utility
 /**
- * Creates a filter that allows each document snapshot to be processed only once based on its path.
+ * Creates a stateful filter that allows each document snapshot through only once,
+ * keyed by its full Firestore model path.
  *
- * This utility helps prevent duplicate processing of documents by tracking which ones have
- * already been seen based on their path.
+ * Unlike {@link filterRepeatCheckpointSnapshots} which uses document ID by default,
+ * this filter uses the full document path ({@link readFirestoreModelKeyFromDocumentSnapshot}),
+ * making it suitable for cross-collection iteration where document IDs alone may collide.
  *
- * @template T - The document snapshot type
- * @returns A filter function that only allows each unique document to pass once
+ * @returns A reusable filter function that passes each unique document path exactly once
+ *
+ * @example
+ * ```typescript
+ * const onceFilter = allowDocumentSnapshotWithPathOnceFilter();
+ * const uniqueSnapshots = allSnapshots.filter(onceFilter);
+ * ```
  */
 function allowDocumentSnapshotWithPathOnceFilter() {
     return allowValueOnceFilter(readFirestoreModelKeyFromDocumentSnapshot);
@@ -9249,5 +9673,5 @@ function systemStateFirestoreCollection(firestoreContext, converters) {
     });
 }
 
-export { ALL_STORAGE_FILE_NOTIFICATION_TASK_TYPES, ALL_USER_UPLOADS_FOLDER_NAME, ALL_USER_UPLOADS_FOLDER_PATH, AbstractFirestoreDocument, AbstractFirestoreDocumentDataAccessorWrapper, AbstractFirestoreDocumentWithParent, AbstractSubscribeOrUnsubscribeToNotificationBoxParams, AbstractSubscribeToNotificationBoxParams, AppNotificationTemplateTypeInfoRecordService, BASE_MODEL_STORAGE_FILE_PATH, CALL_MODEL_APP_FUNCTION_KEY, COPY_USER_RELATED_DATA_ACCESSOR_FACTORY_FUNCTION, CREATE_NOTIFICATION_ID_REQUIRED_ERROR_CODE, CleanupSentNotificationsParams, ContextGrantedModelRolesReaderInstance, CreateNotificationBoxParams, CreateNotificationSummaryParams, CreateNotificationUserParams, CreateStorageFileGroupParams, CreateStorageFileParams, DBX_FIREBASE_SERVER_NO_AUTH_ERROR_CODE, DBX_FIREBASE_SERVER_NO_UID_ERROR_CODE, DEFAULT_DATE_CELL_RANGE_VALUE, DEFAULT_FIRESTORE_DATE_CELL_SCHEDULE_VALUE, DEFAULT_FIRESTORE_ITEM_PAGE_ITERATOR_ITEMS_PER_PAGE, DEFAULT_FIRESTORE_STRING_FIELD_VALUE, DEFAULT_FIRESTORE_UNITED_STATES_ADDRESS_VALUE, DEFAULT_FIRESTORE_WEBSITE_FILE_LINK_VALUE, DEFAULT_ITERATE_FIRESTORE_DOCUMENT_SNAPSHOT_BATCHES_BATCH_SIZE, DEFAULT_NOTIFICATION_TASK_NOTIFICATION_MODEL_KEY, DEFAULT_NOTIFICATION_TASK_SUBTASK_CLEANUP_RETRY_ATTEMPTS, DEFAULT_NOTIFICATION_TASK_SUBTASK_CLEANUP_RETRY_DELAY, DEFAULT_NOTIFICATION_TEMPLATE_TYPE, DEFAULT_QUERY_CHANGE_WATCHER_DELAY, DEFAULT_SINGLE_ITEM_FIRESTORE_COLLECTION_DOCUMENT_IDENTIFIER, DEFAULT_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL, DEFAULT_WEBSITE_LINK, DeleteAllQueuedStorageFilesParams, DeleteStorageFileParams, DownloadStorageFileParams, EMPTY_STORAGE_FILE_PURPOSE_SUBGROUP, EXACT_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL, FIREBASE_AUTH_NETWORK_REQUEST_ERROR, FIREBASE_AUTH_NETWORK_REQUEST_FAILED, FIREBASE_AUTH_PASSWORD_MAX_LENGTH, FIREBASE_AUTH_PASSWORD_MIN_LENGTH, FIREBASE_AUTH_USER_NOT_FOUND_ERROR, FIREBASE_AUTH_WRONG_PASSWORD, FIREBASE_DEVELOPMENT_FUNCTIONS_MAP_KEY, FIREBASE_SERVER_AUTH_CLAIMS_RESET_LAST_COM_DATE_KEY, FIREBASE_SERVER_AUTH_CLAIMS_RESET_PASSWORD_KEY, FIREBASE_SERVER_AUTH_CLAIMS_SETUP_LAST_COM_DATE_KEY, FIREBASE_SERVER_AUTH_CLAIMS_SETUP_PASSWORD_KEY, FIRESTORE_CLIENT_QUERY_CONSTRAINT_HANDLER_MAPPING, FIRESTORE_COLLECTION_NAME_SEPARATOR, FIRESTORE_DUMMY_MODEL_KEY, FIRESTORE_EMPTY_VALUE, FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_AT_VALUE_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE, FIRESTORE_ITEM_PAGE_ITERATOR, FIRESTORE_ITEM_PAGE_ITERATOR_DELEGATE, FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE, FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE, FIRESTORE_MAX_WHERE_IN_FILTER_ARGS_COUNT, FIRESTORE_MODEL_ID_REGEX, FIRESTORE_MODEL_KEY_REGEX, FIRESTORE_MODEL_KEY_REGEX_STRICT, FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE, FIRESTORE_ORDER_BY_DOCUMENT_ID_QUERY_CONSTRAINT_TYPE, FIRESTORE_ORDER_BY_QUERY_CONSTRAINT_TYPE, FIRESTORE_PASSTHROUGH_FIELD, FIRESTORE_PERMISSION_DENIED_ERROR_CODE, FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AT_VALUE_QUERY_CONSTRAINT_TYPE, FIRESTORE_WHERE_DOCUMENT_ID_QUERY_CONSTRAINT_TYPE, FIRESTORE_WHERE_QUERY_CONSTRAINT_TYPE, FirebaseDevelopmentFunctions, FirebaseModelPermissionServiceInstance, FirebaseServerError, FirestoreAccessorStreamMode, FirestoreDocumentContextType, HIGH_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL, InferredTargetModelIdParams, InferredTargetModelParams, InitializeAllApplicableNotificationBoxesParams, InitializeAllApplicableNotificationSummariesParams, InitializeAllApplicableStorageFileGroupsParams, InitializeAllStorageFilesFromUploadsParams, InitializeNotificationModelParams, InitializeStorageFileFromUploadParams, InitializeStorageFileModelParams, IsFirestoreModelId, IsFirestoreModelIdOrKey, IsFirestoreModelKey, LOW_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL, MAX_FIRESTORE_MAP_ZOOM_LEVEL_VALUE, MIN_FIRESTORE_MAP_ZOOM_LEVEL_VALUE, MODEL_FUNCTION_FIREBASE_CRUD_FUNCTION_SPECIFIER_DEFAULT, MODEL_FUNCTION_FIREBASE_CRUD_FUNCTION_SPECIFIER_SPLITTER, MODEL_STORAGE_FILE_SLASH_PATH_FACTORY, ModifyBeforeSetFirestoreDocumentDataAccessorWrapper, NOTIFICATION_BOX_DOES_NOT_EXIST_ERROR_CODE, NOTIFICATION_BOX_EXCLUSION_TARGET_INVALID_ERROR_CODE, NOTIFICATION_BOX_EXISTS_FOR_MODEL_ERROR_CODE, NOTIFICATION_BOX_RECIPIENT_DOES_NOT_EXIST_ERROR_CODE, NOTIFICATION_MESSAGE_MAX_LENGTH, NOTIFICATION_MESSAGE_MIN_LENGTH, NOTIFICATION_MODEL_ALREADY_INITIALIZED_ERROR_CODE, NOTIFICATION_RECIPIENT_NAME_MAX_LENGTH, NOTIFICATION_RECIPIENT_NAME_MIN_LENGTH, NOTIFICATION_SUBJECT_MAX_LENGTH, NOTIFICATION_SUBJECT_MIN_LENGTH, NOTIFICATION_SUMMARY_EMBEDDED_NOTIFICATION_ITEM_MESSAGE_MAX_LENGTH, NOTIFICATION_SUMMARY_EMBEDDED_NOTIFICATION_ITEM_SUBJECT_MAX_LENGTH, NOTIFICATION_SUMMARY_ITEM_LIMIT, NOTIFICATION_TASK_SUBTASK_CHECKPOINT_CLEANUP, NOTIFICATION_TASK_SUBTASK_CHECKPOINT_PROCESSING, NOTIFICATION_USER_BLOCKED_FROM_BEING_ADD_TO_RECIPIENTS_ERROR_CODE, NOTIFICATION_USER_INVALID_UID_FOR_CREATE_ERROR_CODE, NOTIFICATION_USER_LOCKED_CONFIG_FROM_BEING_UPDATED_ERROR_CODE, NOTIFICATION_WEEK_NOTIFICATION_ITEM_LIMIT, NotificationBoxDocument, NotificationBoxRecipientFlag, NotificationBoxRecipientTemplateConfigArrayEntryParam, NotificationBoxRecipientTemplateConfigBoolean, NotificationDocument, NotificationFirestoreCollections, NotificationFunctions, NotificationMessageFlag, NotificationRecipientParams, NotificationRecipientSendFlag, NotificationSendState, NotificationSendType, NotificationSummaryDocument, NotificationUserDocument, NotificationWeekDocument, ProcessAllQueuedStorageFilesParams, ProcessStorageFileParams, RUN_DEV_FUNCTION_APP_FUNCTION_KEY, RegenerateAllFlaggedStorageFileGroupsContentParams, RegenerateStorageFileGroupContentParams, ResyncAllNotificationUserParams, ResyncNotificationUserParams, SCHEDULED_FUNCTION_DEV_FUNCTION_SPECIFIER, STORAGEFILE_RELATED_FILE_METADATA_KEY, STORAGE_FILE_ALREADY_PROCESSED_ERROR_CODE, STORAGE_FILE_CANNOT_BE_DELETED_YET_ERROR_CODE, STORAGE_FILE_GROUP_CREATE_INPUT_ERROR_CODE, STORAGE_FILE_GROUP_QUEUED_FOR_INITIALIZATION_ERROR_CODE, STORAGE_FILE_GROUP_ROOT_FOLDER_PATH, STORAGE_FILE_GROUP_ZIP_FILE_PATH, STORAGE_FILE_GROUP_ZIP_INFO_JSON_FILE_NAME, STORAGE_FILE_GROUP_ZIP_STORAGE_FILE_PURPOSE, STORAGE_FILE_GROUP_ZIP_STORAGE_FILE_PURPOSE_CREATE_ZIP_SUBTASK, STORAGE_FILE_MODEL_ALREADY_INITIALIZED_ERROR_CODE, STORAGE_FILE_NOT_FLAGGED_FOR_DELETION_ERROR_CODE, STORAGE_FILE_NOT_FLAGGED_FOR_GROUPS_SYNC_ERROR_CODE, STORAGE_FILE_PROCESSING_NOTIFICATION_TASK_TYPE, STORAGE_FILE_PROCESSING_NOT_ALLOWED_FOR_INVALID_STATE_ERROR_CODE, STORAGE_FILE_PROCESSING_NOT_AVAILABLE_FOR_TYPE_ERROR_CODE, STORAGE_FILE_PROCESSING_NOT_QUEUED_FOR_PROCESSING_ERROR_CODE, STORAGE_FILE_PROCESSING_STUCK_THROTTLE_CHECK_MS, STORAGE_FILE_UPLOAD_USER_ROLE, ScheduledFunctionDevelopmentFirebaseFunctionListEntry, ScheduledFunctionDevelopmentFirebaseFunctionParams, ScheduledFunctionDevelopmentFunctionTypeEnum, SendNotificationParams, SendQueuedNotificationsParams, StorageFileCreationType, StorageFileDocument, StorageFileFirestoreCollections, StorageFileFunctions, StorageFileGroupDocument, StorageFileProcessingState, StorageFileState, StorageFileUploadStreamUnsupportedError, SyncAllFlaggedStorageFilesWithGroupsParams, SyncStorageFileWithGroupsParams, SystemStateDocument, SystemStateFirestoreCollections, TargetModelIdParams, TargetModelParams, UPLOADED_FILE_DOES_NOT_EXIST_ERROR_CODE, UPLOADED_FILE_INITIALIZATION_DISCARDED_ERROR_CODE, UPLOADED_FILE_INITIALIZATION_FAILED_ERROR_CODE, UPLOADED_FILE_NOT_ALLOWED_TO_BE_INITIALIZED_ERROR_CODE, UPLOADS_FOLDER_PATH, UpdateNotificationBoxParams, UpdateNotificationBoxRecipientLikeParams, UpdateNotificationBoxRecipientParams, UpdateNotificationSummaryParams, UpdateNotificationUserDefaultNotificationBoxRecipientConfigParams, UpdateNotificationUserNotificationBoxRecipientParams, UpdateNotificationUserParams, UpdateStorageFileGroupEntryParams, UpdateStorageFileGroupParams, UpdateStorageFileParams, _createNotificationDocumentFromPair, addConstraintToBuilder, addOrReplaceLimitInConstraints, allChildDocumentsUnderParent, allChildDocumentsUnderParentPath, allChildDocumentsUnderRelativePath, allowDocumentSnapshotWithPathOnceFilter, allowedNotificationRecipients, appNotificationTemplateTypeInfoRecordService, applyExclusionsToNotificationUserNotificationBoxRecipientConfigs, arrayUpdateWithAccessorFunction, asTopLevelFieldPath, asTopLevelFieldPaths, assertFirestoreUpdateHasData, assertStorageUploadOptionsStringFormat, assignDateCellRangeFunction, assignDateCellScheduleFunction, assignUnitedStatesAddressFunction, assignWebsiteFileLinkFunction, assignWebsiteLinkFunction, buildFirebaseCollectionTypeModelTypeMap, calculateNsForNotificationUserNotificationBoxRecipientConfigs, calculateStorageFileGroupEmbeddedFileUpdate, calculateStorageFileGroupRegeneration, callModelFirebaseFunctionMapFactory, canQueueStorageFileForProcessing, childFirestoreModelKey, childFirestoreModelKeyPath, childFirestoreModelKeys, clientFirebaseFirestoreContextFactory, clientFirebaseStorageContextFactory, combineUploadFileTypeDeterminers, completeSubtaskProcessingAndScheduleCleanupTaskResult, contextGrantedModelRolesReader, contextGrantedModelRolesReaderDoesNotExistErrorMessage, contextGrantedModelRolesReaderPermissionErrorMessage, convertHttpsCallableErrorToReadableError, copyDocumentIdForUserRelatedModifierFunction, copyDocumentIdToFieldModifierFunction, copyStoragePath, copyUserRelatedDataAccessorFactoryFunction, copyUserRelatedDataModifierConfig, createNotificationDocument, createNotificationDocumentIfSending, createNotificationDocumentPair, createNotificationTaskTemplate, createNotificationTemplate, createStorageFileDocumentPair, createStorageFileDocumentPairFactory, dataFromDocumentSnapshots, dataFromSnapshotStream, delayCompletion, determineByFileName, determineByFilePath, determineByFolderName, determineUserByFolder, determineUserByFolderWrapperFunction, determineUserByUserUploadsFolderWrapperFunction, developmentFirebaseFunctionMapFactory, directDataHttpsCallable, documentData, documentDataFunction, documentDataWithIdAndKey, documentReferenceFromDocument, documentReferencesFromDocuments, documentReferencesFromSnapshot, effectiveNotificationBoxRecipientConfig, effectiveNotificationBoxRecipientTemplateConfig, endAt, endAtValue, endBefore, extendFirestoreCollectionWithSingleDocumentAccessor, filterConstraintsOfType, filterDisallowedFirestoreItemPageIteratorInputConstraints, filterRepeatCheckpointSnapshots, filterWithDateRange, firebaseAuthErrorToReadableError, firebaseFirestoreClientDrivers, firebaseFirestoreQueryConstraintFunctionsDriver, firebaseFirestoreQueryDriver, firebaseFunctionMapFactory, firebaseModelLoader, firebaseModelPermissionService, firebaseModelService, firebaseModelServiceFactory, firebaseModelsService, firebaseQueryItemAccumulator, firebaseQuerySnapshotAccumulator, firebaseStorageBucketFolderPath, firebaseStorageClientAccessorDriver, firebaseStorageClientAccessorFile, firebaseStorageClientAccessorFolder, firebaseStorageClientDrivers, firebaseStorageClientListFilesResultFactory, firebaseStorageContextFactory, firebaseStorageFileExists, firebaseStorageFilePathFromStorageFilePath, firebaseStorageRefForStorageFilePath, firestoreArray, firestoreArrayMap, firestoreBitwiseObjectMap, firestoreBitwiseSet, firestoreBitwiseSetMap, firestoreBoolean, firestoreClientAccessorDriver, firestoreClientArrayUpdateToUpdateData, firestoreClientIncrementUpdateToUpdateData, firestoreCollectionQueryFactory, firestoreContextFactory, firestoreDate, firestoreDateCellRange, firestoreDateCellRangeArray, firestoreDateCellRangeAssignFn, firestoreDateCellSchedule, firestoreDateCellScheduleAssignFn, firestoreDateNumber, firestoreDencoderArray, firestoreDencoderMap, firestoreDencoderStringArray, firestoreDocumentAccessorContextExtension, firestoreDocumentAccessorFactory, firestoreDocumentLoader, firestoreDocumentSnapshotPairsLoader, firestoreDocumentSnapshotPairsLoaderInstance, firestoreDummyKey, firestoreEncodedArray, firestoreEncodedObjectMap, firestoreEnum, firestoreEnumArray, firestoreField, firestoreFieldConfigToModelMapFunctionsRef, firestoreFixedItemPageIteration, firestoreFixedItemPageIterationFactory, firestoreIdBatchVerifierFactory, firestoreIdentityTypeArray, firestoreIdentityTypeArrayName, firestoreItemPageIteration, firestoreItemPageIterationFactory, firestoreLatLngString, firestoreMap, firestoreMapZoomLevel, firestoreModelId, firestoreModelIdArrayField, firestoreModelIdFromDocument, firestoreModelIdFromEmail, firestoreModelIdGrantedRoleArrayMap, firestoreModelIdGrantedRoleMap, firestoreModelIdString, firestoreModelIdentity, firestoreModelIdentityTypeMap, firestoreModelIdsFromDocuments, firestoreModelIdsFromKey, firestoreModelKey, firestoreModelKeyArrayField, firestoreModelKeyCollectionName, firestoreModelKeyCollectionType, firestoreModelKeyCollectionTypeArray, firestoreModelKeyCollectionTypeArrayName, firestoreModelKeyCollectionTypePair, firestoreModelKeyEncodedGrantedRoleMap, firestoreModelKeyFactory, firestoreModelKeyFromDocument, firestoreModelKeyGrantedRoleArrayMap, firestoreModelKeyGrantedRoleMap, firestoreModelKeyPairObject, firestoreModelKeyParentKey, firestoreModelKeyParentKeyPartPairs, firestoreModelKeyPart, firestoreModelKeyPartPairs, firestoreModelKeyPartPairsKeyPath, firestoreModelKeyPartPairsPaths, firestoreModelKeyPath, firestoreModelKeyString, firestoreModelKeyTypePair, firestoreModelKeys, firestoreModelKeysFromDocuments, firestoreModelType, firestoreNotificationBoxRecipient, firestoreNotificationBoxRecipientTemplateConfigRecord, firestoreNotificationItem, firestoreNotificationRecipientWithConfig, firestoreNotificationUserDefaultNotificationBoxRecipientConfig, firestoreNotificationUserNotificationBoxRecipientConfig, firestoreNumber, firestoreObjectArray, firestorePassThroughField, firestoreQueryConstraint, firestoreQueryConstraintFactory, firestoreQueryDocumentSnapshotPairsLoader, firestoreQueryFactory, firestoreSingleDocumentAccessor, firestoreString, firestoreSubObject, firestoreTimezoneString, firestoreUID, firestoreUniqueArray, firestoreUniqueKeyedArray, firestoreUniqueNumberArray, firestoreUniqueStringArray, firestoreUnitedStatesAddress, firestoreUnitedStatesAddressAssignFn, firestoreUnixDateTimeSecondsNumber, firestoreUpdateWithNoDataError, firestoreWebsiteFileLink, firestoreWebsiteFileLinkAssignFn, firestoreWebsiteFileLinkEncodedArray, firestoreWebsiteFileLinkObjectArray, firestoreWebsiteLink, firestoreWebsiteLinkArray, firestoreWebsiteLinkAssignFn, flatFirestoreModelKey, getDataFromDocumentSnapshots, getDocumentSnapshotData, getDocumentSnapshotDataPair, getDocumentSnapshotDataPairs, getDocumentSnapshotDataPairsWithData, getDocumentSnapshotDataTuples, getDocumentSnapshotPair, getDocumentSnapshotPairs, getDocumentSnapshots, getDocumentSnapshotsData, grantFullAccessIfAdmin, grantFullAccessIfAuthUserRelated, grantModelRolesIfAdmin, grantModelRolesIfAdminFunction, grantModelRolesIfAuthUserRelatedModelFunction, grantModelRolesIfFunction, grantModelRolesIfHasAuthRolesFactory, grantModelRolesIfHasAuthRolesFunction, grantModelRolesOnlyIfFunction, grantStorageFileRolesForUserAuthFunction, inContextFirebaseModelServiceFactory, inContextFirebaseModelsServiceFactory, incrementUpdateWithAccessorFunction, inferKeyFromTwoWayFlatFirestoreModelKey, inferNotificationBoxRelatedModelKey, inferStorageFileGroupRelatedModelKey, interceptAccessorFactoryFunction, isAdminInFirebaseModelContext, isClientFirebaseError, isCompleteNotificationSendState, isFirebaseStorageObjectNotFoundError, isFirestoreModelId, isFirestoreModelIdOrKey, isFirestoreModelKey, isOwnerOfUserRelatedModelInFirebaseModelContext, iterateFirestoreDocumentSnapshotBatches, iterateFirestoreDocumentSnapshotCheckpoints, iterateFirestoreDocumentSnapshotPairBatches, iterateFirestoreDocumentSnapshotPairs, iterateFirestoreDocumentSnapshots, iterateStorageListFiles, iterateStorageListFilesByEachFile, iterateStorageListFilesFactory, iterationQueryDocChangeWatcher, iterationQueryDocChangeWatcherChangeTypeForGroup, latestDataFromDocuments, latestSnapshotsFromDocuments, lazyFirebaseFunctionsFactory, limit, limitToLast, limitUploadFileTypeDeterminer, limitedFirestoreDocumentAccessorFactory, loadAllFirestoreDocumentSnapshot, loadAllFirestoreDocumentSnapshotPairs, loadDocumentsForDocumentReferences, loadDocumentsForDocumentReferencesFromValues, loadDocumentsForIds, loadDocumentsForIdsFromValues, loadDocumentsForKeys, loadDocumentsForKeysFromValues, loadDocumentsForSnapshots, loadDocumentsForValues, loadNotificationBoxDocumentForReferencePair, loadStorageFileGroupDocumentForReferencePair, makeDocuments, makeFirestoreCollection, makeFirestoreCollectionGroup, makeFirestoreCollectionWithParent, makeFirestoreItemPageIteratorDelegate, makeFirestoreQueryConstraintFunctionsDriver, makeRootSingleItemFirestoreCollection, makeSingleItemFirestoreCollection, mapDataFromSnapshot, mapHttpsCallable, mergeNotificationBoxRecipientTemplateConfigRecords, mergeNotificationBoxRecipientTemplateConfigs, mergeNotificationBoxRecipients, mergeNotificationSendMessagesResult, mergeNotificationUserDefaultNotificationBoxRecipientConfig, mergeNotificationUserNotificationBoxRecipientConfigs, modelStorageSlashPathFactory, modifyBeforeSetInterceptAccessorFactoryFunction, newDocuments, newNotificationBoxRecipientForUid, noContentNotificationMessageFunctionFactory, noStringFormatInStorageUploadOptionsError, notificationBoxCollectionReference, notificationBoxConverter, notificationBoxFirestoreCollection, notificationBoxIdForModel, notificationBoxIdentity, notificationBoxModelCrudFunctionsConfig, notificationBoxRecipientTemplateConfigArrayToRecord, notificationBoxRecipientTemplateConfigRecordToArray, notificationBoxesFlaggedForNeedsInitializationQuery, notificationBoxesFlaggedInvalidQuery, notificationCollectionReference, notificationCollectionReferenceFactory, notificationConverter, notificationFirestoreCollectionFactory, notificationFirestoreCollectionGroup, notificationFunctionMap, notificationFunctionTypeConfigMap, notificationIdentity, notificationMessageFunction, notificationSendExclusionCanSendFunction, notificationSendFlagsImplyIsComplete, notificationSubtaskComplete, notificationSummariesFlaggedForNeedsInitializationQuery, notificationSummaryCollectionReference, notificationSummaryConverter, notificationSummaryFirestoreCollection, notificationSummaryIdForModel, notificationSummaryIdForUidFunctionForRootFirestoreModelIdentity, notificationSummaryIdentity, notificationTaskCanRunNextCheckpoint, notificationTaskComplete, notificationTaskDelayRetry, notificationTaskFailed, notificationTaskPartiallyComplete, notificationTaskUniqueId, notificationTemplateTypeInfoRecord, notificationUserCollectionReference, notificationUserConverter, notificationUserFirestoreCollection, notificationUserHasExclusionQuery, notificationUserIdentity, notificationUsersFlaggedForNeedsSyncQuery, notificationWeekCollectionReference, notificationWeekCollectionReferenceFactory, notificationWeekConverter, notificationWeekFirestoreCollectionFactory, notificationWeekFirestoreCollectionGroup, notificationWeekIdentity, notificationsPastSendAtTimeQuery, notificationsReadyForCleanupQuery, offset, onCallCreateModelParams, onCallCreateModelResult, onCallCreateModelResultWithDocs, onCallDeleteModelParams, onCallDevelopmentParams, onCallReadModelParams, onCallTypedModelParams, onCallTypedModelParamsFunction, onCallUpdateModelParams, optionalFirestoreArray, optionalFirestoreBoolean, optionalFirestoreDate, optionalFirestoreDateNumber, optionalFirestoreEnum, optionalFirestoreField, optionalFirestoreNumber, optionalFirestoreString, optionalFirestoreUID, optionalFirestoreUnitedStatesAddress, optionalFirestoreUnixDateTimeSecondsNumber, orderBy, orderByDocumentId, readFirestoreModelKey, readFirestoreModelKeyFromDocumentSnapshot, replaceConstraints, selectFromFirebaseModelsService, separateConstraints, setIdAndKeyFromKeyIdRefOnDocumentData, setIdAndKeyFromSnapshotOnDocumentData, shouldSaveNotificationToNotificationWeek, shouldSendCreatedNotificationInput, snapshotConverterFunctions, snapshotStreamDataForAccessor, snapshotStreamForAccessor, sortNotificationItemsFunction, startAfter, startAt, startAtValue, storageFileCollectionReference, storageFileConverter, storageFileFirestoreCollection, storageFileFlaggedForSyncWithGroupsQuery, storageFileFunctionMap, storageFileFunctionTypeConfigMap, storageFileGroupCollectionReference, storageFileGroupConverter, storageFileGroupCreateStorageFileKeyFactory, storageFileGroupCreatedStorageFileKey, storageFileGroupEmbeddedFile, storageFileGroupFirestoreCollection, storageFileGroupFolderPath, storageFileGroupIdForModel, storageFileGroupIdentity, storageFileGroupZipFileStoragePath, storageFileGroupZipStorageFileKey, storageFileGroupsFlaggedForContentRegenerationQuery, storageFileGroupsFlaggedForNeedsInitializationQuery, storageFileGroupsFlaggedInvalidQuery, storageFileIdentity, storageFileModelCrudFunctionsConfig, storageFileProcessingNotificationTaskTemplate, storageFilePurposeAndUserQuery, storageFileUploadUserSimpleClaimsConfiguration, storageFilesQueuedForDeleteQuery, storageFilesQueuedForProcessingQuery, storageListFilesResultFactory, storageListFilesResultHasNoNextError, storagePathFactory, storedFileReaderFactory, streamFromOnSnapshot, systemStateCollectionReference, systemStateConverter, systemStateFirestoreCollection, systemStateIdentity, twoWayFlatFirestoreModelKey, unreadNotificationItems, unsupportedFirestoreDriverFunctionError, updateNotificationBoxRecipientTemplateConfigRecord, updateNotificationRecipient, updateNotificationUserDefaultNotificationBoxRecipientConfig, updateNotificationUserNotificationBoxRecipientConfigIfChanged, updateNotificationUserNotificationBoxRecipientConfigs, updateNotificationUserNotificationSendExclusions, updateWithAccessorUpdateAndConverterFunction, uploadFileWithStream, useContextAuth, useContextAuthUid, useDocumentSnapshot, useDocumentSnapshotData, useFirebaseModelsService, userUploadsFolderSlashPathFactory, userUploadsFolderStoragePathFactory, where, whereDateIsAfter, whereDateIsAfterWithSort, whereDateIsBefore, whereDateIsBeforeWithSort, whereDateIsBetween, whereDateIsInRange, whereDateIsOnOrAfter, whereDateIsOnOrAfterWithSort, whereDateIsOnOrBefore, whereDateIsOnOrBeforeWithSort, whereDocumentId, whereStringHasRootIdentityModelKey, whereStringValueHasPrefix };
+export { ALL_STORAGE_FILE_NOTIFICATION_TASK_TYPES, ALL_USER_UPLOADS_FOLDER_NAME, ALL_USER_UPLOADS_FOLDER_PATH, AbstractFirestoreDocument, AbstractFirestoreDocumentDataAccessorWrapper, AbstractFirestoreDocumentWithParent, AbstractSubscribeOrUnsubscribeToNotificationBoxParams, AbstractSubscribeToNotificationBoxParams, AppNotificationTemplateTypeInfoRecordService, BASE_MODEL_STORAGE_FILE_PATH, CALL_MODEL_APP_FUNCTION_KEY, COPY_USER_RELATED_DATA_ACCESSOR_FACTORY_FUNCTION, CREATE_NOTIFICATION_ID_REQUIRED_ERROR_CODE, CleanupSentNotificationsParams, ContextGrantedModelRolesReaderInstance, CreateNotificationBoxParams, CreateNotificationSummaryParams, CreateNotificationUserParams, CreateStorageFileGroupParams, CreateStorageFileParams, DBX_FIREBASE_SERVER_NO_AUTH_ERROR_CODE, DBX_FIREBASE_SERVER_NO_UID_ERROR_CODE, DEFAULT_DATE_CELL_RANGE_VALUE, DEFAULT_FIRESTORE_DATE_CELL_SCHEDULE_VALUE, DEFAULT_FIRESTORE_ITEM_PAGE_ITERATOR_ITEMS_PER_PAGE, DEFAULT_FIRESTORE_STRING_FIELD_VALUE, DEFAULT_FIRESTORE_UNITED_STATES_ADDRESS_VALUE, DEFAULT_FIRESTORE_WEBSITE_FILE_LINK_VALUE, DEFAULT_ITERATE_FIRESTORE_DOCUMENT_SNAPSHOT_BATCHES_BATCH_SIZE, DEFAULT_NOTIFICATION_TASK_NOTIFICATION_MODEL_KEY, DEFAULT_NOTIFICATION_TASK_SUBTASK_CLEANUP_RETRY_ATTEMPTS, DEFAULT_NOTIFICATION_TASK_SUBTASK_CLEANUP_RETRY_DELAY, DEFAULT_NOTIFICATION_TEMPLATE_TYPE, DEFAULT_QUERY_CHANGE_WATCHER_DELAY, DEFAULT_SINGLE_ITEM_FIRESTORE_COLLECTION_DOCUMENT_IDENTIFIER, DEFAULT_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL, DEFAULT_WEBSITE_LINK, DeleteAllQueuedStorageFilesParams, DeleteStorageFileParams, DownloadStorageFileParams, EMPTY_STORAGE_FILE_PURPOSE_SUBGROUP, EXACT_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL, FIREBASE_AUTH_NETWORK_REQUEST_ERROR, FIREBASE_AUTH_NETWORK_REQUEST_FAILED, FIREBASE_AUTH_PASSWORD_MAX_LENGTH, FIREBASE_AUTH_PASSWORD_MIN_LENGTH, FIREBASE_AUTH_USER_NOT_FOUND_ERROR, FIREBASE_AUTH_WRONG_PASSWORD, FIREBASE_DEVELOPMENT_FUNCTIONS_MAP_KEY, FIREBASE_SERVER_AUTH_CLAIMS_RESET_LAST_COM_DATE_KEY, FIREBASE_SERVER_AUTH_CLAIMS_RESET_PASSWORD_KEY, FIREBASE_SERVER_AUTH_CLAIMS_SETUP_LAST_COM_DATE_KEY, FIREBASE_SERVER_AUTH_CLAIMS_SETUP_PASSWORD_KEY, FIRESTORE_CLIENT_QUERY_CONSTRAINT_HANDLER_MAPPING, FIRESTORE_COLLECTION_NAME_SEPARATOR, FIRESTORE_DUMMY_MODEL_KEY, FIRESTORE_EMPTY_VALUE, FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_AT_VALUE_QUERY_CONSTRAINT_TYPE, FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE, FIRESTORE_ITEM_PAGE_ITERATOR, FIRESTORE_ITEM_PAGE_ITERATOR_DELEGATE, FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE, FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE, FIRESTORE_MAX_WHERE_IN_FILTER_ARGS_COUNT, FIRESTORE_MODEL_ID_REGEX, FIRESTORE_MODEL_KEY_REGEX, FIRESTORE_MODEL_KEY_REGEX_STRICT, FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE, FIRESTORE_ORDER_BY_DOCUMENT_ID_QUERY_CONSTRAINT_TYPE, FIRESTORE_ORDER_BY_QUERY_CONSTRAINT_TYPE, FIRESTORE_PASSTHROUGH_FIELD, FIRESTORE_PERMISSION_DENIED_ERROR_CODE, FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE, FIRESTORE_START_AT_VALUE_QUERY_CONSTRAINT_TYPE, FIRESTORE_WHERE_DOCUMENT_ID_QUERY_CONSTRAINT_TYPE, FIRESTORE_WHERE_QUERY_CONSTRAINT_TYPE, FirebaseDevelopmentFunctions, FirebaseModelPermissionServiceInstance, FirebaseServerError, FirestoreAccessorStreamMode, FirestoreDocumentContextType, HIGH_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL, InferredTargetModelIdParams, InferredTargetModelParams, InitializeAllApplicableNotificationBoxesParams, InitializeAllApplicableNotificationSummariesParams, InitializeAllApplicableStorageFileGroupsParams, InitializeAllStorageFilesFromUploadsParams, InitializeNotificationModelParams, InitializeStorageFileFromUploadParams, InitializeStorageFileModelParams, IsFirestoreModelId, IsFirestoreModelIdOrKey, IsFirestoreModelKey, LOW_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL, MAX_FIRESTORE_MAP_ZOOM_LEVEL_VALUE, MIN_FIRESTORE_MAP_ZOOM_LEVEL_VALUE, MODEL_FUNCTION_FIREBASE_CRUD_FUNCTION_SPECIFIER_DEFAULT, MODEL_FUNCTION_FIREBASE_CRUD_FUNCTION_SPECIFIER_SPLITTER, MODEL_STORAGE_FILE_SLASH_PATH_FACTORY, ModifyBeforeSetFirestoreDocumentDataAccessorWrapper, NOTIFICATION_BOX_DOES_NOT_EXIST_ERROR_CODE, NOTIFICATION_BOX_EXCLUSION_TARGET_INVALID_ERROR_CODE, NOTIFICATION_BOX_EXISTS_FOR_MODEL_ERROR_CODE, NOTIFICATION_BOX_RECIPIENT_DOES_NOT_EXIST_ERROR_CODE, NOTIFICATION_MESSAGE_MAX_LENGTH, NOTIFICATION_MESSAGE_MIN_LENGTH, NOTIFICATION_MODEL_ALREADY_INITIALIZED_ERROR_CODE, NOTIFICATION_RECIPIENT_NAME_MAX_LENGTH, NOTIFICATION_RECIPIENT_NAME_MIN_LENGTH, NOTIFICATION_SUBJECT_MAX_LENGTH, NOTIFICATION_SUBJECT_MIN_LENGTH, NOTIFICATION_SUMMARY_EMBEDDED_NOTIFICATION_ITEM_MESSAGE_MAX_LENGTH, NOTIFICATION_SUMMARY_EMBEDDED_NOTIFICATION_ITEM_SUBJECT_MAX_LENGTH, NOTIFICATION_SUMMARY_ITEM_LIMIT, NOTIFICATION_TASK_SUBTASK_CHECKPOINT_CLEANUP, NOTIFICATION_TASK_SUBTASK_CHECKPOINT_PROCESSING, NOTIFICATION_USER_BLOCKED_FROM_BEING_ADD_TO_RECIPIENTS_ERROR_CODE, NOTIFICATION_USER_INVALID_UID_FOR_CREATE_ERROR_CODE, NOTIFICATION_USER_LOCKED_CONFIG_FROM_BEING_UPDATED_ERROR_CODE, NOTIFICATION_WEEK_NOTIFICATION_ITEM_LIMIT, NotificationBoxDocument, NotificationBoxRecipientFlag, NotificationBoxRecipientTemplateConfigArrayEntryParam, NotificationBoxRecipientTemplateConfigBoolean, NotificationDocument, NotificationFirestoreCollections, NotificationFunctions, NotificationMessageFlag, NotificationRecipientParams, NotificationRecipientSendFlag, NotificationSendState, NotificationSendType, NotificationSummaryDocument, NotificationUserDocument, NotificationWeekDocument, ProcessAllQueuedStorageFilesParams, ProcessStorageFileParams, RUN_DEV_FUNCTION_APP_FUNCTION_KEY, RegenerateAllFlaggedStorageFileGroupsContentParams, RegenerateStorageFileGroupContentParams, ResyncAllNotificationUserParams, ResyncNotificationUserParams, SCHEDULED_FUNCTION_DEV_FUNCTION_SPECIFIER, STORAGEFILE_RELATED_FILE_METADATA_KEY, STORAGE_FILE_ALREADY_PROCESSED_ERROR_CODE, STORAGE_FILE_CANNOT_BE_DELETED_YET_ERROR_CODE, STORAGE_FILE_GROUP_CREATE_INPUT_ERROR_CODE, STORAGE_FILE_GROUP_QUEUED_FOR_INITIALIZATION_ERROR_CODE, STORAGE_FILE_GROUP_ROOT_FOLDER_PATH, STORAGE_FILE_GROUP_ZIP_FILE_PATH, STORAGE_FILE_GROUP_ZIP_INFO_JSON_FILE_NAME, STORAGE_FILE_GROUP_ZIP_STORAGE_FILE_PURPOSE, STORAGE_FILE_GROUP_ZIP_STORAGE_FILE_PURPOSE_CREATE_ZIP_SUBTASK, STORAGE_FILE_MODEL_ALREADY_INITIALIZED_ERROR_CODE, STORAGE_FILE_NOT_FLAGGED_FOR_DELETION_ERROR_CODE, STORAGE_FILE_NOT_FLAGGED_FOR_GROUPS_SYNC_ERROR_CODE, STORAGE_FILE_PROCESSING_NOTIFICATION_TASK_TYPE, STORAGE_FILE_PROCESSING_NOT_ALLOWED_FOR_INVALID_STATE_ERROR_CODE, STORAGE_FILE_PROCESSING_NOT_AVAILABLE_FOR_TYPE_ERROR_CODE, STORAGE_FILE_PROCESSING_NOT_QUEUED_FOR_PROCESSING_ERROR_CODE, STORAGE_FILE_PROCESSING_STUCK_THROTTLE_CHECK_MS, STORAGE_FILE_UPLOAD_USER_ROLE, ScheduledFunctionDevelopmentFirebaseFunctionListEntry, ScheduledFunctionDevelopmentFirebaseFunctionParams, ScheduledFunctionDevelopmentFunctionTypeEnum, SendNotificationParams, SendQueuedNotificationsParams, StorageFileCreationType, StorageFileDocument, StorageFileFirestoreCollections, StorageFileFunctions, StorageFileGroupDocument, StorageFileProcessingState, StorageFileState, StorageFileUploadStreamUnsupportedError, SyncAllFlaggedStorageFilesWithGroupsParams, SyncStorageFileWithGroupsParams, SystemStateDocument, SystemStateFirestoreCollections, TargetModelIdParams, TargetModelParams, UPLOADED_FILE_DOES_NOT_EXIST_ERROR_CODE, UPLOADED_FILE_INITIALIZATION_DISCARDED_ERROR_CODE, UPLOADED_FILE_INITIALIZATION_FAILED_ERROR_CODE, UPLOADED_FILE_NOT_ALLOWED_TO_BE_INITIALIZED_ERROR_CODE, UPLOADS_FOLDER_PATH, UpdateNotificationBoxParams, UpdateNotificationBoxRecipientLikeParams, UpdateNotificationBoxRecipientParams, UpdateNotificationSummaryParams, UpdateNotificationUserDefaultNotificationBoxRecipientConfigParams, UpdateNotificationUserNotificationBoxRecipientParams, UpdateNotificationUserParams, UpdateStorageFileGroupEntryParams, UpdateStorageFileGroupParams, UpdateStorageFileParams, _createNotificationDocumentFromPair, addConstraintToBuilder, addOrReplaceLimitInConstraints, allChildDocumentsUnderParent, allChildDocumentsUnderParentPath, allChildDocumentsUnderRelativePath, allowDocumentSnapshotWithPathOnceFilter, allowedNotificationRecipients, appNotificationTemplateTypeInfoRecordService, applyExclusionsToNotificationUserNotificationBoxRecipientConfigs, arrayUpdateWithAccessorFunction, asTopLevelFieldPath, asTopLevelFieldPaths, assertFirestoreUpdateHasData, assertStorageUploadOptionsStringFormat, assignDateCellRangeFunction, assignDateCellScheduleFunction, assignUnitedStatesAddressFunction, assignWebsiteFileLinkFunction, assignWebsiteLinkFunction, buildFirebaseCollectionTypeModelTypeMap, calculateNsForNotificationUserNotificationBoxRecipientConfigs, calculateStorageFileGroupEmbeddedFileUpdate, calculateStorageFileGroupRegeneration, callModelFirebaseFunctionMapFactory, canQueueStorageFileForProcessing, childFirestoreModelKey, childFirestoreModelKeyPath, childFirestoreModelKeys, clientFirebaseFirestoreContextFactory, clientFirebaseStorageContextFactory, combineUploadFileTypeDeterminers, completeSubtaskProcessingAndScheduleCleanupTaskResult, contextGrantedModelRolesReader, contextGrantedModelRolesReaderDoesNotExistErrorMessage, contextGrantedModelRolesReaderPermissionErrorMessage, convertHttpsCallableErrorToReadableError, copyDocumentIdForUserRelatedModifierFunction, copyDocumentIdToFieldModifierFunction, copyStoragePath, copyUserRelatedDataAccessorFactoryFunction, copyUserRelatedDataModifierConfig, createNotificationDocument, createNotificationDocumentIfSending, createNotificationDocumentPair, createNotificationTaskTemplate, createNotificationTemplate, createStorageFileDocumentPair, createStorageFileDocumentPairFactory, dataFromDocumentSnapshots, dataFromSnapshotStream, delayCompletion, determineByFileName, determineByFilePath, determineByFolderName, determineUserByFolder, determineUserByFolderWrapperFunction, determineUserByUserUploadsFolderWrapperFunction, developmentFirebaseFunctionMapFactory, directDataHttpsCallable, documentData, documentDataFunction, documentDataWithIdAndKey, documentReferenceFromDocument, documentReferencesFromDocuments, documentReferencesFromSnapshot, effectiveNotificationBoxRecipientConfig, effectiveNotificationBoxRecipientTemplateConfig, endAt, endAtValue, endBefore, extendFirestoreCollectionWithSingleDocumentAccessor, filterConstraintsOfType, filterDisallowedFirestoreItemPageIteratorInputConstraints, filterRepeatCheckpointSnapshots, filterWithDateRange, firebaseAuthErrorToReadableError, firebaseFirestoreClientDrivers, firebaseFirestoreQueryConstraintFunctionsDriver, firebaseFirestoreQueryDriver, firebaseFunctionMapFactory, firebaseModelLoader, firebaseModelPermissionService, firebaseModelService, firebaseModelServiceFactory, firebaseModelsService, firebaseQueryItemAccumulator, firebaseQuerySnapshotAccumulator, firebaseStorageBucketFolderPath, firebaseStorageClientAccessorDriver, firebaseStorageClientAccessorFile, firebaseStorageClientAccessorFolder, firebaseStorageClientDrivers, firebaseStorageClientListFilesResultFactory, firebaseStorageContextFactory, firebaseStorageFileExists, firebaseStorageFilePathFromStorageFilePath, firebaseStorageRefForStorageFilePath, firestoreArray, firestoreArrayMap, firestoreBitwiseObjectMap, firestoreBitwiseSet, firestoreBitwiseSetMap, firestoreBoolean, firestoreClientAccessorDriver, firestoreClientArrayUpdateToUpdateData, firestoreClientIncrementUpdateToUpdateData, firestoreCollectionQueryFactory, firestoreContextFactory, firestoreDate, firestoreDateCellRange, firestoreDateCellRangeArray, firestoreDateCellRangeAssignFn, firestoreDateCellSchedule, firestoreDateCellScheduleAssignFn, firestoreDateNumber, firestoreDencoderArray, firestoreDencoderMap, firestoreDencoderStringArray, firestoreDocumentAccessorContextExtension, firestoreDocumentAccessorFactory, firestoreDocumentLoader, firestoreDocumentSnapshotPairsLoader, firestoreDocumentSnapshotPairsLoaderInstance, firestoreDummyKey, firestoreEncodedArray, firestoreEncodedObjectMap, firestoreEnum, firestoreEnumArray, firestoreField, firestoreFieldConfigToModelMapFunctionsRef, firestoreFixedItemPageIteration, firestoreFixedItemPageIterationFactory, firestoreIdBatchVerifierFactory, firestoreIdentityTypeArray, firestoreIdentityTypeArrayName, firestoreItemPageIteration, firestoreItemPageIterationFactory, firestoreLatLngString, firestoreMap, firestoreMapZoomLevel, firestoreModelId, firestoreModelIdArrayField, firestoreModelIdFromDocument, firestoreModelIdFromEmail, firestoreModelIdGrantedRoleArrayMap, firestoreModelIdGrantedRoleMap, firestoreModelIdString, firestoreModelIdentity, firestoreModelIdentityTypeMap, firestoreModelIdsFromDocuments, firestoreModelIdsFromKey, firestoreModelKey, firestoreModelKeyArrayField, firestoreModelKeyCollectionName, firestoreModelKeyCollectionType, firestoreModelKeyCollectionTypeArray, firestoreModelKeyCollectionTypeArrayName, firestoreModelKeyCollectionTypePair, firestoreModelKeyEncodedGrantedRoleMap, firestoreModelKeyFactory, firestoreModelKeyFromDocument, firestoreModelKeyGrantedRoleArrayMap, firestoreModelKeyGrantedRoleMap, firestoreModelKeyPairObject, firestoreModelKeyParentKey, firestoreModelKeyParentKeyPartPairs, firestoreModelKeyPart, firestoreModelKeyPartPairs, firestoreModelKeyPartPairsKeyPath, firestoreModelKeyPartPairsPaths, firestoreModelKeyPath, firestoreModelKeyString, firestoreModelKeyTypePair, firestoreModelKeys, firestoreModelKeysFromDocuments, firestoreModelType, firestoreNotificationBoxRecipient, firestoreNotificationBoxRecipientTemplateConfigRecord, firestoreNotificationItem, firestoreNotificationRecipientWithConfig, firestoreNotificationUserDefaultNotificationBoxRecipientConfig, firestoreNotificationUserNotificationBoxRecipientConfig, firestoreNumber, firestoreObjectArray, firestorePassThroughField, firestoreQueryConstraint, firestoreQueryConstraintFactory, firestoreQueryDocumentSnapshotPairsLoader, firestoreQueryFactory, firestoreSingleDocumentAccessor, firestoreString, firestoreSubObject, firestoreTimezoneString, firestoreUID, firestoreUniqueArray, firestoreUniqueKeyedArray, firestoreUniqueNumberArray, firestoreUniqueStringArray, firestoreUnitedStatesAddress, firestoreUnitedStatesAddressAssignFn, firestoreUnixDateTimeSecondsNumber, firestoreUpdateWithNoDataError, firestoreWebsiteFileLink, firestoreWebsiteFileLinkAssignFn, firestoreWebsiteFileLinkEncodedArray, firestoreWebsiteFileLinkObjectArray, firestoreWebsiteLink, firestoreWebsiteLinkArray, firestoreWebsiteLinkAssignFn, flatFirestoreModelKey, getDataFromDocumentSnapshots, getDocumentSnapshotData, getDocumentSnapshotDataPair, getDocumentSnapshotDataPairs, getDocumentSnapshotDataPairsWithData, getDocumentSnapshotDataTuples, getDocumentSnapshotPair, getDocumentSnapshotPairs, getDocumentSnapshots, getDocumentSnapshotsData, grantFullAccessIfAdmin, grantFullAccessIfAuthUserRelated, grantModelRolesIfAdmin, grantModelRolesIfAdminFunction, grantModelRolesIfAuthUserRelatedModelFunction, grantModelRolesIfFunction, grantModelRolesIfHasAuthRolesFactory, grantModelRolesIfHasAuthRolesFunction, grantModelRolesOnlyIfFunction, grantStorageFileRolesForUserAuthFunction, inContextFirebaseModelServiceFactory, inContextFirebaseModelsServiceFactory, incrementUpdateWithAccessorFunction, inferKeyFromTwoWayFlatFirestoreModelKey, inferNotificationBoxRelatedModelKey, inferStorageFileGroupRelatedModelKey, interceptAccessorFactoryFunction, isAdminInFirebaseModelContext, isClientFirebaseError, isCompleteNotificationSendState, isFirebaseStorageObjectNotFoundError, isFirestoreModelId, isFirestoreModelIdOrKey, isFirestoreModelKey, isOwnerOfUserRelatedModelInFirebaseModelContext, iterateFirestoreDocumentSnapshotBatches, iterateFirestoreDocumentSnapshotCheckpoints, iterateFirestoreDocumentSnapshotPairBatches, iterateFirestoreDocumentSnapshotPairs, iterateFirestoreDocumentSnapshots, iterateStorageListFiles, iterateStorageListFilesByEachFile, iterateStorageListFilesFactory, iterationQueryDocChangeWatcher, iterationQueryDocChangeWatcherChangeTypeForGroup, latestDataFromDocuments, latestSnapshotsFromDocuments, lazyFirebaseFunctionsFactory, limit, limitToLast, limitUploadFileTypeDeterminer, limitedFirestoreDocumentAccessorFactory, limitedFirestoreDocumentAccessorSnapshotCache, loadAllFirestoreDocumentSnapshot, loadAllFirestoreDocumentSnapshotPairs, loadDocumentsForDocumentReferences, loadDocumentsForDocumentReferencesFromValues, loadDocumentsForIds, loadDocumentsForIdsFromValues, loadDocumentsForKeys, loadDocumentsForKeysFromValues, loadDocumentsForSnapshots, loadDocumentsForValues, loadNotificationBoxDocumentForReferencePair, loadStorageFileGroupDocumentForReferencePair, makeDocuments, makeFirestoreCollection, makeFirestoreCollectionGroup, makeFirestoreCollectionWithParent, makeFirestoreItemPageIteratorDelegate, makeFirestoreQueryConstraintFunctionsDriver, makeRootSingleItemFirestoreCollection, makeSingleItemFirestoreCollection, mapDataFromSnapshot, mapHttpsCallable, mapLatestSnapshotsFromDocuments, mergeNotificationBoxRecipientTemplateConfigRecords, mergeNotificationBoxRecipientTemplateConfigs, mergeNotificationBoxRecipients, mergeNotificationSendMessagesResult, mergeNotificationUserDefaultNotificationBoxRecipientConfig, mergeNotificationUserNotificationBoxRecipientConfigs, modelStorageSlashPathFactory, modifyBeforeSetInterceptAccessorFactoryFunction, newDocuments, newNotificationBoxRecipientForUid, noContentNotificationMessageFunctionFactory, noStringFormatInStorageUploadOptionsError, notificationBoxCollectionReference, notificationBoxConverter, notificationBoxFirestoreCollection, notificationBoxIdForModel, notificationBoxIdentity, notificationBoxModelCrudFunctionsConfig, notificationBoxRecipientTemplateConfigArrayToRecord, notificationBoxRecipientTemplateConfigRecordToArray, notificationBoxesFlaggedForNeedsInitializationQuery, notificationBoxesFlaggedInvalidQuery, notificationCollectionReference, notificationCollectionReferenceFactory, notificationConverter, notificationFirestoreCollectionFactory, notificationFirestoreCollectionGroup, notificationFunctionMap, notificationFunctionTypeConfigMap, notificationIdentity, notificationMessageFunction, notificationSendExclusionCanSendFunction, notificationSendFlagsImplyIsComplete, notificationSubtaskComplete, notificationSummariesFlaggedForNeedsInitializationQuery, notificationSummaryCollectionReference, notificationSummaryConverter, notificationSummaryFirestoreCollection, notificationSummaryIdForModel, notificationSummaryIdForUidFunctionForRootFirestoreModelIdentity, notificationSummaryIdentity, notificationTaskCanRunNextCheckpoint, notificationTaskComplete, notificationTaskDelayRetry, notificationTaskFailed, notificationTaskPartiallyComplete, notificationTaskUniqueId, notificationTemplateTypeInfoRecord, notificationUserCollectionReference, notificationUserConverter, notificationUserFirestoreCollection, notificationUserHasExclusionQuery, notificationUserIdentity, notificationUsersFlaggedForNeedsSyncQuery, notificationWeekCollectionReference, notificationWeekCollectionReferenceFactory, notificationWeekConverter, notificationWeekFirestoreCollectionFactory, notificationWeekFirestoreCollectionGroup, notificationWeekIdentity, notificationsPastSendAtTimeQuery, notificationsReadyForCleanupQuery, offset, onCallCreateModelParams, onCallCreateModelResult, onCallCreateModelResultWithDocs, onCallDeleteModelParams, onCallDevelopmentParams, onCallReadModelParams, onCallTypedModelParams, onCallTypedModelParamsFunction, onCallUpdateModelParams, optionalFirestoreArray, optionalFirestoreBoolean, optionalFirestoreDate, optionalFirestoreDateNumber, optionalFirestoreEnum, optionalFirestoreField, optionalFirestoreNumber, optionalFirestoreString, optionalFirestoreUID, optionalFirestoreUnitedStatesAddress, optionalFirestoreUnixDateTimeSecondsNumber, orderBy, orderByDocumentId, readFirestoreModelKey, readFirestoreModelKeyFromDocumentSnapshot, replaceConstraints, selectFromFirebaseModelsService, separateConstraints, setIdAndKeyFromKeyIdRefOnDocumentData, setIdAndKeyFromSnapshotOnDocumentData, shouldSaveNotificationToNotificationWeek, shouldSendCreatedNotificationInput, snapshotConverterFunctions, snapshotStreamDataForAccessor, snapshotStreamForAccessor, sortNotificationItemsFunction, startAfter, startAt, startAtValue, storageFileCollectionReference, storageFileConverter, storageFileFirestoreCollection, storageFileFlaggedForSyncWithGroupsQuery, storageFileFunctionMap, storageFileFunctionTypeConfigMap, storageFileGroupCollectionReference, storageFileGroupConverter, storageFileGroupCreateStorageFileKeyFactory, storageFileGroupCreatedStorageFileKey, storageFileGroupEmbeddedFile, storageFileGroupFirestoreCollection, storageFileGroupFolderPath, storageFileGroupIdForModel, storageFileGroupIdentity, storageFileGroupZipFileStoragePath, storageFileGroupZipStorageFileKey, storageFileGroupsFlaggedForContentRegenerationQuery, storageFileGroupsFlaggedForNeedsInitializationQuery, storageFileGroupsFlaggedInvalidQuery, storageFileIdentity, storageFileModelCrudFunctionsConfig, storageFileProcessingNotificationTaskTemplate, storageFilePurposeAndUserQuery, storageFileUploadUserSimpleClaimsConfiguration, storageFilesQueuedForDeleteQuery, storageFilesQueuedForProcessingQuery, storageListFilesResultFactory, storageListFilesResultHasNoNextError, storagePathFactory, storedFileReaderFactory, streamDocumentSnapshotDataPairs, streamDocumentSnapshotDataPairsWithData, streamDocumentSnapshotsData, streamFromOnSnapshot, systemStateCollectionReference, systemStateConverter, systemStateFirestoreCollection, systemStateIdentity, twoWayFlatFirestoreModelKey, unreadNotificationItems, unsupportedFirestoreDriverFunctionError, updateNotificationBoxRecipientTemplateConfigRecord, updateNotificationRecipient, updateNotificationUserDefaultNotificationBoxRecipientConfig, updateNotificationUserNotificationBoxRecipientConfigIfChanged, updateNotificationUserNotificationBoxRecipientConfigs, updateNotificationUserNotificationSendExclusions, updateWithAccessorUpdateAndConverterFunction, uploadFileWithStream, useContextAuth, useContextAuthUid, useDocumentSnapshot, useDocumentSnapshotData, useFirebaseModelsService, userUploadsFolderSlashPathFactory, userUploadsFolderStoragePathFactory, where, whereDateIsAfter, whereDateIsAfterWithSort, whereDateIsBefore, whereDateIsBeforeWithSort, whereDateIsBetween, whereDateIsInRange, whereDateIsOnOrAfter, whereDateIsOnOrAfterWithSort, whereDateIsOnOrBefore, whereDateIsOnOrBeforeWithSort, whereDocumentId, whereStringHasRootIdentityModelKey, whereStringValueHasPrefix };
 //# sourceMappingURL=index.esm.js.map