@firebase/app 0.9.29 → 0.10.0-canary.0068ed5ab

package/dist/index.cjs.js

@@ -63,7 +63,7 @@ function isVersionServiceProvider(provider) {
 }
 
 var name$o = "@firebase/app";
-var version$1 = "0.9.29";
+var version$1 = "0.10.0-canary.0068ed5ab";
 
 /**
  * @license
@@ -130,7 +130,7 @@ var name$2 = "@firebase/firestore";
 var name$1 = "@firebase/firestore-compat";
 
 var name = "firebase";
-var version = "10.9.0";
+var version = "10.10.0-canary.0068ed5ab";
 
 /**
  * @license
@@ -204,6 +204,10 @@ var PLATFORM_LOG_STRING = (_a$1 = {},
  * @internal
  */
 var _apps = new Map();
+/**
+ * @internal
+ */
+var _serverApps = new Map();
 /**
  * Registered components.
  *
@@ -239,7 +243,7 @@ function _addOrOverwriteComponent(app, component) {
  * @internal
  */
 function _registerComponent(component) {
-    var e_1, _a;
+    var e_1, _a, e_2, _b;
     var componentName = component.name;
     if (_components.has(componentName)) {
         logger.debug("There were multiple attempts to register component ".concat(componentName, "."));
@@ -248,18 +252,31 @@ function _registerComponent(component) {
     _components.set(componentName, component);
     try {
         // add the component to existing app instances
-        for (var _b = tslib.__values(_apps.values()), _c = _b.next(); !_c.done; _c = _b.next()) {
-            var app = _c.value;
+        for (var _c = tslib.__values(_apps.values()), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var app = _d.value;
             _addComponent(app, component);
         }
     }
     catch (e_1_1) { e_1 = { error: e_1_1 }; }
     finally {
         try {
-            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
         }
         finally { if (e_1) throw e_1.error; }
     }
+    try {
+        for (var _e = tslib.__values(_serverApps.values()), _f = _e.next(); !_f.done; _f = _e.next()) {
+            var serverApp = _f.value;
+            _addComponent(serverApp, component);
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
     return true;
 }
 /**
@@ -292,6 +309,28 @@ function _removeServiceInstance(app, name, instanceIdentifier) {
     if (instanceIdentifier === void 0) { instanceIdentifier = DEFAULT_ENTRY_NAME; }
     _getProvider(app, name).clearInstance(instanceIdentifier);
 }
+/**
+ *
+ * @param obj - an object of type FirebaseApp or FirebaseOptions.
+ *
+ * @returns true if the provide object is of type FirebaseApp.
+ *
+ * @internal
+ */
+function _isFirebaseApp(obj) {
+    return obj.options !== undefined;
+}
+/**
+ *
+ * @param obj - an object of type FirebaseApp.
+ *
+ * @returns true if the provided object is of type FirebaseServerAppImpl.
+ *
+ * @internal
+ */
+function _isFirebaseServerApp(obj) {
+    return obj.settings !== undefined;
+}
 /**
  * Test only
  *
@@ -321,9 +360,10 @@ var _a;
 var ERRORS = (_a = {},
     _a["no-app" /* AppError.NO_APP */] = "No Firebase App '{$appName}' has been created - " +
         'call initializeApp() first',
-    _a["bad-app-name" /* AppError.BAD_APP_NAME */] = "Illegal App name: '{$appName}",
+    _a["bad-app-name" /* AppError.BAD_APP_NAME */] = "Illegal App name: '{$appName}'",
     _a["duplicate-app" /* AppError.DUPLICATE_APP */] = "Firebase App named '{$appName}' already exists with different options or config",
     _a["app-deleted" /* AppError.APP_DELETED */] = "Firebase App named '{$appName}' already deleted",
+    _a["server-app-deleted" /* AppError.SERVER_APP_DELETED */] = 'Firebase Server App has been deleted',
     _a["no-options" /* AppError.NO_OPTIONS */] = 'Need to provide options, when not being deployed to hosting via source.',
     _a["invalid-app-argument" /* AppError.INVALID_APP_ARGUMENT */] = 'firebase.{$appName}() takes either no argument or a ' +
         'Firebase App instance.',
@@ -332,6 +372,8 @@ var ERRORS = (_a = {},
     _a["idb-get" /* AppError.IDB_GET */] = 'Error thrown when reading from IndexedDB. Original error: {$originalErrorMessage}.',
     _a["idb-set" /* AppError.IDB_WRITE */] = 'Error thrown when writing to IndexedDB. Original error: {$originalErrorMessage}.',
     _a["idb-delete" /* AppError.IDB_DELETE */] = 'Error thrown when deleting from IndexedDB. Original error: {$originalErrorMessage}.',
+    _a["finalization-registry-not-supported" /* AppError.FINALIZATION_REGISTRY_NOT_SUPPORTED */] = 'FirebaseServerApp deleteOnDeref field defined but the JS runtime does not support FinalizationRegistry.',
+    _a["invalid-server-app-environment" /* AppError.INVALID_SERVER_APP_ENVIRONMENT */] = 'FirebaseServerApp is not for use in browser environments.',
     _a);
 var ERROR_FACTORY = new util.ErrorFactory('app', 'Firebase', ERRORS);
 
@@ -428,6 +470,111 @@ var FirebaseAppImpl = /** @class */ (function () {
     return FirebaseAppImpl;
 }());
 
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ *
+ * 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.
+ */
+var FirebaseServerAppImpl = /** @class */ (function (_super) {
+    tslib.__extends(FirebaseServerAppImpl, _super);
+    function FirebaseServerAppImpl(options, serverConfig, name, container) {
+        var _this = this;
+        // Build configuration parameters for the FirebaseAppImpl base class.
+        var automaticDataCollectionEnabled = serverConfig.automaticDataCollectionEnabled !== undefined
+            ? serverConfig.automaticDataCollectionEnabled
+            : false;
+        // Create the FirebaseAppSettings object for the FirebaseAppImp constructor.
+        var config = {
+            name: name,
+            automaticDataCollectionEnabled: automaticDataCollectionEnabled
+        };
+        if (options.apiKey !== undefined) {
+            // Construct the parent FirebaseAppImp object.
+            _this = _super.call(this, options, config, container) || this;
+        }
+        else {
+            var appImpl = options;
+            _this = _super.call(this, appImpl.options, config, container) || this;
+        }
+        // Now construct the data for the FirebaseServerAppImpl.
+        _this._serverConfig = tslib.__assign({ automaticDataCollectionEnabled: automaticDataCollectionEnabled }, serverConfig);
+        _this._finalizationRegistry = new FinalizationRegistry(function () {
+            _this.automaticCleanup();
+        });
+        _this._refCount = 0;
+        _this.incRefCount(_this._serverConfig.releaseOnDeref);
+        // Do not retain a hard reference to the dref object, otherwise the FinalizationRegisry
+        // will never trigger.
+        _this._serverConfig.releaseOnDeref = undefined;
+        serverConfig.releaseOnDeref = undefined;
+        registerVersion(name$o, version$1, 'serverapp');
+        return _this;
+    }
+    FirebaseServerAppImpl.prototype.toJSON = function () {
+        return undefined;
+    };
+    Object.defineProperty(FirebaseServerAppImpl.prototype, "refCount", {
+        get: function () {
+            return this._refCount;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    // Increment the reference count of this server app. If an object is provided, register it
+    // with the finalization registry.
+    FirebaseServerAppImpl.prototype.incRefCount = function (obj) {
+        if (this.isDeleted) {
+            return;
+        }
+        this._refCount++;
+        if (obj !== undefined) {
+            this._finalizationRegistry.register(obj, this);
+        }
+    };
+    // Decrement the reference count.
+    FirebaseServerAppImpl.prototype.decRefCount = function () {
+        if (this.isDeleted) {
+            return 0;
+        }
+        return --this._refCount;
+    };
+    // Invoked by the FinalizationRegistry callback to note that this app should go through its
+    // reference counts and delete itself if no reference count remain. The coordinating logic that
+    // handles this is in deleteApp(...).
+    FirebaseServerAppImpl.prototype.automaticCleanup = function () {
+        void deleteApp(this);
+    };
+    Object.defineProperty(FirebaseServerAppImpl.prototype, "settings", {
+        get: function () {
+            this.checkDestroyed();
+            return this._serverConfig;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * This function will throw an Error if the App has already been deleted -
+     * use before performing API actions on the App.
+     */
+    FirebaseServerAppImpl.prototype.checkDestroyed = function () {
+        if (this.isDeleted) {
+            throw ERROR_FACTORY.create("server-app-deleted" /* AppError.SERVER_APP_DELETED */);
+        }
+    };
+    return FirebaseServerAppImpl;
+}(FirebaseAppImpl));
+
 /**
  * @license
  * Copyright 2019 Google LLC
@@ -498,6 +645,61 @@ function initializeApp(_options, rawConfig) {
     _apps.set(name, newApp);
     return newApp;
 }
+function initializeServerApp(_options, _serverAppConfig) {
+    var e_2, _a;
+    if (util.isBrowser()) {
+        // FirebaseServerApp isn't designed to be run in browsers.
+        throw ERROR_FACTORY.create("invalid-server-app-environment" /* AppError.INVALID_SERVER_APP_ENVIRONMENT */);
+    }
+    if (_serverAppConfig.automaticDataCollectionEnabled === undefined) {
+        _serverAppConfig.automaticDataCollectionEnabled = false;
+    }
+    var appOptions;
+    if (_isFirebaseApp(_options)) {
+        appOptions = _options.options;
+    }
+    else {
+        appOptions = _options;
+    }
+    // Build an app name based on a hash of the configuration options.
+    var nameObj = tslib.__assign(tslib.__assign({}, _serverAppConfig), appOptions);
+    // However, Do not mangle the name based on releaseOnDeref, since it will vary between the
+    // construction of FirebaseServerApp instances. For example, if the object is the request headers.
+    if (nameObj.releaseOnDeref !== undefined) {
+        delete nameObj.releaseOnDeref;
+    }
+    var hashCode = function (s) {
+        return tslib.__spreadArray([], tslib.__read(s), false).reduce(function (hash, c) { return (Math.imul(31, hash) + c.charCodeAt(0)) | 0; }, 0);
+    };
+    if (_serverAppConfig.releaseOnDeref !== undefined) {
+        if (typeof FinalizationRegistry === 'undefined') {
+            throw ERROR_FACTORY.create("finalization-registry-not-supported" /* AppError.FINALIZATION_REGISTRY_NOT_SUPPORTED */, {});
+        }
+    }
+    var nameString = '' + hashCode(JSON.stringify(nameObj));
+    var existingApp = _serverApps.get(nameString);
+    if (existingApp) {
+        existingApp.incRefCount(_serverAppConfig.releaseOnDeref);
+        return existingApp;
+    }
+    var container = new component.ComponentContainer(nameString);
+    try {
+        for (var _b = tslib.__values(_components.values()), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var component$1 = _c.value;
+            container.addComponent(component$1);
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    var newApp = new FirebaseServerAppImpl(appOptions, _serverAppConfig, nameString, container);
+    _serverApps.set(nameString, newApp);
+    return newApp;
+}
 /**
  * Retrieves a {@link @firebase/app#FirebaseApp} instance.
  *
@@ -564,13 +766,24 @@ function getApps() {
  */
 function deleteApp(app) {
     return tslib.__awaiter(this, void 0, void 0, function () {
-        var name;
+        var cleanupProviders, name, firebaseServerApp;
         return tslib.__generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
+                    cleanupProviders = false;
                     name = app.name;
-                    if (!_apps.has(name)) return [3 /*break*/, 2];
-                    _apps.delete(name);
+                    if (_apps.has(name)) {
+                        cleanupProviders = true;
+                        _apps.delete(name);
+                    }
+                    else if (_serverApps.has(name)) {
+                        firebaseServerApp = app;
+                        if (firebaseServerApp.decRefCount() <= 0) {
+                            _serverApps.delete(name);
+                            cleanupProviders = true;
+                        }
+                    }
+                    if (!cleanupProviders) return [3 /*break*/, 2];
                     return [4 /*yield*/, Promise.all(app.container
                             .getProviders()
                             .map(function (provider) { return provider.delete(); }))];
@@ -1135,12 +1348,16 @@ exports._apps = _apps;
 exports._clearComponents = _clearComponents;
 exports._components = _components;
 exports._getProvider = _getProvider;
+exports._isFirebaseApp = _isFirebaseApp;
+exports._isFirebaseServerApp = _isFirebaseServerApp;
 exports._registerComponent = _registerComponent;
 exports._removeServiceInstance = _removeServiceInstance;
+exports._serverApps = _serverApps;
 exports.deleteApp = deleteApp;
 exports.getApp = getApp;
 exports.getApps = getApps;
 exports.initializeApp = initializeApp;
+exports.initializeServerApp = initializeServerApp;
 exports.onLog = onLog;
 exports.registerVersion = registerVersion;
 exports.setLogLevel = setLogLevel;