@savvy-web/github-action-builder 0.7.3 → 0.7.5

package/bin/github-action-builder.d.ts

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

package/bin/github-action-builder.js

@@ -1,317 +1,49 @@
 #!/usr/bin/env node
-import { Args, Command, Options } from "@effect/cli";
+import { AppLayer } from "../layers/app.js";
+import { buildCommand } from "../cli/commands/build.js";
+import { initCommand } from "../cli/commands/init.js";
+import { validateCommand } from "../cli/commands/validate.js";
+import "../cli/commands/index.js";
+import { Cause, Console, Effect, Layer } from "effect";
+import { Command } from "@effect/cli";
 import { NodeContext, NodeRuntime } from "@effect/platform-node";
-import { Cause, Console, Effect, Layer, Option } from "effect";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { PersistLocalService, ValidationService, AppLayer, BuildService, ConfigService, ValidationFailed, BuildFailed } from "../948.js";
-const configOption = Options.file("config").pipe(Options.withAlias("c"), Options.withDescription("Path to configuration file"), Options.optional);
-const quietOption = Options.boolean("quiet").pipe(Options.withAlias("q"), Options.withDescription("Suppress non-error output"), Options.withDefault(false));
-const noValidateOption = Options.boolean("no-validate").pipe(Options.withDescription("Skip validation step"), Options.withDefault(false));
-const noPersistOption = Options.boolean("no-persist").pipe(Options.withDescription("Skip persisting build output to local action directory"), Options.withDefault(false));
-const buildHandler = ({ config, quiet, noValidate, noPersist })=>Effect.gen(function*() {
-        const configService = yield* ConfigService;
-        const validationService = yield* ValidationService;
-        const buildService = yield* BuildService;
-        const persistLocalService = yield* PersistLocalService;
-        const cwd = process.cwd();
-        if (!quiet) yield* Console.log("Loading configuration...");
-        const loadOptions = Option.isSome(config) ? {
-            cwd,
-            configPath: config.value
-        } : {
-            cwd
-        };
-        const configResult = yield* configService.load(loadOptions);
-        if (!quiet) if (configResult.usingDefaults) yield* Console.log("  Using default configuration");
-        else yield* Console.log(`  Found ${configResult.configPath}`);
-        if (!noValidate) {
-            if (!quiet) yield* Console.log("\nValidating...");
-            const validationResult = yield* validationService.validate(configResult.config, {
-                cwd
-            });
-            if (!validationResult.valid) {
-                yield* Console.error(`\n${validationService.formatResult(validationResult)}`);
-                return yield* new ValidationFailed({
-                    errorCount: validationResult.errors.length,
-                    warningCount: validationResult.warnings.length,
-                    message: "Validation failed"
-                });
-            }
-            if (!quiet && validationResult.warnings.length > 0) yield* Console.log(validationService.formatResult(validationResult));
-            else if (!quiet) yield* Console.log("  All checks passed");
-        }
-        if (!quiet) yield* Console.log("\nBuilding...");
-        const buildResult = yield* buildService.build(configResult.config, {
-            cwd
-        });
-        if (!buildResult.success) {
-            yield* Console.error(`\nBuild failed: ${buildResult.error}`);
-            return yield* new BuildFailed({
-                message: buildResult.error ?? "One or more entries failed to build",
-                failedEntries: buildResult.entries.filter((e)=>!e.success).length
-            });
-        }
-        if (!quiet) {
-            yield* Console.log(`\n${buildService.formatResult(buildResult)}`);
-            yield* Console.log("\nBuild completed successfully!");
-        }
-        if (!noPersist && configResult.config.persistLocal.enabled) {
-            if (!quiet) yield* Console.log("\nPersisting to local action directory...");
-            const persistResult = yield* persistLocalService.persist(configResult.config, {
-                cwd
-            });
-            if (!quiet && persistResult.success) yield* Console.log(persistLocalService.formatResult(persistResult));
-        }
-    });
-const buildCommand = Command.make("build", {
-    config: configOption,
-    quiet: quietOption,
-    noValidate: noValidateOption,
-    noPersist: noPersistOption
-}, buildHandler);
-const actionNameArg = Args.text({
-    name: "action-name"
-}).pipe(Args.withDescription("Name of the GitHub Action (also the output directory)"));
-const forceOption = Options.boolean("force").pipe(Options.withAlias("f"), Options.withDescription("Overwrite existing files"), Options.withDefault(false));
-const getPackageVersion = ()=>"0.7.3";
-const generatePackageJson = (name)=>{
-    const version = getPackageVersion();
-    const pkg = {
-        name,
-        version: "0.0.0",
-        private: true,
-        type: "module",
-        scripts: {
-            build: "github-action-builder build",
-            validate: "github-action-builder validate",
-            typecheck: "tsc --noEmit"
-        },
-        devDependencies: {
-            "@savvy-web/github-action-builder": `^${version}`,
-            typescript: "^5.9.3"
-        },
-        dependencies: {
-            "@actions/core": "^1.11.1",
-            "@actions/github": "^6.0.0"
-        }
-    };
-    return `${JSON.stringify(pkg, null, 2)}\n`;
-};
-const generateTsConfig = ()=>{
-    const config = {
-        compilerOptions: {
-            target: "ES2022",
-            module: "NodeNext",
-            moduleResolution: "NodeNext",
-            strict: true,
-            esModuleInterop: true,
-            skipLibCheck: true,
-            forceConsistentCasingInFileNames: true,
-            declaration: false,
-            outDir: "dist",
-            rootDir: "src"
-        },
-        include: [
-            "src/**/*.ts",
-            "action.config.ts"
-        ],
-        exclude: [
-            "node_modules",
-            "dist"
-        ]
-    };
-    return `${JSON.stringify(config, null, 2)}\n`;
-};
-const generateActionYml = (name)=>`name: "${name}"
-description: "A GitHub Action built with @savvy-web/github-action-builder"
-author: ""
 
-inputs:
-  example-input:
-    description: "An example input"
-    required: false
-    default: "hello"
-
-outputs:
-  example-output:
-    description: "An example output"
-
-runs:
-  using: "node24"
-  main: "dist/main.js"
-  pre: "dist/pre.js"
-  post: "dist/post.js"
-
-branding:
-  icon: "zap"
-  color: "blue"
-`;
-const defaultConfig = `import { GitHubAction } from "@savvy-web/github-action-builder";
-
-export default GitHubAction.create({
-	// Entry points are auto-detected from src/main.ts, src/pre.ts, src/post.ts
-	// Uncomment to customize:
-	// entries: {
-	//   main: "src/main.ts",
-	//   pre: "src/pre.ts",
-	//   post: "src/post.ts",
-	// },
-
-	// Build options
-	// build: {
-	//   minify: true,
-	//   sourceMap: false,
-	// },
-
-	// Validation options
-	// validation: {
-	//   strict: undefined, // Auto-detects CI environment
-	// },
-});
-`;
-const mainTemplate = `import * as core from "@actions/core";
-
-async function run(): Promise<void> {
-	try {
-		const input = core.getInput("example-input");
-		core.info(\`Running main action with input: \${input}\`);
-
-		// Your main action logic goes here
-
-		core.setOutput("example-output", "success");
-	} catch (error) {
-		if (error instanceof Error) {
-			core.setFailed(error.message);
-		} else {
-			core.setFailed("An unexpected error occurred");
-		}
-	}
-}
-
-run();
-`;
-const preTemplate = `import * as core from "@actions/core";
-
-async function run(): Promise<void> {
-	try {
-		core.info("Running pre action...");
-
-		// Your pre-action setup logic goes here
-		// This runs before the main action
-	} catch (error) {
-		if (error instanceof Error) {
-			core.setFailed(error.message);
-		} else {
-			core.setFailed("An unexpected error occurred");
-		}
-	}
-}
-
-run();
-`;
-const postTemplate = `import * as core from "@actions/core";
-
-async function run(): Promise<void> {
-	try {
-		core.info("Running post action...");
-
-		// Your post-action cleanup logic goes here
-		// This runs after the main action, even if it fails
-	} catch (error) {
-		if (error instanceof Error) {
-			core.warning(error.message);
-		} else {
-			core.warning("An unexpected error occurred during cleanup");
-		}
-	}
-}
-
-run();
-`;
-const writeFile = (path, content, force, createdFiles, skippedFiles)=>{
-    if (existsSync(path) && !force) return void skippedFiles.push(path);
-    writeFileSync(path, content, "utf-8");
-    createdFiles.push(path);
-};
-const initHandler = ({ actionName, force })=>Effect.gen(function*() {
-        const cwd = process.cwd();
-        const projectDir = resolve(cwd, actionName);
-        const createdFiles = [];
-        const skippedFiles = [];
-        if (existsSync(projectDir) && !force) {
-            yield* Console.error(`Directory already exists: ${actionName}`);
-            yield* Console.error("Use --force to overwrite existing files.");
-            return yield* Effect.fail(new Error("Directory exists"));
-        }
-        if (!existsSync(projectDir)) mkdirSync(projectDir, {
-            recursive: true
-        });
-        const srcDir = resolve(projectDir, "src");
-        if (!existsSync(srcDir)) mkdirSync(srcDir, {
-            recursive: true
-        });
-        writeFile(resolve(projectDir, "package.json"), generatePackageJson(actionName), force, createdFiles, skippedFiles);
-        writeFile(resolve(projectDir, "tsconfig.json"), generateTsConfig(), force, createdFiles, skippedFiles);
-        writeFile(resolve(projectDir, "action.yml"), generateActionYml(actionName), force, createdFiles, skippedFiles);
-        writeFile(resolve(projectDir, "action.config.ts"), defaultConfig, force, createdFiles, skippedFiles);
-        writeFile(resolve(srcDir, "main.ts"), mainTemplate, force, createdFiles, skippedFiles);
-        writeFile(resolve(srcDir, "pre.ts"), preTemplate, force, createdFiles, skippedFiles);
-        writeFile(resolve(srcDir, "post.ts"), postTemplate, force, createdFiles, skippedFiles);
-        yield* Console.log(`Created ${actionName}/`);
-        if (createdFiles.length > 0) for (const file of createdFiles)yield* Console.log(`  ${file.replace(`${projectDir}/`, "")}`);
-        if (skippedFiles.length > 0) {
-            yield* Console.log("\nSkipped existing files (use --force to overwrite):");
-            for (const file of skippedFiles)yield* Console.log(`  ${file.replace(`${projectDir}/`, "")}`);
-        }
-        yield* Console.log("\nNext steps:");
-        yield* Console.log(`  cd ${actionName}`);
-        yield* Console.log("  npm install");
-        yield* Console.log("  npm run build");
-    });
-const initCommand = Command.make("init", {
-    actionName: actionNameArg,
-    force: forceOption
-}, initHandler);
-const validateHandler = ({ config, quiet })=>Effect.gen(function*() {
-        const configService = yield* ConfigService;
-        const validationService = yield* ValidationService;
-        const cwd = process.cwd();
-        if (!quiet) yield* Console.log("Loading configuration...");
-        const loadOptions = Option.isSome(config) ? {
-            cwd,
-            configPath: config.value
-        } : {
-            cwd
-        };
-        const configResult = yield* configService.load(loadOptions);
-        if (!quiet) if (configResult.usingDefaults) yield* Console.log("  Using default configuration");
-        else yield* Console.log(`  Found ${configResult.configPath}`);
-        if (!quiet) yield* Console.log("\nValidating...");
-        const validationResult = yield* validationService.validate(configResult.config, {
-            cwd
-        });
-        yield* Console.log(`\n${validationService.formatResult(validationResult)}`);
-        if (!validationResult.valid) return yield* Effect.fail(new Error("Validation failed"));
-        if (!quiet) yield* Console.log("\nValidation completed successfully!");
-    });
-const validateCommand = Command.make("validate", {
-    config: configOption,
-    quiet: quietOption
-}, validateHandler);
+//#region src/cli/index.ts
+/* v8 ignore start - CLI entry point requires integration testing */
+/**
+* GitHub Action Builder CLI entry point.
+*/
+/**
+* Root command for the CLI.
+*/
 const rootCommand = Command.make("github-action-builder").pipe(Command.withSubcommands([
-    buildCommand,
-    validateCommand,
-    initCommand
+	buildCommand,
+	validateCommand,
+	initCommand
 ]));
