@intentius/chant-lexicon-azure 0.15.1 → 0.15.3

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "c71f8c6d91577879032b9b5f2c0947e2671a9b3de1b482e835765e4d50cfd61a",
+    "manifest.json": "ced8d5e5edae01dc34ff156822445fbbbf17a261ae78abbc35933c7928fd158e",
     "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": "80f4f69fdccb61156444408efef97a404f529b3346e6ec8287a9a5f80320b713"
+  "composite": "c80fc2a2f5a20f60437c862601204ad4d5ce4029b9f067653a8be31faf13023a"
 }

package/dist/manifest.json

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

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

@@ -0,0 +1,44 @@
+export interface FlociAzUpArgs {
+    /** Container name. Default: `chant-floci-az`. */
+    name?: string;
+    /** Host port mapped to the emulator's `:4577`. Default: `4577`. */
+    port?: number;
+    /** Image. Default: `floci/floci-az:latest`. */
+    image?: string;
+    /** Readiness timeout in ms. Default: `60000`. */
+    timeoutMs?: number;
+    /** Health poll interval in ms. Default: `2000`. */
+    intervalMs?: number;
+}
+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;
+/** 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<{
+    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>;
+//# sourceMappingURL=floci-az.d.ts.map

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

@@ -0,0 +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"}

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

@@ -5,6 +5,8 @@
  */
 export { azGroupEnsure, azGroupDelete, azGroupEnsureCommand, azGroupDeleteCommand } from "./azure.js";
 export type { AzGroupEnsureArgs, AzGroupDeleteArgs } from "./azure.js";
+export { flociAzUp, flociAzDown, flociAzRunCommand, flociAzRmCommand, flociAzExistsCommand, flociAzHealthUrl, flociAzEndpoint, } from "./floci-az.js";
+export type { FlociAzUpArgs, FlociAzDownArgs } from "./floci-az.js";
 export { azApply, azDelete, pruneArmOrphans, deleteArmResource, listGroupResources, chantOwnershipTags, isChantOwned, evalArm, evalArmString, armResourceUrl, armResourceBody, armDependencies, orderArmResources, } from "./az-apply.js";
 export type { AzApplyArgs, ArmEvalCtx, ArmResource, ArmListItem, AzHttp } from "./az-apply.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;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACnG,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpE,OAAO,EACL,OAAO,EACP,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,OAAO,EACP,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/activities/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACnG,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIpE,OAAO,EACL,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EACL,OAAO,EACP,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,OAAO,EACP,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-azure",
-  "version": "0.15.1",
+  "version": "0.15.3",
   "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.1"
+    "@intentius/chant": "^0.15.3"
   }
 }

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

@@ -0,0 +1,29 @@
+import { describe, test, expect } from "vitest";
+import {
+  flociAzRunCommand,
+  flociAzRmCommand,
+  flociAzExistsCommand,
+  flociAzHealthUrl,
+  flociAzEndpoint,
+} from "./floci-az";
+
+describe("floci-az lifecycle commands (typed emulator, not shell)", () => {
+  test("run command uses defaults and maps the port", () => {
+    expect(flociAzRunCommand({})).toBe(
+      "docker run -d --rm --name chant-floci-az -p 4577:4577 floci/floci-az:latest",
+    );
+  });
+
+  test("run command honors name/port/image overrides", () => {
+    expect(flociAzRunCommand({ name: "az2", port: 4599, image: "floci/floci-az:0.8.0" })).toBe(
+      "docker run -d --rm --name az2 -p 4599:4577 floci/floci-az:0.8.0",
+    );
+  });
+
+  test("rm / exists / health / endpoint", () => {
+    expect(flociAzRmCommand("az2")).toBe("docker rm -f az2");
+    expect(flociAzExistsCommand("az2")).toBe("docker ps -q -f name=az2");
+    expect(flociAzHealthUrl(4577)).toBe("http://localhost:4577/_floci/health");
+    expect(flociAzEndpoint(4577)).toBe("http://localhost:4577");
+  });
+});

package/src/op/activities/floci-az.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-az";
+const DEFAULT_PORT = 4577;
+const DEFAULT_IMAGE = "floci/floci-az:latest";
+
+export interface FlociAzUpArgs {
+  /** Container name. Default: `chant-floci-az`. */
+  name?: string;
+  /** Host port mapped to the emulator's `:4577`. Default: `4577`. */
+  port?: number;
+  /** Image. Default: `floci/floci-az:latest`. */
+  image?: string;
+  /** Readiness timeout in ms. Default: `60000`. */
+  timeoutMs?: number;
+  /** Health poll interval in ms. Default: `2000`. */
+  intervalMs?: number;
+}
+
+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 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`;
+}
+
+/** 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.
+  }
+
+  if (running) {
+    console.log(`floci-az container "${name}" already running — reusing`);
+  } else {
+    await execAsync(flociAzRunCommand({ ...args, name, port }), { 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.
+  }
+}

package/src/op/activities/index.ts

@@ -6,6 +6,19 @@
 export { azGroupEnsure, azGroupDelete, azGroupEnsureCommand, azGroupDeleteCommand } from "./azure";
 export type { AzGroupEnsureArgs, AzGroupDeleteArgs } from "./azure";
 
+// floci-az (Azure emulator) lifecycle — the typed twin of aws's flociUp/Down, so
+// the trio's Azure op boots/tears down the emulator as a modeled step, not a shell.
+export {
+  flociAzUp,
+  flociAzDown,
+  flociAzRunCommand,
+  flociAzRmCommand,
+  flociAzExistsCommand,
+  flociAzHealthUrl,
+  flociAzEndpoint,
+} from "./floci-az";
+export type { FlociAzUpArgs, FlociAzDownArgs } from "./floci-az";
+
 export {
   azApply,
   azDelete,