@intentius/chant-lexicon-azure 0.15.2 → 0.16.0

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "9b6eec8e49d61507ee2c5451aac2dd7dd84d0a929c5955898a70caaace370115",
+    "manifest.json": "0b5a14f49bdda47a334f29c37668785c4b69b176155fa92504fa33ae3b7cc0ed",
     "meta.json": "4b9c0be734f8b4a5fbba3136e14aaa1ea73ff0ee93f2aa480db83e476ce727b5",
     "types/index.d.ts": "d62c0fd7947ddf04a9126cc8bf44a9f4437f21cf8647fc812c022398f2c00d57",
     "rules/hardcoded-location.ts": "a9b1d1cec93f2ca9c5206641f53fc9621cefcfd2c00b3ab89c194b30a75fa949",
@@ -33,5 +33,5 @@
     "skills/chant-azure-patterns.md": "1a3bacfac612826b77332d2692a59195638db9f1b5e8ea2eda7579621d25f603",
     "skills/chant-azure-aks.md": "2d4e0098c1a22b54ffadd410564d9df0f3a04cb4eb7c6261f20ae33106e7aca8"
   },
-  "composite": "4b88a0517fc5aa7720d15b6e8cce2ffac5986819d42ddd3e5832135157c4981b"
+  "composite": "a6d15485fe9337f12eff84c538506a05c1f88c75903b4e70050e29438c686044"
 }

package/dist/manifest.json

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

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

@@ -14,31 +14,16 @@ export interface FlociAzDownArgs {
     /** Container name to remove. Default: `chant-floci-az`. */
     name?: string;
 }
-/** `docker ps -q -f name=<name>` — non-empty stdout means the container is running. */
-export declare function flociAzExistsCommand(name: string): string;
-/** Build the `docker run` command that boots floci-az. */
-export declare function flociAzRunCommand(args: FlociAzUpArgs): string;
-/** Build the `docker rm -f` command. */
-export declare function flociAzRmCommand(name: string): string;
-/** The floci-az health endpoint URL for a host port. */
-export declare function flociAzHealthUrl(port: number): string;
+export declare const flociAzExistsCommand: (name: string) => string;
+export declare const flociAzRmCommand: (name: string) => string;
+export declare const flociAzHealthUrl: (port: number) => string;
 /** The ARM endpoint URL (what `azApply`'s `endpoint` should point at). */
-export declare function flociAzEndpoint(port: number): string;
-/**
- * Boot a local floci-az (Azure emulator) in Docker and return its ARM endpoint.
- *
- * Idempotent: reuses a running container of the same name. Waits for the health
- * endpoint to answer, then returns `{ endpoint }` for `azApply({ 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 flociAzUp(args: FlociAzUpArgs, signal?: AbortSignal): Promise<{
+export declare const flociAzEndpoint: (port: number) => string;
+export declare const flociAzRunCommand: (args?: FlociAzUpArgs) => string;
+/** Boot a local floci-az (Azure emulator) in Docker and return its ARM endpoint. */
+export declare const flociAzUp: (args?: FlociAzUpArgs, signal?: AbortSignal) => Promise<{
     endpoint: string;
 }>;
-/**
- * Stop and remove the local floci-az container. A no-op success when the
- * container is already gone. Uses fastIdempotent profile — 5m timeout.
- */
-export declare function flociAzDown(args: FlociAzDownArgs, signal?: AbortSignal): Promise<void>;
+/** Stop and remove the local floci-az container (no-op if already gone). */
+export declare const flociAzDown: (args?: FlociAzDownArgs, signal?: AbortSignal) => Promise<void>;
 //# sourceMappingURL=floci-az.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"floci-az.d.ts","sourceRoot":"","sources":["../../../src/op/activities/floci-az.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,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,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAK7D;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA4CxG;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5F"}
+{"version":3,"file":"floci-az.d.ts","sourceRoot":"","sources":["../../../src/op/activities/floci-az.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,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,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAWD,eAAO,MAAM,oBAAoB,0BAAmB,CAAC;AACrD,eAAO,MAAM,gBAAgB,0BAAe,CAAC;AAC7C,eAAO,MAAM,gBAAgB,0BAAe,CAAC;AAC7C,0EAA0E;AAC1E,eAAO,MAAM,eAAe,0BAAc,CAAC;AAC3C,eAAO,MAAM,iBAAiB,GAAI,OAAM,aAAkB,KAAG,MAA6B,CAAC;AAE3F,oFAAoF;AACpF,eAAO,MAAM,SAAS,GAAI,OAAM,aAAkB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAClF,CAAC;AAEtB,4EAA4E;AAC5E,eAAO,MAAM,WAAW,GAAI,OAAM,eAAoB,EAAE,SAAS,WAAW,KAAG,OAAO,CAAC,IAAI,CACpE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-azure",
-  "version": "0.15.2",
+  "version": "0.16.0",
   "description": "Azure lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -74,6 +74,6 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.15.2"
+    "@intentius/chant": "^0.16.0"
   }
 }

