@intentius/chant-lexicon-gcp 0.49.0 → 0.50.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { gcpApply, gcpDelete, flociGcpUp, flociGcpDown } from "./op/builders.js";
 export { gcpSerializer } from "./serializer.js";
 export { gcpPlugin } from "./plugin.js";
 export { defaultLabels, defaultAnnotations, isDefaultLabels, isDefaultAnnotations } from "./default-labels.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAGrF,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EACL,UAAU,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAC7E,cAAc,EAAE,wBAAwB,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAC3F,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAC5D,oBAAoB,EAAE,mBAAmB,EAAE,uBAAuB,GACnE,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,eAAe,EAAE,SAAS,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EAAE,oBAAoB,EAC1C,mBAAmB,EAAE,uBAAuB,EAC5C,gBAAgB,EAAE,gBAAgB,EAClC,yBAAyB,EAAE,wBAAwB,EAAE,4BAA4B,GAClF,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,iBAAiB,EAAE,2BAA2B,EAC9C,uBAAuB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,GACtF,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG9H,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGxH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC1G,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrI,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG9E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAGrF,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EACL,UAAU,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAC7E,cAAc,EAAE,wBAAwB,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAC3F,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAC5D,oBAAoB,EAAE,mBAAmB,EAAE,uBAAuB,GACnE,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,eAAe,EAAE,SAAS,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EAAE,oBAAoB,EAC1C,mBAAmB,EAAE,uBAAuB,EAC5C,gBAAgB,EAAE,gBAAgB,EAClC,yBAAyB,EAAE,wBAAwB,EAAE,4BAA4B,GAClF,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,iBAAiB,EAAE,2BAA2B,EAC9C,uBAAuB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,GACtF,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG9H,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGxH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC1G,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrI,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "227727b18bfb8d0875e8ea92b6c572ec1294fadfb0edb8ce0a641f1674c90b1f",
+    "manifest.json": "ed246ac3b74e491648ab0fe551472acafbae7f5ec4dcd09f4cfca817effe4eea",
     "meta.json": "475f10909854d059a2e2d4fb541c058803422e38b9c64bd4d6858c0623eedb8c",
     "types/index.d.ts": "5433b54c04b57d6fda8f3d81ef92ed0aca87f7e8e5dd3ea92d8de6e62a3ccfab",
     "rules/hardcoded-project.ts": "228631d3159e1ffcce2359c66073d4ae59bb0285f378e46e446f416aec50481c",
@@ -40,5 +40,5 @@
     "skills/chant-gcp-patterns.md": "4c6809fc7c37fa1879379ad4c0e2d114dec9497bc6eb9d1bca4e79fddea4f509",
     "skills/chant-gcp-gke.md": "be277019da9a722c851e47cd2dfb9c9536668948c3535fb20db7697e934c4e2b"
   },
-  "composite": "2592321e250e7dbd8adcad67b82a9232652af393445d16192e44bf7a5e1ebda9"
+  "composite": "d82d01c89efe07eb6159d280987dae5435443c5f5696f5d1044d8812f87a0f31"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "gcp",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "chantVersion": ">=0.1.0",
   "namespace": "GCP",
   "intrinsics": [],

