@dereekb/firebase-server 13.11.14 → 13.11.15

package/index.cjs.js

@@ -580,7 +580,7 @@ function _ts_generator$h(thisArg, body) {
  *
  * Any error other than {@link FIREBASE_AUTH_USER_NOT_FOUND_ERROR} is re-thrown.
  *
- * @param promise - A promise resolving to a UserRecord (e.g., from `auth.getUser(uid)`).
+ * @param promise - Promise resolving to a UserRecord (e.g., from `auth.getUser(uid)`).
  * @returns The user record, or `undefined` if the user does not exist.
  *
  * @example
@@ -592,7 +592,7 @@ function _ts_generator$h(thisArg, body) {
  * ```
  */ function getAuthUserOrUndefined(promise) {
     return _async_to_generator$h(function() {
-        var error;
+        var result, error;
         return _ts_generator$h(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -607,22 +607,24 @@ function _ts_generator$h(thisArg, body) {
                         promise
                     ];
                 case 1:
+                    result = _state.sent();
                     return [
-                        2,
-                        _state.sent()
+                        3,
+                        3
                     ];
                 case 2:
                     error = _state.sent();
-                    if (error.code === firebase.FIREBASE_AUTH_USER_NOT_FOUND_ERROR) {
-                        return [
-                            2,
-                            undefined
-                        ];
+                    if (error.code !== firebase.FIREBASE_AUTH_USER_NOT_FOUND_ERROR) {
+                        throw error;
                     }
-                    throw error;
+                    return [
+                        3,
+                        3
+                    ];
                 case 3:
                     return [
-                        2
+                        2,
+                        result
                     ];
             }
         });
@@ -1486,7 +1488,7 @@ function _ts_generator$g(thisArg, body) {
             key: "setClaims",
             value: function setClaims(claims) {
                 var _this = this;
-                return this.service.auth.setCustomUserClaims(this.uid, claims).then(function() {
+                return this.service.auth.setCustomUserClaims(this.uid, claims !== null && claims !== void 0 ? claims : null).then(function() {
                     _this._loadRecord.reset(); // reset the cache
                 });
             }
@@ -1987,7 +1989,7 @@ function _ts_generator$g(thisArg, body) {
      *
      * @param input - The initialization configuration for the new user.
      * @returns The created user record and the setup password used.
-     * @throws Throws if the Firebase Admin SDK rejects the user creation.
+     * @throws {Error} Throws if the Firebase Admin SDK rejects the user creation.
      */ function createNewUser(input) {
                 return _async_to_generator$g(function() {
                     var uid, displayName, email, phoneNumber, inputPassword, password, user, e, firebaseError, errorCode;
@@ -3149,15 +3151,16 @@ function _ts_generator$e(thisArg, body) {
  * Use this when the NestJS app needs the config accessible via either token.
  *
  * @param env - The Firebase server environment configuration.
- * @returns An array of providers binding the config to both Firebase and base server env tokens.
+ * @returns The providers binding the config to both Firebase and base server env tokens.
  *
- * @example
- * ```typescript
- * @Module({
+ * @Module ({
  *   providers: [...firebaseServerEnvTokenProviders(myEnvConfig)]
  * })
  * export class AppModule {}
  * ```
+ *
+ * @example
+ * ```typescript
  */ function firebaseServerEnvTokenProviders(env) {
     return [
         firebaseServerEnvTokenProvider(env),
@@ -4004,7 +4007,7 @@ function _ts_generator$d(thisArg, body) {
  * @param path - The initial collection path.
  * @param pathSegments - Optional pairs of [docId, collectionName] for subcollection traversal.
  * @returns The resolved {@link CollectionReference} at the given path.
- * @throws Error if pathSegments length is odd (segments must come in pairs).
+ * @throws {Error} If pathSegments length is odd (segments must come in pairs).
  *
  * @example
  * ```typescript
@@ -4319,6 +4322,11 @@ var _obj;
  * The encryption key is resolved from the configured secret source on each read/write,
  * allowing for key rotation via environment variable changes.
  *
+ * @param config - Encryption field configuration.
+ * @returns A field mapping configuration for encrypted values.
+ *
+ * @template T - The JSON-serializable value type.
+ *
  * @example
  * ```typescript
  * const jwksField = firestoreEncryptedField<JWKSet>({
@@ -4327,9 +4335,6 @@ var _obj;
  * });
  * ```
  *
- * @template T - The JSON-serializable value type.
- * @param config - Encryption field configuration.
- * @returns A field mapping configuration for encrypted values.
  * @__NO_SIDE_EFFECTS__
  */ function firestoreEncryptedField(config) {
     var secret = config.secret, defaultValue = config.default;
@@ -4350,6 +4355,11 @@ var _obj;
  * When the value is null/undefined, it is stored/read as null. When present, it is
  * encrypted/decrypted using AES-256-GCM.
  *
+ * @param config - Encryption field configuration.
+ * @returns A field mapping configuration for optional encrypted values.
+ *
+ * @template T - The JSON-serializable value type.
+ *
  * @example
  * ```typescript
  * const optionalSecretField = optionalFirestoreEncryptedField<OAuthClientSecret>({
@@ -4357,9 +4367,6 @@ var _obj;
  * });
  * ```
  *
- * @template T - The JSON-serializable value type.
- * @param config - Encryption field configuration.
- * @returns A field mapping configuration for optional encrypted values.
  * @__NO_SIDE_EFFECTS__
  */ function optionalFirestoreEncryptedField(config) {
     var secret = config.secret;
@@ -4751,15 +4758,15 @@ function _ts_generator$c(thisArg, body) {
  * Creates an {@link OnCallAnalyticsEmitterInstance} that produces {@link OnCallAnalyticsEmitter} instances
  * for each lifecycle stage, pre-bound to the given service and context.
  *
+ * @param config - The service and context to bind to the emitter factory.
+ * @returns A factory function that creates lifecycle-stage-specific emitters.
+ *
  * @example
  * ```typescript
  * const emitter = onCallAnalyticsEmitterInstance({ service, context });
  * emitter('triggered').sendEventType('Handler Starting');
  * emitter('success').sendEvent('Widget Created', { id: result.id });
  * ```
- *
- * @param config - The service and context to bind to the emitter factory.
- * @returns A factory function that creates lifecycle-stage-specific emitters.
  */ function onCallAnalyticsEmitterInstance(config) {
     var service = config.service, context = config.context;
     return function(lifecycle) {
@@ -4796,8 +4803,8 @@ function _ts_generator$c(thisArg, body) {
  * Analytics callback errors are caught and logged but never propagate — the handler result
  * or error is always returned/thrown unmodified.
  *
- * @param config - the handler, analytics details, service, and context
- * @returns the handler's return value
+ * @param config - The handler, analytics details, service, and context.
+ * @returns The handler's return value.
  *
  * @example
  * ```ts
@@ -5008,6 +5015,9 @@ function _unsupported_iterable_to_array$a(o, minLen) {
  * (same effect as optionalAuthContext). This avoids the composition issue where
  * optionalAuthContext(withApiDetails(...)) would lose the _apiDetails.
  *
+ * @param config - The API details configuration including the handler function.
+ * @returns The handler function with _apiDetails attached.
+ *
  * @example
  * ```typescript
  * // Handler with api details (auth required by default)
@@ -5026,9 +5036,6 @@ function _unsupported_iterable_to_array$a(o, minLen) {
  *   fn: async (request) => { ... }
  * });
  * ```
- *
- * @param config - The API details configuration including the handler function.
- * @returns The handler function with _apiDetails attached.
  */ function withApiDetails(config) {
     var optionalAuth = config.optionalAuth, fn = config.fn, apiDetails = _object_without_properties(config, [
         "optionalAuth",
@@ -5181,7 +5188,7 @@ function _unsupported_iterable_to_array$a(o, minLen) {
  * pivots it to modelType → CRUD, which is the natural shape for MCP tool generation
  * and schema introspection.
  *
- * @param callModelFn The function returned by onCallModel(), or any object with _apiDetails.
+ * @param callModelFn - The function returned by onCallModel(), or any object with _apiDetails.
  * @returns Model-first API details, or undefined if no _apiDetails are present.
  *
  * @example
@@ -5192,64 +5199,67 @@ function _unsupported_iterable_to_array$a(o, minLen) {
  * ```
  */ function getModelApiDetails(callModelFn) {
     var topDetails = readApiDetails(callModelFn);
-    if (topDetails == null) {
-        return undefined;
-    }
-    var models = {};
-    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
-    try {
-        // Pivot: iterate CRUD types, then model types within each
-        for(var _iterator = Object.entries(topDetails)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
-            var _step_value = _sliced_to_array$2(_step.value, 2), callType = _step_value[0], crudDetails = _step_value[1];
-            if (crudDetails == null) {
-                continue;
-            }
-            var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
-            try {
-                for(var _iterator1 = Object.entries(crudDetails.modelTypes)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
-                    var _step_value1 = _sliced_to_array$2(_step1.value, 2), modelType = _step_value1[0], modelDetails = _step_value1[1];
-                    if (modelDetails == null) {
-                        continue;
-                    }
-                    if (!(modelType in models)) {
-                        models[modelType] = {
-                            calls: {}
-                        };
-                    }
-                    models[modelType].calls[callType] = modelDetails;
+    var result;
+    if (topDetails != null) {
+        var models = {};
+        var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+        try {
+            // Pivot: iterate CRUD types, then model types within each
+            for(var _iterator = Object.entries(topDetails)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                var _step_value = _sliced_to_array$2(_step.value, 2), callType = _step_value[0], crudDetails = _step_value[1];
+                if (crudDetails == null) {
+                    continue;
                 }
-            } catch (err) {
-                _didIteratorError1 = true;
-                _iteratorError1 = err;
-            } finally{
+                var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
                 try {
-                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
-                        _iterator1.return();
+                    for(var _iterator1 = Object.entries(crudDetails.modelTypes)[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+                        var _step_value1 = _sliced_to_array$2(_step1.value, 2), modelType = _step_value1[0], modelDetails = _step_value1[1];
+                        if (modelDetails == null) {
+                            continue;
+                        }
+                        if (!(modelType in models)) {
+                            models[modelType] = {
+                                calls: {}
+                            };
+                        }
+                        models[modelType].calls[callType] = modelDetails;
                     }
+                } catch (err) {
+                    _didIteratorError1 = true;
+                    _iteratorError1 = err;
                 } finally{
-                    if (_didIteratorError1) {
-                        throw _iteratorError1;
+                    try {
+                        if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                            _iterator1.return();
+                        }
+                    } finally{
+                        if (_didIteratorError1) {
+                            throw _iteratorError1;
+                        }
                     }
                 }
             }
-        }
-    } catch (err) {
-        _didIteratorError = true;
-        _iteratorError = err;
-    } finally{
-        try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-                _iterator.return();
-            }
+        } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
         } finally{
-            if (_didIteratorError) {
-                throw _iteratorError;
+            try {
+                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                    _iterator.return();
+                }
+            } finally{
+                if (_didIteratorError) {
+                    throw _iteratorError;
+                }
             }
         }
+        if (Object.keys(models).length > 0) {
+            result = {
+                models: models
+            };
+        }
     }
-    return Object.keys(models).length > 0 ? {
-        models: models
-    } : undefined;
+    return result;
 }
 // MARK: Analytics Resolution
 /**
@@ -5267,14 +5277,15 @@ function _unsupported_iterable_to_array$a(o, minLen) {
 function resolveAnalyticsFromApiDetails(apiDetails, call, modelType, specifier) {
     var _apiDetails_call;
     var modelDetails = (_apiDetails_call = apiDetails[call]) === null || _apiDetails_call === void 0 ? void 0 : _apiDetails_call.modelTypes[modelType];
+    var result;
     if (modelDetails) {
         var _modelDetails_specifiers_key;
         // All entries are now OnCallModelTypeApiDetails. For non-specifier handlers,
         // the details are under the `_` key.
         var key = specifier !== null && specifier !== void 0 ? specifier : '_';
-        return (_modelDetails_specifiers_key = modelDetails.specifiers[key]) === null || _modelDetails_specifiers_key === void 0 ? void 0 : _modelDetails_specifiers_key.analytics;
+        result = (_modelDetails_specifiers_key = modelDetails.specifiers[key]) === null || _modelDetails_specifiers_key === void 0 ? void 0 : _modelDetails_specifiers_key.analytics;
     }
-    return undefined;
+    return result;
 }
 /**
  * @deprecated Use {@link isOnCallModelTypeApiDetails} instead.
@@ -5339,6 +5350,9 @@ function resolveAnalyticsFromApiDetails(apiDetails, call, modelType, specifier)
  * By default, callable functions with auth-aware nest context require auth. Use this wrapper to
  * explicitly opt out of that requirement for endpoints that should be publicly accessible.
  *
+ * @param fn - The callable function handler to wrap.
+ * @returns A new handler flagged with `_requireAuth: false`.
+ *
  * @example
  * ```ts
  * const handler = optionalAuthContext<MyContext, Input, Output>((request) => {
@@ -5346,9 +5360,6 @@ function resolveAnalyticsFromApiDetails(apiDetails, call, modelType, specifier)
  *   return doSomething(request);
  * });
  * ```
- *
- * @param fn - The callable function handler to wrap.
- * @returns A new handler flagged with `_requireAuth: false`.
  */ function optionalAuthContext(fn) {
     var fnWithOptionalAuth = function fnWithOptionalAuth(request) {
         return fn(request);
@@ -5373,6 +5384,9 @@ function resolveAnalyticsFromApiDetails(apiDetails, call, modelType, specifier)
  * The wrapper calls {@link assertIsContextWithAuthData} before invoking the handler, ensuring that
  * unauthenticated requests are rejected with an appropriate error before reaching handler logic.
  *
+ * @param fn - The authorized handler to wrap with auth assertion.
+ * @returns A general {@link OnCallWithNestContext} handler that asserts auth before delegating.
+ *
  * @example
  * ```ts
  * const secureHandler = inAuthContext<MyContext, Input, Output>((request) => {
@@ -5380,9 +5394,6 @@ function resolveAnalyticsFromApiDetails(apiDetails, call, modelType, specifier)
  *   return processAuthenticatedRequest(request);
  * });
  * ```
- *
- * @param fn - The authorized handler to wrap with auth assertion.
- * @returns A general {@link OnCallWithNestContext} handler that asserts auth before delegating.
  */ function inAuthContext(fn) {
     return function(request) {
         assertIsContextWithAuthData(request);
@@ -5415,7 +5426,7 @@ function resolveAnalyticsFromApiDetails(apiDetails, call, modelType, specifier)
  */ function onCallSpecifierHandler(config) {
     var map = util.objectToMap(config);
     var fn = function fn(request) {
-        var _request_specifier = request.specifier, specifier = _request_specifier === void 0 ? firebase.MODEL_FUNCTION_FIREBASE_CRUD_FUNCTION_SPECIFIER_DEFAULT : _request_specifier;
+        var _request_specifier = request.specifier, specifier = _request_specifier === void 0 ? firebase.DEFAULT_MODEL_FUNCTION_FIREBASE_CRUD_FUNCTION_SPECIFIER : _request_specifier;
         var handler = map.get(specifier);
         if (handler != null) {
             return handler(request);
@@ -5534,13 +5545,15 @@ function _object_spread_props$c(target, source) {
     function getAnalyticsService(request) {
         var token = analyticsToken !== null && analyticsToken !== void 0 ? analyticsToken : ON_CALL_MODEL_ANALYTICS_SERVICE;
         var moduleRef = request.nestApplication.get(core.ModuleRef);
+        var result;
         try {
-            return moduleRef.get(token, {
+            result = moduleRef.get(token, {
                 strict: false
             });
         } catch (unused) {
-            return noopOnCallModelAnalyticsService();
+            result = noopOnCallModelAnalyticsService();
         }
+        return result;
     }
     var fn = function fn(request) {
         var call = request.data.call;
@@ -6056,6 +6069,9 @@ function _ts_generator$b(thisArg, body) {
  * - Fetching one extra document to detect whether more results exist
  * - Building the {@link OnCallQueryModelResult} with cursorDocumentKey and hasMore
  *
+ * @param config - Query configuration including collection, constraints, and pagination params.
+ * @returns Paginated query result with cursor for the next page.
+ *
  * @example
  * ```typescript
  * export const queryGuestbooks: DemoQueryModelFunction<QueryGuestbooksParams, OnCallQueryModelResult<Guestbook>> = async (request) => {
@@ -6078,9 +6094,6 @@ function _ts_generator$b(thisArg, body) {
  *   });
  * };
  * ```
- *
- * @param config - Query configuration including collection, constraints, and pagination params.
- * @returns Paginated query result with cursor for the next page.
  */ function executeOnCallQuery(config) {
     return _async_to_generator$b(function() {
         var _collection, _params_limit, _resultDocs_at, params, collection, loadCursorDocument, buildConstraints, _config_maxLimit, maxLimit, mapResult, requestedLimit, effectiveLimit, constraints, cursorSnapshot, e, errorInfo, executableQuery, querySnapshot, docs, hasMore, resultDocs, results, keys, cursorDocumentKey;
@@ -6201,16 +6214,17 @@ function _unsupported_iterable_to_array$8(o, minLen) {
  * Provides {@link FirebaseServerAnalyticsService} and registers it as the
  * {@link ON_CALL_MODEL_ANALYTICS_SERVICE} token for the onCall dispatch chain.
  *
- * @param config - the configuration including an optional dependency module and additional providers
- * @returns module metadata ready for use with `@Module()`
+ * @param config - The configuration including an optional dependency module and additional providers.
+ * @returns Module metadata ready for use with `@Module()`
  *
- * @example
- * ```ts
- * @Module(appAnalyticsModuleMetadata({
+ * @Module (appAnalyticsModuleMetadata({
  *   dependencyModule: FirebaseServerAnalyticsSegmentModule
  * }))
  * export class AppAnalyticsModule {}
  * ```
+ *
+ * @example
+ * ```ts
  */ function appAnalyticsModuleMetadata(config) {
     var dependencyModule = config.dependencyModule, imports = config.imports, exports$1 = config.exports, providers = config.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -6602,13 +6616,14 @@ exports.FirebaseServerAuthModule = __decorate([
  * @param config - The module metadata configuration including the service provider.
  * @returns The merged NestJS module metadata.
  *
- * @example
- * ```typescript
- * @Module(firebaseServerAuthModuleMetadata({
+ * @Module (firebaseServerAuthModuleMetadata({
  *   serviceProvider: { provide: MyAuthService, useFactory: (auth) => new MyAuthService(auth) }
  * }))
  * export class AppAuthModule {}
  * ```
+ *
+ * @example
+ * ```typescript
  */ function firebaseServerAuthModuleMetadata(config) {
     return nestjs.mergeModuleMetadata({
         imports: [
@@ -7329,7 +7344,7 @@ function _ts_generator$9(thisArg, body) {
      * @param key - The full Firestore model key (e.g., 'pr/abc123').
      * @param auth - The authenticated user's auth data from the request.
      * @returns The document key and data.
-     * @throws Permission or not-found errors from useModel.
+     * @throws {Error} Permission or not-found errors from useModel.
      */ function readDocument(modelType, key, auth) {
                 return _async_to_generator$9(function() {
                     var authRef, doc, snapshot;
@@ -7889,6 +7904,7 @@ function _ts_generator$8(thisArg, body) {
      *
      * @param req - The Express request containing wildcard path params.
      * @returns Parsed path components with modelType, call, and specifier (defaults to '_').
+     * @throws {HttpException} `400 BAD_REQUEST` when `modelType` or `call` is missing from the path.
      */ key: "_parsePath",
             value: function _parsePath(req) {
                 var _ref, _req_params_path, _pathSegments_;
@@ -7960,18 +7976,21 @@ function _ts_generator$8(thisArg, body) {
         {
             key: "_toHttpException",
             value: function _toHttpException(error) {
-                var _ref, _ref1, _ref2;
-                var _error_httpErrorCode;
+                var result;
                 if (_instanceof$1(error, common.HttpException)) {
-                    return error;
+                    result = error;
+                } else {
+                    var _ref, _ref1, _ref2;
+                    var _error_httpErrorCode;
+                    var status = (_ref = (_ref1 = error === null || error === void 0 ? void 0 : error.status) !== null && _ref1 !== void 0 ? _ref1 : error === null || error === void 0 ? void 0 : (_error_httpErrorCode = error.httpErrorCode) === null || _error_httpErrorCode === void 0 ? void 0 : _error_httpErrorCode.status) !== null && _ref !== void 0 ? _ref : common.HttpStatus.INTERNAL_SERVER_ERROR;
+                    var message = (_ref2 = error === null || error === void 0 ? void 0 : error.message) !== null && _ref2 !== void 0 ? _ref2 : 'Internal server error';
+                    result = new common.HttpException({
+                        statusCode: status,
+                        message: message,
+                        code: error === null || error === void 0 ? void 0 : error.code
+                    }, status);
                 }
-                var status = (_ref = (_ref1 = error === null || error === void 0 ? void 0 : error.status) !== null && _ref1 !== void 0 ? _ref1 : error === null || error === void 0 ? void 0 : (_error_httpErrorCode = error.httpErrorCode) === null || _error_httpErrorCode === void 0 ? void 0 : _error_httpErrorCode.status) !== null && _ref !== void 0 ? _ref : common.HttpStatus.INTERNAL_SERVER_ERROR;
-                var message = (_ref2 = error === null || error === void 0 ? void 0 : error.message) !== null && _ref2 !== void 0 ? _ref2 : 'Internal server error';
-                return new common.HttpException({
-                    statusCode: status,
-                    message: message,
-                    code: error === null || error === void 0 ? void 0 : error.code
-                }, status);
+                return result;
             }
         }
     ]);
@@ -8067,13 +8086,14 @@ function _unsupported_iterable_to_array$7(o, minLen) {
  * @param metadataConfig - Configuration including the dependency module.
  * @returns NestJS module metadata with the Model API controller, dispatch service, and app context provider.
  *
- * @example
- * ```typescript
- * @Module(modelApiModuleMetadata({
+ * @Module (modelApiModuleMetadata({
  *   dependencyModule: DemoModelApiDependencyModule
  * }))
  * export class DemoModelApiModule {}
  * ```
+ *
+ * @example
+ * ```typescript
  */ function modelApiModuleMetadata(metadataConfig) {
     var dependencyModule = metadataConfig.dependencyModule, imports = metadataConfig.imports, exports$1 = metadataConfig.exports, providers = metadataConfig.providers;
     return {
@@ -8201,7 +8221,7 @@ function _object_spread_props$8(target, source) {
 /**
  * Creates a bad-request error indicating the provided development function specifier is not recognized.
  *
- * @param specifier - the unrecognized specifier string from the client request.
+ * @param specifier - The unrecognized specifier string from the client request.
  * @returns A bad-request error with the unknown specifier details.
  */ function developmentUnknownSpecifierError(specifier) {
     return badRequestError(util.serverError({
@@ -8236,7 +8256,7 @@ function _object_spread_props$8(target, source) {
  * Creates a bad-request error for when the requested scheduled function name
  * is not found in the registered function map.
  *
- * @param name - the unrecognized function name from the client request.
+ * @param name - The unrecognized function name from the client request.
  * @returns A bad-request error with the unknown function name details.
  */ function unknownScheduledFunctionDevelopmentFunctionName(name) {
     return badRequestError({
@@ -8254,7 +8274,7 @@ function _object_spread_props$8(target, source) {
  * Creates a bad-request error for when the request `type` field does not match
  * any supported operation ('run' or 'list').
  *
- * @param type - the unrecognized type value from the client request.
+ * @param type - The unrecognized type value from the client request.
  * @returns A bad-request error with the unknown type details.
  */ function unknownScheduledFunctionDevelopmentFunctionType(type) {
     return badRequestError({
@@ -8481,7 +8501,7 @@ function _ts_generator$7(thisArg, body) {
     });
     return function(request) {
         return _async_to_generator$7(function() {
-            var data, type, targetRunName, targetFunction, e;
+            var data, type, result, targetRunName, targetFunction, e;
             return _ts_generator$7(this, function(_state) {
                 switch(_state.label){
                     case 0:
@@ -8535,24 +8555,27 @@ function _ts_generator$7(thisArg, body) {
                         console.error('Failed manually running task "'.concat(targetRunName, '".'), e);
                         throw e;
                     case 5:
+                        result = {
+                            type: 'run',
+                            success: true
+                        };
                         return [
-                            2,
-                            {
-                                type: 'run',
-                                success: true
-                            }
+                            3,
+                            7
                         ];
                     case 6:
+                        result = {
+                            type: 'list',
+                            list: getListValues()
+                        };
                         return [
-                            2,
-                            {
-                                type: 'list',
-                                list: getListValues()
-                            }
+                            3,
+                            7
                         ];
                     case 7:
                         return [
-                            2
+                            2,
+                            result
                         ];
                 }
             });
@@ -8918,7 +8941,7 @@ exports.DefaultFirebaseServerEnvService = __decorate([
  *
  * Useful for conditionally enabling production-only Cloud Functions (e.g., scheduled tasks).
  *
- * @param nest - getter for the NestJS application context promise.
+ * @param nest - Getter for the NestJS application context promise.
  * @returns An async decision function that resolves to `true` in production.
  *
  * @example
@@ -8938,7 +8961,7 @@ exports.DefaultFirebaseServerEnvService = __decorate([
  *
  * The development scheduler is enabled in non-production, non-testing environments.
  *
- * @param nest - getter for the NestJS application context promise.
+ * @param nest - Getter for the NestJS application context promise.
  * @returns An async decision function that resolves to `true` when the development scheduler is enabled.
  */ function nestAppHasDevelopmentSchedulerEnabled(nest) {
     return function() {
@@ -9041,16 +9064,17 @@ exports.FirebaseServerFirestoreContextModule = __decorate([
  *
  * If caching is not needed, use {@link FirebaseServerFirestoreContextModule} directly instead.
  *
- * @param config - Configuration including the cache factory
- * @returns Module metadata ready for the `@Module()` decorator
+ * @param config - Configuration including the cache factory.
+ * @returns Module metadata ready for the `@Module()` decorator.
  *
- * @example
- * ```typescript
- * @Module(firebaseServerFirestoreContextModuleMetadata({
+ * @Module (firebaseServerFirestoreContextModuleMetadata({
  *   firestoreContextCacheFactory: inMemoryFirestoreContextCacheFactory()
  * }))
  * export class AppFirestoreContextModule {}
  * ```
+ *
+ * @example
+ * ```typescript
  */ function firebaseServerFirestoreContextModuleMetadata(config) {
     var params = {
         firestoreContextCacheFactory: config.firestoreContextCacheFactory
@@ -9115,25 +9139,25 @@ exports.FirebaseServerFirestoreContextModule = __decorate([
  * @param config - The Firestore collections config plus optional additional module metadata.
  * @returns NestJS module metadata ready to be passed to the `@Module()` decorator.
  *
- * @example
- * ```typescript
- * @Module(appFirestoreModuleMetadata({
+ * @Module (appFirestoreModuleMetadata({
  *   provide: DemoFirestoreCollections,
  *   useFactory: (context) => new DemoFirestoreCollections(context)
  * }))
  * export class AppFirestoreModule {}
  * ```
- *
- * @example
- * ```typescript
- * // With caching
- * @Module(appFirestoreModuleMetadata({
+ * @Module (appFirestoreModuleMetadata({
  *   provide: DemoFirestoreCollections,
  *   useFactory: (context) => new DemoFirestoreCollections(context),
  *   firestoreContextCacheFactory: inMemoryFirestoreContextCacheFactory()
  * }))
  * export class AppFirestoreModule {}
  * ```
+ *
+ * @example
+ * ```typescript
+ * @example
+ * ```typescript
+ * // With caching
  */ function appFirestoreModuleMetadata(config) {
     var _contextModuleMetadata_imports, _config_imports, _contextModuleMetadata_exports, _config_exports, _contextModuleMetadata_providers, _config_providers;
     var contextModuleMetadata = config.firestoreContextCacheFactory ? firebaseServerFirestoreContextModuleMetadata({
@@ -9208,6 +9232,11 @@ function _object_spread_props$7(target, source) {
  * The attached `__handler` enables direct handler invocation in tests without triggering
  * the full Firebase blocking function infrastructure.
  *
+ * @param blockingFunctionBuilder - The Firebase blocking function constructor (e.g., `beforeUserCreated`).
+ * @param handler - The handler logic to execute on each event.
+ * @param opts - Optional {@link BlockingOptions} passed to the builder.
+ * @returns A {@link BlockingFunctionWithHandler} with the handler accessible via `__handler`.
+ *
  * @example
  * ```ts
  * const fn = makeBlockingFunctionWithHandler(
@@ -9218,10 +9247,6 @@ function _object_spread_props$7(target, source) {
  * // In tests: fn.__handler(mockEvent)
  * ```
  *
- * @param blockingFunctionBuilder - The Firebase blocking function constructor (e.g., `beforeUserCreated`).
- * @param handler - The handler logic to execute on each event.
- * @param opts - Optional {@link BlockingOptions} passed to the builder.
- * @returns A {@link BlockingFunctionWithHandler} with the handler accessible via `__handler`.
  * @__NO_SIDE_EFFECTS__
  */ function makeBlockingFunctionWithHandler(blockingFunctionBuilder, handler, opts) {
     var blockingFn = opts != null ? blockingFunctionBuilder(opts, handler) : blockingFunctionBuilder(handler);
@@ -9235,6 +9260,9 @@ function _object_spread_props$7(target, source) {
  * The returned factory lazily resolves the NestJS application on each invocation, injects the
  * typed context into the event, and delegates to the handler.
  *
+ * @param makeNestContext - Factory that creates the typed context from the NestJS application context.
+ * @returns A factory for creating nest-context-aware blocking function handlers.
+ *
  * @example
  * ```ts
  * const factory = blockingFunctionHandlerWithNestContextFactory(makeMyContext);
@@ -9246,8 +9274,6 @@ function _object_spread_props$7(target, source) {
  * );
  * ```
  *
- * @param makeNestContext - Factory that creates the typed context from the NestJS application context.
- * @returns A factory for creating nest-context-aware blocking function handlers.
  * @__NO_SIDE_EFFECTS__
  */ function blockingFunctionHandlerWithNestContextFactory(makeNestContext) {
     return function(fn) {
@@ -9322,6 +9348,9 @@ function _object_spread_props$6(target, source) {
  * The `defaultOpts` are merged with per-function options, allowing shared configuration (e.g., CORS settings,
  * memory allocation) to be set once at the factory level.
  *
+ * @param defaultOpts - Default {@link https.CallableOptions} applied to all functions created by this factory.
+ * @returns A factory that creates nest-application-aware callable functions.
+ *
  * @example
  * ```ts
  * const callFactory = onCallHandlerWithNestApplicationFactory({ cors: true });
@@ -9331,8 +9360,6 @@ function _object_spread_props$6(target, source) {
  * );
  * ```
  *
- * @param defaultOpts - Default {@link https.CallableOptions} applied to all functions created by this factory.
- * @returns A factory that creates nest-application-aware callable functions.
  * @__NO_SIDE_EFFECTS__
  */ function onCallHandlerWithNestApplicationFactory() {
     var defaultOpts = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
@@ -9355,6 +9382,10 @@ function _object_spread_props$6(target, source) {
  * This is the standard way to create callable functions that receive a domain-specific context
  * (e.g., `MyApiNestContext`) rather than the raw NestJS application context.
  *
+ * @param appFactory - The base application-level callable factory.
+ * @param makeNestContext - Factory that creates the typed context from the application context.
+ * @returns A factory that creates typed-context-aware callable functions.
+ *
  * @example
  * ```ts
  * const appFactory = onCallHandlerWithNestApplicationFactory();
@@ -9365,9 +9396,6 @@ function _object_spread_props$6(target, source) {
  * });
  * ```
  *
- * @param appFactory - The base application-level callable factory.
- * @param makeNestContext - Factory that creates the typed context from the application context.
- * @returns A factory that creates typed-context-aware callable functions.
  * @__NO_SIDE_EFFECTS__
  */ function onCallHandlerWithNestContextFactory(appFactory, makeNestContext) {
     return function(fn, opts) {
@@ -9432,6 +9460,9 @@ function _object_spread_props$5(target, source) {
  * context, and delegates to the handler. This is the event-triggered equivalent of
  * {@link onCallHandlerWithNestContextFactory} for callable functions.
  *
+ * @param makeNestContext - Factory that creates the typed context from the NestJS application context.
+ * @returns A factory for creating nest-context-aware event function handlers.
+ *
  * @example
  * ```ts
  * const factory = cloudEventHandlerWithNestContextFactory(makeMyContext);
@@ -9443,8 +9474,6 @@ function _object_spread_props$5(target, source) {
  * );
  * ```
  *
- * @param makeNestContext - Factory that creates the typed context from the NestJS application context.
- * @returns A factory for creating nest-context-aware event function handlers.
  * @__NO_SIDE_EFFECTS__
  */ function cloudEventHandlerWithNestContextFactory(makeNestContext) {
     return function(fn) {
@@ -9500,6 +9529,9 @@ function _object_spread_props$5(target, source) {
  * merges base and per-function schedule options, and attaches `_runNow` and `_schedule` metadata
  * to the resulting function for testing and introspection.
  *
+ * @param baseScheduleConfig - Optional default schedule options merged into every function created by this factory.
+ * @returns A factory for creating nest-application-aware scheduled functions.
+ *
  * @example
  * ```ts
  * const scheduleFactory = onScheduleHandlerWithNestApplicationFactory({ timeoutSeconds: 60 });
@@ -9509,8 +9541,6 @@ function _object_spread_props$5(target, source) {
  * );
  * ```
  *
- * @param baseScheduleConfig - Optional default schedule options merged into every function created by this factory.
- * @returns A factory for creating nest-application-aware scheduled functions.
  * @__NO_SIDE_EFFECTS__
  */ function onScheduleHandlerWithNestApplicationFactory(baseScheduleConfig) {
     return function(inputSchedule, fn) {
@@ -9607,9 +9637,10 @@ function _object_spread_props$4(target, source) {
 /**
  * Creates a TaskQueueFunctionHandlerWithNestContextFactory.
  *
- * @param appFactory
  * @param makeNestContext
+ * @param appFactory
  * @returns
+ *
  * @__NO_SIDE_EFFECTS__
  */ function taskQueueFunctionHandlerWithNestContextFactory(makeNestContext) {
     return function(fn) {
@@ -9802,13 +9833,13 @@ function _ts_generator$5(thisArg, body) {
 /**
  * Creates a {@link FirebaseServerActionsContext} with the default transform and validation factories.
  *
+ * @param options - Optional configuration for error logging behavior.
+ * @returns A fully configured actions context.
+ *
  * @example
  * ```ts
  * const context = firebaseServerActionsContext({ logError: true });
  * ```
- *
- * @param options - Optional configuration for error logging behavior.
- * @returns A fully configured actions context.
  */ function firebaseServerActionsContext(options) {
     return _object_spread$4({}, firebaseServerActionsTransformContext(options));
 }
@@ -9816,7 +9847,7 @@ function _ts_generator$5(thisArg, body) {
  * Default error logger that writes validation error details to the console.
  * Used when `logError` is `true` or omitted in the factory options.
  *
- * @param details - the validation error details to log.
+ * @param details - The validation error details to log.
  */ var defaultFirebaseServerActionsTransformFactoryLogErrorFunction = function defaultFirebaseServerActionsTransformFactoryLogErrorFunction(details) {
     console.log('firebaseServerActionsTransformFactory() encountered validation error: ', details);
 };
@@ -9872,6 +9903,9 @@ function _ts_generator$5(thisArg, body) {
  *
  * Validation errors are optionally logged before the error is thrown, controlled by the `logError` option.
  *
+ * @param options - Optional configuration for error logging behavior.
+ * @returns A factory that creates type-safe transform functions from ArkType schemas.
+ *
  * @example
  * ```ts
  * const transformFactory = firebaseServerActionsTransformFactory({ logError: true });
@@ -9879,8 +9913,6 @@ function _ts_generator$5(thisArg, body) {
  * const validated = await transform(rawInput);
  * ```
  *
- * @param options - Optional configuration for error logging behavior.
- * @returns A factory that creates type-safe transform functions from ArkType schemas.
  * @__NO_SIDE_EFFECTS__
  */ function firebaseServerActionsTransformFactory(options) {
     var logError = (options !== null && options !== void 0 ? options : {}).logError;
@@ -10807,8 +10839,8 @@ function _ts_generator$2(thisArg, body) {
 /**
  * Resolves a Google Cloud Storage {@link Bucket} from a {@link StoragePath}.
  *
- * @param storage - the Google Cloud Storage client instance.
- * @param path - the storage path containing the bucket ID.
+ * @param storage - The Google Cloud Storage client instance.
+ * @param path - The storage path containing the bucket ID.
  * @returns The resolved Google Cloud Storage bucket.
  */ function googleCloudStorageBucketForStorageFilePath(storage, path) {
     return storage.bucket(path.bucketId);
@@ -10816,8 +10848,8 @@ function _ts_generator$2(thisArg, body) {
 /**
  * Resolves a Google Cloud Storage {@link GoogleCloudFile} from a {@link StoragePath}.
  *
- * @param storage - the Google Cloud Storage client instance.
- * @param path - the storage path containing bucket ID and file path.
+ * @param storage - The Google Cloud Storage client instance.
+ * @param path - The storage path containing bucket ID and file path.
  * @returns The resolved Google Cloud Storage file reference.
  */ function googleCloudStorageFileForStorageFilePath(storage, path) {
     return googleCloudStorageBucketForStorageFilePath(storage, path).file(path.pathString);
@@ -10825,8 +10857,8 @@ function _ts_generator$2(thisArg, body) {
 /**
  * Converts Google Cloud Storage {@link FileMetadata} into the normalized {@link StorageMetadata} format.
  *
- * @param file - the Google Cloud Storage file reference.
- * @param metadata - the raw file metadata from the Google Cloud SDK.
+ * @param file - The Google Cloud Storage file reference.
+ * @param metadata - The raw file metadata from the Google Cloud SDK.
  * @returns Normalized storage metadata.
  */ function googleCloudFileMetadataToStorageMetadata(file, metadata) {
     var _metadata_generation;
@@ -10859,8 +10891,8 @@ function _ts_generator$2(thisArg, body) {
  *
  * Handles emulator-specific edge cases (e.g., signing errors, atomic move fallback).
  *
- * @param storage - the Google Cloud Storage client instance.
- * @param storagePath - the storage path identifying the file's bucket and path.
+ * @param storage - The Google Cloud Storage client instance.
+ * @param storagePath - The storage path identifying the file's bucket and path.
  * @returns A file accessor with CRUD, streaming, and ACL operations.
  */ function googleCloudStorageAccessorFile(storage$1, storagePath) {
     var file = googleCloudStorageFileForStorageFilePath(storage$1, storagePath);
@@ -11219,8 +11251,8 @@ var googleCloudStorageListFilesResultFactory = firebase.storageListFilesResultFa
  * Creates a {@link GoogleCloudStorageAccessorFolder} that supports checking folder existence
  * and listing files/subfolders with pagination.
  *
- * @param storage - the Google Cloud Storage client instance.
- * @param storagePath - the storage path identifying the folder's bucket and prefix.
+ * @param storage - The Google Cloud Storage client instance.
+ * @param storagePath - The storage path identifying the folder's bucket and prefix.
  * @returns A folder accessor with existence checking and listing operations.
  */ function googleCloudStorageAccessorFolder(storage, storagePath) {
     var bucket = googleCloudStorageBucketForStorageFilePath(storage, storagePath);
@@ -11556,7 +11588,7 @@ exports.FirebaseServerStorageContextModule = __decorate([
  *
  * @param input - A bucket ID string or full factory config object.
  * @returns A NestJS provider for the storage context factory config token.
- * @throws Error if `defaultBucketId` is empty.
+ * @throws {Error} If `defaultBucketId` is empty.
  *
  * @example
  * ```typescript
@@ -11593,7 +11625,7 @@ exports.FirebaseServerStorageContextModule = __decorate([
  * so the service can also be injected by the abstract type.
  *
  * @param provider - The storage service provider configuration.
- * @returns An array of NestJS providers for the storage service.
+ * @returns Array of NestJS providers for the storage service.
  * @__NO_SIDE_EFFECTS__
  */ function provideFirebaseServerStorageService(provider) {
     var _provider_inject;
@@ -11619,11 +11651,12 @@ exports.FirebaseServerStorageContextModule = __decorate([
  * @param config - Optional configuration including a custom service provider and additional module metadata.
  * @returns NestJS module metadata ready to be passed to the `@Module()` decorator.
  *
- * @example
- * ```typescript
- * @Module(firebaseServerStorageModuleMetadata())
+ * @Module (firebaseServerStorageModuleMetadata())
  * export class AppStorageModule {}
  * ```
+ *
+ * @example
+ * ```typescript
  */ function firebaseServerStorageModuleMetadata(config) {
     var _ref;
     var serviceProvider = (_ref = config === null || config === void 0 ? void 0 : config.serviceProvider) !== null && _ref !== void 0 ? _ref : defaultProvideFirebaseServerStorageServiceSimple();
@@ -11737,8 +11770,9 @@ var FirebaseNestServerRootModule = function FirebaseNestServerRootModule() {
  * - `GlobalRoutePrefixConfig` token
  * - Optional webhook and AppCheck middleware modules
  *
- * @param config - Shared configuration
- * @returns The root module and resolved prefix config
+ * @param config - Shared configuration.
+ * @returns The root module and resolved prefix config.
+ *
  * @__NO_SIDE_EFFECTS__
  */ function buildNestServerRootModule(config) {
     var _ref, _ref1;
@@ -12040,6 +12074,7 @@ function _ts_generator$1(thisArg, body) {
         };
     }
 }
+// COMPAT: Deprecated alias for NestFirebaseServerEnvironmentConfig.
 /**
  * Creates a {@link NestServerInstance} that manages NestJS server lifecycle within Firebase Cloud Functions.
  *
@@ -12420,8 +12455,9 @@ function _ts_generator(thisArg, body) {
             get: /**
      * Returns the NestJS application context.
      *
-     * @deprecated use nestApplication instead.
      * @returns The NestJS application context.
+     *
+     * @deprecated use nestApplication instead.
      */ function get() {
                 return this._nestApplication;
             }
@@ -12549,9 +12585,9 @@ function _ts_generator(thisArg, body) {
      * {@link nestFirebaseForbiddenPermissionError}. These errors are captured per-key
      * and passed to the `use` function via the failure array (unless `throwOnFirstError` is true).
      *
-     * @param type - the model type to load
-     * @param select - selection params including keys array, roles, and use function
-     * @returns the result of the use function
+     * @param type - The model type to load.
+     * @param select - Selection params including keys array, roles, and use function.
+     * @returns The result of the use function.
      *
      * @example
      * ```ts
@@ -12618,18 +12654,12 @@ function _ts_generator(thisArg, body) {
                                     throw errors[0].error;
                                 }
                                 // useOnFirstError: call use() with empty successes and abortedEarly: true on first error
-                                if (hasErrors && useOnFirstError) {
-                                    return [
-                                        2,
-                                        use([], {
-                                            errors: errors,
-                                            abortedEarly: true
-                                        })
-                                    ];
-                                }
                                 return [
                                     2,
-                                    use(successful, {
+                                    hasErrors && useOnFirstError ? use([], {
+                                        errors: errors,
+                                        abortedEarly: true
+                                    }) : use(successful, {
                                         errors: errors,
                                         abortedEarly: false
                                     })