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

package/dist/functions/google-firestore/generate-typescript-decorators.d.ts

@@ -0,0 +1,13 @@
+import { ModelGenerateTypeScriptDecorators } from '@causa/workspace-typescript';
+import { type TypeScriptDecorator } from '@causa/workspace-typescript/code-generation';
+/**
+ * Implements {@link ModelGenerateTypeScriptDecorators} to add Google Firestore decorators from the Causa Google runtime.
+ *
+ * If an object schema is marked with the `googleFirestoreCollection` extension, the `@FirestoreCollection` decorator is
+ * added to the class. If the `hasSoftDelete` property is `true`, the `@SoftDeletedFirestoreCollection` decorator is also
+ * added.
+ */
+export declare class ModelGenerateTypeScriptDecoratorsForGoogleFirestore extends ModelGenerateTypeScriptDecorators {
+    _call(): TypeScriptDecorator[];
+    _supports(): boolean;
+}

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

@@ -0,0 +1,78 @@
+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 Firestore collection.
+ */
+const GOOGLE_FIRESTORE_COLLECTION_EXTENSION = 'googleFirestoreCollection';
+/**
+ * The name of the Causa module for the TypeScript Google runtime.
+ */
+const CAUSA_GOOGLE_MODULE = '@causa/runtime-google';
+/**
+ * Implements {@link ModelGenerateTypeScriptDecorators} to add Google Firestore decorators from the Causa Google runtime.
+ *
+ * If an object schema is marked with the `googleFirestoreCollection` extension, the `@FirestoreCollection` decorator is
+ * added to the class. If the `hasSoftDelete` property is `true`, the `@SoftDeletedFirestoreCollection` decorator is also
+ * added.
+ */
+export class ModelGenerateTypeScriptDecoratorsForGoogleFirestore extends ModelGenerateTypeScriptDecorators {
+    _call() {
+        if (this.property) {
+            return [];
+        }
+        const attribute = this.schema.extensions[GOOGLE_FIRESTORE_COLLECTION_EXTENSION];
+        if (!attribute) {
+            return [];
+        }
+        const globs = this.configuration?.google?.firestore?.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 [];
+            }
+        }
+        const debugName = this.schema.name;
+        if (typeof attribute !== 'object') {
+            throw new Error(`Invalid '${GOOGLE_FIRESTORE_COLLECTION_EXTENSION}' attribute on '${debugName}'. Expected an object.`);
+        }
+        const { name, path, hasSoftDelete } = attribute;
+        if (typeof name !== 'string') {
+            throw new Error(`Invalid '${GOOGLE_FIRESTORE_COLLECTION_EXTENSION}' attribute on '${debugName}'. Expected an object with a 'name' string property.`);
+        }
+        if (!Array.isArray(path)) {
+            throw new Error(`Invalid '${GOOGLE_FIRESTORE_COLLECTION_EXTENSION}' attribute on '${debugName}'. Expected an object with a 'path' array property.`);
+        }
+        const propertyNames = new Set(this.schema.properties.map((p) => p.name));
+        const elements = path.map((element) => {
+            if (typeof element === 'string') {
+                return JSON.stringify(element);
+            }
+            if (typeof element === 'object' &&
+                element !== null &&
+                'property' in element &&
+                typeof element.property === 'string') {
+                const propertyName = element.property;
+                if (!propertyNames.has(propertyName)) {
+                    throw new Error(`Property '${propertyName}' referenced in 'path' not found in '${debugName}'.`);
+                }
+                return `doc.${propertyName}`;
+            }
+            throw new Error(`Invalid path element in '${GOOGLE_FIRESTORE_COLLECTION_EXTENSION}' attribute on '${debugName}'.`);
+        });
+        const pathExpression = path.length === 1 ? elements[0] : `[${elements.join(', ')}].join("/")`;
+        const decorators = [];
+        addDecoratorToList(decorators, { schema: this.schema }, 'FirestoreCollection', CAUSA_GOOGLE_MODULE, `@FirestoreCollection({ name: ${JSON.stringify(name)}, path: (doc) => ${pathExpression} })`);
+        if (hasSoftDelete === true) {
+            addDecoratorToList(decorators, { schema: this.schema }, 'SoftDeletedFirestoreCollection', CAUSA_GOOGLE_MODULE, '@SoftDeletedFirestoreCollection()');
+        }
+        return decorators;
+    }
+    _supports() {
+        return (this._context.get('project.language') === 'typescript' &&
+            this.generator === 'typescriptModelClass');
+    }
+}

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

