Merge remote-tracking branch 'origin/main' into SimpleDbExtendedDebugLogging

Author: dconeybe

.changeset/thin-bikes-tan.md

@@ -0,0 +1,6 @@
+---
+'@firebase/app': minor
+'firebase': minor
+---
+
+initializeServerApp now supports auto-initialization for Firebase App Hosting.

common/api-review/app.api.md

@@ -110,14 +110,20 @@ export function initializeApp(options: FirebaseOptions, config?: FirebaseAppSett
 export function initializeApp(): FirebaseApp;
 
 // @public
-export function initializeServerApp(options: FirebaseOptions | FirebaseApp, config: FirebaseServerAppSettings): FirebaseServerApp;
+export function initializeServerApp(options: FirebaseOptions | FirebaseApp, config?: FirebaseServerAppSettings): FirebaseServerApp;
+
+// @public
+export function initializeServerApp(config?: FirebaseServerAppSettings): FirebaseServerApp;
 
 // @internal (undocumented)
-export function _isFirebaseApp(obj: FirebaseApp | FirebaseOptions): obj is FirebaseApp;
+export function _isFirebaseApp(obj: FirebaseApp | FirebaseOptions | FirebaseAppSettings): obj is FirebaseApp;
 
 // @internal (undocumented)
 export function _isFirebaseServerApp(obj: FirebaseApp | FirebaseServerApp | null | undefined): obj is FirebaseServerApp;
 
+// @internal (undocumented)
+export function _isFirebaseServerAppSettings(obj: FirebaseApp | FirebaseOptions | FirebaseAppSettings): obj is FirebaseServerAppSettings;
+
 // @public
 export function onLog(logCallback: LogCallback | null, options?: LogOptions): void;
 

config/.eslintrc.js

@@ -31,7 +31,7 @@ module.exports = {
     'unused-imports'
   ],
   'parserOptions': {
-    'ecmaVersion': 2017,
+    'ecmaVersion': 2020,
     'sourceType': 'module'
   },
   'overrides': [

config/tsconfig.base.json

@@ -6,15 +6,15 @@
     "strict": true,
     "lib": [
       "dom",
-      "es2017",
+      "es2020",
       "esnext.WeakRef",
     ],
     "module": "ES2015",
     "moduleResolution": "node",
     "resolveJsonModule": true,
     "esModuleInterop": true,
     "sourceMap": true,
-    "target": "es2017",
+    "target": "es2020",
     "typeRoots": [
       "../node_modules/@types"
     ],

config/webpack.test.js

@@ -44,7 +44,7 @@ module.exports = {
           options: {
             compilerOptions: {
               module: 'commonjs',
-              target: 'es2017',
+              target: 'es2020',
               downlevelIteration: true,
               resolveJsonModule: true
             }
@@ -56,15 +56,6 @@ module.exports = {
         use: 'source-map-loader',
         enforce: 'pre'
       },
-      {
-        test: /\.tsx?$/,
-        use: {
-          loader: 'istanbul-instrumenter-loader',
-          options: { esModules: true }
-        },
-        enforce: 'post',
-        exclude: [/\.test\.ts$/, /\btest(ing)?\//]
-      },
       {
         test: /\.js$/,
         include: [/node_modules\/chai-as-promised/],

docs-devsite/app.md

@@ -23,6 +23,8 @@ This package coordinates the communication between the different Firebase compon
 |  <b>function()</b> |
 |  [getApps()](./app.md#getapps) | A (read-only) array of all initialized apps. |
 |  [initializeApp()](./app.md#initializeapp) | Creates and initializes a FirebaseApp instance. |
+|  <b>function(config, ...)</b> |
+|  [initializeServerApp(config)](./app.md#initializeserverapp_e7d0728) | Creates and initializes a [FirebaseServerApp](./app.firebaseserverapp.md#firebaseserverapp_interface) instance. |
 |  <b>function(libraryKeyOrName, ...)</b> |
 |  [registerVersion(libraryKeyOrName, version, variant)](./app.md#registerversion_f673248) | Registers a library's name and version for platform logging purposes. |
 |  <b>function(logCallback, ...)</b> |
@@ -116,6 +118,38 @@ export declare function initializeApp(): FirebaseApp;
 
 [FirebaseApp](./app.firebaseapp.md#firebaseapp_interface)
 
+## function(config, ...)
+
+### initializeServerApp(config) {:#initializeserverapp_e7d0728}
+
+Creates and initializes a [FirebaseServerApp](./app.firebaseserverapp.md#firebaseserverapp_interface) instance.
+
+<b>Signature:</b>
+
+```typescript
+export declare function initializeServerApp(config?: FirebaseServerAppSettings): FirebaseServerApp;
+```
+
+#### Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  config | [FirebaseServerAppSettings](./app.firebaseserverappsettings.md#firebaseserverappsettings_interface) | Optional <code>FirebaseServerApp</code> settings. |
+
+<b>Returns:</b>
+
+[FirebaseServerApp](./app.firebaseserverapp.md#firebaseserverapp_interface)
+
+The initialized `FirebaseServerApp`<!-- -->.
+
+#### Exceptions
+
+If invoked in an unsupported non-server environment such as a browser.
+
+If [FirebaseServerAppSettings.releaseOnDeref](./app.firebaseserverappsettings.md#firebaseserverappsettingsreleaseonderef) is defined but the runtime doesn't provide Finalization Registry support.
+
+If the `FIREBASE_OPTIONS` enviornment variable does not contain a valid project configuration required for auto-initialization.
+
 ## function(libraryKeyOrName, ...)
 
 ### registerVersion(libraryKeyOrName, version, variant) {:#registerversion_f673248}
@@ -260,6 +294,12 @@ export declare function initializeApp(options: FirebaseOptions, name?: string):
 
 The initialized app.
 
+#### Exceptions
+
+If the optional `name` parameter is malformed or empty.
+
+If a `FirebaseApp` already exists with the same name but with a different configuration.
+
 ### Example 1
 
 
@@ -312,6 +352,12 @@ export declare function initializeApp(options: FirebaseOptions, config?: Firebas
 
 [FirebaseApp](./app.firebaseapp.md#firebaseapp_interface)
 
+#### Exceptions
+
+If [FirebaseAppSettings.name](./app.firebaseappsettings.md#firebaseappsettingsname) is defined but the value is malformed or empty.
+
+If a `FirebaseApp` already exists with the same name but with a different configuration.
+
 ### initializeServerApp(options, config) {:#initializeserverapp_30ab697}
 
 Creates and initializes a [FirebaseServerApp](./app.firebaseserverapp.md#firebaseserverapp_interface) instance.
@@ -323,22 +369,28 @@ See [Add Firebase to your app](https://firebase.google.com/docs/web/setup#add_fi
 <b>Signature:</b>
 
 ```typescript
-export declare function initializeServerApp(options: FirebaseOptions | FirebaseApp, config: FirebaseServerAppSettings): FirebaseServerApp;
+export declare function initializeServerApp(options: FirebaseOptions | FirebaseApp, config?: FirebaseServerAppSettings): FirebaseServerApp;
 ```
 
 #### Parameters
 
 |  Parameter | Type | Description |
 |  --- | --- | --- |
 |  options | [FirebaseOptions](./app.firebaseoptions.md#firebaseoptions_interface) \| [FirebaseApp](./app.firebaseapp.md#firebaseapp_interface) | <code>Firebase.AppOptions</code> to configure the app's services, or a a <code>FirebaseApp</code> instance which contains the <code>AppOptions</code> within. |
-|  config | [FirebaseServerAppSettings](./app.firebaseserverappsettings.md#firebaseserverappsettings_interface) | <code>FirebaseServerApp</code> configuration. |
+|  config | [FirebaseServerAppSettings](./app.firebaseserverappsettings.md#firebaseserverappsettings_interface) | Optional <code>FirebaseServerApp</code> settings. |
 
 <b>Returns:</b>
 
 [FirebaseServerApp](./app.firebaseserverapp.md#firebaseserverapp_interface)
 
 The initialized `FirebaseServerApp`<!-- -->.
 
+#### Exceptions
+
+If invoked in an unsupported non-server environment such as a browser.
+
+If [FirebaseServerAppSettings.releaseOnDeref](./app.firebaseserverappsettings.md#firebaseserverappsettingsreleaseonderef) is defined but the runtime doesn't provide Finalization Registry support.
+
 ### Example
 
 

integration/compat-interop/tsconfig.json

@@ -8,7 +8,7 @@
     "moduleResolution": "node",
     "noImplicitAny": true,
     "outDir": "dist",
-    "target": "es2017",
+    "target": "es2020",
     "sourceMap": true,
     "esModuleInterop": true
   },

package.json

@@ -111,7 +111,6 @@
     "http-server": "14.1.1",
     "indexeddbshim": "10.1.0",
     "inquirer": "8.2.6",
-    "istanbul-instrumenter-loader": "3.0.1",
     "js-yaml": "4.1.0",
     "karma": "6.4.4",
     "karma-chrome-launcher": "3.2.0",

packages/ai/package.json

@@ -7,8 +7,8 @@
     "node": ">=18.0.0"
   },
   "main": "dist/index.cjs.js",
-  "browser": "dist/esm/index.esm2017.js",
-  "module": "dist/esm/index.esm2017.js",
+  "browser": "dist/esm/index.esm.js",
+  "module": "dist/esm/index.esm.js",
   "exports": {
     ".": {
       "types": "./dist/ai-public.d.ts",
@@ -18,9 +18,9 @@
       },
       "browser": {
         "require": "./dist/index.cjs.js",
-        "import": "./dist/esm/index.esm2017.js"
+        "import": "./dist/esm/index.esm.js"
       },
-      "default": "./dist/esm/index.esm2017.js"
+      "default": "./dist/esm/index.esm.js"
     },
     "./package.json": "./package.json"
   },

packages/ai/rollup.config.js

@@ -39,7 +39,7 @@ const buildPlugins = [
         'integration'
       ],
       compilerOptions: {
-        target: 'es2017'
+        target: 'es2020'
       }
     }
   }),
@@ -57,7 +57,7 @@ const browserBuilds = [
     plugins: [
       ...buildPlugins,
       replace({
-        ...generateBuildTargetReplaceConfig('esm', 2017),
+        ...generateBuildTargetReplaceConfig('esm', 2020),
         __PACKAGE_VERSION__: pkg.version
       }),
       emitModulePackageFile()
@@ -74,7 +74,7 @@ const browserBuilds = [
     plugins: [
       ...buildPlugins,
       replace({
-        ...generateBuildTargetReplaceConfig('cjs', 2017),
+        ...generateBuildTargetReplaceConfig('cjs', 2020),
         __PACKAGE_VERSION__: pkg.version
       })
     ],
@@ -93,7 +93,7 @@ const nodeBuilds = [
     plugins: [
       ...buildPlugins,
       replace({
-        ...generateBuildTargetReplaceConfig('esm', 2017)
+        ...generateBuildTargetReplaceConfig('esm', 2020)
       })
     ],
     external: id => deps.some(dep => id === dep || id.startsWith(`${dep}/`))
@@ -108,7 +108,7 @@ const nodeBuilds = [
     plugins: [
       ...buildPlugins,
       replace({
-        ...generateBuildTargetReplaceConfig('cjs', 2017)
+        ...generateBuildTargetReplaceConfig('cjs', 2020)
       })
     ],
     external: id => deps.some(dep => id === dep || id.startsWith(`${dep}/`))