@forinda/kickjs-cli 1.2.0 → 1.2.2

package/dist/cli.js

@@ -22,7 +22,13 @@ import { fileURLToPath } from "url";
 // src/utils/fs.ts
 import { writeFile, mkdir, access, readFile } from "fs/promises";
 import { dirname } from "path";
+var _dryRun = false;
+function setDryRun(enabled) {
+  _dryRun = enabled;
+}
+__name(setDryRun, "setDryRun");
 async function writeFileSafe(filePath, content) {
+  if (_dryRun) return;
   await mkdir(dirname(filePath), {
     recursive: true
   });
@@ -1926,7 +1932,7 @@ function promptUser(question) {
 }
 __name(promptUser, "promptUser");
 async function generateModule(options) {
-  const { name, modulesDir, noEntity, noTests, repo = "inmemory", force } = options;
+  const { name, modulesDir, noEntity, noTests, repo = "inmemory", force, dryRun } = options;
   let pattern = options.pattern ?? "ddd";
   if (options.minimal) pattern = "minimal";
   const kebab = toKebabCase(name);
@@ -1938,6 +1944,10 @@ async function generateModule(options) {
   let overwriteAll = force ?? false;
   const write = /* @__PURE__ */ __name(async (relativePath, content) => {
     const fullPath = join2(moduleDir, relativePath);
+    if (dryRun) {
+      files.push(fullPath);
+      return;
+    }
     if (!overwriteAll && await fileExists(fullPath)) {
       const answer = await promptUser(`  File already exists: ${relativePath}
   Overwrite? (y/n/a = yes/no/all) `);
@@ -1979,7 +1989,9 @@ async function generateModule(options) {
       await generateDddFiles(ctx);
       break;
   }
-  await autoRegisterModule(modulesDir, pascal, plural);
+  if (!dryRun) {
+    await autoRegisterModule(modulesDir, pascal, plural);
+  }
   return files;
 }
 __name(generateModule, "generateModule");
@@ -3299,13 +3311,19 @@ async function loadKickConfig(cwd) {
 __name(loadKickConfig, "loadKickConfig");
 
 // src/commands/generate.ts
-function printGenerated(files) {
+function isDryRun(cmd) {
+  return cmd.parent?.opts()?.dryRun ?? false;
+}
+__name(isDryRun, "isDryRun");
+function printGenerated(files, dryRun = false) {
   const cwd = process.cwd();
+  const label = dryRun ? "Would generate" : "Generated";
   console.log(`
-  Generated ${files.length} file${files.length === 1 ? "" : "s"}:`);
+  ${label} ${files.length} file${files.length === 1 ? "" : "s"}:`);
   for (const f of files) {
     console.log(`    ${f.replace(cwd + "/", "")}`);
   }
+  if (dryRun) console.log("\n  (dry run \u2014 no files were written)");
   console.log();
 }
 __name(printGenerated, "printGenerated");
@@ -3369,14 +3387,16 @@ function printGeneratorList() {
 }
 __name(printGeneratorList, "printGeneratorList");
 function registerGenerateCommand(program) {
-  const gen = program.command("generate").alias("g").description("Generate code scaffolds").option("--list", "List all available generators").action((opts) => {
+  const gen = program.command("generate").alias("g").description("Generate code scaffolds").option("--list", "List all available generators").option("--dry-run", "Preview files that would be generated without writing them").action((opts) => {
     if (opts.list) {
       printGeneratorList();
     } else {
       gen.help();
     }
   });
-  gen.command("module <name>").description("Generate a module (structure depends on project pattern)").option("--no-entity", "Skip entity and value object generation").option("--no-tests", "Skip test file generation").option("--repo <type>", "Repository implementation: inmemory | drizzle | prisma").option("--pattern <pattern>", "Override project pattern: rest | ddd | cqrs | minimal").option("--minimal", "Shorthand for --pattern minimal").option("--modules-dir <dir>", "Modules directory").option("-f, --force", "Overwrite existing files without prompting").action(async (name, opts) => {
+  gen.command("module <name>").description("Generate a module (structure depends on project pattern)").option("--no-entity", "Skip entity and value object generation").option("--no-tests", "Skip test file generation").option("--repo <type>", "Repository implementation: inmemory | drizzle | prisma").option("--pattern <pattern>", "Override project pattern: rest | ddd | cqrs | minimal").option("--minimal", "Shorthand for --pattern minimal").option("--modules-dir <dir>", "Modules directory").option("-f, --force", "Overwrite existing files without prompting").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const config = await loadKickConfig(process.cwd());
     const modulesDir = opts.modulesDir ?? config?.modulesDir ?? "src/modules";
     const repo = opts.repo ?? config?.defaultRepo ?? "inmemory";
@@ -3389,18 +3409,23 @@ function registerGenerateCommand(program) {
       repo,
       minimal: opts.minimal,
       force: opts.force,
-      pattern
+      pattern,
+      dryRun
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("adapter <name>").description("Generate an AppAdapter with lifecycle hooks and middleware support").option("-o, --out <dir>", "Output directory", "src/adapters").action(async (name, opts) => {
+  gen.command("adapter <name>").description("Generate an AppAdapter with lifecycle hooks and middleware support").option("-o, --out <dir>", "Output directory", "src/adapters").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const files = await generateAdapter({
       name,
       outDir: resolve4(opts.out)
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("middleware <name>").description("Generate an Express middleware function\n  Use -m to scope it to a module: kick g middleware auth -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts) => {
+  gen.command("middleware <name>").description("Generate an Express middleware function\n  Use -m to scope it to a module: kick g middleware auth -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const config = await loadKickConfig(process.cwd());
     const modulesDir = config?.modulesDir ?? "src/modules";
     const files = await generateMiddleware({
@@ -3410,9 +3435,11 @@ function registerGenerateCommand(program) {
       modulesDir,
       pattern: config?.pattern
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("guard <name>").description("Generate a route guard (auth, roles, etc.)\n  Use -m to scope it to a module: kick g guard admin -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts) => {
+  gen.command("guard <name>").description("Generate a route guard (auth, roles, etc.)\n  Use -m to scope it to a module: kick g guard admin -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const config = await loadKickConfig(process.cwd());
     const modulesDir = config?.modulesDir ?? "src/modules";
     const files = await generateGuard({
@@ -3422,9 +3449,11 @@ function registerGenerateCommand(program) {
       modulesDir,
       pattern: config?.pattern
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("service <name>").description("Generate a @Service() class\n  Use -m to scope it to a module: kick g service payment -m orders").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts) => {
+  gen.command("service <name>").description("Generate a @Service() class\n  Use -m to scope it to a module: kick g service payment -m orders").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const config = await loadKickConfig(process.cwd());
     const modulesDir = config?.modulesDir ?? "src/modules";
     const files = await generateService({
@@ -3434,9 +3463,11 @@ function registerGenerateCommand(program) {
       modulesDir,
       pattern: config?.pattern
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("controller <name>").description("Generate a @Controller() class with basic routes\n  Use -m to scope it to a module: kick g controller auth -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts) => {
+  gen.command("controller <name>").description("Generate a @Controller() class with basic routes\n  Use -m to scope it to a module: kick g controller auth -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const config = await loadKickConfig(process.cwd());
     const modulesDir = config?.modulesDir ?? "src/modules";
     const files = await generateController2({
@@ -3446,9 +3477,11 @@ function registerGenerateCommand(program) {
       modulesDir,
       pattern: config?.pattern
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("dto <name>").description("Generate a Zod DTO schema\n  Use -m to scope it to a module: kick g dto create-user -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts) => {
+  gen.command("dto <name>").description("Generate a Zod DTO schema\n  Use -m to scope it to a module: kick g dto create-user -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module folder").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const config = await loadKickConfig(process.cwd());
     const modulesDir = config?.modulesDir ?? "src/modules";
     const files = await generateDto({
@@ -3458,9 +3491,11 @@ function registerGenerateCommand(program) {
       modulesDir,
       pattern: config?.pattern
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("test <name>").description("Generate a Vitest test scaffold\n  Use -m to scope it to a module: kick g test user-service -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module's __tests__/ folder").action(async (name, opts) => {
+  gen.command("test <name>").description("Generate a Vitest test scaffold\n  Use -m to scope it to a module: kick g test user-service -m users").option("-o, --out <dir>", "Output directory (overrides --module)").option("-m, --module <module>", "Place inside a module's __tests__/ folder").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const config = await loadKickConfig(process.cwd());
     const modulesDir = config?.modulesDir ?? "src/modules";
     const files = await generateTest({
@@ -3469,24 +3504,30 @@ function registerGenerateCommand(program) {
       moduleName: opts.module,
       modulesDir
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("resolver <name>").description("Generate a GraphQL @Resolver class with @Query and @Mutation methods").option("-o, --out <dir>", "Output directory", "src/resolvers").action(async (name, opts) => {
+  gen.command("resolver <name>").description("Generate a GraphQL @Resolver class with @Query and @Mutation methods").option("-o, --out <dir>", "Output directory", "src/resolvers").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const files = await generateResolver({
       name,
       outDir: resolve4(opts.out)
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("job <name>").description("Generate a @Job queue processor with @Process handlers").option("-o, --out <dir>", "Output directory", "src/jobs").option("-q, --queue <name>", "Queue name (default: <name>-queue)").action(async (name, opts) => {
+  gen.command("job <name>").description("Generate a @Job queue processor with @Process handlers").option("-o, --out <dir>", "Output directory", "src/jobs").option("-q, --queue <name>", "Queue name (default: <name>-queue)").action(async (name, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const files = await generateJob({
       name,
       outDir: resolve4(opts.out),
       queue: opts.queue
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("scaffold <name> [fields...]").description("Generate a full CRUD module from field definitions\n  Example: kick g scaffold Post title:string body:text published:boolean?\n  Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c\n  Append ? for optional fields: description:text?").option("--no-entity", "Skip entity and value object generation").option("--no-tests", "Skip test file generation").option("--modules-dir <dir>", "Modules directory").action(async (name, rawFields, opts) => {
+  gen.command("scaffold <name> [fields...]").description("Generate a full CRUD module from field definitions\n  Example: kick g scaffold Post title:string body:text published:boolean?\n  Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c\n  Append ? for optional fields: description:text?").option("--no-entity", "Skip entity and value object generation").option("--no-tests", "Skip test file generation").option("--modules-dir <dir>", "Modules directory").action(async (name, rawFields, opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     if (rawFields.length === 0) {
       console.error("\n  Error: At least one field is required.\n  Usage: kick g scaffold <name> <field:type> [field:type...]\n  Example: kick g scaffold Post title:string body:text published:boolean\n");
       process.exit(1);
@@ -3506,16 +3547,18 @@ function registerGenerateCommand(program) {
     for (const f of fields) {
       console.log(`    ${f.name}: ${f.type}${f.optional ? " (optional)" : ""}`);
     }
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
-  gen.command("config").description("Generate a kick.config.ts at the project root").option("--modules-dir <dir>", "Modules directory path", "src/modules").option("--repo <type>", "Default repository type: inmemory | drizzle | prisma", "inmemory").option("-f, --force", "Overwrite existing kick.config.ts without prompting").action(async (opts) => {
+  gen.command("config").description("Generate a kick.config.ts at the project root").option("--modules-dir <dir>", "Modules directory path", "src/modules").option("--repo <type>", "Default repository type: inmemory | drizzle | prisma", "inmemory").option("-f, --force", "Overwrite existing kick.config.ts without prompting").action(async (opts, cmd) => {
+    const dryRun = isDryRun(cmd);
+    setDryRun(dryRun);
     const files = await generateConfig({
       outDir: resolve4("."),
       modulesDir: opts.modulesDir,
       defaultRepo: opts.repo,
       force: opts.force
     });
-    printGenerated(files);
+    printGenerated(files, dryRun);
   });
 }
 __name(registerGenerateCommand, "registerGenerateCommand");