zudojs-cli 0.1.2 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zudojs Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -51,22 +51,45 @@ zudojs generate module users
 
 # Add a feature
 zudojs add database
+
+# Build the project
+zudojs build
 ```
 
+`zudojs build` and `zudojs doctor` exit with a non-zero status when they fail,
+so they can be used as CI gates.
+
+### Update check
+
+`zudojs info` asks npm whether a newer `zudojs-cli` exists and prints the
+version if so. Set `ZUDOJS_NO_UPDATE_CHECK=1` to turn it off; it is skipped
+automatically when `CI` is set or npm is offline. Nothing runs at install
+time.
+
+### What a new project contains
+
+`zudojs create` records the project's type, architecture, package manager and
+capabilities in `.zudojs/manifest.json` (machine-managed) and in the `zudojs`
+block of `package.json`. Every follow-up command reads those; no
+`zudojs.config.ts` is written. Framework packages are added as `^1.0.0`
+ranges, and projects created for pnpm carry a `pnpm-workspace.yaml` that
+allows esbuild's build script, which pnpm 10+ would otherwise refuse to run.
+
 ## Commands
 
 | Command    | Description                                                              |
 | ---------- | ------------------------------------------------------------------------ |
 | `create`   | Scaffold a new project (backend, frontend, or fullstack)                 |
 | `generate` | Generate files (service, module, command, query, controller, repository) |
-| `add`      | Add feature packages (database, queue, messaging, etc.)                  |
-| `dev`      | Start development servers                                                |
+| `add`      | Add feature packages (database, queue, messaging, etc.); `--service` targets one microservice app |
+| `dev`      | Start development servers through the project's package manager (`pnpm run dev`, …) |
+| `build`    | Build the project with its detected package manager                      |
 | `doctor`   | Run project diagnostics                                                  |
 | `info`     | Show project information                                                 |
 
 ## Supported Frameworks
 
-- **Backend:** Node.js, Express, Fastify
+- **Backend:** Node.js (Zudojs runtime)
 - **Frontend:** React, Next.js, Vue, Nuxt, Angular, Svelte, SvelteKit, Astro, Vanilla, Flutter, React Native
 - **Architectures:** Monolith, Modular Monolith, Microservice
 

package/dist/src/adapters/databases/postgres.adapter.d.ts

@@ -17,18 +17,4 @@ export declare class PostgresAdapter implements DatabaseAdapter {
     getDependencies(): readonly string[];
     getEnvironmentVariables(): Record<string, string>;
 }
-export declare class MySqlAdapter implements DatabaseAdapter {
-    readonly name = "mysql";
-    readonly driver = "mysql";
-    getConnectionString(dbName: string): string;
-    getDependencies(): readonly string[];
-    getEnvironmentVariables(): Record<string, string>;
-}
-export declare class SqliteAdapter implements DatabaseAdapter {
-    readonly name = "sqlite";
-    readonly driver = "sqlite";
-    getConnectionString(dbName: string): string;
-    getDependencies(): readonly string[];
-    getEnvironmentVariables(): Record<string, string>;
-}
 //# sourceMappingURL=postgres.adapter.d.ts.map

package/dist/src/adapters/databases/postgres.adapter.js

@@ -18,34 +18,4 @@ export class PostgresAdapter {
         };
     }
 }
-export class MySqlAdapter {
-    name = "mysql";
-    driver = "mysql";
-    getConnectionString(dbName) {
-        return `mysql://localhost:3306/${dbName}`;
-    }
-    getDependencies() {
-        return ["@zudojs/database"];
-    }
-    getEnvironmentVariables() {
-        return {
-            DATABASE_URL: "mysql://localhost:3306/mydb",
-        };
-    }
-}
-export class SqliteAdapter {
-    name = "sqlite";
-    driver = "sqlite";
-    getConnectionString(dbName) {
-        return `sqlite:${dbName}.db`;
-    }
-    getDependencies() {
-        return ["@zudojs/database"];
-    }
-    getEnvironmentVariables() {
-        return {
-            DATABASE_URL: "sqlite:mydb.db",
-        };
-    }
-}
 //# sourceMappingURL=postgres.adapter.js.map

