@intentius/chant-lexicon-gcp 0.0.15

package/src/testdata/storage-bucket.yaml

@@ -0,0 +1,100 @@
+apiVersion: apiextensions.k8s.io/v1
+kind: CustomResourceDefinition
+metadata:
+  name: storagebuckets.storage.cnrm.cloud.google.com
+spec:
+  group: storage.cnrm.cloud.google.com
+  names:
+    kind: StorageBucket
+    plural: storagebuckets
+    singular: storagebucket
+  versions:
+    - name: v1beta1
+      served: true
+      storage: true
+      schema:
+        openAPIV3Schema:
+          type: object
+          properties:
+            apiVersion:
+              type: string
+            kind:
+              type: string
+            metadata:
+              type: object
+            spec:
+              type: object
+              required:
+                - location
+              properties:
+                location:
+                  type: string
+                  description: The GCS location.
+                storageClass:
+                  type: string
+                  description: The Storage Class of the new bucket.
+                  enum:
+                    - STANDARD
+                    - NEARLINE
+                    - COLDLINE
+                    - ARCHIVE
+                uniformBucketLevelAccess:
+                  type: boolean
+                  description: Enables uniform bucket-level access on a bucket.
+                versioning:
+                  type: object
+                  properties:
+                    enabled:
+                      type: boolean
+                encryption:
+                  type: object
+                  properties:
+                    defaultKmsKeyName:
+                      type: string
+                lifecycleRule:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      action:
+                        type: object
+                        properties:
+                          type:
+                            type: string
+                          storageClass:
+                            type: string
+                      condition:
+                        type: object
+                        properties:
+                          age:
+                            type: integer
+                          isLive:
+                            type: boolean
+                cors:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      origin:
+                        type: array
+                        items:
+                          type: string
+                      method:
+                        type: array
+                        items:
+                          type: string
+                      responseHeader:
+                        type: array
+                        items:
+                          type: string
+                      maxAgeSeconds:
+                        type: integer
+                resourceID:
+                  type: string
+            status:
+              type: object
+              properties:
+                selfLink:
+                  type: string
+                url:
+                  type: string

package/src/validate-cli.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env bun
+import { validate } from "./validate";
+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/src/validate.test.ts

@@ -0,0 +1,38 @@
+import { describe, test, expect } from "bun:test";
+import { existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const pkgDir = dirname(dirname(fileURLToPath(import.meta.url)));
+const hasGenerated = existsSync(join(pkgDir, "src", "generated", "lexicon-gcp.json"));
+
+describe("validate", () => {
+  test("validate function exists and is exported", async () => {
+    const mod = await import("./validate");
+    expect(typeof mod.validate).toBe("function");
+  });
+
+  test("REQUIRED_NAMES covers core resource types", async () => {
+    const mod = await import("./validate");
+    expect(mod.validate).toBeDefined();
+  });
+
+  test.skipIf(!hasGenerated)("validate succeeds with generated artifacts", async () => {
+    const { validate } = await import("./validate");
+    const result = await validate();
+    expect(result).toBeDefined();
+    expect(result.checks).toBeDefined();
+    expect(Array.isArray(result.checks)).toBe(true);
+  }, 60_000);
+
+  test("handles missing generated files", async () => {
+    const { validate } = await import("./validate");
+    if (!hasGenerated) {
+      try {
+        await validate();
+      } catch {
+        // Expected — no generated files
+      }
+    }
+  });
+});

package/src/validate.ts

@@ -0,0 +1,30 @@
+/**
+ * Validate generated lexicon-gcp artifacts.
+ */
+
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+import { validateLexiconArtifacts, type ValidateResult } from "@intentius/chant/codegen/validate";
+
+export type { ValidateCheck, ValidateResult } from "@intentius/chant/codegen/validate";
+
+const REQUIRED_NAMES = [
+  "ComputeInstance", "StorageBucket", "GKECluster", "SQLInstance",
+  "GCPServiceAccount", "IAMPolicyMember", "CloudRunService", "PubSubTopic",
+  "VPCNetwork",
+];
+
+export async function validate(opts?: { basePath?: string }): Promise<ValidateResult> {
+  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/src/variables.ts

@@ -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",
+} as const;