@causa/workspace-google 0.17.0 → 0.18.0-beta.2

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/generate-typescript-decorators.d.ts

@@ -0,0 +1,14 @@
+import { ModelGenerateTypeScriptDecorators } from '@causa/workspace-typescript';
+import { type TypeScriptDecorator } from '@causa/workspace-typescript/code-generation';
+/**
+ * Implements {@link ModelGenerateTypeScriptDecorators} to add Google Spanner decorators from the Causa Google runtime.
+ *
+ * If an object schema is marked with the `googleSpannerTable` extension, the `@SpannerTable` decorator is added to the
+ * class, and `@SpannerColumn` decorators are added to all its properties.
+ */
+export declare class ModelGenerateTypeScriptDecoratorsForGoogleSpanner extends ModelGenerateTypeScriptDecorators {
+    _call(): TypeScriptDecorator[];
+    _supports(): boolean;
+    private decoratorsForClass;
+    private decoratorsForProperty;
+}

package/dist/functions/google-spanner/generate-typescript-decorators.js

@@ -0,0 +1,120 @@
+import { ModelGenerateTypeScriptDecorators } from '@causa/workspace-typescript';
+import { addDecoratorToList, } from '@causa/workspace-typescript/code-generation';
+import micromatch from 'micromatch';
+import { join } from 'path';
+/**
+ * The name of the Causa extension marking an object schema as a Google Spanner table.
+ */
+const GOOGLE_SPANNER_TABLE_EXTENSION = 'googleSpannerTable';
+/**
+ * The name of the optional Causa extension that can be present on an object property schema to specify options for the
+ * `@SpannerColumn` decorator.
+ */
+const GOOGLE_SPANNER_COLUMN_EXTENSION = 'googleSpannerColumn';
+/**
+ * The name of the Causa module for the TypeScript Google runtime.
+ */
+const CAUSA_GOOGLE_MODULE = '@causa/runtime-google';
+/**
+ * The list of options that can be passed to the `@SpannerColumn` decorator and that indicates that the schema specifies
+ * the type of the column. In this case, the renderer should not infer any type information.
+ */
+const TYPE_INFO_COLUMN_ATTRIBUTE_NAMES = [
+    'isBigInt',
+    'isInt',
+    'isPreciseDate',
+    'isJson',
+];
+/**
+ * Implements {@link ModelGenerateTypeScriptDecorators} to add Google Spanner decorators from the Causa Google runtime.
+ *
+ * If an object schema is marked with the `googleSpannerTable` extension, the `@SpannerTable` decorator is added to the
+ * class, and `@SpannerColumn` decorators are added to all its properties.
+ */
+export class ModelGenerateTypeScriptDecoratorsForGoogleSpanner extends ModelGenerateTypeScriptDecorators {
+    _call() {
+        const tableAttribute = this.schema.extensions[GOOGLE_SPANNER_TABLE_EXTENSION];
+        if (!tableAttribute) {
+            return [];
+        }
+        const globs = this.configuration?.google?.spanner?.globs;
+        if (Array.isArray(globs)) {
+            const projectPath = this._context.getProjectPathOrThrow();
+            const absoluteGlobs = globs.map((g) => join(projectPath, g));
+            const schemaPath = this.schema.path.split('#')[0];
+            if (!micromatch.isMatch(schemaPath, absoluteGlobs)) {
+                return [];
+            }
+        }
+        return this.property
+            ? this.decoratorsForProperty()
+            : this.decoratorsForClass(tableAttribute);
+    }
+    _supports() {
+        return (this._context.get('project.language') === 'typescript' &&
+            this.generator === 'typescriptModelClass');
+    }
+    decoratorsForClass(tableAttribute) {
+        const debugName = this.schema.name;
+        if (typeof tableAttribute !== 'object' ||
+            tableAttribute === null ||
+            !('primaryKey' in tableAttribute) ||
+            !Array.isArray(tableAttribute.primaryKey) ||
+            tableAttribute.primaryKey.length === 0 ||
+            tableAttribute.primaryKey.some((k) => typeof k !== 'string')) {
+            throw new Error(`Invalid '${GOOGLE_SPANNER_TABLE_EXTENSION}' attribute on '${debugName}'. Expected an object with a 'primaryKey' array.`);
+        }
+        const { primaryKey, name } = tableAttribute;
+        if (name !== undefined && typeof name !== 'string') {
+            throw new Error(`Invalid 'name' in '${GOOGLE_SPANNER_TABLE_EXTENSION}' attribute on '${debugName}'. Expected a string.`);
+        }
+        const decorators = [];
+        addDecoratorToList(decorators, { schema: this.schema }, 'SpannerTable', CAUSA_GOOGLE_MODULE, `@SpannerTable(${JSON.stringify({ primaryKey, name })})`);
+        return decorators;
+    }
+    decoratorsForProperty() {
+        const property = this.property;
+        const rawAttributes = property.extensions[GOOGLE_SPANNER_COLUMN_EXTENSION] ?? {};
+        if (typeof rawAttributes !== 'object' || rawAttributes === null) {
+            throw new Error(`Invalid '${GOOGLE_SPANNER_COLUMN_EXTENSION}' attribute on '${this.schema.name}.${property.name}'. Expected an object.`);
+        }
+        const { name: overriddenName, tsOptions } = rawAttributes;
+        if (tsOptions !== undefined &&
+            (typeof tsOptions !== 'object' || tsOptions === null)) {
+            throw new Error(`Invalid 'tsOptions' in '${GOOGLE_SPANNER_COLUMN_EXTENSION}' attribute. Expected an object.`);
+        }
+        const columnAttributes = {
+            ...(tsOptions ?? {}),
+        };
+        if (overriddenName !== undefined) {
+            if (typeof overriddenName !== 'string') {
+                throw new Error(`Invalid 'name' in '${GOOGLE_SPANNER_COLUMN_EXTENSION}' attribute. Expected a string.`);
+            }
+            columnAttributes.name = overriddenName;
+        }
+        const softDeletionColumn = this.configuration?.google?.spanner
+            ?.softDeletionColumn;
+        const columnName = typeof overriddenName === 'string' ? overriddenName : property.name;
+        if (columnName === softDeletionColumn) {
+            columnAttributes.softDelete = true;
+        }
+        const schemaOverridesTypeInfo = TYPE_INFO_COLUMN_ATTRIBUTE_NAMES.some((n) => n in columnAttributes);
+        if (!schemaOverridesTypeInfo) {
+            const type = property.type.kind === 'array' ? property.type.items : property.type;
+            const resolved = type.kind === 'ref' ? this.schemas[type.ref] : undefined;
+            if (type.kind === 'primitive' && type.type === 'integer') {
+                columnAttributes.isInt = true;
+            }
+            else if (type.kind === 'map' || resolved?.kind === 'object') {
+                columnAttributes.isJson = true;
+            }
+        }
+        const hasOptions = Object.keys(columnAttributes).length > 0;
+        const source = hasOptions
+            ? `@SpannerColumn(${JSON.stringify(columnAttributes)})`
+            : '@SpannerColumn()';
+        const decorators = [];
+        addDecoratorToList(decorators, { schema: this.schema, property }, 'SpannerColumn', CAUSA_GOOGLE_MODULE, source);
+        return decorators;
+    }
+}

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

