@causa/workspace-google 0.1.1 → 0.2.0

package/dist/assets/firebase-auth.json

@@ -0,0 +1,12 @@
+{
+    "emulators": {
+        "auth": {
+            "port": 9099,
+            "host": "0.0.0.0"
+        },
+        "ui": {
+            "enabled": false,
+            "host": "0.0.0.0"
+        }
+    }
+}

package/dist/assets/firebase-storage.json

@@ -0,0 +1,15 @@
+{
+    "emulators": {
+        "storage": {
+            "port": 9199,
+            "host": "0.0.0.0"
+        },
+        "ui": {
+            "enabled": false,
+            "host": "0.0.0.0"
+        }
+    },
+    "storage": {
+        "rules": "storage.rules"
+    }
+}

package/dist/cli/google-app-check.d.ts

@@ -0,0 +1,5 @@
+import { ParentCliCommandDefinition } from '@causa/cli';
+/**
+ * The parent `google appCheck` command.
+ */
+export declare const appCheckCommandDefinition: ParentCliCommandDefinition;

package/dist/cli/google-app-check.js

@@ -0,0 +1,9 @@
+import { googleCommandDefinition } from './google.js';
+/**
+ * The parent `google appCheck` command.
+ */
+export const appCheckCommandDefinition = {
+    parent: googleCommandDefinition,
+    name: 'appCheck',
+    description: 'Performs AppCheck-related operations.',
+};

package/dist/cli/google-identity-platform.d.ts

@@ -0,0 +1,5 @@
+import { ParentCliCommandDefinition } from '@causa/cli';
+/**
+ * The parent `google identityPlatform` command.
+ */
+export declare const identityPlatformCommandDefinition: ParentCliCommandDefinition;

package/dist/cli/google-identity-platform.js

@@ -0,0 +1,9 @@
+import { googleCommandDefinition } from './google.js';
+/**
+ * The parent `google identityPlatform` command.
+ */
+export const identityPlatformCommandDefinition = {
+    parent: googleCommandDefinition,
+    name: 'identityPlatform',
+    description: 'Performs Identity Platform-related operations.',
+};

package/dist/cli/index.d.ts

@@ -1,3 +1,5 @@
+export { appCheckCommandDefinition } from './google-app-check.js';
 export { firebaseStorageCommandDefinition } from './google-firebase-storage.js';
 export { firestoreCommandDefinition } from './google-firestore.js';
+export { identityPlatformCommandDefinition } from './google-identity-platform.js';
 export { googleCommandDefinition } from './google.js';

package/dist/cli/index.js

@@ -1,3 +1,5 @@
+export { appCheckCommandDefinition } from './google-app-check.js';
 export { firebaseStorageCommandDefinition } from './google-firebase-storage.js';
 export { firestoreCommandDefinition } from './google-firestore.js';
+export { identityPlatformCommandDefinition } from './google-identity-platform.js';
 export { googleCommandDefinition } from './google.js';

package/dist/configurations/google.d.ts

@@ -50,21 +50,28 @@ export type GoogleConfiguration = {
              * the API.
              */
             apiKey?: string;
+            /**
+             * The Firebase app ID used by clients.
+             * This can be found in the Firebase Console. Each platform (Android, iOS, Web) has its own app ID.
+             * If this is not set and is needed by an operation, an attempt will be made to find the first eligible app ID
+             * using the Firebase API.
+             */
+            appId?: string;
             /**
              * The domain name for the project.
              * If not set, this default to `<GCP project>.firebaseapp.com`.
              */
             authDomain?: string;
-        };
-        /**
-         * Configuration for Firebase tools (the CLI).
-         * This applies to Dockerized calls to the `firebase` CLI.
-         */
-        firebaseTools?: {
             /**
-             * The version of the CLI to use.
+             * Configuration for Firebase tools (the CLI).
+             * This applies to Dockerized calls to the `firebase` CLI.
              */
-            version?: string;
+            tools?: {
+                /**
+                 * The version of the CLI to use.
+                 */
+                version?: string;
+            };
         };
         /**
          * Configuration for the Secret Manager service.

package/dist/configurations/index.d.ts

@@ -1 +1,2 @@
 export { GoogleConfiguration } from './google.js';
+export * from './utils.js';

package/dist/configurations/index.js

@@ -1 +1 @@
-export {};
+export * from './utils.js';

package/dist/configurations/utils.d.ts

@@ -0,0 +1,10 @@
+import { WorkspaceContext } from '@causa/workspace';
+/**
+ * Gets or formats the ID of the local GCP project.
+ * For some emulators to work correctly, the ID must start with `demo-`.
+ * By default, the name of the workspace is appended to this.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The ID of the local GCP project that should be used with emulators.
+ */
+export declare function getLocalGcpProject(context: WorkspaceContext): string;

