@causa/workspace-google 0.12.2 → 0.13.0-rc.2

package/dist/functions/causa/list-schemas.d.ts

@@ -0,0 +1,9 @@
+import { CausaListConfigurationSchemas } from '@causa/workspace-core';
+/**
+ * Implements {@link CausaListConfigurationSchemas} for the Google module.
+ * Returns the paths to the configuration schemas bundled with this package.
+ */
+export declare class CausaListConfigurationSchemasForGoogle extends CausaListConfigurationSchemas {
+    _call(): Promise<string[]>;
+    _supports(): boolean;
+}

package/dist/functions/causa/list-schemas.js

@@ -0,0 +1,23 @@
+import { CausaListConfigurationSchemas } from '@causa/workspace-core';
+import { globby } from 'globby';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * The directory containing the configuration schemas provided by this module.
+ */
+const SCHEMAS_DIRECTORY = resolve(dirname(fileURLToPath(import.meta.url)), '../../configurations/schemas');
+/**
+ * Implements {@link CausaListConfigurationSchemas} for the Google module.
+ * Returns the paths to the configuration schemas bundled with this package.
+ */
+export class CausaListConfigurationSchemasForGoogle extends CausaListConfigurationSchemas {
+    async _call() {
+        return await globby('*.yaml', {
+            cwd: SCHEMAS_DIRECTORY,
+            absolute: true,
+        });
+    }
+    _supports() {
+        return true;
+    }
+}

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

@@ -2,7 +2,7 @@ import { WorkspaceContext } from '@causa/workspace';
 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 { FirebaseEmulatorService } from '../../services/firebase-emulator.js';
 import { GoogleFirebaseStorageMergeRules } from '../google-firebase-storage/index.js';
 /**
  * The Firebase configuration file enabling only the Storage emulator.

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

@@ -1,7 +1,7 @@
 import { WorkspaceContext } from '@causa/workspace';
 import { EmulatorStart } from '@causa/workspace-core';
 import { FIRESTORE_CONTAINER_RULES_FILE, FIRESTORE_EMULATOR_NAME, FIRESTORE_PORT, getFirestoreContainerName, } from '../../emulators/index.js';
-import { GcloudEmulatorService } from '../../services/index.js';
+import { GcloudEmulatorService } from '../../services/gcloud-emulator.js';
 import { GoogleFirestoreMergeRules } from '../google-firestore/index.js';
 /**
  * Implements {@link EmulatorStart} for the Firestore emulator.

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

@@ -2,7 +2,7 @@ import { WorkspaceContext } from '@causa/workspace';
 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';
+import { FirebaseEmulatorService } from '../../services/firebase-emulator.js';
 /**
  * The Firebase configuration file enabling only the Auth emulator.
  */

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

@@ -0,0 +1,4 @@
+import type { WorkspaceContext } from '@causa/workspace';
+import { type EmulatorStartResult } from '@causa/workspace-core';
+import type { EmulatorStartForPubSub } from './start-pubsub.js';
+export default function call(this: EmulatorStartForPubSub, context: WorkspaceContext): Promise<EmulatorStartResult>;

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

@@ -0,0 +1,57 @@
+import { 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 '../../services/gcloud-emulator.js';
+export default async function call(context) {
+    const configuration = await startPubSub(this, context);
+    return { name: PUBSUB_EMULATOR_NAME, configuration };
+}
+async function startPubSub(self, context) {
+    if (self.dryRun) {
+        return {};
+    }
+    const emulatorConf = await startPubSubEmulator(context);
+    const topicsConf = await createTopicsIfNeeded(context);
+    context.logger.info('📫 Successfully initialized Pub/Sub emulator.');
+    return { ...emulatorConf, ...topicsConf };
+}
+async function 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,
+    };
+}
+async function 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-pubsub.d.ts

@@ -8,26 +8,4 @@ import { EmulatorStart, type EmulatorStartResult } from '@causa/workspace-core';
 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

