@intentius/chant-lexicon-azure 0.46.0 → 0.50.0

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  *
  * Azure Resource Manager lexicon for chant.
  */
+export { azApply, azDelete, azGroupEnsure, azGroupDelete, flociAzUp, flociAzDown } from "./op/builders.js";
 export { defaultTags, type TagEntry, type DefaultTags } from "./default-tags.js";
 export { deploymentScope, isDeploymentScope, type DeploymentScope, type DeployScope } from "./deploy-scopes.js";
 export { azureSerializer } from "./serializer.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "fa47e648ba3dfe5076642c461707390387fbe003c0f68fe32fbd70b13867955a",
+    "manifest.json": "72f4b592231f377ccfa887c57e7a608d709ecd1ad20bd03f7b214d73510dbdd0",
     "meta.json": "8c7a1ea3cfaf39461d3e758fa2b0cbd70c7800fac736e56df8d14a3e07ef1840",
     "types/index.d.ts": "16cb7dc2f9b4f82dc974935442f294d0c88077c0f21d21a92690b19227174b59",
     "rules/hardcoded-location.ts": "a9b1d1cec93f2ca9c5206641f53fc9621cefcfd2c00b3ab89c194b30a75fa949",
@@ -37,5 +37,5 @@
     "skills/chant-azure-patterns.md": "1a3bacfac612826b77332d2692a59195638db9f1b5e8ea2eda7579621d25f603",
     "skills/chant-azure-aks.md": "2d4e0098c1a22b54ffadd410564d9df0f3a04cb4eb7c6261f20ae33106e7aca8"
   },
-  "composite": "8f9dff45c7b216d7d632331e7ed939ecd049ab36298c9056c2f22d55fc983f54"
+  "composite": "129991e9a84b5eb1c2b351ea7e3fb8c290d856c7f8a3ee53c10398f377f9fbc3"
 }

package/dist/manifest.json

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

