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

package/dist/functions/event-topic/broker-get-topic-id-pubsub.js

@@ -1,17 +1,17 @@
-import { WorkspaceContext } from '@causa/workspace';
 import { EventTopicBrokerGetTopicId, } from '@causa/workspace-core';
 /**
  * Implements {@link EventTopicBrokerGetTopicId} for Pub/Sub.
  * The returned topic ID is a full Pub/Sub topic ID, e.g. `projects/<projectId>/topics/<topicId>`.
  */
 export class EventTopicBrokerGetTopicIdForPubSub extends EventTopicBrokerGetTopicId {
-    async _call(context) {
-        const googleConf = context.asConfiguration();
+    async _call() {
+        const googleConf = this._context.asConfiguration();
         const projectId = googleConf.getOrThrow('google.project');
         return `projects/${projectId}/topics/${this.eventTopic}`;
     }
-    _supports(context) {
-        return (context.asConfiguration().get('events.broker') ===
-            'google.pubSub');
+    _supports() {
+        return (this._context
+            .asConfiguration()
+            .get('events.broker') === 'google.pubSub');
     }
 }

package/dist/functions/event-topic/broker-publish-events-google.call.d.ts

@@ -1,3 +1,2 @@
-import type { WorkspaceContext } from '@causa/workspace';
 import type { EventTopicBrokerPublishEventsForGoogle } from './broker-publish-events-google.js';
-export default function call(this: EventTopicBrokerPublishEventsForGoogle, context: WorkspaceContext): Promise<void>;
+export default function call(this: EventTopicBrokerPublishEventsForGoogle): Promise<void>;

package/dist/functions/event-topic/broker-publish-events-google.call.js

@@ -18,28 +18,27 @@ const PUBLISH_OPTIONS = {
         maxMilliseconds: 1000,
     },
 };
-export default async function call(context) {
-    const publisher = context
+export default async function call() {
+    const publisher = this._context
         .service(PubSubService)
         .pubSub.topic(this.topicId, PUBLISH_OPTIONS)
         .flowControlled();
-    context.logger.info('📫 Publishing events.');
+    this._context.logger.info('📫 Publishing events.');
     let numEvents = 0;
     for await (const event of this.source()) {
         numEvents += 1;
         const wait = publisher.publish({
             data: event.data,
             attributes: event.attributes,
-            orderingKey: event.key,
         });
         if (wait) {
-            context.logger.debug('Waiting for the publisher to catch up before resuming publishing.');
+            this._context.logger.debug('Waiting for the publisher to catch up before resuming publishing.');
             await wait;
         }
         if (numEvents % PUBLISH_PROGRESS_LOG_INTERVAL === 0) {
-            context.logger.debug(`Published ${numEvents} events.`);
+            this._context.logger.debug(`Published ${numEvents} events.`);
         }
     }
     await publisher.all();
-    context.logger.info(`📫 Finished publishing ${numEvents} events.`);
+    this._context.logger.info(`📫 Finished publishing ${numEvents} events.`);
 }

package/dist/functions/event-topic/broker-publish-events-google.d.ts

@@ -1,10 +1,9 @@
-import { WorkspaceContext } from '@causa/workspace';
 import { EventTopicBrokerPublishEvents } from '@causa/workspace-core';
 /**
  * Implements {@link EventTopicBrokerPublishEvents} for a Google / GCP stack.
  * The supported message broker is Pub/Sub.
  */
 export declare class EventTopicBrokerPublishEventsForGoogle extends EventTopicBrokerPublishEvents {
-    _call(context: WorkspaceContext): Promise<void>;
-    _supports(context: WorkspaceContext): boolean;
+    _call(): Promise<void>;
+    _supports(): boolean;
 }

package/dist/functions/event-topic/broker-publish-events-google.js

@@ -1,15 +1,16 @@
-import { callDeferred, WorkspaceContext } from '@causa/workspace';
+import { callDeferred } from '@causa/workspace';
 import { EventTopicBrokerPublishEvents, } from '@causa/workspace-core';
 /**
  * Implements {@link EventTopicBrokerPublishEvents} for a Google / GCP stack.
  * The supported message broker is Pub/Sub.
  */
 export class EventTopicBrokerPublishEventsForGoogle extends EventTopicBrokerPublishEvents {
-    async _call(context) {
-        return await callDeferred(this, context, import.meta.url);
+    async _call() {
+        return await callDeferred(this, import.meta.url);
     }
-    _supports(context) {
-        return (context.asConfiguration().get('events.broker') ===
-            'google.pubSub');
+    _supports() {
+        return (this._context
+            .asConfiguration()
+            .get('events.broker') === 'google.pubSub');
     }
 }

package/dist/functions/event-topic/create-backfill-source-bigquery.call.d.ts

@@ -1,4 +1,3 @@
-import type { WorkspaceContext } from '@causa/workspace';
 import type { BackfillEvent } from '@causa/workspace-core';
 import { type EventTopicCreateBackfillSourceForBigQuery } from './create-backfill-source-bigquery.js';
-export default function call(this: EventTopicCreateBackfillSourceForBigQuery, context: WorkspaceContext): Promise<AsyncIterable<BackfillEvent>>;
+export default function call(this: EventTopicCreateBackfillSourceForBigQuery): Promise<AsyncIterable<BackfillEvent>>;

package/dist/functions/event-topic/create-backfill-source-bigquery.call.js

@@ -21,8 +21,8 @@ function resolveTableId(self, context) {
     const tableName = self.eventTopic.replace(/[-\.]/g, '_');
     return `${projectId}.${rawEventsDatasetId}.${tableName}`;
 }
-export default async function call(context) {
-    const tableId = resolveTableId(this, context);
+export default async function call() {
+    const tableId = resolveTableId(this, this._context);
     let query = `
     SELECT
       data,
@@ -34,8 +34,8 @@ export default async function call(context) {
     WHERE
       (${this.filter})`;
     }
-    context.logger.debug(`Creating BigQuery job from query '${query}'.`);
-    const bigQuery = context.service(BigQueryService).bigQuery;
+    this._context.logger.debug(`Creating BigQuery job from query '${query}'.`);
+    const bigQuery = this._context.service(BigQueryService).bigQuery;
     const [job] = await bigQuery.createQueryJob(query);
     return (async function* () {
         for await (const row of job.getQueryResultsStream()) {

package/dist/functions/event-topic/create-backfill-source-bigquery.d.ts

@@ -1,4 +1,3 @@
-import { WorkspaceContext } from '@causa/workspace';
 import { type BackfillEvent, EventTopicCreateBackfillSource } from '@causa/workspace-core';
 /**
  * The regular expression used to parse a `bq://<tableId>` source string.
@@ -15,6 +14,6 @@ export declare const BIGQUERY_SOURCE_REGEX: RegExp;
  * The returned async iterable pages through the query results and yields each row as a {@link BackfillEvent}.
  */
 export declare class EventTopicCreateBackfillSourceForBigQuery extends EventTopicCreateBackfillSource {
-    _call(context: WorkspaceContext): Promise<AsyncIterable<BackfillEvent>>;
-    _supports(context: WorkspaceContext): boolean;
+    _call(): Promise<AsyncIterable<BackfillEvent>>;
+    _supports(): boolean;
 }

package/dist/functions/event-topic/create-backfill-source-bigquery.js

@@ -1,4 +1,4 @@
-import { callDeferred, WorkspaceContext } from '@causa/workspace';
+import { callDeferred } from '@causa/workspace';
 import { EventTopicCreateBackfillSource, } from '@causa/workspace-core';
 /**
  * The regular expression used to parse a `bq://<tableId>` source string.
@@ -15,17 +15,17 @@ export const BIGQUERY_SOURCE_REGEX = /^bq:\/\/(?<tableId>.+)$/;
  * The returned async iterable pages through the query results and yields each row as a {@link BackfillEvent}.
  */
 export class EventTopicCreateBackfillSourceForBigQuery extends EventTopicCreateBackfillSource {
-    async _call(context) {
-        return await callDeferred(this, context, import.meta.url);
+    async _call() {
+        return await callDeferred(this, import.meta.url);
     }
-    _supports(context) {
+    _supports() {
         if (this.source?.match(BIGQUERY_SOURCE_REGEX)) {
             return true;
         }
         if (this.source) {
             return false;
         }
-        const conf = context.asConfiguration();
+        const conf = this._context.asConfiguration();
         return (conf.get('events.broker') === 'google.pubSub' &&
             !!conf.get('google.pubSub.bigQueryStorage.rawEventsDatasetId'));
     }

package/dist/functions/event-topic/index.d.ts

@@ -7,3 +7,4 @@ export { EventTopicBrokerDeleteTriggerResourceForServiceAccount } from './broker
 export { EventTopicBrokerGetTopicIdForPubSub } from './broker-get-topic-id-pubsub.js';
 export { EventTopicBrokerPublishEventsForGoogle } from './broker-publish-events-google.js';
 export { EventTopicCreateBackfillSourceForBigQuery } from './create-backfill-source-bigquery.js';
+export { EventTopicQueryEventsForBigQuery } from './query-events-bigquery.js';

package/dist/functions/event-topic/index.js

@@ -7,3 +7,4 @@ export { EventTopicBrokerDeleteTriggerResourceForServiceAccount } from './broker
 export { EventTopicBrokerGetTopicIdForPubSub } from './broker-get-topic-id-pubsub.js';
 export { EventTopicBrokerPublishEventsForGoogle } from './broker-publish-events-google.js';
 export { EventTopicCreateBackfillSourceForBigQuery } from './create-backfill-source-bigquery.js';
+export { EventTopicQueryEventsForBigQuery } from './query-events-bigquery.js';

package/dist/functions/event-topic/query-events-bigquery.call.d.ts

@@ -0,0 +1,3 @@
+import type { QueriedEvent } from '@causa/workspace-core';
+import type { EventTopicQueryEventsForBigQuery } from './query-events-bigquery.js';
+export default function call(this: EventTopicQueryEventsForBigQuery): Promise<QueriedEvent[]>;

package/dist/functions/event-topic/query-events-bigquery.call.js

@@ -0,0 +1,41 @@
+import { BigQueryService } from '../../services/index.js';
+/**
+ * The default duration applied to `from` when it is not set, in milliseconds.
+ */
+const DEFAULT_FROM_OFFSET = 60 * 60 * 1000;
+/**
+ * The default value for `limit` when it is not set.
+ */
+const DEFAULT_LIMIT = 1000;
+export default async function call() {
+    const from = this.from ?? new Date(Date.now() - DEFAULT_FROM_OFFSET);
+    const limit = this.limit ?? DEFAULT_LIMIT;
+    const googleConf = this._context.asConfiguration();
+    const projectId = googleConf.getOrThrow('google.project');
+    const rawEventsDatasetId = googleConf.getOrThrow('google.pubSub.bigQueryStorage.rawEventsDatasetId');
+    const tableName = this.topic.replace(/[-\.]/g, '_');
+    const tableId = `${projectId}.${rawEventsDatasetId}.${tableName}`;
+    const conditions = [`publish_time >= @from`];
+    const params = { from: from.toISOString() };
+    if (this.to) {
+        conditions.push(`publish_time < @to`);
+        params.to = this.to.toISOString();
+    }
+    if (this.filter) {
+        conditions.push(`(${this.filter})`);
+    }
+    const query = `
+    SELECT publish_time, data, attributes
+    FROM \`${tableId}\`
+    WHERE ${conditions.join(' AND ')}
+    ORDER BY publish_time ASC
+    LIMIT ${limit}`;
+    this._context.logger.debug(`Querying BigQuery for events:\n${query}`);
+    const bigQuery = this._context.service(BigQueryService).bigQuery;
+    const [rows] = await bigQuery.query({ query, params });
+    return rows.map((row) => ({
+        timestamp: new Date(row.publish_time.value),
+        attributes: row.attributes ? JSON.parse(row.attributes) : {},
+        data: JSON.parse(row.data.toString('utf8')),
+    }));
+}

package/dist/functions/event-topic/query-events-bigquery.d.ts

@@ -0,0 +1,9 @@
+import { EventTopicQueryEvents, type QueriedEvent } from '@causa/workspace-core';
+/**
+ * Implements {@link EventTopicQueryEvents} for Pub/Sub topics whose events are stored in BigQuery via a BigQuery
+ * subscription. The events are read from the dataset configured at `google.pubSub.bigQueryStorage.rawEventsDatasetId`.
+ */
+export declare class EventTopicQueryEventsForBigQuery extends EventTopicQueryEvents {
+    _call(): Promise<QueriedEvent[]>;
+    _supports(): boolean;
+}

package/dist/functions/event-topic/query-events-bigquery.js

@@ -0,0 +1,17 @@
+import { callDeferred } from '@causa/workspace';
+import { EventTopicQueryEvents, } from '@causa/workspace-core';
+/**
+ * Implements {@link EventTopicQueryEvents} for Pub/Sub topics whose events are stored in BigQuery via a BigQuery
+ * subscription. The events are read from the dataset configured at `google.pubSub.bigQueryStorage.rawEventsDatasetId`.
+ */
+export class EventTopicQueryEventsForBigQuery extends EventTopicQueryEvents {
+    async _call() {
+        return await callDeferred(this, import.meta.url);
+    }
+    _supports() {
+        const conf = this._context.asConfiguration();
+        return (conf.get('events.broker') === 'google.pubSub' &&
+            conf.get('events.format') === 'json' &&
+            !!conf.get('google.pubSub.bigQueryStorage.rawEventsDatasetId'));
+    }
+}

package/dist/functions/google-app-check/generate-token.call.d.ts

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

package/dist/functions/google-app-check/generate-token.call.js

@@ -4,11 +4,11 @@ import { FirebaseAppService } from '../../services/firebase-app.js';
  * The time to live of generated tokens, in seconds.
  */
 const TOKEN_TTL = 3600;
-export default async function call(context) {
-    const firebaseAppService = context.service(FirebaseAppService);
+export default async function call() {
+    const firebaseAppService = this._context.service(FirebaseAppService);
     const app = await firebaseAppService.getAdminAppForAdminServiceAccount();
     const appId = this.app ?? (await firebaseAppService.getAppId());
-    context.logger.info(`🛂 Generating AppCheck token for Firebase application '${appId}'.`);
+    this._context.logger.info(`🛂 Generating AppCheck token for Firebase application '${appId}'.`);
     const appCheck = getAppCheck(app);
     const { token } = await appCheck.createToken(appId, {
         ttlMillis: TOKEN_TTL * 1000,

package/dist/functions/google-app-check/generate-token.d.ts

@@ -1,4 +1,4 @@
-import { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+import { WorkspaceFunction } from '@causa/workspace';
 /**
  * Generates a new AppCheck token.
  */
@@ -8,6 +8,6 @@ export declare class GoogleAppCheckGenerateToken extends WorkspaceFunction<Promi
      * If `undefined`, a Firebase app ID will be found in the configuration or using the API.
      */
     readonly app?: string;
-    _call(context: WorkspaceContext): Promise<string>;
+    _call(): Promise<string>;
     _supports(): boolean;
 }

package/dist/functions/google-app-check/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 { 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 { IsString } from 'class-validator';
 import { appCheckCommandDefinition } from '../../cli/index.js';
@@ -21,8 +21,8 @@ let GoogleAppCheckGenerateToken = class GoogleAppCheckGenerateToken extends Work
      * If `undefined`, a Firebase app ID will be found in the configuration or using the API.
      */
     app;
-    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-firebase-storage/merge-rules.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';
 /**
@@ -27,7 +27,7 @@ type GoogleFirebaseStorageMergeRulesResult = {
  */
 export declare class GoogleFirebaseStorageMergeRules extends WorkspaceFunction<Promise<GoogleFirebaseStorageMergeRulesResult>> implements InfrastructureProcessor {
     readonly tearDown?: boolean;
-    _call(context: WorkspaceContext): Promise<GoogleFirebaseStorageMergeRulesResult>;
+    _call(): Promise<GoogleFirebaseStorageMergeRulesResult>;
     _supports(): boolean;
 }
 export {};

package/dist/functions/google-firebase-storage/merge-rules.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 { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+import { WorkspaceFunction } from '@causa/workspace';
 import { AllowMissing } from '@causa/workspace/validation';
 import { IsBoolean } from 'class-validator';
 import { firebaseStorageCommandDefinition } from '../../cli/index.js';
@@ -29,11 +29,11 @@ const DEFAULT_FIREBASE_STORAGE_SECURITY_RULE_FILE = 'storage.rules';
  */
 let GoogleFirebaseStorageMergeRules = class GoogleFirebaseStorageMergeRules extends WorkspaceFunction {
     tearDown;
-    async _call(context) {
+    async _call() {
         if (this.tearDown) {
             return { configuration: {}, securityRuleFile: null };
         }
-        const googleConf = context.asConfiguration();
+        const googleConf = this._context.asConfiguration();
         let securityRuleFile = googleConf.get('google.firebaseStorage.securityRuleFile') ??
             DEFAULT_FIREBASE_STORAGE_SECURITY_RULE_FILE;
         const globs = googleConf.get('google.firebaseStorage.securityRuleFiles') ?? [];
@@ -44,7 +44,7 @@ service firebase.storage {
 ${rules}
   }
 }
-`, securityRuleFile, context);
+`, securityRuleFile, this._context);
         return {
             configuration: { google: { firebaseStorage: { securityRuleFile } } },
             securityRuleFile,

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

@@ -0,0 +1,11 @@
+import { ModelSchemaExtractDatabase, type SchemaDatabase } from '@causa/workspace-core';
+/**
+ * Implements {@link ModelSchemaExtractDatabase} for Google Firestore.
+ * The schema is selected when it carries a `googleFirestoreCollection` Causa extension with a `path` array. The table
+ * label is the slash-joined formatted path (e.g. `users/{userId}/orders/{orderId}`), optionally prefixed by the
+ * extension's `name`. Property references in the path become the primary keys.
+ */
+export declare class ModelSchemaExtractDatabaseForGoogleFirestore extends ModelSchemaExtractDatabase {
+    _call(): SchemaDatabase;
+    _supports(): boolean;
+}

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

@@ -0,0 +1,44 @@
+import { ModelSchemaExtractDatabase, } from '@causa/workspace-core';
+/**
+ * The name of the Causa extension marking an object schema as a Google Firestore collection.
+ */
+const GOOGLE_FIRESTORE_COLLECTION_EXTENSION = 'googleFirestoreCollection';
+/**
+ * Implements {@link ModelSchemaExtractDatabase} for Google Firestore.
+ * The schema is selected when it carries a `googleFirestoreCollection` Causa extension with a `path` array. The table
+ * label is the slash-joined formatted path (e.g. `users/{userId}/orders/{orderId}`), optionally prefixed by the
+ * extension's `name`. Property references in the path become the primary keys.
+ */
+export class ModelSchemaExtractDatabaseForGoogleFirestore extends ModelSchemaExtractDatabase {
+    _call() {
+        const extension = this.schema.extensions[GOOGLE_FIRESTORE_COLLECTION_EXTENSION];
+        const primaryKeys = [];
+        const segments = extension.path.map((element) => {
+            if (typeof element === 'string') {
+                return element;
+            }
+            if (typeof element === 'object' &&
+                element !== null &&
+                'property' in element &&
+                typeof element.property === 'string') {
+                primaryKeys.push(element.property);
+                return `{${element.property}}`;
+            }
+            return '?';
+        });
+        if (typeof extension.name === 'string') {
+            segments.unshift(extension.name);
+        }
+        return {
+            engine: 'google.firestore',
+            table: segments.join('/'),
+            primaryKeys,
+        };
+    }
+    _supports() {
+        const extension = this.schema.extensions[GOOGLE_FIRESTORE_COLLECTION_EXTENSION];
+        return (typeof extension === 'object' &&
+            extension !== null &&
+            Array.isArray(extension.path));
+    }
+}

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

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

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

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

package/dist/functions/google-firestore/merge-rules.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';
 /**
@@ -27,7 +27,7 @@ type GoogleFirestoreMergeRulesResult = {
  */
 export declare class GoogleFirestoreMergeRules extends WorkspaceFunction<Promise<GoogleFirestoreMergeRulesResult>> implements InfrastructureProcessor {
     readonly tearDown?: boolean;
-    _call(context: WorkspaceContext): Promise<GoogleFirestoreMergeRulesResult>;
+    _call(): Promise<GoogleFirestoreMergeRulesResult>;
     _supports(): boolean;
 }
 export {};

package/dist/functions/google-firestore/merge-rules.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 { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+import { WorkspaceFunction } from '@causa/workspace';
 import { AllowMissing } from '@causa/workspace/validation';
 import { IsBoolean } from 'class-validator';
 import { firestoreCommandDefinition } from '../../cli/index.js';
@@ -29,11 +29,11 @@ const DEFAULT_FIRESTORE_SECURITY_RULE_FILE = 'firestore.rules';
  */
 let GoogleFirestoreMergeRules = class GoogleFirestoreMergeRules extends WorkspaceFunction {
     tearDown;
-    async _call(context) {
+    async _call() {
         if (this.tearDown) {
             return { configuration: {}, securityRuleFile: null };
         }
-        const googleConf = context.asConfiguration();
+        const googleConf = this._context.asConfiguration();
         let securityRuleFile = googleConf.get('google.firestore.securityRuleFile') ??
             DEFAULT_FIRESTORE_SECURITY_RULE_FILE;
         const globs = googleConf.get('google.firestore.securityRuleFiles') ?? [];
@@ -44,7 +44,7 @@ service cloud.firestore {
 ${rules}
   }
 }
-`, securityRuleFile, context);
+`, securityRuleFile, this._context);
         return {
             configuration: { google: { firestore: { securityRuleFile } } },
             securityRuleFile,

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

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

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

@@ -0,0 +1,50 @@
+import { deleteApp, initializeApp } from 'firebase-admin/app';
+import { DocumentReference, GeoPoint, getFirestore, Timestamp, } from 'firebase-admin/firestore';
+import { randomUUID } from 'node:crypto';
+export default async function call() {
+    if (!this.query) {
+        throw new Error(`The 'query' input is required for the 'google.firestore' engine.`);
+    }
+    const googleConf = this._context.asConfiguration();
+    const projectId = googleConf.getOrThrow('google.project');
+    const database = this.database ?? '(default)';
+    this._context.logger.debug(`🗃️ Fetching Firestore document '${this.query}' from database '${database}' in project '${projectId}'.`);
+    const app = initializeApp({ projectId }, randomUUID());
+    try {
+        const firestore = getFirestore(app, database);
+        const snapshot = await firestore.doc(this.query).get();
+        return snapshot.exists ? [toJson(snapshot.data())] : [];
+    }
+    finally {
+        await deleteApp(app);
+    }
+}
+/**
+ * Recursively converts Firestore-specific types to JSON-friendly equivalents:
+ * - {@link Timestamp} → {@link Date}
+ * - {@link GeoPoint} → `{ latitude, longitude }`
+ * - {@link DocumentReference} → its `path`
+ *
+ * Other values (including `Buffer`) are returned as-is.
+ */
+function toJson(value) {
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (value instanceof Timestamp) {
+        return value.toDate();
+    }
+    if (value instanceof GeoPoint) {
+        return { latitude: value.latitude, longitude: value.longitude };
+    }
+    if (value instanceof DocumentReference) {
+        return value.path;
+    }
+    if (Buffer.isBuffer(value)) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(toJson);
+    }
+    return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, toJson(v)]));
+}

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

@@ -0,0 +1,17 @@
+import { DatabaseQueryRecords } from '@causa/workspace-core';
+/**
+ * The engine identifier handled by this implementation.
+ */
+export declare const FIRESTORE_ENGINE = "google.firestore";
+/**
+ * Implements {@link DatabaseQueryRecords} for Firestore.
+ *
+ * The `database` input is optional and defaults to the default Firestore database. The `query` input is the path to a
+ * single document (e.g. `users/abc`).
+ *
+ * Returns an array containing a single document's data, or an empty array if the document does not exist.
+ */
+export declare class DatabaseQueryRecordsForFirestore extends DatabaseQueryRecords {
+    _call(): Promise<any[]>;
+    _supports(): boolean;
+}

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

@@ -0,0 +1,22 @@
+import { callDeferred } from '@causa/workspace';
+import { DatabaseQueryRecords } from '@causa/workspace-core';
+/**
+ * The engine identifier handled by this implementation.
+ */
+export const FIRESTORE_ENGINE = 'google.firestore';
+/**
+ * Implements {@link DatabaseQueryRecords} for Firestore.
+ *
+ * The `database` input is optional and defaults to the default Firestore database. The `query` input is the path to a
+ * single document (e.g. `users/abc`).
+ *
+ * Returns an array containing a single document's data, or an empty array if the document does not exist.
+ */
+export class DatabaseQueryRecordsForFirestore extends DatabaseQueryRecords {
+    async _call() {
+        return await callDeferred(this, import.meta.url);
+    }
+    _supports() {
+        return this.engine === FIRESTORE_ENGINE;
+    }
+}

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

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

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

@@ -1,7 +1,7 @@
 import { getAuth } from 'firebase-admin/auth';
 import { FirebaseAppService } from '../../services/firebase-app.js';
-export default async function call(context) {
-    const adminApp = await context
+export default async function call() {
+    const adminApp = await this._context
         .service(FirebaseAppService)
         .getAdminAppForAdminServiceAccount();
     return await getAuth(adminApp).createCustomToken(this.user, this.claims);

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

@@ -1,4 +1,4 @@
-import { WorkspaceContext, WorkspaceFunction } from '@causa/workspace';
+import { WorkspaceFunction } from '@causa/workspace';
 /**
  * Generates a custom token that can be used to sign in to Identity Platform as a given user.
  * Optionally, custom claims can be set in the token.
@@ -15,6 +15,6 @@ export declare class GoogleIdentityPlatformGenerateCustomToken extends Workspace
      * A dictionary of custom claims to add to the token.
      */
     readonly claims?: Record<string, any>;
-    _call(context: WorkspaceContext): Promise<string>;
+    _call(): Promise<string>;
     _supports(): boolean;
 }