+/**
+* CLI application configuration.
+*/
 const cli = Command.run(rootCommand, {
-    name: "github-action-builder",
-    version: "0.7.3"
+	name: "github-action-builder",
+	version: process.env.__PACKAGE_VERSION__ ?? "0.0.0"
 });
+/**
+* Combined layer: AppLayer + NodeContext for CLI.
+*/
 const CliLayer = Layer.merge(AppLayer, NodeContext.layer);
-const main = Effect.suspend(()=>cli(process.argv)).pipe(Effect.provide(CliLayer), Effect.catchAllCause((cause)=>{
-    const defects = Cause.defects(cause);
-    if (defects.length > 0) return Console.error(Cause.pretty(cause)).pipe(Effect.andThen(Effect.failCause(cause)));
-    return Effect.failCause(cause);
+/**
+* Run the CLI with full error cause rendering.
+*
+* Expected typed errors (ValidationFailed, BuildFailed, etc.) are already
+* printed by command handlers — they just need to exit with failure.
+* Unexpected defects get full Cause.pretty rendering with stack traces.
+*/
+const main = Effect.suspend(() => cli(process.argv)).pipe(Effect.provide(CliLayer), Effect.catchAllCause((cause) => {
+	if (Cause.defects(cause).length > 0) return Console.error(Cause.pretty(cause)).pipe(Effect.andThen(Effect.failCause(cause)));
+	return Effect.failCause(cause);
 }));
 NodeRuntime.runMain(main);
+
+//#endregion
+export {  };

package/cli/commands/build.js

@@ -0,0 +1,91 @@
+import { BuildFailed, ValidationFailed } from "../../errors.js";
+import { BuildService } from "../../services/build.js";
+import { ConfigService } from "../../services/config.js";
+import { PersistLocalService } from "../../services/persist-local.js";
+import { ValidationService } from "../../services/validation.js";
+import { Console, Effect, Option } from "effect";
+import { Command, Options } from "@effect/cli";
+
+//#region src/cli/commands/build.ts
+/* v8 ignore start - CLI commands require integration testing */
+/**
+* Build command for GitHub Action Builder CLI.
+*/
+/**
+* Config file option - shared across commands.
+*/
+const configOption = Options.file("config").pipe(Options.withAlias("c"), Options.withDescription("Path to configuration file"), Options.optional);
+/**
+* Quiet mode option - suppress non-error output.
+*/
+const quietOption = Options.boolean("quiet").pipe(Options.withAlias("q"), Options.withDescription("Suppress non-error output"), Options.withDefault(false));
+/**
+* Skip validation option.
+*/
+const noValidateOption = Options.boolean("no-validate").pipe(Options.withDescription("Skip validation step"), Options.withDefault(false));
+/**
+* Skip persist-local option.
+*/
+const noPersistOption = Options.boolean("no-persist").pipe(Options.withDescription("Skip persisting build output to local action directory"), Options.withDefault(false));
+/**
+* Build command handler using Effect services.
+*/
+const buildHandler = ({ config, quiet, noValidate, noPersist }) => Effect.gen(function* () {
+	const configService = yield* ConfigService;
+	const validationService = yield* ValidationService;
+	const buildService = yield* BuildService;
+	const persistLocalService = yield* PersistLocalService;
+	const cwd = process.cwd();
+	if (!quiet) yield* Console.log("Loading configuration...");
+	const loadOptions = Option.isSome(config) ? {
+		cwd,
+		configPath: config.value
+	} : { cwd };
+	const configResult = yield* configService.load(loadOptions);
+	if (!quiet) if (configResult.usingDefaults) yield* Console.log("  Using default configuration");
+	else yield* Console.log(`  Found ${configResult.configPath}`);
+	if (!noValidate) {
+		if (!quiet) yield* Console.log("\nValidating...");
+		const validationResult = yield* validationService.validate(configResult.config, { cwd });
+		if (!validationResult.valid) {
+			yield* Console.error(`\n${validationService.formatResult(validationResult)}`);
+			return yield* new ValidationFailed({
+				errorCount: validationResult.errors.length,
+				warningCount: validationResult.warnings.length,
+				message: "Validation failed"
+			});
+		}
+		if (!quiet && validationResult.warnings.length > 0) yield* Console.log(validationService.formatResult(validationResult));
+		else if (!quiet) yield* Console.log("  All checks passed");
+	}
+	if (!quiet) yield* Console.log("\nBuilding...");
+	const buildResult = yield* buildService.build(configResult.config, { cwd });
+	if (!buildResult.success) {
+		yield* Console.error(`\nBuild failed: ${buildResult.error}`);
+		return yield* new BuildFailed({
+			message: buildResult.error ?? "One or more entries failed to build",
+			failedEntries: buildResult.entries.filter((e) => !e.success).length
+		});
+	}
+	if (!quiet) {
+		yield* Console.log(`\n${buildService.formatResult(buildResult)}`);
+		yield* Console.log("\nBuild completed successfully!");
+	}
+	if (!noPersist && configResult.config.persistLocal.enabled) {
+		if (!quiet) yield* Console.log("\nPersisting to local action directory...");
+		const persistResult = yield* persistLocalService.persist(configResult.config, { cwd });
+		if (!quiet && persistResult.success) yield* Console.log(persistLocalService.formatResult(persistResult));
+	}
+});
+/**
+* Build command - bundles GitHub Action entry points.
+*/
+const buildCommand = Command.make("build", {
+	config: configOption,
+	quiet: quietOption,
+	noValidate: noValidateOption,
+	noPersist: noPersistOption
+}, buildHandler);
+
+//#endregion
+export { buildCommand, configOption, noValidateOption, quietOption };

package/cli/commands/index.js

@@ -0,0 +1,5 @@
+import { buildCommand, configOption, noValidateOption, quietOption } from "./build.js";
+import { initCommand } from "./init.js";
+import { validateCommand } from "./validate.js";
+
+export {  };