@@ -1,3 +1,4 @@
 export { ModelSchemaExtractDatabaseForGoogleFirestore } from './extract-database.js';
+export { ModelGenerateTypeScriptDecoratorsForGoogleFirestore } from './generate-typescript-decorators.js';
 export { DatabaseQueryRecordsForFirestore } from './query-records.js';
 export { GoogleFirestoreMergeRules } from './merge-rules.js';

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

@@ -1,3 +1,4 @@
 export { ModelSchemaExtractDatabaseForGoogleFirestore } from './extract-database.js';
+export { ModelGenerateTypeScriptDecoratorsForGoogleFirestore } from './generate-typescript-decorators.js';
 export { DatabaseQueryRecordsForFirestore } from './query-records.js';
 export { GoogleFirestoreMergeRules } from './merge-rules.js';

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,4 +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,4 +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/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, ModelSchemaExtractDatabaseForGoogleFirestore, } 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, ModelSchemaExtractDatabaseForGoogleSpanner, } 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, ModelSchemaExtractDatabaseForGoogleFirestore, ModelSchemaExtractDatabaseForGoogleSpanner, 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);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@causa/workspace-google",
-  "version": "0.18.0-beta.1",
+  "version": "0.18.0-beta.2",
   "description": "The Causa workspace module providing many functionalities related to GCP and its services.",
   "repository": {
     "type": "git",
@@ -37,8 +37,8 @@
   "dependencies": {
     "@causa/cli": ">= 0.8.0-beta.1 < 1.0.0",
     "@causa/workspace": ">= 0.25.0-beta.3 < 1.0.0",
-    "@causa/workspace-core": ">= 0.35.0-beta.1 < 1.0.0",
-    "@causa/workspace-typescript": ">= 0.23.0-beta.1 < 1.0.0",
+    "@causa/workspace-core": ">= 0.35.0-beta.2 < 1.0.0",
+    "@causa/workspace-typescript": ">= 0.23.0-beta.2 < 1.0.0",
     "@google-cloud/apikeys": "^2.2.2",
     "@google-cloud/bigquery": "^8.3.1",
     "@google-cloud/iam-credentials": "^4.2.2",
@@ -56,10 +56,9 @@
     "globby": "^16.2.0",
     "google-auth-library": "^10.6.2",
     "google-gax": "5.0.6",
-    "googleapis": "^171.4.0",
+    "googleapis": "^172.0.0",
     "micromatch": "^4.0.8",
-    "pino": "^10.3.1",
-    "quicktype-core": "^23.2.6"
+    "pino": "^10.3.1"
   },
   "devDependencies": {
     "@swc/core": "^1.15.33",
@@ -76,7 +75,7 @@
     "jest-extended": "^7.0.0",
     "rimraf": "^6.1.3",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.3",
+    "typescript-eslint": "^8.59.4",
     "yaml": "^2.9.0"
   }
 }

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

