@firebase/firestore 3.4.14-canary.fcd4b8ac3 → 3.4.15

package/dist/lite/internal.d.ts

@@ -979,18 +979,18 @@ declare abstract class Filter {
 export declare class Firestore implements FirestoreService {
     _authCredentials: CredentialsProvider<User>;
     _appCheckCredentials: CredentialsProvider<string>;
+    readonly _databaseId: DatabaseId;
+    readonly _app?: FirebaseApp | undefined;
     /**
      * Whether it's a Firestore or Firestore Lite instance.
      */
     type: 'firestore-lite' | 'firestore';
-    readonly _databaseId: DatabaseId;
     readonly _persistenceKey: string;
     private _settings;
     private _settingsFrozen;
     private _terminateTask?;
-    _app?: FirebaseApp;
     /** @hideconstructor */
-    constructor(databaseIdOrApp: DatabaseId | FirebaseApp, _authCredentials: CredentialsProvider<User>, _appCheckCredentials: CredentialsProvider<string>);
+    constructor(_authCredentials: CredentialsProvider<User>, _appCheckCredentials: CredentialsProvider<string>, _databaseId: DatabaseId, _app?: FirebaseApp | undefined);
     /**
      * The {@link @firebase/app#FirebaseApp} associated with this `Firestore` service
      * instance.
@@ -1555,15 +1555,48 @@ export declare function getDoc<T>(reference: DocumentReference<T>): Promise<Docu
 export declare function getDocs<T>(query: Query<T>): Promise<QuerySnapshot<T>>;
 
 /**
- * Returns the existing `Firestore` instance that is associated with the
+ * Returns the existing default {@link Firestore} instance that is associated with the
+ * default {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @returns The {@link Firestore} instance of the provided app.
+ */
+export declare function getFirestore(): Firestore;
+
+/**
+ * Returns the existing default {@link Firestore} instance that is associated with the
+ * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
+ * instance is associated with.
+ * @returns The {@link Firestore} instance of the provided app.
+ */
+export declare function getFirestore(app: FirebaseApp): Firestore;
+
+/**
+ * Returns the existing {@link Firestore} instance that is associated with the
+ * default {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @param databaseId - The name of database.
+ * @returns The {@link Firestore} instance of the provided app.
+ * @internal
+ */
+export declare function getFirestore(databaseId: string): Firestore;
+
+/**
+ * Returns the existing {@link Firestore} instance that is associated with the
  * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
  * instance with default settings.
  *
- * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned `Firestore`
+ * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
  * instance is associated with.
- * @returns The `Firestore` instance of the provided app.
+ * @param databaseId - The name of database.
+ * @returns The {@link Firestore} instance of the provided app.
+ * @internal
  */
-export declare function getFirestore(app?: FirebaseApp): Firestore;
+export declare function getFirestore(app: FirebaseApp, databaseId: string): Firestore;
 
 /**
  * Returns a special value that can be used with {@link @firebase/firestore/lite#(setDoc:1)} or {@link
@@ -1603,6 +1636,21 @@ declare type IndexState = 'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'ERROR';
  */
 export declare function initializeFirestore(app: FirebaseApp, settings: Settings): Firestore;
 
+/**
+ * Initializes a new instance of Cloud Firestore with the provided settings.
+ * Can only be called before any other functions, including
+ * {@link getFirestore}. If the custom settings are empty, this function is
+ * equivalent to calling {@link getFirestore}.
+ *
+ * @param app - The {@link @firebase/app#FirebaseApp} with which the `Firestore` instance will
+ * be associated.
+ * @param settings - A settings object to configure the `Firestore` instance.
+ * @param databaseId - The name of database.
+ * @returns A newly initialized `Firestore` instance.
+ * @internal
+ */
+export declare function initializeFirestore(app: FirebaseApp, settings: Settings, databaseId?: string): Firestore;
+
 /**
  * Creates a {@link QueryConstraint} that only returns the first matching documents.
  *

package/dist/lite/packages/firestore/dist/lite/index.browser.esm2017.d.ts

@@ -273,9 +273,11 @@ declare class wn {
  * Do not call this constructor directly. Instead, use {@link getFirestore}.
  */ declare class an {
     /** @hideconstructor */
-    constructor(t: any, e: any, n: any);
+    constructor(t: any, e: any, n: any, r: any);
     _authCredentials: any;
     _appCheckCredentials: any;
+    _databaseId: any;
+    _app: any;
     /**
      * Whether it's a Firestore or Firestore Lite instance.
      */
@@ -283,8 +285,6 @@ declare class wn {
     _persistenceKey: string;
     _settings: cn;
     _settingsFrozen: boolean;
-    _databaseId: H;
-    _app: any;
     /**
      * The {@link @firebase/app#FirebaseApp} associated with this `Firestore` service
      * instance.
@@ -298,7 +298,7 @@ declare class wn {
     _terminateTask: Promise<void> | undefined;
     /** Returns a JSON-serializable representation of this `Firestore` instance. */ toJSON(): {
         app: any;
-        databaseId: H;
+        databaseId: any;
         settings: cn;
     };
     /**
@@ -737,15 +737,7 @@ declare function yr(...t: any[]): pr;
  * @param query - The `Query` to execute.
  * @returns A Promise that will be resolved with the results of the query.
  */ declare function Rr(t: any): Promise<er>;
-/**
- * Returns the existing `Firestore` instance that is associated with the
- * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
- * instance with default settings.
- *
- * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned `Firestore`
- * instance is associated with.
- * @returns The `Firestore` instance of the provided app.
- */ declare function ln(e?: import("@firebase/app").FirebaseApp): import("../../lite").Firestore;
+declare function ln(e: any, n: any): import("../../lite").Firestore;
 /**
  * Returns a special value that can be used with {@link @firebase/firestore/lite#(setDoc:1)} or {@link
  * @firebase/firestore/lite#(updateDoc:1)} that tells the server to increment the field's current value by
@@ -765,7 +757,7 @@ declare function yr(...t: any[]): pr;
  * @returns The `FieldValue` sentinel for use in a call to `setDoc()` or
  * `updateDoc()`
  */ declare function qr(t: any): Mn;
-declare function hn(t: any, e: any): import("../../lite").Firestore;
+declare function hn(t: any, e: any, n: any): import("../../lite").Firestore;
 /**
  * Creates a {@link QueryConstraint} that only returns the first matching documents.
  *
@@ -957,19 +949,6 @@ declare class cn {
     useFetchStreams: boolean;
     isEqual(t: any): boolean;
 }
-/** The default database name for a project. */
-/**
- * Represents the database ID a Firestore client is associated with.
- * @internal
- */
-declare class H {
-    static empty(): H;
-    constructor(t: any, e: any);
-    projectId: any;
-    database: any;
-    get isDefaultDatabase(): boolean;
-    isEqual(t: any): boolean;
-}
 import { FirebaseError as c } from "@firebase/util/dist/src/errors";
 /**
  * Helper for parsing raw user input (provided via the API) into internal model
@@ -1043,22 +1022,6 @@ declare class or extends sr {
     type: string;
     _apply(t: any): mn;
 }
-/**
- * @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.
- */
 /**
  * Path represents an ordered sequence of string segments.
  */

package/dist/lite/packages/firestore/src/api/database.d.ts

@@ -50,7 +50,7 @@ export declare class Firestore extends LiteFirestore {
     readonly _persistenceKey: string;
     _firestoreClient: FirestoreClient | undefined;
     /** @hideconstructor */
-    constructor(databaseIdOrApp: DatabaseId | FirebaseApp, authCredentialsProvider: CredentialsProvider<User>, appCheckCredentialsProvider: CredentialsProvider<string>);
+    constructor(authCredentialsProvider: CredentialsProvider<User>, appCheckCredentialsProvider: CredentialsProvider<string>, databaseId: DatabaseId, app?: FirebaseApp);
     _terminate(): Promise<void>;
 }
 /**
@@ -62,9 +62,38 @@ export declare class Firestore extends LiteFirestore {
  * @param app - The {@link @firebase/app#FirebaseApp} with which the {@link Firestore} instance will
  * be associated.
  * @param settings - A settings object to configure the {@link Firestore} instance.
+ * @param databaseId - The name of database.
  * @returns A newly initialized {@link Firestore} instance.
  */
-export declare function initializeFirestore(app: FirebaseApp, settings: FirestoreSettings): Firestore;
+export declare function initializeFirestore(app: FirebaseApp, settings: FirestoreSettings, databaseId?: string): Firestore;
+/**
+ * Returns the existing default {@link Firestore} instance that is associated with the
+ * default {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @returns The {@link Firestore} instance of the provided app.
+ */
+export declare function getFirestore(): Firestore;
+/**
+ * Returns the existing default {@link Firestore} instance that is associated with the
+ * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
+ * instance is associated with.
+ * @returns The {@link Firestore} instance of the provided app.
+ */
+export declare function getFirestore(app: FirebaseApp): Firestore;
+/**
+ * Returns the existing {@link Firestore} instance that is associated with the
+ * default {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @param databaseId - The name of database.
+ * @returns The {@link Firestore} instance of the provided app.
+ * @internal
+ */
+export declare function getFirestore(databaseId: string): Firestore;
 /**
  * Returns the existing {@link Firestore} instance that is associated with the
  * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
@@ -72,9 +101,11 @@ export declare function initializeFirestore(app: FirebaseApp, settings: Firestor
  *
  * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
  * instance is associated with.
+ * @param databaseId - The name of database.
  * @returns The {@link Firestore} instance of the provided app.
+ * @internal
  */
-export declare function getFirestore(app?: FirebaseApp): Firestore;
+export declare function getFirestore(app: FirebaseApp, databaseId: string): Firestore;
 /**
  * @internal
  */

package/dist/lite/packages/firestore/src/core/database_info.d.ts

@@ -1,3 +1,4 @@
+import { FirebaseApp } from '@firebase/app';
 /**
  * @license
  * Copyright 2017 Google LLC
@@ -42,6 +43,8 @@ export declare class DatabaseInfo {
      */
     constructor(databaseId: DatabaseId, appId: string, persistenceKey: string, host: string, ssl: boolean, forceLongPolling: boolean, autoDetectLongPolling: boolean, useFetchStreams: boolean);
 }
+/** The default database name for a project. */
+export declare const DEFAULT_DATABASE_NAME = "(default)";
 /**
  * Represents the database ID a Firestore client is associated with.
  * @internal
@@ -54,3 +57,4 @@ export declare class DatabaseId {
     get isDefaultDatabase(): boolean;
     isEqual(other: {}): boolean;
 }
+export declare function databaseIdFromApp(app: FirebaseApp, database?: string): DatabaseId;

package/dist/lite/packages/firestore/src/lite-api/database.d.ts

@@ -34,18 +34,18 @@ declare module '@firebase/component' {
 export declare class Firestore implements FirestoreService {
     _authCredentials: CredentialsProvider<User>;
     _appCheckCredentials: CredentialsProvider<string>;
+    readonly _databaseId: DatabaseId;
+    readonly _app?: FirebaseApp | undefined;
     /**
      * Whether it's a Firestore or Firestore Lite instance.
      */
     type: 'firestore-lite' | 'firestore';
-    readonly _databaseId: DatabaseId;
     readonly _persistenceKey: string;
     private _settings;
     private _settingsFrozen;
     private _terminateTask?;
-    _app?: FirebaseApp;
     /** @hideconstructor */
-    constructor(databaseIdOrApp: DatabaseId | FirebaseApp, _authCredentials: CredentialsProvider<User>, _appCheckCredentials: CredentialsProvider<string>);
+    constructor(_authCredentials: CredentialsProvider<User>, _appCheckCredentials: CredentialsProvider<string>, _databaseId: DatabaseId, _app?: FirebaseApp | undefined);
     /**
      * The {@link @firebase/app#FirebaseApp} associated with this `Firestore` service
      * instance.
@@ -81,15 +81,59 @@ export declare class Firestore implements FirestoreService {
  */
 export declare function initializeFirestore(app: FirebaseApp, settings: FirestoreSettings): Firestore;
 /**
- * Returns the existing `Firestore` instance that is associated with the
+ * Initializes a new instance of Cloud Firestore with the provided settings.
+ * Can only be called before any other functions, including
+ * {@link getFirestore}. If the custom settings are empty, this function is
+ * equivalent to calling {@link getFirestore}.
+ *
+ * @param app - The {@link @firebase/app#FirebaseApp} with which the `Firestore` instance will
+ * be associated.
+ * @param settings - A settings object to configure the `Firestore` instance.
+ * @param databaseId - The name of database.
+ * @returns A newly initialized `Firestore` instance.
+ * @internal
+ */
+export declare function initializeFirestore(app: FirebaseApp, settings: FirestoreSettings, databaseId?: string): Firestore;
+/**
+ * Returns the existing default {@link Firestore} instance that is associated with the
+ * default {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @returns The {@link Firestore} instance of the provided app.
+ */
+export declare function getFirestore(): Firestore;
+/**
+ * Returns the existing default {@link Firestore} instance that is associated with the
+ * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
+ * instance is associated with.
+ * @returns The {@link Firestore} instance of the provided app.
+ */
+export declare function getFirestore(app: FirebaseApp): Firestore;
+/**
+ * Returns the existing {@link Firestore} instance that is associated with the
+ * default {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @param databaseId - The name of database.
+ * @returns The {@link Firestore} instance of the provided app.
+ * @internal
+ */
+export declare function getFirestore(databaseId: string): Firestore;
+/**
+ * Returns the existing {@link Firestore} instance that is associated with the
  * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
  * instance with default settings.
  *
- * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned `Firestore`
+ * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
  * instance is associated with.
- * @returns The `Firestore` instance of the provided app.
+ * @param databaseId - The name of database.
+ * @returns The {@link Firestore} instance of the provided app.
+ * @internal
  */
-export declare function getFirestore(app?: FirebaseApp): Firestore;
+export declare function getFirestore(app: FirebaseApp, databaseId: string): Firestore;
 export { EmulatorMockTokenOptions } from '@firebase/util';
 /**
  * Modify this instance to communicate with the Cloud Firestore emulator.

package/dist/lite/packages/firestore/test/integration/api/provider.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022 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.
+ */
+export {};

package/dist/lite/packages/firestore/test/integration/util/firebase_export.d.ts

@@ -17,6 +17,7 @@
 import { FirebaseApp } from '@firebase/app';
 import { Firestore } from '../../../src';
 import { PrivateSettings } from '../../../src/lite-api/settings';
-export declare function newTestFirestore(projectId: string, nameOrApp?: string | FirebaseApp, settings?: PrivateSettings): Firestore;
+export declare function newTestApp(projectId: string, appName?: string): FirebaseApp;
+export declare function newTestFirestore(app: FirebaseApp, settings?: PrivateSettings, dbName?: string): Firestore;
 export * from '../../../src';
 export { PrivateSettings };

package/dist/lite/packages/firestore/test/integration/util/helpers.d.ts

@@ -37,6 +37,7 @@ export declare function withTestDb(persistence: boolean, fn: (db: Firestore) =>
 export declare function withAlternateTestDb(persistence: boolean, fn: (db: Firestore) => Promise<void>): Promise<void>;
 export declare function withTestDbs(persistence: boolean, numDbs: number, fn: (db: Firestore[]) => Promise<void>): Promise<void>;
 export declare function withTestDbsSettings(persistence: boolean, projectId: string, settings: PrivateSettings, numDbs: number, fn: (db: Firestore[]) => Promise<void>): Promise<void>;
+export declare function withNamedTestDbsOrSkipUnlessUsingEmulator(persistence: boolean, dbNames: string[], fn: (db: Firestore[]) => Promise<void>): Promise<void>;
 export declare function withTestDoc(persistence: boolean, fn: (doc: DocumentReference, db: Firestore) => Promise<void>): Promise<void>;
 export declare function withTestDocAndSettings(persistence: boolean, settings: PrivateSettings, fn: (doc: DocumentReference) => Promise<void>): Promise<void>;
 export declare function withTestDocAndInitialData(persistence: boolean, initialData: DocumentData | null, fn: (doc: DocumentReference, db: Firestore) => Promise<void>): Promise<void>;

package/dist/lite/private.d.ts

@@ -856,18 +856,18 @@ declare abstract class Filter {
 export declare class Firestore implements FirestoreService {
     _authCredentials: CredentialsProvider<User>;
     _appCheckCredentials: CredentialsProvider<string>;
+    readonly _databaseId: DatabaseId;
+    readonly _app?: FirebaseApp | undefined;
     /**
      * Whether it's a Firestore or Firestore Lite instance.
      */
     type: 'firestore-lite' | 'firestore';
-    readonly _databaseId: DatabaseId;
     readonly _persistenceKey: string;
     private _settings;
     private _settingsFrozen;
     private _terminateTask?;
-    _app?: FirebaseApp;
     /** @hideconstructor */
-    constructor(databaseIdOrApp: DatabaseId | FirebaseApp, _authCredentials: CredentialsProvider<User>, _appCheckCredentials: CredentialsProvider<string>);
+    constructor(_authCredentials: CredentialsProvider<User>, _appCheckCredentials: CredentialsProvider<string>, _databaseId: DatabaseId, _app?: FirebaseApp | undefined);
     /**
      * The {@link @firebase/app#FirebaseApp} associated with this `Firestore` service
      * instance.
@@ -1432,15 +1432,28 @@ export declare function getDoc<T>(reference: DocumentReference<T>): Promise<Docu
 export declare function getDocs<T>(query: Query<T>): Promise<QuerySnapshot<T>>;
 
 /**
- * Returns the existing `Firestore` instance that is associated with the
+ * Returns the existing default {@link Firestore} instance that is associated with the
+ * default {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @returns The {@link Firestore} instance of the provided app.
+ */
+export declare function getFirestore(): Firestore;
+
+/**
+ * Returns the existing default {@link Firestore} instance that is associated with the
  * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
  * instance with default settings.
  *
- * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned `Firestore`
+ * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
  * instance is associated with.
- * @returns The `Firestore` instance of the provided app.
+ * @returns The {@link Firestore} instance of the provided app.
  */
-export declare function getFirestore(app?: FirebaseApp): Firestore;
+export declare function getFirestore(app: FirebaseApp): Firestore;
+
+/* Excluded declaration from this release type: getFirestore */
+
+/* Excluded declaration from this release type: getFirestore */
 
 /**
  * Returns a special value that can be used with {@link @firebase/firestore/lite#(setDoc:1)} or {@link
@@ -1480,6 +1493,8 @@ declare type IndexState = 'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'ERROR';
  */
 export declare function initializeFirestore(app: FirebaseApp, settings: Settings): Firestore;
 
+/* Excluded declaration from this release type: initializeFirestore */
+
 /**
  * Creates a {@link QueryConstraint} that only returns the first matching documents.
  *

package/dist/packages/firestore/dist/index.esm2017.d.ts

@@ -845,7 +845,19 @@ declare function Da(t: any, e: any, ...n: any[]): Sa;
  * will be included. Cannot contain a slash.
  * @returns The created `Query`.
  */ declare function Ca(t: any, e: any): Va;
-declare function Pa(t: any, e: any, n: any, s?: {}): void;
+/**
+ * Modify this instance to communicate with the Cloud Firestore emulator.
+ *
+ * Note: This must be called before this instance has been used to do any
+ * operations.
+ *
+ * @param firestore - The `Firestore` instance to configure to connect to the
+ * emulator.
+ * @param host - the emulator host (ex: localhost).
+ * @param port - the emulator port (ex: 9000).
+ * @param options.mockUserToken - the mock auth token to use for unit testing
+ * Security Rules.
+ */ declare function Pa(t: any, e: any, n: any, s?: {}): void;
 /**
  * Deletes the document referred to by the specified `DocumentReference`.
  *
@@ -1034,15 +1046,7 @@ declare function dl(t: any): Promise<Oh>;
  *
  * @returns A `Promise` that will be resolved with the results of the query.
  */ declare function pl(t: any): Promise<$h>;
-/**
- * Returns the existing {@link Firestore} instance that is associated with the
- * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
- * instance with default settings.
- *
- * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
- * instance is associated with.
- * @returns The {@link Firestore} instance of the provided app.
- */ declare function Ua(e?: import("@firebase/app").FirebaseApp): import("../src").Firestore;
+declare function Ua(e: any, n: any): import("../src").Firestore;
 /**
  * Returns a special value that can be used with {@link @firebase/firestore/lite#(setDoc:1)} or {@link
  * @firebase/firestore/lite#(updateDoc:1)} that tells the server to increment the field's current value by
@@ -1071,8 +1075,9 @@ declare function dl(t: any): Promise<Oh>;
  * @param app - The {@link @firebase/app#FirebaseApp} with which the {@link Firestore} instance will
  * be associated.
  * @param settings - A settings object to configure the {@link Firestore} instance.
+ * @param databaseId - The name of database.
  * @returns A newly initialized {@link Firestore} instance.
- */ declare function La(t: any, e: any): import("../src").Firestore;
+ */ declare function La(t: any, e: any, n: any): import("../src").Firestore;
 /**
  * Creates a {@link QueryConstraint} that only returns the first matching documents.
  *
@@ -1368,9 +1373,11 @@ declare function Tl(t: any, e: any, n: any, ...s: any[]): Promise<any>;
  * Do not call this constructor directly. Instead, use {@link getFirestore}.
  */ declare class ba {
     /** @hideconstructor */
-    constructor(t: any, e: any, n: any);
+    constructor(t: any, e: any, n: any, s: any);
     _authCredentials: any;
     _appCheckCredentials: any;
+    _databaseId: any;
+    _app: any;
     /**
      * Whether it's a Firestore or Firestore Lite instance.
      */
@@ -1378,8 +1385,6 @@ declare function Tl(t: any, e: any, n: any, ...s: any[]): Promise<any>;
     _persistenceKey: string;
     _settings: Ra;
     _settingsFrozen: boolean;
-    _databaseId: ue;
-    _app: any;
     /**
      * The {@link @firebase/app#FirebaseApp} associated with this `Firestore` service
      * instance.
@@ -1393,7 +1398,7 @@ declare function Tl(t: any, e: any, n: any, ...s: any[]): Promise<any>;
     _terminateTask: Promise<void> | undefined;
     /** Returns a JSON-serializable representation of this `Firestore` instance. */ toJSON(): {
         app: any;
-        databaseId: ue;
+        databaseId: any;
         settings: Ra;
     };
     /**

package/dist/packages/firestore/src/api/database.d.ts

@@ -50,7 +50,7 @@ export declare class Firestore extends LiteFirestore {
     readonly _persistenceKey: string;
     _firestoreClient: FirestoreClient | undefined;
     /** @hideconstructor */
-    constructor(databaseIdOrApp: DatabaseId | FirebaseApp, authCredentialsProvider: CredentialsProvider<User>, appCheckCredentialsProvider: CredentialsProvider<string>);
+    constructor(authCredentialsProvider: CredentialsProvider<User>, appCheckCredentialsProvider: CredentialsProvider<string>, databaseId: DatabaseId, app?: FirebaseApp);
     _terminate(): Promise<void>;
 }
 /**
@@ -62,9 +62,38 @@ export declare class Firestore extends LiteFirestore {
  * @param app - The {@link @firebase/app#FirebaseApp} with which the {@link Firestore} instance will
  * be associated.
  * @param settings - A settings object to configure the {@link Firestore} instance.
+ * @param databaseId - The name of database.
  * @returns A newly initialized {@link Firestore} instance.
  */
-export declare function initializeFirestore(app: FirebaseApp, settings: FirestoreSettings): Firestore;
+export declare function initializeFirestore(app: FirebaseApp, settings: FirestoreSettings, databaseId?: string): Firestore;
+/**
+ * Returns the existing default {@link Firestore} instance that is associated with the
+ * default {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @returns The {@link Firestore} instance of the provided app.
+ */
+export declare function getFirestore(): Firestore;
+/**
+ * Returns the existing default {@link Firestore} instance that is associated with the
+ * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
+ * instance is associated with.
+ * @returns The {@link Firestore} instance of the provided app.
+ */
+export declare function getFirestore(app: FirebaseApp): Firestore;
+/**
+ * Returns the existing {@link Firestore} instance that is associated with the
+ * default {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
+ * instance with default settings.
+ *
+ * @param databaseId - The name of database.
+ * @returns The {@link Firestore} instance of the provided app.
+ * @internal
+ */
+export declare function getFirestore(databaseId: string): Firestore;
 /**
  * Returns the existing {@link Firestore} instance that is associated with the
  * provided {@link @firebase/app#FirebaseApp}. If no instance exists, initializes a new
@@ -72,9 +101,11 @@ export declare function initializeFirestore(app: FirebaseApp, settings: Firestor
  *
  * @param app - The {@link @firebase/app#FirebaseApp} instance that the returned {@link Firestore}
  * instance is associated with.
+ * @param databaseId - The name of database.
  * @returns The {@link Firestore} instance of the provided app.
+ * @internal
  */
-export declare function getFirestore(app?: FirebaseApp): Firestore;
+export declare function getFirestore(app: FirebaseApp, databaseId: string): Firestore;
 /**
  * @internal
  */

package/dist/packages/firestore/src/core/database_info.d.ts

@@ -1,3 +1,4 @@
+import { FirebaseApp } from '@firebase/app';
 /**
  * @license
  * Copyright 2017 Google LLC
@@ -42,6 +43,8 @@ export declare class DatabaseInfo {
      */
     constructor(databaseId: DatabaseId, appId: string, persistenceKey: string, host: string, ssl: boolean, forceLongPolling: boolean, autoDetectLongPolling: boolean, useFetchStreams: boolean);
 }
+/** The default database name for a project. */
+export declare const DEFAULT_DATABASE_NAME = "(default)";
 /**
  * Represents the database ID a Firestore client is associated with.
  * @internal
@@ -54,3 +57,4 @@ export declare class DatabaseId {
     get isDefaultDatabase(): boolean;
     isEqual(other: {}): boolean;
 }
+export declare function databaseIdFromApp(app: FirebaseApp, database?: string): DatabaseId;