@intentius/chant-lexicon-gcp 0.15.0 → 0.15.2

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "83a16761b52ff3f8ad88e37eccca05dfc72a28e6e290d7aa0bba0e2d53911ca9",
+    "manifest.json": "3c45f5e54db2e865c44d31a6aad4819415ec4eb48fdef24c5caeebd8d5dd9744",
     "meta.json": "475f10909854d059a2e2d4fb541c058803422e38b9c64bd4d6858c0623eedb8c",
     "types/index.d.ts": "5433b54c04b57d6fda8f3d81ef92ed0aca87f7e8e5dd3ea92d8de6e62a3ccfab",
     "rules/hardcoded-project.ts": "228631d3159e1ffcce2359c66073d4ae59bb0285f378e46e446f416aec50481c",
@@ -37,5 +37,5 @@
     "skills/chant-gcp-patterns.md": "a7ef31c1eb2f7244d3f73952c300472ef94c1eb09bd7a1003281b89299b6b704",
     "skills/chant-gcp-gke.md": "be277019da9a722c851e47cd2dfb9c9536668948c3535fb20db7697e934c4e2b"
   },
-  "composite": "1debcc99b19499e7ec9f42ec39eeafe752a818018119869dc2cef6e31419bd34"
+  "composite": "42fc10bc9384b76a76f820292b930953ad576e8417f95d969d0dfcf84dd4f204"
 }

package/dist/manifest.json

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

package/dist/op/activities/floci-gcp.d.ts

