@intentius/chant-lexicon-gcp 0.124.31 → 0.124.33

package/dist/validate-cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env tsx
+import { validate } from "./validate.js";
+import { printValidationResult } from "@intentius/chant/codegen/validate";
+async function main() {
+    const result = await validate();
+    printValidationResult(result);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/validate.js

@@ -0,0 +1,24 @@
+/**
+ * Validate generated lexicon-gcp artifacts.
+ */
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { validateLexiconArtifacts } from "@intentius/chant/codegen/validate";
+const REQUIRED_NAMES = [
+    "ComputeInstance", "StorageBucket", "GKECluster", "SQLInstance",
+    "GCPServiceAccount", "IAMPolicyMember", "CloudRunService", "PubSubTopic",
+    "VPCNetwork",
+];
+export async function validate(opts) {
+    const basePath = opts?.basePath ?? dirname(dirname(fileURLToPath(import.meta.url)));
+    return validateLexiconArtifacts({
+        lexiconJsonFilename: "lexicon-gcp.json",
+        requiredNames: REQUIRED_NAMES,
+        basePath,
+        coverageThresholds: {
+            minPropertyPct: 0,
+            minLifecyclePct: 0,
+            minAttrPct: 1,
+        },
+    });
+}

package/dist/variables.js

@@ -0,0 +1,15 @@
+/**
+ * Well-known Config Connector annotation keys.
+ */
+export const GcpAnnotations = {
+    /** Bind a resource to a specific GCP project. */
+    ProjectId: "cnrm.cloud.google.com/project-id",
+    /** Control what happens when a resource is deleted from K8s. */
+    DeletionPolicy: "cnrm.cloud.google.com/deletion-policy",
+    /** Whether to merge observed spec back into the resource. */
+    StateIntoSpec: "cnrm.cloud.google.com/state-into-spec",
+    /** Strategy when another controller manages the same resource. */
+    ManagementConflictPolicy: "cnrm.cloud.google.com/management-conflict-prevention-policy",
+    /** Disable dependent resource reconciliation. */
+    SkipDependentResources: "cnrm.cloud.google.com/skip-dependent-resources",
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-gcp",
-  "version": "0.124.31",
+  "version": "0.124.33",
   "description": "Google Cloud lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -32,27 +32,27 @@
     ".": {
       "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
-      "default": "./src/index.ts"
+      "default": "./dist/index.js"
     },
     "./*": {
       "development": "./src/*.ts",
       "types": "./dist/*.d.ts",
-      "default": "./src/*.ts"
+      "default": "./dist/*.js"
     },
     "./detect": {
       "development": "./src/detect.ts",
       "types": "./dist/detect.d.ts",
-      "default": "./src/detect.ts"
+      "default": "./dist/detect.js"
     },
     "./op/activities": {
       "development": "./src/op/activities/index.ts",
       "types": "./dist/op/activities/index.d.ts",
-      "default": "./src/op/activities/index.ts"
+      "default": "./dist/op/activities/index.js"
     },
     "./lint/post-synth": {
       "development": "./src/lint/post-synth/index.ts",
       "types": "./dist/lint/post-synth/index.d.ts",
-      "default": "./src/lint/post-synth/index.ts"
+      "default": "./dist/lint/post-synth/index.js"
     },
     "./manifest": "./dist/manifest.json",
     "./meta": "./dist/meta.json",
@@ -64,7 +64,7 @@
     "validate": "tsx src/validate-cli.ts",
     "docs": "tsx src/codegen/docs-cli.ts",
     "prepack": "npm run generate && npm run bundle && npm run validate && npm run build",
-    "build": "../../scripts/tsc7.sh -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && find dist -type f \\( -name \"*.js\" -o -name \"*.js.map\" \\) -delete"
+    "build": "../../scripts/tsc7.sh -p tsconfig.build.json --sourceMap false && tsc-alias -p tsconfig.build.json"
   },
   "dependencies": {
     "fflate": "^0.8.2",
@@ -76,6 +76,6 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.124.31"
+    "@intentius/chant": "^0.124.33"
   }
 }

