@causa/workspace-google 0.9.3 → 0.10.0

package/README.md

@@ -85,28 +85,72 @@ secrets:
 
 ### Code generation
 
-This module implements the `google.spanner` TypeScript decorator renderer, which can be used to add `@SpannerTable` and `@SpannerColumn` decorators to classes generated from events. Below is an example of how to enable it for a JSONSchema object:
+This module provides TypeScript decorator renderers for Spanner and Firestore, which can be used to add `@SpannerTable`, `@SpannerColumn`, `@FirestoreCollection`, and `@SoftDeletedFirestoreCollection` decorators to classes generated from events. Below is an example of how to enable it for a JSONSchema object:
 
 ```yaml
-title: MyClass
+title: MySpannerTable
 type: object
 additionalProperties: false
 causa:
   # This must be set for the decorators to be added to both the class and its properties.
   # The content of the object will be passed as the argument to the `@SpannerTable` decorator.
-  tsGoogleSpannerTable:
+  googleSpannerTable:
     primaryKey: [id]
 properties:
   id:
     type: string
     format: uuid
-    # In most cases, the property-level `tsGoogleSpannerColumn` attribute does not need to be set. The decorator configuration will be automatically inferred.
-    # If needed, the content of `tsGoogleSpannerColumn` will be passed as the argument to the `@SpannerColumn` decorator.
+    # In most cases, the property-level `googleSpannerColumn` attribute does not need to be set. The decorator configuration will be automatically inferred.
+    # If needed, the content of `googleSpannerColumn` will be passed as the argument to the `@SpannerColumn` decorator.
     # causa:
-    #   tsGoogleSpannerColumn:
+    #   googleSpannerColumn:
     #     isJson: false
   myProperty:
     type: string
+
+---
+title: MyFirestoreDocument
+type: object
+additionalProperties: false
+causa:
+  # This must be set for the decorators to be added to the class.
+  googleFirestoreCollection:
+    # Mandatory, the name of the Firestore collection.
+    name: myCollection
+    # Mandatory, determines how to create the path for a document.
+    path: [property: id]
+    # This could also contain plain strings, e.g. for `{id}/subCollection/{otherProp}`:
+    # path: [property: id, subCollection, property: otherProp]
+    # Optional, adds the `@SoftDeletedFirestoreCollection` decorator.
+    hasSoftDelete: true
+properties:
+  id:
+    type: string
+  otherProp:
+    type: string
+```
+
+To restrict the decorator to some schema files, you can configure the parent `typescriptModelClass` generator:
+
+```yaml
+model:
+  codeGenerators:
+    - generator: typescriptModelClass
+
+      # ...Rest of the configuration...
+
+      google:
+        spanner:
+          # Decorators will only be added to the schemas in those files, relative to the project directory.
+          globs:
+            - ../entities/*.yaml
+          # The name of the property / column to which the `softDelete` option should be added.
+          softDeletionColumn: deletedAt
+
+        firestore:
+          # Same as Spanner globs.
+          globs:
+            - ../firestore/*.yaml
 ```
 
 ## 🔨 Custom `google` commands

package/dist/backfilling/pubsub.js

