zudojs-cli 0.1.1 → 1.0.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,8 +51,20 @@ 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.
+
+### Disabling the update check
+
+`zudojs-cli` checks npm for a newer version after a global install. Set
+`ZUDOJS_NO_UPDATE_CHECK=1` to turn it off; it is skipped automatically when
+`CI` is set, when npm is offline, and for non-global installs.
+
 ## Commands
 
 | Command    | Description                                                              |
@@ -61,12 +73,13 @@ zudojs add database
 | `generate` | Generate files (service, module, command, query, controller, repository) |
 | `add`      | Add feature packages (database, queue, messaging, etc.)                  |
 | `dev`      | Start development servers                                                |
+| `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/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

@@ -4,6 +4,9 @@
  *
  * @module bin/zudojs
  */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { createCLI } from "../cliApplication/index.js";
 import { CLI_DEFAULTS } from "../cliConstant/cliConstant.value.js";
 import { createCommand } from "../cliCommand/index.js";
@@ -14,9 +17,32 @@ import { runAddCommand } from "../commands/add.command.js";
 import { runBuildCommand } from "../commands/build.command.js";
 import { runDoctorCommand } from "../commands/doctor.command.js";
 import { runInfoCommand } from "../commands/info.command.js";
+/**
+ * Reads the CLI's real version from its own package.json at runtime so
+ * `zudojs --version` can never drift from the published version.
+ */
+function readCliVersion() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let depth = 0; depth < 6; depth++) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+            if (pkg.name === "zudojs-cli" && pkg.version) {
+                return pkg.version;
+            }
+        }
+        catch {
+            // keep walking up
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return CLI_DEFAULTS.VERSION;
+}
 const app = createCLI({
     name: "Zudojs",
-    version: "0.1.0",
+    version: readCliVersion(),
     description: "Command-line interface for the Zudojs framework.",
 });
 app.register(createCommand({
@@ -73,7 +99,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 +124,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) => {
@@ -226,8 +255,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

@@ -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);

package/dist/src/cliConstant/cliConstant.value.d.ts

@@ -8,7 +8,7 @@ export declare const CLI_NAME = "zudojs";
 /** Default application configuration. */
 export declare const CLI_DEFAULTS: {
     readonly NAME: "zudojs";
-    readonly VERSION: "0.1.0";
+    readonly VERSION: string;
     readonly DESCRIPTION: "Command-line interface for the Zudojs framework.";
     readonly COMMAND_PREFIX: "zudojs";
     readonly DEFAULT_CWD: string;

package/dist/src/cliConstant/cliConstant.value.js

@@ -3,6 +3,7 @@
  *
  * Default values, limits, and magic strings used across the CLI package.
  */
+import { CLI_VERSION } from "./cliVersion.js";
 /* -------------------------------------------------------------------------- */
 /* Application Defaults                                                       */
 /* -------------------------------------------------------------------------- */
@@ -11,7 +12,7 @@ export const CLI_NAME = "zudojs";
 /** Default application configuration. */
 export const CLI_DEFAULTS = {
     NAME: "zudojs",
-    VERSION: "0.1.0",
+    VERSION: CLI_VERSION,
     DESCRIPTION: "Command-line interface for the Zudojs framework.",
     COMMAND_PREFIX: "zudojs",
     DEFAULT_CWD: process.cwd(),

package/dist/src/cliConstant/cliVersion.d.ts

@@ -0,0 +1,16 @@
+/**
+ * zudojs-cli — Version resolution
+ *
+ * The CLI's own version, read from its `package.json` at runtime.
+ *
+ * It used to be a hand-maintained string literal duplicated in two places
+ * (`constants/index.ts` and `cliConstant.value.ts`). Both are stamped into the
+ * manifest of every generated project, so a release that bumped `package.json`
+ * without editing both copies would silently scaffold projects claiming the
+ * previous version. Reading the manifest removes the duplication entirely.
+ *
+ * @module cliConstant/cliVersion
+ */
+/** The CLI's version, matching its `package.json`. */
+export declare const CLI_VERSION: string;
+//# sourceMappingURL=cliVersion.d.ts.map