package/dist/configurations/utils.js

@@ -0,0 +1,17 @@
+/**
+ * Gets or formats the ID of the local GCP project.
+ * For some emulators to work correctly, the ID must start with `demo-`.
+ * By default, the name of the workspace is appended to this.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The ID of the local GCP project that should be used with emulators.
+ */
+export function getLocalGcpProject(context) {
+    const googleConf = context.asConfiguration();
+    const localProject = googleConf.get('google.localProject');
+    if (localProject) {
+        return localProject;
+    }
+    const workspaceName = googleConf.getOrThrow('workspace.name');
+    return `demo-${workspaceName}`;
+}

package/dist/emulators/firebase-storage.d.ts

@@ -0,0 +1,20 @@
+import { WorkspaceContext } from '@causa/workspace';
+/**
+ * The name of the Firebase Storage emulator.
+ */
+export declare const FIREBASE_STORAGE_EMULATOR_NAME = "google.firebaseStorage";
+/**
+ * Gets the name of the Firebase Storage emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Firebase Storage emulator Docker container.
+ */
+export declare function getFirebaseStorageContainerName(context: WorkspaceContext): string;
+/**
+ * The exposed port for Firebase Storage.
+ */
+export declare const FIREBASE_STORAGE_PORT = 9199;
+/**
+ * The location of the Firebase Storage security rules file within the container.
+ */
+export declare const FIREBASE_CONTAINER_STORAGE_RULES_FILE = "/home/node/storage.rules";

package/dist/emulators/firebase-storage.js

@@ -0,0 +1,27 @@
+/**
+ * The name of the Firebase Storage emulator.
+ */
+export const FIREBASE_STORAGE_EMULATOR_NAME = 'google.firebaseStorage';
+/**
+ * Gets the name of the Firebase Storage emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Firebase Storage emulator Docker container.
+ */
+export function getFirebaseStorageContainerName(context) {
+    const googleConf = context.asConfiguration();
+    const containerName = googleConf.get('google.firebaseStorage.emulator.containerName');
+    if (containerName) {
+        return containerName;
+    }
+    const workspaceName = googleConf.getOrThrow('workspace.name');
+    return `${workspaceName}-firebase-storage`;
+}
+/**
+ * The exposed port for Firebase Storage.
+ */
+export const FIREBASE_STORAGE_PORT = 9199;
+/**
+ * The location of the Firebase Storage security rules file within the container.
+ */
+export const FIREBASE_CONTAINER_STORAGE_RULES_FILE = '/home/node/storage.rules';

package/dist/emulators/firestore.d.ts

@@ -0,0 +1,20 @@
+import { WorkspaceContext } from '@causa/workspace';
+/**
+ * The name of the Firestore emulator.
+ */
+export declare const FIRESTORE_EMULATOR_NAME = "google.firestore";
+/**
+ * Gets the name of the Firestore emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Firestore emulator Docker container.
+ */
+export declare function getFirestoreContainerName(context: WorkspaceContext): string;
+/**
+ * The path to the Firestore security rules file within the container.
+ */
+export declare const FIRESTORE_CONTAINER_RULES_FILE = "/firestore.rules";
+/**
+ * The port on which the Firestore emulator listens.
+ */
+export declare const FIRESTORE_PORT = 8080;

package/dist/emulators/firestore.js

@@ -0,0 +1,27 @@
+/**
+ * The name of the Firestore emulator.
+ */
+export const FIRESTORE_EMULATOR_NAME = 'google.firestore';
+/**
+ * Gets the name of the Firestore emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Firestore emulator Docker container.
+ */
+export function getFirestoreContainerName(context) {
+    const googleConf = context.asConfiguration();
+    const containerName = googleConf.get('google.firestore.emulator.containerName');
+    if (containerName) {
+        return containerName;
+    }
+    const workspaceName = googleConf.getOrThrow('workspace.name');
+    return `${workspaceName}-firestore`;
+}
+/**
+ * The path to the Firestore security rules file within the container.
+ */
+export const FIRESTORE_CONTAINER_RULES_FILE = '/firestore.rules';
+/**
+ * The port on which the Firestore emulator listens.
+ */
+export const FIRESTORE_PORT = 8080;

