@causa/workspace-google 0.16.0 → 0.18.0-beta.1

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

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { callDeferred, WorkspaceContext, WorkspaceFunction, } from '@causa/workspace';
+import { callDeferred, WorkspaceFunction } from '@causa/workspace';
 import { AllowMissing } from '@causa/workspace/validation';
 import { IsObject, IsString } from 'class-validator';
 /**
@@ -26,8 +26,8 @@ export class GoogleIdentityPlatformGenerateCustomToken extends WorkspaceFunction
      * A dictionary of custom claims to add to the token.
      */
     claims;
-    async _call(context) {
-        return await callDeferred(this, context, import.meta.url);
+    async _call() {
+        return await callDeferred(this, import.meta.url);
     }
     _supports() {
         return true;

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

@@ -1,3 +1,2 @@
-import type { WorkspaceContext } from '@causa/workspace';
 import type { GoogleIdentityPlatformGenerateToken } from './generate-token.js';
-export default function call(this: GoogleIdentityPlatformGenerateToken, context: WorkspaceContext): Promise<string>;
+export default function call(this: GoogleIdentityPlatformGenerateToken): Promise<string>;

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

@@ -1,10 +1,10 @@
 import { getAuth, signInWithCustomToken } from 'firebase/auth';
 import { FirebaseAppService } from '../../services/firebase-app.js';
 import { GoogleIdentityPlatformGenerateCustomToken } from './generate-custom-token.js';
-export default async function call(context) {
-    context.logger.info(`🛂 Signing in user '${this.user}' with a custom token.`);
-    const customToken = await context.call(GoogleIdentityPlatformGenerateCustomToken, { user: this.user, claims: this.claims });
-    const app = await context.service(FirebaseAppService).getApp();
+export default async function call() {
+    this._context.logger.info(`🛂 Signing in user '${this.user}' with a custom token.`);
+    const customToken = await this._context.call(GoogleIdentityPlatformGenerateCustomToken, { user: this.user, claims: this.claims });
+    const app = await this._context.service(FirebaseAppService).getApp();
     const auth = getAuth(app);
     const credentials = await signInWithCustomToken(auth, customToken);
     return this.refreshToken

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

@@ -1,4 +1,4 @@
-import { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+import { 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
@@ -17,6 +17,6 @@ export declare class GoogleIdentityPlatformGenerateToken extends WorkspaceFuncti
      * Whether to return the refresh token instead of the ID token.
      */
     readonly refreshToken?: boolean;
-    _call(context: WorkspaceContext): Promise<string>;
+    _call(): Promise<string>;
     _supports(): boolean;
 }

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

@@ -8,7 +8,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { CliArgument, CliCommand, CliOption } from '@causa/cli';
-import { callDeferred, WorkspaceContext, WorkspaceFunction, } from '@causa/workspace';
+import { callDeferred, WorkspaceFunction } from '@causa/workspace';
 import { AllowMissing } from '@causa/workspace/validation';
 import { Transform } from 'class-transformer';
 import { IsBoolean, IsObject, IsString } from 'class-validator';
@@ -31,8 +31,8 @@ let GoogleIdentityPlatformGenerateToken = class GoogleIdentityPlatformGenerateTo
      * Whether to return the refresh token instead of the ID token.
      */
     refreshToken;
-    async _call(context) {
-        return await callDeferred(this, context, import.meta.url);
+    async _call() {
+        return await callDeferred(this, import.meta.url);
     }
     _supports() {
         return true;

package/dist/functions/google-pubsub/write-topics.d.ts

@@ -1,4 +1,4 @@
-import { type ProcessorResult, WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+import { type ProcessorResult, WorkspaceFunction } from '@causa/workspace';
 import { type InfrastructureProcessor } from '@causa/workspace-core';
 /**
  * A function that uses {@link EventTopicList} to find all the topics in the workspace, and writes their configurations
@@ -13,10 +13,9 @@ export declare class GooglePubSubWriteTopics extends WorkspaceFunction<Promise<P
      * Returns the path to the directory where Pub/Sub topic configurations should be written.
      * It is either fetched from the workspace configuration, or the default value is used.
      *
-     * @param context The {@link WorkspaceContext}.
      * @returns The path to the directory where topic configurations should be written.
      */
     private getConfigurationsDirectory;
-    _call(context: WorkspaceContext): Promise<ProcessorResult>;
+    _call(): Promise<ProcessorResult>;
     _supports(): boolean;
 }

package/dist/functions/google-pubsub/write-topics.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { WorkspaceContext, WorkspaceFunction, } from '@causa/workspace';
+import { WorkspaceFunction } from '@causa/workspace';
 import { EventTopicList, } from '@causa/workspace-core';
 import { CAUSA_FOLDER } from '@causa/workspace/initialization';
 import { AllowMissing } from '@causa/workspace/validation';
@@ -31,26 +31,25 @@ export class GooglePubSubWriteTopics extends WorkspaceFunction {
      * Returns the path to the directory where Pub/Sub topic configurations should be written.
      * It is either fetched from the workspace configuration, or the default value is used.
      *
-     * @param context The {@link WorkspaceContext}.
      * @returns The path to the directory where topic configurations should be written.
      */
-    getConfigurationsDirectory(context) {
-        return (context
+    getConfigurationsDirectory() {
+        return (this._context
             .asConfiguration()
             .get('google.pubSub.topicConfigurationsDirectory') ??
             DEFAULT_TOPIC_CONFIGURATIONS_DIRECTORY);
     }
-    async _call(context) {
-        const topicConfigurationsDirectory = this.getConfigurationsDirectory(context);
-        const absoluteDir = join(context.rootPath, topicConfigurationsDirectory);
+    async _call() {
+        const topicConfigurationsDirectory = this.getConfigurationsDirectory();
+        const absoluteDir = join(this._context.rootPath, topicConfigurationsDirectory);
         await rm(absoluteDir, { recursive: true, force: true });
         if (this.tearDown) {
-            context.logger.debug(`📫 Tore down Pub/Sub topic configurations directory '${absoluteDir}'.`);
+            this._context.logger.debug(`📫 Tore down Pub/Sub topic configurations directory '${absoluteDir}'.`);
             return { configuration: {} };
         }
-        context.logger.info('️📫 Listing and writing Pub/Sub topic configurations.');
-        const topics = await context.call(EventTopicList, {});
-        context.logger.debug(`📫 Writing configurations for Pub/Sub topics: ${topics
+        this._context.logger.info('️📫 Listing and writing Pub/Sub topic configurations.');
+        const topics = await this._context.call(EventTopicList, {});
+        this._context.logger.debug(`📫 Writing configurations for Pub/Sub topics: ${topics
             .map((d) => `'${d.id}'`)
             .join(', ')}.`);
         await mkdir(absoluteDir, { recursive: true });
@@ -62,7 +61,7 @@ export class GooglePubSubWriteTopics extends WorkspaceFunction {
             const topicFile = join(absoluteDir, `${topic.id}.json`);
             await writeFile(topicFile, JSON.stringify(topicConfiguration));
         }));
-        context.logger.debug(`️📫 Wrote Pub/Sub topic configurations in '${absoluteDir}'.`);
+        this._context.logger.debug(`️📫 Wrote Pub/Sub topic configurations in '${absoluteDir}'.`);
         return {
             configuration: {
                 google: { pubSub: { topicConfigurationsDirectory } },

package/dist/functions/google-services/enable.call.d.ts

@@ -1,7 +1,6 @@
-import type { WorkspaceContext } from '@causa/workspace';
 import type { GoogleConfiguration } from '../../configurations/index.js';
 import type { GoogleServicesEnable } from './enable.js';
-export default function call(this: GoogleServicesEnable, context: WorkspaceContext): Promise<{
+export default function call(this: GoogleServicesEnable): Promise<{
     configuration: GoogleConfiguration;
     services: string[];
 }>;

package/dist/functions/google-services/enable.call.js

@@ -3,11 +3,11 @@ import { ServiceUsageClient } from '@google-cloud/service-usage';
  * The maximum number of GCP services that can be enabled at the same time.
  */
 const MAX_SERVICE_BATCH = 20;
-export default async function call(context) {
+export default async function call() {
     if (this.tearDown) {
         return { configuration: {}, services: [] };
     }
-    const googleConf = context.asConfiguration();
+    const googleConf = this._context.asConfiguration();
     const gcpProject = googleConf.getOrThrow('google.project');
     const services = googleConf.get('google.services');
     if (!services) {
@@ -20,7 +20,7 @@ export default async function call(context) {
     const parent = `projects/${gcpProject}`;
     while (servicesToEnable.length > 0) {
         const serviceIds = servicesToEnable.splice(0, MAX_SERVICE_BATCH);
-        context.logger.info(`➕ Enabling GCP service(s) ${serviceIds
+        this._context.logger.info(`➕ Enabling GCP service(s) ${serviceIds
             .map((s) => `'${s}'`)
             .join(', ')} in project '${gcpProject}'.`);
         const [operation] = await serviceUsageClient.batchEnableServices({

package/dist/functions/google-services/enable.d.ts

@@ -1,4 +1,4 @@
-import { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+import { WorkspaceFunction } from '@causa/workspace';
 import type { InfrastructureProcessor } from '@causa/workspace-core';
 import type { GoogleConfiguration } from '../../configurations/index.js';
 /**
@@ -22,7 +22,7 @@ type GoogleServicesEnableResult = {
  */
 export declare class GoogleServicesEnable extends WorkspaceFunction<Promise<GoogleServicesEnableResult>> implements InfrastructureProcessor {
     readonly tearDown?: boolean;
-    _call(context: WorkspaceContext): Promise<GoogleServicesEnableResult>;
+    _call(): Promise<GoogleServicesEnableResult>;
     _supports(): boolean;
 }
 export {};

package/dist/functions/google-services/enable.js

@@ -8,7 +8,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { CliCommand } from '@causa/cli';
-import { callDeferred, WorkspaceContext, WorkspaceFunction, } from '@causa/workspace';
+import { callDeferred, WorkspaceFunction } from '@causa/workspace';
 import { AllowMissing } from '@causa/workspace/validation';
 import { IsBoolean } from 'class-validator';
 import { googleCommandDefinition } from '../../cli/index.js';
@@ -17,8 +17,8 @@ import { googleCommandDefinition } from '../../cli/index.js';
  */
 let GoogleServicesEnable = class GoogleServicesEnable extends WorkspaceFunction {
     tearDown;
-    async _call(context) {
-        return await callDeferred(this, context, import.meta.url);
+    async _call() {
+        return await callDeferred(this, import.meta.url);
     }
     _supports() {
         return true;

package/dist/functions/google-spanner/extract-database.d.ts

@@ -0,0 +1,11 @@
+import { ModelSchemaExtractDatabase, type SchemaDatabase } from '@causa/workspace-core';
+/**
+ * Implements {@link ModelSchemaExtractDatabase} for Google Spanner.
+ * The schema is selected when it carries a `googleSpannerTable` Causa extension with a `primaryKey` array. The table
+ * name defaults to the schema's name when not explicitly set, and the primary keys are read from the extension's
+ * `primaryKey` array.
+ */
+export declare class ModelSchemaExtractDatabaseForGoogleSpanner extends ModelSchemaExtractDatabase {
+    _call(): SchemaDatabase;
+    _supports(): boolean;
+}

package/dist/functions/google-spanner/extract-database.js

@@ -0,0 +1,25 @@
+import { ModelSchemaExtractDatabase, } from '@causa/workspace-core';
+/**
+ * The name of the Causa extension marking an object schema as a Google Spanner table.
+ */
+const GOOGLE_SPANNER_TABLE_EXTENSION = 'googleSpannerTable';
+/**
+ * Implements {@link ModelSchemaExtractDatabase} for Google Spanner.
+ * The schema is selected when it carries a `googleSpannerTable` Causa extension with a `primaryKey` array. The table
+ * name defaults to the schema's name when not explicitly set, and the primary keys are read from the extension's
+ * `primaryKey` array.
+ */
+export class ModelSchemaExtractDatabaseForGoogleSpanner extends ModelSchemaExtractDatabase {
+    _call() {
+        const extension = this.schema.extensions[GOOGLE_SPANNER_TABLE_EXTENSION];
+        const primaryKeys = extension.primaryKey.filter((k) => typeof k === 'string');
+        const table = typeof extension.name === 'string' ? extension.name : this.schema.name;
+        return { engine: 'google.spanner', table, primaryKeys };
+    }
+    _supports() {
+        const extension = this.schema.extensions[GOOGLE_SPANNER_TABLE_EXTENSION];
+        return (typeof extension === 'object' &&
+            extension !== null &&
+            Array.isArray(extension.primaryKey));
+    }
+}

package/dist/functions/google-spanner/index.d.ts

@@ -1,2 +1,4 @@
+export { ModelSchemaExtractDatabaseForGoogleSpanner } from './extract-database.js';
 export { GoogleSpannerListDatabases } from './list-databases.js';
+export { DatabaseQueryRecordsForSpanner } from './query-records.js';
 export { GoogleSpannerWriteDatabases } from './write-databases.js';

package/dist/functions/google-spanner/index.js

@@ -1,2 +1,4 @@
+export { ModelSchemaExtractDatabaseForGoogleSpanner } from './extract-database.js';
 export { GoogleSpannerListDatabases } from './list-databases.js';
+export { DatabaseQueryRecordsForSpanner } from './query-records.js';
 export { GoogleSpannerWriteDatabases } from './write-databases.js';

package/dist/functions/google-spanner/list-databases.d.ts

@@ -1,4 +1,4 @@
-import { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+import { WorkspaceFunction } from '@causa/workspace';
 /**
  * The definition of a Spanner database with its DDL statements.
  */
@@ -20,7 +20,7 @@ export type SpannerDatabase = {
  * A function that lists Spanner databases defined in the workspace, and returns their corresponding DDLs.
  */
 export declare class GoogleSpannerListDatabases extends WorkspaceFunction<Promise<SpannerDatabase[]>> {
-    _call(context: WorkspaceContext): Promise<SpannerDatabase[]>;
+    _call(): Promise<SpannerDatabase[]>;
     /**
      * Parses a SQL file containing Spanner DDL statements.
      * End-of-the-line comments are removed, and statements are split using semicolons.

package/dist/functions/google-spanner/list-databases.js

@@ -1,4 +1,4 @@
-import { WorkspaceContext, WorkspaceFunction, listFilesAndFormat, } from '@causa/workspace';
+import { WorkspaceFunction, listFilesAndFormat } from '@causa/workspace';
 import { readFile } from 'fs/promises';
 /**
  * The default format used to infer the ID / name of the database from the format parts.
@@ -16,16 +16,16 @@ const DEFAULT_DDL_REGULAR_EXPRESSION = 'domains/(?<database>[\\w-]+)\\/spanner\\
  * A function that lists Spanner databases defined in the workspace, and returns their corresponding DDLs.
  */
 export class GoogleSpannerListDatabases extends WorkspaceFunction {
-    async _call(context) {
-        const googleConf = context.asConfiguration();
+    async _call() {
+        const googleConf = this._context.asConfiguration();
         const format = googleConf.get('google.spanner.ddls.format') ??
             DEFAULT_DDL_DATABASE_ID_FORMAT;
         const globs = googleConf.get('google.spanner.ddls.globs') ?? DEFAULT_DDL_GLOBS;
         const regExp = googleConf.get('google.spanner.ddls.regularExpression') ??
             DEFAULT_DDL_REGULAR_EXPRESSION;
-        context.logger.debug('🗃️ Listing Spanner databases and DDL files.');
-        const filesAndFormats = await listFilesAndFormat(globs, regExp, format, context.rootPath, {
-            nonMatchingPathHandler: (path) => context.logger.warn(`📂 Path '${path}' matches the Spanner DDL globs but did not match the regular expression. It will be ignored.`),
+        this._context.logger.debug('🗃️ Listing Spanner databases and DDL files.');
+        const filesAndFormats = await listFilesAndFormat(globs, regExp, format, this._context.rootPath, {
+            nonMatchingPathHandler: (path) => this._context.logger.warn(`📂 Path '${path}' matches the Spanner DDL globs but did not match the regular expression. It will be ignored.`),
         });
         const databaseDdlFiles = filesAndFormats.reduce((files, { rendered, filePath }) => {
             (files[rendered] ?? (files[rendered] = [])).push(filePath);
@@ -35,7 +35,7 @@ export class GoogleSpannerListDatabases extends WorkspaceFunction {
             ddlFiles.sort();
             const ddlsInFiles = await Promise.all(ddlFiles.map((ddlFile) => this.parseDdlFile(ddlFile)));
             const ddls = ddlsInFiles.flatMap((ddls) => ddls);
-            context.logger.debug(`🗃️ Found Spanner database '${id}' with ${ddlFiles.length} DDL file(s) and ${ddls.length} statement(s).`);
+            this._context.logger.debug(`🗃️ Found Spanner database '${id}' with ${ddlFiles.length} DDL file(s) and ${ddls.length} statement(s).`);
             return { id, ddlFiles, ddls };
         }));
     }

package/dist/functions/google-spanner/query-records.call.d.ts

@@ -0,0 +1,2 @@
+import { type DatabaseQueryRecordsForSpanner } from './query-records.js';
+export default function call(this: DatabaseQueryRecordsForSpanner): Promise<any[]>;

package/dist/functions/google-spanner/query-records.call.js

@@ -0,0 +1,66 @@
+import { Numeric, PGNumeric, Spanner, SpannerDate, } from '@google-cloud/spanner';
+import { SPANNER_QUERY_RECORDS_LIMIT, } from './query-records.js';
+export default async function call() {
+    if (!this.database) {
+        throw new Error(`The 'database' input is required for the 'google.spanner' engine.`);
+    }
+    if (!this.query) {
+        throw new Error(`The 'query' input is required for the 'google.spanner' engine.`);
+    }
+    const googleConf = this._context.asConfiguration();
+    const projectId = googleConf.getOrThrow('google.project');
+    const instanceName = googleConf.getOrThrow('google.spanner.instance.name');
+    this._context.logger.debug(`🗃️ Querying Spanner database '${this.database}' in instance '${instanceName}' (project '${projectId}').`);
+    const spanner = new Spanner({ projectId });
+    let database;
+    try {
+        database = spanner.instance(instanceName).database(this.database);
+        const rows = [];
+        const stream = database.runStream({
+            sql: this.query,
+            json: true,
+            jsonOptions: { wrapNumbers: false, wrapStructs: false },
+        });
+        for await (const row of stream) {
+            if (rows.length >= SPANNER_QUERY_RECORDS_LIMIT) {
+                this._context.logger.warn(`⚠️ Spanner query exceeded the hard limit of ${SPANNER_QUERY_RECORDS_LIMIT} rows. Results were truncated.`);
+                break;
+            }
+            rows.push(toJson(row));
+        }
+        return rows;
+    }
+    finally {
+        await database?.close();
+        spanner.close();
+    }
+}
+/**
+ * Recursively converts Spanner-specific types in a row to JSON-friendly equivalents:
+ * - {@link Numeric} / {@link PGNumeric} (NUMERIC / PG_NUMERIC) → their string value.
+ * - {@link SpannerDate} (DATE) → `YYYY-MM-DD` string.
+ * - Other `Date` subclasses such as `PreciseDate` (TIMESTAMP) → plain {@link Date} instances.
+ *
+ * `Buffer` values are returned as-is.
+ */
+function toJson(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (value instanceof Numeric || value instanceof PGNumeric) {
+        return value.value;
+    }
+    if (value instanceof SpannerDate) {
+        return value.toJSON();
+    }
+    if (value instanceof Date) {
+        return new Date(value.getTime());
+    }
+    if (Buffer.isBuffer(value)) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(toJson);
+    }
+    return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, toJson(v)]));
+}

package/dist/functions/google-spanner/query-records.d.ts

@@ -0,0 +1,22 @@
+import { DatabaseQueryRecords } from '@causa/workspace-core';
+/**
+ * The engine identifier handled by this implementation.
+ */
+export declare const SPANNER_ENGINE = "google.spanner";
+/**
+ * The maximum number of rows that will be returned by a single query.
+ * Acts as a safety mechanism to avoid loading huge result sets in memory.
+ */
+export declare const SPANNER_QUERY_RECORDS_LIMIT = 100000;
+/**
+ * Implements {@link DatabaseQueryRecords} for Spanner databases.
+ *
+ * The Spanner instance and GCP project are read from the workspace configuration. The `database` input is the name of
+ * the database within the instance, and `query` is a regular SQL statement.
+ *
+ * Results are streamed and capped to {@link SPANNER_QUERY_RECORDS_LIMIT} rows.
+ */
+export declare class DatabaseQueryRecordsForSpanner extends DatabaseQueryRecords {
+    _call(): Promise<any[]>;
+    _supports(): boolean;
+}

package/dist/functions/google-spanner/query-records.js

@@ -0,0 +1,27 @@
+import { callDeferred } from '@causa/workspace';
+import { DatabaseQueryRecords } from '@causa/workspace-core';
+/**
+ * The engine identifier handled by this implementation.
+ */
+export const SPANNER_ENGINE = 'google.spanner';
+/**
+ * The maximum number of rows that will be returned by a single query.
+ * Acts as a safety mechanism to avoid loading huge result sets in memory.
+ */
+export const SPANNER_QUERY_RECORDS_LIMIT = 100_000;
+/**
+ * Implements {@link DatabaseQueryRecords} for Spanner databases.
+ *
+ * The Spanner instance and GCP project are read from the workspace configuration. The `database` input is the name of
+ * the database within the instance, and `query` is a regular SQL statement.
+ *
+ * Results are streamed and capped to {@link SPANNER_QUERY_RECORDS_LIMIT} rows.
+ */
+export class DatabaseQueryRecordsForSpanner extends DatabaseQueryRecords {
+    async _call() {
+        return await callDeferred(this, import.meta.url);
+    }
+    _supports() {
+        return this.engine === SPANNER_ENGINE;
+    }
+}

package/dist/functions/google-spanner/write-databases.d.ts

@@ -1,4 +1,4 @@
-import { type ProcessorResult, WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+import { type ProcessorResult, WorkspaceFunction } from '@causa/workspace';
 import type { InfrastructureProcessor } from '@causa/workspace-core';
 /**
  * A function that uses {@link GoogleSpannerListDatabases} to find all the Spanner databases in the workspace, and
@@ -13,10 +13,9 @@ export declare class GoogleSpannerWriteDatabases extends WorkspaceFunction<Promi
      * Returns the path to the directory where Spanner databases configurations should be written.
      * It is either fetched from the workspace configuration, or the default value is used.
      *
-     * @param context The {@link WorkspaceContext}.
      * @returns The path to the directory where database configurations should be written.
      */
     private getConfigurationsDirectory;
-    _call(context: WorkspaceContext): Promise<ProcessorResult>;
+    _call(): Promise<ProcessorResult>;
     _supports(): boolean;
 }

package/dist/functions/google-spanner/write-databases.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { WorkspaceContext, WorkspaceFunction, } from '@causa/workspace';
+import { WorkspaceFunction } from '@causa/workspace';
 import { CAUSA_FOLDER } from '@causa/workspace/initialization';
 import { AllowMissing } from '@causa/workspace/validation';
 import { IsBoolean } from 'class-validator';
@@ -31,31 +31,30 @@ export class GoogleSpannerWriteDatabases extends WorkspaceFunction {
      * Returns the path to the directory where Spanner databases configurations should be written.
      * It is either fetched from the workspace configuration, or the default value is used.
      *
-     * @param context The {@link WorkspaceContext}.
      * @returns The path to the directory where database configurations should be written.
      */
-    getConfigurationsDirectory(context) {
-        return (context
+    getConfigurationsDirectory() {
+        return (this._context
             .asConfiguration()
             .get('google.spanner.databaseConfigurationsDirectory') ??
             DEFAULT_DATABASE_CONFIGURATIONS_DIRECTORY);
     }
-    async _call(context) {
-        const databaseConfigurationsDirectory = this.getConfigurationsDirectory(context);
-        const absoluteDir = join(context.rootPath, databaseConfigurationsDirectory);
+    async _call() {
+        const databaseConfigurationsDirectory = this.getConfigurationsDirectory();
+        const absoluteDir = join(this._context.rootPath, databaseConfigurationsDirectory);
         await rm(absoluteDir, { recursive: true, force: true });
         if (this.tearDown) {
-            context.logger.debug(`️🗃️ Tore down Spanner database configurations directory '${absoluteDir}'.`);
+            this._context.logger.debug(`️🗃️ Tore down Spanner database configurations directory '${absoluteDir}'.`);
             return { configuration: {} };
         }
-        context.logger.info('🗃️ Listing and writing Spanner database configurations.');
-        const databases = await context.call(GoogleSpannerListDatabases, {});
+        this._context.logger.info('🗃️ Listing and writing Spanner database configurations.');
+        const databases = await this._context.call(GoogleSpannerListDatabases, {});
         await mkdir(absoluteDir, { recursive: true });
-        context.logger.debug(`🗃️ Writing configurations for Spanner databases: ${databases
+        this._context.logger.debug(`🗃️ Writing configurations for Spanner databases: ${databases
             .map((d) => `'${d.id}'`)
             .join(', ')}.`);
         await Promise.all(databases.map((database) => writeFile(join(absoluteDir, `${database.id}.json`), JSON.stringify(database))));
-        context.logger.debug(`🗃️ Wrote Spanner database configurations in '${absoluteDir}'.`);
+        this._context.logger.debug(`🗃️ Wrote Spanner database configurations in '${absoluteDir}'.`);
         return {
             configuration: {
                 google: { spanner: { databaseConfigurationsDirectory } },

package/dist/functions/index.js

@@ -1,16 +1,17 @@
 import { CausaListConfigurationSchemasForGoogle } from './causa/index.js';
 import { EmulatorStartForFirebaseStorage, EmulatorStartForFirestore, EmulatorStartForIdentityPlatform, EmulatorStartForPubSub, EmulatorStartForSpanner, EmulatorStopForFirebaseStorage, EmulatorStopForFirestore, EmulatorStopForIdentityPlatform, EmulatorStopForPubSub, EmulatorStopForSpanner, } from './emulator/index.js';
-import { EventTopicBrokerCreateTopicForPubSub, EventTopicBrokerCreateTriggerForCloudRun, EventTopicBrokerDeleteTopicForPubSub, EventTopicBrokerDeleteTriggerResourceForCloudRunInvokerRole, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, EventTopicCreateBackfillSourceForBigQuery, } from './event-topic/index.js';
+import { EventTopicBrokerCreateTopicForPubSub, EventTopicBrokerCreateTriggerForCloudRun, EventTopicBrokerDeleteTopicForPubSub, EventTopicBrokerDeleteTriggerResourceForCloudRunInvokerRole, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, EventTopicCreateBackfillSourceForBigQuery, EventTopicQueryEventsForBigQuery, } from './event-topic/index.js';
 import { GoogleAppCheckGenerateToken } from './google-app-check/index.js';
 import { GoogleFirebaseStorageMergeRules } from './google-firebase-storage/index.js';
-import { GoogleFirestoreMergeRules } from './google-firestore/index.js';
+import { DatabaseQueryRecordsForFirestore, GoogleFirestoreMergeRules, ModelSchemaExtractDatabaseForGoogleFirestore, } from './google-firestore/index.js';
 import { GoogleIdentityPlatformGenerateCustomToken, GoogleIdentityPlatformGenerateToken, } from './google-identity-platform/index.js';
 import { GooglePubSubWriteTopics } from './google-pubsub/index.js';
 import { GoogleServicesEnable } from './google-services/index.js';
-import { GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, } from './google-spanner/index.js';
+import { DatabaseQueryRecordsForSpanner, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, ModelSchemaExtractDatabaseForGoogleSpanner, } from './google-spanner/index.js';
 import { ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, } from './project/index.js';
 import { SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, } from './secret/index.js';
+import { ServiceContainerQueryLogsForCloudRun } from './service-container/index.js';
 import { TypeScriptGetDecoratorRendererForGoogleFirestore, TypeScriptGetDecoratorRendererForGoogleSpanner, } from './typescript/index.js';
 export function registerFunctions(context) {
-    context.registerFunctionImplementations(CausaListConfigurationSchemasForGoogle, EmulatorStartForFirebaseStorage, EmulatorStartForFirestore, EmulatorStartForIdentityPlatform, EmulatorStartForPubSub, EmulatorStartForSpanner, EmulatorStopForFirebaseStorage, EmulatorStopForFirestore, EmulatorStopForIdentityPlatform, EmulatorStopForPubSub, EmulatorStopForSpanner, EventTopicBrokerCreateTopicForPubSub, EventTopicBrokerCreateTriggerForCloudRun, EventTopicBrokerDeleteTopicForPubSub, EventTopicBrokerDeleteTriggerResourceForCloudRunInvokerRole, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, EventTopicCreateBackfillSourceForBigQuery, GoogleAppCheckGenerateToken, GoogleFirebaseStorageMergeRules, GoogleFirestoreMergeRules, GoogleIdentityPlatformGenerateCustomToken, GoogleIdentityPlatformGenerateToken, GooglePubSubWriteTopics, GoogleServicesEnable, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, TypeScriptGetDecoratorRendererForGoogleFirestore, TypeScriptGetDecoratorRendererForGoogleSpanner);
+    context.registerFunctionImplementations(CausaListConfigurationSchemasForGoogle, DatabaseQueryRecordsForFirestore, DatabaseQueryRecordsForSpanner, EmulatorStartForFirebaseStorage, EmulatorStartForFirestore, EmulatorStartForIdentityPlatform, EmulatorStartForPubSub, EmulatorStartForSpanner, EmulatorStopForFirebaseStorage, EmulatorStopForFirestore, EmulatorStopForIdentityPlatform, EmulatorStopForPubSub, EmulatorStopForSpanner, EventTopicBrokerCreateTopicForPubSub, EventTopicBrokerCreateTriggerForCloudRun, EventTopicBrokerDeleteTopicForPubSub, EventTopicBrokerDeleteTriggerResourceForCloudRunInvokerRole, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, EventTopicCreateBackfillSourceForBigQuery, EventTopicQueryEventsForBigQuery, GoogleAppCheckGenerateToken, GoogleFirebaseStorageMergeRules, GoogleFirestoreMergeRules, GoogleIdentityPlatformGenerateCustomToken, GoogleIdentityPlatformGenerateToken, GooglePubSubWriteTopics, GoogleServicesEnable, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, ModelSchemaExtractDatabaseForGoogleFirestore, ModelSchemaExtractDatabaseForGoogleSpanner, ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, ServiceContainerQueryLogsForCloudRun, TypeScriptGetDecoratorRendererForGoogleFirestore, TypeScriptGetDecoratorRendererForGoogleSpanner);
 }

package/dist/functions/project/get-artefact-destination-cloud-functions.d.ts

@@ -1,4 +1,3 @@
-import { WorkspaceContext } from '@causa/workspace';
 import { ProjectGetArtefactDestination } from '@causa/workspace-core';
 /**
  * Implements the {@link ProjectGetArtefactDestination} function for Cloud Functions projects.
@@ -6,6 +5,6 @@ import { ProjectGetArtefactDestination } from '@causa/workspace-core';
  * defined in the `google.cloudFunctions.artefactStorage` configuration.
  */
 export declare class ProjectGetArtefactDestinationForCloudFunctions extends ProjectGetArtefactDestination {
-    _call(context: WorkspaceContext): Promise<string>;
-    _supports(context: WorkspaceContext): boolean;
+    _call(): Promise<string>;
+    _supports(): boolean;
 }

package/dist/functions/project/get-artefact-destination-cloud-functions.js

@@ -1,4 +1,3 @@
-import { WorkspaceContext } from '@causa/workspace';
 import { ProjectGetArtefactDestination, } from '@causa/workspace-core';
 /**
  * Implements the {@link ProjectGetArtefactDestination} function for Cloud Functions projects.
@@ -6,9 +5,9 @@ import { ProjectGetArtefactDestination, } from '@causa/workspace-core';
  * defined in the `google.cloudFunctions.artefactStorage` configuration.
  */
 export class ProjectGetArtefactDestinationForCloudFunctions extends ProjectGetArtefactDestination {
-    async _call(context) {
-        const projectName = context.getOrThrow('project.name');
-        const googleConf = context.asConfiguration();
+    async _call() {
+        const projectName = this._context.getOrThrow('project.name');
+        const googleConf = this._context.asConfiguration();
         let bucketAndPrefix = googleConf.getOrThrow('google.cloudFunctions.artefactStorage.bucket');
         const archivesStoragePrefix = googleConf.get('google.cloudFunctions.artefactStorage.prefix');
         if (archivesStoragePrefix) {
@@ -16,8 +15,8 @@ export class ProjectGetArtefactDestinationForCloudFunctions extends ProjectGetAr
         }
         return `gs://${bucketAndPrefix}/${projectName}/${this.tag}.zip`;
     }
-    _supports(context) {
-        const conf = context.asConfiguration();
+    _supports() {
+        const conf = this._context.asConfiguration();
         return (conf.get('project.type') === 'serverlessFunctions' &&
             conf.get('serverlessFunctions.platform') === 'google.cloudFunctions');
     }

package/dist/functions/project/get-artefact-destination-cloud-run.d.ts

@@ -1,10 +1,9 @@
-import { WorkspaceContext } from '@causa/workspace';
 import { ProjectGetArtefactDestination } from '@causa/workspace-core';
 /**
  * Implements the {@link ProjectGetArtefactDestination} function for Cloud Run services.
  * The destination Docker repository is expected to be defined in `google.cloudRun.dockerRepository`.
  */
 export declare class ProjectGetArtefactDestinationForCloudRun extends ProjectGetArtefactDestination {
-    _call(context: WorkspaceContext): Promise<string>;
-    _supports(context: WorkspaceContext): boolean;
+    _call(): Promise<string>;
+    _supports(): boolean;
 }