@@ -7,8 +7,8 @@ import { PubSubService } from '../services/index.js';
  */
 const PUBLISH_OPTIONS = {
     flowControlOptions: {
-        maxOutstandingBytes: 512 * 1024 * 1024,
-        maxOutstandingMessages: 100000,
+        maxOutstandingBytes: 10 * 1024 * 1024,
+        maxOutstandingMessages: 1000,
     },
     batching: {
         maxBytes: 10 * 1024 * 1024,

package/dist/code-generation/google-firestore-renderer.d.ts

@@ -0,0 +1,12 @@
+import { type ClassContext, type TypeScriptDecorator, TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript';
+/**
+ * A {@link TypeScriptDecoratorsRenderer} that adds Google Firestore decorators from the Causa Google runtime.
+ *
+ * If an object schema is marked with the `googleFirestoreCollection` attribute, the `@FirestoreCollection` decorator
+ * is added to the class. If the `hasSoftDelete` property is `true`, the `@SoftDeletedFirestoreCollection` decorator
+ * is also added.
+ */
+export declare class GoogleFirestoreRenderer extends TypeScriptWithDecoratorsRenderer {
+    decoratorsForClass(context: ClassContext): TypeScriptDecorator[];
+    decoratorsForProperty(): TypeScriptDecorator[];
+}

package/dist/code-generation/google-firestore-renderer.js

@@ -0,0 +1,90 @@
+import { TypeScriptWithDecoratorsRenderer, } from '@causa/workspace-typescript';
+import { Name, panic } from 'quicktype-core';
+import { schemaMatchesGlobPatterns } from './utils.js';
+/**
+ * The name of the Causa attribute that should be present for a class to be decorated with Google Firestore decorators.
+ */
+const GOOGLE_FIRESTORE_COLLECTION_ATTRIBUTE = 'googleFirestoreCollection';
+/**
+ * The name of the Causa module for the TypeScript Google runtime.
+ */
+const CAUSA_GOOGLE_MODULE = '@causa/runtime-google';
+/**
+ * A {@link TypeScriptDecoratorsRenderer} that adds Google Firestore decorators from the Causa Google runtime.
+ *
+ * If an object schema is marked with the `googleFirestoreCollection` attribute, the `@FirestoreCollection` decorator
+ * is added to the class. If the `hasSoftDelete` property is `true`, the `@SoftDeletedFirestoreCollection` decorator
+ * is also added.
+ */
+export class GoogleFirestoreRenderer extends TypeScriptWithDecoratorsRenderer {
+    decoratorsForClass(context) {
+        const collectionAttribute = context.objectAttributes[GOOGLE_FIRESTORE_COLLECTION_ATTRIBUTE];
+        const globs = this.targetLanguage.options.generatorOptions?.google?.firestore?.globs;
+        if (!collectionAttribute ||
+            !schemaMatchesGlobPatterns(this, context, globs)) {
+            return [];
+        }
+        const debugName = context.classType.getCombinedName();
+        if (typeof collectionAttribute !== 'object') {
+            panic(`Invalid '${GOOGLE_FIRESTORE_COLLECTION_ATTRIBUTE}' attribute on '${debugName}'. Expected an object.`);
+        }
+        const { name, path, hasSoftDelete } = collectionAttribute;
+        if (typeof name !== 'string') {
+            panic(`Invalid '${GOOGLE_FIRESTORE_COLLECTION_ATTRIBUTE}' attribute on '${debugName}'. Expected an object with a 'name' string property.`);
+        }
+        if (!Array.isArray(path)) {
+            panic(`Invalid '${GOOGLE_FIRESTORE_COLLECTION_ATTRIBUTE}' attribute on '${debugName}'. Expected an object with a 'path' array property.`);
+        }
+        const requiredProperties = path.flatMap((e) => typeof e === 'object' &&
+            e !== null &&
+            'property' in e &&
+            typeof e.property === 'string'
+            ? [e.property]
+            : []);
+        const propertyReferences = new Map();
+        this.forEachClassProperty(context.classType, 'none', (name, jsonName) => {
+            if (requiredProperties.includes(jsonName)) {
+                propertyReferences.set(jsonName, name);
+            }
+        });
+        for (const propertyName of requiredProperties) {
+            if (!propertyReferences.has(propertyName)) {
+                panic(`Property '${propertyName}' referenced in 'path' not found in '${debugName}'.`);
+            }
+        }
+        const elements = path.map((element) => {
+            if (typeof element === 'string') {
+                return JSON.stringify(element);
+            }
+            if (typeof element === 'object' &&
+                element !== null &&
+                'property' in element) {
+                const propertyName = element.property;
+                const generatedName = propertyReferences.get(propertyName);
+                if (!generatedName) {
+                    panic(`Property '${propertyName}' not found in property references.`);
+                }
+                return ['doc.', generatedName];
+            }
+            panic(`Invalid path element in '${GOOGLE_FIRESTORE_COLLECTION_ATTRIBUTE}' attribute on '${debugName}'.`);
+        });
+        const pathExpression = path.length === 1
+            ? elements
+            : ['[', ...elements.flatMap((e) => [e, ', ']), "].join('/')"];
+        const decorators = [];
+        this.addDecoratorToList(decorators, context, 'FirestoreCollection', CAUSA_GOOGLE_MODULE, [
+            '@FirestoreCollection({ name: ',
+            JSON.stringify(name),
+            ', path: (doc) => ',
+            ...pathExpression,
+            '})',
+        ]);
+        if (hasSoftDelete === true) {
+            this.addDecoratorToList(decorators, context, 'SoftDeletedFirestoreCollection', CAUSA_GOOGLE_MODULE, ['@SoftDeletedFirestoreCollection()']);
+        }
+        return decorators;
+    }
+    decoratorsForProperty() {
+        return [];
+    }
+}

package/dist/code-generation/google-spanner-renderer.d.ts

@@ -1,11 +1,11 @@
-import { type ClassContext, type ClassPropertyContext, type TypeScriptDecorator, TypeScriptDecoratorsRenderer } from '@causa/workspace-typescript';
+import { type ClassContext, type ClassPropertyContext, type TypeScriptDecorator, TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript';
 /**
  * A {@link TypeScriptDecoratorsRenderer} that adds Google Spanner decorators from the Causa Google runtime.
  *
- * If an object schema is marked with the `tsGoogleSpannerTable` attribute, the `@SpannerTable` decorator is added to
- * the class, and `@SpannerColumn` decorators are added to all its properties.
+ * If an object schema is marked with the `googleSpannerTable` attribute, the `@SpannerTable` decorator is added to the
+ * class, and `@SpannerColumn` decorators are added to all its properties.
  */
-export declare class GoogleSpannerRenderer extends TypeScriptDecoratorsRenderer {
+export declare class GoogleSpannerRenderer extends TypeScriptWithDecoratorsRenderer {
     decoratorsForClass(context: ClassContext): TypeScriptDecorator[];
     decoratorsForProperty(context: ClassPropertyContext): TypeScriptDecorator[];
 }

package/dist/code-generation/google-spanner-renderer.js

@@ -1,24 +1,15 @@
-import { TypeScriptDecoratorsRenderer, getSingleType, typeScriptSourceForObject, } from '@causa/workspace-typescript';
+import { TypeScriptWithDecoratorsRenderer, getSingleType, typeScriptSourceForObject, } from '@causa/workspace-typescript';
 import { panic } from 'quicktype-core';
+import { schemaMatchesGlobPatterns } from './utils.js';
 /**
  * The name of the Causa attribute that should be present for a class to be decorated with Google Spanner decorators.
  */
-const GOOGLE_SPANNER_TABLE_ATTRIBUTE = 'tsGoogleSpannerTable';
-/**
- * The name of the Causa attribute that can be present on a class to only generate `@SpannerColumn` decorators for its
- * properties, but not a `@SpannerTable` decorator for the class itself.
- */
-const GOOGLE_SPANNER_NESTED_TYPE_ATTRIBUTE = 'tsGoogleSpannerNestedType';
+const GOOGLE_SPANNER_TABLE_ATTRIBUTE = 'googleSpannerTable';
 /**
  * The name of the optional Causa attribute that can be present on an object property schema to specify options for the
  * `@SpannerColumn` decorator.
  */
-const GOOGLE_SPANNER_COLUMN_ATTRIBUTE = 'tsGoogleSpannerColumn';
-/**
- * The name of the `decoratorOptions` key that can be used to specify the name of the property that should be used as
- * the soft deletion column.
- */
-const GOOGLE_SPANNER_SOFT_DELETION_COLUMN_OPTION = 'googleSpannerSoftDeletionColumn';
+const GOOGLE_SPANNER_COLUMN_ATTRIBUTE = 'googleSpannerColumn';
 /**
  * The name of the Causa module for the TypeScript Google runtime.
  */
@@ -28,8 +19,6 @@ const CAUSA_GOOGLE_MODULE = '@causa/runtime-google';
  * specifies the type of the column. In this case, the renderer should not infer any type information.
  */
 const TYPE_INFO_COLUMN_ATTRIBUTE_NAMES = [
-    'nestedType',
-    'nullifyNested',
     'isBigInt',
     'isInt',
     'isPreciseDate',
@@ -38,55 +27,73 @@ const TYPE_INFO_COLUMN_ATTRIBUTE_NAMES = [
 /**
  * A {@link TypeScriptDecoratorsRenderer} that adds Google Spanner decorators from the Causa Google runtime.
  *
- * If an object schema is marked with the `tsGoogleSpannerTable` attribute, the `@SpannerTable` decorator is added to
- * the class, and `@SpannerColumn` decorators are added to all its properties.
+ * If an object schema is marked with the `googleSpannerTable` attribute, the `@SpannerTable` decorator is added to the
+ * class, and `@SpannerColumn` decorators are added to all its properties.
  */
-export class GoogleSpannerRenderer extends TypeScriptDecoratorsRenderer {
+export class GoogleSpannerRenderer extends TypeScriptWithDecoratorsRenderer {
     decoratorsForClass(context) {
         const tableAttribute = context.objectAttributes[GOOGLE_SPANNER_TABLE_ATTRIBUTE];
-        if (!tableAttribute) {
+        const globs = this.targetLanguage.options.generatorOptions?.google?.spanner?.globs;
+        if (!tableAttribute || !schemaMatchesGlobPatterns(this, context, globs)) {
             return [];
         }
         if (typeof tableAttribute !== 'object' ||
             !('primaryKey' in tableAttribute) ||
-            !Array.isArray(tableAttribute.primaryKey)) {
-            panic(`Invalid ${GOOGLE_SPANNER_TABLE_ATTRIBUTE} attribute on ${context.classType.getNames()}`);
+            !Array.isArray(tableAttribute.primaryKey) ||
+            tableAttribute.primaryKey.length === 0 ||
+            tableAttribute.primaryKey.some((k) => typeof k !== 'string')) {
+            panic(`Invalid '${GOOGLE_SPANNER_TABLE_ATTRIBUTE}' attribute on '${context.classType.getCombinedName()}'. Expected an object with a 'primaryKey' array.`);
+        }
+        if ('name' in tableAttribute && typeof tableAttribute.name !== 'string') {
+            panic(`Invalid 'name' in '${GOOGLE_SPANNER_TABLE_ATTRIBUTE}' attribute on '${context.classType.getCombinedName()}'. Expected a string.`);
         }
-        const optionsSource = typeScriptSourceForObject(tableAttribute);
+        const optionsSource = typeScriptSourceForObject({
+            primaryKey: tableAttribute.primaryKey,
+            name: tableAttribute.name,
+        });
         const decorators = [];
         this.addDecoratorToList(decorators, context, 'SpannerTable', CAUSA_GOOGLE_MODULE, ['@SpannerTable(', optionsSource, ')']);
         return decorators;
     }
     decoratorsForProperty(context) {
-        if (!context.objectAttributes[GOOGLE_SPANNER_TABLE_ATTRIBUTE] &&
-            !context.objectAttributes[GOOGLE_SPANNER_NESTED_TYPE_ATTRIBUTE]) {
+        const globs = this.targetLanguage.options.generatorOptions?.google?.spanner?.globs;
+        if (!context.objectAttributes[GOOGLE_SPANNER_TABLE_ATTRIBUTE] ||
+            !schemaMatchesGlobPatterns(this, context, globs)) {
             return [];
         }
-        const rawColumnAttributes = context.propertyAttributes[GOOGLE_SPANNER_COLUMN_ATTRIBUTE] ?? {};
-        const columnAttributes = typeof rawColumnAttributes === 'object' ? rawColumnAttributes : {};
-        const softDeletionColumn = this.decoratorOptions[GOOGLE_SPANNER_SOFT_DELETION_COLUMN_OPTION];
-        if (softDeletionColumn && context.jsonName === softDeletionColumn) {
+        const attributes = context.propertyAttributes[GOOGLE_SPANNER_COLUMN_ATTRIBUTE] ?? {};
+        const { generatorOptions } = this.targetLanguage.options;
+        const softDeletionColumn = generatorOptions?.google?.spanner?.softDeletionColumn;
+        const { name: overriddenName, tsOptions } = attributes;
+        if (tsOptions && typeof tsOptions !== 'object') {
+            panic(`Invalid 'tsOptions' in '${GOOGLE_SPANNER_COLUMN_ATTRIBUTE}' attribute. Expected an object.`);
+        }
+        const columnAttributes = tsOptions ?? {};
+        if (overriddenName) {
+            if (typeof overriddenName !== 'string') {
+                panic(`Invalid 'name' in '${GOOGLE_SPANNER_COLUMN_ATTRIBUTE}' attribute. Expected a string.`);
+            }
+            columnAttributes.name = overriddenName;
+        }
+        const columnName = overriddenName ?? this.names.get(context.name);
+        if (columnName === softDeletionColumn) {
             columnAttributes.softDelete = true;
         }
-        if (!context.propertyAttributes.tsType) {
-            const singleTypeInfo = getSingleType(context.property.type);
-            const schemaOverridesTypeInfo = TYPE_INFO_COLUMN_ATTRIBUTE_NAMES.some((name) => name in columnAttributes);
-            if (!schemaOverridesTypeInfo && singleTypeInfo) {
-                switch (singleTypeInfo.type.kind) {
-                    case 'class':
-                    case 'object':
-                    case 'map':
-                        columnAttributes.isJson = true;
-                        break;
-                    case 'integer':
-                        columnAttributes.isInt = true;
-                        break;
-                }
+        const singleTypeInfo = getSingleType(context.property.type);
+        const schemaOverridesTypeInfo = TYPE_INFO_COLUMN_ATTRIBUTE_NAMES.some((name) => name in columnAttributes);
+        if (!schemaOverridesTypeInfo && singleTypeInfo) {
+            switch (singleTypeInfo.type.kind) {
+                case 'class':
+                case 'object':
+                case 'map':
+                    columnAttributes.isJson = true;
+                    break;
+                case 'integer':
+                    columnAttributes.isInt = true;
+                    break;
             }
         }
-        const optionsSource = typeScriptSourceForObject(columnAttributes, {
-            encoder: (key, value) => key === 'nestedType' ? value : JSON.stringify(value),
-        });
+        const optionsSource = typeScriptSourceForObject(columnAttributes);
         const decorators = [];
         this.addDecoratorToList(decorators, context, 'SpannerColumn', CAUSA_GOOGLE_MODULE, ['@SpannerColumn(', optionsSource, ')']);
         return decorators;

package/dist/code-generation/index.d.ts

@@ -1 +1,2 @@
+export { GoogleFirestoreRenderer } from './google-firestore-renderer.js';
 export { GoogleSpannerRenderer } from './google-spanner-renderer.js';

package/dist/code-generation/index.js

@@ -1 +1,2 @@
+export { GoogleFirestoreRenderer } from './google-firestore-renderer.js';
 export { GoogleSpannerRenderer } from './google-spanner-renderer.js';

package/dist/code-generation/utils.d.ts

@@ -0,0 +1,12 @@
+import type { ClassContext } from '@causa/workspace-typescript';
+import { TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript';
+/**
+ * Checks whether the schema matches the glob patterns specified in the renderer's options.
+ * If this returns `false`, the decorators should not be generated for the schema.
+ *
+ * @param renderer The renderer instance.
+ * @param context The {@link ClassContext} of the schema to check.
+ * @param globs The glob patterns to match against, or undefined/null if not configured.
+ * @returns `true` if the decorators should be generated for the schema.
+ */
+export declare function schemaMatchesGlobPatterns(renderer: TypeScriptWithDecoratorsRenderer, context: ClassContext, globs: unknown): boolean;

package/dist/code-generation/utils.js

@@ -0,0 +1,21 @@
+import { TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript';
+import micromatch from 'micromatch';
+import { join } from 'path';
+/**
+ * Checks whether the schema matches the glob patterns specified in the renderer's options.
+ * If this returns `false`, the decorators should not be generated for the schema.
+ *
+ * @param renderer The renderer instance.
+ * @param context The {@link ClassContext} of the schema to check.
+ * @param globs The glob patterns to match against, or undefined/null if not configured.
+ * @returns `true` if the decorators should be generated for the schema.
+ */
+export function schemaMatchesGlobPatterns(renderer, context, globs) {
+    const { uri } = context;
+    if (!uri || !globs || !Array.isArray(globs)) {
+        return true;
+    }
+    const projectPath = renderer.targetLanguage.workspaceContext.getProjectPathOrThrow();
+    const absoluteGlobs = globs.map((g) => join(projectPath, g));
+    return micromatch.isMatch(uri, absoluteGlobs);
+}

package/dist/functions/index.js

@@ -9,7 +9,7 @@ import { GoogleServicesEnable } from './google-services/index.js';
 import { GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, } from './google-spanner/index.js';
 import { ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, } from './project/index.js';
 import { SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, } from './secret/index.js';
-import { TypeScriptGetDecoratorRendererForGoogleSpanner } from './typescript/index.js';
+import { TypeScriptGetDecoratorRendererForGoogleFirestore, TypeScriptGetDecoratorRendererForGoogleSpanner, } from './typescript/index.js';
 export function registerFunctions(context) {
-    context.registerFunctionImplementations(EmulatorStartForFirebaseStorage, EmulatorStartForFirestore, EmulatorStartForIdentityPlatform, EmulatorStartForPubSub, EmulatorStartForSpanner, EmulatorStopForFirebaseStorage, EmulatorStopForFirestore, EmulatorStopForIdentityPlatform, EmulatorStopForPubSub, EmulatorStopForSpanner, EventTopicBrokerCreateTopicForPubSub, EventTopicBrokerCreateTriggerForCloudRun, EventTopicBrokerDeleteTopicForPubSub, EventTopicBrokerDeleteTriggerResourceForCloudRunInvokerRole, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, GoogleAppCheckGenerateToken, GoogleFirebaseStorageMergeRules, GoogleFirestoreMergeRules, GoogleIdentityPlatformGenerateCustomToken, GoogleIdentityPlatformGenerateToken, GooglePubSubWriteTopics, GoogleServicesEnable, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, TypeScriptGetDecoratorRendererForGoogleSpanner);
+    context.registerFunctionImplementations(EmulatorStartForFirebaseStorage, EmulatorStartForFirestore, EmulatorStartForIdentityPlatform, EmulatorStartForPubSub, EmulatorStartForSpanner, EmulatorStopForFirebaseStorage, EmulatorStopForFirestore, EmulatorStopForIdentityPlatform, EmulatorStopForPubSub, EmulatorStopForSpanner, EventTopicBrokerCreateTopicForPubSub, EventTopicBrokerCreateTriggerForCloudRun, EventTopicBrokerDeleteTopicForPubSub, EventTopicBrokerDeleteTriggerResourceForCloudRunInvokerRole, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, GoogleAppCheckGenerateToken, GoogleFirebaseStorageMergeRules, GoogleFirestoreMergeRules, GoogleIdentityPlatformGenerateCustomToken, GoogleIdentityPlatformGenerateToken, GooglePubSubWriteTopics, GoogleServicesEnable, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, TypeScriptGetDecoratorRendererForGoogleFirestore, TypeScriptGetDecoratorRendererForGoogleSpanner);
 }

package/dist/functions/typescript/get-decorator-renderer-google-firestore.d.ts

@@ -0,0 +1,9 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { TypeScriptGetDecoratorRenderer, TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript';
+/**
+ * Implements {@link TypeScriptGetDecoratorRenderer} for the {@link GoogleFirestoreRenderer}.
+ */
+export declare class TypeScriptGetDecoratorRendererForGoogleFirestore extends TypeScriptGetDecoratorRenderer {
+    _call(): new (...args: any[]) => TypeScriptWithDecoratorsRenderer;
+    _supports(context: WorkspaceContext): boolean;
+}

package/dist/functions/typescript/get-decorator-renderer-google-firestore.js

@@ -0,0 +1,15 @@
+import { WorkspaceContext } from '@causa/workspace';
+import { TypeScriptGetDecoratorRenderer, TypeScriptWithDecoratorsRenderer, } from '@causa/workspace-typescript';
+import { GoogleFirestoreRenderer } from '../../code-generation/index.js';
+/**
+ * Implements {@link TypeScriptGetDecoratorRenderer} for the {@link GoogleFirestoreRenderer}.
+ */
+export class TypeScriptGetDecoratorRendererForGoogleFirestore extends TypeScriptGetDecoratorRenderer {
+    _call() {
+        return GoogleFirestoreRenderer;
+    }
+    _supports(context) {
+        return (context.get('project.language') === 'typescript' &&
+            this.generator === 'typescriptModelClass');
+    }
+}

package/dist/functions/typescript/get-decorator-renderer-google-spanner.d.ts

@@ -1,10 +1,9 @@
 import { WorkspaceContext } from '@causa/workspace';
-import { TypeScriptDecoratorsRenderer, TypeScriptGetDecoratorRenderer } from '@causa/workspace-typescript';
+import { TypeScriptGetDecoratorRenderer, TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript';
 /**
  * Implements {@link TypeScriptGetDecoratorRenderer} for the {@link GoogleSpannerRenderer}.
- * The configuration name for the renderer is `google.spanner`.
  */
 export declare class TypeScriptGetDecoratorRendererForGoogleSpanner extends TypeScriptGetDecoratorRenderer {
-    _call(): new (...args: any[]) => TypeScriptDecoratorsRenderer;
+    _call(): new (...args: any[]) => TypeScriptWithDecoratorsRenderer;
     _supports(context: WorkspaceContext): boolean;
 }

package/dist/functions/typescript/get-decorator-renderer-google-spanner.js

@@ -1,22 +1,15 @@
 import { WorkspaceContext } from '@causa/workspace';
-import { TypeScriptDecoratorsRenderer, TypeScriptGetDecoratorRenderer, } from '@causa/workspace-typescript';
+import { TypeScriptGetDecoratorRenderer, TypeScriptWithDecoratorsRenderer, } from '@causa/workspace-typescript';
 import { GoogleSpannerRenderer } from '../../code-generation/index.js';
 /**
  * Implements {@link TypeScriptGetDecoratorRenderer} for the {@link GoogleSpannerRenderer}.
- * The configuration name for the renderer is `google.spanner`.
  */
 export class TypeScriptGetDecoratorRendererForGoogleSpanner extends TypeScriptGetDecoratorRenderer {
     _call() {
         return GoogleSpannerRenderer;
     }
     _supports(context) {
-        if (context.get('project.language') !== 'typescript') {
-            return false;
-        }
-        const decoratorRenderers = context
-            .asConfiguration()
-            .get('typescript.codeGeneration.decoratorRenderers') ?? [];
-        return (decoratorRenderers.length === 0 ||
-            decoratorRenderers.includes('google.spanner'));
+        return (context.get('project.language') === 'typescript' &&
+            this.generator === 'typescriptModelClass');
     }
 }

package/dist/functions/typescript/index.d.ts

@@ -1 +1,2 @@
+export { TypeScriptGetDecoratorRendererForGoogleFirestore } from './get-decorator-renderer-google-firestore.js';
 export { TypeScriptGetDecoratorRendererForGoogleSpanner } from './get-decorator-renderer-google-spanner.js';

package/dist/functions/typescript/index.js

@@ -1 +1,2 @@
+export { TypeScriptGetDecoratorRendererForGoogleFirestore } from './get-decorator-renderer-google-firestore.js';
 export { TypeScriptGetDecoratorRendererForGoogleSpanner } from './get-decorator-renderer-google-spanner.js';

package/dist/services/cloud-run-pubsub-trigger.js

@@ -2,6 +2,7 @@ import { WorkspaceContext } from '@causa/workspace';
 import { EventTopicTriggerCreationError } from '@causa/workspace-core';
 import { Subscription } from '@google-cloud/pubsub';
 import { randomBytes } from 'crypto';
+import { grpc } from 'google-gax';
 import { CloudRunService } from './cloud-run.js';
 import { IamService } from './iam.js';
 import { PubSubService } from './pubsub.js';
@@ -109,7 +110,6 @@ export class CloudRunPubSubTriggerService {
         }
         this.invokerBindingIds.add(invokerBindingId);
         this.logger.info(`🛂 Granting invoker IAM role to backfilling service account '${pubSubServiceAccount}' for Cloud Run service '${serviceId}'.`);
-        // This may fail due to eventual consistency during service account creation.
         await this.cloudRunService.addInvokerBinding(serviceId, pubSubServiceAccount);
         return invokerBindingId;
     }
@@ -138,6 +138,8 @@ export class CloudRunPubSubTriggerService {
                 minimumBackoff: { seconds: 1, nanos: 0 },
                 maximumBackoff: { seconds: 60, nanos: 0 },
             },
+            // This can occur due to eventual consistency when the service account is created.
+            gaxOpts: { retry: { retryCodes: [grpc.status.INVALID_ARGUMENT] } },
         });
         return subscriptionId;
     }

package/dist/services/cloud-run.js

@@ -1,4 +1,5 @@
 import { ServicesClient } from '@google-cloud/run';
+import { grpc } from 'google-gax';
 /**
  * The role used to allow a service account to call a Cloud Run service.
  */
@@ -39,11 +40,9 @@ export class CloudRunService {
         const members = [`serviceAccount:${serviceAccountEmail}`];
         const binding = { role: INVOKER_ROLE, members };
         policy.bindings = [...(policy.bindings ?? []), binding];
-        // This may fail due to eventual consistency during service account creation.
-        await this.servicesClient.setIamPolicy({
-            resource: serviceId,
-            policy,
-        });
+        await this.servicesClient.setIamPolicy({ resource: serviceId, policy }, 
+        // This can occur due to eventual consistency when the service account is created.
+        { retry: { retryCodes: [grpc.status.INVALID_ARGUMENT] } });
     }
     /**
      * Removes a service account from the list of allowed invokers of a Cloud Run service.

package/dist/services/resource-manager.js

@@ -17,16 +17,12 @@ export class ResourceManagerService {
      * @returns The number of the GCP project.
      */
     async getProjectNumber(projectId) {
-        const [projects] = await this.projectsClient.searchProjects({
-            query: `projectId:${projectId}`,
-            pageSize: 1,
-        });
+        const [projects] = await this.projectsClient.searchProjects({ query: `projectId:${projectId}`, pageSize: 1 }, { autoPaginate: false });
         if (projects.length < 1) {
             throw new Error(`Could not find GCP project '${projectId}'.`);
         }
         const [project] = projects;
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const [projectsConst, projectNumber] = project.name?.split('/') ?? [];
+        const projectNumber = project.name?.split('/').at(1);
         if (!projectNumber) {
             throw new Error(`Failed to parse invalid project name '${project.name}'.`);
         }

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@causa/workspace-google",
-  "version": "0.9.3",
+  "version": "0.10.0",
   "description": "The Causa workspace module providing many functionalities related to GCP and its services.",
-  "repository": "github:causa-io/workspace-module-google",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/causa-io/workspace-module-google.git"
+  },
   "license": "ISC",
   "type": "module",
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,47 +32,49 @@
     "test:cov": "npm run test -- --coverage"
   },
   "dependencies": {
-    "@causa/cli": ">= 0.6.1 < 1.0.0",
-    "@causa/workspace": ">= 0.16.1 < 1.0.0",
-    "@causa/workspace-core": ">= 0.22.3 < 1.0.0",
-    "@causa/workspace-typescript": ">= 0.10.2 < 1.0.0",
-    "@google-cloud/apikeys": "^2.1.0",
-    "@google-cloud/bigquery": "^8.0.0",
-    "@google-cloud/iam-credentials": "^4.0.1",
-    "@google-cloud/pubsub": "^5.0.0",
-    "@google-cloud/resource-manager": "^6.0.1",
-    "@google-cloud/run": "^2.0.1",
-    "@google-cloud/secret-manager": "^6.0.1",
-    "@google-cloud/service-usage": "^4.1.0",
-    "@google-cloud/spanner": "7.21.0",
+    "@causa/cli": ">= 0.6.2 < 1.0.0",
+    "@causa/workspace": ">= 0.18.0 < 1.0.0",
+    "@causa/workspace-core": ">= 0.23.0 < 1.0.0",
+    "@causa/workspace-typescript": ">= 0.11.0 < 1.0.0",
+    "@google-cloud/apikeys": "^2.2.0",
+    "@google-cloud/bigquery": "^8.1.1",
+    "@google-cloud/iam-credentials": "^4.2.0",
+    "@google-cloud/pubsub": "^5.1.0",
+    "@google-cloud/resource-manager": "^6.2.0",
+    "@google-cloud/run": "^2.3.0",
+    "@google-cloud/secret-manager": "^6.1.0",
+    "@google-cloud/service-usage": "^4.2.0",
+    "@google-cloud/spanner": "8.1.0",
     "@google-cloud/storage": "^7.16.0",
     "class-validator": "^0.14.2",
-    "firebase": "^11.7.1",
-    "firebase-admin": "^13.3.0",
+    "firebase": "^12.0.0",
+    "firebase-admin": "^13.4.0",
     "globby": "^14.1.0",
-    "google-auth-library": "^9.15.1",
-    "google-gax": "4.4.1",
-    "googleapis": "^148.0.0",
-    "pino": "^9.6.0",
-    "quicktype-core": "^23.1.4",
+    "google-auth-library": "^10.2.1",
+    "google-gax": "5.0.1-rc.1",
+    "googleapis": "^155.0.0",
+    "micromatch": "^4.0.8",
+    "pino": "^9.7.0",
+    "quicktype-core": "^23.2.6",
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@swc/core": "^1.11.24",
-    "@swc/jest": "^0.2.38",
-    "@tsconfig/node20": "^20.1.5",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^18.19.100",
+    "@swc/core": "^1.13.3",
+    "@swc/jest": "^0.2.39",
+    "@tsconfig/node20": "^20.1.6",
+    "@types/jest": "^30.0.0",
+    "@types/micromatch": "^4.0.9",
+    "@types/node": "^22.17.0",
     "@types/uuid": "^10.0.0",
     "copyfiles": "^2.4.1",
-    "eslint": "^9.26.0",
-    "eslint-config-prettier": "^10.1.5",
-    "eslint-plugin-prettier": "^5.4.0",
-    "jest": "^29.7.0",
-    "jest-extended": "^4.0.2",
+    "eslint": "^9.32.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.3",
+    "jest": "^30.0.5",
+    "jest-extended": "^6.0.0",
     "rimraf": "^6.0.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.32.0"
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.39.0"
   }
 }