package/dist/emulators/identity-platform.d.ts

@@ -0,0 +1,16 @@
+import { WorkspaceContext } from '@causa/workspace';
+/**
+ * The name of the Identity Platform emulator.
+ */
+export declare const IDENTITY_PLATFORM_EMULATOR_NAME = "google.identityPlatform";
+/**
+ * Gets the name of the Identity Platform emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Identity Platform emulator Docker container.
+ */
+export declare function getIdentityPlatformContainerName(context: WorkspaceContext): string;
+/**
+ * The port on which the Firebase Auth emulator is listening.
+ */
+export declare const FIREBASE_AUTH_PORT = 9099;

package/dist/emulators/identity-platform.js

@@ -0,0 +1,23 @@
+/**
+ * The name of the Identity Platform emulator.
+ */
+export const IDENTITY_PLATFORM_EMULATOR_NAME = 'google.identityPlatform';
+/**
+ * Gets the name of the Identity Platform emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Identity Platform emulator Docker container.
+ */
+export function getIdentityPlatformContainerName(context) {
+    const googleConf = context.asConfiguration();
+    const containerName = googleConf.get('google.identityPlatform.emulator.containerName');
+    if (containerName) {
+        return containerName;
+    }
+    const workspaceName = googleConf.getOrThrow('workspace.name');
+    return `${workspaceName}-identity-platform`;
+}
+/**
+ * The port on which the Firebase Auth emulator is listening.
+ */
+export const FIREBASE_AUTH_PORT = 9099;

package/dist/emulators/index.d.ts

@@ -0,0 +1,5 @@
+export * from './firebase-storage.js';
+export * from './firestore.js';
+export * from './identity-platform.js';
+export * from './pubsub.js';
+export * from './spanner.js';

package/dist/emulators/index.js

@@ -0,0 +1,5 @@
+export * from './firebase-storage.js';
+export * from './firestore.js';
+export * from './identity-platform.js';
+export * from './pubsub.js';
+export * from './spanner.js';

package/dist/emulators/pubsub.d.ts

@@ -0,0 +1,25 @@
+import { WorkspaceContext } from '@causa/workspace';
+/**
+ * The name of the Pub/Sub emulator.
+ */
+export declare const PUBSUB_EMULATOR_NAME = "google.pubSub";
+/**
+ * Gets the name of the Pub/Sub emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Pub/Sub emulator Docker container.
+ */
+export declare function getPubSubContainerName(context: WorkspaceContext): string;
+/**
+ * The port on which the Pub/Sub emulator is listening.
+ */
+export declare const PUBSUB_PORT = 8085;
+/**
+ * Formats the name of a Pub/Sub topic as an environment variable.
+ * The value of the corresponding environment variable is expected to be the Pub/Sub topic ID, e.g.
+ * `projects/my-project/topics/my-topic`.
+ *
+ * @param topicId The ID of the event topic.
+ * @returns The name of the environment variable that should be used to configure the Pub/Sub topic.
+ */
+export declare function formatPubSubTopicAsEnvironmentVariable(topicId: string): string;

package/dist/emulators/pubsub.js

@@ -0,0 +1,35 @@
+/**
+ * The name of the Pub/Sub emulator.
+ */
+export const PUBSUB_EMULATOR_NAME = 'google.pubSub';
+/**
+ * Gets the name of the Pub/Sub emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Pub/Sub emulator Docker container.
+ */
+export function getPubSubContainerName(context) {
+    const googleConf = context.asConfiguration();
+    const containerName = googleConf.get('google.pubSub.emulator.containerName');
+    if (containerName) {
+        return containerName;
+    }
+    const workspaceName = googleConf.getOrThrow('workspace.name');
+    return `${workspaceName}-pubsub`;
+}
+/**
+ * The port on which the Pub/Sub emulator is listening.
+ */
+export const PUBSUB_PORT = 8085;
+/**
+ * Formats the name of a Pub/Sub topic as an environment variable.
+ * The value of the corresponding environment variable is expected to be the Pub/Sub topic ID, e.g.
+ * `projects/my-project/topics/my-topic`.
+ *
+ * @param topicId The ID of the event topic.
+ * @returns The name of the environment variable that should be used to configure the Pub/Sub topic.
+ */
+export function formatPubSubTopicAsEnvironmentVariable(topicId) {
+    const formattedTopicName = topicId.toUpperCase().replace(/[-\.]/g, '_');
+    return `PUBSUB_TOPIC_${formattedTopicName}`;
+}

