zudojs-cli 0.1.2 → 1.0.0

package/dist/src/generators/route/route.generator.js

@@ -4,21 +4,27 @@
  * Generates route files.
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
+import { normalizeName, toCamelCase } from "../../utils/utils.name.js";
 export async function generateRoute(options, cwd) {
+    const name = normalizeName(options.name);
+    const nameCamel = toCamelCase(options.name);
     const files = {
-        [`${options.basePath}/routes/${options.name}.route.ts`]: `/**
- * ${options.name} route.
+        [`${options.basePath}/routes/${name}.route.ts`]: `/**
+ * ${name} route.
  */
 
-export const ${options.name}Route = {
-  path: "/${options.name.toLowerCase()}",
+export const ${nameCamel}Route = {
+  path: "/${name}",
   method: "GET",
   handler: async () => {
-    return { message: "${options.name}" };
+    return { message: "${name}" };
   },
 };
 `,
     };
+    if (options.dryRun) {
+        return Object.keys(files);
+    }
     await writeFileTree(cwd, files);
     return Object.keys(files);
 }

package/dist/src/generators/service/service.generator.d.ts

@@ -6,6 +6,7 @@
 export interface GenerateServiceOptions {
     readonly name: string;
     readonly basePath?: string;
+    readonly dryRun?: boolean;
 }
 export declare function generateService(options: GenerateServiceOptions, cwd: string): Promise<string[]>;
 //# sourceMappingURL=service.generator.d.ts.map

package/dist/src/generators/service/service.generator.js

@@ -3,14 +3,13 @@
  *
  * Generates a new service with CQRS structure.
  */
-import { writeFileTree } from "../../utils/utils.fileSystem.js";
+import { writeFileTree, mergeBarrelExport, } from "../../utils/utils.fileSystem.js";
 import { CLIGenerationError } from "../../errors/index.js";
+import { assertGeneratableName, toPascalCase } from "../../utils/utils.name.js";
 export async function generateService(options, cwd) {
     const basePath = options.basePath ?? "services";
-    const name = options.name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
-    const namePascal = name
-        .replace(/-([a-z])/g, (_, c) => c.toUpperCase())
-        .replace(/^./, (c) => c.toUpperCase());
+    const name = assertGeneratableName(options.name, "service name");
+    const namePascal = toPascalCase(name);
     const files = {
         [`${basePath}/${name}/${name}.service.ts`]: `import { createLogger } from "@zudojs/logger";
 
@@ -22,11 +21,15 @@ export class ${namePascal}Service {
   }
 }
 `,
-        [`${basePath}/${name}/index.ts`]: `export { ${namePascal}Service } from "./${name}.service.js";
-`,
-        [`${basePath}/${name}/commands/index.ts`]: ``,
-        [`${basePath}/${name}/queries/index.ts`]: ``,
+        // Merge with any existing barrel content instead of overwriting it.
+        [`${basePath}/${name}/index.ts`]: mergeBarrelExport(cwd, `${basePath}/${name}/index.ts`, `export { ${namePascal}Service } from "./${name}.service.js";`),
+        // Preserve any existing content in the CQRS barrels.
+        [`${basePath}/${name}/commands/index.ts`]: mergeBarrelExport(cwd, `${basePath}/${name}/commands/index.ts`, ""),
+        [`${basePath}/${name}/queries/index.ts`]: mergeBarrelExport(cwd, `${basePath}/${name}/queries/index.ts`, ""),
     };
+    if (options.dryRun) {
+        return Object.keys(files);
+    }
     try {
         await writeFileTree(cwd, files);
         return Object.keys(files);

package/dist/src/generators/validator/validator.generator.d.ts

@@ -6,6 +6,7 @@
 export interface GenerateValidatorOptions {
     readonly name: string;
     readonly basePath: string;
+    readonly dryRun?: boolean;
 }
 export declare function generateValidator(options: GenerateValidatorOptions, cwd: string): Promise<string[]>;
 //# sourceMappingURL=validator.generator.d.ts.map

package/dist/src/generators/validator/validator.generator.js

@@ -4,17 +4,23 @@
  * Generates validator files.
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
+import { normalizeName, toPascalCase } from "../../utils/utils.name.js";
 export async function generateValidator(options, cwd) {
+    const name = normalizeName(options.name);
+    const namePascal = toPascalCase(options.name);
     const files = {
-        [`${options.basePath}/validators/${options.name}.validator.ts`]: `/**
- * ${options.name} validator.
+        [`${options.basePath}/validators/${name}.validator.ts`]: `/**
+ * ${name} validator.
  */
 
-export function validate${options.name}(input: unknown): boolean {
+export function validate${namePascal}(input: unknown): boolean {
   return true;
 }
 `,
     };
+    if (options.dryRun) {
+        return Object.keys(files);
+    }
     await writeFileTree(cwd, files);
     return Object.keys(files);
 }

package/dist/src/installers/dependency.installer.js

@@ -1,4 +1,4 @@
-import { execCommand } from "../utils/utils.exec.js";
+import { runStreaming } from "../utils/utils.exec.js";
 export function getInstallCommand(packageManager) {
     switch (packageManager) {
         case "pnpm":
@@ -7,6 +7,8 @@ export function getInstallCommand(packageManager) {
             return ["npm", "install"];
         case "yarn":
             return ["yarn", "install"];
+        case "bun":
+            return ["bun", "install"];
         default:
             return ["pnpm", "install"];
     }
@@ -19,12 +21,14 @@ export function getAddCommand(packageManager, pkg) {
             return ["npm", "install", pkg];
         case "yarn":
             return ["yarn", "add", pkg];
+        case "bun":
+            return ["bun", "add", pkg];
         default:
             return ["pnpm", "add", pkg];
     }
 }
 export async function installDependencies(packageManager, cwd) {
     const [file, ...args] = getInstallCommand(packageManager);
-    await execCommand(file, args, cwd);
+    await runStreaming(file, args, cwd);
 }
 //# sourceMappingURL=dependency.installer.js.map

package/dist/src/manifest/manifestManager.core.d.ts

@@ -5,7 +5,10 @@
  */
 export interface ZudojsManifest {
     readonly version: string;
+    readonly projectType?: string;
     readonly architecture: string;
+    /** Service names for microservice projects. */
+    readonly services?: readonly string[];
     readonly backend?: {
         readonly architecture: string;
         readonly api: string;

package/dist/src/prompts/backend/index.d.ts

@@ -6,4 +6,5 @@
 export { promptBackendArchitecture } from "./backend-architecture.prompt.js";
 export { promptDatabase } from "./database.prompt.js";
 export { promptApiStyle } from "./api-style.prompt.js";
+export { promptServices } from "./services.prompt.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/prompts/backend/index.js

@@ -6,4 +6,5 @@
 export { promptBackendArchitecture } from "./backend-architecture.prompt.js";
 export { promptDatabase } from "./database.prompt.js";
 export { promptApiStyle } from "./api-style.prompt.js";
+export { promptServices } from "./services.prompt.js";
 //# sourceMappingURL=index.js.map

package/dist/src/prompts/backend/services.prompt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * zudojs-cli — Services Prompt
+ *
+ * Prompts for microservice service names (comma-separated).
+ */
+export declare function promptServices(overrides?: readonly string[]): Promise<string[]>;
+//# sourceMappingURL=services.prompt.d.ts.map

package/dist/src/prompts/backend/services.prompt.js

@@ -0,0 +1,39 @@
+/**
+ * zudojs-cli — Services Prompt
+ *
+ * Prompts for microservice service names (comma-separated).
+ */
+import * as p from "@clack/prompts";
+const SERVICE_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
+function parseServices(value) {
+    return value
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+export async function promptServices(overrides) {
+    if (overrides && overrides.length > 0) {
+        return [...overrides];
+    }
+    const value = await p.text({
+        message: "Service names (comma-separated)",
+        placeholder: "identity,billing,notification",
+        validate(input) {
+            const services = parseServices(input ?? "");
+            if (services.length === 0) {
+                return "At least one service name is required.";
+            }
+            for (const service of services) {
+                if (!SERVICE_NAME_PATTERN.test(service)) {
+                    return `Invalid service name "${service}". Only alphanumeric characters, hyphens, and underscores are allowed.`;
+                }
+            }
+        },
+    });
+    if (p.isCancel(value)) {
+        p.cancel("Operation cancelled.");
+        process.exit(0);
+    }
+    return parseServices(value);
+}
+//# sourceMappingURL=services.prompt.js.map

package/dist/src/prompts/index.d.ts

@@ -1,7 +1,6 @@
 /**
  * zudojs-cli — Prompts Index
  */
-export { promptCreateProject, type CreateProjectPrompts, type PromptChoice, } from "./prompts.createProject.js";
 export { promptProjectName } from "./project/project-name.prompt.js";
 export { promptProjectType } from "./project/project-type.prompt.js";
 export { promptConfirmation } from "./project/confirmation.prompt.js";

package/dist/src/prompts/index.js

@@ -1,7 +1,6 @@
 /**
  * zudojs-cli — Prompts Index
  */
-export { promptCreateProject, } from "./prompts.createProject.js";
 export { promptProjectName } from "./project/project-name.prompt.js";
 export { promptProjectType } from "./project/project-type.prompt.js";
 export { promptConfirmation } from "./project/confirmation.prompt.js";

package/dist/src/rollback/rollbackManager.core.js

@@ -5,7 +5,6 @@
  */
 import { existsSync } from "node:fs";
 import { rm } from "node:fs/promises";
-import { join } from "node:path";
 export class RollbackManager {
     entries = [];
     trackFile(path) {

package/dist/src/runners/process/processRunner.core.d.ts

@@ -6,6 +6,10 @@
 export interface ProcessOptions {
     readonly cwd: string;
     readonly env?: Record<string, string>;
+    /**
+     * Child stdio mode. Only meaningful for {@link ProcessRunner.runBackground};
+     * {@link ProcessRunner.run} always buffers output so it can return it.
+     */
     readonly stdio?: "inherit" | "pipe" | "ignore";
 }
 export declare class ProcessRunner {

package/dist/src/runners/process/processRunner.core.js

@@ -7,12 +7,26 @@ import { execCommand } from "../../utils/utils.exec.js";
 export class ProcessRunner {
     async run(command, args, options) {
         try {
-            await execCommand(command, Array.from(args), options.cwd);
-            return { stdout: "", stderr: "", exitCode: 0 };
+            // The buffered output used to be thrown away and every caller got
+            // empty strings, making the documented `stdout`/`stderr` fields
+            // useless. `options.env` was ignored here too.
+            const result = await execCommand(command, Array.from(args), options.cwd, {
+                ...(options.env ? { env: { ...process.env, ...options.env } } : {}),
+            });
+            return { stdout: result.stdout, stderr: result.stderr, exitCode: 0 };
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
-            return { stdout: "", stderr: message, exitCode: 1 };
+            const stdout = typeof error.stdout === "string"
+                ? error.stdout
+                : "";
+            const stderr = typeof error.stderr === "string"
+                ? error.stderr
+                : message;
+            const exitCode = typeof error.code === "number"
+                ? error.code
+                : 1;
+            return { stdout, stderr, exitCode };
         }
     }
     async runBackground(command, args, options) {

package/dist/src/scaffolders/framework.scaffolder.js

@@ -7,7 +7,10 @@ import { execCommand } from "../utils/utils.exec.js";
 export class FrameworkScaffolder {
     async scaffold(targetPath) {
         try {
-            await execCommand(this.command, this.args, targetPath);
+            await execCommand(this.command, this.args, targetPath, {
+                // Suppress interactive prompts from create-* tools.
+                env: { ...process.env, CI: "1" },
+            });
             return { success: true, path: targetPath };
         }
         catch (error) {
@@ -19,12 +22,12 @@ export class FrameworkScaffolder {
 export class ViteReactScaffolder extends FrameworkScaffolder {
     name = "react-vite";
     command = "npm";
-    args = ["create", "vite@latest", ".", "--template", "react-ts"];
+    args = ["create", "vite@latest", ".", "--", "--template", "react-ts"];
 }
 export class ViteVueScaffolder extends FrameworkScaffolder {
     name = "vue-vite";
     command = "npm";
-    args = ["create", "vite@latest", ".", "--template", "vue-ts"];
+    args = ["create", "vite@latest", ".", "--", "--template", "vue-ts"];
 }
 export class NextScaffolder extends FrameworkScaffolder {
     name = "next";
@@ -61,12 +64,12 @@ export class AngularScaffolder extends FrameworkScaffolder {
 export class AstroScaffolder extends FrameworkScaffolder {
     name = "astro";
     command = "npm";
-    args = ["create", "astro@latest", ".", "--template", "minimal"];
+    args = ["create", "astro@latest", ".", "--", "--template", "minimal"];
 }
 export class SvelteScaffolder extends FrameworkScaffolder {
     name = "svelte";
     command = "npm";
-    args = ["create", "svite@latest", ".", "--template", "ts"];
+    args = ["create", "vite@latest", ".", "--", "--template", "svelte-ts"];
 }
 export class SvelteKitScaffolder extends FrameworkScaffolder {
     name = "sveltekit";
@@ -76,7 +79,7 @@ export class SvelteKitScaffolder extends FrameworkScaffolder {
 export class VanillaScaffolder extends FrameworkScaffolder {
     name = "vanilla";
     command = "npm";
-    args = ["create", "vite@latest", ".", "--template", "vanilla-ts"];
+    args = ["create", "vite@latest", ".", "--", "--template", "vanilla-ts"];
 }
 export class FlutterScaffolder extends FrameworkScaffolder {
     name = "flutter";

package/dist/src/scaffolders/scaffolder.helper.js

@@ -7,10 +7,15 @@ import { execCommand } from "../utils/utils.exec.js";
 import { writeFileTree } from "../utils/utils.fileSystem.js";
 export async function scaffoldWithFallback(options) {
     try {
-        await execCommand(options.command, Array.from(options.args), options.targetPath);
+        await execCommand(options.command, Array.from(options.args), options.targetPath, {
+            // Suppress interactive prompts from create-* tools.
+            env: { ...process.env, CI: "1" },
+        });
         return true;
     }
-    catch {
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`Warning: official scaffolder "${options.command} ${options.args.join(" ")}" failed (${message.split("\n")[0]}). Using built-in fallback template.`);
         await writeFileTree(options.targetPath, options.fallbackFiles);
         return false;
     }

package/dist/src/scripts/postinstall.cjs

@@ -25,7 +25,7 @@ async function checkLatestVersion(packageName) {
     const timeout = setTimeout(() => controller.abort(), 5000);
 
     const response = await fetch(
-      `https://registry.npmjs.org/latest/${packageName}`,
+      `https://registry.npmjs.org/${packageName}/latest`,
       { signal: controller.signal },
     );
     clearTimeout(timeout);
@@ -41,15 +41,36 @@ async function checkLatestVersion(packageName) {
   }
 }
 
+/**
+ * Whether the update check should be skipped.
+ *
+ * The check reaches out to registry.npmjs.org on every install. That is
+ * unwanted in CI, in Docker builds and on air-gapped machines, and there was
+ * previously no way to turn it off.
+ */
+function shouldSkip() {
+  if (process.env.ZUDOJS_NO_UPDATE_CHECK) return true;
+  if (process.env.CI) return true;
+  if (process.env.NODE_ENV === "test") return true;
+  if (process.env.npm_config_offline === "true") return true;
+  // Only a global install is the one the user upgrades with `npm i -g`.
+  if (process.env.npm_config_global !== "true") return true;
+  return false;
+}
+
 async function main() {
+  if (shouldSkip()) {
+    return;
+  }
+
   const installed = getInstalledVersion();
-  const latest = await checkLatestVersion("@zudojs/cli");
+  const latest = await checkLatestVersion("zudojs-cli");
 
   if (latest && latest !== installed) {
     console.log(
       `\n  zudojs ${installed} is installed, but version ${latest} is available.`,
     );
-    console.log(`   Run: npm install -g @zudojs/cli@latest\n`);
+    console.log(`   Run: npm install -g zudojs-cli@latest\n`);
   }
 }
 

package/dist/src/templates/microservice/index.d.ts

@@ -1,5 +1,5 @@
 /**
  * zudojs-cli — Microservice Template Index
  */
-export { generateMicroserviceFiles } from "./microservice.template.js";
+export { generateMicroserviceFiles, resolveMicroserviceServices, DEFAULT_MICROSERVICE_SERVICES, RESERVED_MICROSERVICE_APP_NAMES, } from "./microservice.template.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/templates/microservice/index.js

@@ -1,5 +1,5 @@
 /**
  * zudojs-cli — Microservice Template Index
  */
-export { generateMicroserviceFiles } from "./microservice.template.js";
+export { generateMicroserviceFiles, resolveMicroserviceServices, DEFAULT_MICROSERVICE_SERVICES, RESERVED_MICROSERVICE_APP_NAMES, } from "./microservice.template.js";
 //# sourceMappingURL=index.js.map

package/dist/src/templates/microservice/microservice.template.d.ts

@@ -17,10 +17,25 @@
  * ├── infrastructure/
  * ├── package.json
  * ├── pnpm-workspace.yaml
+ * ├── zudojs.config.ts
  * ├── docker-compose.yml
  * └── README.md
  * ```
  */
 import type { ScaffoldOptions } from "../../types/index.js";
+/** Default service names used when none are provided. */
+export declare const DEFAULT_MICROSERVICE_SERVICES: readonly ["identity", "enrollment", "assessment", "notification"];
+/**
+ * The gateway app is always generated at `apps/gateway`, so "gateway" is a
+ * reserved name: a service called `gateway` would produce a second, competing
+ * gateway at `apps/services/gateway`.
+ */
+export declare const RESERVED_MICROSERVICE_APP_NAMES: readonly ["gateway"];
+/**
+ * Normalizes a requested service list into the service apps generated under
+ * `apps/services/`. Reserved names and duplicates are dropped; an empty list
+ * falls back to DEFAULT_MICROSERVICE_SERVICES.
+ */
+export declare function resolveMicroserviceServices(requested: readonly string[]): readonly string[];
 export declare function generateMicroserviceFiles(options: ScaffoldOptions): Record<string, string>;
 //# sourceMappingURL=microservice.template.d.ts.map