@@ -1,9 +1,6 @@
-import { WorkspaceContext } from '@causa/workspace';
-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 '../../services/index.js';
+import { callDeferred, WorkspaceContext } from '@causa/workspace';
+import { EmulatorStart } from '@causa/workspace-core';
+import { PUBSUB_EMULATOR_NAME } from '../../emulators/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
@@ -11,77 +8,9 @@ import { GcloudEmulatorService } from '../../services/index.js';
  */
 export class EmulatorStartForPubSub extends EmulatorStart {
     async _call(context) {
-        const configuration = await this.startPubSub(context);
-        return { name: PUBSUB_EMULATOR_NAME, configuration };
+        return await callDeferred(this, context, import.meta.url);
     }
     _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.call.d.ts

@@ -0,0 +1,4 @@
+import type { WorkspaceContext } from '@causa/workspace';
+import type { EmulatorStartResult } from '@causa/workspace-core';
+import type { EmulatorStartForSpanner } from './start-spanner.js';
+export default function call(this: EmulatorStartForSpanner, context: WorkspaceContext): Promise<EmulatorStartResult>;

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

@@ -0,0 +1,92 @@
+import { DockerEmulatorService } from '@causa/workspace-core/services';
+import { Instance, Spanner } from '@google-cloud/spanner';
+// The Spanner client depends on `google-gax` rather than `@grpc/grpc-js` directly. By ensuring `google-gax` is kept in
+// sync with the version required by Spanner, and importing `grpc` from `google-gax`, the correct `grpc.credentials`
+// version can be loaded.
+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/index.js';
+export default async function call(context) {
+    const configuration = await startSpanner(this, context);
+    return { name: SPANNER_EMULATOR_NAME, configuration };
+}
+async function startSpanner(self, context) {
+    if (self.dryRun) {
+        return {};
+    }
+    const emulatorConf = await startSpannerEmulator(context);
+    const instanceAndDatabaseConf = await initializeEmulator(context);
+    context.logger.info('🗃️ Successfully initialized Spanner emulator.');
+    return { ...emulatorConf, ...instanceAndDatabaseConf };
+}
+async function 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,
+    };
+}
+async function initializeEmulator(context) {
+    const spanner = new Spanner({
+        servicePath: '127.0.0.1',
+        port: SPANNER_GRPC_PORT,
+        projectId: getLocalGcpProject(context),
+        sslCreds: grpc.credentials.createInsecure(),
+    });
+    const { instance, instanceConf } = await createInstance(spanner, context);
+    const databaseConf = await createDatabases(instance, context);
+    spanner.close();
+    return { ...instanceConf, ...databaseConf };
+}
+async function createInstance(spanner, context) {
+    const instanceName = context
+        .asConfiguration()
+        .get('google.spanner.emulator.instanceName') ?? 'local';
+    context.logger.info(`🗃️ Creating Spanner emulator instance '${instanceName}'.`);
+    const [instance, operation] = await spanner.createInstance(instanceName, {
+        config: 'emulator-config',
+        displayName: instanceName,
+        processingUnits: 100,
+    });
+    await operation.promise();
+    return { instance, instanceConf: { SPANNER_INSTANCE: instanceName } };
+}
+async function 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 [db, operation] = await instance.createDatabase(database.id, {
+            schema: ddls,
+        });
+        // While unlikely, the database object might emit errors, e.g "The client has already been closed.".
+        // These errors could simply be ignored, as awaiting on the operation should be enough to ensure the database is
+        // created. However they are logged as warnings for completeness.
+        db.on('error', (error) => {
+            context.logger.warn(`⚠️ Uncaught Spanner database error: '${error.message}'.`);
+        });
+        await operation.promise();
+        await db.close();
+    }));
+    return databases.length === 0
+        ? {}
+        : {
+            SPANNER_DATABASE: databases.map((database) => database.id).join('|'),
+        };
+}

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

@@ -7,42 +7,4 @@ import { EmulatorStart, type EmulatorStartResult } from '@causa/workspace-core';
 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 the Spanner instance and databases within the emulator.
