@intentius/chant-lexicon-gcp 0.15.2 → 0.16.0

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "3c45f5e54db2e865c44d31a6aad4819415ec4eb48fdef24c5caeebd8d5dd9744",
+    "manifest.json": "99b71297b50bc2eacdee359a9a2074579841e019ec3da67510a7175f07e0179d",
     "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": "42fc10bc9384b76a76f820292b930953ad576e8417f95d969d0dfcf84dd4f204"
+  "composite": "414193cf3778e11c8cc72849add9573dcbd6059113835f26357ff256bed61b47"
 }

package/dist/manifest.json

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

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

@@ -14,31 +14,16 @@ 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;
+export declare const flociGcpExistsCommand: (name: string) => string;
+export declare const flociGcpRmCommand: (name: string) => string;
+export declare const 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<{
+export declare const flociGcpEndpoint: (port: number) => string;
+export declare const flociGcpRunCommand: (args?: FlociGcpUpArgs) => string;
+/** Boot a local floci-gcp (GCP emulator) in Docker and return its endpoint. */
+export declare const 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>;
+/** Stop and remove the local floci-gcp container (no-op if already gone). */
+export declare const flociGcpDown: (args?: FlociGcpDownArgs, signal?: AbortSignal) => Promise<void>;
 //# sourceMappingURL=floci-gcp.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"floci-gcp.d.ts","sourceRoot":"","sources":["../../../src/op/activities/floci-gcp.ts"],"names":[],"mappings":"AAEA,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;AAWD,eAAO,MAAM,qBAAqB,0BAAoB,CAAC;AACvD,eAAO,MAAM,iBAAiB,0BAAgB,CAAC;AAC/C,eAAO,MAAM,iBAAiB,0BAAgB,CAAC;AAC/C,2EAA2E;AAC3E,eAAO,MAAM,gBAAgB,0BAAe,CAAC;AAC7C,eAAO,MAAM,kBAAkB,GAAI,OAAM,cAAmB,KAAG,MAA8B,CAAC;AAE9F,+EAA+E;AAC/E,eAAO,MAAM,UAAU,GAAI,OAAM,cAAmB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CACnF,CAAC;AAEvB,6EAA6E;AAC7E,eAAO,MAAM,YAAY,GAAI,OAAM,gBAAqB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CACrE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-gcp",
-  "version": "0.15.2",
+  "version": "0.16.0",
   "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.2"
+    "@intentius/chant": "^0.16.0"
   }
 }

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

@@ -1,12 +1,4 @@
-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";
+import { emulatorLifecycle } from "@intentius/chant/op";
 
 export interface FlociGcpUpArgs {
   /** Container name. Default: `chant-floci-gcp`. */
@@ -26,98 +18,26 @@ export interface FlociGcpDownArgs {
   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`;
-}
+// floci-gcp is a bespoke GCP-REST fake (not LocalStack) — a plain 200 on its
+// health endpoint means ready. Shared lifecycle: emulatorLifecycle (#746).
+const gcp = emulatorLifecycle({
+  name: "chant-floci-gcp",
+  image: "floci/floci-gcp:latest",
+  containerPort: 4588,
+  healthPath: "/_floci-gcp/health",
+});
 
+export const flociGcpExistsCommand = gcp.existsCommand;
+export const flociGcpRmCommand = gcp.rmCommand;
+export const flociGcpHealthUrl = gcp.healthUrl;
 /** 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.
-  }
+export const flociGcpEndpoint = gcp.endpoint;
+export const flociGcpRunCommand = (args: FlociGcpUpArgs = {}): string => gcp.runCommand(args);
 
-  if (running) {
-    console.log(`floci-gcp container "${name}" already running — reusing`);
-  } else {
-    await execAsync(flociGcpRunCommand({ ...args, name, port }), { signal });
-  }
+/** Boot a local floci-gcp (GCP emulator) in Docker and return its endpoint. */
+export const flociGcpUp = (args: FlociGcpUpArgs = {}, signal?: AbortSignal): Promise<{ endpoint: string }> =>
+  gcp.up(args, 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.
-  }
-}
+/** Stop and remove the local floci-gcp container (no-op if already gone). */
+export const flociGcpDown = (args: FlociGcpDownArgs = {}, signal?: AbortSignal): Promise<void> =>
+  gcp.down(args, signal);