@causa/workspace-google 0.1.1 → 0.3.0

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

@@ -0,0 +1,33 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStart, EmulatorStartResult } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStart} for the Pub/Sub emulator.
+ * This first starts the Pub/Sub emulator, and then creates the topics defined in the workspace (if the workspace is
+ * configured with Pub/Sub as its event broker).
+ */
+export declare class EmulatorStartForPubSub extends EmulatorStart {
+    _call(context: WorkspaceContext): Promise<EmulatorStartResult>;
+    _supports(): boolean;
+    /**
+     * Starts the Pub/Sub emulator and creates the topics defined in the workspace.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the emulator and the local Pub/Sub topics.
+     */
+    private startPubSub;
+    /**
+     * Starts the Pub/Sub emulator.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the Pub/Sub emulator.
+     */
+    private startPubSubEmulator;
+    /**
+     * Creates the Pub/Sub topics corresponding to the event topics defined in the workspace.
+     * This is only performed if Pub/Sub is defined as the broker for the workspace.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration listing the local Pub/Sub topics.
+     */
+    private createTopicsIfNeeded;
+}

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

@@ -0,0 +1,86 @@
+import { EmulatorStart, EventTopicList, } from '@causa/workspace-core';
+import { PubSub } from '@google-cloud/pubsub';
+import { getLocalGcpProject } from '../configurations/utils.js';
+import { PUBSUB_EMULATOR_NAME, PUBSUB_PORT, formatPubSubTopicAsEnvironmentVariable, getPubSubContainerName, } from '../emulators/index.js';
+import { GcloudEmulatorService } from '../index.js';
+/**
+ * Implements {@link EmulatorStart} for the Pub/Sub emulator.
+ * This first starts the Pub/Sub emulator, and then creates the topics defined in the workspace (if the workspace is
+ * configured with Pub/Sub as its event broker).
+ */
+export class EmulatorStartForPubSub extends EmulatorStart {
+    async _call(context) {
+        const configuration = await this.startPubSub(context);
+        return { name: PUBSUB_EMULATOR_NAME, configuration };
+    }
+    _supports() {
+        return this.name === undefined || this.name === PUBSUB_EMULATOR_NAME;
+    }
+    /**
+     * Starts the Pub/Sub emulator and creates the topics defined in the workspace.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the emulator and the local Pub/Sub topics.
+     */
+    async startPubSub(context) {
+        if (this.dryRun) {
+            return {};
+        }
+        const emulatorConf = await this.startPubSubEmulator(context);
+        const topicsConf = await this.createTopicsIfNeeded(context);
+        context.logger.info('📫 Successfully initialized Pub/Sub emulator.');
+        return { ...emulatorConf, ...topicsConf };
+    }
+    /**
+     * Starts the Pub/Sub emulator.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the Pub/Sub emulator.
+     */
+    async startPubSubEmulator(context) {
+        context.logger.info('📫 Starting Pub/Sub emulator.');
+        const gcpProject = getLocalGcpProject(context);
+        const containerName = getPubSubContainerName(context);
+        const gcloudEmulatorService = context.service(GcloudEmulatorService);
+        await gcloudEmulatorService.start('pubsub', containerName, [{ host: '127.0.0.1', local: PUBSUB_PORT, container: PUBSUB_PORT }], {
+            availabilityEndpoint: `http://127.0.0.1:${PUBSUB_PORT}/v1/projects/${gcpProject}/topics`,
+        });
+        return {
+            PUBSUB_EMULATOR_HOST: `127.0.0.1:${PUBSUB_PORT}`,
+            GOOGLE_CLOUD_PROJECT: gcloudEmulatorService.localGcpProject,
+            GCP_PROJECT: gcloudEmulatorService.localGcpProject,
+            GCLOUD_PROJECT: gcloudEmulatorService.localGcpProject,
+        };
+    }
+    /**
+     * Creates the Pub/Sub topics corresponding to the event topics defined in the workspace.
+     * This is only performed if Pub/Sub is defined as the broker for the workspace.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration listing the local Pub/Sub topics.
+     */
+    async createTopicsIfNeeded(context) {
+        if (context.get('events.broker') !== 'google.pubSub') {
+            context.logger.warn('📫️ Pub/Sub is not set as the event broker. Skipping event topics setup.');
+            return {};
+        }
+        const topics = await context.call(EventTopicList, {});
+        const gcpProject = getLocalGcpProject(context);
+        const pubSub = new PubSub({
+            projectId: gcpProject,
+            apiEndpoint: `127.0.0.1:${PUBSUB_PORT}`,
+        });
+        const envVars = await Promise.all(topics.map(async ({ id }) => {
+            context.logger.info(`📫 Creating Pub/Sub emulator topic '${id}'.`);
+            const [topic] = await pubSub.topic(id).create();
+            return {
+                envVar: formatPubSubTopicAsEnvironmentVariable(id),
+                pubSubTopic: topic.name,
+            };
+        }));
+        return envVars.reduce((vars, { envVar, pubSubTopic }) => {
+            vars[envVar] = pubSubTopic;
+            return vars;
+        }, {});
+    }
+}

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