-     *
-     * @param context The {@link WorkspaceContext}.
-     * @returns The configuration for the created instance and databases.
-     */
-    private initializeEmulator;
-    /**
-     * Creates a local instance within the Spanner emulator.
-     *
-     * @param spanner The {@link Spanner} client.
-     * @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

@@ -1,135 +1,15 @@
-import { WorkspaceContext } from '@causa/workspace';
-import { DockerEmulatorService, EmulatorStart, } from '@causa/workspace-core';
-import { Instance, Spanner } from '@google-cloud/spanner';
-// The Spanner client depends on `google-gax` rather than `@grpc/grpc-js` directly. By ensuring `google-gax` is kept in
-// sync with the version required by Spanner, and importing `grpc` from `google-gax`, the correct `grpc.credentials`
-// version can be loaded.
-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/index.js';
+import { callDeferred, WorkspaceContext } from '@causa/workspace';
+import { EmulatorStart } from '@causa/workspace-core';
+import { SPANNER_EMULATOR_NAME } from '../../emulators/index.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 };
+        return await callDeferred(this, context, import.meta.url);
     }
     _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 instanceAndDatabaseConf = await this.initializeEmulator(context);
-        context.logger.info('🗃️ Successfully initialized Spanner emulator.');
-        return { ...emulatorConf, ...instanceAndDatabaseConf };
-    }
-    /**
-     * 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 the Spanner instance and databases within the emulator.
-     *
-     * @param context The {@link WorkspaceContext}.
-     * @returns The configuration for the created instance and databases.
-     */
-    async initializeEmulator(context) {
-        const spanner = new Spanner({
-            servicePath: '127.0.0.1',
-            port: SPANNER_GRPC_PORT,
-            projectId: getLocalGcpProject(context),
-            sslCreds: grpc.credentials.createInsecure(),
-        });
-        const { instance, instanceConf } = await this.createInstance(spanner, context);
-        const databaseConf = await this.createDatabases(instance, context);
-        spanner.close();
-        return { ...instanceConf, ...databaseConf };
-    }
-    /**
-     * Creates a local instance within the Spanner emulator.
-     *
-     * @param spanner The {@link Spanner} client.
-     * @param context The {@link WorkspaceContext}.
-     * @returns The created Spanner {@link Instance} and the corresponding client configuration.
-     */
-    async createInstance(spanner, context) {
-        const instanceName = context
-            .asConfiguration()
-            .get('google.spanner.emulator.instanceName') ?? 'local';
-        context.logger.info(`🗃️ Creating Spanner emulator instance '${instanceName}'.`);
-        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 [db, operation] = await instance.createDatabase(database.id, {
-                schema: ddls,
-            });
-            // While unlikely, the database object might emit errors, e.g "The client has already been closed.".
-            // These errors could simply be ignored, as awaiting on the operation should be enough to ensure the database is
-            // created. However they are logged as warnings for completeness.
-            db.on('error', (error) => {
-                context.logger.warn(`⚠️ Uncaught Spanner database error: '${error.message}'.`);
-            });
-            await operation.promise();
-            await db.close();
-        }));
-        return databases.length === 0
-            ? {}
-            : {
-                SPANNER_DATABASE: databases.map((database) => database.id).join('|'),
-            };
-    }
 }

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

@@ -1,5 +1,6 @@
 import { WorkspaceContext } from '@causa/workspace';