@@ -1,12 +0,0 @@
-import { type ClassContext, type TypeScriptDecorator, TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript/code-generation';
-/**
- * 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

@@ -1,89 +0,0 @@
-import { TypeScriptWithDecoratorsRenderer, } from '@causa/workspace-typescript/code-generation';
-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') {
-            throw new Error(`Invalid '${GOOGLE_FIRESTORE_COLLECTION_ATTRIBUTE}' attribute on '${debugName}'. Expected an object.`);
-        }
-        const { name, path, hasSoftDelete } = collectionAttribute;
-        if (typeof name !== 'string') {
-            throw new Error(`Invalid '${GOOGLE_FIRESTORE_COLLECTION_ATTRIBUTE}' attribute on '${debugName}'. Expected an object with a 'name' string property.`);
-        }
-        if (!Array.isArray(path)) {
-            throw new Error(`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)) {
-                throw new Error(`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) {
-                    throw new Error(`Property '${propertyName}' not found in property references.`);
-                }
-                return ['doc.', generatedName];
-            }
-            throw new Error(`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 +0,0 @@
-import { type ClassContext, type ClassPropertyContext, type TypeScriptDecorator, TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript/code-generation';
-/**
- * A {@link TypeScriptDecoratorsRenderer} that adds Google Spanner decorators from the Causa Google runtime.
- *
- * 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 TypeScriptWithDecoratorsRenderer {
-    decoratorsForClass(context: ClassContext): TypeScriptDecorator[];
-    decoratorsForProperty(context: ClassPropertyContext): TypeScriptDecorator[];
-}

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

@@ -1,100 +0,0 @@
-import { TypeScriptWithDecoratorsRenderer, getSingleType, typeScriptSourceForObject, } from '@causa/workspace-typescript/code-generation';
-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 = '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 = '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 JSONSchema
- * 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',
-];
-/**
- * A {@link TypeScriptDecoratorsRenderer} that adds Google Spanner decorators from the Causa Google runtime.
- *
- * 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 TypeScriptWithDecoratorsRenderer {
-    decoratorsForClass(context) {
-        const tableAttribute = context.objectAttributes[GOOGLE_SPANNER_TABLE_ATTRIBUTE];
-        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) ||
-            tableAttribute.primaryKey.length === 0 ||
-            tableAttribute.primaryKey.some((k) => typeof k !== 'string')) {
-            throw new Error(`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') {
-            throw new Error(`Invalid 'name' in '${GOOGLE_SPANNER_TABLE_ATTRIBUTE}' attribute on '${context.classType.getCombinedName()}'. Expected a string.`);
-        }
-        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) {
-        const globs = this.targetLanguage.options.generatorOptions?.google?.spanner?.globs;
-        if (!context.objectAttributes[GOOGLE_SPANNER_TABLE_ATTRIBUTE] ||
-            !schemaMatchesGlobPatterns(this, context, globs)) {
-            return [];
-        }
-        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') {
-            throw new Error(`Invalid 'tsOptions' in '${GOOGLE_SPANNER_COLUMN_ATTRIBUTE}' attribute. Expected an object.`);
-        }
-        const columnAttributes = tsOptions ?? {};
-        if (overriddenName) {
-            if (typeof overriddenName !== 'string') {
-                throw new Error(`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;
-        }
-        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);
-        const decorators = [];
-        this.addDecoratorToList(decorators, context, 'SpannerColumn', CAUSA_GOOGLE_MODULE, ['@SpannerColumn(', optionsSource, ')']);
-        return decorators;
-    }
-}

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

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

package/dist/code-generation/index.js

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

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

@@ -1,12 +0,0 @@
-import type { ClassContext } from '@causa/workspace-typescript/code-generation';
-import { TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript/code-generation';
-/**
- * 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

@@ -1,21 +0,0 @@
-import { TypeScriptWithDecoratorsRenderer } from '@causa/workspace-typescript/code-generation';
-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/typescript/get-decorator-renderer-google-firestore.d.ts

@@ -1,8 +0,0 @@
-import { TypeScriptGetDecoratorRenderer, type TypeScriptWithDecoratorsRendererType } from '@causa/workspace-typescript';
-/**
- * Implements {@link TypeScriptGetDecoratorRenderer} for the `GoogleFirestoreRenderer`.
- */
-export declare class TypeScriptGetDecoratorRendererForGoogleFirestore extends TypeScriptGetDecoratorRenderer {
-    _call(): Promise<TypeScriptWithDecoratorsRendererType>;
-    _supports(): boolean;
-}

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

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

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

@@ -1,8 +0,0 @@
-import { TypeScriptGetDecoratorRenderer, type TypeScriptWithDecoratorsRendererType } from '@causa/workspace-typescript';
-/**
- * Implements {@link TypeScriptGetDecoratorRenderer} for the `GoogleSpannerRenderer`.
- */
-export declare class TypeScriptGetDecoratorRendererForGoogleSpanner extends TypeScriptGetDecoratorRenderer {
-    _call(): Promise<TypeScriptWithDecoratorsRendererType>;
-    _supports(): boolean;
-}

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

@@ -1,14 +0,0 @@
-import { TypeScriptGetDecoratorRenderer, } from '@causa/workspace-typescript';
-/**
- * Implements {@link TypeScriptGetDecoratorRenderer} for the `GoogleSpannerRenderer`.
- */
-export class TypeScriptGetDecoratorRendererForGoogleSpanner extends TypeScriptGetDecoratorRenderer {
-    async _call() {
-        const { GoogleSpannerRenderer } = await import('../../code-generation/index.js');
-        return GoogleSpannerRenderer;
-    }
-    _supports() {
-        return (this._context.get('project.language') === 'typescript' &&
-            this.generator === 'typescriptModelClass');
-    }
-}

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

@@ -1,2 +0,0 @@
-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,2 +0,0 @@
-export { TypeScriptGetDecoratorRendererForGoogleFirestore } from './get-decorator-renderer-google-firestore.js';
-export { TypeScriptGetDecoratorRendererForGoogleSpanner } from './get-decorator-renderer-google-spanner.js';