@@ -0,0 +1,40 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStart, EmulatorStartResult } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStart} for the Spanner emulator.
+ * This starts the emulator, creates a local instance, and creates the databases using the DDLs found in the workspace.
+ */
+export declare class EmulatorStartForSpanner extends EmulatorStart {
+    _call(context: WorkspaceContext): Promise<EmulatorStartResult>;
+    _supports(): boolean;
+    /**
+     * Starts the Spanner emulator, and creates the instance and databases within it.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the emulator, instance and databases.
+     */
+    private startSpanner;
+    /**
+     * Starts the Spanner emulator.
+     * The emulator is defined in a separate Docker image, not part of the `gcloud` CLI emulators.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the Spanner emulator.
+     */
+    private startSpannerEmulator;
+    /**
+     * Creates a local instance within the Spanner emulator.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The created Spanner {@link Instance} and the corresponding client configuration.
+     */
+    private createInstance;
+    /**
+     * Creates the Spanner databases within the given instance, along with their DDL statements found in the workspace.
+     *
+     * @param instance The Spanner {@link Instance} in which the databases should be created.
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the created databases.
+     */
+    private createDatabases;
+}

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

@@ -0,0 +1,112 @@
+import { DockerEmulatorService, EmulatorStart, } from '@causa/workspace-core';
+import { Spanner } from '@google-cloud/spanner';
+import { grpc } from 'google-gax';
+import { getLocalGcpProject, } from '../configurations/index.js';
+import { SPANNER_EMULATOR_NAME, SPANNER_GRPC_PORT, SPANNER_HTTP_PORT, SPANNER_IMAGE, getSpannerContainerName, } from '../emulators/index.js';
+import { GoogleSpannerListDatabases } from './google-spanner-list-databases.js';
+/**
+ * Implements {@link EmulatorStart} for the Spanner emulator.
+ * This starts the emulator, creates a local instance, and creates the databases using the DDLs found in the workspace.
+ */
+export class EmulatorStartForSpanner extends EmulatorStart {
+    async _call(context) {
+        const configuration = await this.startSpanner(context);
+        return { name: SPANNER_EMULATOR_NAME, configuration };
+    }
+    _supports() {
+        return this.name === undefined || this.name === SPANNER_EMULATOR_NAME;
+    }
+    /**
+     * Starts the Spanner emulator, and creates the instance and databases within it.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the emulator, instance and databases.
+     */
+    async startSpanner(context) {
+        if (this.dryRun) {
+            return {};
+        }
+        const emulatorConf = await this.startSpannerEmulator(context);
+        const { instance, instanceConf } = await this.createInstance(context);
+        const databaseConf = await this.createDatabases(instance, context);
+        context.logger.info('🗃️ Successfully initialized Spanner emulator.');
+        return { ...emulatorConf, ...instanceConf, ...databaseConf };
+    }
+    /**
+     * Starts the Spanner emulator.
+     * The emulator is defined in a separate Docker image, not part of the `gcloud` CLI emulators.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the Spanner emulator.
+     */
+    async startSpannerEmulator(context) {
+        context.logger.info('🗃️ Starting Spanner emulator.');
+        const gcpProject = getLocalGcpProject(context);
+        const containerName = getSpannerContainerName(context);
+        const imageVersion = context
+            .asConfiguration()
+            .get('google.spanner.emulator.version') ?? 'latest';
+        const dockerEmulatorService = context.service(DockerEmulatorService);
+        await dockerEmulatorService.start(`${SPANNER_IMAGE}:${imageVersion}`, containerName, [SPANNER_GRPC_PORT, SPANNER_HTTP_PORT].map((p) => ({
+            host: '127.0.0.1',
+            local: p,
+            container: p,
+        })));
+        await dockerEmulatorService.waitForAvailability(containerName, `http://127.0.0.1:${SPANNER_HTTP_PORT}/v1/projects/${gcpProject}/instances`);
+        return {
+            SPANNER_EMULATOR_HOST: `127.0.0.1:${SPANNER_GRPC_PORT}`,
+            GOOGLE_CLOUD_PROJECT: gcpProject,
+            GCP_PROJECT: gcpProject,
+            GCLOUD_PROJECT: gcpProject,
+        };
+    }
+    /**
+     * Creates a local instance within the Spanner emulator.
+     *
+     * @param context The {@link WorkspaceContext}.
+     * @returns The created Spanner {@link Instance} and the corresponding client configuration.
+     */
+    async createInstance(context) {
+        const instanceName = context
+            .asConfiguration()
+            .get('google.spanner.emulator.instanceName') ?? 'local';
+        context.logger.info(`🗃️ Creating Spanner emulator instance '${instanceName}'.`);
+        const spanner = new Spanner({
+            servicePath: '127.0.0.1',
+            port: SPANNER_GRPC_PORT,
+            projectId: getLocalGcpProject(context),
+            sslCreds: grpc.credentials.createInsecure(),
+        });
+        const [instance, operation] = await spanner.createInstance(instanceName, {
+            config: 'emulator-config',
+            displayName: instanceName,
+            processingUnits: 100,
+        });
+        await operation.promise();
+        return { instance, instanceConf: { SPANNER_INSTANCE: instanceName } };
+    }
+    /**
+     * Creates the Spanner databases within the given instance, along with their DDL statements found in the workspace.
+     *
+     * @param instance The Spanner {@link Instance} in which the databases should be created.
+     * @param context The {@link WorkspaceContext}.
+     * @returns The configuration for the created databases.
+     */
+    async createDatabases(instance, context) {
+        const databases = await context.call(GoogleSpannerListDatabases, {});
+        await Promise.all(databases.map(async (database) => {
+            context.logger.info(`🗃️ Creating Spanner emulator database '${database.id}'.`);
+            // Discarding `DROP TABLE` statements as the emulator does not seem to handle them properly.
+            const ddls = database.ddls.filter((statement) => !statement.toUpperCase().startsWith('DROP TABLE'));
+            const [_, operation] = await instance.createDatabase(database.id, {
+                schema: ddls,
+            });
+            await operation.promise();
+        }));
+        return databases.length === 0
+            ? {}
+            : {
+                SPANNER_DATABASE: databases.map((database) => database.id).join('|'),
+            };
+    }
+}

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