-import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { EmulatorStop } from '@causa/workspace-core';
+import { DockerEmulatorService } from '@causa/workspace-core/services';
 import { FIREBASE_STORAGE_EMULATOR_NAME, getFirebaseStorageContainerName, } from '../../emulators/index.js';
 /**
  * Implements {@link EmulatorStop} for the Firebase Storage emulator.

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

@@ -1,5 +1,6 @@
 import { WorkspaceContext } from '@causa/workspace';
-import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { EmulatorStop } from '@causa/workspace-core';
+import { DockerEmulatorService } from '@causa/workspace-core/services';
 import { FIRESTORE_EMULATOR_NAME, getFirestoreContainerName, } from '../../emulators/index.js';
 /**
  * Implements {@link EmulatorStop} for the Firestore emulator.

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

@@ -1,5 +1,6 @@
 import { WorkspaceContext } from '@causa/workspace';
-import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { EmulatorStop } from '@causa/workspace-core';
+import { DockerEmulatorService } from '@causa/workspace-core/services';
 import { IDENTITY_PLATFORM_EMULATOR_NAME, getIdentityPlatformContainerName, } from '../../emulators/index.js';
 /**
  * Implements {@link EmulatorStop} for the Identity Platform emulator.

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

@@ -1,5 +1,6 @@
 import { WorkspaceContext } from '@causa/workspace';
-import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { EmulatorStop } from '@causa/workspace-core';
+import { DockerEmulatorService } from '@causa/workspace-core/services';
 import { PUBSUB_EMULATOR_NAME, getPubSubContainerName, } from '../../emulators/index.js';
 /**
  * Implements {@link EmulatorStop} for the Pub/Sub emulator.

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

@@ -1,5 +1,6 @@
 import { WorkspaceContext } from '@causa/workspace';
-import { DockerEmulatorService, EmulatorStop } from '@causa/workspace-core';
+import { EmulatorStop } from '@causa/workspace-core';
+import { DockerEmulatorService } from '@causa/workspace-core/services';
 import { SPANNER_EMULATOR_NAME, getSpannerContainerName, } from '../../emulators/index.js';
 /**
  * Implements {@link EmulatorStop} for the Spanner emulator.

package/dist/functions/event-topic/broker-create-topic-pubsub.call.d.ts

@@ -0,0 +1,3 @@
+import type { WorkspaceContext } from '@causa/workspace';
+import type { EventTopicBrokerCreateTopicForPubSub } from './broker-create-topic-pubsub.js';
+export default function call(this: EventTopicBrokerCreateTopicForPubSub, context: WorkspaceContext): Promise<string>;

package/dist/functions/event-topic/broker-create-topic-pubsub.call.js

@@ -0,0 +1,15 @@
+import { PubSubService } from '../../services/pubsub.js';
+export default async function call(context) {
+    const googleConf = context.asConfiguration();
+    const projectId = googleConf.getOrThrow('google.project');
+    const region = googleConf.get('google.region');
+    const topicId = `projects/${projectId}/topics/${this.name}`;
+    context.logger.info(`📫 Creating Pub/Sub topic '${topicId}'.`);
+    await context.service(PubSubService).pubSub.createTopic({
+        name: topicId,
+        ...(region
+            ? { messageStoragePolicy: { allowedPersistenceRegions: [region] } }
+            : {}),
+    });
+    return topicId;
+}

package/dist/functions/event-topic/broker-create-topic-pubsub.js

@@ -1,6 +1,5 @@
-import { WorkspaceContext } from '@causa/workspace';
+import { callDeferred, WorkspaceContext } from '@causa/workspace';
 import { EventTopicBrokerCreateTopic, } from '@causa/workspace-core';
-import { PubSubService } from '../../services/index.js';
 /**
  * Implements {@link EventTopicBrokerCreateTopic} for Pub/Sub.
  * Topics are created in the GCP project set in the `google.project` configuration.
@@ -8,18 +7,7 @@ import { PubSubService } from '../../services/index.js';
  */
 export class EventTopicBrokerCreateTopicForPubSub extends EventTopicBrokerCreateTopic {
     async _call(context) {
-        const googleConf = context.asConfiguration();
-        const projectId = googleConf.getOrThrow('google.project');
-        const region = googleConf.get('google.region');
-        const topicId = `projects/${projectId}/topics/${this.name}`;
-        context.logger.info(`📫 Creating Pub/Sub topic '${topicId}'.`);
-        await context.service(PubSubService).pubSub.createTopic({
-            name: topicId,
-            ...(region
-                ? { messageStoragePolicy: { allowedPersistenceRegions: [region] } }
-                : {}),
-        });
-        return topicId;
+        return await callDeferred(this, context, import.meta.url);
     }
     _supports(context) {
         return (context.asConfiguration().get('events.broker') ===

package/dist/functions/event-topic/broker-create-trigger-cloud-run.call.d.ts

@@ -0,0 +1,3 @@
+import type { WorkspaceContext } from '@causa/workspace';
+import type { EventTopicBrokerCreateTriggerForCloudRun } from './broker-create-trigger-cloud-run.js';
+export default function call(this: EventTopicBrokerCreateTriggerForCloudRun, context: WorkspaceContext): Promise<string[]>;