@@ -1,3 +1,5 @@
+export { ModelSchemaExtractDatabaseForGoogleSpanner } from './extract-database.js';
+export { ModelGenerateTypeScriptDecoratorsForGoogleSpanner } from './generate-typescript-decorators.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,3 +1,5 @@
+export { ModelSchemaExtractDatabaseForGoogleSpanner } from './extract-database.js';
+export { ModelGenerateTypeScriptDecoratorsForGoogleSpanner } from './generate-typescript-decorators.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

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

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

@@ -1,16 +1,16 @@
 import { Numeric, PGNumeric, Spanner, SpannerDate, } from '@google-cloud/spanner';
 import { SPANNER_QUERY_RECORDS_LIMIT, } from './query-records.js';
-export default async function call(context) {
+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 = context.asConfiguration();
+    const googleConf = this._context.asConfiguration();
     const projectId = googleConf.getOrThrow('google.project');
     const instanceName = googleConf.getOrThrow('google.spanner.instance.name');
-    context.logger.debug(`🗃️ Querying Spanner database '${this.database}' in instance '${instanceName}' (project '${projectId}').`);
+    this._context.logger.debug(`🗃️ Querying Spanner database '${this.database}' in instance '${instanceName}' (project '${projectId}').`);
     const spanner = new Spanner({ projectId });
     let database;
     try {
@@ -23,7 +23,7 @@ export default async function call(context) {
         });
         for await (const row of stream) {
             if (rows.length >= SPANNER_QUERY_RECORDS_LIMIT) {
-                context.logger.warn(`⚠️ Spanner query exceeded the hard limit of ${SPANNER_QUERY_RECORDS_LIMIT} rows. Results were truncated.`);
+                this._context.logger.warn(`⚠️ Spanner query exceeded the hard limit of ${SPANNER_QUERY_RECORDS_LIMIT} rows. Results were truncated.`);
                 break;
             }
             rows.push(toJson(row));

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

@@ -1,4 +1,3 @@
-import { WorkspaceContext } from '@causa/workspace';
 import { DatabaseQueryRecords } from '@causa/workspace-core';
 /**
  * The engine identifier handled by this implementation.
@@ -18,6 +17,6 @@ export declare const SPANNER_QUERY_RECORDS_LIMIT = 100000;
  * Results are streamed and capped to {@link SPANNER_QUERY_RECORDS_LIMIT} rows.
  */
 export declare class DatabaseQueryRecordsForSpanner extends DatabaseQueryRecords {
-    _call(context: WorkspaceContext): Promise<any[]>;
+    _call(): Promise<any[]>;
     _supports(): boolean;
 }

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

@@ -1,4 +1,4 @@
-import { callDeferred, WorkspaceContext } from '@causa/workspace';
+import { callDeferred } from '@causa/workspace';
 import { DatabaseQueryRecords } from '@causa/workspace-core';
 /**
  * The engine identifier handled by this implementation.
@@ -18,8 +18,8 @@ export const SPANNER_QUERY_RECORDS_LIMIT = 100_000;
  * Results are streamed and capped to {@link SPANNER_QUERY_RECORDS_LIMIT} rows.
  */
 export class DatabaseQueryRecordsForSpanner extends DatabaseQueryRecords {
-    async _call(context) {
-        return await callDeferred(this, context, import.meta.url);
+    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

@@ -3,15 +3,14 @@ import { EmulatorStartForFirebaseStorage, EmulatorStartForFirestore, EmulatorSta
 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 { DatabaseQueryRecordsForFirestore, GoogleFirestoreMergeRules, } from './google-firestore/index.js';
+import { DatabaseQueryRecordsForFirestore, GoogleFirestoreMergeRules, ModelGenerateTypeScriptDecoratorsForGoogleFirestore, 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 { DatabaseQueryRecordsForSpanner, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, } from './google-spanner/index.js';
+import { DatabaseQueryRecordsForSpanner, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, ModelGenerateTypeScriptDecoratorsForGoogleSpanner, 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, 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, ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, ServiceContainerQueryLogsForCloudRun, 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, ModelGenerateTypeScriptDecoratorsForGoogleFirestore, ModelGenerateTypeScriptDecoratorsForGoogleSpanner, ModelSchemaExtractDatabaseForGoogleFirestore, ModelSchemaExtractDatabaseForGoogleSpanner, ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, ServiceContainerQueryLogsForCloudRun);
 }