package/dist/src/adapters/frontend/angular.adapter.js

@@ -4,6 +4,7 @@
  * @module adapters/frontend/angular
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
+import { normalizeName } from "../../utils/utils.name.js";
 import { scaffoldWithFallback } from "../../scaffolders/scaffolder.helper.js";
 /**
  * Angular adapter with standalone support.
@@ -19,11 +20,16 @@ export class AngularAdapter {
     }
     async scaffold(context) {
         const files = this.getBaseFiles(context);
+        // Angular CLI requires a valid project name; "." is not one. Pass the
+        // real name and scaffold into the current directory via --directory.
+        const projectName = normalizeName(context.project.name) || "zudojs-app";
         await scaffoldWithFallback({
             command: "npx",
             args: [
                 "@angular/cli@latest",
                 "new",
+                projectName,
+                "--directory",
                 ".",
                 "--skip-git",
                 "--skip-install",

package/dist/src/adapters/frontend/astro.adapter.js

@@ -25,12 +25,12 @@ export class AstroAdapter {
                 "create",
                 "astro@latest",
                 ".",
+                "--",
                 "--template",
                 "minimal",
                 "--no-install",
                 "--no-git",
-                "--typescript",
-                "strict",
+                "--yes",
             ],
             targetPath: context.projectPath,
             fallbackFiles: files,

package/dist/src/adapters/frontend/frontendAdapter.type.d.ts

@@ -17,6 +17,12 @@ export interface FrontendGenerationContext {
     readonly architecture: "zudojs-standard" | "feature-based" | "minimal" | "framework-default";
     readonly packageManager: "pnpm" | "npm" | "yarn" | "bun";
     readonly features: FrontendFeatures;
+    /**
+     * Record resolved dependencies in package.json instead of installing
+     * them. Set by `zudojs create --no-install`, which the frontend pipeline
+     * used to ignore: it ran the package manager regardless of the flag.
+     */
+    readonly skipInstall?: boolean;
 }
 /**
  * Optional frontend features.

package/dist/src/adapters/frontend/react.adapter.js

@@ -32,6 +32,7 @@ export class ReactAdapter {
                 "create",
                 "vite@latest",
                 ".",
+                "--",
                 "--template",
                 context.language === "javascript" ? "react" : "react-ts",
             ],
@@ -76,6 +77,7 @@ export class ReactAdapter {
     }
     getBaseFiles(context) {
         const useTypeScript = context.language === "typescript";
+        const ext = useTypeScript ? "tsx" : "jsx";
         return {
             "package.json": JSON.stringify({
                 name: context.project.name,
@@ -84,7 +86,8 @@ export class ReactAdapter {
                 type: "module",
                 scripts: {
                     dev: "vite",
-                    build: "tsc && vite build",
+                    // Vite performs the build; tsc only typechecks (noEmit).
+                    build: useTypeScript ? "tsc --noEmit && vite build" : "vite build",
                     preview: "vite preview",
                 },
                 dependencies: {
@@ -104,18 +107,24 @@ export default defineConfig({
   plugins: [react()],
 });
 `,
-            "tsconfig.json": JSON.stringify({
-                compilerOptions: {
-                    target: "ES2020",
-                    useDefineForClassFields: true,
-                    lib: ["ES2020", "DOM", "DOM.Iterable"],
-                    module: "ESNext",
-                    skipLibCheck: true,
-                    moduleResolution: "bundler",
-                    allowImportingTsExtensions: true,
-                    resolveJsonModule: true,
-                },
-            }, null, 2),
+            ...(useTypeScript
+                ? {
+                    "tsconfig.json": JSON.stringify({
+                        compilerOptions: {
+                            target: "ES2020",
+                            useDefineForClassFields: true,
+                            lib: ["ES2020", "DOM", "DOM.Iterable"],
+                            module: "ESNext",
+                            skipLibCheck: true,
+                            moduleResolution: "bundler",
+                            allowImportingTsExtensions: true,
+                            resolveJsonModule: true,
+                            jsx: "react-jsx",
+                            noEmit: true,
+                        },
+                    }, null, 2),
+                }
+                : {}),
             "index.html": `<!DOCTYPE html>
 <html lang="en">
   <head>
@@ -125,21 +134,21 @@ export default defineConfig({
   </head>
   <body>
     <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
+    <script type="module" src="/src/main.${ext}"></script>
   </body>
 </html>
 `,
-            "src/main.tsx": `import { StrictMode } from "react";
+            [`src/main.${ext}`]: `import { StrictMode } from "react";
 import { createRoot } from "react-dom/client";
 import App from "./App";
 
-createRoot(document.getElementById("root")!).render(
+createRoot(document.getElementById("root")${useTypeScript ? "!" : ""}).render(
   <StrictMode>
     <App />
   </StrictMode>,
 );
 `,
-            "src/App.tsx": `export default function App() {
+            [`src/App.${ext}`]: `export default function App() {
   return (
     <div>
       <h1>Hello from Zudojs</h1>

package/dist/src/adapters/frontend/svelte.adapter.js

@@ -25,6 +25,7 @@ export class SvelteAdapter {
                 "create",
                 "vite@latest",
                 ".",
+                "--",
                 "--template",
                 context.language === "javascript" ? "svelte" : "svelte-ts",
             ],

package/dist/src/adapters/frontend/sveltekit.adapter.js

@@ -20,17 +20,16 @@ export class SvelteKitAdapter {
     async scaffold(context) {
         const files = this.getBaseFiles(context);
         await scaffoldWithFallback({
-            command: "npm",
+            command: "npx",
             args: [
+                "sv",
                 "create",
-                "svelte@latest",
                 ".",
-                "--typescript",
-                "--no-eslint",
-                "--no-prettier",
-                "--no-playwright",
-                "--no-vitest",
-                "--no-git",
+                "--template",
+                "minimal",
+                "--types",
+                "ts",
+                "--no-add-ons",
                 "--no-install",
             ],
             targetPath: context.projectPath,

package/dist/src/adapters/frontend/vanilla.adapter.js

@@ -21,7 +21,7 @@ export class VanillaAdapter {
         const files = this.getBaseFiles(context);
         await scaffoldWithFallback({
             command: "npm",
-            args: ["create", "vite@latest", ".", "--template", "vanilla-ts"],
+            args: ["create", "vite@latest", ".", "--", "--template", "vanilla-ts"],
             targetPath: context.projectPath,
             fallbackFiles: files,
         });

package/dist/src/adapters/frontend/vue.adapter.js

@@ -25,6 +25,7 @@ export class VueAdapter {
                 "create",
                 "vite@latest",
                 ".",
+                "--",
                 "--template",
                 context.language === "javascript" ? "vue" : "vue-ts",
             ],

package/dist/src/adapters/package-managers/bun.adapter.js

@@ -3,7 +3,7 @@
  *
  * @module adapters/package-managers/bun
  */