package/src/op/activities/floci-az.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-az";
-const DEFAULT_PORT = 4577;
-const DEFAULT_IMAGE = "floci/floci-az:latest";
+import { emulatorLifecycle } from "@intentius/chant/op";
 
 export interface FlociAzUpArgs {
   /** Container name. Default: `chant-floci-az`. */
@@ -26,98 +18,26 @@ export interface FlociAzDownArgs {
   name?: string;
 }
 
-/** `docker ps -q -f name=<name>` — non-empty stdout means the container is running. */
-export function flociAzExistsCommand(name: string): string {
-  return `docker ps -q -f name=${name}`;
-}
-
-/** Build the `docker run` command that boots floci-az. */
-export function flociAzRunCommand(args: FlociAzUpArgs): 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}:4577`, image].join(" ");
-}
-
-/** Build the `docker rm -f` command. */
-export function flociAzRmCommand(name: string): string {
-  return `docker rm -f ${name}`;
-}
-
-/** The floci-az health endpoint URL for a host port. */
-export function flociAzHealthUrl(port: number): string {
-  return `http://localhost:${port}/_floci/health`;
-}
+// floci-az is a bespoke ARM fake (not LocalStack) — a plain 200 on its health
+// endpoint means ready. Shared lifecycle: emulatorLifecycle (#746).
+const az = emulatorLifecycle({
+  name: "chant-floci-az",
+  image: "floci/floci-az:latest",
+  containerPort: 4577,
+  healthPath: "/_floci/health",
+});
 
+export const flociAzExistsCommand = az.existsCommand;
+export const flociAzRmCommand = az.rmCommand;
+export const flociAzHealthUrl = az.healthUrl;
 /** The ARM endpoint URL (what `azApply`'s `endpoint` should point at). */
-export function flociAzEndpoint(port: number): string {
-  return `http://localhost:${port}`;
-}
-
-/**
- * Boot a local floci-az (Azure emulator) in Docker and return its ARM endpoint.
- *
- * Idempotent: reuses a running container of the same name. Waits for the health
- * endpoint to answer, then returns `{ endpoint }` for `azApply({ 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 flociAzUp(args: FlociAzUpArgs, 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(flociAzExistsCommand(name), { signal });
-    running = Boolean(stdout.trim());
-  } catch {
-    // `docker ps` failed — assume not running and try to start it.
-  }
+export const flociAzEndpoint = az.endpoint;
+export const flociAzRunCommand = (args: FlociAzUpArgs = {}): string => az.runCommand(args);
 
-  if (running) {
-    console.log(`floci-az container "${name}" already running — reusing`);
-  } else {
-    await execAsync(flociAzRunCommand({ ...args, name, port }), { signal });
-  }
+/** Boot a local floci-az (Azure emulator) in Docker and return its ARM endpoint. */
+export const flociAzUp = (args: FlociAzUpArgs = {}, signal?: AbortSignal): Promise<{ endpoint: string }> =>
+  az.up(args, signal);
 
-  const url = flociAzHealthUrl(port);
-  const deadline = Date.now() + timeoutMs;
-  let ready = false;
-  while (Date.now() < deadline) {
-    if (signal?.aborted) throw new Error("flociAzUp aborted");
-    safeHeartbeat({ step: "flociAzUp", 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-az "${name}" did not become ready within ${timeoutMs}ms`);
-  }
-
-  const endpoint = flociAzEndpoint(port);
-  console.log(`floci-az ready on ${endpoint}`);
-  return { endpoint };
-}
-
-/**
- * Stop and remove the local floci-az container. A no-op success when the
- * container is already gone. Uses fastIdempotent profile — 5m timeout.
- */
-export async function flociAzDown(args: FlociAzDownArgs, signal?: AbortSignal): Promise<void> {
-  const name = args.name ?? DEFAULT_NAME;
-  try {
-    await execAsync(flociAzRmCommand(name), { signal });
-  } catch {
-    // Already removed (`--rm` on exit, or never started) — treat as success.
-  }
-}
+/** Stop and remove the local floci-az container (no-op if already gone). */
+export const flociAzDown = (args: FlociAzDownArgs = {}, signal?: AbortSignal): Promise<void> =>
+  az.down(args, signal);