package/dist/op/builders.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Typed step-builder wrappers for this lexicon's activities (chant #1288
+ * Stage 2). See `lexicons/k8s/src/op/builders.ts`'s module doc for why these
+ * live beside their `*Args` interfaces rather than in core or the temporal
+ * barrel. `opts`'s type in each wrapper below IS the activity's own `*Args`
+ * interface (via `Omit`/`WithStepRefs`) — never restated. `core`'s own
+ * `gcpApply`/`gcpDelete`/`flociGcpUp`/`flociGcpDown` are unchanged and
+ * produce byte-identical `ActivityStep` output; these are purely additive.
+ */
+import { type ActivityStep, type NamedActivityStep, type WithStepRefs } from "@intentius/chant/op";
+import type { GcpApplyArgs } from "./activities/gcp-apply.js";
+import type { FlociGcpUpArgs, FlociGcpDownArgs } from "./activities/floci-gcp.js";
+/** Extra opts every wrapper below accepts alongside its activity's own fields. */
+type StepOpts = {
+    profile?: ActivityStep["profile"];
+    id?: string;
+};
+/**
+ * Apply built GCP (CNRM) resources directly to their GCP REST APIs — the
+ * fully typed twin of core's `gcpApply`. `opts` is {@link GcpApplyArgs}
+ * itself, minus the positional `manifestPath`. Defaults to the `longInfra`
+ * profile.
+ */
+export declare const gcpApply: (manifestPath: string, opts?: WithStepRefs<Omit<GcpApplyArgs, "manifestPath">> & StepOpts) => NamedActivityStep;
+/**
+ * Delete the GCP (CNRM) resources in a built manifest — the inverse of
+ * {@link gcpApply}, fully typed twin of core's `gcpDelete`. `opts` is
+ * {@link GcpApplyArgs} itself (the activity reuses it), minus the positional
+ * `manifestPath`. Defaults to the `longInfra` profile.
+ */
+export declare const gcpDelete: (manifestPath: string, opts?: WithStepRefs<Omit<GcpApplyArgs, "manifestPath">> & StepOpts) => NamedActivityStep;
+/**
+ * Boot a local floci-gcp (GCP emulator) — the fully typed twin of core's
+ * `flociGcpUp`. `opts` is {@link FlociGcpUpArgs} itself. Defaults to the
+ * `longInfra` profile.
+ */
+export declare const flociGcpUp: (opts?: WithStepRefs<FlociGcpUpArgs> & StepOpts) => NamedActivityStep;
+/**
+ * Stop and remove the local floci-gcp container — the fully typed twin of
+ * core's `flociGcpDown`. `opts` is {@link FlociGcpDownArgs} itself. Defaults
+ * to the `fastIdempotent` profile.
+ */
+export declare const flociGcpDown: (opts?: WithStepRefs<FlociGcpDownArgs> & StepOpts) => NamedActivityStep;
+export {};
+//# sourceMappingURL=builders.d.ts.map

package/dist/op/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/op/builders.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,kFAAkF;AAClF,KAAK,QAAQ,GAAG;IAAE,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GACnB,cAAc,MAAM,EACpB,OAAO,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,GAAG,QAAQ,KACjE,iBAGF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,cAAc,MAAM,EACpB,OAAO,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,GAAG,QAAQ,KACjE,iBAGF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,YAAY,CAAC,cAAc,CAAC,GAAG,QAAQ,KAAG,iBAG3E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,YAAY,CAAC,gBAAgB,CAAC,GAAG,QAAQ,KAAG,iBAG/E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-gcp",
-  "version": "0.49.0",
+  "version": "0.50.0",
   "description": "Google Cloud lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -76,7 +76,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.49.0",
+    "@intentius/chant": "^0.50.0",
     "typescript": "^5.9.3"
   }
 }

package/src/index.ts

@@ -1,3 +1,11 @@
+// Typed Op step-builder wrappers (chant #1288 Stage 2) — gcpApply/gcpDelete/
+// flociGcpUp/flociGcpDown with authoring-time types derived from this
+// lexicon's own *Args interfaces (see ./op/builders.ts's module doc for why
+// these live here rather than in core or the temporal barrel). Opt-in:
+// `@intentius/chant-lexicon-temporal`'s same-named exports are core's
+// original untyped builders, unchanged.
+export { gcpApply, gcpDelete, flociGcpUp, flociGcpDown } from "./op/builders";
+
 // Serializer
 export { gcpSerializer } from "./serializer";
 

package/src/op/builders.test.ts

@@ -0,0 +1,58 @@
+/**
+ * Typed step-builder wrappers (chant #1288 Stage 2) — see
+ * `lexicons/k8s/src/op/builders.test.ts`'s module doc for what's asserted
+ * and why.
+ */
+
+import { describe, test, expect } from "vitest";
+import {
+  gcpApply as gcpApplyOld,
+  gcpDelete as gcpDeleteOld,
+  flociGcpUp as flociGcpUpOld,
+  flociGcpDown as flociGcpDownOld,
+  stepOutput,
+  type StepOutputRef,
+} from "@intentius/chant/op";
+import { gcpApply, gcpDelete, flociGcpUp, flociGcpDown } from "./builders";
+
+describe("gcp typed step builders (#1288 Stage 2)", () => {
+  test("gcpApply: identical ActivityStep to core's original for a minimal call", () => {
+    expect(gcpApply("dist/manifest.yaml")).toEqual(gcpApplyOld("dist/manifest.yaml"));
+  });
+
+  test("gcpApply: identical ActivityStep with opts", () => {
+    const opts = { project: "my-project", prune: true };
+    expect(gcpApply("dist/manifest.yaml", opts)).toEqual(gcpApplyOld("dist/manifest.yaml", opts));
+  });
+
+  test("gcpDelete: identical ActivityStep to core's original", () => {
+    expect(gcpDelete("dist/manifest.yaml")).toEqual(gcpDeleteOld("dist/manifest.yaml"));
+  });
+
+  test("flociGcpUp/flociGcpDown: identical ActivityStep to core's original", () => {
+    expect(flociGcpUp()).toEqual(flociGcpUpOld());
+    expect(flociGcpDown()).toEqual(flociGcpDownOld());
+  });
+
+  test("gcpApply: accepts a StepOutputRef in a typed slot", () => {
+    const ref = stepOutput("resolve-project", "project");
+    const step = gcpApply("dist/manifest.yaml", { project: ref });
+    expect(step.args?.project).toBe(ref);
+  });
+
+  test("gcpApply: .out is reachable when an id is given", () => {
+    const step = gcpApply("dist/manifest.yaml", { id: "apply" });
+    const ref: StepOutputRef = step.out.applied;
+    expect(ref.step).toBe("apply");
+  });
+});
+
+// ── Compile-time-only: authoring-time type errors (never executed) ──────────
+function _typeChecksOnly(): void {
+  // @ts-expect-error — "projectId" is not a key of GcpApplyArgs (the field is `project`).
+  gcpApply("dist/manifest.yaml", { projectId: "my-project" });
+
+  // @ts-expect-error — prune must be a boolean.
+  gcpApply("dist/manifest.yaml", { prune: "true" });
+}
+void _typeChecksOnly;