@@ -0,0 +1,9 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStop } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStop} for the Firebase Storage emulator.
+ */
+export declare class EmulatorStopForFirebaseStorage extends EmulatorStop {
+    _call(context: WorkspaceContext): Promise<string>;
+    _supports(): boolean;
+}

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

@@ -0,0 +1,17 @@
+import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { FIREBASE_STORAGE_EMULATOR_NAME, getFirebaseStorageContainerName, } from '../emulators/index.js';
+/**
+ * Implements {@link EmulatorStop} for the Firebase Storage emulator.
+ */
+export class EmulatorStopForFirebaseStorage extends EmulatorStop {
+    async _call(context) {
+        const containerName = getFirebaseStorageContainerName(context);
+        context.logger.info('️🍱 Stopping Firebase Storage emulator.');
+        await context.service(DockerEmulatorService).stop(containerName);
+        context.logger.info('️🍱 Successfully stopped Firebase Storage emulator.');
+        return FIREBASE_STORAGE_EMULATOR_NAME;
+    }
+    _supports() {
+        return (this.name === undefined || this.name === FIREBASE_STORAGE_EMULATOR_NAME);
+    }
+}

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

@@ -0,0 +1,9 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStop } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStop} for the Firestore emulator.
+ */
+export declare class EmulatorStopForFirestore extends EmulatorStop {
+    _call(context: WorkspaceContext): Promise<string>;
+    _supports(): boolean;
+}

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