package/src/attributes.test.ts

@@ -0,0 +1,16 @@
+/**
+ * A RunService's URL is referenceable (#4179), so DNS in another lexicon can
+ * point at it: `status.uri` is read through `status_uri`.
+ */
+
+import { describe, expect, test } from "vitest";
+import { AttrRef } from "@intentius/chant";
+import { CloudRunService } from "./index";
+
+describe("status attributes", () => {
+  test("a RunService exposes status.uri as an AttrRef", () => {
+    const svc = new CloudRunService({ location: "us-central1", projectRef: { external: "p" }, template: {} }) as unknown as Record<string, unknown>;
+    expect(svc.status_uri).toBeInstanceOf(AttrRef);
+    expect((svc.status_uri as AttrRef).attribute).toBe("status.uri");
+  });
+});

package/src/codegen/generate.ts

@@ -125,7 +125,7 @@ function generateLexiconJSON(results: GcpParseResult[], naming: NamingStrategy):
         required: r.resource.properties.filter((p) => p.required).map((p) => p.name),
       },
       attrs: Object.fromEntries(
-        r.resource.attributes.map((a) => [a.name, a.tsType]),
+        r.resource.attributes.map((a) => [attrKey(a.name), a.tsType]),
       ),
     };
 
@@ -170,7 +170,7 @@ function generateTypeScriptDeclarations(results: GcpParseResult[], naming: Namin
 
     // Attributes
     for (const attr of r.resource.attributes) {
-      lines.push(`  readonly ${attr.name}: ${attr.tsType};`);
+      lines.push(`  readonly ${attrKey(attr.name)}: ${attr.tsType};`);
     }
 
     lines.push(`}`);
@@ -222,6 +222,11 @@ function generateTypeScriptDeclarations(results: GcpParseResult[], naming: Namin
 
 // ── Runtime index generation ────────────────────────────────────────
 
+/** The property an attribute is read through: `status.uri` is `status_uri`, as AWS's `Endpoint.Address` is `Endpoint_Address`. */
+function attrKey(name: string): string {
+  return name.replace(/\./g, "_");
+}
+
 function generateRuntimeIndex(results: GcpParseResult[], naming: NamingStrategy): string {
   const resourceEntries: RuntimeIndexEntry[] = [];
   const propertyEntries: RuntimeIndexPropertyEntry[] = [];
@@ -234,7 +239,7 @@ function generateRuntimeIndex(results: GcpParseResult[], naming: NamingStrategy)
 
     const attrs: Record<string, string> = {};
     for (const a of r.resource.attributes) {
-      attrs[a.name] = a.name;
+      attrs[attrKey(a.name)] = a.name;
     }
 
     resourceEntries.push({ tsName, resourceType: cfnType, attrs });

package/src/codegen/package.ts

@@ -6,7 +6,7 @@
 import { readFileSync } from "fs";
 import { gcpPlugin } from "../plugin";
 import { dirname } from "path";
-import { fileURLToPath } from "url";
+import { moduleSourceDir } from "@intentius/chant/module-source";
 import {
   packagePipeline,
   collectSkills,
@@ -18,7 +18,7 @@ import { generate } from "./generate";
 export type { PackageOptions, PackageResult };
 
 // src/codegen/package.ts → dirname x2 → src/ (srcDir for rule collection)
-const pkgDir = dirname(dirname(fileURLToPath(import.meta.url)));
+const pkgDir = dirname(moduleSourceDir(import.meta.url));
 
 /**
  * Package the GCP lexicon into a distributable BundleSpec.

package/src/composites/catalog.ts

@@ -119,7 +119,13 @@ export const compositeCatalog: CompositeEntry[] = [
         "name": "location",
         "type": "string",
         "required": false,
-        "description": "GCP region."
+        "description": "GCP region (default: GCP.Region, resolved from GCP_REGION at build)."
+      },
+      {
+        "name": "projectId",
+        "type": "string",
+        "required": false,
+        "description": "GCP project the service runs in, as `projectRef.external` (default: GCP.ProjectId, resolved from GCP_PROJECT_ID at build)."
       },
       {
         "name": "port",

package/src/composites/cloud-run-service.ts

@@ -7,14 +7,17 @@ import {
   CloudRunService as CloudRunServiceResource,
   IAMPolicyMember,
 } from "../generated";
+import { GCP } from "../pseudo";
 
 export interface CloudRunServiceProps {
   /** Service name. */
   name: string;
   /** Container image. */
   image: string;
-  /** GCP region. */
+  /** GCP region (default: GCP.Region, resolved from GCP_REGION at build). */
   location?: string;
+  /** GCP project the service runs in, as `projectRef.external` (default: GCP.ProjectId, resolved from GCP_PROJECT_ID at build). */
+  projectId?: string;
   /** Port the container listens on (default: 8080). */
   port?: number;
   /** CPU limit (default: "1000m"). */
@@ -47,10 +50,12 @@ export interface CloudRunServiceProps {
  *
  * @example
  * ```ts
- * import { CloudRunService } from "@intentius/chant-lexicon-gcp";
+ * import { CloudRunServiceComposite } from "@intentius/chant-lexicon-gcp";
  *
- * const { service, publicIam } = CloudRunService({
+ * const { service, publicIam } = CloudRunServiceComposite({
  *   name: "my-api",
+ *   projectId: "my-project",
+ *   location: "us-central1",
  *   image: "gcr.io/my-project/my-api:latest",
  *   publicAccess: true,
  * });
@@ -61,6 +66,7 @@ export const CloudRunServiceComposite = Composite((props: CloudRunServiceProps)
     name,
     image,
     location,
+    projectId,
     port = 8080,
     cpuLimit = "1000m",
     memoryLimit = "512Mi",
@@ -97,7 +103,8 @@ export const CloudRunServiceComposite = Composite((props: CloudRunServiceProps)
       ...(namespace && { namespace }),
       labels: { ...commonLabels, "app.kubernetes.io/component": "service" },
     },
-    ...(location && { location }),
+    location: location ?? GCP.Region,
+    projectRef: { external: projectId ?? GCP.ProjectId },
     template: {
       maxInstanceRequestConcurrency,
       scaling: {
@@ -106,7 +113,7 @@ export const CloudRunServiceComposite = Composite((props: CloudRunServiceProps)
       },
       containers,
     },
-  } as Record<string, unknown>, defs?.service));
+  }, defs?.service));
 
   const result: Record<string, any> = { service };
 

package/src/composites/composites.test.ts

@@ -83,6 +83,23 @@ describe("CloudRunServiceComposite", () => {
     expect(result.service).toBeDefined();
   });
 
+  test("sets projectRef and location, which the RunService CRD requires", () => {
+    const result = CloudRunServiceComposite({
+      name: "api",
+      image: "gcr.io/p/api:1",
+      projectId: "proj",
+      location: "us-central1",
+    });
+    expect(p(result.service).projectRef).toEqual({ external: "proj" });
+    expect(p(result.service).location).toBe("us-central1");
+  });
+
+  test("defaults projectRef and location to the GCP pseudo-parameters", () => {
+    const result = CloudRunServiceComposite({ name: "api", image: "gcr.io/p/api:1" });
+    expect(JSON.parse(JSON.stringify(p(result.service).projectRef))).toEqual({ external: { Ref: "GCP::ProjectId" } });
+    expect(JSON.parse(JSON.stringify(p(result.service).location))).toEqual({ Ref: "GCP::Region" });
+  });
+
   test("no public IAM by default", () => {
     const result = CloudRunServiceComposite({ name: "api", image: "gcr.io/p/api:1" });
     expect(result.publicIam).toBeUndefined();