package/src/op/builders.ts

@@ -0,0 +1,70 @@
+/**
+ * Typed step-builder wrappers for this lexicon's activities (chant #1288
+ * Stage 2). See `lexicons/k8s/src/op/builders.ts`'s module doc for why these
+ * live beside their `*Args` interfaces rather than in core or the temporal
+ * barrel. `opts`'s type in each wrapper below IS the activity's own `*Args`
+ * interface (via `Omit`/`WithStepRefs`) — never restated. `core`'s own
+ * `gcpApply`/`gcpDelete`/`flociGcpUp`/`flociGcpDown` are unchanged and
+ * produce byte-identical `ActivityStep` output; these are purely additive.
+ */
+
+import {
+  activity,
+  takeProfileAndId,
+  type ActivityStep,
+  type NamedActivityStep,
+  type WithStepRefs,
+} from "@intentius/chant/op";
+import type { GcpApplyArgs } from "./activities/gcp-apply";
+import type { FlociGcpUpArgs, FlociGcpDownArgs } from "./activities/floci-gcp";
+
+/** Extra opts every wrapper below accepts alongside its activity's own fields. */
+type StepOpts = { profile?: ActivityStep["profile"]; id?: string };
+
+/**
+ * Apply built GCP (CNRM) resources directly to their GCP REST APIs — the
+ * fully typed twin of core's `gcpApply`. `opts` is {@link GcpApplyArgs}
+ * itself, minus the positional `manifestPath`. Defaults to the `longInfra`
+ * profile.
+ */
+export const gcpApply = (
+  manifestPath: string,
+  opts?: WithStepRefs<Omit<GcpApplyArgs, "manifestPath">> & StepOpts,
+): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("gcpApply", { manifestPath, ...args }, { profile: profile ?? "longInfra", ...(id ? { id } : {}) });
+};
+
+/**
+ * Delete the GCP (CNRM) resources in a built manifest — the inverse of
+ * {@link gcpApply}, fully typed twin of core's `gcpDelete`. `opts` is
+ * {@link GcpApplyArgs} itself (the activity reuses it), minus the positional
+ * `manifestPath`. Defaults to the `longInfra` profile.
+ */
+export const gcpDelete = (
+  manifestPath: string,
+  opts?: WithStepRefs<Omit<GcpApplyArgs, "manifestPath">> & StepOpts,
+): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("gcpDelete", { manifestPath, ...args }, { profile: profile ?? "longInfra", ...(id ? { id } : {}) });
+};
+
+/**
+ * Boot a local floci-gcp (GCP emulator) — the fully typed twin of core's
+ * `flociGcpUp`. `opts` is {@link FlociGcpUpArgs} itself. Defaults to the
+ * `longInfra` profile.
+ */
+export const flociGcpUp = (opts?: WithStepRefs<FlociGcpUpArgs> & StepOpts): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("flociGcpUp", args, { profile: profile ?? "longInfra", ...(id ? { id } : {}) });
+};
+
+/**
+ * Stop and remove the local floci-gcp container — the fully typed twin of
+ * core's `flociGcpDown`. `opts` is {@link FlociGcpDownArgs} itself. Defaults
+ * to the `fastIdempotent` profile.
+ */
+export const flociGcpDown = (opts?: WithStepRefs<FlociGcpDownArgs> & StepOpts): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("flociGcpDown", args, { profile: profile ?? "fastIdempotent", ...(id ? { id } : {}) });
+};