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

package/dist/graph/environment/resources.d.ts

@@ -0,0 +1,45 @@
+import type { GraphEnvironmentContext, GraphNodeEntry } from '@causa/workspace-core/graph';
+/**
+ * The segments of a Google Cloud resource name, keyed by collection.
+ * For example, `projects/my-project/locations/europe-west1/services/my-service` is
+ * `{ projects: 'my-project', locations: 'europe-west1', services: 'my-service' }`.
+ */
+export type ResourceNameSegments = Record<string, string>;
+/**
+ * Parses a Google Cloud resource name into its segments.
+ * The `global` segment, which is not followed by an ID (e.g. in `projects/my-project/global/urlMaps/api`), is skipped.
+ *
+ * @param name The resource name.
+ * @returns The segments, keyed by collection.
+ */
+export declare function parseResourceName(name: string): ResourceNameSegments;
+/**
+ * A node whose resource is a Google Cloud resource, along with its full name.
+ */
+export type GoogleResource = {
+    /**
+     * The node.
+     */
+    readonly node: GraphNodeEntry;
+    /**
+     * The type of the resource, e.g. `run.googleapis.com/Service`.
+     */
+    readonly type: string;
+    /**
+     * The full resource name.
+     */
+    readonly name: string;
+    /**
+     * The segments of the resource name.
+     */
+    readonly segments: ResourceNameSegments;
+};
+/**
+ * Returns the Google Cloud resources of the graph, with the segments of their names.
+ *
+ * @param environment The context of the environment.
+ * @param resourceType The type of the resources. Defaults to all Google Cloud resource types.
+ * @param nodeType The type of the nodes. Defaults to all node types.
+ * @returns The resources, in the order of the graph.
+ */
+export declare function googleResources(environment: GraphEnvironmentContext, resourceType?: string, nodeType?: string): GoogleResource[];

package/dist/graph/environment/resources.js

@@ -0,0 +1,49 @@
+/**
+ * Parses a Google Cloud resource name into its segments.
+ * The `global` segment, which is not followed by an ID (e.g. in `projects/my-project/global/urlMaps/api`), is skipped.
+ *
+ * @param name The resource name.
+ * @returns The segments, keyed by collection.
+ */
+export function parseResourceName(name) {
+    const tokens = name.split('/');
+    const segments = {};
+    for (let index = 0; index < tokens.length;) {
+        const collection = tokens[index];
+        if (collection === 'global') {
+            index += 1;
+            continue;
+        }
+        segments[collection] = tokens[index + 1] ?? '';
+        index += 2;
+    }
+    return segments;
+}
+/**
+ * Returns whether a resource type is the type of a Google Cloud resource.
+ *
+ * @param type The type of the resource.
+ * @returns `true` for Google Cloud resource types, e.g. `run.googleapis.com/Service`.
+ */
+function isGoogleResourceType(type) {
+    return type.includes('.googleapis.com/');
+}
+/**
+ * Returns the Google Cloud resources of the graph, with the segments of their names.
+ *
+ * @param environment The context of the environment.
+ * @param resourceType The type of the resources. Defaults to all Google Cloud resource types.
+ * @param nodeType The type of the nodes. Defaults to all node types.
+ * @returns The resources, in the order of the graph.
+ */
+export function googleResources(environment, resourceType, nodeType) {
+    return environment
+        .resources(resourceType, nodeType)
+        .filter(({ resource }) => isGoogleResourceType(resource.type))
+        .map(({ node, resource: { type, id } }) => ({
+        node,
+        type,
+        name: id,
+        segments: parseResourceName(id),
+    }));
+}

package/dist/graph/index.d.ts

@@ -1,4 +1,5 @@
 export * from './cloud-run.js';
+export * from './environment/index.js';
 export * from './ids.js';
 export * from './rules/configuration/index.js';
 export * from './rules/terraform/index.js';

package/dist/graph/index.js

@@ -1,4 +1,5 @@
 export * from './cloud-run.js';
+export * from './environment/index.js';
 export * from './ids.js';
 export * from './rules/configuration/index.js';
 export * from './rules/terraform/index.js';

package/dist/graph/spanner.d.ts

@@ -1,5 +1,5 @@
 import type { GraphOriginSource } from '@causa/workspace-core';
-import { GraphFact, type EntityFacts, type GraphContext, type GraphFactOutput, type WorkspaceDomain } from '@causa/workspace-core/graph';
+import { GraphExtractionFact, type EntityFacts, type GraphContext, type GraphFactOutput, type WorkspaceDomain } from '@causa/workspace-core/graph';
 /**
  * A table created by a `CREATE TABLE` statement in a Spanner DDL file.
  */