@@ -0,0 +1,17 @@
+import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { FIRESTORE_EMULATOR_NAME, getFirestoreContainerName, } from '../emulators/index.js';
+/**
+ * Implements {@link EmulatorStop} for the Firestore emulator.
+ */
+export class EmulatorStopForFirestore extends EmulatorStop {
+    async _call(context) {
+        const containerName = getFirestoreContainerName(context);
+        context.logger.info('️🗃️ Stopping Firestore emulator.');
+        await context.service(DockerEmulatorService).stop(containerName);
+        context.logger.info('️🗃️ Successfully stopped Firestore emulator.');
+        return FIRESTORE_EMULATOR_NAME;
+    }
+    _supports() {
+        return this.name === undefined || this.name === FIRESTORE_EMULATOR_NAME;
+    }
+}

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

@@ -0,0 +1,9 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStop } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStop} for the Identity Platform emulator.
+ */
+export declare class EmulatorStopForIdentityPlatform extends EmulatorStop {
+    _call(context: WorkspaceContext): Promise<string>;
+    _supports(): boolean;
+}

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

@@ -0,0 +1,17 @@
+import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { IDENTITY_PLATFORM_EMULATOR_NAME, getIdentityPlatformContainerName, } from '../emulators/index.js';
+/**
+ * Implements {@link EmulatorStop} for the Identity Platform emulator.
+ */
+export class EmulatorStopForIdentityPlatform extends EmulatorStop {
+    async _call(context) {
+        const containerName = getIdentityPlatformContainerName(context);
+        context.logger.info('️🛂 Stopping Identity Platform emulator.');
+        await context.service(DockerEmulatorService).stop(containerName);
+        context.logger.info('🛂 Successfully stopped Identity Platform emulator.');
+        return IDENTITY_PLATFORM_EMULATOR_NAME;
+    }
+    _supports() {
+        return (this.name === undefined || this.name === IDENTITY_PLATFORM_EMULATOR_NAME);
+    }
+}

package/dist/functions/emulator-stop-pubsub.d.ts

@@ -0,0 +1,9 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStop } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStop} for the Pub/Sub emulator.
+ */
+export declare class EmulatorStopForPubSub extends EmulatorStop {
+    _call(context: WorkspaceContext): Promise<string>;
+    _supports(): boolean;
+}

package/dist/functions/emulator-stop-pubsub.js

@@ -0,0 +1,17 @@
+import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { PUBSUB_EMULATOR_NAME, getPubSubContainerName, } from '../emulators/index.js';
+/**
+ * Implements {@link EmulatorStop} for the Pub/Sub emulator.
+ */
+export class EmulatorStopForPubSub extends EmulatorStop {
+    async _call(context) {
+        const containerName = getPubSubContainerName(context);
+        context.logger.info('️📫 Stopping Pub/Sub emulator.');
+        await context.service(DockerEmulatorService).stop(containerName);
+        context.logger.info('📫 Successfully stopped Pub/Sub emulator.');
+        return PUBSUB_EMULATOR_NAME;
+    }
+    _supports() {
+        return this.name === undefined || this.name === PUBSUB_EMULATOR_NAME;
+    }
+}

package/dist/functions/emulator-stop-spanner.d.ts

@@ -0,0 +1,9 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { EmulatorStop } from '@causa/workspace-core';
+/**
+ * Implements {@link EmulatorStop} for the Spanner emulator.
+ */
+export declare class EmulatorStopForSpanner extends EmulatorStop {
+    _call(context: WorkspaceContext): Promise<string>;
+    _supports(): boolean;
+}

package/dist/functions/emulator-stop-spanner.js

@@ -0,0 +1,17 @@
+import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { SPANNER_EMULATOR_NAME, getSpannerContainerName, } from '../emulators/index.js';
+/**
+ * Implements {@link EmulatorStop} for the Spanner emulator.
+ */
+export class EmulatorStopForSpanner extends EmulatorStop {
+    async _call(context) {
+        const containerName = getSpannerContainerName(context);
+        context.logger.info('️️🗃️ Stopping Spanner emulator.');
+        await context.service(DockerEmulatorService).stop(containerName);
+        context.logger.info('️🗃️ Successfully stopped Spanner emulator.');
+        return SPANNER_EMULATOR_NAME;
+    }
+    _supports() {
+        return this.name === undefined || this.name === SPANNER_EMULATOR_NAME;
+    }
+}

