@firebase/database 1.0.12 → 1.0.13-20250226000544

package/dist/internal.d.ts

@@ -2269,22 +2269,6 @@ declare class Repo {
     toString(): string;
 }
 
-/**
- * @license
- * Copyright 2017 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.
- */
 /**
  * A class that holds metadata about a Repo object
  */
@@ -2296,6 +2280,7 @@ declare class RepoInfo {
     readonly persistenceKey: string;
     readonly includeNamespaceInQueryParams: boolean;
     readonly isUsingEmulator: boolean;
+    readonly emulatorOptions: RepoInfoEmulatorOptions | null;
     private _host;
     private _domain;
     internalHost: string;
@@ -2307,7 +2292,7 @@ declare class RepoInfo {
      * @param nodeAdmin - Whether this instance uses Admin SDK credentials
      * @param persistenceKey - Override the default session persistence storage key
      */
-    constructor(host: string, secure: boolean, namespace: string, webSocketOnly: boolean, nodeAdmin?: boolean, persistenceKey?: string, includeNamespaceInQueryParams?: boolean, isUsingEmulator?: boolean);
+    constructor(host: string, secure: boolean, namespace: string, webSocketOnly: boolean, nodeAdmin?: boolean, persistenceKey?: string, includeNamespaceInQueryParams?: boolean, isUsingEmulator?: boolean, emulatorOptions?: RepoInfoEmulatorOptions | null);
     isCacheableHost(): boolean;
     isCustomHost(): boolean;
     get host(): string;
@@ -2316,6 +2301,10 @@ declare class RepoInfo {
     toURLString(): string;
 }
 
+declare interface RepoInfoEmulatorOptions {
+    mockUserToken?: string | EmulatorMockTokenOptions;
+}
+
 /**
  * This function should only ever be called to CREATE a new database instance.
  * @internal

package/dist/node-esm/index.node.esm.js

@@ -1,5 +1,5 @@
 import Websocket from 'faye-websocket';
-import { stringify, jsonEval, contains, assert, isNodeSdk, stringToByteArray, Sha1, base64, deepCopy, base64Encode, isMobileCordova, stringLength, Deferred, safeGet, isAdmin, isValidFormat, isEmpty, isReactNative, assertionError, map, querystring, errorPrefix, getModularInstance, getDefaultEmulatorHostnameAndPort, createMockUserToken } from '@firebase/util';
+import { stringify, jsonEval, contains, assert, isNodeSdk, stringToByteArray, Sha1, base64, deepCopy, base64Encode, isMobileCordova, stringLength, Deferred, safeGet, isAdmin, isValidFormat, isEmpty, isReactNative, assertionError, map, querystring, errorPrefix, getModularInstance, getDefaultEmulatorHostnameAndPort, deepEqual, createMockUserToken } from '@firebase/util';
 import { Logger, LogLevel } from '@firebase/logger';
 import { _isFirebaseServerApp, _getProvider, getApp, SDK_VERSION as SDK_VERSION$1, _registerComponent, registerVersion } from '@firebase/app';
 import { Component, ComponentContainer, Provider } from '@firebase/component';
@@ -721,7 +721,7 @@ class RepoInfo {
      * @param nodeAdmin - Whether this instance uses Admin SDK credentials
      * @param persistenceKey - Override the default session persistence storage key
      */
-    constructor(host, secure, namespace, webSocketOnly, nodeAdmin = false, persistenceKey = '', includeNamespaceInQueryParams = false, isUsingEmulator = false) {
+    constructor(host, secure, namespace, webSocketOnly, nodeAdmin = false, persistenceKey = '', includeNamespaceInQueryParams = false, isUsingEmulator = false, emulatorOptions = null) {
         this.secure = secure;
         this.namespace = namespace;
         this.webSocketOnly = webSocketOnly;
@@ -729,6 +729,7 @@ class RepoInfo {
         this.persistenceKey = persistenceKey;
         this.includeNamespaceInQueryParams = includeNamespaceInQueryParams;
         this.isUsingEmulator = isUsingEmulator;
+        this.emulatorOptions = emulatorOptions;
         this._host = host.toLowerCase();
         this._domain = this._host.substr(this._host.indexOf('.') + 1);
         this.internalHost =
@@ -1251,7 +1252,7 @@ WebSocketConnection.responsesRequiredToBeHealthy = 2;
 WebSocketConnection.healthyTimeout = 30000;
 
 const name = "@firebase/database";
-const version = "1.0.12";
+const version = "1.0.13-20250226000544";
 
 /**
  * @license
@@ -13490,10 +13491,10 @@ let useRestClient = false;
 /**
  * Update an existing `Repo` in place to point to a new host/port.
  */
-function repoManagerApplyEmulatorSettings(repo, host, port, tokenProvider) {
-    repo.repoInfo_ = new RepoInfo(`${host}:${port}`, 
+function repoManagerApplyEmulatorSettings(repo, hostAndPort, emulatorOptions, tokenProvider) {
+    repo.repoInfo_ = new RepoInfo(hostAndPort, 
     /* secure= */ false, repo.repoInfo_.namespace, repo.repoInfo_.webSocketOnly, repo.repoInfo_.nodeAdmin, repo.repoInfo_.persistenceKey, repo.repoInfo_.includeNamespaceInQueryParams, 
-    /*isUsingEmulator=*/ true);
+    /*isUsingEmulator=*/ true, emulatorOptions);
     if (tokenProvider) {
         repo.authTokenProvider_ = tokenProvider;
     }
@@ -13678,10 +13679,17 @@ function getDatabase(app = getApp(), url) {
 function connectDatabaseEmulator(db, host, port, options = {}) {
     db = getModularInstance(db);
     db._checkNotDeleted('useEmulator');
+    const hostAndPort = `${host}:${port}`;
+    const repo = db._repoInternal;
     if (db._instanceStarted) {
-        fatal('Cannot call useEmulator() after instance has already been initialized.');
+        // If the instance has already been started, then silenty fail if this function is called again
+        // with the same parameters. If the parameters differ then assert.
+        if (hostAndPort === db._repoInternal.repoInfo_.host &&
+            deepEqual(options, repo.repoInfo_.emulatorOptions)) {
+            return;
+        }
+        fatal('connectDatabaseEmulator() cannot initialize or alter the emulator configuration after the database instance has started.');
     }
-    const repo = db._repoInternal;
     let tokenProvider = undefined;
     if (repo.repoInfo_.nodeAdmin) {
         if (options.mockUserToken) {
@@ -13696,7 +13704,7 @@ function connectDatabaseEmulator(db, host, port, options = {}) {
         tokenProvider = new EmulatorTokenProvider(token);
     }
     // Modify the repo to apply emulator settings
-    repoManagerApplyEmulatorSettings(repo, host, port, tokenProvider);
+    repoManagerApplyEmulatorSettings(repo, hostAndPort, options, tokenProvider);
 }
 /**
  * Disconnects from the server (all Database operations will be completed