@xplane/utils 0.0.0

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/cli.mjs

@@ -0,0 +1,394 @@
+#!/usr/bin/env node
+import { a as awaitReady, n as listXrCollection, o as loadKubeConfig, r as parseTarget, t as createXrWatcher } from "./xr-watcher-1etyvp-6.mjs";
+import { t as runRenderer } from "./render-Cnhpyf1X.mjs";
+import { createRequire } from "node:module";
+import { ApiextensionsV1Api } from "@kubernetes/client-node";
+import { defineCommand, runMain } from "citty";
+//#region src/cli/discovery.ts
+let crdCache;
+/**
+* Fetch the cluster's CRDs and project them into a flat list of resolved
+* resources (one entry per served version). Cached per `KubeConfig` instance.
+*/
+async function listCrdResources(kc) {
+	crdCache ??= /* @__PURE__ */ new WeakMap();
+	const cached = crdCache.get(kc);
+	if (cached) return cached;
+	const promise = fetchCrdResources(kc).catch((err) => {
+		crdCache?.delete(kc);
+		throw err;
+	});
+	crdCache.set(kc, promise);
+	return promise;
+}
+async function fetchCrdResources(kc) {
+	const list = await kc.makeApiClient(ApiextensionsV1Api).listCustomResourceDefinition();
+	const out = [];
+	for (const item of list.items ?? []) {
+		const spec = item.spec;
+		if (!spec?.group || !spec.names?.kind || !spec.names.plural) continue;
+		const namespaced = spec.scope === "Namespaced";
+		for (const v of spec.versions ?? []) {
+			if (!v.name || v.served === false) continue;
+			out.push({
+				group: spec.group,
+				version: v.name,
+				kind: spec.names.kind,
+				plural: spec.names.plural,
+				namespaced
+			});
+		}
+	}
+	return out;
+}
+/**
+* Resolve a `<resource>[.group][.version]` user hint to a single CRD-backed
+* resource. Throws when nothing matches or when the hint is ambiguous.
+*/
+async function resolveResource(kc, hint) {
+	const all = await listCrdResources(kc);
+	const r = hint.resource.toLowerCase();
+	const matches = all.filter((c) => {
+		const kindLc = c.kind.toLowerCase();
+		const pluralLc = c.plural.toLowerCase();
+		if (kindLc !== r && pluralLc !== r) return false;
+		if (hint.group !== void 0 && c.group !== hint.group) return false;
+		if (hint.version !== void 0 && c.version !== hint.version) return false;
+		return true;
+	});
+	if (matches.length === 0) {
+		const detail = [
+			hint.resource,
+			hint.group,
+			hint.version
+		].filter(Boolean).join(".");
+		throw new Error(`No CRD found matching "${detail}". Available kinds: ${summarise(all)}.`);
+	}
+	if (matches.length > 1) {
+		if (hint.version === void 0) {
+			const grouped = /* @__PURE__ */ new Map();
+			for (const m of matches) grouped.set(`${m.group}/${m.kind}`, [...grouped.get(`${m.group}/${m.kind}`) ?? [], m]);
+			if (grouped.size === 1) return [...matches].sort((a, b) => b.version.localeCompare(a.version))[0];
+		}
+		const candidates = matches.map((m) => `${m.plural}.${m.version}.${m.group}`).join(", ");
+		throw new Error(`Ambiguous resource hint "${hint.resource}". Candidates: ${candidates}. Disambiguate with .group or .version.group.`);
+	}
+	return matches[0];
+}
+function summarise(all) {
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	for (const r of all) {
+		const k = `${r.plural}.${r.group}`;
+		if (seen.has(k)) continue;
+		seen.add(k);
+		out.push(k);
+		if (out.length >= 20) {
+			out.push("…");
+			break;
+		}
+	}
+	return out.join(", ");
+}
+//#endregion
+//#region src/cli/get-status.ts
+/**
+* Headless implementation of the `xplane-utils get-status` subcommand.
+* Fetches a single XR and prints its `.status` to `out` in the requested format.
+*/
+async function runGetStatusCommand(args, deps = {}) {
+	const load = deps.loadKubeConfig ?? loadKubeConfig;
+	const resolve = deps.resolveResource ?? resolveResource;
+	const list = deps.listXrCollection ?? listXrCollection;
+	const out = deps.out ?? process.stdout;
+	const kcOpts = {};
+	if (args.kubeconfig !== void 0) kcOpts.kubeconfig = args.kubeconfig;
+	if (args.context !== void 0) kcOpts.context = args.context;
+	const kc = load(kcOpts);
+	const parsed = parseTarget(args.target);
+	const resolved = await resolve(kc, {
+		resource: parsed.resource,
+		...parsed.group !== void 0 ? { group: parsed.group } : {},
+		...parsed.version !== void 0 ? { version: parsed.version } : {}
+	});
+	const ref = {
+		group: resolved.group,
+		version: resolved.version,
+		plural: resolved.plural,
+		kind: resolved.kind,
+		namespaced: resolved.namespaced,
+		name: parsed.name,
+		...args.namespace !== void 0 ? { namespace: args.namespace } : {}
+	};
+	if (ref.namespaced && !ref.namespace) return {
+		code: 1,
+		error: `${ref.kind} is namespaced — pass --namespace/-n`
+	};
+	const item = (await list(kc, ref)).items[0];
+	if (!item) return {
+		code: 1,
+		error: `${`${ref.kind}/${ref.name}${ref.namespace ? ` -n ${ref.namespace}` : ""}`} not found`
+	};
+	const status = item.status ?? {};
+	const excluded = /* @__PURE__ */ new Set();
+	if (!args.includeXplane) excluded.add("xplane");
+	if (!args.includeConditions) excluded.add("conditions");
+	const filtered = excluded.size === 0 ? status : Object.fromEntries(Object.entries(status).filter(([k]) => !excluded.has(k)));
+	const text = (args.format ?? "dot") === "json" ? JSON.stringify(filtered, null, args.pretty === false ? 0 : 2) : toDotLines(filtered).join("\n");
+	out.write(text.length > 0 ? `${text}\n` : "");
+	return { code: 0 };
+}
+/**
+* Flatten an arbitrary JSON value into `path=value` lines. Object keys are
+* joined with `.`; array indices use `[n]`. Leaf values are JSON-encoded so
+* strings retain their quoting and special characters are preserved.
+*/
+function toDotLines(value, prefix = "") {
+	if (value === void 0) return [];
+	if (value === null) return [`${prefix || "."}=null`];
+	if (Array.isArray(value)) {
+		if (value.length === 0) return [`${prefix || "."}=[]`];
+		return value.flatMap((v, i) => toDotLines(v, `${prefix}[${i}]`));
+	}
+	if (typeof value === "object") {
+		const entries = Object.entries(value);
+		if (entries.length === 0) return [`${prefix || "."}={}`];
+		return entries.flatMap(([k, v]) => toDotLines(v, prefix ? `${prefix}.${k}` : k));
+	}
+	return [`${prefix || "."}=${JSON.stringify(value)}`];
+}
+//#endregion
+//#region src/cli/duration.ts
+/** Parse a duration like `30s`, `5m`, `2h`, `100ms`, or a bare integer (milliseconds). */
+function parseDuration(input) {
+	if (input === void 0 || input === "") return void 0;
+	const m = /^(\d+)(ms|s|m|h)?$/.exec(input);
+	if (!m) throw new Error(`Invalid duration "${input}". Use e.g. "30s", "5m", "1h", or a number of ms.`);
+	const n = Number(m[1]);
+	switch (m[2]) {
+		case void 0:
+		case "ms": return n;
+		case "s": return n * 1e3;
+		case "m": return n * 6e4;
+		case "h": return n * 36e5;
+	}
+}
+//#endregion
+//#region src/cli/watch.ts
+/**
+* Headless implementation of the `xplane-utils watch` subcommand.
+* Returns the exit code instead of calling `process.exit` so it is unit-testable.
+*/
+async function runWatchCommand(args, deps = {}) {
+	const load = deps.loadKubeConfig ?? loadKubeConfig;
+	const resolve = deps.resolveResource ?? resolveResource;
+	const factory = deps.createXrWatcher ?? createXrWatcher;
+	const render = deps.runRenderer ?? runRenderer;
+	const wait = deps.awaitReady ?? awaitReady;
+	const kcOpts = {};
+	if (args.kubeconfig !== void 0) kcOpts.kubeconfig = args.kubeconfig;
+	if (args.context !== void 0) kcOpts.context = args.context;
+	const kc = load(kcOpts);
+	const parsed = parseTarget(args.target);
+	const resolved = await resolve(kc, {
+		resource: parsed.resource,
+		...parsed.group !== void 0 ? { group: parsed.group } : {},
+		...parsed.version !== void 0 ? { version: parsed.version } : {}
+	});
+	const ref = {
+		group: resolved.group,
+		version: resolved.version,
+		plural: resolved.plural,
+		kind: resolved.kind,
+		namespaced: resolved.namespaced,
+		name: parsed.name,
+		...args.namespace !== void 0 ? { namespace: args.namespace } : {}
+	};
+	if (ref.namespaced && !ref.namespace) return {
+		code: 1,
+		error: `${ref.kind} is namespaced — pass --namespace/-n`
+	};
+	const watcher = factory({
+		kubeConfig: kc,
+		ref,
+		...deps.signal !== void 0 ? { signal: deps.signal } : {},
+		...args.disableEvents ? { disableEvents: true } : {}
+	});
+	const mode = args.mode === "tty" || args.mode === "ci" ? args.mode : void 0;
+	const renderOpts = { ref };
+	if (mode) renderOpts.mode = mode;
+	if (deps.out) renderOpts.out = deps.out;
+	const heartbeatMs = parseDuration(args.heartbeat);
+	if (heartbeatMs !== void 0) renderOpts.heartbeatMs = heartbeatMs;
+	if (args.showEvents !== void 0) renderOpts.showEvents = args.showEvents;
+	if (args.snapshotEveryHeartbeats !== void 0) renderOpts.snapshotEveryHeartbeats = args.snapshotEveryHeartbeats;
+	const renderPromise = render(watcher, renderOpts);
+	const timeoutMs = parseDuration(args.timeout);
+	try {
+		await wait(watcher, timeoutMs !== void 0 ? { timeoutMs } : {});
+		watcher.stop();
+		await renderPromise;
+		return { code: 0 };
+	} catch (_err) {
+		watcher.stop();
+		await renderPromise.catch(() => void 0);
+		return { code: 1 };
+	}
+}
+//#endregion
+//#region src/cli.ts
+const { version } = createRequire(import.meta.url)("../package.json");
+const watch = defineCommand({
+	meta: {
+		name: "watch",
+		description: "Subscribe to a Crossplane XR and block until it becomes Ready"
+	},
+	args: {
+		target: {
+			type: "positional",
+			required: true,
+			description: "kubectl-style target: <resource[.group][.version]>/<name>"
+		},
+		namespace: {
+			type: "string",
+			alias: "n",
+			description: "Namespace (required for namespaced XRs)"
+		},
+		kubeconfig: {
+			type: "string",
+			description: "Path to kubeconfig"
+		},
+		context: {
+			type: "string",
+			description: "Override the active kubeconfig context"
+		},
+		timeout: {
+			type: "string",
+			description: "Maximum time to wait for Ready, e.g. \"30s\", \"5m\", \"1h\""
+		},
+		mode: {
+			type: "string",
+			description: "Force renderer mode: \"tty\" or \"ci\" (default: auto)"
+		},
+		"no-events": {
+			type: "boolean",
+			description: "Disable subscribing to Kubernetes Events for the XR"
+		},
+		heartbeat: {
+			type: "string",
+			description: "CI mode: heartbeat interval for liveness lines (default \"30s\", \"0\" to disable)"
+		},
+		"show-events": {
+			type: "boolean",
+			description: "CI mode: include Kubernetes Events inline (off by default)"
+		},
+		"snapshot-every": {
+			type: "string",
+			description: "CI mode: every N idle heartbeats, expand the liveness line into a snapshot of unready + blocked resources (default 10, 0 to disable)"
+		}
+	},
+	async run({ args }) {
+		const controller = new AbortController();
+		process.on("SIGINT", () => controller.abort());
+		process.on("SIGTERM", () => controller.abort());
+		const cmdArgs = { target: String(args.target) };
+		if (typeof args.namespace === "string") cmdArgs.namespace = args.namespace;
+		if (typeof args.kubeconfig === "string") cmdArgs.kubeconfig = args.kubeconfig;
+		if (typeof args.context === "string") cmdArgs.context = args.context;
+		if (typeof args.timeout === "string") cmdArgs.timeout = args.timeout;
+		if (typeof args.mode === "string") cmdArgs.mode = args.mode;
+		if (args["no-events"]) cmdArgs.disableEvents = true;
+		if (typeof args.heartbeat === "string") cmdArgs.heartbeat = args.heartbeat;
+		if (args["show-events"]) cmdArgs.showEvents = true;
+		if (typeof args["snapshot-every"] === "string") {
+			const n = Number.parseInt(args["snapshot-every"], 10);
+			if (Number.isFinite(n) && n >= 0) cmdArgs.snapshotEveryHeartbeats = n;
+		}
+		const result = await runWatchCommand(cmdArgs, { signal: controller.signal });
+		if (result.code !== 0) {
+			if (result.error) process.stderr.write(`${result.error}\n`);
+			process.exit(result.code);
+		}
+		process.exit(0);
+	}
+});
+const getStatus = defineCommand({
+	meta: {
+		name: "get-status",
+		description: "Fetch a Crossplane XR and print its .status"
+	},
+	args: {
+		target: {
+			type: "positional",
+			required: true,
+			description: "kubectl-style target: <resource[.group][.version]>/<name>"
+		},
+		namespace: {
+			type: "string",
+			alias: "n",
+			description: "Namespace (required for namespaced XRs)"
+		},
+		kubeconfig: {
+			type: "string",
+			description: "Path to kubeconfig"
+		},
+		context: {
+			type: "string",
+			description: "Override the active kubeconfig context"
+		},
+		format: {
+			type: "string",
+			alias: "o",
+			description: "Output format: \"dot\" (default) or \"json\""
+		},
+		compact: {
+			type: "boolean",
+			description: "JSON mode: emit compact (single-line) JSON instead of pretty-printed"
+		},
+		"include-xplane": {
+			type: "boolean",
+			description: "Include the framework-managed status.xplane subtree (excluded by default)"
+		},
+		"include-conditions": {
+			type: "boolean",
+			description: "Include status.conditions (excluded by default)"
+		}
+	},
+	async run({ args }) {
+		const cmdArgs = { target: String(args.target) };
+		if (typeof args.namespace === "string") cmdArgs.namespace = args.namespace;
+		if (typeof args.kubeconfig === "string") cmdArgs.kubeconfig = args.kubeconfig;
+		if (typeof args.context === "string") cmdArgs.context = args.context;
+		if (typeof args.format === "string") {
+			if (args.format !== "dot" && args.format !== "json") {
+				process.stderr.write(`Invalid --format "${args.format}" (expected "dot" or "json")\n`);
+				process.exit(2);
+			}
+			cmdArgs.format = args.format;
+		}
+		if (args.compact) cmdArgs.pretty = false;
+		if (args["include-xplane"]) cmdArgs.includeXplane = true;
+		if (args["include-conditions"]) cmdArgs.includeConditions = true;
+		const result = await runGetStatusCommand(cmdArgs);
+		if (result.code !== 0) {
+			process.stderr.write(`${result.error}\n`);
+			process.exit(result.code);
+		}
+		process.exit(0);
+	}
+});
+runMain(defineCommand({
+	meta: {
+		name: "xplane-utils",
+		version,
+		description: "Utilities for Crossplane compositions built with xplane"
+	},
+	subCommands: {
+		watch,
+		"get-status": getStatus
+	}
+}));
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli/discovery.ts","../src/cli/get-status.ts","../src/cli/duration.ts","../src/cli/watch.ts","../src/cli.ts"],"sourcesContent":["import { ApiextensionsV1Api, type KubeConfig } from '@kubernetes/client-node';\n\n/** Resolved API resource metadata. */\nexport interface ResolvedResource {\n  group: string;\n  version: string;\n  kind: string;\n  plural: string;\n  namespaced: boolean;\n}\n\nlet crdCache: WeakMap<KubeConfig, Promise<ResolvedResource[]>> | undefined;\n\n/**\n * Fetch the cluster's CRDs and project them into a flat list of resolved\n * resources (one entry per served version). Cached per `KubeConfig` instance.\n */\nexport async function listCrdResources(kc: KubeConfig): Promise<ResolvedResource[]> {\n  crdCache ??= new WeakMap();\n  const cached = crdCache.get(kc);\n  if (cached) return cached;\n  const promise = fetchCrdResources(kc).catch((err) => {\n    crdCache?.delete(kc);\n    throw err;\n  });\n  crdCache.set(kc, promise);\n  return promise;\n}\n\nasync function fetchCrdResources(kc: KubeConfig): Promise<ResolvedResource[]> {\n  const api = kc.makeApiClient(ApiextensionsV1Api);\n  const list = await api.listCustomResourceDefinition();\n  const out: ResolvedResource[] = [];\n  for (const item of list.items ?? []) {\n    const spec = item.spec;\n    if (!spec?.group || !spec.names?.kind || !spec.names.plural) continue;\n    const namespaced = spec.scope === 'Namespaced';\n    for (const v of spec.versions ?? []) {\n      if (!v.name || v.served === false) continue;\n      out.push({\n        group: spec.group,\n        version: v.name,\n        kind: spec.names.kind,\n        plural: spec.names.plural,\n        namespaced,\n      });\n    }\n  }\n  return out;\n}\n\n/**\n * Resolve a `<resource>[.group][.version]` user hint to a single CRD-backed\n * resource. Throws when nothing matches or when the hint is ambiguous.\n */\nexport async function resolveResource(\n  kc: KubeConfig,\n  hint: { resource: string; group?: string; version?: string },\n): Promise<ResolvedResource> {\n  const all = await listCrdResources(kc);\n  const r = hint.resource.toLowerCase();\n  const matches = all.filter((c) => {\n    const kindLc = c.kind.toLowerCase();\n    const pluralLc = c.plural.toLowerCase();\n    if (kindLc !== r && pluralLc !== r) return false;\n    if (hint.group !== undefined && c.group !== hint.group) return false;\n    if (hint.version !== undefined && c.version !== hint.version) return false;\n    return true;\n  });\n  if (matches.length === 0) {\n    const detail = [hint.resource, hint.group, hint.version].filter(Boolean).join('.');\n    throw new Error(`No CRD found matching \"${detail}\". Available kinds: ${summarise(all)}.`);\n  }\n  if (matches.length > 1) {\n    if (hint.version === undefined) {\n      const grouped = new Map<string, ResolvedResource[]>();\n      for (const m of matches)\n        grouped.set(`${m.group}/${m.kind}`, [...(grouped.get(`${m.group}/${m.kind}`) ?? []), m]);\n      if (grouped.size === 1) {\n        // Multiple served versions of the same kind/group — pick the lexicographically highest.\n        const sorted = [...matches].sort((a, b) => b.version.localeCompare(a.version));\n        return sorted[0] as ResolvedResource;\n      }\n    }\n    const candidates = matches.map((m) => `${m.plural}.${m.version}.${m.group}`).join(', ');\n    throw new Error(\n      `Ambiguous resource hint \"${hint.resource}\". Candidates: ${candidates}. Disambiguate with .group or .version.group.`,\n    );\n  }\n  return matches[0] as ResolvedResource;\n}\n\nfunction summarise(all: ResolvedResource[]): string {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const r of all) {\n    const k = `${r.plural}.${r.group}`;\n    if (seen.has(k)) continue;\n    seen.add(k);\n    out.push(k);\n    if (out.length >= 20) {\n      out.push('…');\n      break;\n    }\n  }\n  return out.join(', ');\n}\n","import type { KubeConfig } from '@kubernetes/client-node';\nimport { type LoadKubeConfigOptions, loadKubeConfig } from '../client/kubeconfig.js';\nimport { listXrCollection } from '../client/lists.js';\nimport { parseTarget } from '../watcher/target.js';\nimport type { XrRef } from '../watcher/types.js';\nimport { resolveResource } from './discovery.js';\n\nexport type GetStatusFormat = 'dot' | 'json';\n\nexport interface GetStatusCommandArgs {\n  target: string;\n  namespace?: string;\n  kubeconfig?: string;\n  context?: string;\n  /** Output format. Defaults to \"dot\". */\n  format?: GetStatusFormat;\n  /** Pretty-print JSON output. Ignored for `dot`. Defaults to true. */\n  pretty?: boolean;\n  /** Include the framework-managed `status.xplane` subtree. Defaults to false. */\n  includeXplane?: boolean;\n  /** Include `status.conditions`. Defaults to false. */\n  includeConditions?: boolean;\n}\n\nexport interface GetStatusCommandDeps {\n  loadKubeConfig?: (opts: LoadKubeConfigOptions) => KubeConfig;\n  resolveResource?: typeof resolveResource;\n  listXrCollection?: typeof listXrCollection;\n  /** Destination stream for the rendered output. */\n  out?: NodeJS.WritableStream;\n}\n\nexport type GetStatusResult = { code: 0 } | { code: 1; error: string };\n\n/**\n * Headless implementation of the `xplane-utils get-status` subcommand.\n * Fetches a single XR and prints its `.status` to `out` in the requested format.\n */\nexport async function runGetStatusCommand(\n  args: GetStatusCommandArgs,\n  deps: GetStatusCommandDeps = {},\n): Promise<GetStatusResult> {\n  const load = deps.loadKubeConfig ?? loadKubeConfig;\n  const resolve = deps.resolveResource ?? resolveResource;\n  const list = deps.listXrCollection ?? listXrCollection;\n  const out = deps.out ?? process.stdout;\n\n  const kcOpts: LoadKubeConfigOptions = {};\n  if (args.kubeconfig !== undefined) kcOpts.kubeconfig = args.kubeconfig;\n  if (args.context !== undefined) kcOpts.context = args.context;\n  const kc = load(kcOpts);\n\n  const parsed = parseTarget(args.target);\n  const resolved = await resolve(kc, {\n    resource: parsed.resource,\n    ...(parsed.group !== undefined ? { group: parsed.group } : {}),\n    ...(parsed.version !== undefined ? { version: parsed.version } : {}),\n  });\n  const ref: XrRef = {\n    group: resolved.group,\n    version: resolved.version,\n    plural: resolved.plural,\n    kind: resolved.kind,\n    namespaced: resolved.namespaced,\n    name: parsed.name,\n    ...(args.namespace !== undefined ? { namespace: args.namespace } : {}),\n  };\n  if (ref.namespaced && !ref.namespace) {\n    return { code: 1, error: `${ref.kind} is namespaced — pass --namespace/-n` };\n  }\n\n  const result = await list(kc, ref);\n  const item = result.items[0] as Record<string, unknown> | undefined;\n  if (!item) {\n    const target = `${ref.kind}/${ref.name}${ref.namespace ? ` -n ${ref.namespace}` : ''}`;\n    return { code: 1, error: `${target} not found` };\n  }\n  const status = (item.status ?? {}) as Record<string, unknown>;\n  const excluded = new Set<string>();\n  if (!args.includeXplane) excluded.add('xplane');\n  if (!args.includeConditions) excluded.add('conditions');\n  const filtered =\n    excluded.size === 0\n      ? status\n      : Object.fromEntries(Object.entries(status).filter(([k]) => !excluded.has(k)));\n\n  const format: GetStatusFormat = args.format ?? 'dot';\n  const text =\n    format === 'json'\n      ? JSON.stringify(filtered, null, args.pretty === false ? 0 : 2)\n      : toDotLines(filtered).join('\\n');\n  out.write(text.length > 0 ? `${text}\\n` : '');\n  return { code: 0 };\n}\n\n/**\n * Flatten an arbitrary JSON value into `path=value` lines. Object keys are\n * joined with `.`; array indices use `[n]`. Leaf values are JSON-encoded so\n * strings retain their quoting and special characters are preserved.\n */\nexport function toDotLines(value: unknown, prefix = ''): string[] {\n  if (value === undefined) return [];\n  if (value === null) return [`${prefix || '.'}=null`];\n  if (Array.isArray(value)) {\n    if (value.length === 0) return [`${prefix || '.'}=[]`];\n    return value.flatMap((v, i) => toDotLines(v, `${prefix}[${i}]`));\n  }\n  if (typeof value === 'object') {\n    const entries = Object.entries(value as Record<string, unknown>);\n    if (entries.length === 0) return [`${prefix || '.'}={}`];\n    return entries.flatMap(([k, v]) => toDotLines(v, prefix ? `${prefix}.${k}` : k));\n  }\n  return [`${prefix || '.'}=${JSON.stringify(value)}`];\n}\n","/** Parse a duration like `30s`, `5m`, `2h`, `100ms`, or a bare integer (milliseconds). */\nexport function parseDuration(input: string | undefined): number | undefined {\n  if (input === undefined || input === '') return undefined;\n  const m = /^(\\d+)(ms|s|m|h)?$/.exec(input);\n  if (!m)\n    throw new Error(`Invalid duration \"${input}\". Use e.g. \"30s\", \"5m\", \"1h\", or a number of ms.`);\n  const n = Number(m[1]);\n  switch (m[2]) {\n    case undefined:\n    case 'ms':\n      return n;\n    case 's':\n      return n * 1000;\n    case 'm':\n      return n * 60_000;\n    case 'h':\n      return n * 3_600_000;\n  }\n  // Unreachable — regex guarantees one of the cases above matches.\n  /* c8 ignore next */\n  return undefined;\n}\n","import type { KubeConfig } from '@kubernetes/client-node';\nimport { type LoadKubeConfigOptions, loadKubeConfig } from '../client/kubeconfig.js';\nimport { type RendererMode, runRenderer } from '../render/index.js';\nimport { awaitReady } from '../watcher/await-ready.js';\nimport { parseTarget } from '../watcher/target.js';\nimport type { XrRef } from '../watcher/types.js';\nimport { createXrWatcher, type XrWatcher } from '../watcher/xr-watcher.js';\nimport { resolveResource } from './discovery.js';\nimport { parseDuration } from './duration.js';\n\nexport interface WatchCommandArgs {\n  target: string;\n  namespace?: string;\n  kubeconfig?: string;\n  context?: string;\n  timeout?: string;\n  mode?: string;\n  disableEvents?: boolean;\n  /** CI: heartbeat interval (e.g. \"30s\"). 0 disables. */\n  heartbeat?: string;\n  /** CI: include K8s Events inline (off by default). */\n  showEvents?: boolean;\n  /** CI: every N idle heartbeats, expand into a snapshot of unready + blocked resources. 0 disables. */\n  snapshotEveryHeartbeats?: number;\n}\n\nexport interface WatchCommandDeps {\n  /** Override KubeConfig loader (for tests). */\n  loadKubeConfig?: (opts: LoadKubeConfigOptions) => KubeConfig;\n  /** Override discovery (for tests). */\n  resolveResource?: typeof resolveResource;\n  /** Override watcher factory (for tests). */\n  createXrWatcher?: typeof createXrWatcher;\n  /** Override renderer (for tests). */\n  runRenderer?: typeof runRenderer;\n  /** Override awaitReady (for tests). */\n  awaitReady?: typeof awaitReady;\n  /** Destination stream for the renderer. */\n  out?: NodeJS.WriteStream;\n  /** Signal that aborts both the watcher and renderer. */\n  signal?: AbortSignal;\n}\n\nexport type WatchResult = { code: 0 } | { code: 1; error?: string };\n\n/**\n * Headless implementation of the `xplane-utils watch` subcommand.\n * Returns the exit code instead of calling `process.exit` so it is unit-testable.\n */\nexport async function runWatchCommand(\n  args: WatchCommandArgs,\n  deps: WatchCommandDeps = {},\n): Promise<WatchResult> {\n  const load = deps.loadKubeConfig ?? loadKubeConfig;\n  const resolve = deps.resolveResource ?? resolveResource;\n  const factory = deps.createXrWatcher ?? createXrWatcher;\n  const render = deps.runRenderer ?? runRenderer;\n  const wait = deps.awaitReady ?? awaitReady;\n\n  const kcOpts: LoadKubeConfigOptions = {};\n  if (args.kubeconfig !== undefined) kcOpts.kubeconfig = args.kubeconfig;\n  if (args.context !== undefined) kcOpts.context = args.context;\n  const kc = load(kcOpts);\n\n  const parsed = parseTarget(args.target);\n  const resolved = await resolve(kc, {\n    resource: parsed.resource,\n    ...(parsed.group !== undefined ? { group: parsed.group } : {}),\n    ...(parsed.version !== undefined ? { version: parsed.version } : {}),\n  });\n  const ref: XrRef = {\n    group: resolved.group,\n    version: resolved.version,\n    plural: resolved.plural,\n    kind: resolved.kind,\n    namespaced: resolved.namespaced,\n    name: parsed.name,\n    ...(args.namespace !== undefined ? { namespace: args.namespace } : {}),\n  };\n  if (ref.namespaced && !ref.namespace) {\n    return { code: 1, error: `${ref.kind} is namespaced — pass --namespace/-n` };\n  }\n\n  const watcher: XrWatcher = factory({\n    kubeConfig: kc,\n    ref,\n    ...(deps.signal !== undefined ? { signal: deps.signal } : {}),\n    ...(args.disableEvents ? { disableEvents: true } : {}),\n  });\n\n  const mode: RendererMode | undefined =\n    args.mode === 'tty' || args.mode === 'ci' ? args.mode : undefined;\n  const renderOpts: Parameters<typeof runRenderer>[1] = { ref };\n  if (mode) renderOpts.mode = mode;\n  if (deps.out) renderOpts.out = deps.out;\n  const heartbeatMs = parseDuration(args.heartbeat);\n  if (heartbeatMs !== undefined) renderOpts.heartbeatMs = heartbeatMs;\n  if (args.showEvents !== undefined) renderOpts.showEvents = args.showEvents;\n  if (args.snapshotEveryHeartbeats !== undefined)\n    renderOpts.snapshotEveryHeartbeats = args.snapshotEveryHeartbeats;\n  const renderPromise = render(watcher, renderOpts);\n\n  const timeoutMs = parseDuration(args.timeout);\n  try {\n    await wait(watcher, timeoutMs !== undefined ? { timeoutMs } : {});\n    watcher.stop();\n    await renderPromise;\n    return { code: 0 };\n  } catch (_err) {\n    watcher.stop();\n    await renderPromise.catch(() => undefined);\n    // The renderer already surfaced the error inline — omit it here to avoid duplication.\n    return { code: 1 };\n  }\n}\n","#!/usr/bin/env node\nimport { createRequire } from 'node:module';\nimport { defineCommand, runMain } from 'citty';\nimport {\n  type GetStatusCommandArgs,\n  type GetStatusFormat,\n  runGetStatusCommand,\n} from './cli/get-status.js';\nimport { runWatchCommand, type WatchCommandArgs } from './cli/watch.js';\n\nconst require = createRequire(import.meta.url);\nconst { version } = require('../package.json') as { version: string };\n\nconst watch = defineCommand({\n  meta: {\n    name: 'watch',\n    description: 'Subscribe to a Crossplane XR and block until it becomes Ready',\n  },\n  args: {\n    target: {\n      type: 'positional',\n      required: true,\n      description: 'kubectl-style target: <resource[.group][.version]>/<name>',\n    },\n    namespace: {\n      type: 'string',\n      alias: 'n',\n      description: 'Namespace (required for namespaced XRs)',\n    },\n    kubeconfig: { type: 'string', description: 'Path to kubeconfig' },\n    context: { type: 'string', description: 'Override the active kubeconfig context' },\n    timeout: {\n      type: 'string',\n      description: 'Maximum time to wait for Ready, e.g. \"30s\", \"5m\", \"1h\"',\n    },\n    mode: { type: 'string', description: 'Force renderer mode: \"tty\" or \"ci\" (default: auto)' },\n    'no-events': {\n      type: 'boolean',\n      description: 'Disable subscribing to Kubernetes Events for the XR',\n    },\n    heartbeat: {\n      type: 'string',\n      description: 'CI mode: heartbeat interval for liveness lines (default \"30s\", \"0\" to disable)',\n    },\n    'show-events': {\n      type: 'boolean',\n      description: 'CI mode: include Kubernetes Events inline (off by default)',\n    },\n    'snapshot-every': {\n      type: 'string',\n      description:\n        'CI mode: every N idle heartbeats, expand the liveness line into a snapshot of unready + blocked resources (default 10, 0 to disable)',\n    },\n  },\n  async run({ args }) {\n    const controller = new AbortController();\n    process.on('SIGINT', () => controller.abort());\n    process.on('SIGTERM', () => controller.abort());\n\n    const cmdArgs: WatchCommandArgs = { target: String(args.target) };\n    if (typeof args.namespace === 'string') cmdArgs.namespace = args.namespace;\n    if (typeof args.kubeconfig === 'string') cmdArgs.kubeconfig = args.kubeconfig;\n    if (typeof args.context === 'string') cmdArgs.context = args.context;\n    if (typeof args.timeout === 'string') cmdArgs.timeout = args.timeout;\n    if (typeof args.mode === 'string') cmdArgs.mode = args.mode;\n    if (args['no-events']) cmdArgs.disableEvents = true;\n    if (typeof args.heartbeat === 'string') cmdArgs.heartbeat = args.heartbeat;\n    if (args['show-events']) cmdArgs.showEvents = true;\n    if (typeof args['snapshot-every'] === 'string') {\n      const n = Number.parseInt(args['snapshot-every'], 10);\n      if (Number.isFinite(n) && n >= 0) cmdArgs.snapshotEveryHeartbeats = n;\n    }\n\n    const result = await runWatchCommand(cmdArgs, { signal: controller.signal });\n    if (result.code !== 0) {\n      if (result.error) process.stderr.write(`${result.error}\\n`);\n      process.exit(result.code);\n    }\n    process.exit(0);\n  },\n});\n\nconst getStatus = defineCommand({\n  meta: {\n    name: 'get-status',\n    description: 'Fetch a Crossplane XR and print its .status',\n  },\n  args: {\n    target: {\n      type: 'positional',\n      required: true,\n      description: 'kubectl-style target: <resource[.group][.version]>/<name>',\n    },\n    namespace: {\n      type: 'string',\n      alias: 'n',\n      description: 'Namespace (required for namespaced XRs)',\n    },\n    kubeconfig: { type: 'string', description: 'Path to kubeconfig' },\n    context: { type: 'string', description: 'Override the active kubeconfig context' },\n    format: {\n      type: 'string',\n      alias: 'o',\n      description: 'Output format: \"dot\" (default) or \"json\"',\n    },\n    compact: {\n      type: 'boolean',\n      description: 'JSON mode: emit compact (single-line) JSON instead of pretty-printed',\n    },\n    'include-xplane': {\n      type: 'boolean',\n      description: 'Include the framework-managed status.xplane subtree (excluded by default)',\n    },\n    'include-conditions': {\n      type: 'boolean',\n      description: 'Include status.conditions (excluded by default)',\n    },\n  },\n  async run({ args }) {\n    const cmdArgs: GetStatusCommandArgs = { target: String(args.target) };\n    if (typeof args.namespace === 'string') cmdArgs.namespace = args.namespace;\n    if (typeof args.kubeconfig === 'string') cmdArgs.kubeconfig = args.kubeconfig;\n    if (typeof args.context === 'string') cmdArgs.context = args.context;\n    if (typeof args.format === 'string') {\n      if (args.format !== 'dot' && args.format !== 'json') {\n        process.stderr.write(`Invalid --format \"${args.format}\" (expected \"dot\" or \"json\")\\n`);\n        process.exit(2);\n      }\n      cmdArgs.format = args.format as GetStatusFormat;\n    }\n    if (args.compact) cmdArgs.pretty = false;\n    if (args['include-xplane']) cmdArgs.includeXplane = true;\n    if (args['include-conditions']) cmdArgs.includeConditions = true;\n\n    const result = await runGetStatusCommand(cmdArgs);\n    if (result.code !== 0) {\n      process.stderr.write(`${result.error}\\n`);\n      process.exit(result.code);\n    }\n    process.exit(0);\n  },\n});\n\nconst main = defineCommand({\n  meta: {\n    name: 'xplane-utils',\n    version,\n    description: 'Utilities for Crossplane compositions built with xplane',\n  },\n  subCommands: { watch, 'get-status': getStatus },\n});\n\nvoid runMain(main);\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,119 @@
+import { a as EmittedResource, c as XplaneStatus, d as XrSnapshot, i as BlockedResource, l as XrEvent, n as XrWatcher, o as KubernetesEvent, r as createXrWatcher, s as ResourceRef, t as CreateXrWatcherOptions, u as XrRef } from "./xr-watcher-EiWHVp3o.mjs";
+import { KubeConfig, KubernetesObject } from "@kubernetes/client-node";
+
+//#region src/client/kubeconfig.d.ts
+interface LoadKubeConfigOptions {
+  /** Explicit kubeconfig file path. Falls back to `KUBECONFIG` / default discovery. */
+  kubeconfig?: string;
+  /** Override the active context. */
+  context?: string;
+}
+/**
+ * Load a `KubeConfig` from disk using `client-node`'s default rules (with
+ * optional explicit overrides). The returned config has its current context
+ * applied.
+ */
+declare function loadKubeConfig(opts?: LoadKubeConfigOptions): KubeConfig;
+//#endregion
+//#region src/watcher/await-ready.d.ts
+interface AwaitReadyOptions {
+  /** Maximum time in ms to wait for `Ready=True` before rejecting. */
+  timeoutMs?: number;
+}
+/**
+ * Resolve when the watcher observes its first `Ready=True` snapshot. Rejects on
+ * the watcher's first error, if the stream ends without becoming ready, or on
+ * `timeoutMs`.
+ *
+ * Uses the watcher's dedicated `ready` promise — it does NOT consume queue
+ * events, so it composes safely with a concurrent renderer iterating the
+ * watcher.
+ *
+ * The watcher itself is not stopped on resolution — call `watcher.stop()` from
+ * a `.finally()` if you want the underlying connections torn down.
+ */
+declare function awaitReady(watcher: XrWatcher, opts?: AwaitReadyOptions): Promise<XrSnapshot>;
+//#endregion
+//#region src/watcher/readiness.d.ts
+/**
+ * Build an `XrSnapshot` from a raw Kubernetes object. Parses the `Ready` condition,
+ * the optional `status.xplane` payload and `status.resourceRefs`.
+ */
+declare function buildSnapshot(object: KubernetesObject): XrSnapshot;
+//#endregion
+//#region src/watcher/target.d.ts
+/**
+ * Parse a kubectl-style resource target of the form:
+ *   <resource>/<name>
+ * where `<resource>` is one of:
+ *   - `kind` (e.g. `xprojects`, `XProject`)
+ *   - `kind.group` (e.g. `xprojects.platform.example.com`)
+ *   - `kind.version.group` (e.g. `xprojects.v1alpha1.platform.example.com`)
+ *
+ * The `kind` token is returned as-is; resolving it to an API group/version/plural
+ * is the discovery layer's responsibility (see `client/discovery.ts`).
+ */
+interface ParsedTarget {
+  /** Resource hint: kind, plural, or short name as typed by the user. */
+  resource: string;
+  /** Optional API group hint extracted from `kind.group` or `kind.version.group`. */
+  group?: string;
+  /** Optional API version hint extracted from `kind.version.group`. */
+  version?: string;
+  /** Object name. */
+  name: string;
+}
+declare function parseTarget(input: string): ParsedTarget;
+//#endregion
+//#region src/watcher/tree.d.ts
+/**
+ * A node in the construct-derived resource tree.
+ *
+ * Resource names emitted by compositions encode their construct path with `/` as
+ * the separator (e.g. `"CMS Database/Security Group"`). The tree mirrors that
+ * hierarchy so renderers can indent each branch.
+ */
+interface TreeNode {
+  /** Last segment of the construct path (display label). */
+  label: string;
+  /** Full construct path (joined with `/`). */
+  path: string;
+  /** Kubernetes `metadata.name` of the leaf resource, when known. */
+  name?: string;
+  /** Kubernetes `metadata.namespace` of the leaf resource, when present. */
+  namespace?: string;
+  /** True when an emitted resource at this exact path is ready. */
+  ready: boolean;
+  /** True when this exact path appears in `blockedResources`. */
+  blocked: boolean;
+  /** Unresolved dependencies copied from the blocked entry. */
+  waitingFor?: string[];
+  /** API version of the leaf resource (if any). */
+  apiVersion?: string;
+  /** Kind of the leaf resource (if any). */
+  kind?: string;
+  /** Child nodes keyed by path segment. */
+  children: TreeNode[];
+}
+/** Aggregate counts derived from `status.xplane`. */
+interface TreeStats {
+  /** Total emitted resources. */
+  total: number;
+  /** Emitted resources marked ready. */
+  ready: number;
+  /** Blocked resources. */
+  blocked: number;
+}
+interface ResourceTree {
+  /** Root-level nodes. */
+  roots: TreeNode[];
+  /** Aggregate counts. Zero values when no xplane status is available. */
+  stats: TreeStats;
+  /** Source used to build the tree. */
+  source: 'xplane' | 'resourceRefs' | 'empty';
+}
+/** Build a `ResourceTree` from a snapshot, preferring `status.xplane` when present. */
+declare function buildTree(snapshot: XrSnapshot): ResourceTree;
+//#endregion
+export { type AwaitReadyOptions, type BlockedResource, type CreateXrWatcherOptions, type EmittedResource, type KubernetesEvent, type LoadKubeConfigOptions, type ParsedTarget, type ResourceRef, type ResourceTree, type TreeNode, type TreeStats, type XplaneStatus, type XrEvent, type XrRef, type XrSnapshot, type XrWatcher, awaitReady, buildSnapshot, buildTree, createXrWatcher, loadKubeConfig, parseTarget };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/client/kubeconfig.ts","../src/watcher/await-ready.ts","../src/watcher/readiness.ts","../src/watcher/target.ts","../src/watcher/tree.ts"],"mappings":";;;;UAEiB,qBAAA;;EAEf,UAAA;EAFe;EAIf,OAAO;AAAA;;AAAA;AAQT;;;iBAAgB,cAAA,CAAe,IAAA,GAAM,qBAAA,GAA6B,UAAU;;;UCX3D,iBAAA;;EAEf,SAAS;AAAA;;;ADCF;AAQT;;;;;;;;AAA4E;iBCMtD,UAAA,CACpB,OAAA,EAAS,SAAA,EACT,IAAA,GAAM,iBAAA,GACL,OAAA,CAAQ,UAAA;;;;;ADrBX;;iBEiBgB,aAAA,CAAc,MAAA,EAAQ,gBAAA,GAAmB,UAAU;;;;;;;AFjBnE;;;;AAIS;AAQT;;UGHiB,YAAA;EHG2D;EGD1E,QAAA;EHC6B;EGC7B,KAAA;EHD0E;EGG1E,OAAA;;EAEA,IAAA;AAAA;AAAA,iBAGc,WAAA,CAAY,KAAA,WAAgB,YAAY;;;;;;AHpBxD;;;;UIOiB,QAAA;EJKD;EIHd,KAAA;;EAEA,IAAA;EJCmC;EICnC,IAAA;EJDgE;EIGhE,SAAA;EJH0E;EIK1E,KAAA;;EAEA,OAAA;EHlBe;EGoBf,UAAA;;EAEA,UAAA;EHpBS;EGsBT,IAAA;EHP8B;EGS9B,QAAA,EAAU,QAAQ;AAAA;;UAIH,SAAA;EHVd;EGYD,KAAA;EHZQ;EGcR,KAAA;EHhBA;EGkBA,OAAA;AAAA;AAAA,UAGe,YAAA;EHnBN;EGqBT,KAAA,EAAO,QAAA;EHrBY;EGuBnB,KAAA,EAAO,SAAS;;EAEhB,MAAA;AAAA;;iBAIc,SAAA,CAAU,QAAA,EAAU,UAAA,GAAa,YAAY"}

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { a as awaitReady, i as buildSnapshot, o as loadKubeConfig, r as parseTarget, t as createXrWatcher } from "./xr-watcher-1etyvp-6.mjs";
+import { t as buildTree } from "./tree-DaHkojq8.mjs";
+export { awaitReady, buildSnapshot, buildTree, createXrWatcher, loadKubeConfig, parseTarget };