@dereekb/firebase 13.4.1 → 13.4.2

package/index.esm.js

@@ -439,13 +439,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);
@@ -454,12 +456,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',
@@ -474,6 +480,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();
 }
@@ -711,9 +719,15 @@ function _ts_generator$k(thisArg, body) {
  * - BATCH: Operations within a Firestore write batch (atomic writes only, no reads)
  */ var FirestoreDocumentContextType;
 (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";
 })(FirestoreDocumentContextType || (FirestoreDocumentContextType = {}));
 
 function asyncGeneratorStep$j(gen, resolve, reject, _next, _throw, key, arg) {
@@ -1210,7 +1224,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);
@@ -1220,8 +1235,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);
@@ -1230,6 +1246,7 @@ function _is_native_reflect_construct$8() {
         {
             /**
      * Retrieves a DocumentSnapshot of the document.
+     *
      * @returns
      */ key: "snapshot",
             value: function snapshot() {
@@ -1239,6 +1256,7 @@ function _is_native_reflect_construct$8() {
         {
             /**
      * Retrieves the data of the DocumentSnapshot of the document.
+     *
      * @param options
      * @returns
      */ key: "snapshotData",
@@ -1278,8 +1296,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);
@@ -1289,7 +1308,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);
@@ -1299,7 +1319,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);
@@ -1308,7 +1329,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) {
@@ -1319,9 +1345,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);
@@ -1359,7 +1382,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) {
@@ -1423,7 +1454,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 {
@@ -1445,10 +1481,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;
@@ -1927,8 +1968,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) {
@@ -2445,12 +2485,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);
         }
@@ -2576,7 +2624,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 : passThrough;
@@ -2624,8 +2672,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;
                 }
@@ -2957,8 +3004,7 @@ function optionalFirestoreField(config) {
     }
     var inputFilterUnique = (config === null || config === void 0 ? void 0 : config.filterUnique) === true ? 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 = isMapIdentityFunction(sortFn) ? undefined : function(x) {
@@ -3048,7 +3094,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: unique
     }));
@@ -3166,6 +3213,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: KeyValueTypleValueFilter.EMPTY
@@ -3200,13 +3249,11 @@ function optionalFirestoreField(config) {
         },
         fromData: function fromData(input) {
             var copy = copyObject(input);
-            var result = mapObjectMap(copy, decoder);
-            return result;
+            return mapObjectMap(copy, decoder);
         },
         toData: function toData(input) {
             var encodedMap = mapObjectMap(input, encoder);
-            var result = filterFinalMapValuesFn(encodedMap);
-            return result;
+            return filterFinalMapValuesFn(encodedMap);
         }
     });
 }