@@ -63,7 +63,7 @@ export type SpannerFacts = {
  * The Spanner databases of the workspace, as `GoogleSpannerListDatabases` lists them, and the tables their DDL files
  * create.
  */
-export declare class SpannerFact extends GraphFact<SpannerFacts> {
+export declare class SpannerFact extends GraphExtractionFact<SpannerFacts> {
     compute(graph: GraphContext): Promise<GraphFactOutput<SpannerFacts>>;
     /**
      * Parses the tables created by the `CREATE TABLE` statements of DDL files.

package/dist/graph/spanner.js

@@ -1,4 +1,4 @@
-import { domainAt, domainOfFile, DomainsFact, GraphFact, } from '@causa/workspace-core/graph';
+import { domainAt, domainOfFile, DomainsFact, GraphExtractionFact, } from '@causa/workspace-core/graph';
 import { readFile } from 'fs/promises';
 import { dirname, join, relative } from 'path';
 import { GoogleSpannerListDatabases } from '../functions/google-spanner/index.js';
@@ -7,7 +7,7 @@ import { SPANNER_ENGINE, spannerDatabaseLocator, spannerDatabaseName, } from './
  * The Spanner databases of the workspace, as `GoogleSpannerListDatabases` lists them, and the tables their DDL files
  * create.
  */
-export class SpannerFact extends GraphFact {
+export class SpannerFact extends GraphExtractionFact {
     async compute(graph) {
         const { context } = graph;
         const instance = context

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@causa/workspace-google",
-  "version": "1.4.0-beta.1",
+  "version": "1.4.0-beta.2",
   "description": "The Causa workspace module providing many functionalities related to GCP and its services.",
   "repository": {
     "type": "git",
@@ -35,21 +35,21 @@
     "generateConfigurationSchemas": "cs model genCode && perl -pi -e 's|\\@causa/runtime|\\@causa/workspace/validation|g' src/configurations/generated.ts"
   },
   "dependencies": {
-    "@causa/cli": "^1.0.0",
-    "@causa/workspace": "^1.2.0",
-    "@causa/workspace-core": "^1.5.0-beta.1",
-    "@causa/workspace-terraform": "^1.1.0-beta.1",
-    "@causa/workspace-typescript": "^1.3.0",
-    "@google-cloud/apikeys": "^3.1.0",
+    "@causa/cli": "^1.0.1-beta.1",
+    "@causa/workspace": "^1.3.0-beta.1",
+    "@causa/workspace-core": "^1.5.0-beta.2",
+    "@causa/workspace-terraform": "^1.1.0-beta.2",
+    "@causa/workspace-typescript": "^1.4.0-beta.1",
+    "@google-cloud/apikeys": "^3.1.1",
     "@google-cloud/bigquery": "^9.1.0",
-    "@google-cloud/iam-credentials": "^5.0.0",
+    "@google-cloud/iam-credentials": "^5.0.1",
     "@google-cloud/logging": "^12.1.0",
-    "@google-cloud/monitoring": "^6.1.0",
+    "@google-cloud/monitoring": "^6.1.1",
     "@google-cloud/pubsub": "^6.1.0",
-    "@google-cloud/resource-manager": "^7.1.0",
-    "@google-cloud/run": "^4.1.0",
-    "@google-cloud/secret-manager": "^7.1.0",
-    "@google-cloud/service-usage": "^5.1.0",
+    "@google-cloud/resource-manager": "^7.1.1",
+    "@google-cloud/run": "^4.1.1",
+    "@google-cloud/secret-manager": "^7.1.1",
+    "@google-cloud/service-usage": "^5.1.1",
     "@google-cloud/spanner": "^9.0.0",
     "@google-cloud/storage": "^8.2.0",
     "class-transformer": "^0.5.1",
@@ -58,26 +58,26 @@
     "firebase-admin": "^14.5.0",
     "globby": "^16.2.4",
     "google-gax": "5.0.6",
-    "googleapis": "^182.0.0",
+    "googleapis": "^183.0.0",
     "micromatch": "^4.0.8",
-    "pino": "^10.3.1"
+    "pino": "^10.4.0"
   },
   "devDependencies": {
-    "@swc/core": "^1.16.2",
+    "@swc/core": "^1.16.13",
     "@swc/jest": "^0.2.39",
     "@tsconfig/node22": "^22.0.6",
     "@types/jest": "^30.0.0",
     "@types/micromatch": "^4.0.10",
-    "@types/node": "^22.20.4",
+    "@types/node": "^22.20.5",
     "copyfiles": "^2.4.1",
-    "eslint": "^10.11.0",
+    "eslint": "^10.12.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.6",
     "jest": "^30.5.2",
     "jest-extended": "^7.0.0",
     "rimraf": "^6.1.3",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.70.1",
+    "typescript-eslint": "^8.71.1",
     "yaml": "^2.9.1"
   }
 }