@f5-sales-demo/pi-resource-management 19.51.2

package/package.json

@@ -0,0 +1,61 @@
+{
+	"type": "module",
+	"name": "@f5-sales-demo/pi-resource-management",
+	"version": "19.51.2",
+	"description": "Shared resource management for F5 XC manifest parsing, validation, diff, and CRUD operations",
+	"homepage": "https://github.com/f5-sales-demo/xcsh",
+	"author": "Robin Mordasiewicz",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/f5-sales-demo/xcsh.git",
+		"directory": "packages/resource-management"
+	},
+	"bugs": {
+		"url": "https://github.com/f5-sales-demo/xcsh/issues"
+	},
+	"keywords": [
+		"xcsh",
+		"resource-management",
+		"kubectl",
+		"apply",
+		"manifest"
+	],
+	"main": "./src/index.ts",
+	"types": "./src/index.ts",
+	"scripts": {
+		"check": "biome check . && bun run check:types",
+		"check:types": "tsgo -p tsconfig.json --noEmit",
+		"generate-defaults": "bun run scripts/generate-defaults.ts && bun run fmt",
+		"lint": "biome lint .",
+		"test": "bun test",
+		"fix": "biome check --write --unsafe .",
+		"fmt": "biome format --write ."
+	},
+	"dependencies": {
+		"yaml": "2.9.0"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.3"
+	},
+	"engines": {
+		"bun": ">=1.3.7"
+	},
+	"files": [
+		"src"
+	],
+	"exports": {
+		".": {
+			"types": "./src/index.ts",
+			"import": "./src/index.ts",
+			"require": "./src/index.ts",
+			"default": "./src/index.ts"
+		},
+		"./*": {
+			"types": "./src/*.ts",
+			"import": "./src/*.ts",
+			"require": "./src/*.ts"
+		},
+		"./*.js": "./src/*.ts"
+	}
+}

package/src/arg-parser.ts

@@ -0,0 +1,131 @@
+import type { ParsedExportArgs, ParsedResourceArgs } from "./types";
+
+const VALID_OUTPUT_FORMATS = new Set(["json", "yaml", "table", "wide"]);
+const VALID_EXPORT_FORMATS = new Set(["json", "yaml"]);
+const VALID_DRY_RUN_MODES = new Set(["client", "server"]);
+
+export function parseResourceArgs(argsString: string): ParsedResourceArgs | { error: string } {
+	const tokens = argsString.split(/\s+/).filter(Boolean);
+	const filenames: string[] = [];
+	let namespace: string | undefined;
+	let outputFormat: ParsedResourceArgs["outputFormat"] = "table";
+	let dryRun: ParsedResourceArgs["dryRun"];
+	let recursive = false;
+	let force = false;
+	const positionals: string[] = [];
+
+	for (let i = 0; i < tokens.length; i++) {
+		const token = tokens[i];
+
+		if (token === "-f" || token === "--filename") {
+			if (i + 1 >= tokens.length) return { error: `${token} requires a file path.` };
+			filenames.push(tokens[++i]);
+		} else if (token.startsWith("-f") && token.length > 2 && token[2] !== "-") {
+			filenames.push(token.slice(2));
+		} else if (token === "-n" || token === "--namespace") {
+			if (i + 1 >= tokens.length) return { error: `${token} requires a namespace value.` };
+			namespace = tokens[++i];
+		} else if (token.startsWith("-n") && token.length > 2 && token[2] !== "-") {
+			namespace = token.slice(2);
+		} else if (token === "-o" || token === "--output") {
+			if (i + 1 >= tokens.length) return { error: `${token} requires a format value (json, yaml, table, wide).` };
+			const fmt = tokens[++i];
+			if (!VALID_OUTPUT_FORMATS.has(fmt)) {
+				return { error: `Invalid output format: "${fmt}". Must be one of: json, yaml, table, wide.` };
+			}
+			outputFormat = fmt as ParsedResourceArgs["outputFormat"];
+		} else if (token.startsWith("-o") && token.length > 2 && token[2] !== "-") {
+			const fmt = token.slice(2);
+			if (!VALID_OUTPUT_FORMATS.has(fmt)) {
+				return { error: `Invalid output format: "${fmt}". Must be one of: json, yaml, table, wide.` };
+			}
+			outputFormat = fmt as ParsedResourceArgs["outputFormat"];
+		} else if (token.startsWith("--dry-run")) {
+			if (token.includes("=")) {
+				const mode = token.split("=")[1];
+				if (!VALID_DRY_RUN_MODES.has(mode)) {
+					return { error: `Invalid --dry-run mode: "${mode}". Must be "client" or "server".` };
+				}
+				dryRun = mode as ParsedResourceArgs["dryRun"];
+			} else {
+				dryRun = "client";
+			}
+		} else if (token === "-R" || token === "--recursive") {
+			recursive = true;
+		} else if (token === "--force") {
+			force = true;
+		} else if (token.startsWith("-")) {
+			return { error: `Unknown flag: "${token}".` };
+		} else {
+			positionals.push(token);
+		}
+	}
+
+	return {
+		filenames,
+		namespace,
+		outputFormat,
+		dryRun,
+		recursive,
+		force,
+		kind: positionals[0],
+		name: positionals[1],
+	};
+}
+
+export function parseExportArgs(argsString: string): ParsedExportArgs | { error: string } {
+	const tokens = argsString.split(/\s+/).filter(Boolean);
+	let namespace: string | undefined;
+	let outputFormat: ParsedExportArgs["outputFormat"] = "json";
+	let outputFile: string | undefined;
+	let all = false;
+	const positionals: string[] = [];
+
+	for (let i = 0; i < tokens.length; i++) {
+		const token = tokens[i];
+
+		if (token === "-n" || token === "--namespace") {
+			if (i + 1 >= tokens.length) return { error: `${token} requires a namespace value.` };
+			namespace = tokens[++i];
+		} else if (token.startsWith("-n") && token.length > 2 && token[2] !== "-") {
+			namespace = token.slice(2);
+		} else if (token === "-o" || token === "--output") {
+			if (i + 1 >= tokens.length) return { error: `${token} requires a format value (json, yaml).` };
+			const fmt = tokens[++i];
+			if (!VALID_EXPORT_FORMATS.has(fmt)) {
+				return { error: `Invalid output format: "${fmt}". Must be one of: json, yaml.` };
+			}
+			outputFormat = fmt as ParsedExportArgs["outputFormat"];
+		} else if (token.startsWith("-o") && token.length > 2 && token[2] !== "-") {
+			const fmt = token.slice(2);
+			if (!VALID_EXPORT_FORMATS.has(fmt)) {
+				return { error: `Invalid output format: "${fmt}". Must be one of: json, yaml.` };
+			}
+			outputFormat = fmt as ParsedExportArgs["outputFormat"];
+		} else if (token === "-f" || token === "--file") {
+			if (i + 1 >= tokens.length) return { error: `${token} requires an output file path.` };
+			outputFile = tokens[++i];
+		} else if (token.startsWith("-f") && token.length > 2 && token[2] !== "-") {
+			outputFile = token.slice(2);
+		} else if (token === "--all") {
+			all = true;
+		} else if (token.startsWith("-")) {
+			return { error: `Unknown flag: "${token}".` };
+		} else {
+			positionals.push(token);
+		}
+	}
+
+	if (!all && positionals.length === 0) {
+		return { error: "Specify a resource kind, or use --all to export all resources." };
+	}
+
+	return {
+		kind: positionals[0],
+		name: positionals[1],
+		namespace,
+		outputFormat,
+		outputFile,
+		all,
+	};
+}