@acidgreen-au/ag-cicd-cli 0.0.1

package/dist/cli.d.mts

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

package/dist/cli.mjs

@@ -0,0 +1,584 @@
+#!/usr/bin/env node
+import { program } from "commander";
+import { execSync, spawn } from "node:child_process";
+import { readFileSync, writeFileSync } from "node:fs";
+
+//#region src/commands/check-tag.ts
+function getVersionFromPackage(packagePath) {
+	const content = readFileSync(packagePath, "utf-8");
+	return JSON.parse(content).version;
+}
+function tagExists(tag) {
+	try {
+		execSync(`git rev-parse --verify "refs/tags/${tag}"`, {
+			encoding: "utf-8",
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		});
+		return true;
+	} catch {
+		return false;
+	}
+}
+function createTag(tag, message) {
+	execSync(`git tag -a "${tag}" -m "${message}"`, {
+		encoding: "utf-8",
+		stdio: [
+			"pipe",
+			"pipe",
+			"pipe"
+		]
+	});
+}
+function pushTag(tag, remote) {
+	execSync(`git push "${remote}" "${tag}"`, {
+		encoding: "utf-8",
+		stdio: [
+			"pipe",
+			"pipe",
+			"pipe"
+		]
+	});
+}
+function checkTag(options) {
+	const packagePath = options.packagePath ?? "package.json";
+	const prefix = options.prefix ?? "v";
+	const remote = options.remote ?? "origin";
+	const version = getVersionFromPackage(packagePath);
+	const tag = `${prefix}${version}`;
+	if (tagExists(tag)) return {
+		version,
+		tag,
+		exists: true,
+		created: false,
+		pushed: false,
+		message: `Tag ${tag} already exists`
+	};
+	if (!options.create) return {
+		version,
+		tag,
+		exists: false,
+		created: false,
+		pushed: false,
+		message: `Tag ${tag} does not exist`
+	};
+	createTag(tag, `Release ${version}`);
+	if (!options.push) return {
+		version,
+		tag,
+		exists: false,
+		created: true,
+		pushed: false,
+		message: `Created tag ${tag}`
+	};
+	pushTag(tag, remote);
+	return {
+		version,
+		tag,
+		exists: false,
+		created: true,
+		pushed: true,
+		message: `Created and pushed tag ${tag}`
+	};
+}
+function checkTagCommand(options) {
+	try {
+		const result = checkTag(options);
+		console.log(result.message);
+		if (!result.exists && !options.create) process.exit(1);
+	} catch (error) {
+		console.error("Error:", error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+}
+
+//#endregion
+//#region src/utils/codequality.ts
+function runBiome() {
+	try {
+		const result = execSync("pnpm exec biome ci --reporter=gitlab --colors=off", {
+			encoding: "utf-8",
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		});
+		return JSON.parse(result);
+	} catch (error) {
+		if (error instanceof Error && "stdout" in error) {
+			const stdout = error.stdout;
+			try {
+				return JSON.parse(stdout);
+			} catch {
+				return [];
+			}
+		}
+		return [];
+	}
+}
+function runPrettier() {
+	let files = [];
+	try {
+		files = parsePrettierOutput(execSync("pnpm exec prettier --check --list-different ./theme", {
+			encoding: "utf-8",
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		}));
+	} catch (error) {
+		if (error instanceof Error && "stdout" in error) {
+			const stdout = error.stdout;
+			files = parsePrettierOutput(stdout);
+		}
+	}
+	return files.map((file) => ({
+		description: "File not formatted according to Prettier rules",
+		check_name: "prettier",
+		fingerprint: Buffer.from(file).toString("base64"),
+		severity: "minor",
+		location: {
+			path: file,
+			lines: { begin: 1 }
+		}
+	}));
+}
+function parsePrettierOutput(output) {
+	return output.split("\n").map((line) => line.trim()).filter((line) => line && !line.startsWith(">") && !line.startsWith("$"));
+}
+function runThemeCheck(themePath) {
+	let themeCheckResult = [];
+	try {
+		const result = execSync(`shopify theme check --path ${themePath} --output json`, {
+			encoding: "utf-8",
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		});
+		themeCheckResult = JSON.parse(result);
+	} catch (error) {
+		if (error instanceof Error && "stdout" in error) {
+			const stdout = error.stdout;
+			try {
+				themeCheckResult = JSON.parse(stdout);
+			} catch {
+				themeCheckResult = [];
+			}
+		}
+	}
+	return themeCheckResult.flatMap((file) => file.offenses.map((offense) => ({
+		description: offense.message,
+		check_name: offense.check,
+		fingerprint: Buffer.from(`${file.path}:${offense.start_row}:${offense.check}`).toString("base64"),
+		severity: mapThemeSeverity(offense.severity),
+		location: {
+			path: file.path,
+			lines: { begin: offense.start_row || 1 }
+		}
+	})));
+}
+function mapThemeSeverity(severity) {
+	switch (severity) {
+		case 0: return "info";
+		case 1: return "minor";
+		case 2: return "major";
+		default: return "critical";
+	}
+}
+function runTsc() {
+	let errors = [];
+	try {
+		execSync("pnpm exec tsc --noEmit", {
+			encoding: "utf-8",
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		});
+	} catch (error) {
+		if (error instanceof Error && "stdout" in error) {
+			const stdout = error.stdout;
+			errors = parseTscOutput(stdout);
+		}
+	}
+	return errors.map((err) => ({
+		description: `TS${err.code}: ${err.message}`,
+		check_name: `typescript/${err.code}`,
+		fingerprint: Buffer.from(`${err.file}:${err.line}:${err.column}:${err.code}`).toString("base64"),
+		severity: "major",
+		location: {
+			path: err.file,
+			lines: { begin: err.line }
+		}
+	}));
+}
+function parseTscOutput(output) {
+	const errors = [];
+	const lines = output.split("\n");
+	const errorRegex = /^(.+)\((\d+),(\d+)\):\s*error\s+TS(\d+):\s*(.+)$/;
+	for (const line of lines) {
+		const match = line.match(errorRegex);
+		if (match) errors.push({
+			file: match[1],
+			line: parseInt(match[2], 10),
+			column: parseInt(match[3], 10),
+			code: match[4],
+			message: match[5]
+		});
+	}
+	return errors;
+}
+
+//#endregion
+//#region src/commands/codequality.ts
+const ALL_CHECKS = [
+	"biome",
+	"prettier",
+	"theme-check",
+	"tsc"
+];
+function codequality(options) {
+	const { output, path, checks = ALL_CHECKS } = options;
+	const allIssues = [];
+	const enabledChecks = new Set(checks);
+	console.log(`Running code quality checks: ${checks.join(", ")}\n`);
+	if (enabledChecks.has("biome")) {
+		console.log("Running Biome...");
+		const biomeIssues = runBiome();
+		allIssues.push(...biomeIssues);
+		console.log(`  Found ${biomeIssues.length} issues\n`);
+	}
+	if (enabledChecks.has("prettier")) {
+		console.log("Running Prettier...");
+		const prettierIssues = runPrettier();
+		allIssues.push(...prettierIssues);
+		console.log(`  Found ${prettierIssues.length} issues\n`);
+	}
+	if (enabledChecks.has("theme-check")) {
+		console.log("Running Theme Check...");
+		const themeIssues = runThemeCheck(path);
+		allIssues.push(...themeIssues);
+		console.log(`  Found ${themeIssues.length} issues\n`);
+	}
+	if (enabledChecks.has("tsc")) {
+		console.log("Running TypeScript...");
+		const tscIssues = runTsc();
+		allIssues.push(...tscIssues);
+		console.log(`  Found ${tscIssues.length} issues\n`);
+	}
+	writeFileSync(output, JSON.stringify(allIssues, null, 2));
+	console.log(`Wrote ${allIssues.length} total issues to ${output}`);
+}
+
+//#endregion
+//#region src/commands/commit-msg.ts
+function validateCommitMsg(options) {
+	const { file, prefix } = options;
+	const ticketRegex = /* @__PURE__ */ new RegExp(`^${prefix}-[0-9]+`);
+	let message;
+	try {
+		message = readFileSync(file, "utf-8").trim();
+	} catch {
+		return {
+			success: false,
+			message: `Error: Unable to read commit message file: ${file}`
+		};
+	}
+	const match = message.match(ticketRegex);
+	if (!match) return {
+		success: false,
+		message: `Error: Commit message must start with a JIRA ticket ID (e.g., ${prefix}-69420).`
+	};
+	const ticket = match[0];
+	let branch;
+	try {
+		branch = execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf-8" }).trim();
+	} catch {
+		return {
+			success: true,
+			message: "Warning: Unable to determine current branch name; skipping branch-ticket check.",
+			ticket
+		};
+	}
+	if (!branch.match(/* @__PURE__ */ new RegExp(`${prefix}-[0-9]+`))) return {
+		success: true,
+		message: "OK",
+		ticket,
+		branch
+	};
+	if (!branch.includes(ticket)) return {
+		success: false,
+		message: `Error: Branch name \`${branch}\` does not contain ticket ID ${ticket}.`,
+		ticket,
+		branch
+	};
+	return {
+		success: true,
+		message: "OK",
+		ticket,
+		branch
+	};
+}
+function commitMsg(options) {
+	const result = validateCommitMsg(options);
+	if (!result.success) {
+		console.error(result.message);
+		process.exit(1);
+	}
+	if (result.message.startsWith("Warning:")) console.warn(result.message);
+	process.exit(0);
+}
+
+//#endregion
+//#region src/utils/shopify.ts
+function listThemes() {
+	const result = execSync("shopify theme list --json", { encoding: "utf-8" });
+	return JSON.parse(result);
+}
+function findThemeByName(name) {
+	return listThemes().find((t) => t.name === name);
+}
+function findLiveTheme() {
+	return listThemes().find((t) => t.role === "live");
+}
+function duplicateTheme(themeId, name) {
+	const result = execSync(`shopify theme duplicate -j --theme "${themeId}" --name "${name}"`, { encoding: "utf-8" });
+	return JSON.parse(result);
+}
+function pushTheme(path, themeId, ignorePatterns = []) {
+	const result = execSync(`shopify theme push --path ${path} --theme "${themeId}" ${ignorePatterns.map((p) => `--ignore "${p}"`).join(" ")} --json`, { encoding: "utf-8" });
+	return JSON.parse(result);
+}
+function deleteTheme(themeId) {
+	execSync(`shopify theme delete --theme "${themeId}" --force`, { encoding: "utf-8" });
+}
+function writeDeployEnv(previewUrl, editorUrl, themeId, extras = {}) {
+	let content = `PREVIEW_URL=${previewUrl}\nEDITOR_URL=${editorUrl}\nTHEME_ID=${themeId}\n`;
+	for (const [key, value] of Object.entries(extras)) content += `${key}=${value}\n`;
+	writeFileSync("deploy.env", content);
+}
+const defaultIgnores = [
+	"templates/**/*.json",
+	"locales/**/*.json",
+	"config/settings_data.json",
+	"src/*",
+	"public/*"
+];
+
+//#endregion
+//#region src/commands/deploy.ts
+function deploy(options) {
+	const { themeId, path } = options;
+	const themeIdNum = parseInt(themeId, 10);
+	const { preview_url, editor_url } = pushTheme(path, themeIdNum, defaultIgnores).theme;
+	console.log("Release deployed successfully!");
+	console.log(`Preview URL: ${preview_url}`);
+	console.log(`Editor URL: ${editor_url}`);
+	writeDeployEnv(preview_url, editor_url, themeIdNum);
+}
+
+//#endregion
+//#region src/commands/deploy-review.ts
+function deployReview(options) {
+	const { branch, path } = options;
+	const themeName = `AG Preview: ${branch}`;
+	console.log(`Setting up review app for branch: ${branch}`);
+	let reviewThemeId;
+	const existingTheme = findThemeByName(themeName);
+	if (!existingTheme) {
+		console.log("Creating new unpublished theme...");
+		const liveTheme = findLiveTheme();
+		if (!liveTheme) throw new Error("No live theme found to clone from");
+		console.log(`Cloning from published theme ID: ${liveTheme.id}`);
+		reviewThemeId = duplicateTheme(liveTheme.id, themeName).theme.id;
+	} else {
+		console.log(`Theme already exists with ID: ${existingTheme.id}`);
+		reviewThemeId = existingTheme.id;
+	}
+	console.log(`Deploying branch ${branch} to theme ID: ${reviewThemeId}`);
+	const { preview_url, editor_url } = pushTheme(path, reviewThemeId, defaultIgnores).theme;
+	console.log("Review app deployed successfully!");
+	console.log(`Preview URL: ${preview_url}`);
+	console.log(`Editor URL: ${editor_url}`);
+	writeDeployEnv(preview_url, editor_url, reviewThemeId, { EXISTING_THEME_ID: existingTheme?.id?.toString() ?? "" });
+}
+
+//#endregion
+//#region src/commands/dev.ts
+function dev(_options, command) {
+	const themeArgs = command.args;
+	console.log("Starting development servers...");
+	const vite = spawn("pnpm", ["exec", "vite"], {
+		stdio: "inherit",
+		shell: true
+	});
+	const shopify = spawn("pnpm", [
+		"exec",
+		"shopify",
+		"theme",
+		"dev",
+		...themeArgs
+	], {
+		stdio: "inherit",
+		shell: true
+	});
+	const cleanup = () => {
+		vite.kill();
+		shopify.kill();
+		process.exit(0);
+	};
+	process.on("SIGINT", cleanup);
+	process.on("SIGTERM", cleanup);
+	vite.on("close", (code) => {
+		if (code !== 0) {
+			console.error(`Vite exited with code ${code}`);
+			shopify.kill();
+			process.exit(code ?? 1);
+		}
+	});
+	shopify.on("close", (code) => {
+		if (code !== 0) {
+			console.error(`Shopify theme dev exited with code ${code}`);
+			vite.kill();
+			process.exit(code ?? 1);
+		}
+	});
+}
+
+//#endregion
+//#region src/commands/release.ts
+function release(options) {
+	const { name, path } = options;
+	const themeName = `AG Release: ${name}`;
+	const liveTheme = findLiveTheme();
+	if (!liveTheme) throw new Error("No live theme found to clone from");
+	console.log(`Cloning from published theme ID: ${liveTheme.id}`);
+	const releaseThemeId = duplicateTheme(liveTheme.id, themeName).theme.id;
+	const { preview_url, editor_url } = pushTheme(path, releaseThemeId, defaultIgnores).theme;
+	console.log("Release deployed successfully!");
+	console.log(`Preview URL: ${preview_url}`);
+	console.log(`Editor URL: ${editor_url}`);
+	writeDeployEnv(preview_url, editor_url, releaseThemeId, { PUBLISHED_THEME_ID: liveTheme.id.toString() });
+}
+
+//#endregion
+//#region src/commands/stop-review.ts
+function stopReview(options) {
+	const { branch } = options;
+	const themeName = `AG Preview: ${branch}`;
+	console.log(`Cleaning up review app for branch: ${branch}`);
+	const theme = findThemeByName(themeName);
+	if (theme) {
+		console.log(`Deleting theme: ${themeName} (ID: ${theme.id})`);
+		deleteTheme(theme.id);
+		console.log("Review app cleaned up successfully!");
+	} else console.log(`No theme found with name: ${themeName}`);
+}
+
+//#endregion
+//#region src/commands/validate-env.ts
+const commonVars = [{
+	name: "SHOPIFY_CLI_THEME_TOKEN",
+	required: true,
+	description: "Shopify CLI authentication token"
+}, {
+	name: "SHOPIFY_FLAG_STORE",
+	required: true,
+	description: "Shopify store URL"
+}];
+const contextVars = {
+	deploy: [{
+		name: "SHOPIFY_THEME_ID",
+		required: true,
+		description: "Target theme ID for deployment"
+	}],
+	review: [{
+		name: "CI_COMMIT_REF_NAME",
+		required: true,
+		description: "Git branch name for review app"
+	}],
+	release: [{
+		name: "CI_COMMIT_TAG",
+		required: true,
+		description: "Git tag for release"
+	}],
+	codequality: []
+};
+function getVarsToCheck(options) {
+	const { context, vars } = options;
+	if (vars && vars.length > 0) return vars.map((name) => ({
+		name,
+		required: true,
+		description: "User-specified variable"
+	}));
+	const varsToCheck = [...commonVars];
+	const ctx = context ?? "all";
+	if (ctx !== "all" && contextVars[ctx]) varsToCheck.push(...contextVars[ctx]);
+	else if (ctx === "all") for (const ctxVars of Object.values(contextVars)) varsToCheck.push(...ctxVars);
+	return varsToCheck;
+}
+function checkEnvVars(varsToCheck, env = process.env) {
+	const missing = [];
+	const present = [];
+	for (const envVar of varsToCheck) {
+		const value = env[envVar.name];
+		if (!value && envVar.required) missing.push(envVar);
+		else present.push({
+			name: envVar.name,
+			value,
+			redacted: envVar.name.includes("TOKEN")
+		});
+	}
+	return {
+		success: missing.length === 0,
+		present,
+		missing
+	};
+}
+function validateEnv(options) {
+	const { context, vars } = options;
+	const ctx = context ?? "all";
+	if (vars && vars.length > 0) console.log("Validating specified environment variables:\n");
+	else console.log(`Validating environment for context: ${ctx}\n`);
+	const result = checkEnvVars(getVarsToCheck(options));
+	if (result.present.length > 0) {
+		console.log("✓ Present:");
+		for (const item of result.present) {
+			const displayValue = item.redacted ? "[REDACTED]" : item.value;
+			console.log(`  ${item.name}=${displayValue}`);
+		}
+		console.log();
+	}
+	if (result.missing.length > 0) {
+		console.log("✗ Missing:");
+		for (const envVar of result.missing) console.log(`  ${envVar.name} - ${envVar.description}`);
+		console.log();
+		process.exit(1);
+	}
+	console.log("All required environment variables are set.");
+}
+
+//#endregion
+//#region src/cli.ts
+program.name("agci").description("Acidgreen CI/CD CLI tools").version("1.0.0");
+program.command("codequality").description("Run code quality checks and combine output").option("-o, --output <file>", "Output file", "codequality.json").option("-p, --path <path>", "Theme path", "theme").option("-c, --checks <checks...>", "Checks to run (biome, prettier, theme-check, tsc)").action(codequality);
+program.command("deploy:review").description("Deploy a review app for the current branch").requiredOption("-b, --branch <branch>", "Branch name (CI_COMMIT_REF_NAME)").option("-p, --path <path>", "Theme path", "theme").action(deployReview);
+program.command("stop:review").description("Stop and delete a review app").requiredOption("-b, --branch <branch>", "Branch name (CI_COMMIT_REF_NAME)").action(stopReview);
+program.command("deploy").description("Deploy to a specific theme").requiredOption("-t, --theme-id <id>", "Theme ID (SHOPIFY_THEME_ID)").option("-p, --path <path>", "Theme path", "theme").action(deploy);
+program.command("release").description("Create a release by cloning live theme and pushing").requiredOption("-n, --name <name>", "Release name/tag").option("-p, --path <path>", "Theme path", "theme").action(release);
+program.command("validate-env").description("Validate required environment variables are set").option("-c, --context <context>", "Context to validate (deploy, review, release, codequality, all)").option("-v, --vars <vars...>", "Specific environment variables to check").action(validateEnv);
+program.command("dev").description("Start Vite and Shopify theme dev servers concurrently").allowUnknownOption().allowExcessArguments().action(dev);
+program.command("commit-msg").description("Validate commit message format (for git hooks)").requiredOption("-f, --file <file>", "Path to commit message file").option("-p, --prefix <prefix>", "JIRA project prefix", "AIR").action(commitMsg);
+program.command("check-tag").description("Check if git tag exists for package.json version").option("-p, --package-path <path>", "Path to package.json", "package.json").option("--prefix <prefix>", "Tag prefix", "v").option("-c, --create", "Create the tag if it does not exist").option("--push", "Push the tag to remote (requires --create)").option("-r, --remote <remote>", "Remote to push to", "origin").action(checkTagCommand);
+program.parse();
+
+//#endregion
+export {  };

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@acidgreen-au/ag-cicd-cli",
+  "version": "0.0.1",
+  "description": "Acidgreen CI/CD CLI tools",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/acidgreen/internal/agcicd.git"
+  },
+  "type": "module",
+  "bin": {
+    "agci": "./dist/cli.mjs"
+  },
+  "main": "./dist/cli.mjs",
+  "types": "./dist/cli.d.mts",
+  "exports": {
+    ".": "./dist/cli.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "commander": "13.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.10",
+    "@types/node": "24.10.4",
+    "husky": "^9.1.7",
+    "tsdown": "^0.18.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "volta": {
+    "node": "24.12.0"
+  },
+  "module": "./dist/cli.mjs",
+  "scripts": {
+    "build": "tsdown",
+    "cli": "node src/cli.ts",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "biome:unsafe": "biome check --write --unsafe",
+    "biome:check": "biome check",
+    "biome:ci": "biome ci",
+    "typecheck": "tsc",
+    "precommit": "pnpm run biome:ci && pnpm run typecheck"
+  }
+}