package/dist/op/builders.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 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
+ * `azApply`/`azDelete`/`azGroupEnsure`/`azGroupDelete`/`flociAzUp`/
+ * `flociAzDown` 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 { AzApplyArgs } from "./activities/az-apply.js";
+import type { AzGroupEnsureArgs, AzGroupDeleteArgs } from "./activities/azure.js";
+import type { FlociAzUpArgs, FlociAzDownArgs } from "./activities/floci-az.js";
+/** Extra opts every wrapper below accepts alongside its activity's own fields. */
+type StepOpts = {
+    profile?: ActivityStep["profile"];
+    id?: string;
+};
+/**
+ * Ensure an Azure resource group exists before an ARM apply — the fully
+ * typed twin of core's `azGroupEnsure`. `opts` is {@link AzGroupEnsureArgs}
+ * itself, minus the positional `resourceGroup`. Defaults to the
+ * `fastIdempotent` profile.
+ */
+export declare const azGroupEnsure: (resourceGroup: string, opts?: WithStepRefs<Omit<AzGroupEnsureArgs, "resourceGroup">> & StepOpts) => NamedActivityStep;
+/**
+ * Delete an Azure resource group and its contents — the fully typed twin of
+ * core's `azGroupDelete`. `opts` is {@link AzGroupDeleteArgs} itself, minus
+ * the positional `resourceGroup`. Defaults to the `fastIdempotent` profile.
+ */
+export declare const azGroupDelete: (resourceGroup: string, opts?: WithStepRefs<Omit<AzGroupDeleteArgs, "resourceGroup">> & StepOpts) => NamedActivityStep;
+/**
+ * Apply a built ARM template directly to the ARM resource API — the fully
+ * typed twin of core's `azApply`. `opts` is {@link AzApplyArgs} itself,
+ * minus the positional `templatePath` (`resourceGroup` remains required).
+ * Defaults to the `longInfra` profile.
+ */
+export declare const azApply: (templatePath: string, opts: WithStepRefs<Omit<AzApplyArgs, "templatePath">> & StepOpts) => NamedActivityStep;
+/**
+ * Delete the Azure (ARM) resources in a built template — the inverse of
+ * {@link azApply}, fully typed twin of core's `azDelete`. `opts` is
+ * {@link AzApplyArgs} itself (the activity reuses it), minus the positional
+ * `templatePath`. Defaults to the `longInfra` profile.
+ */
+export declare const azDelete: (templatePath: string, opts: WithStepRefs<Omit<AzApplyArgs, "templatePath">> & StepOpts) => NamedActivityStep;
+/**
+ * Boot a local floci-az (Azure emulator) — the fully typed twin of core's
+ * `flociAzUp`. `opts` is {@link FlociAzUpArgs} itself. Defaults to the
+ * `longInfra` profile.
+ */
+export declare const flociAzUp: (opts?: WithStepRefs<FlociAzUpArgs> & StepOpts) => NamedActivityStep;
+/**
+ * Stop and remove the local floci-az container — the fully typed twin of
+ * core's `flociAzDown`. `opts` is {@link FlociAzDownArgs} itself. Defaults
+ * to the `fastIdempotent` profile.
+ */
+export declare const flociAzDown: (opts?: WithStepRefs<FlociAzDownArgs> & 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;;;;;;;;;GASG;AAEH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5E,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,aAAa,GACxB,eAAe,MAAM,EACrB,OAAO,YAAY,CAAC,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC,GAAG,QAAQ,KACvE,iBAGF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GACxB,eAAe,MAAM,EACrB,OAAO,YAAY,CAAC,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC,GAAG,QAAQ,KACvE,iBAGF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAClB,cAAc,MAAM,EACpB,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,GAAG,QAAQ,KAC/D,iBAGF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GACnB,cAAc,MAAM,EACpB,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,GAAG,QAAQ,KAC/D,iBAGF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,YAAY,CAAC,aAAa,CAAC,GAAG,QAAQ,KAAG,iBAGzE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,YAAY,CAAC,eAAe,CAAC,GAAG,QAAQ,KAAG,iBAG7E,CAAC"}

package/package.json

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

package/src/index.ts

@@ -4,6 +4,14 @@
  * Azure Resource Manager lexicon for chant.
  */
 
+// Typed Op step-builder wrappers (chant #1288 Stage 2) — azApply/azDelete/
+// azGroupEnsure/azGroupDelete/flociAzUp/flociAzDown 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 { azApply, azDelete, azGroupEnsure, azGroupDelete, flociAzUp, flociAzDown } from "./op/builders";
+
 // --- Core ---
 export { defaultTags, type TagEntry, type DefaultTags } from "./default-tags";
 export { deploymentScope, isDeploymentScope, type DeploymentScope, type DeployScope } from "./deploy-scopes";

package/src/op/builders.test.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 {
+  azApply as azApplyOld,
+  azDelete as azDeleteOld,
+  azGroupEnsure as azGroupEnsureOld,
+  azGroupDelete as azGroupDeleteOld,
+  flociAzUp as flociAzUpOld,
+  flociAzDown as flociAzDownOld,
+  stepOutput,
+  type StepOutputRef,
+} from "@intentius/chant/op";
+import { azApply, azDelete, azGroupEnsure, azGroupDelete, flociAzUp, flociAzDown } from "./builders";
+
+describe("azure typed step builders (#1288 Stage 2)", () => {
+  test("azGroupEnsure: identical ActivityStep to core's original", () => {
+    expect(azGroupEnsure("my-rg")).toEqual(azGroupEnsureOld("my-rg"));
+    expect(azGroupEnsure("my-rg", { location: "westus" })).toEqual(azGroupEnsureOld("my-rg", { location: "westus" }));
+  });
+
+  test("azGroupDelete: identical ActivityStep to core's original", () => {
+    expect(azGroupDelete("my-rg")).toEqual(azGroupDeleteOld("my-rg"));
+  });
+
+  test("azApply: identical ActivityStep to core's original", () => {
+    const opts = { resourceGroup: "my-rg" };
+    expect(azApply("dist/template.json", opts)).toEqual(azApplyOld("dist/template.json", opts));
+  });
+
+  test("azDelete: identical ActivityStep to core's original", () => {
+    const opts = { resourceGroup: "my-rg" };
+    expect(azDelete("dist/template.json", opts)).toEqual(azDeleteOld("dist/template.json", opts));
+  });
+
+  test("flociAzUp/flociAzDown: identical ActivityStep to core's original", () => {
+    expect(flociAzUp()).toEqual(flociAzUpOld());
+    expect(flociAzDown({ name: "custom" })).toEqual(flociAzDownOld({ name: "custom" }));
+  });
+
+  test("azApply: accepts a StepOutputRef in a typed slot", () => {
+    const ref = stepOutput("resolve-rg", "resourceGroup");
+    const step = azApply("dist/template.json", { resourceGroup: ref });
+    expect(step.args?.resourceGroup).toBe(ref);
+  });
+
+  test("azGroupEnsure: .out is reachable when an id is given", () => {
+    const step = azGroupEnsure("my-rg", { id: "ensure-rg" });
+    const ref: StepOutputRef = step.out.location;
+    expect(ref.step).toBe("ensure-rg");
+  });
+});
+
+// ── Compile-time-only: authoring-time type errors (never executed) ──────────
+function _typeChecksOnly(): void {
+  // @ts-expect-error — resourceGroup is required for azApply (the activity
+  // fails without it); omitting opts entirely is no longer a way around that.
+  azApply("dist/template.json");
+
+  // @ts-expect-error — "resourcegroup" (wrong case) is not a key of AzApplyArgs.
+  azApply("dist/template.json", { resourcegroup: "my-rg" });
+
+  // @ts-expect-error — prune must be a boolean.
+  azApply("dist/template.json", { resourceGroup: "my-rg", prune: "yes" });
+
+  // @ts-expect-error — location must be a string.
+  azGroupEnsure("my-rg", { location: 1 });
+}
+void _typeChecksOnly;

package/src/op/builders.ts

@@ -0,0 +1,99 @@
+/**
+ * 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
+ * `azApply`/`azDelete`/`azGroupEnsure`/`azGroupDelete`/`flociAzUp`/
+ * `flociAzDown` 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 { AzApplyArgs } from "./activities/az-apply";
+import type { AzGroupEnsureArgs, AzGroupDeleteArgs } from "./activities/azure";
+import type { FlociAzUpArgs, FlociAzDownArgs } from "./activities/floci-az";
+
+/** Extra opts every wrapper below accepts alongside its activity's own fields. */
+type StepOpts = { profile?: ActivityStep["profile"]; id?: string };
+
+/**
+ * Ensure an Azure resource group exists before an ARM apply — the fully
+ * typed twin of core's `azGroupEnsure`. `opts` is {@link AzGroupEnsureArgs}
+ * itself, minus the positional `resourceGroup`. Defaults to the
+ * `fastIdempotent` profile.
+ */
+export const azGroupEnsure = (
+  resourceGroup: string,
+  opts?: WithStepRefs<Omit<AzGroupEnsureArgs, "resourceGroup">> & StepOpts,
+): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("azGroupEnsure", { resourceGroup, ...args }, { profile: profile ?? "fastIdempotent", ...(id ? { id } : {}) });
+};
+
+/**
+ * Delete an Azure resource group and its contents — the fully typed twin of
+ * core's `azGroupDelete`. `opts` is {@link AzGroupDeleteArgs} itself, minus
+ * the positional `resourceGroup`. Defaults to the `fastIdempotent` profile.
+ */
+export const azGroupDelete = (
+  resourceGroup: string,
+  opts?: WithStepRefs<Omit<AzGroupDeleteArgs, "resourceGroup">> & StepOpts,
+): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("azGroupDelete", { resourceGroup, ...args }, { profile: profile ?? "fastIdempotent", ...(id ? { id } : {}) });
+};
+
+/**
+ * Apply a built ARM template directly to the ARM resource API — the fully
+ * typed twin of core's `azApply`. `opts` is {@link AzApplyArgs} itself,
+ * minus the positional `templatePath` (`resourceGroup` remains required).
+ * Defaults to the `longInfra` profile.
+ */
+export const azApply = (
+  templatePath: string,
+  opts: WithStepRefs<Omit<AzApplyArgs, "templatePath">> & StepOpts,
+): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("azApply", { templatePath, ...args }, { profile: profile ?? "longInfra", ...(id ? { id } : {}) });
+};
+
+/**
+ * Delete the Azure (ARM) resources in a built template — the inverse of
+ * {@link azApply}, fully typed twin of core's `azDelete`. `opts` is
+ * {@link AzApplyArgs} itself (the activity reuses it), minus the positional
+ * `templatePath`. Defaults to the `longInfra` profile.
+ */
+export const azDelete = (
+  templatePath: string,
+  opts: WithStepRefs<Omit<AzApplyArgs, "templatePath">> & StepOpts,
+): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("azDelete", { templatePath, ...args }, { profile: profile ?? "longInfra", ...(id ? { id } : {}) });
+};
+
+/**
+ * Boot a local floci-az (Azure emulator) — the fully typed twin of core's
+ * `flociAzUp`. `opts` is {@link FlociAzUpArgs} itself. Defaults to the
+ * `longInfra` profile.
+ */
+export const flociAzUp = (opts?: WithStepRefs<FlociAzUpArgs> & StepOpts): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("flociAzUp", args, { profile: profile ?? "longInfra", ...(id ? { id } : {}) });
+};
+
+/**
+ * Stop and remove the local floci-az container — the fully typed twin of
+ * core's `flociAzDown`. `opts` is {@link FlociAzDownArgs} itself. Defaults
+ * to the `fastIdempotent` profile.
+ */
+export const flociAzDown = (opts?: WithStepRefs<FlociAzDownArgs> & StepOpts): NamedActivityStep => {
+  const { args, profile, id } = takeProfileAndId(opts as Record<string, unknown> | undefined);
+  return activity("flociAzDown", args, { profile: profile ?? "fastIdempotent", ...(id ? { id } : {}) });
+};