@dereekb/firebase 13.4.1 → 13.5.0

package/index.cjs.js

@@ -441,13 +441,15 @@ function _is_native_reflect_construct$9() {
  */ function copyDocumentIdToFieldModifierFunction(fieldName) {
     return function(param) {
         var data = param.data, documentRef = param.documentRef;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         data[fieldName] = documentRef.id; // copy the id to the target field
     };
 }
 /**
  * Creates an {@link InterceptAccessorFactoryFunction} that wraps all created accessors with
  * {@link ModifyBeforeSetFirestoreDocumentDataAccessorWrapper} using the provided config.
+ *
+ * @param config - The ModifyBeforeSetConfig defining when and how to modify documents
+ * @returns An InterceptAccessorFactoryFunction that wraps accessors with the modify-before-set behavior
  */ function modifyBeforeSetInterceptAccessorFactoryFunction(config) {
     return interceptAccessorFactoryFunction(function(accessor) {
         return new ModifyBeforeSetFirestoreDocumentDataAccessorWrapper(accessor, config);
@@ -456,12 +458,16 @@ function _is_native_reflect_construct$9() {
 // MARK: Templates
 /**
  * Creates a modifier that copies the document ID to the `uid` field for {@link UserRelated} models.
+ *
+ * @returns A ModifyBeforeSetModifierFunction that sets the `uid` field to the document's ID
  */ function copyDocumentIdForUserRelatedModifierFunction() {
     return copyDocumentIdToFieldModifierFunction('uid');
 }
 /**
  * Returns a pre-configured {@link ModifyBeforeSetConfig} for {@link UserRelated} models
  * that copies the document ID to the `uid` field on set operations (new document creation).
+ *
+ * @returns A ModifyBeforeSetConfig configured to copy the document ID to the `uid` field on set
  */ function copyUserRelatedDataModifierConfig() {
     return {
         when: 'set',
@@ -476,6 +482,8 @@ function _is_native_reflect_construct$9() {
 /**
  * Returns a typed {@link InterceptAccessorFactoryFunction} that applies the UserRelated
  * document ID copy modifier to all accessors created by the factory.
+ *
+ * @returns A typed InterceptAccessorFactoryFunction with the UserRelated document ID copy modifier applied
  */ function copyUserRelatedDataAccessorFactoryFunction() {
     return COPY_USER_RELATED_DATA_ACCESSOR_FACTORY_FUNCTION();
 }
@@ -713,9 +721,15 @@ function _ts_generator$k(thisArg, body) {
  * - BATCH: Operations within a Firestore write batch (atomic writes only, no reads)
  */ exports.FirestoreDocumentContextType = void 0;
 (function(FirestoreDocumentContextType) {
-    /** Standard context with no special transactional semantics */ FirestoreDocumentContextType["NONE"] = "none";
-    /** Operations within a Firestore transaction (atomic reads and writes) */ FirestoreDocumentContextType["TRANSACTION"] = "transaction";
-    /** Operations within a Firestore write batch (atomic writes only) */ FirestoreDocumentContextType["BATCH"] = "batch";
+    /**
+     * Standard context with no special transactional semantics
+     */ FirestoreDocumentContextType["NONE"] = "none";
+    /**
+     * Operations within a Firestore transaction (atomic reads and writes)
+     */ FirestoreDocumentContextType["TRANSACTION"] = "transaction";
+    /**
+     * Operations within a Firestore write batch (atomic writes only)
+     */ FirestoreDocumentContextType["BATCH"] = "batch";
 })(exports.FirestoreDocumentContextType || (exports.FirestoreDocumentContextType = {}));
 
 function asyncGeneratorStep$j(gen, resolve, reject, _next, _throw, key, arg) {
@@ -1212,7 +1226,8 @@ function _is_native_reflect_construct$8() {
             /**
      * Retrieves a DocumentSnapshot of the document as an Observable. Streams based on the input mode.
      *
-     * @returns
+     * @param mode - The stream mode controlling how the Observable emits snapshot updates
+     * @returns An Observable that emits DocumentSnapshot values based on the given mode
      */ key: "snapshotStream",
             value: function snapshotStream(mode) {
                 return snapshotStreamForAccessor(this.accessor, mode);
@@ -1222,8 +1237,9 @@ function _is_native_reflect_construct$8() {
             /**
      * Retrieves the data of the DocumentSnapshot of the document as an Observable. Streams based on the input mode.
      *
-     * @param options
-     * @returns
+     * @param mode - The stream mode controlling how the Observable emits snapshot data updates
+     * @param options - Optional SnapshotOptions for reading the document data
+     * @returns An Observable that emits the document data or undefined based on the given mode
      */ key: "snapshotDataStream",
             value: function snapshotDataStream(mode, options) {
                 return snapshotStreamDataForAccessor(this.accessor, mode, options);
@@ -1232,6 +1248,7 @@ function _is_native_reflect_construct$8() {
         {
             /**
      * Retrieves a DocumentSnapshot of the document.
+     *
      * @returns
      */ key: "snapshot",
             value: function snapshot() {
@@ -1241,6 +1258,7 @@ function _is_native_reflect_construct$8() {
         {
             /**
      * Retrieves the data of the DocumentSnapshot of the document.
+     *
      * @param options
      * @returns
      */ key: "snapshotData",
@@ -1280,8 +1298,9 @@ function _is_native_reflect_construct$8() {
      *
      * Throws an exception when it does not exist.
      *
-     * @param data
-     * @returns
+     * @param data - Partial document data to update
+     * @param params - Optional update parameters
+     * @returns A Promise that resolves when the update completes
      */ key: "update",
             value: function update(data, params) {
                 return updateWithAccessorUpdateAndConverterFunction(this.accessor, this.converter)(data, params);
@@ -1291,7 +1310,8 @@ function _is_native_reflect_construct$8() {
             /**
      * Updates the document using the accessor's increment functionality.
      *
-     * @param data
+     * @param data - The increment update to apply to numeric fields
+     * @returns A Promise that resolves when the increment update completes
      */ key: "increment",
             value: function increment(data) {
                 return incrementUpdateWithAccessorFunction(this.accessor)(data);
@@ -1301,7 +1321,8 @@ function _is_native_reflect_construct$8() {
             /**
      * Updates the document using the accessor's array field update functionality.
      *
-     * @param data
+     * @param data - The array field update to apply (union or remove elements)
+     * @returns A Promise that resolves when the array update completes
      */ key: "arrayUpdate",
             value: function arrayUpdate(data) {
                 return arrayUpdateWithAccessorFunction(this.accessor)(data);
@@ -1310,7 +1331,12 @@ function _is_native_reflect_construct$8() {
     ]);
     return AbstractFirestoreDocument;
 }();
-function limitedFirestoreDocumentAccessorFactory(config) {
+/**
+ * Creates a {@link LimitedFirestoreDocumentAccessorFactoryFunction} from the provided configuration.
+ *
+ * @param config - Configuration including converter, accessor factory, and document factory
+ * @returns A factory function for creating LimitedFirestoreDocumentAccessor instances
+ */ function limitedFirestoreDocumentAccessorFactory(config) {
     var firestoreContext = config.firestoreContext, firestoreAccessorDriver = config.firestoreAccessorDriver, makeDocument = config.makeDocument, interceptAccessorFactory = config.accessorFactory, inputDefaultConverter = config.converter, inputConverterFactory = config.converterFactory, modelIdentity = config.modelIdentity;
     var expectedCollectionName = firestoreAccessorDriver.fuzzedPathForPath ? firestoreAccessorDriver.fuzzedPathForPath(modelIdentity.collectionName) : modelIdentity.collectionName;
     var converterFactory = inputConverterFactory ? function(ref) {
@@ -1321,9 +1347,6 @@ function limitedFirestoreDocumentAccessorFactory(config) {
     };
     var result = function result(context) {
         var loadDocument = function loadDocument(ref) {
-            if (!ref) {
-                throw new Error('ref must be defined.');
-            }
             var converter = converterFactory(ref);
             var accessor = dataAccessorFactory.accessorFor(ref.withConverter(converter));
             return makeDocument(accessor, documentAccessor);
@@ -1361,7 +1384,15 @@ function limitedFirestoreDocumentAccessorFactory(config) {
     result.converterFactory = converterFactory;
     return result;
 }
-function firestoreDocumentAccessorFactory(config) {
+/**
+ * Creates a {@link FirestoreDocumentAccessorFactoryFunction} from the provided configuration.
+ *
+ * Extends the limited accessor factory with collection-level operations such as creating new documents
+ * and loading documents by ID.
+ *
+ * @param config - Configuration including the collection reference and document factory
+ * @returns A factory function for creating FirestoreDocumentAccessor instances
+ */ function firestoreDocumentAccessorFactory(config) {
     var firestoreAccessorDriver = config.firestoreAccessorDriver, collection = config.collection;
     var limitedFirestoreDocumentAccessor = limitedFirestoreDocumentAccessorFactory(config);
     function documentRefForId(path) {
@@ -1425,7 +1456,12 @@ var AbstractFirestoreDocumentWithParent = /*#__PURE__*/ function(AbstractFiresto
     ]);
     return AbstractFirestoreDocumentWithParent;
 }(AbstractFirestoreDocument);
-function firestoreSingleDocumentAccessor(config) {
+/**
+ * Creates a {@link FirestoreSingleDocumentAccessor} for a collection that contains a single known document.
+ *
+ * @param config - Configuration specifying the single item identifier and the document accessor context extension
+ * @returns A FirestoreSingleDocumentAccessor providing convenient access to the single document
+ */ function firestoreSingleDocumentAccessor(config) {
     var singleItemIdentifier = config.singleItemIdentifier, accessors = config.accessors;
     var defaultAccessor = accessors.documentAccessor();
     return {
@@ -1447,10 +1483,15 @@ function firestoreSingleDocumentAccessor(config) {
 /**
  * Default document ID used for single-document collections. The document is stored at path `<collection>/0`.
  */ var DEFAULT_SINGLE_ITEM_FIRESTORE_COLLECTION_DOCUMENT_IDENTIFIER = '0';
-function extendFirestoreCollectionWithSingleDocumentAccessor(x, singleItemIdentifier) {
+/**
+ * Extends a Firestore collection object in-place with single-document accessor methods.
+ *
+ * @param x - The collection object to extend with single-document accessor methods
+ * @param singleItemIdentifier - Optional identifier for the single document; defaults to {@link DEFAULT_SINGLE_ITEM_FIRESTORE_COLLECTION_DOCUMENT_IDENTIFIER}
+ */ function extendFirestoreCollectionWithSingleDocumentAccessor(x, singleItemIdentifier) {
     var singleAccessor = firestoreSingleDocumentAccessor({
         accessors: x,
-        singleItemIdentifier: singleItemIdentifier || DEFAULT_SINGLE_ITEM_FIRESTORE_COLLECTION_DOCUMENT_IDENTIFIER
+        singleItemIdentifier: singleItemIdentifier !== null && singleItemIdentifier !== void 0 ? singleItemIdentifier : DEFAULT_SINGLE_ITEM_FIRESTORE_COLLECTION_DOCUMENT_IDENTIFIER
     });
     x.singleItemIdentifier = singleAccessor.singleItemIdentifier;
     x.documentRef = singleAccessor.documentRef;
@@ -1929,8 +1970,7 @@ function getDataFromDocumentSnapshots(snapshots) {
  */ var firestoreQueryDocumentSnapshotPairsLoader = firestoreDocumentSnapshotPairsLoader;
 function documentData(snapshot) {
     var withId = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : false;
-    var result = withId ? documentDataWithIdAndKey(snapshot) : snapshot.data();
-    return result;
+    return withId ? documentDataWithIdAndKey(snapshot) : snapshot.data();
 }
 function documentDataFunction(withId) {
     return withId ? documentDataWithIdAndKey : function(snapshot) {
@@ -2447,12 +2487,20 @@ function _object_spread_props$j(target, source) {
         /**
          * Implementation of FirestoreDataConverter.fromFirestore
          * Converts Firestore data to the application model type
+         *
+         * @param snapshot - The DocumentSnapshot containing raw Firestore data
+         * @param options - Optional SnapshotOptions for reading data
+         * @returns The converted application model instance
          */ fromFirestore: function fromFirestore(snapshot, options) {
             return from(snapshot, undefined);
         },
         /**
          * Implementation of FirestoreDataConverter.toFirestore
          * Converts the application model to Firestore data format
+         *
+         * @param modelObject - The model object to convert to Firestore data
+         * @param options - Optional SetOptions controlling how data is written
+         * @returns The converted Firestore data object
          */ toFirestore: function toFirestore(modelObject, options) {
             return to(modelObject, undefined, options);
         }
@@ -2578,7 +2626,7 @@ function _object_spread_props$i(target, source) {
 function optionalFirestoreField(config) {
     // NOTE: Typings for this function internally is weird due to the support for both the one and two type transforms.
     if (config) {
-        var inputConfig = config !== null && config !== void 0 ? config : {};
+        var inputConfig = config;
         var dontStoreDefaultReadValue = inputConfig.dontStoreDefaultReadValue, inputDontStoreValueIf = inputConfig.dontStoreValueIf, inputTransformData = inputConfig.transformData; // might be defined.
         var inputDefaultReadValue = inputConfig.defaultReadValue, inputDontStoreIf = inputConfig.dontStoreIf, transformFromData = inputConfig.transformFromData, transformToData = inputConfig.transformToData;
         var transformData = inputTransformData !== null && inputTransformData !== void 0 ? inputTransformData : util.passThrough;
@@ -2626,8 +2674,7 @@ function optionalFirestoreField(config) {
             toData = function toData(x) {
                 if (x != null) {
                     var transformedValue = transformTo(x);
-                    var finalValue = transformedValue != null && !dontStoreValue(transformedValue) ? transformedValue : null;
-                    return finalValue;
+                    return transformedValue != null && !dontStoreValue(transformedValue) ? transformedValue : null;
                 } else {
                     return x;
                 }
@@ -2959,8 +3006,7 @@ function optionalFirestoreField(config) {
     }
     var inputFilterUnique = (config === null || config === void 0 ? void 0 : config.filterUnique) === true ? util.unique : config === null || config === void 0 ? void 0 : config.filterUnique;
     var filterUniqueValuesFn = inputFilterUnique != null ? function(x) {
-        var result = inputFilterUnique(x);
-        return result;
+        return inputFilterUnique(x);
     } : undefined;
     var inputTransformData = config === null || config === void 0 ? void 0 : config.transformData;
     var sortArrayFn = util.isMapIdentityFunction(sortFn) ? undefined : function(x) {
@@ -3050,7 +3096,8 @@ function optionalFirestoreField(config) {
  * @template S - Number type (defaults to number)
  * @param config - Configuration for the unique number array field
  * @returns A field mapping configuration for unique number array values
- */ function firestoreUniqueNumberArray(config) {
+ */ // eslint-disable-next-line sonarjs/no-identical-functions -- intentionally separate for distinct type constraints (number vs string|number)
+function firestoreUniqueNumberArray(config) {
     return firestoreUniqueArray(_object_spread_props$i(_object_spread$m({}, config), {
         filterUnique: util.unique
     }));
@@ -3168,6 +3215,8 @@ function optionalFirestoreField(config) {
  * FirestoreField configuration for a map of granted roles, keyed by model keys.
  *
  * Filters out models with no/null roles by default.
+ *
+ * @returns A field mapping configuration for a map of granted roles keyed by FirestoreModelKey
  */ function firestoreModelKeyGrantedRoleMap() {
     return firestoreMap({
         mapFilter: util.KeyValueTypleValueFilter.EMPTY
@@ -3202,13 +3251,11 @@ function optionalFirestoreField(config) {
         },
         fromData: function fromData(input) {
             var copy = util.copyObject(input);
-            var result = util.mapObjectMap(copy, decoder);
-            return result;
+            return util.mapObjectMap(copy, decoder);
         },
         toData: function toData(input) {
             var encodedMap = util.mapObjectMap(input, encoder);
-            var result = filterFinalMapValuesFn(encodedMap);
-            return result;
+            return filterFinalMapValuesFn(encodedMap);
         }
     });
 }
@@ -3234,6 +3281,9 @@ function optionalFirestoreField(config) {
  * FirestoreField configuration for a map of encoded granted roles, keyed by model keys.
  *
  * Filters out models with empty/no roles by default.
+ *
+ * @param dencoder - The dencoder function used to encode and decode the role values
+ * @returns A field mapping configuration for an encoded granted role map keyed by FirestoreModelKey
  */ function firestoreModelKeyEncodedGrantedRoleMap(dencoder) {
     return firestoreDencoderMap({
         dencoder: dencoder
@@ -3259,6 +3309,8 @@ function optionalFirestoreField(config) {
  * FirestoreField configuration for a map of granted roles, keyed by models keys.
  *
  * Filters empty roles/arrays by default.
+ *
+ * @returns A field mapping configuration for a map of granted role arrays keyed by FirestoreModelKey
  */ function firestoreModelKeyGrantedRoleArrayMap() {
     return firestoreArrayMap({
         mapFieldValues: util.filterEmptyArrayValues
@@ -3274,6 +3326,9 @@ function optionalFirestoreField(config) {
  *
  * Used internally by {@link firestoreObjectArray} to adapt field configs into the map functions
  * format needed for array element conversion.
+ *
+ * @param config - The FirestoreModelFieldMapFunctionsConfig to convert
+ * @returns A ModelMapFunctionsRef wrapping the derived map functions
  */ function firestoreFieldConfigToModelMapFunctionsRef(config) {
     var mapFunctions = util.modelFieldMapFunctions(config);
     return {
@@ -3324,8 +3379,7 @@ function optionalFirestoreField(config) {
     var to = function to(x) {
         // remove null/undefined values from each field when converting to in order to mirror firestore usage (undefined is treated like null)
         var base = baseTo(x);
-        var nullishfilteredOut = util.filterNullAndUndefinedValues(base);
-        return nullishfilteredOut;
+        return util.filterNullAndUndefinedValues(base);
     };
     return firestoreField({
         default: (_config_default = config.default) !== null && _config_default !== void 0 ? _config_default : function() {
@@ -3378,7 +3432,7 @@ function optionalFirestoreField(config) {
     var defaultBeforeSave = (_config_defaultBeforeSave = config.defaultBeforeSave) !== null && _config_defaultBeforeSave !== void 0 ? _config_defaultBeforeSave : config.saveDefaultObject ? function() {
         return toData({});
     } : null;
-    var mapFunctionsConfig = util.build({
+    return util.build({
         base: firestoreField({
             default: (_config_default = config.default) !== null && _config_default !== void 0 ? _config_default : defaultWithFields,
             defaultBeforeSave: defaultBeforeSave,
@@ -3389,7 +3443,6 @@ function optionalFirestoreField(config) {
             x.mapFunctions = mapFunctions;
         }
     });
-    return mapFunctionsConfig;
 }
 /**
  * Creates a field mapping configuration for Firestore latitude/longitude string fields.
@@ -3419,7 +3472,10 @@ function optionalFirestoreField(config) {
 /**
  * Default configuration for a TimezoneString.
  *
- * The value defaults to UTC
+ * The value defaults to UTC.
+ *
+ * @param config - Optional configuration for the timezone string field, including default value and pre-save default.
+ * @returns A configured Firestore field that stores a TimezoneString value.
  */ function firestoreTimezoneString(config) {
     var _ref = config !== null && config !== void 0 ? config : {}, defaultValue = _ref.default, defaultBeforeSave = _ref.defaultBeforeSave;
     return firestoreString({
@@ -3440,8 +3496,7 @@ var assignWebsiteLinkFunction = util.assignValuesToPOJOFunction({
     valueFilter: util.KeyValueTypleValueFilter.EMPTY
 });
 var firestoreWebsiteLinkAssignFn = function firestoreWebsiteLinkAssignFn(input) {
-    var behavior = assignWebsiteLinkFunction(DEFAULT_WEBSITE_LINK, input);
-    return behavior;
+    return assignWebsiteLinkFunction(DEFAULT_WEBSITE_LINK, input);
 };
 /**
  * Creates a field mapping configuration for Firestore website link fields.
@@ -3457,7 +3512,11 @@ var firestoreWebsiteLinkAssignFn = function firestoreWebsiteLinkAssignFn(input)
     });
 }
 // MARK: WebsiteLink Array
-function firestoreWebsiteLinkArray() {
+/**
+ * Creates a field mapping configuration for Firestore arrays of WebsiteLink values.
+ *
+ * @returns A field mapping configuration for WebsiteLink array values
+ */ function firestoreWebsiteLinkArray() {
     return firestoreObjectArray({
         firestoreField: firestoreWebsiteLink()
     });
@@ -3475,8 +3534,7 @@ var assignWebsiteFileLinkFunction = util.assignValuesToPOJOFunction({
     valueFilter: util.KeyValueTypleValueFilter.EMPTY
 });
 var firestoreWebsiteFileLinkAssignFn = function firestoreWebsiteFileLinkAssignFn(input) {
-    var behavior = assignWebsiteFileLinkFunction(DEFAULT_FIRESTORE_WEBSITE_FILE_LINK_VALUE, input);
-    return behavior;
+    return assignWebsiteFileLinkFunction(DEFAULT_FIRESTORE_WEBSITE_FILE_LINK_VALUE, input);
 };
 /**
  * Creates a field mapping configuration for Firestore website file link fields.
@@ -3494,6 +3552,8 @@ var firestoreWebsiteFileLinkAssignFn = function firestoreWebsiteFileLinkAssignFn
 // MARK: WebsiteFileLink Array
 /**
  * Stores the array of WebsiteFileLink values as an array of objects.
+ *
+ * @returns A field mapping configuration for WebsiteFileLink array values stored as objects
  */ function firestoreWebsiteFileLinkObjectArray() {
     return firestoreObjectArray({
         firestoreField: firestoreWebsiteFileLink()
@@ -3501,6 +3561,8 @@ var firestoreWebsiteFileLinkAssignFn = function firestoreWebsiteFileLinkAssignFn
 }
 /**
  * Stores the array of WebsiteFileLink values as an array of EncodedWebsiteFileLink values.
+ *
+ * @returns A field mapping configuration for WebsiteFileLink array values stored in encoded form
  */ function firestoreWebsiteFileLinkEncodedArray() {
     return firestoreEncodedArray({
         convert: {
@@ -3539,7 +3601,12 @@ var firestoreDateCellRangeAssignFn = function firestoreDateCellRangeAssignFn(inp
     });
 }
 // MARK: DateCellRange Array
-function firestoreDateCellRangeArray() {
+/**
+ * Creates a field mapping configuration for Firestore arrays of DateCellRange values.
+ *
+ * @param sort - Whether to sort the array by index number; defaults to true
+ * @returns A field mapping configuration for DateCellRange array values
+ */ function firestoreDateCellRangeArray() {
     var sort = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : true;
     return firestoreObjectArray({
         sortWith: sort ? util.sortAscendingIndexNumberRefFunction() : undefined,
@@ -3559,8 +3626,7 @@ var assignDateCellScheduleFunction = util.assignValuesToPOJOFunction({
     valueFilter: util.KeyValueTypleValueFilter.NULL
 });
 var firestoreDateCellScheduleAssignFn = function firestoreDateCellScheduleAssignFn(input) {
-    var block = assignDateCellScheduleFunction(DEFAULT_FIRESTORE_DATE_CELL_SCHEDULE_VALUE, input);
-    return block;
+    return assignDateCellScheduleFunction(DEFAULT_FIRESTORE_DATE_CELL_SCHEDULE_VALUE, input);
 };
 /**
  * Creates a field mapping configuration for Firestore date cell schedule fields.
@@ -3594,6 +3660,9 @@ var DEFAULT_FIRESTORE_UNITED_STATES_ADDRESS_VALUE = {
 });
 /**
  * Function to assign values from an input UnitedStatesAddress to a default UnitedStatesAddress.
+ *
+ * @param input - The source UnitedStatesAddress to copy values from
+ * @returns A new UnitedStatesAddress with values assigned from the input
  */ var firestoreUnitedStatesAddressAssignFn = function firestoreUnitedStatesAddressAssignFn(input) {
     return assignUnitedStatesAddressFunction(DEFAULT_FIRESTORE_UNITED_STATES_ADDRESS_VALUE, input);
 };
@@ -3731,37 +3800,37 @@ function firebaseQueryItemAccumulator(iteration, mapItem) {
     var mapFn = function mapFn(x) {
         var result = util.filterMaybeArrayValues(x.map(function(y) {
             var data = snapshotData(y);
-            return data ? mapItem(data) : undefined;
+            return mapItem(data);
         }));
         return result;
     };
     return firebaseQuerySnapshotAccumulator(iteration, mapFn);
 }
 
-function _array_like_to_array$f(arr, len) {
+function _array_like_to_array$g(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$b(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$f(arr);
+function _array_without_holes$d(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$g(arr);
 }
-function _iterable_to_array$b(iter) {
+function _iterable_to_array$d(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$b() {
+function _non_iterable_spread$d() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _to_consumable_array$b(arr) {
-    return _array_without_holes$b(arr) || _iterable_to_array$b(arr) || _unsupported_iterable_to_array$f(arr) || _non_iterable_spread$b();
+function _to_consumable_array$d(arr) {
+    return _array_without_holes$d(arr) || _iterable_to_array$d(arr) || _unsupported_iterable_to_array$g(arr) || _non_iterable_spread$d();
 }
-function _unsupported_iterable_to_array$f(o, minLen) {
+function _unsupported_iterable_to_array$g(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$f(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$g(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$f(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$g(o, minLen);
 }
 /**
  * Creates a {@link FirestoreQueryConstraint} with the given type identifier and data.
@@ -4060,7 +4129,7 @@ function orderBy(fieldPath, directionStr) {
  * const newConstraints = withLastLimit10(existingConstraints);
  */ function addOrReplaceLimitInConstraints(limit) {
     var addedLimitType = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE;
-    var replace = replaceConstraints(function(constraints) {
+    return replaceConstraints(function(constraints) {
         var type;
         if (constraints.length) {
             type = constraints[0].type;
@@ -4077,7 +4146,6 @@ function orderBy(fieldPath, directionStr) {
         FIRESTORE_LIMIT_QUERY_CONSTRAINT_TYPE,
         FIRESTORE_LIMIT_TO_LAST_QUERY_CONSTRAINT_TYPE
     ]);
-    return replace;
 }
 /**
  * Creates a function that filters out constraints of specific types.
@@ -4122,11 +4190,11 @@ function orderBy(fieldPath, directionStr) {
  * );
  * const newConstraints = replaceLimit(existingConstraints);
  */ function replaceConstraints(replaceFn, types) {
-    var separateFn = separateConstraints.apply(void 0, _to_consumable_array$b(types));
+    var separateFn = separateConstraints.apply(void 0, _to_consumable_array$d(types));
     return function(constraints) {
         var separated = separateFn(constraints);
         var replacements = util.asArray(replaceFn(separated.excluded));
-        return replacements ? util.pushItemOrArrayItemsIntoArray(separated.included, replacements) : separated.included;
+        return util.pushItemOrArrayItemsIntoArray(separated.included, replacements);
     };
 }
 /**
@@ -4151,10 +4219,9 @@ function orderBy(fieldPath, directionStr) {
     }
     return function(constraints) {
         var typesToFilterOut = new Set(types);
-        var separated = util.separateValues(constraints, function(x) {
+        return util.separateValues(constraints, function(x) {
             return !typesToFilterOut.has(x.type);
         });
-        return separated;
     };
 }
 
@@ -4309,13 +4376,13 @@ function whereDateIsBeforeWithSort(fieldPath) {
     ];
 }
 
-function _array_like_to_array$e(arr, len) {
+function _array_like_to_array$f(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$a(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$e(arr);
+function _array_without_holes$c(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$f(arr);
 }
 function _define_property$r(obj, key, value) {
     if (key in obj) {
@@ -4330,10 +4397,10 @@ function _define_property$r(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array$a(iter) {
+function _iterable_to_array$c(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$a() {
+function _non_iterable_spread$c() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$l(target) {
@@ -4370,16 +4437,16 @@ function _object_spread_props$h(target, source) {
     }
     return target;
 }
-function _to_consumable_array$a(arr) {
-    return _array_without_holes$a(arr) || _iterable_to_array$a(arr) || _unsupported_iterable_to_array$e(arr) || _non_iterable_spread$a();
+function _to_consumable_array$c(arr) {
+    return _array_without_holes$c(arr) || _iterable_to_array$c(arr) || _unsupported_iterable_to_array$f(arr) || _non_iterable_spread$c();
 }
-function _unsupported_iterable_to_array$e(o, minLen) {
+function _unsupported_iterable_to_array$f(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$e(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$f(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$e(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$f(o, minLen);
 }
 /**
  * Filters out constraints that should not be directly specified in pagination queries.
@@ -4442,13 +4509,13 @@ function _unsupported_iterable_to_array$e(o, minLen) {
                     // Add Limit
                     var limitCount = filterLimit !== null && filterLimit !== void 0 ? filterLimit : itemsPerPage + (startAfterFilter ? 1 : 0); // todo: may not be needed.
                     var limitConstraint = limit(limitCount);
-                    var constraintsWithLimit = _to_consumable_array$a(constraints).concat([
+                    var constraintsWithLimit = _to_consumable_array$c(constraints).concat([
                         limitConstraint
                     ]);
                     // make query
                     var batchQuery = (_driver = driver).query.apply(_driver, [
                         queryLike
-                    ].concat(_to_consumable_array$a(constraintsWithLimit)));
+                    ].concat(_to_consumable_array$c(constraintsWithLimit)));
                     var resultPromise = driver.getDocs(batchQuery).then(function(snapshot) {
                         var time = new Date();
                         var docs = snapshot.docs;
@@ -4677,7 +4744,7 @@ function _firestoreItemPageIterationWithSnapshotIteration(snapshotIteration) {
                             return snapshot;
                         });
                     };
-                    var resultPromise = _loadFakeQuerySnapshot().then(function(snapshot) {
+                    return _loadFakeQuerySnapshot().then(function(snapshot) {
                         var result = {
                             value: {
                                 time: time,
@@ -4686,7 +4753,7 @@ function _firestoreItemPageIterationWithSnapshotIteration(snapshotIteration) {
                                 reload: function reload() {
                                     return _loadFakeQuerySnapshot();
                                 },
-                                stream: function stream(options) {
+                                stream: function stream(_options) {
                                     // TODO: Count potentially stream to fully implement, but might not be used anyways.
                                     return rxjs$1.of(snapshot);
                                 }
@@ -4695,7 +4762,6 @@ function _firestoreItemPageIterationWithSnapshotIteration(snapshotIteration) {
                         };
                         return result;
                     });
-                    return resultPromise;
                 }
             }));
         }
@@ -4705,13 +4771,13 @@ function _firestoreItemPageIterationWithSnapshotIteration(snapshotIteration) {
     return _firestoreItemPageIterationWithSnapshotIteration(snapshotIteration);
 }
 
-function _array_like_to_array$d(arr, len) {
+function _array_like_to_array$e(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$9(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$d(arr);
+function _array_without_holes$b(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$e(arr);
 }
 function asyncGeneratorStep$g(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -4742,22 +4808,22 @@ function _async_to_generator$g(fn) {
         });
     };
 }
-function _iterable_to_array$9(iter) {
+function _iterable_to_array$b(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$9() {
+function _non_iterable_spread$b() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _to_consumable_array$9(arr) {
-    return _array_without_holes$9(arr) || _iterable_to_array$9(arr) || _unsupported_iterable_to_array$d(arr) || _non_iterable_spread$9();
+function _to_consumable_array$b(arr) {
+    return _array_without_holes$b(arr) || _iterable_to_array$b(arr) || _unsupported_iterable_to_array$e(arr) || _non_iterable_spread$b();
 }
-function _unsupported_iterable_to_array$d(o, minLen) {
+function _unsupported_iterable_to_array$e(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$d(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$e(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$d(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$e(o, minLen);
 }
 function _ts_generator$g(thisArg, body) {
     var f, y, t, _ = {
@@ -4895,7 +4961,7 @@ function _ts_generator$g(thisArg, body) {
         var allConstraints = util.flattenArrayOrValueArray(queryConstraints);
         var query = makeQuery.apply(void 0, [
             inputQuery
-        ].concat(_to_consumable_array$9(allConstraints)));
+        ].concat(_to_consumable_array$b(allConstraints)));
         var result = {
             query: query,
             countDocs: function countDocs1() {
@@ -4917,7 +4983,7 @@ function _ts_generator$g(thisArg, body) {
                                 constraintsForOneDoc = addOrReplaceLimitInConstraints(1)(allConstraints);
                                 query = makeQuery.apply(void 0, [
                                     inputQuery
-                                ].concat(_to_consumable_array$9(constraintsForOneDoc)));
+                                ].concat(_to_consumable_array$b(constraintsForOneDoc)));
                                 return [
                                     4,
                                     getDocs(query, transaction)
@@ -5021,7 +5087,7 @@ function _ts_generator$g(thisArg, body) {
     return snapshot.ref.path;
 }
 
-function _array_like_to_array$c(arr, len) {
+function _array_like_to_array$d(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
@@ -5133,15 +5199,15 @@ function _object_spread_props$g(target, source) {
     return target;
 }
 function _sliced_to_array$3(arr, i) {
-    return _array_with_holes$3(arr) || _iterable_to_array_limit$3(arr, i) || _unsupported_iterable_to_array$c(arr, i) || _non_iterable_rest$3();
+    return _array_with_holes$3(arr) || _iterable_to_array_limit$3(arr, i) || _unsupported_iterable_to_array$d(arr, i) || _non_iterable_rest$3();
 }
-function _unsupported_iterable_to_array$c(o, minLen) {
+function _unsupported_iterable_to_array$d(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$c(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$d(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$c(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$d(o, minLen);
 }
 function _ts_generator$f(thisArg, body) {
     var f, y, t, _ = {
@@ -5331,27 +5397,17 @@ function _ts_generator$f(thisArg, body) {
                     maxParallelCheckpoints: 1,
                     iterateSnapshotBatch: function iterateSnapshotBatch(docSnapshots) {
                         return _async_to_generator$f(function() {
-                            var performTasksResult;
                             return _ts_generator$f(this, function(_state) {
-                                switch(_state.label){
-                                    case 0:
-                                        return [
-                                            4,
-                                            util.performAsyncTasks(docSnapshots, iterateSnapshot, _object_spread$k({
-                                                sequential: true
-                                            }, snapshotsPerformTasksConfig !== null && snapshotsPerformTasksConfig !== void 0 ? snapshotsPerformTasksConfig : _object_spread_props$g(_object_spread$k({}, performTasksConfig), {
-                                                nonConcurrentTaskKeyFactory: undefined,
-                                                beforeRetry: undefined
-                                            }) // don't pass the nonConcurrentTaskKeyFactory
-                                            ))
-                                        ];
-                                    case 1:
-                                        performTasksResult = _state.sent();
-                                        return [
-                                            2,
-                                            performTasksResult
-                                        ];
-                                }
+                                return [
+                                    2,
+                                    util.performAsyncTasks(docSnapshots, iterateSnapshot, _object_spread$k({
+                                        sequential: true
+                                    }, snapshotsPerformTasksConfig !== null && snapshotsPerformTasksConfig !== void 0 ? snapshotsPerformTasksConfig : _object_spread_props$g(_object_spread$k({}, performTasksConfig), {
+                                        nonConcurrentTaskKeyFactory: undefined,
+                                        beforeRetry: undefined
+                                    }) // don't pass the nonConcurrentTaskKeyFactory
+                                    ))
+                                ];
                             });
                         })();
                     }
@@ -5466,14 +5522,9 @@ function _ts_generator$f(thisArg, body) {
                                     case 0:
                                         if (!(docSnapshots.length > 0)) return [
                                             3,
-                                            3
-                                        ];
-                                        return [
-                                            4,
-                                            batchSizeForSnapshots(docSnapshots)
+                                            2
                                         ];
-                                    case 1:
-                                        batchSizeForSnapshotsResult = _state.sent();
+                                        batchSizeForSnapshotsResult = batchSizeForSnapshots(docSnapshots);
                                         batches = batchSizeForSnapshotsResult === null ? [
                                             docSnapshots
                                         ] : util.batch(docSnapshots, batchSizeForSnapshotsResult);
@@ -5486,7 +5537,7 @@ function _ts_generator$f(thisArg, body) {
                                                 sequential: true
                                             }, performTasksConfig))
                                         ];
-                                    case 2:
+                                    case 1:
                                         performTasksResult = _state.sent();
                                         return [
                                             2,
@@ -5499,12 +5550,12 @@ function _ts_generator$f(thisArg, body) {
                                                 };
                                             })
                                         ];
-                                    case 3:
+                                    case 2:
                                         return [
                                             2,
                                             []
                                         ];
-                                    case 4:
+                                    case 3:
                                         return [
                                             2
                                         ];
@@ -5601,6 +5652,7 @@ function _ts_generator$f(thisArg, body) {
  */ function iterateFirestoreDocumentSnapshotCheckpoints(config) {
     return _async_to_generator$f(function() {
         var iterateCheckpoint, inputFilterCheckpointSnapshot, inputHandleRepeatCursor, waitBetweenCheckpoints, useCheckpointResult, inputConstraintsFactory, inputDynamicConstraints, queryFactory, _config_maxParallelCheckpoints, maxParallelCheckpoints, inputLimitPerCheckpoint, inputTotalSnapshotsLimit, constraintsInputIsFactory, constraintsFactory, limitPerCheckpoint, totalSnapshotsLimit, currentIndex, hasReachedEnd, totalSnapshotsLimitReached, totalSnapshotsVisited, cursorDocument, visitedCursorPaths, handleRepeatCursor, filterCheckpointSnapshot, performTaskFn, result;
+        // eslint-disable-next-line sonarjs/cognitive-complexity -- cursor-based pagination logic with repeat detection is inherently complex
         function taskInputFactory() {
             return _async_to_generator$f(function() {
                 var result, constraints, startAfterFilter, shouldContinue, totalPossibleNumberOfItemsLeftToLoad, nextLimit, query, docQuerySnapshot, docSnapshots, nextCursorDocument, cursorPath, repeatResult, newSnapshotsVisited, i;
@@ -6166,7 +6218,7 @@ function _ts_generator$e(thisArg, body) {
     }), rxjs$1.shareReplay(1));
     var event$ = stream$.pipe(rxjs$1.map(function(event) {
         var changes = event.docChanges();
-        var results = util.build({
+        return util.build({
             base: util.groupValues(changes, function(x) {
                 return x.type;
             }),
@@ -6180,7 +6232,6 @@ function _ts_generator$e(thisArg, body) {
                 x.type = iterationQueryDocChangeWatcherChangeTypeForGroup(x);
             }
         });
-        return results;
     }), rxjs$1.shareReplay(1));
     return {
         stream$: stream$,
@@ -6219,13 +6270,13 @@ function _ts_generator$e(thisArg, body) {
     return type;
 }
 
-function _array_like_to_array$b(arr, len) {
+function _array_like_to_array$c(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$8(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$b(arr);
+function _array_without_holes$a(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$c(arr);
 }
 function asyncGeneratorStep$d(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -6256,22 +6307,22 @@ function _async_to_generator$d(fn) {
         });
     };
 }
-function _iterable_to_array$8(iter) {
+function _iterable_to_array$a(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$8() {
+function _non_iterable_spread$a() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
-function _to_consumable_array$8(arr) {
-    return _array_without_holes$8(arr) || _iterable_to_array$8(arr) || _unsupported_iterable_to_array$b(arr) || _non_iterable_spread$8();
+function _to_consumable_array$a(arr) {
+    return _array_without_holes$a(arr) || _iterable_to_array$a(arr) || _unsupported_iterable_to_array$c(arr) || _non_iterable_spread$a();
 }
-function _unsupported_iterable_to_array$b(o, minLen) {
+function _unsupported_iterable_to_array$c(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$b(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$c(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$b(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$c(o, minLen);
 }
 function _ts_generator$d(thisArg, body) {
     var f, y, t, _ = {
@@ -6489,7 +6540,7 @@ function _ts_generator$d(thisArg, body) {
                 for(var _len = arguments.length, queryConstraints = new Array(_len), _key = 0; _key < _len; _key++){
                     queryConstraints[_key] = arguments[_key];
                 }
-                return wrapQuery((_baseQuery = baseQuery).filter.apply(_baseQuery, _to_consumable_array$8(queryConstraints)));
+                return wrapQuery((_baseQuery = baseQuery).filter.apply(_baseQuery, _to_consumable_array$a(queryConstraints)));
             }
         };
     };
@@ -6499,18 +6550,18 @@ function _ts_generator$d(thisArg, body) {
             for(var _len = arguments.length, queryConstraints = new Array(_len), _key = 0; _key < _len; _key++){
                 queryConstraints[_key] = arguments[_key];
             }
-            return wrapQuery((_queryFactory = queryFactory).query.apply(_queryFactory, _to_consumable_array$8(queryConstraints)));
+            return wrapQuery((_queryFactory = queryFactory).query.apply(_queryFactory, _to_consumable_array$a(queryConstraints)));
         }
     };
 }
 
-function _array_like_to_array$a(arr, len) {
+function _array_like_to_array$b(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$7(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$a(arr);
+function _array_without_holes$9(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$b(arr);
 }
 function _define_property$p(obj, key, value) {
     if (key in obj) {
@@ -6525,10 +6576,10 @@ function _define_property$p(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array$7(iter) {
+function _iterable_to_array$9(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$7() {
+function _non_iterable_spread$9() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$j(target) {
@@ -6565,20 +6616,20 @@ function _object_spread_props$f(target, source) {
     }
     return target;
 }
-function _to_consumable_array$7(arr) {
-    return _array_without_holes$7(arr) || _iterable_to_array$7(arr) || _unsupported_iterable_to_array$a(arr) || _non_iterable_spread$7();
+function _to_consumable_array$9(arr) {
+    return _array_without_holes$9(arr) || _iterable_to_array$9(arr) || _unsupported_iterable_to_array$b(arr) || _non_iterable_spread$9();
 }
 function _type_of$9(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _unsupported_iterable_to_array$a(o, minLen) {
+function _unsupported_iterable_to_array$b(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$a(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$b(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$a(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$b(o, minLen);
 }
 /**
  * Separator used in Firestore paths to separate collection and document IDs.
@@ -6608,6 +6659,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
 }
 /**
  * Creates a FirestoreModelIdentityTypeMap from the input identities.
+ *
  * @param identities
  * @returns
  */ function firestoreModelIdentityTypeMap(identities) {
@@ -6651,8 +6703,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
     } else {
         key = input;
     }
-    var result = id ? id : util.lastValue(key.split(FIRESTORE_COLLECTION_NAME_SEPARATOR));
-    return result;
+    return id !== null && id !== void 0 ? id : util.lastValue(key.split(FIRESTORE_COLLECTION_NAME_SEPARATOR));
 }
 /**
  * Returns the array of ids within a FirestoreModelKey.
@@ -6688,7 +6739,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
  * @param key
  * @returns
  */ function inferKeyFromTwoWayFlatFirestoreModelKey(key) {
-    return key.replace(/\_/g, FIRESTORE_COLLECTION_NAME_SEPARATOR);
+    return key.replace(/_/g, FIRESTORE_COLLECTION_NAME_SEPARATOR);
 }
 /**
  * Firestore Model Id Regex
@@ -6698,7 +6749,8 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
 /**
  * Returns true if the input string is a FirestoreModelId.
  *
- * @param input
+ * @param input - The string to test
+ * @returns True if the input is a valid FirestoreModelId
  */ function isFirestoreModelId(input) {
     return FIRESTORE_MODEL_ID_REGEX.test(input);
 }
@@ -6722,14 +6774,16 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
 /**
  * Returns true if the input string is a FirestoreModelKey.
  *
- * @param input
+ * @param input - The string to test
+ * @returns True if the input is a valid FirestoreModelKey
  */ function isFirestoreModelKey(input) {
     return FIRESTORE_MODEL_KEY_REGEX.test(input);
 }
 /**
- * Returns true if the input string is a FirestoreModelId.
+ * Returns true if the input string is a FirestoreModelId or a FirestoreModelKey.
  *
- * @param input
+ * @param input - The string to test
+ * @returns True if the input is a valid FirestoreModelId or FirestoreModelKey
  */ function isFirestoreModelIdOrKey(input) {
     return util.stringContains(input, '/') ? FIRESTORE_MODEL_KEY_REGEX.test(input) : FIRESTORE_MODEL_ID_REGEX.test(input);
 }
@@ -6751,6 +6805,9 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
  */ var firestoreModelKey = firestoreModelKeyPart;
 /**
  * Creates a FirestoreModelKeyFactory for the input root identity.
+ *
+ * @param identity - The root FirestoreModelIdentity to bind the factory to
+ * @returns A factory function that creates FirestoreModelKey values for the given identity and a provided id
  */ function firestoreModelKeyFactory(identity) {
     return function(id) {
         return firestoreModelKey(identity, id);
@@ -6814,7 +6871,12 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
         return "".concat(parent).concat(FIRESTORE_COLLECTION_NAME_SEPARATOR).concat(childPath);
     });
 }
-function firestoreModelKeyPairObject(input) {
+/**
+ * Converts a FirestoreModelKey or reference into a record mapping each collection name to its document id.
+ *
+ * @param input - The FirestoreModelKey, DocumentReferenceRef, or FirestoreModelKeyRef to convert
+ * @returns An object mapping collection names to document ids, or undefined if the key is unavailable
+ */ function firestoreModelKeyPairObject(input) {
     var pairs = firestoreModelKeyPartPairs(input);
     var object;
     if (pairs) {
@@ -6826,22 +6888,44 @@ function firestoreModelKeyPairObject(input) {
     }
     return object;
 }
-function firestoreModelKeyCollectionType(input) {
+/**
+ * Returns the FirestoreCollectionType derived from the input FirestoreModelKey.
+ *
+ * @param input - The key or reference to extract the collection type from
+ * @returns The FirestoreCollectionType string, or undefined if the key is unavailable
+ */ function firestoreModelKeyCollectionType(input) {
     return firestoreModelKeyCollectionTypeArrayName(input, FIRESTORE_COLLECTION_NAME_SEPARATOR);
 }
-function firestoreModelKeyCollectionTypeArrayName(input) {
+/**
+ * Returns the collection type array name string derived from the input key, joined by the given separator.
+ *
+ * @param input - The key or reference to extract collection names from
+ * @param separator - The separator to join collection names with; defaults to the Firestore collection name separator
+ * @returns The joined collection type array name string, or undefined if the key is unavailable
+ */ function firestoreModelKeyCollectionTypeArrayName(input) {
     var separator = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : FIRESTORE_COLLECTION_NAME_SEPARATOR;
     var _firestoreModelKeyCollectionTypeArray;
     return (_firestoreModelKeyCollectionTypeArray = firestoreModelKeyCollectionTypeArray(input)) === null || _firestoreModelKeyCollectionTypeArray === void 0 ? void 0 : _firestoreModelKeyCollectionTypeArray.join(separator);
 }
-function firestoreIdentityTypeArrayName(input) {
+/**
+ * Returns the collection type array name string derived from a FirestoreModelIdentity, joined by the given separator.
+ *
+ * @param input - The FirestoreModelIdentity to derive collection names from
+ * @param separator - The separator to join collection names with; defaults to the Firestore collection name separator
+ * @returns The joined collection type array name string
+ */ function firestoreIdentityTypeArrayName(input) {
     var separator = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : FIRESTORE_COLLECTION_NAME_SEPARATOR;
     return firestoreIdentityTypeArray(input).join(separator);
 }
-function firestoreIdentityTypeArray(input) {
+/**
+ * Returns an ordered array of collection names derived from a FirestoreModelIdentity, from root to leaf.
+ *
+ * @param input - The FirestoreModelIdentity to traverse
+ * @returns An array of FirestoreCollectionName values ordered from root to leaf
+ */ function firestoreIdentityTypeArray(input) {
     var array = [];
     var current = input;
-    while(true){
+    for(;;){
         array.push(current.collectionName);
         if (current.type === 'nested') {
             current = current.parent;
@@ -6851,11 +6935,16 @@ function firestoreIdentityTypeArray(input) {
     }
     return array.reverse();
 }
-function firestoreModelKeyCollectionTypeArray(input) {
+/**
+ * Returns an ordered array of collection names derived from the input FirestoreModelKey.
+ *
+ * @param input - The key or reference to extract collection names from
+ * @returns An array of FirestoreCollectionName values, or undefined if the key is unavailable
+ */ function firestoreModelKeyCollectionTypeArray(input) {
     var key = readFirestoreModelKey(input);
     var array;
     if (key) {
-        var pieces = key === null || key === void 0 ? void 0 : key.split(FIRESTORE_COLLECTION_NAME_SEPARATOR);
+        var pieces = key.split(FIRESTORE_COLLECTION_NAME_SEPARATOR);
         if (util.isOddNumber(pieces.length)) {
             throw new Error('input key source was a collection ref or unavailable.');
         }
@@ -6870,8 +6959,8 @@ function firestoreModelKeyCollectionTypeArray(input) {
 /**
  * Returns the collection name of the input key.
  *
- * @param input
- * @returns
+ * @param input - The key or reference to extract the collection name from
+ * @returns The FirestoreCollectionName from the deepest key pair, or undefined if unavailable
  */ function firestoreModelKeyCollectionName(input) {
     var _firestoreModelKeyTypePair;
     return (_firestoreModelKeyTypePair = firestoreModelKeyTypePair(input)) === null || _firestoreModelKeyTypePair === void 0 ? void 0 : _firestoreModelKeyTypePair.collectionName;
@@ -6879,8 +6968,9 @@ function firestoreModelKeyCollectionTypeArray(input) {
 /**
  * Returns the parent model key from up the specified amount of levels.
  *
- * @param input
- * @param maxLevelsUp
+ * @param input - The key or reference to extract the parent key from
+ * @param maxLevelsUp - The number of levels to traverse up the key hierarchy; defaults to 1
+ * @returns The parent FirestoreModelKey, or undefined if no parent exists
  */ function firestoreModelKeyParentKey(input) {
     var maxLevelsUp = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 1;
     var keyParts = firestoreModelKeyParentKeyPartPairs(input, maxLevelsUp);
@@ -6890,7 +6980,13 @@ function firestoreModelKeyCollectionTypeArray(input) {
     }
     return result;
 }
-function firestoreModelKeyParentKeyPartPairs(input) {
+/**
+ * Returns the collection/id pair array truncated by the specified number of levels from the end.
+ *
+ * @param input - The key or reference to extract pairs from
+ * @param maxLevelsUp - The number of levels to remove from the end; defaults to 1
+ * @returns An array of FirestoreModelCollectionAndIdPair values up to the parent level, or undefined if unavailable
+ */ function firestoreModelKeyParentKeyPartPairs(input) {
     var maxLevelsUp = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 1;
     var allParts = firestoreModelKeyPartPairs(input);
     var parentParts = undefined;
@@ -6908,11 +7004,16 @@ function firestoreModelKeyParentKeyPartPairs(input) {
  */ function firestoreModelKeyTypePair(input) {
     return util.lastValue(firestoreModelKeyPartPairs(input));
 }
-function firestoreModelKeyPartPairs(input) {
+/**
+ * Parses a FirestoreModelKey into an ordered array of collection/id pair objects.
+ *
+ * @param input - The key or reference to parse
+ * @returns An array of FirestoreModelCollectionAndIdPair values, or undefined if the key is unavailable
+ */ function firestoreModelKeyPartPairs(input) {
     var key = readFirestoreModelKey(input);
     var pairs;
     if (key) {
-        var pieces = key === null || key === void 0 ? void 0 : key.split(FIRESTORE_COLLECTION_NAME_SEPARATOR);
+        var pieces = key.split(FIRESTORE_COLLECTION_NAME_SEPARATOR);
         if (util.isOddNumber(pieces.length)) {
             throw new Error('input key source was a collection ref or unavailable.');
         }
@@ -6934,7 +7035,7 @@ function firestoreModelKeyPartPairs(input) {
  * @param input
  * @returns
  */ function firestoreModelKeyPartPairsKeyPath(input) {
-    return firestoreModelKeyPath.apply(void 0, _to_consumable_array$7(firestoreModelKeyPartPairsPaths(input)));
+    return firestoreModelKeyPath.apply(void 0, _to_consumable_array$9(firestoreModelKeyPartPairsPaths(input)));
 }
 /**
  * Maps the input FirestoreModelCollectionAndIdPair[] values to FirestoreModelKeyPart[] values.
@@ -6989,7 +7090,7 @@ var FIRESTORE_DUMMY_MODEL_KEY = 'dummymodel/dummykey';
  *
  * @template T - The data type of documents in the collection
  * @template D - The FirestoreDocument type that wraps the data
- * @param config - Configuration for the collection
+ * @param inputConfig - Configuration for the collection
  * @returns A fully configured FirestoreCollection instance
  */ function makeFirestoreCollection(inputConfig) {
     var config = inputConfig;
@@ -7032,13 +7133,12 @@ var FIRESTORE_DUMMY_MODEL_KEY = 'dummymodel/dummykey';
  * @param config - Configuration for the single document collection
  * @returns A RootSingleItemFirestoreCollection instance configured for the specified document
  */ function makeRootSingleItemFirestoreCollection(config) {
-    var collection = util.build({
+    return util.build({
         base: makeFirestoreCollection(config),
         build: function build(x) {
             extendFirestoreCollectionWithSingleDocumentAccessor(x, config.singleItemIdentifier);
         }
     });
-    return collection;
 }
 
 function _define_property$o(obj, key, value) {
@@ -7189,23 +7289,22 @@ function _object_spread_props$e(target, source) {
  * @param config - Configuration for the single document subcollection
  * @returns A subcollection instance with specialized accessors for the single document
  */ function makeSingleItemFirestoreCollection(config) {
-    var collection = util.build({
+    return util.build({
         base: makeFirestoreCollectionWithParent(config),
         build: function build(x) {
             // Extend the collection with single document accessor capabilities
             extendFirestoreCollectionWithSingleDocumentAccessor(x, config.singleItemIdentifier);
         }
     });
-    return collection;
 }
 
-function _array_like_to_array$9(arr, len) {
+function _array_like_to_array$a(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$6(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$9(arr);
+function _array_without_holes$8(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$a(arr);
 }
 function _define_property$n(obj, key, value) {
     if (key in obj) {
@@ -7220,10 +7319,10 @@ function _define_property$n(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array$6(iter) {
+function _iterable_to_array$8(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$6() {
+function _non_iterable_spread$8() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$h(target) {
@@ -7260,16 +7359,16 @@ function _object_spread_props$d(target, source) {
     }
     return target;
 }
-function _to_consumable_array$6(arr) {
-    return _array_without_holes$6(arr) || _iterable_to_array$6(arr) || _unsupported_iterable_to_array$9(arr) || _non_iterable_spread$6();
+function _to_consumable_array$8(arr) {
+    return _array_without_holes$8(arr) || _iterable_to_array$8(arr) || _unsupported_iterable_to_array$a(arr) || _non_iterable_spread$8();
 }
-function _unsupported_iterable_to_array$9(o, minLen) {
+function _unsupported_iterable_to_array$a(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$9(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$a(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$9(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$a(o, minLen);
 }
 /**
  * Creates a factory function for generating FirestoreContext instances.
@@ -7285,11 +7384,10 @@ function _unsupported_iterable_to_array$9(o, minLen) {
     return function(firestore) {
         var _drivers_firestoreAccessorDriver;
         var makeFirestoreCollectionConfig = function makeFirestoreCollectionConfig(config) {
-            var _config_collection;
-            var _config_collection1;
-            var queryLike = (_config_collection = config.collection) !== null && _config_collection !== void 0 ? _config_collection : config.queryLike;
+            var collection = config.collection;
+            var queryLike = collection !== null && collection !== void 0 ? collection : config.queryLike;
             return _object_spread_props$d(_object_spread$h({}, config), {
-                collection: config.converter ? (_config_collection1 = config.collection) === null || _config_collection1 === void 0 ? void 0 : _config_collection1.withConverter(config.converter) : config.collection,
+                collection: config.converter ? collection === null || collection === void 0 ? void 0 : collection.withConverter(config.converter) : collection,
                 queryLike: config.converter ? queryLike.withConverter(config.converter) : queryLike,
                 firestoreContext: context,
                 firestoreDriverIdentifier: drivers.firestoreDriverIdentifier,
@@ -7317,7 +7415,7 @@ function _unsupported_iterable_to_array$9(o, minLen) {
                 return (_drivers_firestoreAccessorDriver = drivers.firestoreAccessorDriver).collection.apply(_drivers_firestoreAccessorDriver, [
                     firestore,
                     path
-                ].concat(_to_consumable_array$6(pathSegments)));
+                ].concat(_to_consumable_array$8(pathSegments)));
             },
             subcollection: drivers.firestoreAccessorDriver.subcollection,
             runTransaction: drivers.firestoreAccessorDriver.transactionFactoryForFirestore(firestore),
@@ -7529,9 +7627,10 @@ function _ts_generator$c(thisArg, body) {
  * // verifier can now check batches of IDs for uniqueness
  * ```
  */ function firestoreIdBatchVerifierFactory(config) {
+    var _config_makeQueryConstraints;
     var readKeys = config.readKeys;
     var fieldToQuery = config.fieldToQuery;
-    var makeQueryConstraints = config.makeQueryConstraints ? config.makeQueryConstraints : fieldToQuery === '_id' ? function(ids) {
+    var makeQueryConstraints = (_config_makeQueryConstraints = config.makeQueryConstraints) !== null && _config_makeQueryConstraints !== void 0 ? _config_makeQueryConstraints : fieldToQuery === '_id' ? function(ids) {
         return whereDocumentId('in', ids);
     } : function(ids) {
         return where(fieldToQuery, 'in', ids);
@@ -7539,7 +7638,7 @@ function _ts_generator$c(thisArg, body) {
     return function(collection) {
         var verify = function verify(keys) {
             return _async_to_generator$c(function() {
-                var constraints, results, keysInResults, unusedKeys;
+                var constraints, results, keysInResults;
                 return _ts_generator$c(this, function(_state) {
                     switch(_state.label){
                         case 0:
@@ -7550,13 +7649,12 @@ function _ts_generator$c(thisArg, body) {
                             ];
                         case 1:
                             results = _state.sent();
-                            keysInResults = results.docs.map(function(x) {
+                            keysInResults = results.docs.flatMap(function(x) {
                                 return readKeys(x);
-                            }).flat();
-                            unusedKeys = util.unique(keys, keysInResults);
+                            });
                             return [
                                 2,
-                                unusedKeys
+                                util.unique(keys, keysInResults)
                             ];
                     }
                 });
@@ -7578,6 +7676,7 @@ function _ts_generator$c(thisArg, body) {
  * Checks for document existence first, then calls `set()` if the document is absent.
  *
  * @param accessor - the accessor to perform the existence check and set operation on
+ * @returns a function that creates the document if it does not exist, or throws if it does
  * @throws {Error} When the document already exists at the reference path
  *
  * @example
@@ -7617,13 +7716,13 @@ function _ts_generator$c(thisArg, body) {
     });
 }
 
-function _array_like_to_array$8(arr, len) {
+function _array_like_to_array$9(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$5(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$8(arr);
+function _array_without_holes$7(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$9(arr);
 }
 function _define_property$m(obj, key, value) {
     if (key in obj) {
@@ -7638,10 +7737,10 @@ function _define_property$m(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array$5(iter) {
+function _iterable_to_array$7(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$5() {
+function _non_iterable_spread$7() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$g(target) {
@@ -7659,16 +7758,16 @@ function _object_spread$g(target) {
     }
     return target;
 }
-function _to_consumable_array$5(arr) {
-    return _array_without_holes$5(arr) || _iterable_to_array$5(arr) || _unsupported_iterable_to_array$8(arr) || _non_iterable_spread$5();
+function _to_consumable_array$7(arr) {
+    return _array_without_holes$7(arr) || _iterable_to_array$7(arr) || _unsupported_iterable_to_array$9(arr) || _non_iterable_spread$7();
 }
-function _unsupported_iterable_to_array$8(o, minLen) {
+function _unsupported_iterable_to_array$9(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$8(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$9(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$8(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$9(o, minLen);
 }
 /**
  * Converts a {@link FirestoreAccessorArrayUpdate} into Firestore `UpdateData` using the
@@ -7689,15 +7788,15 @@ function _unsupported_iterable_to_array$8(o, minLen) {
  * await updateDoc(docRef, updateData);
  * ```
  */ function firestoreClientArrayUpdateToUpdateData(input) {
-    var union = input === null || input === void 0 ? void 0 : input.union;
-    var remove = input === null || input === void 0 ? void 0 : input.remove;
+    var union = input.union;
+    var remove = input.remove;
     function createUpdatesWithArrayFunction(fieldUpdate, arrayUpdateFunction) {
         var result;
         if (fieldUpdate) {
             result = util.mapObjectMap(fieldUpdate, function(arrayUpdate) {
                 var result;
                 if (arrayUpdate) {
-                    result = arrayUpdateFunction.apply(void 0, _to_consumable_array$5(arrayUpdate)); // use spread operator to insert each value as an argument, as "nested arrays" are not allowed in the Firestore
+                    result = arrayUpdateFunction.apply(void 0, _to_consumable_array$7(arrayUpdate)); // use spread operator to insert each value as an argument, as "nested arrays" are not allowed in the Firestore
                 }
                 return result;
             });
@@ -7836,6 +7935,8 @@ function _define_property$l(obj, key, value) {
  * Creates a {@link FirestoreDocumentDataAccessorFactory} that produces {@link DefaultFirestoreDocumentDataAccessor} instances
  * for direct (non-batched, non-transactional) Firestore operations.
  *
+ * @returns a factory that creates default (non-transactional) document data accessors
+ *
  * @example
  * ```ts
  * const factory = defaultFirestoreAccessorFactory<MyModel>();
@@ -7856,6 +7957,8 @@ function _define_property$l(obj, key, value) {
  * The context type is {@link FirestoreDocumentContextType.NONE}, meaning operations execute immediately
  * against Firestore without transaction or batch grouping.
  *
+ * @returns a default {@link FirestoreDocumentContext} with no transaction or batch semantics
+ *
  * @example
  * ```ts
  * const context = defaultFirestoreDocumentContext<MyModel>();
@@ -8009,6 +8112,7 @@ function _is_native_reflect_construct$7() {
  * into the same batch.
  *
  * @param writeBatch - the Firestore `WriteBatch` to queue operations into
+ * @returns a factory that creates write-batch-backed document data accessors for any document reference
  *
  * @example
  * ```ts
@@ -8054,6 +8158,7 @@ function _is_native_reflect_construct$7() {
  * Factory function that creates a {@link WriteBatchFirestoreDocumentContext} for the given batch.
  *
  * @param batch - the Firestore `WriteBatch` to use for all document operations
+ * @returns a new {@link WriteBatchFirestoreDocumentContext} bound to the given batch
  *
  * @example
  * ```ts
@@ -8198,6 +8303,7 @@ function _define_property$j(obj, key, value) {
  * instances bound to the given transaction. All operations from these accessors participate in the same transaction.
  *
  * @param transaction - the Firestore `Transaction` to bind operations to
+ * @returns a factory that creates transaction-backed document data accessors for any document reference
  *
  * @example
  * ```ts
@@ -8244,6 +8350,7 @@ function _define_property$j(obj, key, value) {
  * Factory function that creates a {@link TransactionFirestoreDocumentContext} for the given transaction.
  *
  * @param transaction - the Firestore `Transaction` to use for all document operations
+ * @returns a new {@link TransactionFirestoreDocumentContext} bound to the given transaction
  *
  * @example
  * ```ts
@@ -8391,6 +8498,8 @@ function _ts_generator$b(thisArg, body) {
  * - Transaction and write batch context factories for atomic operations
  * - A default (non-transactional) document context
  *
+ * @returns a {@link FirestoreAccessorDriver} backed by the `firebase/firestore` client SDK
+ *
  * @example
  * ```ts
  * const driver = firestoreClientAccessorDriver();
@@ -8407,18 +8516,10 @@ function _ts_generator$b(thisArg, body) {
             return function(fn) {
                 return _async_to_generator$b(function() {
                     return _ts_generator$b(this, function(_state) {
-                        switch(_state.label){
-                            case 0:
-                                return [
-                                    4,
-                                    firestore.runTransaction(firestore$1, fn)
-                                ];
-                            case 1:
-                                return [
-                                    2,
-                                    _state.sent()
-                                ];
-                        }
+                        return [
+                            2,
+                            firestore.runTransaction(firestore$1, fn)
+                        ];
                     });
                 })();
             };
@@ -8434,13 +8535,13 @@ function _ts_generator$b(thisArg, body) {
     };
 }
 
-function _array_like_to_array$7(arr, len) {
+function _array_like_to_array$8(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$4(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$7(arr);
+function _array_without_holes$6(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$8(arr);
 }
 function _define_property$i(obj, key, value) {
     if (key in obj) {
@@ -8455,10 +8556,10 @@ function _define_property$i(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array$4(iter) {
+function _iterable_to_array$6(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$4() {
+function _non_iterable_spread$6() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$f(target) {
@@ -8495,26 +8596,29 @@ function _object_spread_props$c(target, source) {
     }
     return target;
 }
-function _to_consumable_array$4(arr) {
-    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$7(arr) || _non_iterable_spread$4();
+function _to_consumable_array$6(arr) {
+    return _array_without_holes$6(arr) || _iterable_to_array$6(arr) || _unsupported_iterable_to_array$8(arr) || _non_iterable_spread$6();
 }
-function _unsupported_iterable_to_array$7(o, minLen) {
+function _unsupported_iterable_to_array$8(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$7(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$8(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$7(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$8(o, minLen);
 }
 /**
  * Appends one or more `QueryConstraint` values to the builder, returning a new builder instance.
  *
  * @param builder - current query builder state
  * @param constraint - constraint(s) to append
+ * @returns a new {@link FirebaseFirestoreQueryBuilder} with the added constraint(s)
  */ function addConstraintToBuilder(builder, constraint) {
     return {
         query: builder.query,
-        constraints: builder.constraints.concat(constraint)
+        constraints: _to_consumable_array$6(builder.constraints).concat(_to_consumable_array$6(Array.isArray(constraint) ? constraint : [
+            constraint
+        ]))
     };
 }
 var _obj;
@@ -8537,13 +8641,13 @@ var _obj;
 }), _define_property$i(_obj, FIRESTORE_OFFSET_QUERY_CONSTRAINT_TYPE, undefined), _define_property$i(_obj, FIRESTORE_START_AT_QUERY_CONSTRAINT_TYPE, function(builder, data) {
     return addConstraintToBuilder(builder, firestore.startAt(data.snapshot));
 }), _define_property$i(_obj, FIRESTORE_START_AT_VALUE_QUERY_CONSTRAINT_TYPE, function(builder, data) {
-    return addConstraintToBuilder(builder, firestore.startAt.apply(void 0, _to_consumable_array$4(data.fieldValues)));
+    return addConstraintToBuilder(builder, firestore.startAt.apply(void 0, _to_consumable_array$6(data.fieldValues)));
 }), _define_property$i(_obj, FIRESTORE_START_AFTER_QUERY_CONSTRAINT_TYPE, function(builder, data) {
     return addConstraintToBuilder(builder, firestore.startAfter(data.snapshot));
 }), _define_property$i(_obj, FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE, function(builder, data) {
     return addConstraintToBuilder(builder, firestore.endAt(data.snapshot));
 }), _define_property$i(_obj, FIRESTORE_END_AT_VALUE_QUERY_CONSTRAINT_TYPE, function(builder, data) {
-    return addConstraintToBuilder(builder, firestore.endAt.apply(void 0, _to_consumable_array$4(data.fieldValues)));
+    return addConstraintToBuilder(builder, firestore.endAt.apply(void 0, _to_consumable_array$6(data.fieldValues)));
 }), _define_property$i(_obj, FIRESTORE_END_BEFORE_QUERY_CONSTRAINT_TYPE, function(builder, data) {
     return addConstraintToBuilder(builder, firestore.endBefore(data.snapshot));
 }), _obj);
@@ -8552,6 +8656,8 @@ var _obj;
  *
  * Converts abstract query constraints into `firebase/firestore` `QueryConstraint` objects
  * and composes them into an executable `Query`.
+ *
+ * @returns a {@link FirestoreQueryConstraintFunctionsDriver} backed by the `firebase/firestore` client SDK
  */ function firebaseFirestoreQueryConstraintFunctionsDriver() {
     return makeFirestoreQueryConstraintFunctionsDriver({
         mapping: FIRESTORE_CLIENT_QUERY_CONSTRAINT_HANDLER_MAPPING,
@@ -8565,7 +8671,7 @@ var _obj;
             var initialQuery = param.query, constraints = param.constraints;
             return firestore.query.apply(void 0, [
                 initialQuery
-            ].concat(_to_consumable_array$4(constraints)));
+            ].concat(_to_consumable_array$6(constraints)));
         },
         documentIdFieldPath: function documentIdFieldPath() {
             return firestore.documentId();
@@ -8579,6 +8685,8 @@ var _obj;
  * Note: Transactions are not supported for queries on the client; passing a `transaction` to `getDocs`
  * will throw an error.
  *
+ * @returns a {@link FirestoreQueryDriver} backed by the `firebase/firestore` client SDK
+ *
  * @example
  * ```ts
  * const queryDriver = firebaseFirestoreQueryDriver();
@@ -8613,6 +8721,8 @@ var _obj;
  * Provides accessor drivers (default, batch, transaction) and query drivers for use
  * with {@link clientFirebaseFirestoreContextFactory}.
  *
+ * @returns the client-side {@link FirebaseFirestoreClientDrivers} for the `firebase/firestore` SDK
+ *
  * @example
  * ```ts
  * const drivers = firebaseFirestoreClientDrivers();
@@ -8792,6 +8902,7 @@ function _is_native_reflect_construct$6() {
      * structured error details from the error's `details` property if available.
      *
      * @param error - the Firebase error from an `HttpsCallable` failure
+     * @returns a new {@link FirebaseServerError} wrapping the given Firebase error with structured server error details
      */ function fromFirebaseError(error) {
                 var details = error.details;
                 details = _object_spread$e({
@@ -9057,6 +9168,7 @@ function mapHttpsCallable(callable, wrap) {
  * Errors are converted to readable errors via {@link convertHttpsCallableErrorToReadableError}.
  *
  * @param callable - the `HttpsCallable` to wrap
+ * @returns a {@link DirectDataHttpsCallable} that resolves to the response data directly
  *
  * @example
  * ```ts
@@ -9079,6 +9191,7 @@ function mapHttpsCallable(callable, wrap) {
  * to preserve server-side error context. Otherwise, converts it to a generic readable error via `toReadableError`.
  *
  * @param error - the caught error from an `HttpsCallable` invocation
+ * @returns a {@link FirebaseServerError} if the error has structured details, or a generic readable error otherwise
  */ function convertHttpsCallableErrorToReadableError(error) {
     var result;
     if ((typeof error === "undefined" ? "undefined" : _type_of$6(error)) === 'object') {
@@ -9093,7 +9206,7 @@ function mapHttpsCallable(callable, wrap) {
     return result;
 }
 
-/* eslint-disable @typescript-eslint/no-explicit-any */ // The use of any here does not degrade the type-safety. The correct type is inferred in most cases.
+// The use of any here does not degrade the type-safety. The correct type is inferred in most cases.
 /**
  * Creates a {@link FirebaseFunctionMapFactory} from a configuration map.
  *
@@ -9101,6 +9214,7 @@ function mapHttpsCallable(callable, wrap) {
  * for direct data access. Per-key options (e.g., timeout) are applied if provided.
  *
  * @param configMap - maps function keys to their optional configuration
+ * @returns a {@link FirebaseFunctionMapFactory} that creates a typed callable function map for a given `Functions` instance
  *
  * @example
  * ```ts
@@ -9121,8 +9235,7 @@ function mapHttpsCallable(callable, wrap) {
             var fn = directDataHttpsCallable(functions.httpsCallable(functionsInstance, key, httpCallableOptions));
             return fn;
         };
-        var result = util.mapObjectMap(configMap, mapFn);
-        return result;
+        return util.mapObjectMap(configMap, mapFn);
     };
 }
 /**
@@ -9132,6 +9245,7 @@ function mapHttpsCallable(callable, wrap) {
  * so `httpsCallable` instances are only created when actually needed.
  *
  * @param configMap - maps each function group key to its `[ClassType, Factory]` tuple
+ * @returns a {@link LazyFirebaseFunctionsFactory} that creates a lazy-loaded function map for a given `Functions` instance
  *
  * @example
  * ```ts
@@ -9166,6 +9280,7 @@ function mapHttpsCallable(callable, wrap) {
  * The returned function builds {@link OnCallTypedModelParams} for any model type.
  *
  * @param call - the CRUD call type to embed in generated params
+ * @returns an {@link OnCallTypeModelParamsFunction} pre-configured with the given call type
  * @throws {Error} When `modelType` is not provided or empty.
  *
  * @example
@@ -9198,10 +9313,13 @@ function mapHttpsCallable(callable, wrap) {
  *
  * @deprecated Move towards using onCallTypedModelParamsFunction directly with the call type instead of using this function. Will not be removed in the future.
  *
- * @param modelType
- * @param data
- * @returns
- */ function onCallTypedModelParams(modelTypeInput, data, specifier, call) {
+ * @param modelTypeInput - the model type string or ref
+ * @param data - the call payload
+ * @param specifier - optional sub-function specifier
+ * @param call - the CRUD call type
+ * @returns the constructed {@link OnCallTypedModelParams}
+ */ // eslint-disable-next-line @typescript-eslint/max-params -- deprecated function, not worth refactoring
+function onCallTypedModelParams(modelTypeInput, data, specifier, call) {
     return onCallTypedModelParamsFunction(call)(modelTypeInput, data, specifier);
 }
 /**
@@ -9223,6 +9341,7 @@ function mapHttpsCallable(callable, wrap) {
  * Creates an {@link OnCallCreateModelResult} from document references by extracting their paths as model keys.
  *
  * @param result - document reference(s) from a create operation
+ * @returns an {@link OnCallCreateModelResult} with model keys extracted from document paths
  *
  * @example
  * ```ts
@@ -9238,13 +9357,14 @@ function mapHttpsCallable(callable, wrap) {
  * Creates an {@link OnCallCreateModelResult} from model key(s), normalizing to an array.
  *
  * @param modelKeys - the model key(s) of the created document(s)
+ * @returns an {@link OnCallCreateModelResult} containing the keys as an array
  */ function onCallCreateModelResult(modelKeys) {
     return {
         modelKeys: util.asArray(modelKeys)
     };
 }
 
-function _array_like_to_array$6(arr, len) {
+function _array_like_to_array$7(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
@@ -9280,15 +9400,15 @@ function _non_iterable_rest$2() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _sliced_to_array$2(arr, i) {
-    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$6(arr, i) || _non_iterable_rest$2();
+    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$7(arr, i) || _non_iterable_rest$2();
 }
-function _unsupported_iterable_to_array$6(o, minLen) {
+function _unsupported_iterable_to_array$7(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$6(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$7(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$6(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$7(o, minLen);
 }
 /**
  * Default specifier string (`'_'`) used when a CRUD operation has specifiers but one
@@ -9311,6 +9431,7 @@ function _unsupported_iterable_to_array$6(o, minLen) {
  *
  * @param configMap - configuration for custom (non-CRUD) functions
  * @param crudConfigMap - configuration for model CRUD functions with optional specifiers
+ * @returns a {@link ModelFirebaseFunctionMapFactory} that creates a combined custom and CRUD function map for a given `Functions` instance
  *
  * @example
  * ```ts
@@ -9325,22 +9446,22 @@ function _unsupported_iterable_to_array$6(o, minLen) {
  */ function callModelFirebaseFunctionMapFactory(configMap, crudConfigMap) {
     var functionFactory = firebaseFunctionMapFactory(configMap);
     return function(functionsInstance) {
-        var makeCallFunction = function makeCallFunction(call, fn, modelType, specifier) {
-            return mapHttpsCallable(fn(), {
+        var makeCallFunction = function makeCallFunction(callFn, modelType, specifier) {
+            return mapHttpsCallable(callFn.fn(), {
                 mapInput: function mapInput(data) {
-                    return onCallTypedModelParamsFunction(call)(modelType, data, specifier);
+                    return onCallTypedModelParamsFunction(callFn.call)(modelType, data, specifier);
                 }
             }, true);
         };
-        var makeCallSpecifiers = function makeCallSpecifiers(call, fn, modelType, specifierKeys) {
+        var makeCallSpecifiers = function makeCallSpecifiers(callFn, modelType, specifierKeys) {
             var modelTypeSuffix = util.capitalizeFirstLetter(modelType);
             var specifiers = {};
             specifierKeys.forEach(function(inputSpecifier) {
                 var specifier = inputSpecifier === MODEL_FUNCTION_FIREBASE_CRUD_FUNCTION_SPECIFIER_DEFAULT ? '' : inputSpecifier;
-                var specifierFn = makeCallFunction(call, fn, modelType, inputSpecifier);
-                var fullSpecifierName = "".concat(call).concat(modelTypeSuffix).concat(util.capitalizeFirstLetter(specifier));
+                var specifierFn = makeCallFunction(callFn, modelType, inputSpecifier);
+                var fullSpecifierName = "".concat(callFn.call).concat(modelTypeSuffix).concat(util.capitalizeFirstLetter(specifier));
                 specifiers[fullSpecifierName] = specifierFn;
-                var shortSpecifierName = util.lowercaseFirstLetter(specifier) || call;
+                var shortSpecifierName = util.lowercaseFirstLetter(specifier) || callFn.call;
                 specifiers[shortSpecifierName] = specifierFn;
             });
             return specifiers;
@@ -9349,7 +9470,7 @@ function _unsupported_iterable_to_array$6(o, minLen) {
         var _callFn = util.cachedGetter(function() {
             return functions.httpsCallable(functionsInstance, CALL_MODEL_APP_FUNCTION_KEY);
         });
-        var result = util.build({
+        return util.build({
             base: functionMap,
             build: function build(x) {
                 Object.entries(crudConfigMap).forEach(function(param) {
@@ -9363,10 +9484,14 @@ function _unsupported_iterable_to_array$6(o, minLen) {
                     };
                     var addCallFunctions = function addCallFunctions(crud, fn, modelType) {
                         var crudFns;
+                        var callFn = {
+                            call: crud,
+                            fn: fn
+                        };
                         if (crudFunctions.has(crud)) {
-                            crudFns = makeCallFunction(crud, fn, modelType);
+                            crudFns = makeCallFunction(callFn, modelType);
                         } else if (specifierFunctions.has(crud)) {
-                            crudFns = makeCallSpecifiers(crud, fn, modelType, specifierFunctions.get(crud));
+                            crudFns = makeCallSpecifiers(callFn, modelType, specifierFunctions.get(crud));
                         }
                         if (crudFns) {
                             modelTypeCalls["".concat(crud).concat(modelTypeSuffix)] = crudFns;
@@ -9374,7 +9499,7 @@ function _unsupported_iterable_to_array$6(o, minLen) {
                     };
                     var modelTypeSuffix = util.capitalizeFirstLetter(modelType);
                     var _separateValues = util.separateValues(config, function(x) {
-                        return x.indexOf(':') === -1;
+                        return !x.includes(':');
                     }), crudFunctionKeys = _separateValues.included, specifiedCallFunctionKeys = _separateValues.excluded;
                     var crudFunctions = new Set(crudFunctionKeys);
                     var specifiedCallFunctionTuples = specifiedCallFunctionKeys.map(function(x) {
@@ -9405,7 +9530,6 @@ function _unsupported_iterable_to_array$6(o, minLen) {
                 });
             }
         });
-        return result;
     };
 }
 
@@ -9414,6 +9538,7 @@ function _unsupported_iterable_to_array$6(o, minLen) {
  *
  * @param specifier - the development function to invoke
  * @param data - the call payload
+ * @returns an {@link OnCallDevelopmentParams} envelope ready to send to the dev endpoint
  *
  * @example
  * ```ts
@@ -9439,6 +9564,7 @@ function _unsupported_iterable_to_array$6(o, minLen) {
  * through a single endpoint. The function specifier and data are wrapped via {@link onCallDevelopmentParams}.
  *
  * @param configMap - maps each development function key to optional configuration
+ * @returns a factory that creates a {@link DevelopmentFirebaseFunctionMap} for a given `Functions` instance
  *
  * @example
  * ```ts
@@ -9491,6 +9617,7 @@ function _class_call_check$c(instance, Constructor) {
  * Useful when you need an independent reference that won't be affected by mutations to the original.
  *
  * @param path - the storage path to copy
+ * @returns a new {@link StoragePath} with the same `bucketId` and `pathString`
  *
  * @example
  * ```ts
@@ -9507,6 +9634,7 @@ function _class_call_check$c(instance, Constructor) {
  * with a consistent bucket assignment.
  *
  * @param config - bucket and replacement behavior
+ * @returns a {@link StoragePathFactory} that normalizes path inputs with the configured bucket
  *
  * @example
  * ```ts
@@ -9529,7 +9657,7 @@ function _class_call_check$c(instance, Constructor) {
         } else {
             return {
                 pathString: pathString,
-                bucketId: inputBucketId || bucketId
+                bucketId: inputBucketId !== null && inputBucketId !== void 0 ? inputBucketId : bucketId
             };
         }
     };
@@ -9541,6 +9669,7 @@ function _class_call_check$c(instance, Constructor) {
  * (implying the default bucket).
  *
  * @param path - the storage path to convert
+ * @returns a {@link GoogleCloudStorageFilePath} string (`gs://bucket/path` or a relative path)
  *
  * @example
  * ```ts
@@ -9563,6 +9692,7 @@ function _class_call_check$c(instance, Constructor) {
  * Returns the `gs://` bucket prefix URI for the given bucket identifier or ref.
  *
  * @param storage - bucket ID string or a {@link StorageBucketIdRef}
+ * @returns the `gs://bucket` prefix URI as a {@link GoogleCloudStorageBucketPrefix}
  *
  * @example
  * ```ts
@@ -9606,13 +9736,36 @@ var FIREBASE_SERVER_AUTH_CLAIMS_RESET_LAST_COM_DATE_KEY = 'resetCommunicationAt'
     return (_x_auth = x.auth) === null || _x_auth === void 0 ? void 0 : _x_auth.uid;
 });
 
-/** Error code when the user account is not found. */ var FIREBASE_AUTH_USER_NOT_FOUND_ERROR = 'auth/user-not-found';
-/** Error code when the password is incorrect. */ var FIREBASE_AUTH_WRONG_PASSWORD = 'auth/wrong-password';
-/** Error code for a network request error (client SDK). */ var FIREBASE_AUTH_NETWORK_REQUEST_ERROR = 'auth/network-request-error';
-/** Error code for a failed network request (client SDK). */ var FIREBASE_AUTH_NETWORK_REQUEST_FAILED = 'auth/network-request-failed';
-/** Error code when a phone number is already associated with another account. */ var FIREBASE_AUTH_PHONE_NUMBER_ALREADY_EXISTS_ERROR = 'auth/phone-number-already-exists';
-/** Error code when an email is already associated with another account. */ var FIREBASE_AUTH_EMAIL_ALREADY_EXISTS_ERROR = 'auth/email-already-exists';
-/** Error code when the provided phone number is not a valid E.164 string. */ var FIREBASE_AUTH_INVALID_PHONE_NUMBER_ERROR = 'auth/invalid-phone-number';
+/**
+ * Error code when the user account is not found.
+ */ var FIREBASE_AUTH_USER_NOT_FOUND_ERROR = 'auth/user-not-found';
+/**
+ * Error code when the password is incorrect.
+ */ var FIREBASE_AUTH_WRONG_PASSWORD = 'auth/wrong-password';
+/**
+ * Error code for a network request error (client SDK).
+ */ var FIREBASE_AUTH_NETWORK_REQUEST_ERROR = 'auth/network-request-error';
+/**
+ * Error code for a failed network request (client SDK).
+ */ var FIREBASE_AUTH_NETWORK_REQUEST_FAILED = 'auth/network-request-failed';
+/**
+ * Error code when a phone number is already associated with another account.
+ */ var FIREBASE_AUTH_PHONE_NUMBER_ALREADY_EXISTS_ERROR = 'auth/phone-number-already-exists';
+/**
+ * Error code when an email is already associated with another account.
+ */ var FIREBASE_AUTH_EMAIL_ALREADY_EXISTS_ERROR = 'auth/email-already-exists';
+/**
+ * Error code when the provided phone number is not a valid E.164 string.
+ */ var FIREBASE_AUTH_INVALID_PHONE_NUMBER_ERROR = 'auth/invalid-phone-number';
+/**
+ * Error code when a provider is already linked to the current user account.
+ */ var FIREBASE_AUTH_PROVIDER_ALREADY_LINKED_ERROR = 'auth/provider-already-linked';
+/**
+ * Error code when the credential is already associated with a different user account.
+ */ var FIREBASE_AUTH_CREDENTIAL_ALREADY_IN_USE_ERROR = 'auth/credential-already-in-use';
+/**
+ * Error code when an email address is already in use by another account during linking.
+ */ var FIREBASE_AUTH_EMAIL_ALREADY_IN_USE_ERROR = 'auth/email-already-in-use';
 /**
  * Converts a {@link FirebaseAuthError} into a user-friendly {@link ReadableError} with a human-readable message.
  *
@@ -9620,6 +9773,7 @@ var FIREBASE_SERVER_AUTH_CLAIMS_RESET_LAST_COM_DATE_KEY = 'resetCommunicationAt'
  * suitable for display in the UI.
  *
  * @param inputError - the Firebase Auth error to convert
+ * @returns a {@link ReadableError} with a human-readable message suitable for display
  *
  * @example
  * ```ts
@@ -9653,6 +9807,24 @@ var FIREBASE_SERVER_AUTH_CLAIMS_RESET_LAST_COM_DATE_KEY = 'resetCommunicationAt'
                 message: 'Could not reach the server. Are you connected to the internet?'
             };
             break;
+        case FIREBASE_AUTH_PROVIDER_ALREADY_LINKED_ERROR:
+            error = {
+                code: code,
+                message: 'This provider is already linked to your account.'
+            };
+            break;
+        case FIREBASE_AUTH_CREDENTIAL_ALREADY_IN_USE_ERROR:
+            error = {
+                code: code,
+                message: 'These credentials are already associated with a different account.'
+            };
+            break;
+        case FIREBASE_AUTH_EMAIL_ALREADY_IN_USE_ERROR:
+            error = {
+                code: code,
+                message: 'This email address is already in use by another account.'
+            };
+            break;
         default:
             error = {
                 code: code,
@@ -9723,6 +9895,7 @@ function _define_property$f(obj, key, value) {
  * Automatically uses a transaction accessor when the context has an active transaction.
  *
  * @param getFirestoreCollection - function to retrieve the Firestore collection from context
+ * @returns a {@link FirebaseModelLoader} that loads document wrappers for given keys
  *
  * @example
  * ```ts
@@ -9739,8 +9912,7 @@ function _define_property$f(obj, key, value) {
             } else {
                 documentAccessor = firestoreCollection.documentAccessor();
             }
-            var document = documentAccessor.loadDocumentForKey(key);
-            return document;
+            return documentAccessor.loadDocumentForKey(key);
         }
     };
 }
@@ -9748,17 +9920,17 @@ function _define_property$f(obj, key, value) {
 /**
  * ArkType schema for a FirestoreModelKey (full path like "collection/12345").
  */ var firestoreModelKeyType = arktype.type('string > 0').narrow(function(val, ctx) {
-    return val != null && isFirestoreModelKey(val) || ctx.mustBe('a valid FirestoreModelKey');
+    return isFirestoreModelKey(val) || ctx.mustBe('a valid FirestoreModelKey');
 });
 /**
  * ArkType schema for a FirestoreModelId (document ID like "12345").
  */ var firestoreModelIdType = arktype.type('string > 0').narrow(function(val, ctx) {
-    return val != null && isFirestoreModelId(val) || ctx.mustBe('a valid FirestoreModelId');
+    return isFirestoreModelId(val) || ctx.mustBe('a valid FirestoreModelId');
 });
 /**
  * ArkType schema for a FirestoreModelId or FirestoreModelKey.
  */ var firestoreModelIdOrKeyType = arktype.type('string > 0').narrow(function(val, ctx) {
-    return val != null && isFirestoreModelIdOrKey(val) || ctx.mustBe('a valid FirestoreModelId or FirestoreModelKey');
+    return isFirestoreModelIdOrKey(val) || ctx.mustBe('a valid FirestoreModelId or FirestoreModelKey');
 });
 
 /**
@@ -10067,6 +10239,7 @@ function _ts_generator$9(thisArg, body) {
  * Creates a {@link FirebaseModelPermissionServiceInstance} from a delegate.
  *
  * @param delegate - provides model loading and role computation
+ * @returns a {@link FirebaseModelPermissionServiceInstance} configured with the given delegate
  */ function firebaseModelPermissionService(delegate) {
     return new FirebaseModelPermissionServiceInstance(delegate);
 }
@@ -10229,8 +10402,7 @@ function _define_property$d(obj, key, value) {
             value: function throwDoesNotExistError() {
                 var _ref;
                 var _this_contextGrantedModelRoles_context_makeDoesNotExistError, _this_contextGrantedModelRoles_context;
-                var error = (_ref = (_this_contextGrantedModelRoles_context_makeDoesNotExistError = (_this_contextGrantedModelRoles_context = this.contextGrantedModelRoles.context).makeDoesNotExistError) === null || _this_contextGrantedModelRoles_context_makeDoesNotExistError === void 0 ? void 0 : _this_contextGrantedModelRoles_context_makeDoesNotExistError.call(_this_contextGrantedModelRoles_context, this.contextGrantedModelRoles)) !== null && _ref !== void 0 ? _ref : new Error(contextGrantedModelRolesReaderDoesNotExistErrorMessage(this.contextGrantedModelRoles));
-                throw error;
+                throw (_ref = (_this_contextGrantedModelRoles_context_makeDoesNotExistError = (_this_contextGrantedModelRoles_context = this.contextGrantedModelRoles.context).makeDoesNotExistError) === null || _this_contextGrantedModelRoles_context_makeDoesNotExistError === void 0 ? void 0 : _this_contextGrantedModelRoles_context_makeDoesNotExistError.call(_this_contextGrantedModelRoles_context, this.contextGrantedModelRoles)) !== null && _ref !== void 0 ? _ref : new Error(contextGrantedModelRolesReaderDoesNotExistErrorMessage(this.contextGrantedModelRoles));
             }
         },
         {
@@ -10238,8 +10410,7 @@ function _define_property$d(obj, key, value) {
             value: function throwPermissionError(role) {
                 var _ref;
                 var _this_contextGrantedModelRoles_context_makePermissionError, _this_contextGrantedModelRoles_context;
-                var error = (_ref = (_this_contextGrantedModelRoles_context_makePermissionError = (_this_contextGrantedModelRoles_context = this.contextGrantedModelRoles.context).makePermissionError) === null || _this_contextGrantedModelRoles_context_makePermissionError === void 0 ? void 0 : _this_contextGrantedModelRoles_context_makePermissionError.call(_this_contextGrantedModelRoles_context, this.contextGrantedModelRoles, role)) !== null && _ref !== void 0 ? _ref : new Error(contextGrantedModelRolesReaderPermissionErrorMessage(this.contextGrantedModelRoles, role));
-                throw error;
+                throw (_ref = (_this_contextGrantedModelRoles_context_makePermissionError = (_this_contextGrantedModelRoles_context = this.contextGrantedModelRoles.context).makePermissionError) === null || _this_contextGrantedModelRoles_context_makePermissionError === void 0 ? void 0 : _this_contextGrantedModelRoles_context_makePermissionError.call(_this_contextGrantedModelRoles_context, this.contextGrantedModelRoles, role)) !== null && _ref !== void 0 ? _ref : new Error(contextGrantedModelRolesReaderPermissionErrorMessage(this.contextGrantedModelRoles, role));
             }
         }
     ]);
@@ -10247,6 +10418,9 @@ function _define_property$d(obj, key, value) {
 }();
 /**
  * Creates a new ContextGrantedModelRolesReader for the input model.
+ *
+ * @param service - the in-model-context permission service to read roles from
+ * @returns a promise resolving to a {@link ContextGrantedModelRolesReader} for the model
  */ function contextGrantedModelRolesReader(service) {
     return service.roleMap().then(function(x) {
         return new ContextGrantedModelRolesReaderInstance(x);
@@ -10255,13 +10429,13 @@ function _define_property$d(obj, key, value) {
 /**
  * Creates the default permission error message.
  *
- * @param contextGrantedModelRoles
- * @param role
- * @returns
+ * @param contextGrantedModelRoles - the granted model roles context to generate the message from
+ * @param roles - the required role(s) that were not satisfied
+ * @returns a human-readable permission error message string
  */ function contextGrantedModelRolesReaderPermissionErrorMessage(contextGrantedModelRoles, roles) {
     var _contextGrantedModelRoles_data, _contextGrantedModelRoles_data1;
     var message = 'Permissions Error ("'.concat((_contextGrantedModelRoles_data = contextGrantedModelRoles.data) === null || _contextGrantedModelRoles_data === void 0 ? void 0 : _contextGrantedModelRoles_data.document.modelType, '":"').concat((_contextGrantedModelRoles_data1 = contextGrantedModelRoles.data) === null || _contextGrantedModelRoles_data1 === void 0 ? void 0 : _contextGrantedModelRoles_data1.document.id, '")');
-    if (roles && (roles === null || roles === void 0 ? void 0 : roles.length)) {
+    if (roles === null || roles === void 0 ? void 0 : roles.length) {
         message = "".concat(message, ': required role(s) "').concat(roles, '"');
     }
     return message;
@@ -10269,13 +10443,11 @@ function _define_property$d(obj, key, value) {
 /**
  * Creates the default does not exist error message.
  *
- * @param contextGrantedModelRoles
- * @param role
- * @returns
+ * @param contextGrantedModelRoles - the granted model roles context to generate the message from
+ * @returns a human-readable does-not-exist error message string
  */ function contextGrantedModelRolesReaderDoesNotExistErrorMessage(contextGrantedModelRoles) {
     var _contextGrantedModelRoles_data, _contextGrantedModelRoles_data1;
-    var message = 'Does Not Exist ("'.concat((_contextGrantedModelRoles_data = contextGrantedModelRoles.data) === null || _contextGrantedModelRoles_data === void 0 ? void 0 : _contextGrantedModelRoles_data.document.modelType, '":"').concat((_contextGrantedModelRoles_data1 = contextGrantedModelRoles.data) === null || _contextGrantedModelRoles_data1 === void 0 ? void 0 : _contextGrantedModelRoles_data1.document.id, '")');
-    return message;
+    return 'Does Not Exist ("'.concat((_contextGrantedModelRoles_data = contextGrantedModelRoles.data) === null || _contextGrantedModelRoles_data === void 0 ? void 0 : _contextGrantedModelRoles_data.document.modelType, '":"').concat((_contextGrantedModelRoles_data1 = contextGrantedModelRoles.data) === null || _contextGrantedModelRoles_data1 === void 0 ? void 0 : _contextGrantedModelRoles_data1.document.id, '")');
 }
 
 function asyncGeneratorStep$8(gen, resolve, reject, _next, _throw, key, arg) {
@@ -10411,6 +10583,9 @@ function _ts_generator$8(thisArg, body) {
  * Decision function that checks if the current user is an admin in the given context.
  *
  * Returns `false` if no auth is present.
+ *
+ * @param context - the Firebase model context to evaluate
+ * @returns a promise resolving to `true` if the user is an admin, `false` otherwise
  */ var isAdminInFirebaseModelContext = function isAdminInFirebaseModelContext(context) {
     var _ref;
     var _context_auth;
@@ -10420,6 +10595,7 @@ function _ts_generator$8(thisArg, body) {
  * Creates a {@link GrantRolesIfFunction} that grants the specified roles when the user is an admin.
  *
  * @param rolesToGrantToAdmin - roles to grant if the user is an admin
+ * @returns a {@link GrantRolesIfFunction} that grants the given roles when the user is an admin
  *
  * @example
  * ```ts
@@ -10438,6 +10614,7 @@ function _ts_generator$8(thisArg, body) {
  * @param context - the model context to check
  * @param rolesToGrantToAdmin - roles to grant if admin
  * @param otherwise - fallback role computation when not admin
+ * @returns a promise or value resolving to the granted role map
  */ function grantModelRolesIfAdmin(context, rolesToGrantToAdmin, otherwise) {
     return grantModelRolesIfAdminFunction(rolesToGrantToAdmin)(context, otherwise);
 }
@@ -10447,6 +10624,7 @@ function _ts_generator$8(thisArg, body) {
  *
  * @param authRoles - the auth roles the user must have
  * @param rolesToGrantToAdmin - the model roles to grant if the auth roles are present
+ * @returns a {@link GrantRolesIfFunction} that grants the given roles when the user has the required auth roles
  */ function grantModelRolesIfHasAuthRolesFunction(authRoles, rolesToGrantToAdmin) {
     return grantModelRolesIfFunction(function(context) {
         var _context_auth;
@@ -10462,6 +10640,7 @@ function _ts_generator$8(thisArg, body) {
  * Creates a reusable factory pre-configured with specific auth roles to check for.
  *
  * @param authRoles - the auth roles the user must have
+ * @returns a {@link GrantModelRolesIfHasAuthRolesFactory} pre-configured to check the given auth roles
  */ function grantModelRolesIfHasAuthRolesFactory(authRoles) {
     var authRolesToHave = util.iterableToArray(authRoles);
     return function(context, rolesToGrantToMatch, otherwise) {
@@ -10520,6 +10699,7 @@ function _ts_generator$8(thisArg, body) {
  * Creates a {@link GrantRolesIfFunction} that grants roles when the authenticated user's UID matches the model's `uid` field.
  *
  * @param rolesToGrant - the roles to grant if the user owns the model
+ * @returns a {@link GrantRolesIfFunction} that grants roles when the authenticated user is the model owner
  *
  * @example
  * ```ts
@@ -10537,6 +10717,7 @@ function _ts_generator$8(thisArg, body) {
  *
  * @param grantIf - decision function to evaluate
  * @param grantedRoles - roles to grant if the decision is `true`
+ * @returns a {@link GrantRolesOnlyIfFunction} that grants roles or returns no-access with no fallback
  */ function grantModelRolesOnlyIfFunction(grantIf, grantedRoles) {
     var fn = grantModelRolesIfFunction(grantIf, grantedRoles);
     return function(context) {
@@ -10551,6 +10732,7 @@ function _ts_generator$8(thisArg, body) {
  *
  * @param grantIf - async decision function to evaluate
  * @param grantedRoles - roles to grant if the decision is `true`
+ * @returns a {@link GrantRolesIfFunction} that evaluates the condition and grants roles or falls back
  * @throws {Error} When `grantIf` is not provided.
  *
  * @example
@@ -10562,9 +10744,6 @@ function _ts_generator$8(thisArg, body) {
  * const roles = await grantIfOwner(context, () => noAccessRoleMap());
  * ```
  */ function grantModelRolesIfFunction(grantIf, grantedRoles) {
-    if (!grantIf) {
-        throw new Error('missing grant if');
-    }
     return function(context) {
         var otherwise = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : model.noAccessRoleMap;
         return _async_to_generator$8(function() {
@@ -10663,6 +10842,7 @@ function _object_spread_props$a(target, source) {
  * Creates a {@link FirebaseModelService} that wires together model loading and permission evaluation.
  *
  * @param config - collection loader and role mapping functions
+ * @returns a {@link FirebaseModelService} combining model loading and permission evaluation
  *
  * @example
  * ```ts
@@ -10695,6 +10875,7 @@ function _object_spread_props$a(target, source) {
  * Creates a {@link FirebaseModelServiceFactory} that lazily instantiates and caches the service.
  *
  * @param config - the service configuration
+ * @returns a {@link FirebaseModelServiceFactory} that lazily creates and caches the service
  */ function firebaseModelServiceFactory(config) {
     return util.cachedGetter(function() {
         return firebaseModelService(config);
@@ -10707,6 +10888,7 @@ function _object_spread_props$a(target, source) {
  * with a model or key to perform permission-checked operations.
  *
  * @param factory - lazy getter for the underlying model service
+ * @returns an {@link InContextFirebaseModelServiceFactory} that binds contexts to the service
  */ function inContextFirebaseModelServiceFactory(factory) {
     return function(context) {
         var firebaseModelService = factory();
@@ -10776,8 +10958,8 @@ function _object_spread_props$a(target, source) {
  * export const demoFirebaseModelServices = firebaseModelsService<typeof DEMO_FIREBASE_MODEL_SERVICE_FACTORIES, DemoFirebaseBaseContext, DemoFirebaseModelTypes>(DEMO_FIREBASE_MODEL_SERVICE_FACTORIES);
  * export type DemoFirebaseContext = DemoFirebaseBaseContext & { service: typeof demoFirebaseModelServices };
  *
- * @param services
- * @returns
+ * @param services - the map of model service getter factories
+ * @returns a {@link FirebaseModelsService} that dispatches to the appropriate model service by type
  */ function firebaseModelsService(services) {
     var firebaseModelsServiceFunction = function firebaseModelsServiceFunction1(type, context) {
         var firebaseModelService = services[type];
@@ -10798,6 +10980,7 @@ function _object_spread_props$a(target, source) {
  * The returned factory binds a context, so callers can then select individual model services by type.
  *
  * @param service - the multi-model service to wrap
+ * @returns an {@link InContextFirebaseModelsServiceFactory} that binds a context to the service
  */ function inContextFirebaseModelsServiceFactory(service) {
     var newInContextFirebaseModelsServiceFactory = function newInContextFirebaseModelsServiceFactory(context) {
         var result = function result(type) {
@@ -10815,6 +10998,7 @@ function _object_spread_props$a(target, source) {
  * @param service - the multi-model service
  * @param type - the model type to select
  * @param select - selection params including context and key
+ * @returns the {@link FirebaseModelsServiceSelectionResult} bound to the specified model
  */ function selectFromFirebaseModelsService(service, type, select) {
     var key = readFirestoreModelKey(select.key, true);
     return service(type, select.context).forKey(key);
@@ -10827,10 +11011,12 @@ function _object_spread_props$a(target, source) {
  * @param service - the multi-model service
  * @param type - the model type to select
  * @param select - selection params including context, key, and optional role requirements
+ * @returns a {@link UsePromiseFunction} for the resolved roles reader
  */ function useFirebaseModelsService(service, type, select) {
+    var _select_roles;
     var inContextModelService = selectFromFirebaseModelsService(service, type, select);
     var result;
-    if (select.roles && select.roles.length) {
+    if ((_select_roles = select.roles) === null || _select_roles === void 0 ? void 0 : _select_roles.length) {
         result = inContextModelService.requireUse(select.roles, select.rolesSetIncludes);
     } else {
         result = inContextModelService.use;
@@ -10844,6 +11030,7 @@ function _object_spread_props$a(target, source) {
  * Useful for routing incoming requests to the correct model service by collection path.
  *
  * @param inContextFirebaseModelsService - context-bound multi-model service
+ * @returns a map of collection type strings to their {@link FirestoreModelIdentity} objects
  */ function buildFirebaseCollectionTypeModelTypeMap(inContextFirebaseModelsService) {
     var allTypes = inContextFirebaseModelsService.allTypes();
     var modelIdentities = allTypes.map(function(type) {
@@ -10870,6 +11057,7 @@ function _object_spread_props$a(target, source) {
  * The generated paths follow the convention `/model/[basePath/]<modelKey>/[path]`.
  *
  * @param config - optional base path to nest under
+ * @returns a {@link ModelStorageSlashPathFactory} that maps Firestore model keys to storage paths
  *
  * @example
  * ```ts
@@ -11070,6 +11258,7 @@ function _ts_generator$7(thisArg, body) {
  * Wraps the folder's `list()` API with cursor-based pagination via {@link fetchPageFactory}.
  *
  * @param config - default listing options (e.g., maxResults)
+ * @returns an {@link IterateStorageListFilesFactory} for paginated file listing
  *
  * @example
  * ```ts
@@ -11080,25 +11269,16 @@ function _ts_generator$7(thisArg, body) {
     return fetch.fetchPageFactory({
         fetch: function fetch(input) {
             return _async_to_generator$7(function() {
-                var _input_maxResults, _input_pageToken, list;
+                var _input_maxResults, _input_pageToken;
                 return _ts_generator$7(this, function(_state) {
-                    switch(_state.label){
-                        case 0:
-                            return [
-                                4,
-                                input.folder.list({
-                                    includeNestedResults: input.includeNestedResults,
-                                    maxResults: (_input_maxResults = input.maxResults) !== null && _input_maxResults !== void 0 ? _input_maxResults : factoryDefaultMaxResults,
-                                    pageToken: (_input_pageToken = input.pageToken) !== null && _input_pageToken !== void 0 ? _input_pageToken : undefined
-                                })
-                            ];
-                        case 1:
-                            list = _state.sent();
-                            return [
-                                2,
-                                list
-                            ];
-                    }
+                    return [
+                        2,
+                        input.folder.list({
+                            includeNestedResults: input.includeNestedResults,
+                            maxResults: (_input_maxResults = input.maxResults) !== null && _input_maxResults !== void 0 ? _input_maxResults : factoryDefaultMaxResults,
+                            pageToken: (_input_pageToken = input.pageToken) !== null && _input_pageToken !== void 0 ? _input_pageToken : undefined
+                        })
+                    ];
                 });
             })();
         },
@@ -11112,7 +11292,7 @@ function _ts_generator$7(thisArg, body) {
             };
             return info;
         },
-        buildInputForNextPage: function buildInputForNextPage(pageResult, input, options) {
+        buildInputForNextPage: function buildInputForNextPage(pageResult, input, _options) {
             var _pageResult_nextPageCursor;
             return _object_spread_props$9(_object_spread$b({}, input), {
                 pageToken: (_pageResult_nextPageCursor = pageResult.nextPageCursor) !== null && _pageResult_nextPageCursor !== void 0 ? _pageResult_nextPageCursor : undefined
@@ -11124,6 +11304,9 @@ function _ts_generator$7(thisArg, body) {
  * Iterates through every file in a storage folder, invoking a callback for each individual file result.
  *
  * Convenience wrapper around {@link iterateFetchPagesByEachItem} pre-configured for storage listing.
+ *
+ * @param input - iteration configuration including folder, listing options, and per-item callback
+ * @returns the result of the paginated per-item iteration
  */ function iterateStorageListFilesByEachFile(input) {
     var folder = input.folder, includeNestedResults = input.includeNestedResults, pageToken = input.pageToken;
     return fetch.iterateFetchPagesByEachItem(_object_spread_props$9(_object_spread$b({}, input), {
@@ -11139,6 +11322,9 @@ function _ts_generator$7(thisArg, body) {
  * Iterates through pages of file results in a storage folder, invoking a callback for each page.
  *
  * Convenience wrapper around {@link iterateFetchPages} pre-configured for storage listing.
+ *
+ * @param input - iteration configuration including folder, listing options, and per-page callback
+ * @returns the result of the paginated page-level iteration
  */ function iterateStorageListFiles(input) {
     var folder = input.folder, includeNestedResults = input.includeNestedResults, pageToken = input.pageToken;
     return fetch.iterateFetchPages(_object_spread_props$9(_object_spread$b({}, input), {
@@ -11217,6 +11403,7 @@ function _is_native_reflect_construct$4() {
  * Required when the upload input is a string, since the format (raw, base64, etc.) must be explicit.
  *
  * @param options - the upload options to extract from
+ * @returns the {@link StorageDataStringType} extracted from the options
  * @throws {Error} When `stringFormat` is not set in the options.
  */ function assertStorageUploadOptionsStringFormat(options) {
     var stringFormat = options === null || options === void 0 ? void 0 : options.stringFormat;
@@ -11227,6 +11414,8 @@ function _is_native_reflect_construct$4() {
 }
 /**
  * Creates an error indicating that `stringFormat` was missing from upload options.
+ *
+ * @returns an {@link Error} describing the missing `stringFormat` in upload options
  */ function noStringFormatInStorageUploadOptionsError() {
     return new Error('stringFormat was missing a value in the StorageUploadOptions.');
 }
@@ -11383,6 +11572,7 @@ function _ts_generator$6(thisArg, body) {
  * @param file - the target file accessor to upload to
  * @param readableStream - the source stream to pipe
  * @param options - optional upload configuration (content type, metadata, etc.)
+ * @returns a promise that resolves when the upload stream has finished
  * @throws {StorageFileUploadStreamUnsupportedError} When the file accessor does not support stream uploads.
  *
  * @example
@@ -11420,15 +11610,16 @@ function _ts_generator$6(thisArg, body) {
  * provides cursor-based pagination through the `next()` method.
  *
  * @param delegate - platform-specific implementation for extracting results
+ * @returns a {@link StorageListFilesResultFactory} that normalizes raw SDK list results
  *
  * @example
  * ```ts
  * const factory = storageListFilesResultFactory(myDelegate);
- * const result = factory(storage, folder, { maxResults: 50 }, rawSdkResult);
+ * const result = factory({ storage, folder, options: { maxResults: 50 } }, rawSdkResult);
  * const files = result.files();
  * ```
  */ function storageListFilesResultFactory(delegate) {
-    return function(storage, folder, options, result) {
+    return function(input, result) {
         var fileResult = function fileResult(item) {
             item.file = function() {
                 return delegate.file(storage, item);
@@ -11441,12 +11632,13 @@ function _ts_generator$6(thisArg, body) {
             };
             return item;
         };
+        var storage = input.storage, folder = input.folder, options = input.options;
         var hasNext = delegate.hasNext(result);
         var next = util.cachedGetter(function() {
             if (!hasNext) {
                 throw storageListFilesResultHasNoNextError();
             }
-            return delegate.next(storage, options, folder, result);
+            return delegate.next(input, result);
         });
         var files = util.cachedGetter(function() {
             return delegate.filesFromResult(result, folder).map(fileResult);
@@ -11474,6 +11666,8 @@ function _ts_generator$6(thisArg, body) {
 }
 /**
  * Creates an error thrown when `next()` is called on a list result that has no more pages.
+ *
+ * @returns an {@link Error} indicating there are no more pages to fetch
  */ function storageListFilesResultHasNoNextError() {
     return new Error('hasNext is false, there are no more results available.');
 }
@@ -11485,6 +11679,7 @@ function _ts_generator$6(thisArg, body) {
  * a {@link StoragePathFactory} to normalize all path inputs.
  *
  * @param drivers - the storage driver implementations to use
+ * @returns a {@link FirebaseStorageContextFactory} that creates storage contexts for a given storage instance
  * @throws {Error} When a default bucket ID cannot be resolved from the driver or config.
  *
  * @example
@@ -11495,9 +11690,10 @@ function _ts_generator$6(thisArg, body) {
  * ```
  */ function firebaseStorageContextFactory(drivers) {
     return function(firebaseStorage, config) {
+        var _ref;
         var _drivers_storageAccessorDriver_getDefaultBucket, _drivers_storageAccessorDriver;
-        var _ref = config !== null && config !== void 0 ? config : {}, inputDefaultBucketId = _ref.defaultBucketId, _ref_forceBucket = _ref.forceBucket, forceBucket = _ref_forceBucket === void 0 ? false : _ref_forceBucket;
-        var defaultBucketId = inputDefaultBucketId || ((_drivers_storageAccessorDriver_getDefaultBucket = (_drivers_storageAccessorDriver = drivers.storageAccessorDriver).getDefaultBucket) === null || _drivers_storageAccessorDriver_getDefaultBucket === void 0 ? void 0 : _drivers_storageAccessorDriver_getDefaultBucket.call(_drivers_storageAccessorDriver, firebaseStorage)) || '';
+        var _ref1 = config !== null && config !== void 0 ? config : {}, inputDefaultBucketId = _ref1.defaultBucketId, _ref_forceBucket = _ref1.forceBucket, forceBucket = _ref_forceBucket === void 0 ? false : _ref_forceBucket;
+        var defaultBucketId = (_ref = inputDefaultBucketId !== null && inputDefaultBucketId !== void 0 ? inputDefaultBucketId : (_drivers_storageAccessorDriver_getDefaultBucket = (_drivers_storageAccessorDriver = drivers.storageAccessorDriver).getDefaultBucket) === null || _drivers_storageAccessorDriver_getDefaultBucket === void 0 ? void 0 : _drivers_storageAccessorDriver_getDefaultBucket.call(_drivers_storageAccessorDriver, firebaseStorage)) !== null && _ref !== void 0 ? _ref : '';
         if (!defaultBucketId) {
             throw new Error('Could not resolve a default bucket id for the firebaseStorageContextFactory(). Supply a defaultBucketId.');
         }
@@ -11522,13 +11718,13 @@ function _ts_generator$6(thisArg, body) {
     };
 }
 
-function _array_like_to_array$5(arr, len) {
+function _array_like_to_array$6(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_without_holes$3(arr) {
-    if (Array.isArray(arr)) return _array_like_to_array$5(arr);
+function _array_without_holes$5(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$6(arr);
 }
 function asyncGeneratorStep$5(gen, resolve, reject, _next, _throw, key, arg) {
     try {
@@ -11572,10 +11768,10 @@ function _define_property$a(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array$3(iter) {
+function _iterable_to_array$5(iter) {
     if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
 }
-function _non_iterable_spread$3() {
+function _non_iterable_spread$5() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$a(target) {
@@ -11612,16 +11808,16 @@ function _object_spread_props$8(target, source) {
     }
     return target;
 }
-function _to_consumable_array$3(arr) {
-    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$5(arr) || _non_iterable_spread$3();
+function _to_consumable_array$5(arr) {
+    return _array_without_holes$5(arr) || _iterable_to_array$5(arr) || _unsupported_iterable_to_array$6(arr) || _non_iterable_spread$5();
 }
-function _unsupported_iterable_to_array$5(o, minLen) {
+function _unsupported_iterable_to_array$6(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$6(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$6(o, minLen);
 }
 function _ts_generator$5(thisArg, body) {
     var f, y, t, _ = {
@@ -11729,6 +11925,7 @@ function _ts_generator$5(thisArg, body) {
  * e.g., to silently handle deletion of already-deleted files.
  *
  * @param input - the error or error message to check
+ * @returns `true` if the error message contains `'storage/object-not-found'`, `false` otherwise
  *
  * @example
  * ```ts
@@ -11748,6 +11945,7 @@ function _ts_generator$5(thisArg, body) {
  *
  * @param storage - the client Firebase Storage instance
  * @param path - abstract storage path to resolve
+ * @returns a `StorageReference` pointing to the resolved storage path
  */ function firebaseStorageRefForStorageFilePath(storage$1, path) {
     return storage.ref(storage$1, firebaseStorageFilePathFromStorageFilePath(path));
 }
@@ -11757,6 +11955,7 @@ function _ts_generator$5(thisArg, body) {
  * Returns `true` if metadata is successfully retrieved, `false` for any error (including permission errors).
  *
  * @param ref - the storage reference to check
+ * @returns a promise that resolves to `true` if the file exists, `false` otherwise
  */ function firebaseStorageFileExists(ref) {
     return storage.getMetadata(ref).then(function(_) {
         return true;
@@ -11772,6 +11971,7 @@ function _ts_generator$5(thisArg, body) {
  *
  * @param storage - the client Firebase Storage instance
  * @param storagePath - the abstract storage path for the file
+ * @returns a {@link FirebaseStorageClientAccessorFile} providing CRUD and upload operations for the given path
  *
  * @example
  * ```ts
@@ -11788,7 +11988,7 @@ function _ts_generator$5(thisArg, body) {
             contentEncoding: (_options_metadata2 = options.metadata) === null || _options_metadata2 === void 0 ? void 0 : _options_metadata2.contentEncoding,
             contentLanguage: (_options_metadata3 = options.metadata) === null || _options_metadata3 === void 0 ? void 0 : _options_metadata3.contentLanguage,
             contentType: (_options_metadata4 = options.metadata) === null || _options_metadata4 === void 0 ? void 0 : _options_metadata4.contentType,
-            customMetadata: util.filterUndefinedValues(_object_spread$a({}, (_options_metadata5 = options.metadata) === null || _options_metadata5 === void 0 ? void 0 : _options_metadata5.customMetadata, options === null || options === void 0 ? void 0 : options.customMetadata))
+            customMetadata: util.filterUndefinedValues(_object_spread$a({}, (_options_metadata5 = options.metadata) === null || _options_metadata5 === void 0 ? void 0 : _options_metadata5.customMetadata, options.customMetadata))
         });
     }
     function uploadMetadataFromStorageUploadOptions(options) {
@@ -11917,7 +12117,8 @@ function _ts_generator$5(thisArg, body) {
     nextPageTokenFromResult: function nextPageTokenFromResult(result) {
         return result.listResult.nextPageToken;
     },
-    next: function next(storage, options, folder, result) {
+    next: function next(param, result) {
+        var options = param.options, folder = param.folder;
         return folder.list(_object_spread_props$8(_object_spread$a({}, options, result.options), {
             pageToken: result.listResult.nextPageToken
         }));
@@ -11959,6 +12160,7 @@ function _ts_generator$5(thisArg, body) {
  *
  * @param storage - the client Firebase Storage instance
  * @param storagePath - the abstract storage path for the folder
+ * @returns a {@link FirebaseStorageClientAccessorFolder} providing listing and existence operations for the given path
  *
  * @example
  * ```ts
@@ -11987,7 +12189,11 @@ function _ts_generator$5(thisArg, body) {
                             return [
                                 4,
                                 storage.list(ref, options).then(function(listResult) {
-                                    return firebaseStorageClientListFilesResultFactory(storage$1, folder, options, {
+                                    return firebaseStorageClientListFilesResultFactory({
+                                        storage: storage$1,
+                                        folder: folder,
+                                        options: options
+                                    }, {
                                         options: options,
                                         listResult: listResult
                                     });
@@ -12014,7 +12220,7 @@ function _ts_generator$5(thisArg, body) {
                         case 2:
                             allNestedFolderFileResults = _state.sent();
                             allNestedFiles = allNestedFolderFileResults.flat();
-                            allFiles = _to_consumable_array$3(allImmediateFiles).concat(_to_consumable_array$3(allNestedFiles));
+                            allFiles = _to_consumable_array$5(allImmediateFiles).concat(_to_consumable_array$5(allNestedFiles));
                             result = _object_spread_props$8(_object_spread$a({}, rootResults), {
                                 files: function files() {
                                     return allFiles;
@@ -12050,6 +12256,8 @@ function _ts_generator$5(thisArg, body) {
  * Provides file and folder accessor factories and default bucket resolution.
  * Used internally by {@link firebaseStorageClientDrivers}.
  *
+ * @returns a {@link FirebaseStorageAccessorDriver} backed by the `firebase/storage` client SDK
+ *
  * @example
  * ```ts
  * const driver = firebaseStorageClientAccessorDriver();
@@ -12077,6 +12285,8 @@ function _ts_generator$5(thisArg, body) {
  *
  * Provides file and folder accessor operations for use with {@link clientFirebaseStorageContextFactory}.
  *
+ * @returns the client-side {@link FirebaseStorageClientDrivers} for the `firebase/storage` SDK
+ *
  * @example
  * ```ts
  * const drivers = firebaseStorageClientDrivers();
@@ -12135,6 +12345,7 @@ function _ts_generator$5(thisArg, body) {
  * by combining the given user model identity with the provided UID.
  *
  * @param userModelIdentity - the root identity for user models (e.g., `profileIdentity`)
+ * @returns a function that generates a {@link NotificationSummaryId} for a given user UID
  *
  * @example
  * ```ts
@@ -12158,9 +12369,9 @@ function _ts_generator$5(thisArg, body) {
 /**
  * Creates a NotificationTaskUniqueId from the input model id and task type.
  *
- * @param input model id input
- * @param taskType task type
- * @returns NotificationTaskUniqueId
+ * @param input - model id input
+ * @param taskType - task type
+ * @returns the unique notification task id combining the model id and task type
  */ function notificationTaskUniqueId(input, taskType) {
     return "".concat(firestoreModelId(input), "_").concat(taskType); // combineation of model id and template type
 }
@@ -12215,6 +12426,10 @@ function _object_spread_props$7(target, source) {
 /**
  * Merges two {@link NotificationBoxRecipientTemplateConfig} objects, preferring values from `a` over `b`.
  *
+ * @param a - primary config whose defined values take precedence
+ * @param b - fallback config supplying values when `a` fields are undefined
+ * @returns the merged template config with values from `a` preferred over `b`
+ *
  * @example
  * ```ts
  * const merged = mergeNotificationBoxRecipientTemplateConfigs(
@@ -12239,6 +12454,9 @@ function _object_spread_props$7(target, source) {
  *
  * This produces the "effective" configuration used at send time, where each channel has a definite boolean.
  *
+ * @param a - the template config to resolve
+ * @returns the effective config with each channel flag filled in using the send-default fallback
+ *
  * @example
  * ```ts
  * const effective = effectiveNotificationBoxRecipientTemplateConfig({ sd: true, se: false });
@@ -12258,6 +12476,10 @@ function _object_spread_props$7(target, source) {
  * Updates a {@link NotificationRecipient} with partial values, preserving existing fields where the update is undefined.
  *
  * Automatically clears the summary ID (`s`) when a `uid` is present.
+ *
+ * @param a - existing recipient to update
+ * @param b - partial values to apply on top of the existing recipient
+ * @returns the updated recipient with merged values
  */ function updateNotificationRecipient(a, b) {
     var inputUid = b.uid, inputN = b.n, inputE = b.e, inputT = b.t, inputS = b.s;
     var uid = util.updateMaybeValue(a.uid, inputUid);
@@ -12309,6 +12531,7 @@ function _object_spread_props$7(target, source) {
  *
  * @param uid - the user's Firebase auth UID
  * @param i - the recipient's index position in the box's recipient array
+ * @returns a new recipient entry with the given uid and index and an empty template config record
  */ function newNotificationBoxRecipientForUid(uid, i) {
     return {
         c: {},
@@ -12318,6 +12541,10 @@ function _object_spread_props$7(target, source) {
 }
 /**
  * Merges two {@link NotificationUserDefaultNotificationBoxRecipientConfig} objects, preferring defined values from `a` over `b`.
+ *
+ * @param a - primary config whose defined values take precedence
+ * @param b - fallback config supplying values when `a` fields are undefined
+ * @returns the merged config
  */ function mergeNotificationUserDefaultNotificationBoxRecipientConfig(a, b) {
     var c = mergeNotificationBoxRecipientTemplateConfigRecords(a.c, b.c);
     var result = _object_spread_props$7(_object_spread$9({}, util.mergeObjects([
@@ -12348,6 +12575,10 @@ function _object_spread_props$7(target, source) {
 })(exports.NotificationBoxRecipientTemplateConfigBoolean || (exports.NotificationBoxRecipientTemplateConfigBoolean = {}));
 /**
  * Merges two {@link NotificationBoxRecipientTemplateConfigRecord} objects, preferring defined values from `a`.
+ *
+ * @param a - primary record whose defined values take precedence
+ * @param b - fallback record supplying values when `a` entries are undefined
+ * @returns the merged template config record
  */ function mergeNotificationBoxRecipientTemplateConfigRecords(a, b) {
     var mergeConfigs = util.mergeObjectsFunction(util.KeyValueTypleValueFilter.UNDEFINED);
     return mergeConfigs([
@@ -12409,6 +12640,8 @@ var notificationBoxRecipientTemplateConfigDencoder = util.bitwiseObjectDencoder(
 /**
  * Creates a Firestore field converter for {@link NotificationBoxRecipientTemplateConfigRecord},
  * using bitwise encoding for compact storage.
+ *
+ * @returns a Firestore field converter that encodes and decodes template config records using bitwise encoding
  */ function firestoreNotificationBoxRecipientTemplateConfigRecord() {
     return firestoreBitwiseObjectMap({
         dencoder: notificationBoxRecipientTemplateConfigDencoder
@@ -12498,6 +12731,9 @@ var notificationBoxRecipientTemplateConfigDencoder = util.bitwiseObjectDencoder(
 /**
  * Converts a {@link NotificationBoxRecipientTemplateConfigRecord} to an array of entries with their type keys.
  *
+ * @param input - the template config record to convert
+ * @returns an array of entries each containing a type key and the corresponding channel config
+ *
  * @example
  * ```ts
  * const array = notificationBoxRecipientTemplateConfigRecordToArray({ 'comment': { se: true } });
@@ -12516,6 +12752,9 @@ var notificationBoxRecipientTemplateConfigDencoder = util.bitwiseObjectDencoder(
 }
 /**
  * Converts a {@link NotificationBoxRecipientTemplateConfigArray} back to a {@link NotificationBoxRecipientTemplateConfigRecord}.
+ *
+ * @param input - the array of typed config entries to convert
+ * @returns a record keyed by template type
  */ function notificationBoxRecipientTemplateConfigArrayToRecord(input) {
     var map = {};
     input.forEach(function(x) {
@@ -12558,6 +12797,7 @@ var notificationBoxRecipientTemplateConfigDencoder = util.bitwiseObjectDencoder(
  *
  * @param items - notification items to classify
  * @param considerReadIfCreatedBefore - optional cutoff date; items created at or before this date are treated as read
+ * @returns an object containing both the read and unread item arrays along with the input cutoff date
  *
  * @example
  * ```ts
@@ -12701,11 +12941,17 @@ var NotificationUserDocument = /*#__PURE__*/ function(AbstractFirestoreDocument)
 });
 /**
  * Creates a Firestore collection reference for {@link NotificationUser} documents.
+ *
+ * @param context - Firestore context to create the collection reference from
+ * @returns a typed collection reference for NotificationUser documents
  */ function notificationUserCollectionReference(context) {
     return context.collection(notificationUserIdentity.collectionName);
 }
 /**
  * Creates a typed {@link NotificationUserFirestoreCollection} bound to the given Firestore context.
+ *
+ * @param firestoreContext - Firestore context to bind the collection to
+ * @returns a typed Firestore collection for NotificationUser documents
  */ function notificationUserFirestoreCollection(firestoreContext) {
     return firestoreContext.firestoreCollection({
         modelIdentity: notificationUserIdentity,
@@ -12768,11 +13014,17 @@ var NotificationSummaryDocument = /*#__PURE__*/ function(AbstractFirestoreDocume
 });
 /**
  * Creates a Firestore collection reference for {@link NotificationSummary} documents.
+ *
+ * @param context - Firestore context to create the collection reference from
+ * @returns a typed collection reference for NotificationSummary documents
  */ function notificationSummaryCollectionReference(context) {
     return context.collection(notificationSummaryIdentity.collectionName);
 }
 /**
  * Creates a typed {@link NotificationSummaryFirestoreCollection} bound to the given Firestore context.
+ *
+ * @param firestoreContext - Firestore context to bind the collection to
+ * @returns a typed Firestore collection for NotificationSummary documents
  */ function notificationSummaryFirestoreCollection(firestoreContext) {
     return firestoreContext.firestoreCollection({
         modelIdentity: notificationSummaryIdentity,
@@ -12835,11 +13087,17 @@ var NotificationBoxDocument = /*#__PURE__*/ function(AbstractFirestoreDocument)
 });
 /**
  * Creates a Firestore collection reference for {@link NotificationBox} documents.
+ *
+ * @param context - Firestore context to create the collection reference from
+ * @returns a typed collection reference for NotificationBox documents
  */ function notificationBoxCollectionReference(context) {
     return context.collection(notificationBoxIdentity.collectionName);
 }
 /**
  * Creates a typed {@link NotificationBoxFirestoreCollection} bound to the given Firestore context.
+ *
+ * @param firestoreContext - Firestore context to bind the collection to
+ * @returns a typed Firestore collection for NotificationBox documents
  */ function notificationBoxFirestoreCollection(firestoreContext) {
     return firestoreContext.firestoreCollection({
         modelIdentity: notificationBoxIdentity,
@@ -13007,6 +13265,9 @@ var NotificationDocument = /*#__PURE__*/ function(AbstractFirestoreDocumentWithP
 });
 /**
  * Creates a factory that produces {@link Notification} subcollection references for a given {@link NotificationBoxDocument} parent.
+ *
+ * @param context - Firestore context to create subcollection references from
+ * @returns a factory function that creates collection references for a given NotificationBox parent
  */ function notificationCollectionReferenceFactory(context) {
     return function(notificationBox) {
         return context.subcollection(notificationBox.documentRef, notificationIdentity.collectionName);
@@ -13014,6 +13275,9 @@ var NotificationDocument = /*#__PURE__*/ function(AbstractFirestoreDocumentWithP
 }
 /**
  * Creates a {@link NotificationFirestoreCollectionFactory} bound to the given Firestore context.
+ *
+ * @param firestoreContext - Firestore context to bind the collection factory to
+ * @returns a factory that creates typed Firestore subcollections for Notification documents
  */ function notificationFirestoreCollectionFactory(firestoreContext) {
     var factory = notificationCollectionReferenceFactory(firestoreContext);
     return function(parent) {
@@ -13031,11 +13295,17 @@ var NotificationDocument = /*#__PURE__*/ function(AbstractFirestoreDocumentWithP
 }
 /**
  * Creates a collection group reference for querying all {@link Notification} documents across all {@link NotificationBox} parents.
+ *
+ * @param context - Firestore context to create the collection group reference from
+ * @returns a typed collection group for querying Notification documents across all parents
  */ function notificationCollectionReference(context) {
     return context.collectionGroup(notificationIdentity.collectionName);
 }
 /**
  * Creates a typed {@link NotificationFirestoreCollectionGroup} bound to the given Firestore context.
+ *
+ * @param firestoreContext - Firestore context to bind the collection group to
+ * @returns a typed Firestore collection group for querying Notification documents across all parents
  */ function notificationFirestoreCollectionGroup(firestoreContext) {
     return firestoreContext.firestoreCollectionGroup({
         modelIdentity: notificationIdentity,
@@ -13084,6 +13354,9 @@ var NotificationWeekDocument = /*#__PURE__*/ function(AbstractFirestoreDocumentW
 });
 /**
  * Creates a factory that produces {@link NotificationWeek} subcollection references for a given {@link NotificationBoxDocument} parent.
+ *
+ * @param context - Firestore context to create subcollection references from
+ * @returns a factory function that creates collection references for a given NotificationBox parent
  */ function notificationWeekCollectionReferenceFactory(context) {
     return function(notificationBox) {
         return context.subcollection(notificationBox.documentRef, notificationWeekIdentity.collectionName);
@@ -13091,6 +13364,9 @@ var NotificationWeekDocument = /*#__PURE__*/ function(AbstractFirestoreDocumentW
 }
 /**
  * Creates a {@link NotificationWeekFirestoreCollectionFactory} bound to the given Firestore context.
+ *
+ * @param firestoreContext - Firestore context to bind the collection factory to
+ * @returns a factory that creates typed Firestore subcollections for NotificationWeek documents
  */ function notificationWeekFirestoreCollectionFactory(firestoreContext) {
     var factory = notificationWeekCollectionReferenceFactory(firestoreContext);
     return function(parent) {
@@ -13108,11 +13384,17 @@ var NotificationWeekDocument = /*#__PURE__*/ function(AbstractFirestoreDocumentW
 }
 /**
  * Creates a collection group reference for querying all {@link NotificationWeek} documents across all {@link NotificationBox} parents.
+ *
+ * @param context - Firestore context to create the collection group reference from
+ * @returns a typed collection group for querying NotificationWeek documents across all parents
  */ function notificationWeekCollectionReference(context) {
     return context.collectionGroup(notificationWeekIdentity.collectionName);
 }
 /**
  * Creates a typed {@link NotificationWeekFirestoreCollectionGroup} bound to the given Firestore context.
+ *
+ * @param firestoreContext - Firestore context to bind the collection group to
+ * @returns a typed Firestore collection group for querying NotificationWeek documents across all parents
  */ function notificationWeekFirestoreCollectionGroup(firestoreContext) {
     return firestoreContext.firestoreCollectionGroup({
         modelIdentity: notificationWeekIdentity,
@@ -13257,16 +13539,42 @@ var notificationBoxModelCrudFunctionsConfig = {
  *
  * Error code constants thrown by the notification server action service.
  * These codes are returned in Firebase function error responses for client-side handling.
- */ /** Thrown when a notification creation request is missing a required ID. */ var CREATE_NOTIFICATION_ID_REQUIRED_ERROR_CODE = 'CREATE_NOTIFICATION_ID_REQUIRED';
-/** Thrown when attempting to initialize a NotificationBox or NotificationSummary that is already initialized. */ var NOTIFICATION_MODEL_ALREADY_INITIALIZED_ERROR_CODE = 'NOTIFICATION_MODEL_ALREADY_INITIALIZED';
-/** Thrown when the target NotificationBox does not exist. */ var NOTIFICATION_BOX_DOES_NOT_EXIST_ERROR_CODE = 'NOTIFICATION_BOX_DOES_NOT_EXIST';
-/** Thrown when attempting to create a NotificationBox for a model that already has one. */ var NOTIFICATION_BOX_EXISTS_FOR_MODEL_ERROR_CODE = 'NOTIFICATION_BOX_EXISTS_FOR_MODEL';
-/** Thrown when the target recipient does not exist in the NotificationBox. */ var NOTIFICATION_BOX_RECIPIENT_DOES_NOT_EXIST_ERROR_CODE = 'NOTIFICATION_BOX_RECIPIENT_DOES_NOT_EXIST';
-/** Thrown when an exclusion target is invalid (e.g., user not associated with the box). */ var NOTIFICATION_BOX_EXCLUSION_TARGET_INVALID_ERROR_CODE = 'NOTIFICATION_BOX_EXCLUSION_TARGET_INVALID';
-/** Thrown when the UID provided for NotificationUser creation is invalid. */ var NOTIFICATION_USER_INVALID_UID_FOR_CREATE_ERROR_CODE = 'NOTIFICATION_USER_INVALID_UID_FOR_CREATE';
-/** Thrown when attempting to add a user who has blocked themselves from being added as a recipient. */ var NOTIFICATION_USER_BLOCKED_FROM_BEING_ADD_TO_RECIPIENTS_ERROR_CODE = 'NOTIFICATION_USER_BLOCKED_FROM_BEING_ADD_TO_RECIPIENTS';
-/** Thrown when attempting to update a recipient config that is locked by the user. */ var NOTIFICATION_USER_LOCKED_CONFIG_FROM_BEING_UPDATED_ERROR_CODE = 'NOTIFICATION_USER_LOCKED_CONFIG_FROM_BEING_UPDATED';
+ */ /**
+ * Thrown when a notification creation request is missing a required ID.
+ */ var CREATE_NOTIFICATION_ID_REQUIRED_ERROR_CODE = 'CREATE_NOTIFICATION_ID_REQUIRED';
+/**
+ * Thrown when attempting to initialize a NotificationBox or NotificationSummary that is already initialized.
+ */ var NOTIFICATION_MODEL_ALREADY_INITIALIZED_ERROR_CODE = 'NOTIFICATION_MODEL_ALREADY_INITIALIZED';
+/**
+ * Thrown when the target NotificationBox does not exist.
+ */ var NOTIFICATION_BOX_DOES_NOT_EXIST_ERROR_CODE = 'NOTIFICATION_BOX_DOES_NOT_EXIST';
+/**
+ * Thrown when attempting to create a NotificationBox for a model that already has one.
+ */ var NOTIFICATION_BOX_EXISTS_FOR_MODEL_ERROR_CODE = 'NOTIFICATION_BOX_EXISTS_FOR_MODEL';
+/**
+ * Thrown when the target recipient does not exist in the NotificationBox.
+ */ var NOTIFICATION_BOX_RECIPIENT_DOES_NOT_EXIST_ERROR_CODE = 'NOTIFICATION_BOX_RECIPIENT_DOES_NOT_EXIST';
+/**
+ * Thrown when an exclusion target is invalid (e.g., user not associated with the box).
+ */ var NOTIFICATION_BOX_EXCLUSION_TARGET_INVALID_ERROR_CODE = 'NOTIFICATION_BOX_EXCLUSION_TARGET_INVALID';
+/**
+ * Thrown when the UID provided for NotificationUser creation is invalid.
+ */ var NOTIFICATION_USER_INVALID_UID_FOR_CREATE_ERROR_CODE = 'NOTIFICATION_USER_INVALID_UID_FOR_CREATE';
+/**
+ * Thrown when attempting to add a user who has blocked themselves from being added as a recipient.
+ */ var NOTIFICATION_USER_BLOCKED_FROM_BEING_ADD_TO_RECIPIENTS_ERROR_CODE = 'NOTIFICATION_USER_BLOCKED_FROM_BEING_ADD_TO_RECIPIENTS';
+/**
+ * Thrown when attempting to update a recipient config that is locked by the user.
+ */ var NOTIFICATION_USER_LOCKED_CONFIG_FROM_BEING_UPDATED_ERROR_CODE = 'NOTIFICATION_USER_LOCKED_CONFIG_FROM_BEING_UPDATED';
 
+function _array_like_to_array$5(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes$4(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$5(arr);
+}
 function _define_property$8(obj, key, value) {
     if (key in obj) {
         Object.defineProperty(obj, key, {
@@ -13280,6 +13588,12 @@ function _define_property$8(obj, key, value) {
     }
     return obj;
 }
+function _iterable_to_array$4(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread$4() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
 function _object_spread$8(target) {
     for(var i = 1; i < arguments.length; i++){
         var source = arguments[i] != null ? arguments[i] : {};
@@ -13314,6 +13628,17 @@ function _object_spread_props$6(target, source) {
     }
     return target;
 }
+function _to_consumable_array$4(arr) {
+    return _array_without_holes$4(arr) || _iterable_to_array$4(arr) || _unsupported_iterable_to_array$5(arr) || _non_iterable_spread$4();
+}
+function _unsupported_iterable_to_array$5(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$5(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$5(o, minLen);
+}
 /**
  * Applies an array of config entry params to a {@link NotificationBoxRecipientTemplateConfigRecord},
  * inserting new entries, merging updates, and removing entries marked with `remove: true`.
@@ -13321,31 +13646,29 @@ function _object_spread_props$6(target, source) {
  * @param a - existing config record
  * @param b - array of update params to apply
  * @param limitToAllowedConfigTypes - when provided, filters the result to only include these template types
+ * @returns the updated config record, or undefined if no changes were made
  */ function updateNotificationBoxRecipientTemplateConfigRecord(a, b, limitToAllowedConfigTypes) {
-    var c;
-    if (b != null) {
-        var cArray = notificationBoxRecipientTemplateConfigRecordToArray(a);
-        var updatedC = util.ModelRelationUtility.insertCollection(cArray, b, {
-            readKey: function readKey(x) {
-                return x.type;
-            },
-            merge: function merge(x, y) {
-                return _object_spread$8({}, x, y);
-            }
-        });
-        // remove types marked as remove
-        updatedC = util.ModelRelationUtility.removeKeysFromCollection(updatedC, b.filter(function(x) {
-            return x.remove;
-        }).map(function(x) {
-            return x.type;
-        }), function(x) {
+    var cArray = notificationBoxRecipientTemplateConfigRecordToArray(a);
+    var updatedC = util.ModelRelationUtility.insertCollection(cArray, b, {
+        readKey: function readKey(x) {
             return x.type;
-        });
-        c = notificationBoxRecipientTemplateConfigArrayToRecord(updatedC);
-        // if the config types are limited to specific types, then filter those only
-        if (limitToAllowedConfigTypes) {
-            c = util.filterKeysOnPOJOFunction(limitToAllowedConfigTypes)(c);
+        },
+        merge: function merge(x, y) {
+            return _object_spread$8({}, x, y);
         }
+    });
+    // remove types marked as remove
+    updatedC = util.ModelRelationUtility.removeKeysFromCollection(updatedC, b.filter(function(x) {
+        return x.remove;
+    }).map(function(x) {
+        return x.type;
+    }), function(x) {
+        return x.type;
+    });
+    var c = notificationBoxRecipientTemplateConfigArrayToRecord(updatedC);
+    // if the config types are limited to specific types, then filter those only
+    if (limitToAllowedConfigTypes) {
+        c = util.filterKeysOnPOJOFunction(limitToAllowedConfigTypes)(c);
     }
     return c;
 }
@@ -13356,6 +13679,7 @@ function _object_spread_props$6(target, source) {
  * @param a - existing config
  * @param b - update params to apply
  * @param limitToAllowedConfigTypes - when provided, filters config types to only allowed template types
+ * @returns the updated default recipient config
  */ function updateNotificationUserDefaultNotificationBoxRecipientConfig(a, b, limitToAllowedConfigTypes) {
     var _ref;
     var inputC = b.configs, inputF = b.f, inputBk = b.bk, inputLk = b.lk;
@@ -13372,6 +13696,11 @@ function _object_spread_props$6(target, source) {
  * only if it actually changed. Returns `undefined` if no changes were detected.
  *
  * Automatically sets `ns = true` (needs sync) when changes are detected and the recipient has been indexed.
+ *
+ * @param a - existing per-box recipient config
+ * @param b - update params to apply
+ * @param limitToAllowedConfigTypes - when provided, filters template config types to only allowed types
+ * @returns the updated config if changes were detected, or undefined if no changes occurred
  */ function updateNotificationUserNotificationBoxRecipientConfigIfChanged(a, b, limitToAllowedConfigTypes) {
     var _ref;
     var inputC = b.configs, inputRm = b.rm, inputLk = b.lk, inputBk = b.bk;
@@ -13402,6 +13731,11 @@ function _object_spread_props$6(target, source) {
  * through the optional {@link AppNotificationTemplateTypeInfoRecordService}.
  *
  * Returns `undefined` if no changes were made.
+ *
+ * @param a - existing per-box recipient config array
+ * @param b - array of update params to apply to matching boxes
+ * @param filterWithService - optional service used to filter template types to only those valid for each box's model
+ * @returns the updated config array if any changes occurred, or undefined if nothing changed
  */ function updateNotificationUserNotificationBoxRecipientConfigs(a, b, filterWithService) {
     var boxesMap = util.makeModelMap(a, function(x) {
         return x.nb;
@@ -13431,7 +13765,7 @@ function _object_spread_props$6(target, source) {
     });
     var result;
     if (hasChanges) {
-        result = Array.from(boxesMap.values());
+        result = _to_consumable_array$4(boxesMap.values());
     }
     return result;
 }
@@ -13570,6 +13904,9 @@ function _ts_generator$4(thisArg, body) {
  *
  * Maps friendly field names (`subject`, `message`, `createdBy`, etc.) to their Firestore abbreviations
  * and filters out null/undefined metadata values.
+ *
+ * @param input - friendly input with readable field names
+ * @returns the low-level template using Firestore field abbreviations
  */ function createNotificationTemplate(input) {
     var _ref, _ref1;
     var inputNotificationModel = input.notificationModel, type = input.type, unique = input.unique, overrideExistingTask = input.overrideExistingTask, // notification
@@ -13616,6 +13953,9 @@ function _ts_generator$4(thisArg, body) {
  * Determines whether a notification should be created based on the explicit toggle and throttle settings.
  *
  * Returns false if `sendNotification` is explicitly false, or if the throttle window hasn't elapsed.
+ *
+ * @param input - the send control parameters including the toggle and throttle configuration
+ * @returns true if the notification should be created and sent
  */ function shouldSendCreatedNotificationInput(input) {
     var sendNotification = input.sendNotification, sendNotificationThrottleDate = input.sendNotificationThrottleDate, inputSendNotificationThrottleTime = input.sendNotificationThrottleTime;
     var sendNotificationThrottleTime = inputSendNotificationThrottleTime !== null && inputSendNotificationThrottleTime !== void 0 ? inputSendNotificationThrottleTime : util.MS_IN_HOUR;
@@ -13629,6 +13969,8 @@ function _ts_generator$4(thisArg, body) {
  *
  * For unique task notifications, generates a deterministic document ID from the target model and task type.
  *
+ * @param input - the creation parameters including template, context, and accessor
+ * @returns the document reference and notification data pair, with `notificationCreated` set to false
  * @throws {Error} When neither an accessor nor sufficient context is provided
  * @throws {Error} When `unique=true` but no target model is specified
  */ function createNotificationDocumentPair(input) {
@@ -13637,15 +13979,13 @@ function _ts_generator$4(thisArg, body) {
     var notificationModel = template.notificationModel, inputCat = template.cat, st = template.st, sat = template.sat, r = template.r, rf = template.rf, n = template.n, ts = template.ts, es = template.es, ps = template.ps, ns = template.ns, ois = template.ois, ots = template.ots, tpr = template.tpr, inputUnique = template.unique, inputOverrideExistingTask = template.overrideExistingTask;
     /**
      * Use the input, or default to true if inputUnique is true.
-     */ var overrideExistingTask = inputOverrideExistingTask != null ? inputOverrideExistingTask : inputUnique ? true : undefined;
+     */ var overrideExistingTask = inputOverrideExistingTask !== null && inputOverrideExistingTask !== void 0 ? inputOverrideExistingTask : inputUnique ? true : undefined;
     var accessor = inputAccessor;
     var notificationBoxId = notificationBoxIdForModel(notificationModel);
-    if (!accessor && notificationBoxId) {
-        if (context) {
-            var notificationCollectionFactory = context.notificationCollectionFactory, notificationBoxCollection = context.notificationBoxCollection;
-            var notificationBoxDocument = notificationBoxCollection.documentAccessorForTransaction(transaction).loadDocumentForId(notificationBoxId);
-            accessor = notificationCollectionFactory(notificationBoxDocument).documentAccessorForTransaction(transaction);
-        }
+    if (!accessor && notificationBoxId && context) {
+        var notificationCollectionFactory = context.notificationCollectionFactory, notificationBoxCollection = context.notificationBoxCollection;
+        var notificationBoxDocument = notificationBoxCollection.documentAccessorForTransaction(transaction).loadDocumentForId(notificationBoxId);
+        accessor = notificationCollectionFactory(notificationBoxDocument).documentAccessorForTransaction(transaction);
     }
     if (!accessor) {
         throw new Error('createNotificationDocument() failed as neither an accessor nor sufficient information was provided about the target.');
@@ -13726,6 +14066,10 @@ function _ts_generator$4(thisArg, body) {
 }
 /**
  * Internal function used by createNotificationDocument().
+ *
+ * @param input - send control parameters (throttle settings, shouldCreateNotification flag)
+ * @param pair - the document pair created by {@link createNotificationDocumentPair}
+ * @returns the pair with `notificationCreated` updated to reflect whether the document was saved
  */ function _createNotificationDocumentFromPair(input, pair) {
     return _async_to_generator$4(function() {
         var notification, notificationDocument, isNotificationTask, overrideExistingTask;
@@ -13776,6 +14120,9 @@ function _ts_generator$4(thisArg, body) {
  *
  * For unique tasks with `overrideExistingTask`, uses `set()` to replace existing documents.
  * Otherwise uses `create()` which fails if the document already exists.
+ *
+ * @param input - the creation parameters including template, context, send control settings
+ * @returns the document pair with `notificationCreated` reflecting whether the document was saved
  */ function createNotificationDocument(input) {
     return _async_to_generator$4(function() {
         var pair;
@@ -13792,6 +14139,9 @@ function _ts_generator$4(thisArg, body) {
  * Creates and saves a notification only if sending conditions are met (not throttled, not explicitly disabled).
  *
  * Returns `undefined` if the notification was not created.
+ *
+ * @param input - the creation parameters including template, context, and send control settings
+ * @returns the document pair if the notification was created, or undefined if it was skipped
  */ function createNotificationDocumentIfSending(input) {
     return _async_to_generator$4(function() {
         var pair;
@@ -13870,6 +14220,8 @@ function _object_spread_props$5(target, source) {
 /**
  * Creates a {@link CreateNotificationTaskTemplate} with `TASK_NOTIFICATION` send type and no recipients.
  *
+ * @param input - task template input parameters
+ * @returns the configured task notification template
  * @throws {Error} When `unique=true` but no `notificationModel` or target model is specified.
  *
  * @example
@@ -13907,11 +14259,17 @@ function _array_like_to_array$4(arr, len) {
 function _array_with_holes$1(arr) {
     if (Array.isArray(arr)) return arr;
 }
+function _array_without_holes$3(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array$4(arr);
+}
 function _class_call_check$5(instance, Constructor) {
     if (!(instance instanceof Constructor)) {
         throw new TypeError("Cannot call a class as a function");
     }
 }
+function _iterable_to_array$3(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
 function _iterable_to_array_limit$1(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
@@ -13939,9 +14297,15 @@ function _iterable_to_array_limit$1(arr, i) {
 function _non_iterable_rest$1() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
+function _non_iterable_spread$3() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
 function _sliced_to_array$1(arr, i) {
     return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$4(arr, i) || _non_iterable_rest$1();
 }
+function _to_consumable_array$3(arr) {
+    return _array_without_holes$3(arr) || _iterable_to_array$3(arr) || _unsupported_iterable_to_array$4(arr) || _non_iterable_spread$3();
+}
 function _unsupported_iterable_to_array$4(o, minLen) {
     if (!o) return;
     if (typeof o === "string") return _array_like_to_array$4(o, minLen);
@@ -13953,6 +14317,8 @@ function _unsupported_iterable_to_array$4(o, minLen) {
 /**
  * Creates a {@link NotificationTemplateTypeInfoRecord} from an array of template type info entries.
  *
+ * @param infoArray - array of template type info entries to index
+ * @returns a record keyed by template type
  * @throws {Error} When duplicate template types are found in the input array.
  *
  * @example
@@ -13989,6 +14355,7 @@ function _unsupported_iterable_to_array$4(o, minLen) {
  * Handles alternative model identities defined in {@link NotificationTemplateTypeInfoIdentityInfoAlternativeModelIdentityPair}.
  *
  * @param appNotificationTemplateTypeInfoRecord - the complete template type registry for the application
+ * @returns a fully initialized service with indexed lookups for fast template type discovery
  *
  * @example
  * ```ts
@@ -14023,10 +14390,10 @@ function _unsupported_iterable_to_array$4(o, minLen) {
         allKnownTemplateTypeInfo.push(info);
         allKnownTemplateTypes.push(info.type);
     });
-    var allNotificationModelIdentityValues = Array.from(allNotificationModelIdentityValuesSet);
+    var allNotificationModelIdentityValues = _to_consumable_array$3(allNotificationModelIdentityValuesSet);
     var notificationModelTemplateInfoMap = notificationModelTypeInfoMapBuilder.map();
     var targetModelTemplateInfoMap = targetModelTypeInfoMapBuilder.map();
-    var notificationModelTemplateTypesMap = new Map(Array.from(notificationModelTemplateInfoMap.entries()).map(function(param) {
+    var notificationModelTemplateTypesMap = new Map(_to_consumable_array$3(notificationModelTemplateInfoMap.entries()).map(function(param) {
         var _param = _sliced_to_array$1(param, 2), k = _param[0], x = _param[1];
         return [
             k,
@@ -14035,7 +14402,7 @@ function _unsupported_iterable_to_array$4(o, minLen) {
             })
         ];
     }));
-    var targetModelTemplateTypesMap = new Map(Array.from(targetModelTemplateInfoMap.entries()).map(function(param) {
+    var targetModelTemplateTypesMap = new Map(_to_consumable_array$3(targetModelTemplateInfoMap.entries()).map(function(param) {
         var _param = _sliced_to_array$1(param, 2), k = _param[0], x = _param[1];
         return [
             k,
@@ -14239,6 +14606,7 @@ function _ts_generator$3(thisArg, body) {
  *
  * @param fn - base function that generates message content per recipient
  * @param extras - optional delivery customization (global recipients, send callbacks)
+ * @returns a {@link NotificationMessageFunction} with the extras attached
  *
  * @example
  * ```ts
@@ -14266,6 +14634,8 @@ function _ts_generator$3(thisArg, body) {
  *
  * Useful as a placeholder factory for template types that should not produce deliverable content.
  *
+ * @returns a factory that produces no-content message functions
+ *
  * @example
  * ```ts
  * const factory = noContentNotificationMessageFunctionFactory();
@@ -14274,7 +14644,7 @@ function _ts_generator$3(thisArg, body) {
  * // msg.flag === NotificationMessageFlag.NO_CONTENT
  * ```
  */ function noContentNotificationMessageFunctionFactory() {
-    return function(config) {
+    return function(_config) {
         return _async_to_generator$3(function() {
             return _ts_generator$3(this, function(_state) {
                 // const { item } = config;
@@ -14309,6 +14679,8 @@ function _ts_generator$3(thisArg, body) {
  * Query constraints for finding {@link NotificationUser} documents that have pending config syncs (`ns == true`).
  *
  * Used by the server to discover users whose configs need to be synced to their NotificationBox recipients.
+ *
+ * @returns array of Firestore query constraints filtering for users needing sync
  */ function notificationUsersFlaggedForNeedsSyncQuery() {
     return [
         where('ns', '==', true)
@@ -14318,6 +14690,7 @@ function _ts_generator$3(thisArg, body) {
  * Query constraints for finding {@link NotificationUser} documents that have any of the given exclusion IDs in their `x` array.
  *
  * @param exclusionId - one or more box IDs or collection name prefixes to match against
+ * @returns array of Firestore query constraints filtering for users with matching exclusions
  */ function notificationUserHasExclusionQuery(exclusionId) {
     return [
         where('x', 'array-contains-any', exclusionId)
@@ -14326,6 +14699,8 @@ function _ts_generator$3(thisArg, body) {
 // MARK: NotificationSummary
 /**
  * Query constraints for finding {@link NotificationSummary} documents that need server-side initialization (`s == true`).
+ *
+ * @returns array of Firestore query constraints filtering for summaries needing initialization
  */ function notificationSummariesFlaggedForNeedsInitializationQuery() {
     return [
         where('s', '==', true)
@@ -14335,6 +14710,8 @@ function _ts_generator$3(thisArg, body) {
 // MARK: NotificationBox
 /**
  * Query constraints for finding {@link NotificationBox} documents that need server-side initialization (`s == true`).
+ *
+ * @returns array of Firestore query constraints filtering for boxes needing initialization
  */ function notificationBoxesFlaggedForNeedsInitializationQuery() {
     return [
         where('s', '==', true)
@@ -14344,6 +14721,8 @@ function _ts_generator$3(thisArg, body) {
  * Query constraints for finding {@link NotificationBox} documents flagged as invalid (`fi == true`).
  *
  * Used by the server to clean up boxes that could not be initialized.
+ *
+ * @returns array of Firestore query constraints filtering for boxes flagged as invalid
  */ function notificationBoxesFlaggedInvalidQuery() {
     return [
         where('fi', '==', true)
@@ -14357,6 +14736,7 @@ function _ts_generator$3(thisArg, body) {
  * This is the primary query used by the send queue processor.
  *
  * @param now - reference time for the `sat` comparison (defaults to current time)
+ * @returns array of Firestore query constraints filtering for notifications past their scheduled send time
  */ function notificationsPastSendAtTimeQuery() {
     var now = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : new Date();
     return [
@@ -14367,6 +14747,8 @@ function _ts_generator$3(thisArg, body) {
 /**
  * Query constraints for finding {@link Notification} documents marked as done (`d == true`)
  * and ready to be archived to {@link NotificationWeek} and then deleted.
+ *
+ * @returns array of Firestore query constraints filtering for completed notifications ready to archive
  */ function notificationsReadyForCleanupQuery() {
     return [
         where('d', '==', true)
@@ -14403,6 +14785,10 @@ function _unsupported_iterable_to_array$3(o, minLen) {
  *
  * Used when combining results from multiple send batches within the same channel.
  *
+ * @param a - first result to merge
+ * @param b - second result to merge
+ * @returns a new result with all recipient lists concatenated from both inputs
+ *
  * @example
  * ```ts
  * const combined = mergeNotificationSendMessagesResult(firstBatchResult, secondBatchResult);
@@ -14469,6 +14855,8 @@ function _object_spread_props$4(target, source) {
  * Use this when the handler needs more time but doesn't want to increment the failure counter.
  * The task will be re-queued without counting as an error attempt.
  *
+ * @returns an empty checkpoint array signaling in-progress without failure
+ *
  * @example
  * ```ts
  * // Waiting for an external process — delay without failing
@@ -14484,6 +14872,7 @@ function _object_spread_props$4(target, source) {
  *
  * @param delayUntil - absolute date or relative milliseconds from the task's run start time
  * @param updateMetadata - optional metadata updates to merge into the notification item
+ * @returns a task result that re-queues the task after the specified delay without marking it failed
  *
  * @example
  * ```ts
@@ -14505,6 +14894,7 @@ function _object_spread_props$4(target, source) {
  *
  * @param completedParts - checkpoint string(s) that were just completed
  * @param updateMetadata - optional metadata updates to merge into the notification item
+ * @returns a task result marking the given checkpoints complete while keeping the task running
  *
  * @example
  * ```ts
@@ -14521,6 +14911,7 @@ function _object_spread_props$4(target, source) {
  * Returns a result indicating the task completed successfully. The notification document will be deleted.
  *
  * @param updateMetadata - optional final metadata update (applied before deletion if subtasks need it)
+ * @returns a task result signaling successful completion; the notification document will be deleted
  *
  * @example
  * ```ts
@@ -14540,6 +14931,7 @@ function _object_spread_props$4(target, source) {
  *
  * @param updateMetadata - optional metadata updates
  * @param removeFromCompletedCheckpoints - checkpoint(s) to remove from the completed set (e.g., to retry a checkpoint)
+ * @returns a task result signaling failure; the error attempt counter is incremented
  *
  * @example
  * ```ts
@@ -14561,6 +14953,7 @@ function _object_spread_props$4(target, source) {
  *
  * @param result - the task result to wrap
  * @param force - when true, overrides any existing `canRunNextCheckpoint` value
+ * @returns a copy of the result with `canRunNextCheckpoint` set to true
  */ function notificationTaskCanRunNextCheckpoint(result, force) {
     if (force || result.canRunNextCheckpoint == null) {
         result = _object_spread_props$4(_object_spread$6({}, result), {
@@ -14634,6 +15027,8 @@ function _object_spread_props$3(target, source) {
  * Internal helper that marks the `'processing'` checkpoint complete and schedules the `'cleanup'` phase.
  *
  * Prefer using {@link notificationSubtaskComplete} in subtask handlers instead of calling this directly.
+ *
+ * @returns a partially-complete task result with the processing checkpoint marked done
  */ function completeSubtaskProcessingAndScheduleCleanupTaskResult() {
     return notificationTaskPartiallyComplete([
         'processing'
@@ -14645,6 +15040,9 @@ function _object_spread_props$3(target, source) {
  * Unlike {@link notificationTaskComplete}, this signals that the cleanup checkpoint should still run.
  * Use `canRunNextCheckpoint: true` in options to run cleanup immediately in the same execution.
  *
+ * @param options - optional metadata updates and flag to run cleanup immediately in the same execution
+ * @returns a task result marking the subtask as complete while allowing cleanup to proceed
+ *
  * @example
  * ```ts
  * // Processing done, schedule cleanup for next run
@@ -14737,6 +15135,9 @@ function _unsupported_iterable_to_array$2(o, minLen) {
  *
  * Filters template configs to only include types applicable to the notification box's model.
  * Used during the server-side sync process to update box recipient entries from user configs.
+ *
+ * @param input - the merged config inputs including uid, global config, box config, and optional existing recipient
+ * @returns the computed effective box recipient with merged config, contact info, and flags
  */ function effectiveNotificationBoxRecipientConfig(input) {
     var _ref, _ref1, _gc_f, _gc_lk, _gc_e, _gc_t;
     var uid = input.uid, inputM = input.m, appNotificationTemplateTypeInfoRecordService = input.appNotificationTemplateTypeInfoRecordService, gc = input.gc, notificationUserNotificationBoxConfig = input.boxConfig, recipient = input.recipient;
@@ -14768,6 +15169,9 @@ function _unsupported_iterable_to_array$2(o, minLen) {
  * and propagates exclusion flags to the per-box configs.
  *
  * Exclusions not matching any associated notification box are automatically filtered out.
+ *
+ * @param input - the user, exclusions to add, and exclusions to remove
+ * @returns the updated exclusion list and the partial user update to apply
  */ function updateNotificationUserNotificationSendExclusions(input) {
     var notificationUser = input.notificationUser, inputAddExclusions = input.addExclusions, inputRemoveExclusions = input.removeExclusions;
     var associatedNotificationBoxes = notificationUser.b, currentExclusions = notificationUser.x, notificationBoxConfigs = notificationUser.bc;
@@ -14805,6 +15209,9 @@ function _unsupported_iterable_to_array$2(o, minLen) {
 /**
  * Applies the current exclusion list to per-box configs, setting/clearing the `x` flag and marking
  * changed configs as needing sync (`ns = true`).
+ *
+ * @param params - the exclusion list, per-box configs, and optional flag to recalculate the global ns flag
+ * @returns the updated per-box configs and the recalculated needs-sync flag
  */ function applyExclusionsToNotificationUserNotificationBoxRecipientConfigs(params) {
     var _ref, _ref1;
     var inputX = params.x, inputBc = params.bc, notificationUser = params.notificationUser, recalculateNs = params.recalculateNs;
@@ -14832,6 +15239,9 @@ function _unsupported_iterable_to_array$2(o, minLen) {
 }
 /**
  * Returns true if any of the per-box configs need syncing (`ns == true`).
+ *
+ * @param configs - array of per-box recipient configs to check
+ * @returns true if at least one config has its needs-sync flag set
  */ function calculateNsForNotificationUserNotificationBoxRecipientConfigs(configs) {
     return configs.some(function(x) {
         return x.ns;
@@ -14840,11 +15250,14 @@ function _unsupported_iterable_to_array$2(o, minLen) {
 /**
  * Creates a {@link NotificationSendExclusionCanSendFunction} from the given exclusion list.
  * Returns true for IDs that don't match any exclusion prefix.
+ *
+ * @param exclusions - the list of box IDs or prefixes that should be excluded from delivery
+ * @returns a predicate function that returns true if the given notification/box ID is not excluded
  */ var notificationSendExclusionCanSendFunction = function notificationSendExclusionCanSendFunction(exclusions) {
     var fn = function fn(notification) {
-        return exclusions.findIndex(function(x) {
+        return !exclusions.some(function(x) {
             return notification.startsWith(x);
-        }) === -1;
+        });
     };
     fn._exclusions = exclusions;
     return fn;
@@ -14853,12 +15266,18 @@ function _unsupported_iterable_to_array$2(o, minLen) {
 /**
  * Returns true if all channels on the notification have reached a terminal state
  * (NONE, NO_TRY, SENT, or SKIPPED). Used to determine if the notification can be marked done.
+ *
+ * @param input - the per-channel send flags to evaluate
+ * @returns true if all channels are in a terminal send state
  */ function notificationSendFlagsImplyIsComplete(input) {
     return isCompleteNotificationSendState(input.es) && isCompleteNotificationSendState(input.ps) && isCompleteNotificationSendState(input.ts) && isCompleteNotificationSendState(input.ns);
 }
 /**
  * Returns true if the given send state is terminal — no further send attempts will be made.
  * Terminal states: NONE, NO_TRY, SENT, SKIPPED.
+ *
+ * @param input - the send state to evaluate
+ * @returns true if the state is terminal and no further delivery will be attempted
  */ function isCompleteNotificationSendState(input) {
     var isComplete = false;
     switch(input){
@@ -14868,7 +15287,11 @@ function _unsupported_iterable_to_array$2(o, minLen) {
         case exports.NotificationSendState.SKIPPED:
             isComplete = true;
             break;
-        default:
+        case exports.NotificationSendState.QUEUED:
+        case exports.NotificationSendState.SENT_PARTIAL:
+        case exports.NotificationSendState.SEND_ERROR:
+        case exports.NotificationSendState.BUILD_ERROR:
+        case exports.NotificationSendState.CONFIG_ERROR:
             isComplete = false;
             break;
     }
@@ -14876,6 +15299,9 @@ function _unsupported_iterable_to_array$2(o, minLen) {
 }
 /**
  * Resolves which recipient groups (global, box, explicit) are allowed based on the {@link NotificationRecipientSendFlag}.
+ *
+ * @param flag - the recipient send flag controlling which groups are included
+ * @returns an object indicating which recipient groups are permitted for this notification
  */ function allowedNotificationRecipients(flag) {
     var canSendToGlobalRecipients = true;
     var canSendToBoxRecipients = true;
@@ -14909,6 +15335,9 @@ function _unsupported_iterable_to_array$2(o, minLen) {
  *
  * Only notifications that can be sent to box recipients are archived (notifications restricted
  * to only explicit or only global recipients are not saved to the weekly archive).
+ *
+ * @param notification - the notification to check
+ * @returns true if the notification should be saved to the weekly archive after delivery
  */ function shouldSaveNotificationToNotificationWeek(notification) {
     return allowedNotificationRecipients(notification.rf).canSendToBoxRecipients;
 }
@@ -14916,6 +15345,10 @@ function _unsupported_iterable_to_array$2(o, minLen) {
 /**
  * Merges a partial update into a {@link NotificationUserNotificationBoxRecipientConfig},
  * preserving user-controlled fields (`nb`, `rm`, `ns`, `lk`, `bk`) and respecting OPT_OUT state.
+ *
+ * @param a - base user box recipient config to merge into
+ * @param b - partial update to apply on top of the base
+ * @returns the merged config with protected fields retained from `a`
  */ function mergeNotificationUserNotificationBoxRecipientConfigs(a, b) {
     var _b_f;
     return _object_spread_props$2(_object_spread$4({}, mergeNotificationBoxRecipients(a, b)), {
@@ -14930,6 +15363,10 @@ function _unsupported_iterable_to_array$2(o, minLen) {
 }
 /**
  * Merges a partial update into a {@link NotificationBoxRecipient}, deeply merging the `c` (config record) field.
+ *
+ * @param a - base recipient to merge into
+ * @param b - partial recipient update to apply on top of the base
+ * @returns the merged recipient with deeply merged template config records
  */ function mergeNotificationBoxRecipients(a, b) {
     return _object_spread_props$2(_object_spread$4({}, a, b), {
         // configs should be merged/ovewritten
@@ -14939,6 +15376,9 @@ function _unsupported_iterable_to_array$2(o, minLen) {
 /**
  * Resolves a {@link NotificationBoxDocument} from a reference pair, loading by model key if no document is provided directly.
  *
+ * @param input - reference pair containing either a direct document or a model key to load from
+ * @param accessor - Firestore document accessor used to load the document by ID when needed
+ * @returns the resolved NotificationBoxDocument
  * @throws {Error} When neither a document nor a model key is provided.
  */ function loadNotificationBoxDocumentForReferencePair(input, accessor) {
     var inputNotificationBoxDocument = input.notificationBoxDocument, inputNotificationBoxRelatedModelKey = input.notificationBoxRelatedModelKey;
@@ -15082,11 +15522,17 @@ function _is_native_reflect_construct$2() {
 });
 /**
  * Returns the Firestore {@link CollectionReference} for {@link OidcEntry} documents.
+ *
+ * @param context - the Firestore context to use
+ * @returns the CollectionReference for OidcEntry documents
  */ function oidcEntryCollectionReference(context) {
     return context.collection(oidcEntryIdentity.collectionName);
 }
 /**
  * Creates an {@link OidcEntryFirestoreCollection} from the given configuration.
+ *
+ * @param config - the Firestore context and collection configuration
+ * @returns a configured OidcEntryFirestoreCollection
  */ function oidcEntryFirestoreCollection(config) {
     var firestoreContext = config.firestoreContext;
     return firestoreContext.firestoreCollection({
@@ -15102,6 +15548,9 @@ function _is_native_reflect_construct$2() {
 
 /**
  * Query for OidcEntry documents with a specific type.
+ *
+ * @param type - the OIDC entry type to filter by
+ * @returns Firestore query constraints for the given type
  */ function oidcEntriesWithTypeQuery(type) {
     return [
         where('type', '==', type)
@@ -15109,6 +15558,10 @@ function _is_native_reflect_construct$2() {
 }
 /**
  * Query for OidcEntry documents with a specific type and userCode.
+ *
+ * @param type - the OIDC entry type to filter by
+ * @param userCode - the user code to match
+ * @returns Firestore query constraints for the given type and userCode
  */ function oidcEntriesByUserCodeQuery(type, userCode) {
     return [
         where('type', '==', type),
@@ -15117,6 +15570,10 @@ function _is_native_reflect_construct$2() {
 }
 /**
  * Query for OidcEntry documents with a specific type and uid.
+ *
+ * @param type - the OIDC entry type to filter by
+ * @param uid - the Firebase user ID to match
+ * @returns Firestore query constraints for the given type and uid
  */ function oidcEntriesByUidQuery(type, uid) {
     return [
         where('type', '==', type),
@@ -15125,6 +15582,10 @@ function _is_native_reflect_construct$2() {
 }
 /**
  * Query for OidcEntry documents with a specific type and grantId.
+ *
+ * @param type - the OIDC entry type to filter by
+ * @param grantId - the grant ID to match
+ * @returns Firestore query constraints for the given type and grantId
  */ function oidcEntriesByGrantIdQuery(type, grantId) {
     return [
         where('type', '==', type),
@@ -15133,6 +15594,9 @@ function _is_native_reflect_construct$2() {
 }
 /**
  * Query for OidcEntry Client documents owned by a specific user.
+ *
+ * @param ownershipKey - the ownership key identifying the owner
+ * @returns Firestore query constraints for Client entries matching the ownership key
  */ function oidcClientEntriesByOwnerQuery(ownershipKey) {
     return [
         where('type', '==', 'Client'),
@@ -15460,6 +15924,10 @@ function _is_native_reflect_construct$1() {
 var storageFileIdentity = firestoreModelIdentity('storageFile', 'sf');
 /**
  * Creates a StorageFileGroupCreatedStorageFileKey from the input StorageFileGroupId and purpose.
+ *
+ * @param purpose - the purpose identifying the type of file within the group
+ * @param storageFileGroupId - the ID of the parent StorageFileGroup
+ * @returns a deterministic FirestoreCollectionModelKey for the storage file
  */ function storageFileGroupCreatedStorageFileKey(purpose, storageFileGroupId) {
     return firestoreModelKey(storageFileIdentity, "".concat(purpose, "_").concat(storageFileGroupId));
 }
@@ -15654,6 +16122,9 @@ var storageFileIdentity = firestoreModelIdentity('storageFile', 'sf');
  * ```ts
  * const colRef = storageFileCollectionReference(firestoreContext);
  * ```
+ *
+ * @param context - the Firestore context to use
+ * @returns the CollectionReference for StorageFile documents
  */ function storageFileCollectionReference(context) {
     return context.collection(storageFileIdentity.collectionName);
 }
@@ -15665,6 +16136,9 @@ var storageFileIdentity = firestoreModelIdentity('storageFile', 'sf');
  * const collection = storageFileFirestoreCollection(firestoreContext);
  * const doc = collection.documentAccessor().newDocument();
  * ```
+ *
+ * @param firestoreContext - the Firestore context to use
+ * @returns a configured StorageFileFirestoreCollection
  */ function storageFileFirestoreCollection(firestoreContext) {
     return firestoreContext.firestoreCollection({
         modelIdentity: storageFileIdentity,
@@ -15757,6 +16231,9 @@ var storageFileIdentity = firestoreModelIdentity('storageFile', 'sf');
  * ```ts
  * const colRef = storageFileGroupCollectionReference(firestoreContext);
  * ```
+ *
+ * @param context - the Firestore context to use
+ * @returns the CollectionReference for StorageFileGroup documents
  */ function storageFileGroupCollectionReference(context) {
     return context.collection(storageFileGroupIdentity.collectionName);
 }
@@ -15768,6 +16245,9 @@ var storageFileIdentity = firestoreModelIdentity('storageFile', 'sf');
  * const collection = storageFileGroupFirestoreCollection(firestoreContext);
  * const doc = collection.documentAccessor().loadDocumentForId(groupId);
  * ```
+ *
+ * @param firestoreContext - the Firestore context to use
+ * @returns a configured StorageFileGroupFirestoreCollection
  */ function storageFileGroupFirestoreCollection(firestoreContext) {
     return firestoreContext.firestoreCollection({
         modelIdentity: storageFileGroupIdentity,
@@ -15963,6 +16443,7 @@ function _ts_generator$2(thisArg, body) {
  * initial state setup.
  *
  * @param config - optional defaults for creation type, subgroup, and processing state
+ * @returns a factory function that creates StorageFile document pairs
  * @throws {Error} When neither accessor nor context is provided
  * @throws {Error} When no storage path can be resolved from the input
  * @throws {Error} When FOR_STORAGE_FILE_GROUP is used without parentStorageFileGroup or purpose
@@ -16060,6 +16541,9 @@ function _ts_generator$2(thisArg, body) {
  * Convenience function for creating a StorageFileDocumentPair.
  *
  * Calls createStorageFileDocumentPairFactory() with no arguments, then passes the input to the factory and returns the result.
+ *
+ * @param input - the creation input specifying the storage path, purpose, and context
+ * @returns a promise resolving to the created StorageFileDocument and StorageFile data
  */ function createStorageFileDocumentPair(input) {
     return _async_to_generator$2(function() {
         return _ts_generator$2(this, function(_state) {
@@ -16106,6 +16590,7 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  *
  * @param storageFileGroupId - the group's document ID
  * @param subPath - optional sub-paths to append
+ * @returns the folder path as a SlashPathFolder string
  *
  * @example
  * ```ts
@@ -16131,6 +16616,9 @@ function _unsupported_iterable_to_array$1(o, minLen) {
 /**
  * Returns the full storage path for a StorageFileGroup's zip file.
  *
+ * @param storageFileGroupId - the group's document ID
+ * @returns the full SlashPath to the group's zip archive
+ *
  * @example
  * ```ts
  * const zipPath = storageFileGroupZipFileStoragePath('abc123');
@@ -16168,6 +16656,8 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * const constraints = storageFilesQueuedForProcessingQuery();
  * const results = await collection.query(constraints);
  * ```
+ *
+ * @returns Firestore query constraints for StorageFiles queued for processing
  */ function storageFilesQueuedForProcessingQuery() {
     return [
         where('ps', '==', exports.StorageFileProcessingState.QUEUED_FOR_PROCESSING)
@@ -16179,6 +16669,7 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * Used by the cleanup service to find files ready for permanent deletion.
  *
  * @param now - reference time for comparison; defaults to current time
+ * @returns Firestore query constraints for StorageFiles whose scheduled delete date has passed
  *
  * @example
  * ```ts
@@ -16194,6 +16685,10 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * with optional subgroup filtering.
  *
  * @example
+ * @param input - the user, purpose, and optional subgroup to filter by
+ * @returns Firestore query constraints for the given purpose and user
+ *
+ * @example
  * ```ts
  * const constraints = storageFilePurposeAndUserQuery({
  *   user: 'user123',
@@ -16216,6 +16711,9 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * Used by the sync service to find files whose group memberships need to be propagated.
  *
  * @example
+ * @returns Firestore query constraints for StorageFiles flagged for group synchronization
+ *
+ * @example
  * ```ts
  * const constraints = storageFileFlaggedForSyncWithGroupsQuery();
  * ```
@@ -16231,6 +16729,9 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * Used by the initialization service to find newly-created groups that haven't been synced yet.
  *
  * @example
+ * @returns Firestore query constraints for StorageFileGroups needing initialization
+ *
+ * @example
  * ```ts
  * const constraints = storageFileGroupsFlaggedForNeedsInitializationQuery();
  * ```
@@ -16243,6 +16744,9 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * Returns query constraints for StorageFileGroups flagged for content regeneration (`re == true`).
  *
  * @example
+ * @returns Firestore query constraints for StorageFileGroups flagged for content regeneration
+ *
+ * @example
  * ```ts
  * const constraints = storageFileGroupsFlaggedForContentRegenerationQuery();
  * ```
@@ -16257,6 +16761,9 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * Invalid groups are typically cleaned up (deleted along with their associated files).
  *
  * @example
+ * @returns Firestore query constraints for StorageFileGroups flagged as invalid
+ *
+ * @example
  * ```ts
  * const constraints = storageFileGroupsFlaggedInvalidQuery();
  * ```
@@ -16279,6 +16786,7 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * The created task is unique per StorageFile (only one processing task at a time).
  *
  * @param input - the target StorageFileDocument and optional subtask data
+ * @returns a CreateNotificationTaskTemplate for the StorageFile processing task
  *
  * @example
  * ```ts
@@ -16523,6 +17031,7 @@ function _ts_generator$1(thisArg, body) {
  * Use this within a permission service to define role-based access for StorageFile operations.
  *
  * @param config - the permission output, auth context, and target document
+ * @returns a function that accepts role configuration and returns a GrantRolesOtherwiseFunction
  *
  * @example
  * ```ts
@@ -16533,7 +17042,7 @@ function _ts_generator$1(thisArg, body) {
  * });
  * ```
  */ function grantStorageFileRolesForUserAuthFunction(config) {
-    var output = config.output, context = config.context; config.model;
+    var output = config.output, context = config.context;
     return function(input) {
         var rolesForStorageFileUser = input.rolesForStorageFileUser, rolesForStorageFileOwnershipKey = input.rolesForStorageFileOwnershipKey;
         var result = function result() {
@@ -16612,6 +17121,8 @@ function _object_spread$1(target) {
  *
  * Should only be used server-side, as `copy` may not be available on the client.
  *
+ * @returns a factory function that wraps FirebaseStorageAccessorFile instances into StoredFileReader accessors
+ *
  * @example
  * ```ts
  * const factory = storedFileReaderFactory();
@@ -16639,7 +17150,8 @@ function _object_spread$1(target) {
             loadFileStream: file.getStream,
             loadFileMetadata: loadFileMetadata,
             loadCustomMetadata: loadCustomMetadata,
-            copy: file.copy // copy is always available on the server-side
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- copy is always available on the server-side
+            copy: file.copy
         };
         return accessor;
     };
@@ -16665,6 +17177,7 @@ function _object_spread$1(target) {
  * Creates a {@link UserUploadsFolderSlashPathFactory} that generates per-user upload folder paths.
  *
  * @param inputBasePath - optional custom base path; defaults to {@link ALL_USER_UPLOADS_FOLDER_PATH}
+ * @returns a factory function that generates per-user upload folder slash paths
  *
  * @example
  * ```ts
@@ -16681,6 +17194,11 @@ function _object_spread$1(target) {
 /**
  * Creates a {@link UserUploadsFolderStoragePathFactory} that includes the storage bucket ID.
  *
+ * @param root0 - the configuration object
+ * @param root0.bucketId - the storage bucket ID to include in each generated path
+ * @param root0.basePath - optional custom base path; defaults to {@link ALL_USER_UPLOADS_FOLDER_PATH}
+ * @returns a factory function that generates per-user StoragePath values including the bucket ID
+ *
  * @example
  * ```ts
  * const factory = userUploadsFolderStoragePathFactory({ bucketId: 'my-bucket' });
@@ -16915,6 +17433,7 @@ function _ts_generator(thisArg, body) {
  * (e.g., `image` matches `image.png`, `image-test.jpg`) at {@link HIGH_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL}.
  *
  * @param config - file type, match string, and optional determination levels
+ * @returns an UploadedFileTypeDeterminer that classifies by file name
  *
  * @example
  * ```ts
@@ -16964,6 +17483,7 @@ function _ts_generator(thisArg, body) {
  * exactly equals the configured match string.
  *
  * @param config - file type and folder name to match
+ * @returns an UploadedFileTypeDeterminer that classifies by folder name
  *
  * @example
  * ```ts
@@ -17003,6 +17523,7 @@ function _ts_generator(thisArg, body) {
  * built-in determiners.
  *
  * @param config - file type, path match config, optional bucket/file filters
+ * @returns an UploadedFileTypeDeterminer that classifies by storage path
  *
  * @example
  * ```ts
@@ -17049,6 +17570,7 @@ function _ts_generator(thisArg, body) {
  * If `requireUser` is true, the determination fails when no user can be detected.
  *
  * @param config - root folder, user prefix, and matching options
+ * @returns a wrapper function that adds user detection to any UploadedFileTypeDeterminer
  *
  * @example
  * ```ts
@@ -17060,8 +17582,7 @@ function _ts_generator(thisArg, body) {
  * ```
  */ function determineUserByFolderWrapperFunction(config) {
     var _config_matchSubPath;
-    var rootFolder = config.rootFolder, userFolderPrefix = config.userFolderPrefix, _config_requireUser = config.requireUser, requireUser = _config_requireUser === void 0 ? false : _config_requireUser, tmp = config.allowSubPaths, inputAllowSubPaths = tmp === void 0 ? true : tmp;
-    var allowSubPaths = inputAllowSubPaths !== null && inputAllowSubPaths !== void 0 ? inputAllowSubPaths : true;
+    var rootFolder = config.rootFolder, userFolderPrefix = config.userFolderPrefix, _config_requireUser = config.requireUser, requireUser = _config_requireUser === void 0 ? false : _config_requireUser, _config_allowSubPaths = config.allowSubPaths, allowSubPaths = _config_allowSubPaths === void 0 ? true : _config_allowSubPaths;
     var subPathMatcherConfig = (_config_matchSubPath = config.matchSubPath) !== null && _config_matchSubPath !== void 0 ? _config_matchSubPath : {
         basePath: util.mergeSlashPaths([
             rootFolder,
@@ -17123,6 +17644,9 @@ function _ts_generator(thisArg, body) {
 /**
  * Convenience wrapper pre-configured for the standard uploads folder structure (`uploads/u/{userId}/...`).
  *
+ * @param config - optional matching options (rootFolder and userFolderPrefix are pre-configured)
+ * @returns a wrapper function that adds user detection for the standard uploads folder structure
+ *
  * @example
  * ```ts
  * const addUser = determineUserByUserUploadsFolderWrapperFunction();
@@ -17149,6 +17673,7 @@ function _ts_generator(thisArg, body) {
  *
  * @param determiner - the determiner to filter
  * @param types - allowed file type identifier(s)
+ * @returns an UploadedFileTypeDeterminer that only returns results for the specified file types
  *
  * @example
  * ```ts
@@ -17192,6 +17717,7 @@ function _ts_generator(thisArg, body) {
  * short-circuited via `completeSearchOnFirstMatch` or `completeSearchAtLevel`.
  *
  * @param config - determiners to combine and optional early-exit settings
+ * @returns a combined UploadedFileTypeDeterminer that returns the highest-confidence match
  *
  * @example
  * ```ts
@@ -17206,9 +17732,9 @@ function _ts_generator(thisArg, body) {
     if (determiners.length === 1) {
         result = determiners[0];
     } else {
-        var possibleFileTypes = util.unique(determiners.map(function(d) {
+        var possibleFileTypes = util.unique(determiners.flatMap(function(d) {
             return d.getPossibleFileTypes();
-        }).flat());
+        }));
         var completeSearchOnFirstMatch = Boolean(inputCompleteSearchOnFirstMatch);
         var completeSearchAtLevel = completeSearchOnFirstMatch ? LOW_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL : inputCompleteSearchAtLevel !== null && inputCompleteSearchAtLevel !== void 0 ? inputCompleteSearchAtLevel : EXACT_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL;
         result = {
@@ -17308,6 +17834,9 @@ function _ts_generator(thisArg, body) {
  * If a document is provided directly, it is returned as-is. Otherwise, the related model key
  * is converted to a group ID via {@link storageFileGroupIdForModel} and loaded from the accessor.
  *
+ * @param input - reference pair containing either a document or a related model key
+ * @param accessor - document accessor used to load the group document by ID
+ * @returns the resolved StorageFileGroupDocument
  * @throws {Error} When neither storageFileGroupDocument nor storageFileGroupRelatedModelKey is provided
  *
  * @example
@@ -17371,7 +17900,7 @@ function _ts_generator(thisArg, body) {
             ]);
         }
     });
-    var re = currentRe || oneOrMoreItemsWereRemoved; // flag removed if any items were removed
+    var re = currentRe !== null && currentRe !== void 0 ? currentRe : oneOrMoreItemsWereRemoved; // flag removed if any items were removed
     // recalculate re if it is false or the retain flag is false
     if (!re || allowRecalculateRegenerateFlag) {
         var flagRegenerate = calculateStorageFileGroupRegeneration({
@@ -17397,6 +17926,7 @@ function _ts_generator(thisArg, body) {
  * - Any embedded file has never been included in the zip (`zat` is unset on the entry)
  *
  * @param input - group state and optional force flag
+ * @returns the regeneration result indicating whether the zip or other derived files need to be regenerated
  *
  * @example
  * ```ts
@@ -17564,6 +18094,9 @@ function _is_native_reflect_construct() {
  * ```ts
  * const colRef = systemStateCollectionReference(firestoreContext);
  * ```
+ *
+ * @param context - the Firestore context to use
+ * @returns the CollectionReference for SystemState documents
  */ function systemStateCollectionReference(context) {
     return context.collection(systemStateIdentity.collectionName);
 }
@@ -17576,6 +18109,7 @@ function _is_native_reflect_construct() {
  *
  * @param firestoreContext - the Firestore context
  * @param converters - map of type identifiers to their data field converters
+ * @returns a configured SystemStateFirestoreCollection with per-type data converters
  *
  * @example
  * ```ts
@@ -17641,13 +18175,16 @@ exports.DEFAULT_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL = DEFAULT_UPLOADED_FILE_T
 exports.DEFAULT_WEBSITE_LINK = DEFAULT_WEBSITE_LINK;
 exports.EMPTY_STORAGE_FILE_PURPOSE_SUBGROUP = EMPTY_STORAGE_FILE_PURPOSE_SUBGROUP;
 exports.EXACT_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL = EXACT_UPLOADED_FILE_TYPE_DETERMINATION_LEVEL;
+exports.FIREBASE_AUTH_CREDENTIAL_ALREADY_IN_USE_ERROR = FIREBASE_AUTH_CREDENTIAL_ALREADY_IN_USE_ERROR;
 exports.FIREBASE_AUTH_EMAIL_ALREADY_EXISTS_ERROR = FIREBASE_AUTH_EMAIL_ALREADY_EXISTS_ERROR;
+exports.FIREBASE_AUTH_EMAIL_ALREADY_IN_USE_ERROR = FIREBASE_AUTH_EMAIL_ALREADY_IN_USE_ERROR;
 exports.FIREBASE_AUTH_INVALID_PHONE_NUMBER_ERROR = FIREBASE_AUTH_INVALID_PHONE_NUMBER_ERROR;
 exports.FIREBASE_AUTH_NETWORK_REQUEST_ERROR = FIREBASE_AUTH_NETWORK_REQUEST_ERROR;
 exports.FIREBASE_AUTH_NETWORK_REQUEST_FAILED = FIREBASE_AUTH_NETWORK_REQUEST_FAILED;
 exports.FIREBASE_AUTH_PASSWORD_MAX_LENGTH = FIREBASE_AUTH_PASSWORD_MAX_LENGTH;
 exports.FIREBASE_AUTH_PASSWORD_MIN_LENGTH = FIREBASE_AUTH_PASSWORD_MIN_LENGTH;
 exports.FIREBASE_AUTH_PHONE_NUMBER_ALREADY_EXISTS_ERROR = FIREBASE_AUTH_PHONE_NUMBER_ALREADY_EXISTS_ERROR;
+exports.FIREBASE_AUTH_PROVIDER_ALREADY_LINKED_ERROR = FIREBASE_AUTH_PROVIDER_ALREADY_LINKED_ERROR;
 exports.FIREBASE_AUTH_USER_NOT_FOUND_ERROR = FIREBASE_AUTH_USER_NOT_FOUND_ERROR;
 exports.FIREBASE_AUTH_WRONG_PASSWORD = FIREBASE_AUTH_WRONG_PASSWORD;
 exports.FIREBASE_DEVELOPMENT_FUNCTIONS_MAP_KEY = FIREBASE_DEVELOPMENT_FUNCTIONS_MAP_KEY;