@@ -0,0 +1,44 @@
+export interface FlociGcpUpArgs {
+    /** Container name. Default: `chant-floci-gcp`. */
+    name?: string;
+    /** Host port mapped to the emulator's `:4588`. Default: `4588`. */
+    port?: number;
+    /** Image. Default: `floci/floci-gcp:latest`. */
+    image?: string;
+    /** Readiness timeout in ms. Default: `60000`. */
+    timeoutMs?: number;
+    /** Health poll interval in ms. Default: `2000`. */
+    intervalMs?: number;
+}
+export interface FlociGcpDownArgs {
+    /** Container name to remove. Default: `chant-floci-gcp`. */
+    name?: string;
+}
+/** `docker ps -q -f name=<name>` — non-empty stdout means the container is running. */
+export declare function flociGcpExistsCommand(name: string): string;
+/** Build the `docker run` command that boots floci-gcp. */
+export declare function flociGcpRunCommand(args: FlociGcpUpArgs): string;
+/** Build the `docker rm -f` command. */
+export declare function flociGcpRmCommand(name: string): string;
+/** The floci-gcp health endpoint URL for a host port. */
+export declare function flociGcpHealthUrl(port: number): string;
+/** The GCP endpoint URL (what `gcpApply`'s `endpoint` should point at). */
+export declare function flociGcpEndpoint(port: number): string;
+/**
+ * Boot a local floci-gcp (GCP emulator) in Docker and return its endpoint.
+ *
+ * Idempotent: reuses a running container of the same name. Waits for the health
+ * endpoint to answer, then returns `{ endpoint }` for `gcpApply({ endpoint })`.
+ * The typed twin of the AWS `flociUp` — replaces a raw `docker run` shell step so
+ * the emulator lifecycle is modeled, not scripted. Uses longInfra profile — 20m
+ * timeout, heartbeat every poll (the image may pull).
+ */
+export declare function flociGcpUp(args: FlociGcpUpArgs, signal?: AbortSignal): Promise<{
+    endpoint: string;
+}>;
+/**
+ * Stop and remove the local floci-gcp container. A no-op success when the
+ * container is already gone. Uses fastIdempotent profile — 5m timeout.
+ */
+export declare function flociGcpDown(args: FlociGcpDownArgs, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=floci-gcp.d.ts.map

package/dist/op/activities/floci-gcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floci-gcp.d.ts","sourceRoot":"","sources":["../../../src/op/activities/floci-gcp.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAK/D;AAED,wCAAwC;AACxC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA4C1G;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9F"}

package/dist/op/activities/index.d.ts

@@ -6,4 +6,6 @@
  */
 export { gcpApply, gcpDelete, applyResource, deleteResource, waitForOperation, longRunningOperation, bucketInsertBody, pubSubTopicBody, pubSubSubscriptionBody, cloudRunServiceBody, secretBody, serviceAccountBody, storageBucketMapper, pubSubTopicMapper, pubSubSubscriptionMapper, cloudRunServiceMapper, secretManagerSecretMapper, gcpServiceAccountMapper, MAPPERS, referencedNames, orderByReferences, pruneOrphans, chantOwnershipLabels, isChantOwned, resolveGcpProject, parseManifest, } from "./gcp-apply.js";
 export type { GcpApplyArgs, GcpResource, CnrmStorageBucket, BucketInsertBody, PubSubTopicBody, ResourceMapper, OperationSpec, ListSpec, ApplyPlan, GcpHttp, } from "./gcp-apply.js";
+export { flociGcpUp, flociGcpDown, flociGcpRunCommand, flociGcpRmCommand, flociGcpExistsCommand, flociGcpHealthUrl, flociGcpEndpoint, } from "./floci-gcp.js";
+export type { FlociGcpUpArgs, FlociGcpDownArgs } from "./floci-gcp.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/op/activities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/activities/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/activities/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,OAAO,EACP,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,aAAa,CAAC;AAIrB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/package.json

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

package/src/op/activities/floci-gcp.test.ts

@@ -0,0 +1,29 @@
+import { describe, test, expect } from "vitest";
+import {
+  flociGcpRunCommand,
+  flociGcpRmCommand,
+  flociGcpExistsCommand,
+  flociGcpHealthUrl,
+  flociGcpEndpoint,
+} from "./floci-gcp";
+
+describe("floci-gcp lifecycle commands (typed emulator, not shell)", () => {
+  test("run command uses defaults and maps the port", () => {
+    expect(flociGcpRunCommand({})).toBe(
+      "docker run -d --rm --name chant-floci-gcp -p 4588:4588 floci/floci-gcp:latest",
+    );
+  });
+
+  test("run command honors name/port/image overrides", () => {
+    expect(flociGcpRunCommand({ name: "gcp2", port: 4599, image: "floci/floci-gcp:0.4.0" })).toBe(
+      "docker run -d --rm --name gcp2 -p 4599:4588 floci/floci-gcp:0.4.0",
+    );
+  });
+
+  test("rm / exists / health / endpoint", () => {
+    expect(flociGcpRmCommand("gcp2")).toBe("docker rm -f gcp2");
+    expect(flociGcpExistsCommand("gcp2")).toBe("docker ps -q -f name=gcp2");
+    expect(flociGcpHealthUrl(4588)).toBe("http://localhost:4588/_floci-gcp/health");
+    expect(flociGcpEndpoint(4588)).toBe("http://localhost:4588");
+  });
+});

package/src/op/activities/floci-gcp.ts

@@ -0,0 +1,123 @@
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { safeHeartbeat, sleep } from "@intentius/chant/op";
+
+const execAsync = promisify(exec);
+
+const DEFAULT_NAME = "chant-floci-gcp";
+const DEFAULT_PORT = 4588;
+const DEFAULT_IMAGE = "floci/floci-gcp:latest";
+
+export interface FlociGcpUpArgs {
+  /** Container name. Default: `chant-floci-gcp`. */
+  name?: string;
+  /** Host port mapped to the emulator's `:4588`. Default: `4588`. */
+  port?: number;
+  /** Image. Default: `floci/floci-gcp:latest`. */
+  image?: string;
+  /** Readiness timeout in ms. Default: `60000`. */
+  timeoutMs?: number;
+  /** Health poll interval in ms. Default: `2000`. */
+  intervalMs?: number;
+}
+
+export interface FlociGcpDownArgs {
+  /** Container name to remove. Default: `chant-floci-gcp`. */
+  name?: string;
+}
+
+/** `docker ps -q -f name=<name>` — non-empty stdout means the container is running. */
+export function flociGcpExistsCommand(name: string): string {
+  return `docker ps -q -f name=${name}`;
+}
+
+/** Build the `docker run` command that boots floci-gcp. */
+export function flociGcpRunCommand(args: FlociGcpUpArgs): string {
+  const name = args.name ?? DEFAULT_NAME;
+  const port = args.port ?? DEFAULT_PORT;
+  const image = args.image ?? DEFAULT_IMAGE;
+  return ["docker", "run", "-d", "--rm", "--name", name, "-p", `${port}:4588`, image].join(" ");
+}
+
+/** Build the `docker rm -f` command. */
+export function flociGcpRmCommand(name: string): string {
+  return `docker rm -f ${name}`;
+}
+
+/** The floci-gcp health endpoint URL for a host port. */
+export function flociGcpHealthUrl(port: number): string {
+  return `http://localhost:${port}/_floci-gcp/health`;
+}
+
+/** The GCP endpoint URL (what `gcpApply`'s `endpoint` should point at). */
+export function flociGcpEndpoint(port: number): string {
+  return `http://localhost:${port}`;
+}
+
+/**
+ * Boot a local floci-gcp (GCP emulator) in Docker and return its endpoint.
+ *
+ * Idempotent: reuses a running container of the same name. Waits for the health
+ * endpoint to answer, then returns `{ endpoint }` for `gcpApply({ endpoint })`.
+ * The typed twin of the AWS `flociUp` — replaces a raw `docker run` shell step so
+ * the emulator lifecycle is modeled, not scripted. Uses longInfra profile — 20m
+ * timeout, heartbeat every poll (the image may pull).
+ */
+export async function flociGcpUp(args: FlociGcpUpArgs, signal?: AbortSignal): Promise<{ endpoint: string }> {
+  const name = args.name ?? DEFAULT_NAME;
+  const port = args.port ?? DEFAULT_PORT;
+  const timeoutMs = args.timeoutMs ?? 60_000;
+  const intervalMs = args.intervalMs ?? 2_000;
+
+  let running = false;
+  try {
+    const { stdout } = await execAsync(flociGcpExistsCommand(name), { signal });
+    running = Boolean(stdout.trim());
+  } catch {
+    // `docker ps` failed — assume not running and try to start it.
+  }
+
+  if (running) {
+    console.log(`floci-gcp container "${name}" already running — reusing`);
+  } else {
+    await execAsync(flociGcpRunCommand({ ...args, name, port }), { signal });
+  }
+
+  const url = flociGcpHealthUrl(port);
+  const deadline = Date.now() + timeoutMs;
+  let ready = false;
+  while (Date.now() < deadline) {
+    if (signal?.aborted) throw new Error("flociGcpUp aborted");
+    safeHeartbeat({ step: "flociGcpUp", container: name });
+    try {
+      const res = await fetch(url, { signal });
+      if (res.ok) {
+        ready = true;
+        break;
+      }
+    } catch {
+      // Not up yet (connection refused / non-2xx) — retry.
+    }
+    await sleep(intervalMs, signal);
+  }
+  if (!ready) {
+    throw new Error(`floci-gcp "${name}" did not become ready within ${timeoutMs}ms`);
+  }
+
+  const endpoint = flociGcpEndpoint(port);
+  console.log(`floci-gcp ready on ${endpoint}`);
+  return { endpoint };
+}
+
+/**
+ * Stop and remove the local floci-gcp container. A no-op success when the
+ * container is already gone. Uses fastIdempotent profile — 5m timeout.
+ */
+export async function flociGcpDown(args: FlociGcpDownArgs, signal?: AbortSignal): Promise<void> {
+  const name = args.name ?? DEFAULT_NAME;
+  try {
+    await execAsync(flociGcpRmCommand(name), { signal });
+  } catch {
+    // Already removed (`--rm` on exit, or never started) — treat as success.
+  }
+}

package/src/op/activities/index.ts

@@ -44,3 +44,16 @@ export type {
   ApplyPlan,
   GcpHttp,
 } from "./gcp-apply";
+
+// floci-gcp (GCP emulator) lifecycle — the typed twin of aws's flociUp/Down, so
+// the trio's GCP op boots/tears down the emulator as a modeled step, not a shell.
+export {
+  flociGcpUp,
+  flociGcpDown,
+  flociGcpRunCommand,
+  flociGcpRmCommand,
+  flociGcpExistsCommand,
+  flociGcpHealthUrl,
+  flociGcpEndpoint,
+} from "./floci-gcp";
+export type { FlociGcpUpArgs, FlociGcpDownArgs } from "./floci-gcp";