-import { execCommand } from "../../utils/utils.exec.js";
+import { execCommand, runStreaming } from "../../utils/utils.exec.js";
 /**
  * bun adapter implementation.
  */
@@ -19,20 +19,20 @@ export class BunAdapter {
         }
     }
     async install(projectPath) {
-        await execCommand("bun", ["install"], projectPath);
+        await runStreaming("bun", ["install"], projectPath);
     }
     async add(projectPath, packages) {
         if (packages.length === 0)
             return;
-        await execCommand("bun", ["add", ...packages], projectPath);
+        await runStreaming("bun", ["add", ...packages], projectPath);
     }
     async addDev(projectPath, packages) {
         if (packages.length === 0)
             return;
-        await execCommand("bun", ["add", "-d", ...packages], projectPath);
+        await runStreaming("bun", ["add", "-d", ...packages], projectPath);
     }
     async run(projectPath, script) {
-        await execCommand("bun", ["run", script], projectPath);
+        await runStreaming("bun", ["run", script], projectPath);
     }
     getInstallCommand() {
         return "bun install";

package/dist/src/adapters/package-managers/npm.adapter.js

@@ -3,7 +3,7 @@
  *
  * @module adapters/package-managers/npm
  */
-import { execCommand } from "../../utils/utils.exec.js";
+import { execCommand, runStreaming } from "../../utils/utils.exec.js";
 /**
  * npm adapter implementation.
  */
@@ -19,20 +19,20 @@ export class NpmAdapter {
         }
     }
     async install(projectPath) {
-        await execCommand("npm", ["install"], projectPath);
+        await runStreaming("npm", ["install"], projectPath);
     }
     async add(projectPath, packages) {
         if (packages.length === 0)
             return;
-        await execCommand("npm", ["install", ...packages], projectPath);
+        await runStreaming("npm", ["install", ...packages], projectPath);
     }
     async addDev(projectPath, packages) {
         if (packages.length === 0)
             return;
-        await execCommand("npm", ["install", "-D", ...packages], projectPath);
+        await runStreaming("npm", ["install", "-D", ...packages], projectPath);
     }
     async run(projectPath, script) {
-        await execCommand("npm", ["run", script], projectPath);
+        await runStreaming("npm", ["run", script], projectPath);
     }
     getInstallCommand() {
         return "npm install";

package/dist/src/adapters/package-managers/pnpm.adapter.js

@@ -3,7 +3,7 @@
  *
  * @module adapters/package-managers/pnpm
  */
-import { execCommand } from "../../utils/utils.exec.js";
+import { execCommand, runStreaming } from "../../utils/utils.exec.js";
 /**
  * pnpm adapter implementation.
  */
@@ -19,20 +19,20 @@ export class PnpmAdapter {
         }
     }
     async install(projectPath) {
-        await execCommand("pnpm", ["install"], projectPath);
+        await runStreaming("pnpm", ["install"], projectPath);
     }
     async add(projectPath, packages) {
         if (packages.length === 0)
             return;
-        await execCommand("pnpm", ["add", ...packages], projectPath);
+        await runStreaming("pnpm", ["add", ...packages], projectPath);
     }
     async addDev(projectPath, packages) {
         if (packages.length === 0)
             return;
-        await execCommand("pnpm", ["add", "-D", ...packages], projectPath);
+        await runStreaming("pnpm", ["add", "-D", ...packages], projectPath);
     }
     async run(projectPath, script) {
-        await execCommand("pnpm", ["run", script], projectPath);
+        await runStreaming("pnpm", ["run", script], projectPath);
     }
     getInstallCommand() {
         return "pnpm install";

package/dist/src/adapters/package-managers/yarn.adapter.js

@@ -3,7 +3,7 @@
  *
  * @module adapters/package-managers/yarn
  */
-import { execCommand } from "../../utils/utils.exec.js";
+import { execCommand, runStreaming } from "../../utils/utils.exec.js";
 /**
  * yarn adapter implementation.
  */
@@ -19,20 +19,20 @@ export class YarnAdapter {
         }
     }
     async install(projectPath) {
-        await execCommand("yarn", ["install"], projectPath);
+        await runStreaming("yarn", ["install"], projectPath);
     }
     async add(projectPath, packages) {
         if (packages.length === 0)
             return;
-        await execCommand("yarn", ["add", ...packages], projectPath);
+        await runStreaming("yarn", ["add", ...packages], projectPath);
     }
     async addDev(projectPath, packages) {
         if (packages.length === 0)
             return;
-        await execCommand("yarn", ["add", "-D", ...packages], projectPath);
+        await runStreaming("yarn", ["add", "-D", ...packages], projectPath);
     }
     async run(projectPath, script) {
-        await execCommand("yarn", [script], projectPath);
+        await runStreaming("yarn", [script], projectPath);
     }
     getInstallCommand() {
         return "yarn install";

package/dist/src/bin/zudojs.js

@@ -5,8 +5,8 @@
  * @module bin/zudojs
  */
 import { createCLI } from "../cliApplication/index.js";
-import { CLI_DEFAULTS } from "../cliConstant/cliConstant.value.js";
 import { createCommand } from "../cliCommand/index.js";
+import { CLI_VERSION, FEATURE_PACKAGES } from "../constants/index.js";
 import { runCreateCommand } from "../commands/create.command.js";
 import { runDevCommand } from "../commands/dev.command.js";
 import { runGenerateCommand } from "../commands/generate.command.js";
@@ -16,7 +16,9 @@ import { runDoctorCommand } from "../commands/doctor.command.js";
 import { runInfoCommand } from "../commands/info.command.js";
 const app = createCLI({
     name: "Zudojs",
-    version: "0.1.0",
+    // Read from the CLI's own package.json, so `zudojs --version` cannot
+    // drift from the published version.
+    version: CLI_VERSION,
     description: "Command-line interface for the Zudojs framework.",
 });
 app.register(createCommand({
@@ -73,7 +75,7 @@ app.register(createCommand({
         },
         {
             name: "frontend-architecture",
-            short: "fa",
+            short: "F",
             description: "Frontend architecture (zudojs-standard, feature-based, minimal, framework-default)",
             type: "string",
             defaultValue: "zudojs-standard",
@@ -98,10 +100,13 @@ app.register(createCommand({
             defaultValue: false,
         },
         {
+            // No default: the flag default used to be "gateway,api", which made a
+            // non-interactive `--architecture microservice` generate
+            // apps/services/gateway alongside the always-generated apps/gateway.
+            // With no default the microservice template picks its own service set.
             name: "services",
             description: "Comma-separated service names (microservice architecture only)",
             type: "string",
-            defaultValue: "gateway,api",
         },
     ],
     execute: async (context) => {
@@ -182,15 +187,15 @@ app.register(createCommand({
     arguments: [
         {
             name: "feature",
-            description: "The feature to add (database, queue, messaging, openapi, observability, security)",
+            description: `The feature to add (${Object.keys(FEATURE_PACKAGES).join(", ")})`,
             required: true,
         },
     ],
     options: [
         {
-            name: "adapter",
-            short: "a",
-            description: "Specific adapter to use",
+            name: "service",
+            short: "s",
+            description: "Add the feature to one app of a microservice project (gateway or a service name)",
             type: "string",
         },
         {
@@ -226,8 +231,15 @@ app.register(createCommand({
         await runInfoCommand(context);
     },
 }));
-const exitCode = await app.run(process.argv.slice(2));
-if (exitCode !== 0) {
-    process.exit(exitCode);
+try {
+    const exitCode = await app.run(process.argv.slice(2));
+    if (exitCode !== 0) {
+        process.exit(exitCode);
+    }
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Error: ${message}`);
+    process.exit(1);
 }
 //# sourceMappingURL=zudojs.js.map

package/dist/src/cliApplication/cliApplication.builtins.d.ts

@@ -4,9 +4,18 @@
  * Help and version request detection and output.
  */
 import type { CLIArguments, CLIWriter } from "../cliType/cliType.type.js";
-/** Returns whether the args contain a help request. */
+/**
+ * Returns whether the args are a help request.
+ *
+ * Only the first argument is considered so that command-specific flags
+ * (e.g. `zudojs create -h ...`) are not swallowed by the global handler.
+ */
 export declare function isHelpRequest(args: CLIArguments): boolean;
-/** Returns whether the args contain a version request. */
+/**
+ * Returns whether the args are a version request.
+ *
+ * Only the first argument is considered.
+ */
 export declare function isVersionRequest(args: CLIArguments): boolean;
 /** Prints the version string. */
 export declare function printVersion(writer: CLIWriter, version?: string): void;

package/dist/src/cliApplication/cliApplication.builtins.js

@@ -4,13 +4,24 @@
  * Help and version request detection and output.
  */
 import { CLI_COMMANDS, CLI_DEFAULTS, } from "../cliConstant/cliConstant.value.js";
-/** Returns whether the args contain a help request. */
+/**
+ * Returns whether the args are a help request.
+ *
+ * Only the first argument is considered so that command-specific flags
+ * (e.g. `zudojs create -h ...`) are not swallowed by the global handler.
+ */
 export function isHelpRequest(args) {
-    return args.some((arg) => arg === CLI_COMMANDS.HELP || arg === "-h" || arg === "--help");
+    const first = args[0];
+    return first === CLI_COMMANDS.HELP || first === "-h" || first === "--help";
 }
-/** Returns whether the args contain a version request. */
+/**
+ * Returns whether the args are a version request.
+ *
+ * Only the first argument is considered.
+ */
 export function isVersionRequest(args) {
-    return args.some((arg) => arg === CLI_COMMANDS.VERSION || arg === "-v" || arg === "--version");
+    const first = args[0];
+    return (first === CLI_COMMANDS.VERSION || first === "-v" || first === "--version");
 }
 /** Prints the version string. */
 export function printVersion(writer, version) {

package/dist/src/cliApplication/cliApplication.core.js

@@ -10,8 +10,8 @@ import { CommandNotFoundError } from "../cliError/cliError.command.js";
 import { CLICommandRegistry } from "../cliCommand/cliCommand.registry.js";
 import { executeCommand } from "../cliCommand/cliCommand.factory.js";
 import { CLIParser, resolveCommand } from "../cliParser/index.js";
-import { createDefaultLogger } from "@zudojs/logger";
 import { createCLIWriter } from "./cliApplication.writer.js";
+import { createCLILogger } from "./cliApplication.logger.js";
 import { isHelpRequest, isVersionRequest, printVersion, printHelp, } from "./cliApplication.builtins.js";
 /* -------------------------------------------------------------------------- */
 /* Application                                                                */
@@ -38,7 +38,7 @@ export class ZudojsCLI {
         this.description = options.description ?? CLI_DEFAULTS.DESCRIPTION;
         this.cwd = options.cwd ?? process.cwd();
         this.env = options.env ?? process.env;
-        this.logger = options.logger ?? createDefaultLogger();
+        this.logger = options.logger ?? createCLILogger();
         this.commands = new CLICommandRegistry();
         this.parser = new CLIParser();
         this.writer = createCLIWriter();
@@ -100,12 +100,27 @@ export class ZudojsCLI {
         }
         catch (error) {
             const normalized = normalizeCLIError(error);
-            const command = this.findCommand(args);
-            const commandArgs = command
-                ? this.getCommandArguments(args, command)
-                : args;
-            const fallbackContext = this.createContext(commandArgs, command);
             if (this.hooks.onError) {
+                // Building the fallback context must never rethrow: if the original
+                // error came from argument parsing, re-parsing would fail again.
+                let fallbackContext;
+                try {
+                    const command = this.findCommand(args);
+                    const commandArgs = command
+                        ? this.getCommandArguments(args, command)
+                        : args;
+                    fallbackContext = this.createContext(commandArgs, command);
+                }
+                catch {
+                    fallbackContext = {
+                        args,
+                        values: {},
+                        command: undefined,
+                        cwd: this.cwd,
+                        env: this.env,
+                        logger: this.logger,
+                    };
+                }
                 await this.hooks.onError(normalized, fallbackContext);
             }
             this.writer.errorLine(normalized.message);