package/dist/emulators/spanner.d.ts

@@ -0,0 +1,24 @@
+import { WorkspaceContext } from '@causa/workspace';
+/**
+ * The name of the Spanner emulator.
+ */
+export declare const SPANNER_EMULATOR_NAME = "google.spanner";
+/**
+ * Gets the name of the Spanner emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Spanner emulator Docker container.
+ */
+export declare function getSpannerContainerName(context: WorkspaceContext): string;
+/**
+ * The Docker image containing the emulator.
+ */
+export declare const SPANNER_IMAGE = "gcr.io/cloud-spanner-emulator/emulator";
+/**
+ * The port on which the Spanner emulator exposes its gRPC API.
+ */
+export declare const SPANNER_GRPC_PORT = 9010;
+/**
+ * The port on which the Spanner emulator exposes its HTTP API.
+ */
+export declare const SPANNER_HTTP_PORT = 9020;

package/dist/emulators/spanner.js

@@ -0,0 +1,31 @@
+/**
+ * The name of the Spanner emulator.
+ */
+export const SPANNER_EMULATOR_NAME = 'google.spanner';
+/**
+ * Gets the name of the Spanner emulator Docker container from the configuration.
+ *
+ * @param context The {@link WorkspaceContext}.
+ * @returns The name of the Spanner emulator Docker container.
+ */
+export function getSpannerContainerName(context) {
+    const googleConf = context.asConfiguration();
+    const containerName = googleConf.get('google.spanner.emulator.containerName');
+    if (containerName) {
+        return containerName;
+    }
+    const workspaceName = googleConf.getOrThrow('workspace.name');
+    return `${workspaceName}-spanner`;
+}
+/**
+ * The Docker image containing the emulator.
+ */
+export const SPANNER_IMAGE = `gcr.io/cloud-spanner-emulator/emulator`;
+/**
+ * The port on which the Spanner emulator exposes its gRPC API.
+ */
+export const SPANNER_GRPC_PORT = 9010;
+/**
+ * The port on which the Spanner emulator exposes its HTTP API.
+ */
+export const SPANNER_HTTP_PORT = 9020;

package/dist/functions/emulator-start-firebase-storage.d.ts

@@ -0,0 +1,17 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStart, EmulatorStartResult } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStart} for the Firebase Storage container.
+ * This first merges the Firebase Storage security rules into a single file, and uses this file to configure the
+ * emulator.
+ */
+export declare class EmulatorStartForFirebaseStorage extends EmulatorStart {
+    _call(context: WorkspaceContext): Promise<EmulatorStartResult>;
+    _supports(): boolean;
+    /**
+     * Merges the Firebase Storage security rules into a single file, and starts the Firebase Storage emulator using them.
+     *
+     * @param context The {@link WorkspaceContext}.
+     */
+    private startFirebaseStorage;
+}

package/dist/functions/emulator-start-firebase-storage.js