package/dist/functions/google-app-check-generate-token.d.ts

@@ -0,0 +1,13 @@
+import { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+/**
+ * Generates a new AppCheck token.
+ */
+export declare class GoogleAppCheckGenerateToken extends WorkspaceFunction<Promise<string>> {
+    /**
+     * The ID of the Firebase app for which the token will be generated.
+     * If `undefined`, a Firebase app ID will be found in the configuration or using the API.
+     */
+    readonly app?: string;
+    _call(context: WorkspaceContext): Promise<string>;
+    _supports(): boolean;
+}

package/dist/functions/google-app-check-generate-token.js

@@ -0,0 +1,66 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { CliCommand, CliOption } from '@causa/cli';
+import { WorkspaceFunction } from '@causa/workspace';
+import { AllowMissing } from '@causa/workspace/validation';
+import { IsString } from 'class-validator';
+import { getAppCheck } from 'firebase-admin/app-check';
+import { appCheckCommandDefinition } from '../cli/index.js';
+import { FirebaseAppService } from '../services/index.js';
+/**
+ * The time to live of generated tokens, in seconds.
+ */
+const TOKEN_TTL = 3600;
+/**
+ * Generates a new AppCheck token.
+ */
+export let GoogleAppCheckGenerateToken = class GoogleAppCheckGenerateToken extends WorkspaceFunction {
+    /**
+     * The ID of the Firebase app for which the token will be generated.
+     * If `undefined`, a Firebase app ID will be found in the configuration or using the API.
+     */
+    app;
+    async _call(context) {
+        const firebaseAppService = context.service(FirebaseAppService);
+        const app = await firebaseAppService.getAdminAppForAdminServiceAccount();
+        const appId = this.app ?? (await firebaseAppService.getAppId());
+        context.logger.info(`🛂 Generating AppCheck token for Firebase application '${appId}'.`);
+        const appCheck = getAppCheck(app);
+        const { token } = await appCheck.createToken(appId, {
+            ttlMillis: TOKEN_TTL * 1000,
+        });
+        return token;
+    }
+    _supports() {
+        return true;
+    }
+};
+__decorate([
+    CliOption({
+        flags: '-a, --app <app>',
+        description: 'The ID of the Firebase app for which the token will be generated.',
+    }),
+    IsString(),
+    AllowMissing(),
+    __metadata("design:type", String)
+], GoogleAppCheckGenerateToken.prototype, "app", void 0);
+GoogleAppCheckGenerateToken = __decorate([
+    CliCommand({
+        parent: appCheckCommandDefinition,
+        name: 'genToken',
+        description: `Generates an AppCheck token.
+This token can be used to mock a call from a verified device.
+If the Firebase app ID is not specified, it will:
+- Be fetched from the 'google.firebase.appId' configuration.
+- If not present in the configuration, will be automatically looked up from the API.`,
+        summary: 'Generates an AppCheck token.',
+        outputFn: (token) => console.log(token),
+    })
+], GoogleAppCheckGenerateToken);

package/dist/functions/google-firebase-storage-merge-rules.js

@@ -27,7 +27,7 @@ const DEFAULT_FIREBASE_STORAGE_SECURITY_RULE_FILE = 'storage.rules';
  * Returns a configuration with `google.firebaseStorage.securityRuleFile` set, such that the function can be used as a
  * processor.
  */
-let GoogleFirebaseStorageMergeRules = class GoogleFirebaseStorageMergeRules extends WorkspaceFunction {
+export let GoogleFirebaseStorageMergeRules = class GoogleFirebaseStorageMergeRules extends WorkspaceFunction {
     tearDown;
     async _call(context) {
         if (this.tearDown) {
@@ -69,4 +69,3 @@ Input files are looked for in the workspace using the globs defined in google.fi
         outputFn: ({ securityRuleFile }) => console.log(securityRuleFile),
     })
 ], GoogleFirebaseStorageMergeRules);
-export { GoogleFirebaseStorageMergeRules };

package/dist/functions/google-firestore-merge-rules.js

@@ -27,7 +27,7 @@ const DEFAULT_FIRESTORE_SECURITY_RULE_FILE = 'firestore.rules';
  * Returns a configuration with `google.firestore.securityRuleFile` set, such that the function can be used as a
  * processor.
  */
-let GoogleFirestoreMergeRules = class GoogleFirestoreMergeRules extends WorkspaceFunction {
+export let GoogleFirestoreMergeRules = class GoogleFirestoreMergeRules extends WorkspaceFunction {
     tearDown;
     async _call(context) {
         if (this.tearDown) {
@@ -69,4 +69,3 @@ Input files are looked for in the workspace using the globs defined in google.fi
         outputFn: ({ securityRuleFile }) => console.log(securityRuleFile),
     })
 ], GoogleFirestoreMergeRules);
-export { GoogleFirestoreMergeRules };

package/dist/functions/google-identity-platform-generate-custom-token.d.ts

@@ -0,0 +1,20 @@
+import { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+/**
+ * Generates a custom token that can be used to sign in to Identity Platform as a given user.
+ * Optionally, custom claims can be set in the token.
+ * They will be included in the ID token returned by Identity Platform when signing in.
+ * If `google.firebase.adminServiceAccount` is set, the service account will be used to sign the token. Otherwise, an
+ * attempt will be made to find a valid service account in the `google.project`.
+ */
+export declare class GoogleIdentityPlatformGenerateCustomToken extends WorkspaceFunction<Promise<string>> {
+    /**
+     * The ID of the user for which the custom token should be generated.
+     */
+    readonly user: string;
+    /**
+     * A dictionary of custom claims to add to the token.
+     */
+    readonly claims?: Record<string, any>;
+    _call(context: WorkspaceContext): Promise<string>;
+    _supports(): boolean;
+}

package/dist/functions/google-identity-platform-generate-custom-token.js

@@ -0,0 +1,49 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { WorkspaceFunction } from '@causa/workspace';
+import { AllowMissing } from '@causa/workspace/validation';
+import { IsObject, IsString } from 'class-validator';
+import { getAuth } from 'firebase-admin/auth';
+import { FirebaseAppService } from '../index.js';
+/**
+ * Generates a custom token that can be used to sign in to Identity Platform as a given user.
+ * Optionally, custom claims can be set in the token.
+ * They will be included in the ID token returned by Identity Platform when signing in.
+ * If `google.firebase.adminServiceAccount` is set, the service account will be used to sign the token. Otherwise, an
+ * attempt will be made to find a valid service account in the `google.project`.
+ */
+export class GoogleIdentityPlatformGenerateCustomToken extends WorkspaceFunction {
+    /**
+     * The ID of the user for which the custom token should be generated.
+     */
+    user;
+    /**
+     * A dictionary of custom claims to add to the token.
+     */
+    claims;
+    async _call(context) {
+        const adminApp = await context
+            .service(FirebaseAppService)
+            .getAdminAppForAdminServiceAccount();
+        return await getAuth(adminApp).createCustomToken(this.user, this.claims);
+    }
+    _supports() {
+        return true;
+    }
+}
+__decorate([
+    IsString(),
+    __metadata("design:type", String)
+], GoogleIdentityPlatformGenerateCustomToken.prototype, "user", void 0);
+__decorate([
+    IsObject(),
+    AllowMissing(),
+    __metadata("design:type", Object)
+], GoogleIdentityPlatformGenerateCustomToken.prototype, "claims", void 0);

package/dist/functions/google-identity-platform-generate-token.d.ts

@@ -0,0 +1,18 @@
+import { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+/**
+ * Generates an ID token for an Identity Platform end user.
+ * For this function to succeed, the `google.project` should be set, which usually means setting the environment in the
+ * context. Also `google.firebase` children can be used to configure (and speed up) how tokens are generated.
+ */
+export declare class GoogleIdentityPlatformGenerateToken extends WorkspaceFunction<Promise<string>> {
+    /**
+     * The ID of the user for which the token will be generated.
+     */
+    readonly user: string;
+    /**
+     * A dictionary of custom claims that will be added to the generated JWT.
+     */
+    readonly claims?: Record<string, any>;
+    _call(context: WorkspaceContext): Promise<string>;
+    _supports(): boolean;
+}