firebase-admin 12.0.0 → 12.1.1

package/lib/machine-learning/machine-learning-api-client.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/machine-learning/machine-learning-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/machine-learning/machine-learning-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/machine-learning/machine-learning-utils.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/machine-learning/machine-learning-utils.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/machine-learning/machine-learning.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/machine-learning/machine-learning.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/messaging/batch-request-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2019 Google Inc.
  *

package/lib/messaging/batch-request-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2019 Google Inc.

package/lib/messaging/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2020 Google Inc.
  *
@@ -50,3 +50,4 @@ export { AndroidConfig, AndroidFcmOptions, AndroidNotification, ApnsConfig, Apns
  *   app.
  */
 export declare function getMessaging(app?: App): Messaging;
+export { FirebaseMessagingError, MessagingClientErrorCode } from '../utils/error';

package/lib/messaging/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.
@@ -16,7 +16,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMessaging = exports.Messaging = void 0;
+exports.MessagingClientErrorCode = exports.FirebaseMessagingError = exports.getMessaging = exports.Messaging = void 0;
 /**
  * Firebase Cloud Messaging (FCM).
  *
@@ -60,3 +60,6 @@ function getMessaging(app) {
     return firebaseApp.getOrInitService('messaging', (app) => new messaging_1.Messaging(app));
 }
 exports.getMessaging = getMessaging;
+var error_1 = require("../utils/error");
+Object.defineProperty(exports, "FirebaseMessagingError", { enumerable: true, get: function () { return error_1.FirebaseMessagingError; } });
+Object.defineProperty(exports, "MessagingClientErrorCode", { enumerable: true, get: function () { return error_1.MessagingClientErrorCode; } });

package/lib/messaging/messaging-api-request-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * @license
  * Copyright 2017 Google Inc.

package/lib/messaging/messaging-api-request-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * @license

package/lib/messaging/messaging-api.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * @license
  * Copyright 2021 Google Inc.

package/lib/messaging/messaging-api.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * @license

package/lib/messaging/messaging-errors-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2019 Google Inc.
  *

package/lib/messaging/messaging-errors-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2019 Google Inc.

package/lib/messaging/messaging-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2020 Google Inc.
  *

package/lib/messaging/messaging-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.

package/lib/messaging/messaging-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/messaging/messaging-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/messaging/messaging.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * @license
  * Copyright 2017 Google Inc.

package/lib/messaging/messaging.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * @license
@@ -235,7 +235,7 @@ class Messaging {
         }
         return this.getUrlPath()
             .then((urlPath) => {
-            const requests = copy.map((message) => {
+            const requests = copy.map(async (message) => {
                 (0, messaging_internal_1.validateMessage)(message);
                 const request = { message };
                 if (dryRun) {

package/lib/project-management/android-app.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/android-app.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/project-management/app-metadata.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/project-management/app-metadata.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/project-management/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2020 Google Inc.
  *
@@ -51,3 +51,4 @@ export { IosApp, IosAppMetadata } from './ios-app';
  *   `ProjectManagement` service associated with the provided app.
  */
 export declare function getProjectManagement(app?: App): ProjectManagement;
+export { FirebaseProjectManagementError, ProjectManagementErrorCode } from '../utils/error';

package/lib/project-management/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.
@@ -16,7 +16,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getProjectManagement = exports.IosApp = exports.ShaCertificate = exports.AndroidApp = exports.ProjectManagement = exports.AppPlatform = void 0;
+exports.FirebaseProjectManagementError = exports.getProjectManagement = exports.IosApp = exports.ShaCertificate = exports.AndroidApp = exports.ProjectManagement = exports.AppPlatform = void 0;
 /**
  * Firebase project management.
  *
@@ -66,3 +66,5 @@ function getProjectManagement(app) {
     return firebaseApp.getOrInitService('projectManagement', (app) => new project_management_1.ProjectManagement(app));
 }
 exports.getProjectManagement = getProjectManagement;
+var error_1 = require("../utils/error");
+Object.defineProperty(exports, "FirebaseProjectManagementError", { enumerable: true, get: function () { return error_1.FirebaseProjectManagementError; } });

package/lib/project-management/ios-app.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/ios-app.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/project-management/project-management-api-request-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/project-management-api-request-internal.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/project-management/project-management-namespace.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2021 Google Inc.
  *

package/lib/project-management/project-management-namespace.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2021 Google Inc.

package/lib/project-management/project-management.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2018 Google Inc.
  *

package/lib/project-management/project-management.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2018 Google Inc.

package/lib/remote-config/condition-evaluator-internal.d.ts

@@ -0,0 +1,17 @@
+/*! firebase-admin v12.1.1 */
+/*!
+ * Copyright 2024 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export {};

package/lib/remote-config/condition-evaluator-internal.js

@@ -0,0 +1,130 @@
+/*! firebase-admin v12.1.1 */
+/*!
+ * Copyright 2024 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConditionEvaluator = void 0;
+const remote_config_api_1 = require("./remote-config-api");
+const farmhash = require("farmhash");
+const long = require("long");
+/**
+ * Encapsulates condition evaluation logic to simplify organization and
+ * facilitate testing.
+ *
+ * @internal
+ */
+class ConditionEvaluator {
+    evaluateConditions(namedConditions, context) {
+        // The order of the conditions is significant.
+        // A JS Map preserves the order of insertion ("Iteration happens in insertion order"
+        // - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map#description).
+        const evaluatedConditions = new Map();
+        for (const namedCondition of namedConditions) {
+            evaluatedConditions.set(namedCondition.name, this.evaluateCondition(namedCondition.condition, context));
+        }
+        return evaluatedConditions;
+    }
+    evaluateCondition(condition, context, nestingLevel = 0) {
+        if (nestingLevel >= ConditionEvaluator.MAX_CONDITION_RECURSION_DEPTH) {
+            // TODO: add logging once we have a wrapped logger.
+            return false;
+        }
+        if (condition.orCondition) {
+            return this.evaluateOrCondition(condition.orCondition, context, nestingLevel + 1);
+        }
+        if (condition.andCondition) {
+            return this.evaluateAndCondition(condition.andCondition, context, nestingLevel + 1);
+        }
+        if (condition.true) {
+            return true;
+        }
+        if (condition.false) {
+            return false;
+        }
+        if (condition.percent) {
+            return this.evaluatePercentCondition(condition.percent, context);
+        }
+        // TODO: add logging once we have a wrapped logger.
+        return false;
+    }
+    evaluateOrCondition(orCondition, context, nestingLevel) {
+        const subConditions = orCondition.conditions || [];
+        for (const subCondition of subConditions) {
+            // Recursive call.
+            const result = this.evaluateCondition(subCondition, context, nestingLevel + 1);
+            // Short-circuit the evaluation result for true.
+            if (result) {
+                return result;
+            }
+        }
+        return false;
+    }
+    evaluateAndCondition(andCondition, context, nestingLevel) {
+        const subConditions = andCondition.conditions || [];
+        for (const subCondition of subConditions) {
+            // Recursive call.
+            const result = this.evaluateCondition(subCondition, context, nestingLevel + 1);
+            // Short-circuit the evaluation result for false.
+            if (!result) {
+                return result;
+            }
+        }
+        return true;
+    }
+    evaluatePercentCondition(percentCondition, context) {
+        if (!context.randomizationId) {
+            // TODO: add logging once we have a wrapped logger.
+            return false;
+        }
+        // This is the entry point for processing percent condition data from the response.
+        // We're not using a proto library, so we can't assume undefined fields have
+        // default values.
+        const { seed, percentOperator, microPercent, microPercentRange } = percentCondition;
+        if (!percentOperator) {
+            // TODO: add logging once we have a wrapped logger.
+            return false;
+        }
+        const normalizedMicroPercent = microPercent || 0;
+        const normalizedMicroPercentUpperBound = microPercentRange?.microPercentUpperBound || 0;
+        const normalizedMicroPercentLowerBound = microPercentRange?.microPercentLowerBound || 0;
+        const seedPrefix = seed && seed.length > 0 ? `${seed}.` : '';
+        const stringToHash = `${seedPrefix}${context.randomizationId}`;
+        // Using a 64-bit long for consistency with the Remote Config fetch endpoint.
+        let hash64 = long.fromString(farmhash.fingerprint64(stringToHash));
+        // Negate the hash if its value is less than 0. We handle this manually because the
+        // Long library doesn't provided an absolute value method.
+        if (hash64.lt(0)) {
+            hash64 = hash64.negate();
+        }
+        const instanceMicroPercentile = hash64.mod(100 * 1000000);
+        switch (percentOperator) {
+            case remote_config_api_1.PercentConditionOperator.LESS_OR_EQUAL:
+                return instanceMicroPercentile.lte(normalizedMicroPercent);
+            case remote_config_api_1.PercentConditionOperator.GREATER_THAN:
+                return instanceMicroPercentile.gt(normalizedMicroPercent);
+            case remote_config_api_1.PercentConditionOperator.BETWEEN:
+                return instanceMicroPercentile.gt(normalizedMicroPercentLowerBound)
+                    && instanceMicroPercentile.lte(normalizedMicroPercentUpperBound);
+            case remote_config_api_1.PercentConditionOperator.UNKNOWN:
+            default:
+                break;
+        }
+        // TODO: add logging once we have a wrapped logger.
+        return false;
+    }
+}
+exports.ConditionEvaluator = ConditionEvaluator;
+ConditionEvaluator.MAX_CONDITION_RECURSION_DEPTH = 10;

package/lib/remote-config/index.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2020 Google Inc.
  *
@@ -21,7 +21,7 @@
  */
 import { App } from '../app';
 import { RemoteConfig } from './remote-config';
-export { ExplicitParameterValue, InAppDefaultValue, ListVersionsOptions, ListVersionsResult, ParameterValueType, RemoteConfigCondition, RemoteConfigParameter, RemoteConfigParameterGroup, RemoteConfigParameterValue, RemoteConfigTemplate, RemoteConfigUser, TagColor, Version, } from './remote-config-api';
+export { AndCondition, DefaultConfig, EvaluationContext, ExplicitParameterValue, GetServerTemplateOptions, InAppDefaultValue, InitServerTemplateOptions, ListVersionsOptions, ListVersionsResult, MicroPercentRange, NamedCondition, OneOfCondition, OrCondition, ParameterValueType, PercentConditionOperator, PercentCondition, RemoteConfigCondition, RemoteConfigParameter, RemoteConfigParameterGroup, RemoteConfigParameterValue, RemoteConfigTemplate, RemoteConfigUser, ServerConfig, ServerTemplate, ServerTemplateData, ServerTemplateDataType, TagColor, Value, ValueSource, Version, } from './remote-config-api';
 export { RemoteConfig } from './remote-config';
 /**
  * Gets the {@link RemoteConfig} service for the default app or a given app.

package/lib/remote-config/index.js

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 "use strict";
 /*!
  * Copyright 2020 Google Inc.
@@ -16,7 +16,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRemoteConfig = exports.RemoteConfig = void 0;
+exports.getRemoteConfig = exports.RemoteConfig = exports.PercentConditionOperator = void 0;
 /**
  * Firebase Remote Config.
  *
@@ -24,6 +24,8 @@ exports.getRemoteConfig = exports.RemoteConfig = void 0;
  */
 const app_1 = require("../app");
 const remote_config_1 = require("./remote-config");
+var remote_config_api_1 = require("./remote-config-api");
+Object.defineProperty(exports, "PercentConditionOperator", { enumerable: true, get: function () { return remote_config_api_1.PercentConditionOperator; } });
 var remote_config_2 = require("./remote-config");
 Object.defineProperty(exports, "RemoteConfig", { enumerable: true, get: function () { return remote_config_2.RemoteConfig; } });
 /**

package/lib/remote-config/internal/value-impl.d.ts

@@ -0,0 +1,17 @@
+/*! firebase-admin v12.1.1 */
+/*!
+ * Copyright 2024 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export {};

package/lib/remote-config/internal/value-impl.js

@@ -0,0 +1,59 @@
+/*! firebase-admin v12.1.1 */
+/*!
+ * Copyright 2024 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValueImpl = void 0;
+/**
+ * Implements type-safe getters for parameter values.
+ *
+ * Visible for testing.
+ *
+ * @internal
+ */
+class ValueImpl {
+    constructor(source, value = ValueImpl.DEFAULT_VALUE_FOR_STRING) {
+        this.source = source;
+        this.value = value;
+    }
+    asString() {
+        return this.value;
+    }
+    asBoolean() {
+        if (this.source === 'static') {
+            return ValueImpl.DEFAULT_VALUE_FOR_BOOLEAN;
+        }
+        return ValueImpl.BOOLEAN_TRUTHY_VALUES.indexOf(this.value.toLowerCase()) >= 0;
+    }
+    asNumber() {
+        if (this.source === 'static') {
+            return ValueImpl.DEFAULT_VALUE_FOR_NUMBER;
+        }
+        const num = Number(this.value);
+        if (isNaN(num)) {
+            return ValueImpl.DEFAULT_VALUE_FOR_NUMBER;
+        }
+        return num;
+    }
+    getSource() {
+        return this.source;
+    }
+}
+exports.ValueImpl = ValueImpl;
+ValueImpl.DEFAULT_VALUE_FOR_BOOLEAN = false;
+ValueImpl.DEFAULT_VALUE_FOR_STRING = '';
+ValueImpl.DEFAULT_VALUE_FOR_NUMBER = 0;
+ValueImpl.BOOLEAN_TRUTHY_VALUES = ['1', 'true', 't', 'yes', 'y', 'on'];

package/lib/remote-config/remote-config-api-client-internal.d.ts

@@ -1,4 +1,4 @@
-/*! firebase-admin v12.0.0 */
+/*! firebase-admin v12.1.1 */
 /*!
  * Copyright 2020 Google Inc.
  *