@@ -0,0 +1,64 @@
+import { EmulatorStart } from '@causa/workspace-core';
+import { fileURLToPath } from 'url';
+import { FIREBASE_CONTAINER_STORAGE_RULES_FILE, FIREBASE_STORAGE_EMULATOR_NAME, FIREBASE_STORAGE_PORT, getFirebaseStorageContainerName, } from '../emulators/index.js';
+import { FirebaseEmulatorService } from '../services/index.js';
+import { GoogleFirebaseStorageMergeRules } from './google-firebase-storage-merge-rules.js';
+/**
+ * The Firebase configuration file enabling only the Storage emulator.
+ */
+const FIREBASE_CONF_FILE = fileURLToPath(new URL('../assets/firebase-storage.json', import.meta.url));
+/**
+ * Implements {@link EmulatorStart} for the Firebase Storage container.
+ * This first merges the Firebase Storage security rules into a single file, and uses this file to configure the
+ * emulator.
+ */
+export class EmulatorStartForFirebaseStorage extends EmulatorStart {
+    async _call(context) {
+        const configuration = await this.startFirebaseStorage(context);
+        return { name: FIREBASE_STORAGE_EMULATOR_NAME, configuration };
+    }
+    _supports() {
+        return (this.name === undefined || this.name === FIREBASE_STORAGE_EMULATOR_NAME);
+    }
+    /**
+     * Merges the Firebase Storage security rules into a single file, and starts the Firebase Storage emulator using them.
+     *
+     * @param context The {@link WorkspaceContext}.
+     */
+    async startFirebaseStorage(context) {
+        if (this.dryRun) {
+            return {};
+        }
+        const { securityRuleFile } = await context.call(GoogleFirebaseStorageMergeRules, {});
+        context.logger.info('️🍱 Starting Firebase Storage emulator.');
+        const containerName = getFirebaseStorageContainerName(context);
+        const firebaseEmulatorService = context.service(FirebaseEmulatorService);
+        await firebaseEmulatorService.start(containerName, FIREBASE_CONF_FILE, [
+            {
+                host: '127.0.0.1',
+                container: FIREBASE_STORAGE_PORT,
+                local: FIREBASE_STORAGE_PORT,
+            },
+        ], {
+            mounts: [
+                {
+                    type: 'bind',
+                    source: securityRuleFile ?? '',
+                    destination: FIREBASE_CONTAINER_STORAGE_RULES_FILE,
+                    readonly: true,
+                },
+            ],
+            // The Firebase Storage emulator returns "not implemented" when a request to the root is made.
+            expectedStatus: 501,
+        });
+        context.logger.info('️🍱 Successfully initialized Firebase Storage emulator.');
+        return {
+            FIREBASE_STORAGE_EMULATOR_HOST: `127.0.0.1:${FIREBASE_STORAGE_PORT}`,
+            GOOGLE_CLOUD_PROJECT: firebaseEmulatorService.localGcpProject,
+            GCP_PROJECT: firebaseEmulatorService.localGcpProject,
+            GCLOUD_PROJECT: firebaseEmulatorService.localGcpProject,
+            FIREBASE_STORAGE_BUCKET_NAME: `${firebaseEmulatorService.localGcpProject}.appspot.com`,
+            FIREBASE_CONFIG: '{}',
+        };
+    }
+}

package/dist/functions/emulator-start-firestore.d.ts

@@ -0,0 +1,17 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStart, EmulatorStartResult } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStart} for the Firestore emulator.
+ * This first merges the Firestore security rules into a single file, and uses this file to configure the emulator.
+ */
+export declare class EmulatorStartForFirestore extends EmulatorStart {
+    _call(context: WorkspaceContext): Promise<EmulatorStartResult>;
+    _supports(): boolean;
+    /**
+     * Merges the Firestore security rules into a single file, and starts the Firestore emulator using them.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the Firestore emulator.
+     */
+    private startFirestore;
+}

package/dist/functions/emulator-start-firestore.js

@@ -0,0 +1,58 @@
+import { EmulatorStart } from '@causa/workspace-core';
+import { FIRESTORE_CONTAINER_RULES_FILE, FIRESTORE_EMULATOR_NAME, FIRESTORE_PORT, getFirestoreContainerName, } from '../emulators/index.js';
+import { GcloudEmulatorService } from '../index.js';
+import { GoogleFirestoreMergeRules } from './google-firestore-merge-rules.js';
+/**
+ * Implements {@link EmulatorStart} for the Firestore emulator.
+ * This first merges the Firestore security rules into a single file, and uses this file to configure the emulator.
+ */
+export class EmulatorStartForFirestore extends EmulatorStart {
+    async _call(context) {
+        const configuration = await this.startFirestore(context);
+        return { name: FIRESTORE_EMULATOR_NAME, configuration };
+    }
+    _supports() {
+        return this.name === undefined || this.name === FIRESTORE_EMULATOR_NAME;
+    }
+    /**
+     * Merges the Firestore security rules into a single file, and starts the Firestore emulator using them.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the Firestore emulator.
+     */
+    async startFirestore(context) {
+        if (this.dryRun) {
+            return {};
+        }
+        const { securityRuleFile } = await context.call(GoogleFirestoreMergeRules, {});
+        context.logger.info('🗃️ Starting Firestore emulator.');
+        const containerName = getFirestoreContainerName(context);
+        const gcloudEmulatorService = context.service(GcloudEmulatorService);
+        await gcloudEmulatorService.start('firestore', containerName, [
+            {
+                host: '127.0.0.1',
+                local: FIRESTORE_PORT,
+                container: FIRESTORE_PORT,
+            },
+        ], {
+            mounts: [
+                {
+                    type: 'bind',
+                    source: securityRuleFile ?? '',
+                    destination: FIRESTORE_CONTAINER_RULES_FILE,
+                    readonly: true,
+                },
+            ],
+            additionalArguments: ['--rules', FIRESTORE_CONTAINER_RULES_FILE],
+            availabilityEndpoint: `http://127.0.0.1:${FIRESTORE_PORT}/`,
+        });
+        context.logger.info('🗃️ Successfully initialized Firestore emulator.');
+        return {
+            FIRESTORE_EMULATOR_HOST: `127.0.0.1:${FIRESTORE_PORT}`,
+            GOOGLE_CLOUD_PROJECT: gcloudEmulatorService.localGcpProject,
+            GCP_PROJECT: gcloudEmulatorService.localGcpProject,
+            GCLOUD_PROJECT: gcloudEmulatorService.localGcpProject,
+            FIREBASE_CONFIG: '{}',
+        };
+    }
+}