@@ -3232,6 +3279,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
@@ -3257,6 +3307,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: filterEmptyArrayValues
@@ -3272,6 +3324,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 = modelFieldMapFunctions(config);
     return {
@@ -3322,8 +3377,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 = filterNullAndUndefinedValues(base);
-        return nullishfilteredOut;
+        return filterNullAndUndefinedValues(base);
     };
     return firestoreField({
         default: (_config_default = config.default) !== null && _config_default !== void 0 ? _config_default : function() {
@@ -3376,7 +3430,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 = build({
+    return build({
         base: firestoreField({
             default: (_config_default = config.default) !== null && _config_default !== void 0 ? _config_default : defaultWithFields,
             defaultBeforeSave: defaultBeforeSave,
@@ -3387,7 +3441,6 @@ function optionalFirestoreField(config) {
             x.mapFunctions = mapFunctions;
         }
     });
-    return mapFunctionsConfig;
 }
 /**
  * Creates a field mapping configuration for Firestore latitude/longitude string fields.
@@ -3417,7 +3470,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({
@@ -3438,8 +3494,7 @@ var assignWebsiteLinkFunction = assignValuesToPOJOFunction({
     valueFilter: 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.
@@ -3455,7 +3510,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()
     });
@@ -3473,8 +3532,7 @@ var assignWebsiteFileLinkFunction = assignValuesToPOJOFunction({
     valueFilter: 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.
@@ -3492,6 +3550,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()
@@ -3499,6 +3559,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: {
@@ -3537,7 +3599,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 ? sortAscendingIndexNumberRefFunction() : undefined,
@@ -3557,8 +3624,7 @@ var assignDateCellScheduleFunction = assignValuesToPOJOFunction({
     valueFilter: 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.
@@ -3592,6 +3658,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);
 };
@@ -3729,37 +3798,37 @@ function firebaseQueryItemAccumulator(iteration, mapItem) {
     var mapFn = function mapFn(x) {
         var result = 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.
@@ -4058,7 +4127,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;
@@ -4075,7 +4144,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.
@@ -4120,11 +4188,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 = asArray(replaceFn(separated.excluded));
-        return replacements ? pushItemOrArrayItemsIntoArray(separated.included, replacements) : separated.included;
+        return pushItemOrArrayItemsIntoArray(separated.included, replacements);
     };
 }
 /**
@@ -4149,10 +4217,9 @@ function orderBy(fieldPath, directionStr) {
     }
     return function(constraints) {
         var typesToFilterOut = new Set(types);
-        var separated = separateValues(constraints, function(x) {
+        return separateValues(constraints, function(x) {
             return !typesToFilterOut.has(x.type);
         });
-        return separated;
     };
 }
 
@@ -4307,13 +4374,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) {
@@ -4328,10 +4395,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) {
@@ -4368,16 +4435,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.
@@ -4440,13 +4507,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;
@@ -4675,7 +4742,7 @@ function _firestoreItemPageIterationWithSnapshotIteration(snapshotIteration) {
                             return snapshot;
                         });
                     };
-                    var resultPromise = _loadFakeQuerySnapshot().then(function(snapshot) {
+                    return _loadFakeQuerySnapshot().then(function(snapshot) {
                         var result = {
                             value: {
                                 time: time,
@@ -4684,7 +4751,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 of(snapshot);
                                 }
@@ -4693,7 +4760,6 @@ function _firestoreItemPageIterationWithSnapshotIteration(snapshotIteration) {
                         };
                         return result;
                     });
-                    return resultPromise;
                 }
             }));
         }
@@ -4703,13 +4769,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 {
@@ -4740,22 +4806,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, _ = {
@@ -4893,7 +4959,7 @@ function _ts_generator$g(thisArg, body) {
         var allConstraints = 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() {
@@ -4915,7 +4981,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)
@@ -5019,7 +5085,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;
@@ -5131,15 +5197,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, _ = {
@@ -5329,27 +5395,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,
-                                            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,
+                                    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
+                                    ))
+                                ];
                             });
                         })();
                     }
@@ -5464,14 +5520,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
                                         ] : batch(docSnapshots, batchSizeForSnapshotsResult);
@@ -5484,7 +5535,7 @@ function _ts_generator$f(thisArg, body) {
                                                 sequential: true
                                             }, performTasksConfig))
                                         ];
-                                    case 2:
+                                    case 1:
                                         performTasksResult = _state.sent();
                                         return [
                                             2,
@@ -5497,12 +5548,12 @@ function _ts_generator$f(thisArg, body) {
                                                 };
                                             })
                                         ];
-                                    case 3:
+                                    case 2:
                                         return [
                                             2,
                                             []
                                         ];
-                                    case 4:
+                                    case 3:
                                         return [
                                             2
                                         ];
@@ -5599,6 +5650,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;
@@ -6164,7 +6216,7 @@ function _ts_generator$e(thisArg, body) {
     }), shareReplay(1));
     var event$ = stream$.pipe(map(function(event) {
         var changes = event.docChanges();
-        var results = build({
+        return build({
             base: groupValues(changes, function(x) {
                 return x.type;
             }),
@@ -6178,7 +6230,6 @@ function _ts_generator$e(thisArg, body) {
                 x.type = iterationQueryDocChangeWatcherChangeTypeForGroup(x);
             }
         });
-        return results;
     }), shareReplay(1));
     return {
         stream$: stream$,
@@ -6217,13 +6268,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 {
@@ -6254,22 +6305,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, _ = {
@@ -6487,7 +6538,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)));
             }
         };
     };
@@ -6497,18 +6548,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) {
@@ -6523,10 +6574,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) {
@@ -6563,20 +6614,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.
@@ -6606,6 +6657,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
 }
 /**
  * Creates a FirestoreModelIdentityTypeMap from the input identities.
+ *
  * @param identities
  * @returns
  */ function firestoreModelIdentityTypeMap(identities) {
@@ -6649,8 +6701,7 @@ function firestoreModelIdentity(parentOrModelName, collectionNameOrModelName, in
     } else {
         key = input;
     }
-    var result = id ? id : lastValue(key.split(FIRESTORE_COLLECTION_NAME_SEPARATOR));
-    return result;
+    return id !== null && id !== void 0 ? id : lastValue(key.split(FIRESTORE_COLLECTION_NAME_SEPARATOR));
 }
 /**
  * Returns the array of ids within a FirestoreModelKey.
@@ -6686,7 +6737,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
@@ -6696,7 +6747,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);
 }
@@ -6720,14 +6772,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 stringContains(input, '/') ? FIRESTORE_MODEL_KEY_REGEX.test(input) : FIRESTORE_MODEL_ID_REGEX.test(input);
 }
@@ -6749,6 +6803,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);
@@ -6812,7 +6869,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) {
@@ -6824,22 +6886,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;
@@ -6849,11 +6933,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 (isOddNumber(pieces.length)) {
             throw new Error('input key source was a collection ref or unavailable.');
         }
@@ -6868,8 +6957,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;
@@ -6877,8 +6966,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);
@@ -6888,7 +6978,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;
@@ -6906,11 +7002,16 @@ function firestoreModelKeyParentKeyPartPairs(input) {
  */ function firestoreModelKeyTypePair(input) {
     return 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 (isOddNumber(pieces.length)) {
             throw new Error('input key source was a collection ref or unavailable.');
         }
@@ -6932,7 +7033,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.
@@ -6987,7 +7088,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;
@@ -7030,13 +7131,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 = build({
+    return build({
         base: makeFirestoreCollection(config),
         build: function build(x) {
             extendFirestoreCollectionWithSingleDocumentAccessor(x, config.singleItemIdentifier);
         }
     });
-    return collection;
 }
 
 function _define_property$o(obj, key, value) {
@@ -7187,23 +7287,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 = build({
+    return 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) {
@@ -7218,10 +7317,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) {
@@ -7258,16 +7357,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.
@@ -7283,11 +7382,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,
@@ -7315,7 +7413,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),
@@ -7527,9 +7625,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);
@@ -7537,7 +7636,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:
@@ -7548,13 +7647,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 = unique(keys, keysInResults);
+                            });
                             return [
                                 2,
-                                unusedKeys
+                                unique(keys, keysInResults)
                             ];
                     }
                 });
@@ -7576,6 +7674,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
@@ -7615,13 +7714,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) {
@@ -7636,10 +7735,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) {
@@ -7657,16 +7756,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
@@ -7687,15 +7786,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 = 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;
             });
@@ -7834,6 +7933,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>();
@@ -7854,6 +7955,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>();
@@ -8007,6 +8110,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
@@ -8052,6 +8156,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
@@ -8196,6 +8301,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
@@ -8242,6 +8348,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
@@ -8389,6 +8496,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();
@@ -8405,18 +8514,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,
-                                    runTransaction(firestore, fn)
-                                ];
-                            case 1:
-                                return [
-                                    2,
-                                    _state.sent()
-                                ];
-                        }
+                        return [
+                            2,
+                            runTransaction(firestore, fn)
+                        ];
                     });
                 })();
             };
