@causa/workspace-google 1.4.0-beta.1 → 1.4.0-beta.3

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

@@ -1,5 +1,9 @@
 import { WorkspaceFunction, listFilesAndFormat } from '@causa/workspace';
 import { readFile } from 'fs/promises';
+/**
+ * Matches a `CREATE TABLE` DDL statement, capturing the name of the table.
+ */
+const CREATE_TABLE_REGEX = /^CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?[`"']?([A-Za-z_]\w*)/i;
 /**
  * The default format used to infer the ID / name of the database from the format parts.
  */
@@ -33,10 +37,14 @@ export class GoogleSpannerListDatabases extends WorkspaceFunction {
         }, {});
         return await Promise.all(Object.entries(databaseDdlFiles).map(async ([id, ddlFiles]) => {
             ddlFiles.sort();
-            const ddlsInFiles = await Promise.all(ddlFiles.map((ddlFile) => this.parseDdlFile(ddlFile)));
-            const ddls = ddlsInFiles.flatMap((ddls) => ddls);
+            const statements = (await Promise.all(ddlFiles.map((ddlFile) => this.parseDdlFile(ddlFile)))).flat();
+            const ddls = statements.map(({ statement }) => statement);
+            const tables = statements.flatMap(({ statement, file, line }) => {
+                const name = statement.match(CREATE_TABLE_REGEX)?.[1];
+                return name ? [{ name, file, line }] : [];
+            });
             this._context.logger.debug(`🗃️ Found Spanner database '${id}' with ${ddlFiles.length} DDL file(s) and ${ddls.length} statement(s).`);
-            return { id, ddlFiles, ddls };
+            return { id, ddlFiles, ddls, tables };
         }));
     }
     /**
@@ -44,21 +52,25 @@ export class GoogleSpannerListDatabases extends WorkspaceFunction {
      * End-of-the-line comments are removed, and statements are split using semicolons.
      *
      * @param path The path to the SQL file containing DDL statements.
-     * @returns The list of DDL statements.
+     * @returns The list of DDL statements, along with the file and the line at which each statement starts.
      */
     async parseDdlFile(path) {
         const rawFile = (await readFile(path)).toString();
-        return (rawFile
-            // Removing comments using the `-- My comment until the end of the line` syntax.
-            .replace(/--.*$/gm, '')
-            // Trimming lines for readability in logs, and joining them to easily split into statements.
-            .split('\n')
-            .map((statement) => statement.trim())
-            .join(' ')
-            // Splitting the SQL statements.
-            .split(';')
-            // Trimming for readability in logs.
-            .map((statement) => statement.trim()));
+        // Removing comments using the `-- My comment until the end of the line` syntax, which preserves line numbers.
+        const withoutComments = rawFile.replace(/--.*$/gm, '');
+        let line = 1;
+        return withoutComments.split(';').map((rawStatement) => {
+            const leadingWhitespace = rawStatement.match(/^\s*/)[0];
+            const startLine = line + leadingWhitespace.split('\n').length - 1;
+            line += rawStatement.split('\n').length - 1;
+            const statement = rawStatement
+                // Trimming lines for readability in logs, and joining them into a single line.
+                .split('\n')
+                .map((statementLine) => statementLine.trim())
+                .join(' ')
+                .trim();
+            return { statement, file: path, line: startLine };
+        });
     }
     _supports() {
         return true;

package/dist/functions/google-spanner/resolve-table.d.ts

@@ -0,0 +1,25 @@
+import type { SpannerDatabase, SpannerTable } from './list-databases.js';
+/**
+ * The resolution of a table name to the database whose DDL creates it.
+ */
+export type SpannerTableResolution<D extends SpannerDatabase = SpannerDatabase> = {
+    readonly kind: 'resolved';
+    readonly database: D;
+    readonly table: SpannerTable;
+} | {
+    readonly kind: 'ambiguous';
+    readonly candidates: D[];
+} | {
+    readonly kind: 'missing';
+};
+/**
+ * Resolves a table name to the database whose DDL creates it. When several databases create a table with that name, the
+ * one with DDL files in the domain of the schema is chosen.
+ *
+ * @param databases The Spanner databases, as listed by `GoogleSpannerListDatabases`.
+ * @param table The name of the table.
+ * @param schemaFile The absolute path of the file declaring the schema persisted in the table.
+ * @param domainPaths The absolute paths of the domains of the workspace.
+ * @returns The resolution.
+ */
+export declare function resolveSpannerTable<D extends SpannerDatabase>(databases: readonly D[], table: string, schemaFile: string, domainPaths: readonly string[]): SpannerTableResolution<D>;

package/dist/functions/google-spanner/resolve-table.js

@@ -0,0 +1,44 @@
+import { sep } from 'path';
+/**
+ * Returns the deepest domain containing a path.
+ *
+ * @param domainPaths The absolute paths of the domains.
+ * @param path The absolute path.
+ * @returns The absolute path of the domain, or `undefined` if the path is not part of a domain.
+ */
+function domainOf(domainPaths, path) {
+    return domainPaths
+        .filter((domain) => path.startsWith(`${domain}${sep}`))
+        .sort((a, b) => b.length - a.length)[0];
+}
+/**
+ * Resolves a table name to the database whose DDL creates it. When several databases create a table with that name, the
+ * one with DDL files in the domain of the schema is chosen.
+ *
+ * @param databases The Spanner databases, as listed by `GoogleSpannerListDatabases`.
+ * @param table The name of the table.
+ * @param schemaFile The absolute path of the file declaring the schema persisted in the table.
+ * @param domainPaths The absolute paths of the domains of the workspace.
+ * @returns The resolution.
+ */
+export function resolveSpannerTable(databases, table, schemaFile, domainPaths) {
+    const candidates = databases.filter((d) => d.tables.some((t) => t.name === table));
+    const pick = (database) => ({
+        kind: 'resolved',
+        database,
+        table: database.tables.find((t) => t.name === table),
+    });
+    if (candidates.length === 1) {
+        return pick(candidates[0]);
+    }
+    if (candidates.length === 0) {
+        return { kind: 'missing' };
+    }
+    const domain = domainOf(domainPaths, schemaFile);
+    const inDomain = domain
+        ? candidates.filter(({ ddlFiles }) => ddlFiles.some((f) => domainOf(domainPaths, f) === domain))
+        : [];
+    return inDomain.length === 1
+        ? pick(inDomain[0])
+        : { kind: 'ambiguous', candidates };
+}

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

@@ -8,6 +8,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { WorkspaceFunction } from '@causa/workspace';
+import { PassArgumentsByReference } from '@causa/workspace/function-registry';
 import { CAUSA_FOLDER } from '@causa/workspace/initialization';
 import { AllowMissing } from '@causa/workspace/validation';
 import { IsBoolean } from 'class-validator';
@@ -25,7 +26,7 @@ const DEFAULT_DATABASE_CONFIGURATIONS_DIRECTORY = join(CAUSA_FOLDER, 'spanner-da
  * database configurations.
  * This function returns a partial configuration, such that it can be used as a processor.
  */
-export class GoogleSpannerWriteDatabases extends WorkspaceFunction {
+let GoogleSpannerWriteDatabases = class GoogleSpannerWriteDatabases extends WorkspaceFunction {
     tearDown;
     /**
      * Returns the path to the directory where Spanner databases configurations should be written.
@@ -64,9 +65,13 @@ export class GoogleSpannerWriteDatabases extends WorkspaceFunction {
     _supports() {
         return true;
     }
-}
+};
 __decorate([
     IsBoolean(),
     AllowMissing(),
     __metadata("design:type", Boolean)
 ], GoogleSpannerWriteDatabases.prototype, "tearDown", void 0);
+GoogleSpannerWriteDatabases = __decorate([
+    PassArgumentsByReference()
+], GoogleSpannerWriteDatabases);
+export { GoogleSpannerWriteDatabases };

package/dist/functions/graph/fetch-environment-metric-series.call.d.ts

@@ -0,0 +1,3 @@
+import { type GraphMetricSeries } from '@causa/workspace-core';
+import type { GraphFetchEnvironmentMetricSeriesForGoogle } from './fetch-environment-metric-series.js';
+export default function call(this: GraphFetchEnvironmentMetricSeriesForGoogle): Promise<GraphMetricSeries>;

package/dist/functions/graph/fetch-environment-metric-series.call.js

@@ -0,0 +1,107 @@
+import { GraphMetricKind, } from '@causa/workspace-core';
+import { GraphEnvironmentContext } from '@causa/workspace-core/graph';
+import { monitoringMetricKind } from '../../graph/environment/monitoring-catalog.js';
+import { MIN_ALIGNMENT_PERIOD, monitoringEnd, queryMonitoringMetric, } from '../../graph/environment/monitoring-query.js';
+import { BucketLayoutRegistry } from '../../graph/environment/monitoring-values.js';
+/**
+ * The steps between points from which the default one is chosen, in seconds.
+ */
+const DEFAULT_STEPS = [
+    60, 120, 300, 600, 900, 1800, 3600, 7200, 10800, 21600, 43200, 86400,
+];
+/**
+ * The maximum number of points in a series when the step is chosen by default.
+ */
+const DEFAULT_MAX_POINTS = 300;
+/**
+ * Returns the default step for a series, as the smallest of {@link DEFAULT_STEPS} that results in at most
+ * {@link DEFAULT_MAX_POINTS} points. For longer series, a whole number of days is used.
+ *
+ * @param duration The duration of the series, in seconds.
+ * @returns The step, in seconds.
+ */
+function defaultStep(duration) {
+    const minimum = duration / DEFAULT_MAX_POINTS;
+    const day = DEFAULT_STEPS[DEFAULT_STEPS.length - 1];
+    return (DEFAULT_STEPS.find((step) => step >= minimum) ??
+        Math.ceil(minimum / day) * day);
+}
+/**
+ * The maximum number of points in a series.
+ */
+const MAX_POINTS = 10000;
+export default async function call() {
+    const metric = this.findMetric();
+    if (!metric) {
+        throw new Error(`The metric '${this.metric}' of node '${this.node}' is not read from Cloud Monitoring.`);
+    }
+    const { start: requestedStart } = this;
+    if (isNaN(this.end.getTime()) || isNaN(requestedStart.getTime())) {
+        throw new Error('The start and end of the series must be valid dates.');
+    }
+    const end = monitoringEnd(this.end);
+    const duration = (end.getTime() - requestedStart.getTime()) / 1000;
+    const requestedStep = this.step ?? defaultStep(duration);
+    if (!Number.isInteger(requestedStep) ||
+        requestedStep < MIN_ALIGNMENT_PERIOD) {
+        throw new Error(`The step must be a whole number of seconds, of at least ${MIN_ALIGNMENT_PERIOD} seconds.`);
+    }
+    const requestedCount = Math.floor(duration / requestedStep);
+    if (requestedCount < 1 || requestedCount > MAX_POINTS) {
+        throw new Error(`The series must contain between 1 and ${MAX_POINTS} points, but contains ${Math.max(requestedCount, 0)}.`);
+    }
+    // Metrics sampled less often than the step are read with a larger step, and at least one point, as for the
+    // point-in-time value.
+    const step = Math.max(requestedStep, metric.minPeriod ?? 0);
+    const count = step === requestedStep
+        ? requestedCount
+        : Math.max(Math.floor(duration / step), 1);
+    if (!this.graph.environment) {
+        throw new Error('The graph must be enriched with environment data to fetch a series.');
+    }
+    const environment = await GraphEnvironmentContext.forEnrichedGraph(this._context, this.graph);
+    const layouts = new BucketLayoutRegistry();
+    // Warnings, e.g. about time series relating to resources missing from the graph, don't affect the values.
+    const { values, groupBy, errors } = await queryMonitoringMetric(environment, metric, { end, period: step, count }, layouts, { nodes: [this.node] });
+    if (errors.length > 0) {
+        throw new Error(errors.map((e) => e.message).join(' '));
+    }
+    const points = values.get(this.node) ?? new Array(count).fill(undefined);
+    const start = new Date(end.getTime() - count * step * 1000);
+    return {
+        start,
+        step,
+        values: points.map((p) => p?.value ?? null),
+        ...(groupBy
+            ? {
+                groupBy,
+                groups: seriesGroups(points, monitoringMetricKind(metric) === GraphMetricKind.Rate ? 0 : null),
+            }
+            : {}),
+        bucketLayouts: layouts.all,
+    };
+}
+/**
+ * Returns the series of each group, from the points of the series.
+ *
+ * @param points The points of the series.
+ * @param missing The value of a group in a period where the point exists but not the group, e.g. `0` for rates.
+ * @returns The series of each group, sorted by key.
+ */
+function seriesGroups(points, missing) {
+    const groups = new Map();
+    points.forEach((point, index) => {
+        for (const { key, value } of point?.groups ?? []) {
+            const serialized = JSON.stringify(key);
+            const group = groups.get(serialized) ?? {
+                key,
+                values: points.map((p) => (p ? missing : null)),
+            };
+            groups.set(serialized, group);
+            group.values[index] = value;
+        }
+    });
+    return [...groups.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([, group]) => group);
+}

package/dist/functions/graph/fetch-environment-metric-series.d.ts

@@ -0,0 +1,23 @@
+import { GraphFetchEnvironmentMetricSeries, type GraphMetricSeries } from '@causa/workspace-core';
+import { type GraphNodeEntry } from '@causa/workspace-core/graph';
+import { type MonitoringMetric } from '../../graph/environment/monitoring-catalog.js';
+/**
+ * Implements {@link GraphFetchEnvironmentMetricSeries} for the metrics read from Cloud Monitoring.
+ */
+export declare class GraphFetchEnvironmentMetricSeriesForGoogle extends GraphFetchEnvironmentMetricSeries {
+    _call(): Promise<GraphMetricSeries>;
+    /**
+     * Returns the requested node, from the graph.
+     *
+     * @returns The node, or `undefined` if it does not exist.
+     */
+    findNode(): GraphNodeEntry | undefined;
+    /**
+     * Returns the Cloud Monitoring metric providing the requested metric of the node.
+     *
+     * @returns The metric, or `undefined` if the node does not exist, has no resource, or the metric is not read from
+     *   Cloud Monitoring for it.
+     */
+    findMetric(): MonitoringMetric | undefined;
+    _supports(): boolean;
+}

package/dist/functions/graph/fetch-environment-metric-series.js

@@ -0,0 +1,40 @@
+import { callDeferred } from '@causa/workspace';
+import { GraphFetchEnvironmentMetricSeries, } from '@causa/workspace-core';
+import { listGraphNodes, } from '@causa/workspace-core/graph';
+import { MONITORING_METRICS, } from '../../graph/environment/monitoring-catalog.js';
+/**
+ * Implements {@link GraphFetchEnvironmentMetricSeries} for the metrics read from Cloud Monitoring.
+ */
+export class GraphFetchEnvironmentMetricSeriesForGoogle extends GraphFetchEnvironmentMetricSeries {
+    async _call() {
+        return await callDeferred(this, import.meta.url);
+    }
+    /**
+     * Returns the requested node, from the graph.
+     *
+     * @returns The node, or `undefined` if it does not exist.
+     */
+    findNode() {
+        return listGraphNodes(this.graph).find((n) => n.id === this.node);
+    }
+    /**
+     * Returns the Cloud Monitoring metric providing the requested metric of the node.
+     *
+     * @returns The metric, or `undefined` if the node does not exist, has no resource, or the metric is not read from
+     *   Cloud Monitoring for it.
+     */
+    findMetric() {
+        const node = this.findNode();
+        const resource = node?.node.data?.resource;
+        if (!node || typeof resource?.id !== 'string') {
+            return undefined;
+        }
+        return MONITORING_METRICS.find((m) => m.metric === this.metric &&
+            m.mapping.nodeType === node.type &&
+            m.mapping.resourceType === resource.type &&
+            (!m.measures || m.measures(node, this.graph)));
+    }
+    _supports() {
+        return !!this.findMetric();
+    }
+}

package/dist/functions/graph/get-environment-provider.d.ts

@@ -0,0 +1,11 @@
+import { GraphGetEnvironmentProvider, type GraphEnvironmentProvider } from '@causa/workspace-core';
+/**
+ * Implements {@link GraphGetEnvironmentProvider} for Google Cloud.
+ * The fetchers read metrics and alerts from Cloud Monitoring, open error groups from Error Reporting as alerts, the
+ * state of Cloud Run services and Cloud Scheduler jobs, and build links to the Google Cloud console. Cloud Tasks
+ * queues, only known by a prefix of their name, are resolved by listing them.
+ */
+export declare class GraphGetEnvironmentProviderForGoogle extends GraphGetEnvironmentProvider {
+    _call(): GraphEnvironmentProvider;
+    _supports(): boolean;
+}

package/dist/functions/graph/get-environment-provider.js

@@ -0,0 +1,20 @@
+import { GraphGetEnvironmentProvider, } from '@causa/workspace-core';
+import { CLOUD_TASKS_QUEUE_RESOLVER, GOOGLE_GRAPH_ENVIRONMENT_FETCHERS, GOOGLE_GRAPH_METRIC_DEFINITIONS, } from '../../graph/index.js';
+/**
+ * Implements {@link GraphGetEnvironmentProvider} for Google Cloud.
+ * The fetchers read metrics and alerts from Cloud Monitoring, open error groups from Error Reporting as alerts, the
+ * state of Cloud Run services and Cloud Scheduler jobs, and build links to the Google Cloud console. Cloud Tasks
+ * queues, only known by a prefix of their name, are resolved by listing them.
+ */
+export class GraphGetEnvironmentProviderForGoogle extends GraphGetEnvironmentProvider {
+    _call() {
+        return {
+            metrics: GOOGLE_GRAPH_METRIC_DEFINITIONS,
+            prefixResolvers: [CLOUD_TASKS_QUEUE_RESOLVER],
+            fetchers: GOOGLE_GRAPH_ENVIRONMENT_FETCHERS,
+        };
+    }
+    _supports() {
+        return true;
+    }
+}

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

@@ -1 +1,3 @@
+export { GraphFetchEnvironmentMetricSeriesForGoogle } from './fetch-environment-metric-series.js';
+export { GraphGetEnvironmentProviderForGoogle } from './get-environment-provider.js';
 export { GraphListRulesForGoogle } from './list-rules.js';

package/dist/functions/graph/index.js

@@ -1 +1,3 @@
+export { GraphFetchEnvironmentMetricSeriesForGoogle } from './fetch-environment-metric-series.js';
+export { GraphGetEnvironmentProviderForGoogle } from './get-environment-provider.js';
 export { GraphListRulesForGoogle } from './list-rules.js';

package/dist/functions/index.js

@@ -1,18 +1,18 @@
 import { CausaListConfigurationSchemasForGoogle } from './causa/index.js';
 import { EmulatorStartForFirebaseStorage, EmulatorStartForFirestore, EmulatorStartForIdentityPlatform, EmulatorStartForPubSub, EmulatorStartForSpanner, EmulatorStopForFirebaseStorage, EmulatorStopForFirestore, EmulatorStopForIdentityPlatform, EmulatorStopForPubSub, EmulatorStopForSpanner, } from './emulator/index.js';
-import { EventTopicBrokerCreateTopicForPubSub, EventTopicBrokerCreateTriggerForCloudRun, EventTopicBrokerDeleteTopicForPubSub, EventTopicBrokerDeleteTriggerResourceForCloudRunInvokerRole, EventTopicBrokerDeleteTriggerResourceForCloudRunService, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, EventTopicBrokerWaitForProcessingForPubSub, EventTopicCreateBackfillSourceForBigQuery, EventTopicQueryEventsForBigQuery, } from './event-topic/index.js';
+import { EventTopicBrokerCreateTopicForPubSub, EventTopicBrokerCreateTriggerForCloudRun, EventTopicBrokerDeleteTopicForPubSub, EventTopicBrokerDeleteTriggerResourceForCloudRunInvokerRole, EventTopicBrokerDeleteTriggerResourceForCloudRunService, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, EventTopicBrokerWaitForProcessingForPubSub, EventTopicCountEventsForBigQuery, 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, 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, ModelGenerateTypeScriptDecoratorsForGoogleSpanner, ModelSchemaExtractDatabaseForGoogleSpanner, } from './google-spanner/index.js';
-import { GraphListRulesForGoogle } from './graph/index.js';
+import { DatabaseCountRecordsForSpanner, DatabaseQueryRecordsForSpanner, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, ModelGenerateTypeScriptDecoratorsForGoogleSpanner, ModelSchemaExtractDatabaseForGoogleSpanner, } from './google-spanner/index.js';
+import { GraphFetchEnvironmentMetricSeriesForGoogle, GraphGetEnvironmentProviderForGoogle, GraphListRulesForGoogle, } from './graph/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 { ModelGenerateTypeScriptTriggerDecoratorsForGoogle } 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, EventTopicBrokerDeleteTriggerResourceForCloudRunService, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, EventTopicBrokerWaitForProcessingForPubSub, EventTopicCreateBackfillSourceForBigQuery, EventTopicQueryEventsForBigQuery, GoogleAppCheckGenerateToken, GoogleFirebaseStorageMergeRules, GoogleFirestoreMergeRules, GoogleIdentityPlatformGenerateCustomToken, GoogleIdentityPlatformGenerateToken, GooglePubSubWriteTopics, GoogleServicesEnable, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, GraphListRulesForGoogle, ModelGenerateTypeScriptDecoratorsForGoogleFirestore, ModelGenerateTypeScriptDecoratorsForGoogleSpanner, ModelGenerateTypeScriptTriggerDecoratorsForGoogle, ModelSchemaExtractDatabaseForGoogleFirestore, ModelSchemaExtractDatabaseForGoogleSpanner, ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, ServiceContainerQueryLogsForCloudRun);
+    context.registerFunctionImplementations(CausaListConfigurationSchemasForGoogle, DatabaseCountRecordsForSpanner, DatabaseQueryRecordsForFirestore, DatabaseQueryRecordsForSpanner, EmulatorStartForFirebaseStorage, EmulatorStartForFirestore, EmulatorStartForIdentityPlatform, EmulatorStartForPubSub, EmulatorStartForSpanner, EmulatorStopForFirebaseStorage, EmulatorStopForFirestore, EmulatorStopForIdentityPlatform, EmulatorStopForPubSub, EmulatorStopForSpanner, EventTopicBrokerCreateTopicForPubSub, EventTopicBrokerCreateTriggerForCloudRun, EventTopicBrokerDeleteTopicForPubSub, EventTopicBrokerDeleteTriggerResourceForCloudRunInvokerRole, EventTopicBrokerDeleteTriggerResourceForCloudRunService, EventTopicBrokerDeleteTriggerResourceForPubSubSubscription, EventTopicBrokerDeleteTriggerResourceForServiceAccount, EventTopicBrokerGetTopicIdForPubSub, EventTopicBrokerPublishEventsForGoogle, EventTopicBrokerWaitForProcessingForPubSub, EventTopicCountEventsForBigQuery, EventTopicCreateBackfillSourceForBigQuery, EventTopicQueryEventsForBigQuery, GoogleAppCheckGenerateToken, GoogleFirebaseStorageMergeRules, GoogleFirestoreMergeRules, GoogleIdentityPlatformGenerateCustomToken, GoogleIdentityPlatformGenerateToken, GooglePubSubWriteTopics, GoogleServicesEnable, GoogleSpannerListDatabases, GoogleSpannerWriteDatabases, GraphFetchEnvironmentMetricSeriesForGoogle, GraphGetEnvironmentProviderForGoogle, GraphListRulesForGoogle, ModelGenerateTypeScriptDecoratorsForGoogleFirestore, ModelGenerateTypeScriptDecoratorsForGoogleSpanner, ModelGenerateTypeScriptTriggerDecoratorsForGoogle, ModelSchemaExtractDatabaseForGoogleFirestore, ModelSchemaExtractDatabaseForGoogleSpanner, ProjectGetArtefactDestinationForCloudFunctions, ProjectGetArtefactDestinationForCloudRun, ProjectPushArtefactForCloudFunctions, SecretFetchForGoogleAccessToken, SecretFetchForGoogleSecretManager, ServiceContainerQueryLogsForCloudRun);
 }

package/dist/graph/cloud-run.d.ts

@@ -1,5 +1,5 @@
 import type { ServiceContainerConfiguration } from '@causa/workspace-core';
-import { GraphFact, type GraphContext, type GraphFactOutput, type GraphTemplatePart, type WorkspaceProject } from '@causa/workspace-core/graph';
+import { GraphExtractionFact, type GraphContext, type GraphFactOutput, type GraphTemplatePart, type WorkspaceProject } from '@causa/workspace-core/graph';
 import { type TerraformModuleBlock } from '@causa/workspace-terraform';
 /**
  * A trigger defined in the `serviceContainer.triggers` configuration.
@@ -83,7 +83,7 @@ export type CloudRunService = {
  * The blocks of the Cloud Run module, evaluated against the configuration of the projects they deploy.
  * Blocks whose `configuration_file` does not name a project of the workspace cannot be mirrored, and are reported.
  */
-export declare class CloudRunFact extends GraphFact<CloudRunService[]> {
+export declare class CloudRunFact extends GraphExtractionFact<CloudRunService[]> {
     compute(graph: GraphContext): Promise<GraphFactOutput<CloudRunService[]>>;
     /**
      * Evaluates a Cloud Run module block, mirroring the defaults of the module.

package/dist/graph/cloud-run.js

@@ -1,4 +1,4 @@
-import { GraphFact, ProjectsFact, serviceId, } from '@causa/workspace-core/graph';
+import { GraphExtractionFact, ProjectsFact, serviceId, } from '@causa/workspace-core/graph';
 import { modulesWithSource, TerraformProjectsFact, } from '@causa/workspace-terraform';
 import { argumentOrConfiguration, projectOfConfigurationFile, } from './terraform-modules.js';
 /**
@@ -13,7 +13,7 @@ const MIRRORED_CLOUD_RUN_MAJOR = 1;
  * The blocks of the Cloud Run module, evaluated against the configuration of the projects they deploy.
  * Blocks whose `configuration_file` does not name a project of the workspace cannot be mirrored, and are reported.
  */
-export class CloudRunFact extends GraphFact {
+export class CloudRunFact extends GraphExtractionFact {
     async compute(graph) {
         const [terraformProjects, projects] = await Promise.all([
             graph.get(TerraformProjectsFact),

package/dist/graph/environment/fetchers/cloud-monitoring-alerts.d.ts

@@ -0,0 +1,6 @@
+import { type GraphEnvironmentFetcher } from '@causa/workspace-core';
+/**
+ * Reads the alerts open at the end of the evaluation window from Cloud Monitoring, and attaches them to the nodes of
+ * their resources.
+ */
+export declare const googleCloudMonitoringAlerts: GraphEnvironmentFetcher;

package/dist/graph/environment/fetchers/cloud-monitoring-alerts.js

@@ -0,0 +1,106 @@
+import { GraphAlertSeverity, } from '@causa/workspace-core';
+import { alertLabelValue, listOpenAlerts, } from '../monitoring-alerts.js';
+import { MONITORING_RESOURCE_MAPPINGS } from '../monitoring-catalog.js';
+import { findMonitoredNode, prepareMonitoringMapping, readMonitoringResourceKey, } from '../monitoring-mappings.js';
+import { googleResources } from '../resources.js';
+import { consoleUrl } from './console-links.js';
+/**
+ * The severities of alerts, keyed by the severity of their policy.
+ */
+const SEVERITIES = {
+    CRITICAL: GraphAlertSeverity.Critical,
+    ERROR: GraphAlertSeverity.Error,
+    WARNING: GraphAlertSeverity.Warning,
+};
+/**
+ * Converts an alert returned by the Alerts API to a {@link GraphAlert}.
+ *
+ * @param alert The alert.
+ * @param project The GCP project from which the alert was listed.
+ * @returns The alert.
+ */
+function toGraphAlert(alert, project) {
+    const severity = SEVERITIES[alert.policy?.severity ?? ''];
+    const id = alert.name?.split('/').at(-1);
+    return {
+        title: alert.policy?.displayName,
+        ...(severity ? { severity } : {}),
+        openedAt: new Date(alert.openTime),
+        ...(id
+            ? { url: consoleUrl(['monitoring', 'alerting', 'alerts', id], project) }
+            : {}),
+    };
+}
+/**
+ * Describes the resource of an alert in a warning.
+ *
+ * @param resource The resource of the alert.
+ * @returns The description.
+ */
+function describeResource(resource) {
+    if (!resource) {
+        return 'a resource of unknown type';
+    }
+    const labels = Object.entries(resource.labels)
+        .filter(([name]) => name !== 'value' && name !== 'monitored_resource')
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([name, value]) => `${name}=${value}`);
+    return `the '${resource.type}' resource (${labels.join(', ')})`;
+}
+/**
+ * Reads the alerts open at the end of the evaluation window from Cloud Monitoring, and attaches them to the nodes of
+ * their resources.
+ */
+export const googleCloudMonitoringAlerts = {
+    name: 'googleCloudMonitoringAlerts',
+    description: "The `alerts` open at the end of the evaluation window, read from Cloud Monitoring in the projects of the graph's resources, and attached to the nodes of their resources. Alerts that cannot be attached to a node are added to the environment.",
+    fetch: async (environment) => {
+        const projects = [
+            ...new Set(googleResources(environment).map(({ segments }) => segments.projects)),
+        ]
+            .filter((p) => !!p)
+            .sort();
+        const warnings = [];
+        const listed = await Promise.all(projects.map(async (project) => {
+            try {
+                return await listOpenAlerts(environment.context, project, environment.at);
+            }
+            catch (error) {
+                warnings.push({
+                    message: `Failed to list the alerts in project '${project}': ${error.message ?? error}`,
+                });
+                return [];
+            }
+        }));
+        const alerts = listed.flat();
+        if (alerts.length === 0) {
+            return { warnings };
+        }
+        // Only the mappings that may apply to an alert are prepared, as preparing a mapping may require listing resources,
+        // e.g. the backends of load balancers.
+        const candidates = (await Promise.all(MONITORING_RESOURCE_MAPPINGS.filter((mapping) => alerts.some(({ resource }) => resource?.type === mapping.monitoredResource &&
+            readMonitoringResourceKey(mapping, resource.project, (label) => alertLabelValue(resource, label)))).map((mapping) => prepareMonitoringMapping(environment, mapping)))).filter((m) => !!m);
+        const nodes = {};
+        const unattached = [];
+        for (const { alert, project, resource } of alerts) {
+            const graphAlert = toGraphAlert(alert, project);
+            const { node } = resource
+                ? findMonitoredNode(environment, candidates.filter(({ mapping }) => mapping.monitoredResource === resource.type), resource.project, (label) => alertLabelValue(resource, label))
+                : {};
+            if (node) {
+                nodes[node.id] ??= { alerts: [] };
+                nodes[node.id].alerts.push(graphAlert);
+                continue;
+            }
+            unattached.push(graphAlert);
+            warnings.push({
+                message: `The alert of policy '${graphAlert.title}' on ${describeResource(resource)} could not be attached to a node, and is added to the environment.`,
+            });
+        }
+        return {
+            nodes,
+            ...(unattached.length > 0 ? { alerts: unattached } : {}),
+            warnings,
+        };
+    },
+};

package/dist/graph/environment/fetchers/cloud-monitoring.d.ts

@@ -0,0 +1,5 @@
+import type { GraphEnvironmentFetcher } from '@causa/workspace-core';
+/**
+ * Reads the metrics of nodes from Cloud Monitoring, over the evaluation window.
+ */
+export declare const googleCloudMonitoring: GraphEnvironmentFetcher;

package/dist/graph/environment/fetchers/cloud-monitoring.js

@@ -0,0 +1,13 @@
+import { MONITORING_METRICS } from '../monitoring-catalog.js';
+import { queryPointInTimeMetrics } from '../monitoring-query.js';
+/**
+ * Reads the metrics of nodes from Cloud Monitoring, over the evaluation window.
+ */
+export const googleCloudMonitoring = {
+    name: 'googleCloudMonitoring',
+    description: 'The metrics of Cloud Run services, API routers, Pub/Sub topics and subscriptions, Cloud Tasks queues, and Spanner, Firestore, and BigQuery databases, read from Cloud Monitoring.',
+    fetch: async (environment) => {
+        const { nodes, bucketLayouts, warnings } = await queryPointInTimeMetrics(environment, MONITORING_METRICS);
+        return { nodes, bucketLayouts, warnings };
+    },
+};

package/dist/graph/environment/fetchers/cloud-run.d.ts

@@ -0,0 +1,5 @@
+import type { GraphEnvironmentFetcher } from '@causa/workspace-core';
+/**
+ * Reads the deployments of Cloud Run services.
+ */
+export declare const googleCloudRun: GraphEnvironmentFetcher;