package/dist/functions/emulator-start-identity-platform.d.ts

@@ -0,0 +1,16 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStart, EmulatorStartResult } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStart} for the Identity Platform emulator.
+ * This actually runs the "legacy" Firebase Auth emulator, which is the same service before it was re-branded.
+ */
+export declare class EmulatorStartForIdentityPlatform extends EmulatorStart {
+    _call(context: WorkspaceContext): Promise<EmulatorStartResult>;
+    _supports(): boolean;
+    /**
+     * Starts the Identity Platform (Firebase Auth) emulator.
+     *
+     * @param context The {@link WorkspaceContext}.
+     */
+    private startIdentityPlatform;
+}

package/dist/functions/emulator-start-identity-platform.js

@@ -0,0 +1,49 @@
+import { EmulatorStart } from '@causa/workspace-core';
+import { fileURLToPath } from 'url';
+import { FIREBASE_AUTH_PORT, IDENTITY_PLATFORM_EMULATOR_NAME, getIdentityPlatformContainerName, } from '../emulators/index.js';
+import { FirebaseEmulatorService } from '../services/index.js';
+/**
+ * The Firebase configuration file enabling only the Auth emulator.
+ */
+const FIREBASE_CONF_FILE = fileURLToPath(new URL('../assets/firebase-auth.json', import.meta.url));
+/**
+ * Implements {@link EmulatorStart} for the Identity Platform emulator.
+ * This actually runs the "legacy" Firebase Auth emulator, which is the same service before it was re-branded.
+ */
+export class EmulatorStartForIdentityPlatform extends EmulatorStart {
+    async _call(context) {
+        const configuration = await this.startIdentityPlatform(context);
+        return { name: IDENTITY_PLATFORM_EMULATOR_NAME, configuration };
+    }
+    _supports() {
+        return (this.name === undefined || this.name === IDENTITY_PLATFORM_EMULATOR_NAME);
+    }
+    /**
+     * Starts the Identity Platform (Firebase Auth) emulator.
+     *
+     * @param context The {@link WorkspaceContext}.
+     */
+    async startIdentityPlatform(context) {
+        if (this.dryRun) {
+            return {};
+        }
+        context.logger.info('🛂 Starting the Identity Platform emulator.');
+        const containerName = getIdentityPlatformContainerName(context);
+        const firebaseEmulatorService = context.service(FirebaseEmulatorService);
+        await firebaseEmulatorService.start(containerName, FIREBASE_CONF_FILE, [
+            {
+                host: '127.0.0.1',
+                local: FIREBASE_AUTH_PORT,
+                container: FIREBASE_AUTH_PORT,
+            },
+        ]);
+        context.logger.info('🛂 Successfully initialized the Identity Platform emulator.');
+        return {
+            FIREBASE_AUTH_EMULATOR_HOST: `127.0.0.1:${FIREBASE_AUTH_PORT}`,
+            GOOGLE_CLOUD_PROJECT: firebaseEmulatorService.localGcpProject,
+            GCP_PROJECT: firebaseEmulatorService.localGcpProject,
+            GCLOUD_PROJECT: firebaseEmulatorService.localGcpProject,
+            FIREBASE_CONFIG: '{}',
+        };
+    }
+}