@@ -8432,13 +8533,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) {
@@ -8453,10 +8554,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) {
@@ -8493,26 +8594,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;
@@ -8535,13 +8639,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, startAt$1(data.snapshot));
 }), _define_property$i(_obj, FIRESTORE_START_AT_VALUE_QUERY_CONSTRAINT_TYPE, function(builder, data) {
-    return addConstraintToBuilder(builder, startAt$1.apply(void 0, _to_consumable_array$4(data.fieldValues)));
+    return addConstraintToBuilder(builder, startAt$1.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, startAfter$1(data.snapshot));
 }), _define_property$i(_obj, FIRESTORE_END_AT_QUERY_CONSTRAINT_TYPE, function(builder, data) {
     return addConstraintToBuilder(builder, endAt$1(data.snapshot));
 }), _define_property$i(_obj, FIRESTORE_END_AT_VALUE_QUERY_CONSTRAINT_TYPE, function(builder, data) {
-    return addConstraintToBuilder(builder, endAt$1.apply(void 0, _to_consumable_array$4(data.fieldValues)));
+    return addConstraintToBuilder(builder, endAt$1.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, endBefore$1(data.snapshot));
 }), _obj);
@@ -8550,6 +8654,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,
@@ -8563,7 +8669,7 @@ var _obj;
             var initialQuery = param.query, constraints = param.constraints;
             return query.apply(void 0, [
                 initialQuery
-            ].concat(_to_consumable_array$4(constraints)));
+            ].concat(_to_consumable_array$6(constraints)));
         },
         documentIdFieldPath: function documentIdFieldPath() {
             return documentId();
@@ -8577,6 +8683,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();
@@ -8611,6 +8719,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();
@@ -8790,6 +8900,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({
@@ -9055,6 +9166,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
@@ -9077,6 +9189,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') {
@@ -9091,7 +9204,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.
  *
@@ -9099,6 +9212,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
@@ -9119,8 +9233,7 @@ function mapHttpsCallable(callable, wrap) {
             var fn = directDataHttpsCallable(httpsCallable(functionsInstance, key, httpCallableOptions));
             return fn;
         };
-        var result = mapObjectMap(configMap, mapFn);
-        return result;
+        return mapObjectMap(configMap, mapFn);
     };
 }
 /**
@@ -9130,6 +9243,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
@@ -9164,6 +9278,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
@@ -9196,10 +9311,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);
 }
 /**
@@ -9221,6 +9339,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
@@ -9236,13 +9355,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: 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;
@@ -9278,15 +9398,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
@@ -9309,6 +9429,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
@@ -9323,22 +9444,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 = 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(capitalizeFirstLetter(specifier));
+                var specifierFn = makeCallFunction(callFn, modelType, inputSpecifier);
+                var fullSpecifierName = "".concat(callFn.call).concat(modelTypeSuffix).concat(capitalizeFirstLetter(specifier));
                 specifiers[fullSpecifierName] = specifierFn;
-                var shortSpecifierName = lowercaseFirstLetter(specifier) || call;
+                var shortSpecifierName = lowercaseFirstLetter(specifier) || callFn.call;
                 specifiers[shortSpecifierName] = specifierFn;
             });
             return specifiers;
@@ -9347,7 +9468,7 @@ function _unsupported_iterable_to_array$6(o, minLen) {
         var _callFn = cachedGetter(function() {
             return httpsCallable(functionsInstance, CALL_MODEL_APP_FUNCTION_KEY);
         });
-        var result = build({
+        return build({
             base: functionMap,
             build: function build(x) {
                 Object.entries(crudConfigMap).forEach(function(param) {
@@ -9361,10 +9482,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;
@@ -9372,7 +9497,7 @@ function _unsupported_iterable_to_array$6(o, minLen) {
                     };
                     var modelTypeSuffix = capitalizeFirstLetter(modelType);
                     var _separateValues = 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) {
@@ -9403,7 +9528,6 @@ function _unsupported_iterable_to_array$6(o, minLen) {
                 });
             }
         });
-        return result;
     };
 }
 
@@ -9412,6 +9536,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
@@ -9437,6 +9562,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
@@ -9489,6 +9615,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
@@ -9505,6 +9632,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
@@ -9527,7 +9655,7 @@ function _class_call_check$c(instance, Constructor) {
         } else {
             return {
                 pathString: pathString,
-                bucketId: inputBucketId || bucketId
+                bucketId: inputBucketId !== null && inputBucketId !== void 0 ? inputBucketId : bucketId
             };
         }
     };
@@ -9539,6 +9667,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
@@ -9561,6 +9690,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
@@ -9604,13 +9734,27 @@ 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';
 /**
  * Converts a {@link FirebaseAuthError} into a user-friendly {@link ReadableError} with a human-readable message.
  *
@@ -9618,6 +9762,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
@@ -9721,6 +9866,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
@@ -9737,8 +9883,7 @@ function _define_property$f(obj, key, value) {
             } else {
                 documentAccessor = firestoreCollection.documentAccessor();
             }
-            var document = documentAccessor.loadDocumentForKey(key);
-            return document;
+            return documentAccessor.loadDocumentForKey(key);
         }
     };
 }
@@ -9746,17 +9891,17 @@ function _define_property$f(obj, key, value) {
 /**
  * ArkType schema for a FirestoreModelKey (full path like "collection/12345").
  */ var firestoreModelKeyType = 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 = 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 = 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');
 });
 
 /**
@@ -10065,6 +10210,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);
 }
@@ -10227,8 +10373,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));
             }
         },
         {
@@ -10236,8 +10381,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));
             }
         }
     ]);
@@ -10245,6 +10389,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);
@@ -10253,13 +10400,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;
@@ -10267,13 +10414,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) {
@@ -10409,6 +10554,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;
@@ -10418,6 +10566,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
@@ -10436,6 +10585,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);
 }
@@ -10445,6 +10595,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;
@@ -10460,6 +10611,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 = iterableToArray(authRoles);
     return function(context, rolesToGrantToMatch, otherwise) {
@@ -10518,6 +10670,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
@@ -10535,6 +10688,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) {
@@ -10549,6 +10703,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
@@ -10560,9 +10715,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] : noAccessRoleMap;
         return _async_to_generator$8(function() {
@@ -10661,6 +10813,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
@@ -10693,6 +10846,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 cachedGetter(function() {
         return firebaseModelService(config);
@@ -10705,6 +10859,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();
@@ -10774,8 +10929,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];
@@ -10796,6 +10951,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) {
@@ -10813,6 +10969,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);
@@ -10825,10 +10982,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;
@@ -10842,6 +11001,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) {
@@ -10868,6 +11028,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
@@ -11068,6 +11229,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
@@ -11078,25 +11240,16 @@ function _ts_generator$7(thisArg, body) {
     return 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
+                        })
+                    ];
                 });
             })();
         },
@@ -11110,7 +11263,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
@@ -11122,6 +11275,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 iterateFetchPagesByEachItem(_object_spread_props$9(_object_spread$b({}, input), {
@@ -11137,6 +11293,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 iterateFetchPages(_object_spread_props$9(_object_spread$b({}, input), {
@@ -11215,6 +11374,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;
@@ -11225,6 +11385,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.');
 }
@@ -11381,6 +11543,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
@@ -11418,15 +11581,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);
@@ -11439,12 +11603,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 = cachedGetter(function() {
             if (!hasNext) {
                 throw storageListFilesResultHasNoNextError();
             }
-            return delegate.next(storage, options, folder, result);
+            return delegate.next(input, result);
         });
         var files = cachedGetter(function() {
             return delegate.filesFromResult(result, folder).map(fileResult);
@@ -11472,6 +11637,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.');
 }
@@ -11483,6 +11650,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
@@ -11493,9 +11661,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.');
         }
@@ -11520,13 +11689,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 {
@@ -11570,10 +11739,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) {
@@ -11610,16 +11779,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, _ = {
@@ -11727,6 +11896,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
@@ -11746,6 +11916,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, path) {
     return ref(storage, firebaseStorageFilePathFromStorageFilePath(path));
 }
@@ -11755,6 +11926,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 getMetadata(ref).then(function(_) {
         return true;
@@ -11770,6 +11942,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
@@ -11786,7 +11959,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: 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: filterUndefinedValues(_object_spread$a({}, (_options_metadata5 = options.metadata) === null || _options_metadata5 === void 0 ? void 0 : _options_metadata5.customMetadata, options.customMetadata))
         });
     }
     function uploadMetadataFromStorageUploadOptions(options) {
@@ -11915,7 +12088,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
         }));
@@ -11957,6 +12131,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
@@ -11985,7 +12160,11 @@ function _ts_generator$5(thisArg, body) {
                             return [
                                 4,
                                 list(ref, options).then(function(listResult) {
-                                    return firebaseStorageClientListFilesResultFactory(storage, folder, options, {
+                                    return firebaseStorageClientListFilesResultFactory({
+                                        storage: storage,
+                                        folder: folder,
+                                        options: options
+                                    }, {
                                         options: options,
                                         listResult: listResult
                                     });
@@ -12012,7 +12191,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;
@@ -12048,6 +12227,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();
@@ -12075,6 +12256,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();
@@ -12133,6 +12316,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
@@ -12156,9 +12340,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
 }
@@ -12213,6 +12397,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(
@@ -12237,6 +12425,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 });
@@ -12256,6 +12447,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 = updateMaybeValue(a.uid, inputUid);
@@ -12307,6 +12502,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: {},
@@ -12316,6 +12512,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({}, mergeObjects([
@@ -12346,6 +12546,10 @@ function _object_spread_props$7(target, source) {
 })(NotificationBoxRecipientTemplateConfigBoolean || (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 = mergeObjectsFunction(KeyValueTypleValueFilter.UNDEFINED);
     return mergeConfigs([
@@ -12407,6 +12611,8 @@ var notificationBoxRecipientTemplateConfigDencoder = 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
@@ -12496,6 +12702,9 @@ var notificationBoxRecipientTemplateConfigDencoder = 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 } });
@@ -12514,6 +12723,9 @@ var notificationBoxRecipientTemplateConfigDencoder = 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) {
@@ -12556,6 +12768,7 @@ var notificationBoxRecipientTemplateConfigDencoder = 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
@@ -12699,11 +12912,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,
@@ -12766,11 +12985,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,
@@ -12833,11 +13058,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,
@@ -13005,6 +13236,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);
@@ -13012,6 +13246,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) {
@@ -13029,11 +13266,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,
@@ -13082,6 +13325,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);
@@ -13089,6 +13335,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) {
@@ -13106,11 +13355,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,
@@ -13255,16 +13510,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, {
@@ -13278,6 +13559,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] : {};
@@ -13312,6 +13599,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`.
@@ -13319,31 +13617,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 = 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 = ModelRelationUtility.removeKeysFromCollection(updatedC, b.filter(function(x) {
-            return x.remove;
-        }).map(function(x) {
-            return x.type;
-        }), function(x) {
+    var cArray = notificationBoxRecipientTemplateConfigRecordToArray(a);
+    var updatedC = 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 = filterKeysOnPOJOFunction(limitToAllowedConfigTypes)(c);
+        },
+        merge: function merge(x, y) {
+            return _object_spread$8({}, x, y);
         }
+    });
+    // remove types marked as remove
+    updatedC = 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 = filterKeysOnPOJOFunction(limitToAllowedConfigTypes)(c);
     }
     return c;
 }
@@ -13354,6 +13650,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;
@@ -13370,6 +13667,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;
@@ -13400,6 +13702,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 = makeModelMap(a, function(x) {
         return x.nb;
@@ -13429,7 +13736,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;
 }
@@ -13568,6 +13875,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
@@ -13614,6 +13924,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 : MS_IN_HOUR;
@@ -13627,6 +13940,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) {
@@ -13635,15 +13950,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.');
@@ -13724,6 +14037,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;
@@ -13774,6 +14091,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;
@@ -13790,6 +14110,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;
@@ -13868,6 +14191,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
@@ -13905,11 +14230,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;
@@ -13937,9 +14268,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);
@@ -13951,6 +14288,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
@@ -13987,6 +14326,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
@@ -14021,10 +14361,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,
@@ -14033,7 +14373,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,
@@ -14237,6 +14577,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
@@ -14264,6 +14605,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();
@@ -14272,7 +14615,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;
@@ -14307,6 +14650,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)
@@ -14316,6 +14661,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)
@@ -14324,6 +14670,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)
@@ -14333,6 +14681,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)
@@ -14342,6 +14692,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)
@@ -14355,6 +14707,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 [
@@ -14365,6 +14718,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)
@@ -14401,6 +14756,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);
@@ -14467,6 +14826,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
@@ -14482,6 +14843,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
@@ -14503,6 +14865,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
@@ -14519,6 +14882,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
@@ -14538,6 +14902,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
@@ -14559,6 +14924,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), {
@@ -14632,6 +14998,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'
@@ -14643,6 +15011,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
@@ -14735,6 +15106,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;
@@ -14766,6 +15140,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;
@@ -14803,6 +15180,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;
@@ -14830,6 +15210,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;
@@ -14838,11 +15221,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;
@@ -14851,12 +15237,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){
@@ -14866,7 +15258,11 @@ function _unsupported_iterable_to_array$2(o, minLen) {
         case NotificationSendState.SKIPPED:
             isComplete = true;
             break;
-        default:
+        case NotificationSendState.QUEUED:
+        case NotificationSendState.SENT_PARTIAL:
+        case NotificationSendState.SEND_ERROR:
+        case NotificationSendState.BUILD_ERROR:
+        case NotificationSendState.CONFIG_ERROR:
             isComplete = false;
             break;
     }
@@ -14874,6 +15270,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;
@@ -14907,6 +15306,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;
 }
@@ -14914,6 +15316,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)), {
@@ -14928,6 +15334,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
@@ -14937,6 +15347,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;
@@ -15080,11 +15493,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({
@@ -15100,6 +15519,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)
@@ -15107,6 +15529,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),
@@ -15115,6 +15541,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),
@@ -15123,6 +15553,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),
@@ -15131,6 +15565,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'),
@@ -15458,6 +15895,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));
 }
@@ -15652,6 +16093,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);
 }
@@ -15663,6 +16107,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,
@@ -15755,6 +16202,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);
 }
@@ -15766,6 +16216,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,
@@ -15961,6 +16414,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
@@ -16058,6 +16512,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) {
@@ -16104,6 +16561,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
@@ -16129,6 +16587,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');
@@ -16166,6 +16627,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', '==', StorageFileProcessingState.QUEUED_FOR_PROCESSING)
@@ -16177,6 +16640,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
@@ -16192,6 +16656,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',
@@ -16214,6 +16682,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();
  * ```
@@ -16229,6 +16700,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();
  * ```
@@ -16241,6 +16715,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();
  * ```
@@ -16255,6 +16732,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();
  * ```
@@ -16277,6 +16757,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
@@ -16521,6 +17002,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
@@ -16531,7 +17013,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() {
@@ -16610,6 +17092,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();
@@ -16637,7 +17121,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;
     };
@@ -16663,6 +17148,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
@@ -16679,6 +17165,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' });
@@ -16913,6 +17404,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
@@ -16962,6 +17454,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
@@ -17001,6 +17494,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
@@ -17047,6 +17541,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
@@ -17058,8 +17553,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: mergeSlashPaths([
             rootFolder,
@@ -17121,6 +17615,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();
@@ -17147,6 +17644,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
@@ -17190,6 +17688,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
@@ -17204,9 +17703,9 @@ function _ts_generator(thisArg, body) {
     if (determiners.length === 1) {
         result = determiners[0];
     } else {
-        var possibleFileTypes = unique(determiners.map(function(d) {
+        var possibleFileTypes = 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 = {
@@ -17306,6 +17805,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
@@ -17369,7 +17871,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({
@@ -17395,6 +17897,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
@@ -17562,6 +18065,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);
 }
@@ -17574,6 +18080,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