zudojs-cli 0.1.2 → 1.0.0

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

@@ -4,8 +4,15 @@
  * Generates Docker, docker-compose, and database infrastructure files.
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
+import { CLIValidationError } from "../../errors/index.js";
+const SERVICE_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
 export class InfrastructureGenerator {
     async generate(options, basePath) {
+        for (const service of options.services ?? []) {
+            if (!SERVICE_NAME_PATTERN.test(service)) {
+                throw new CLIValidationError(`Invalid service name: "${service}". Service names must match ${SERVICE_NAME_PATTERN}.`);
+            }
+        }
         const files = this.getFiles(options);
         await writeFileTree(basePath, files);
     }
@@ -16,7 +23,7 @@ export class InfrastructureGenerator {
             files[".dockerignore"] = "node_modules\ndist\n.git\n.env\n";
             const services = options.services ?? ["gateway"];
             for (const service of services) {
-                files[`apps/${service}/Dockerfile`] =
+                files[`apps/services/${service}/Dockerfile`] =
                     this.getServiceDockerfile(options);
             }
         }
@@ -28,13 +35,83 @@ export class InfrastructureGenerator {
         files["migrations/.gitkeep"] = "";
         return files;
     }
+    /**
+     * Install and build commands for Dockerfiles.
+     *
+     * Generated projects have no lockfile yet, so never use `npm ci` or
+     * `--frozen-lockfile`. pnpm and yarn need `corepack enable` on the bare
+     * node:24-alpine image; bun is not available there so it falls back to npm.
+     */
+    getDockerCommands(options) {
+        switch (options.packageManager) {
+            case "pnpm":
+                return {
+                    install: "corepack enable && pnpm install",
+                    build: "pnpm run build",
+                };
+            case "yarn":
+                return {
+                    install: "corepack enable && yarn install",
+                    build: "yarn run build",
+                };
+            default:
+                return { install: "npm install", build: "npm run build" };
+        }
+    }
+    getDatabaseCompose(options) {
+        if (options.database === "mysql") {
+            return {
+                image: "mysql:8",
+                port: 3306,
+                environment: [
+                    "MYSQL_ROOT_PASSWORD=mysql",
+                    `MYSQL_DATABASE=${options.projectName}`,
+                ],
+                url: `mysql://root:mysql@db:3306/${options.projectName}`,
+                dataPath: "/var/lib/mysql",
+            };
+        }
+        if (options.database === "sqlite") {
+            // SQLite is file-based: no database service at all.
+            return null;
+        }
+        return {
+            image: "postgres:16-alpine",
+            port: 5432,
+            environment: [
+                "POSTGRES_USER=postgres",
+                "POSTGRES_PASSWORD=postgres",
+                `POSTGRES_DB=${options.projectName}`,
+            ],
+            url: `postgresql://postgres:postgres@db:5432/${options.projectName}`,
+            dataPath: "/var/lib/postgresql/data",
+        };
+    }
+    getDatabaseUrl(options) {
+        const db = this.getDatabaseCompose(options);
+        return db ? db.url : "sqlite:./.data/app.db";
+    }
+    getDbServiceBlock(db) {
+        return `  db:
+    image: ${db.image}
+    ports:
+      - "${db.port}:${db.port}"
+    environment:
+${db.environment.map((e) => `      - ${e}`).join("\n")}
+    volumes:
+      - db-data:${db.dataPath}
+
+volumes:
+  db-data:
+`;
+    }
     getAppDockerfile(options) {
+        const { install, build } = this.getDockerCommands(options);
         return `FROM node:24-alpine AS builder
 WORKDIR /app
-COPY package.json pnpm-lock.yaml ./
-RUN ${options.packageManager === "pnpm" ? "pnpm" : options.packageManager === "yarn" ? "yarn" : "npm"} install --frozen-lockfile
 COPY . .
-RUN ${options.packageManager === "pnpm" ? "pnpm" : options.packageManager === "yarn" ? "yarn" : "npm"} run build
+RUN ${install}
+RUN ${build}
 
 FROM node:24-alpine
 WORKDIR /app
@@ -46,12 +123,12 @@ CMD ["node", "dist/server.js"]
 `;
     }
     getServiceDockerfile(options) {
+        const { install, build } = this.getDockerCommands(options);
         return `FROM node:24-alpine AS builder
 WORKDIR /app
-COPY package.json pnpm-lock.yaml ./
-RUN ${options.packageManager === "pnpm" ? "pnpm" : options.packageManager === "yarn" ? "yarn" : "npm"} install --frozen-lockfile
 COPY . .
-RUN ${options.packageManager === "pnpm" ? "pnpm" : options.packageManager === "yarn" ? "yarn" : "npm"} run build
+RUN ${install}
+RUN ${build}
 
 FROM node:24-alpine
 WORKDIR /app
@@ -63,79 +140,42 @@ CMD ["node", "dist/server.js"]
 `;
     }
     getSimpleDockerCompose(options) {
-        const dbImage = options.database === "postgresql"
-            ? "postgres:16-alpine"
-            : options.database === "mysql"
-                ? "mysql:8"
-                : "alpine:latest";
-        return `version: "3.8"
-services:
+        const db = this.getDatabaseCompose(options);
+        const databaseUrl = this.getDatabaseUrl(options);
+        return `services:
   app:
     build: .
     ports:
       - "3000:3000"
     environment:
-      - DATABASE_URL=postgresql://postgres:postgres@db:5432/${options.projectName}
-    depends_on:
-      - db
-    develop:
+      - DATABASE_URL=${databaseUrl}
+${db ? "    depends_on:\n      - db\n" : ""}    develop:
       watch:
         - path: src/
           action: sync
           target: /app/src
-
-  db:
-    image: ${dbImage}
-    ports:
-      - "5432:5432"
-    environment:
-      - POSTGRES_USER=postgres
-      - POSTGRES_PASSWORD=postgres
-      - POSTGRES_DB=${options.projectName}
-    volumes:
-      - db-data:/var/lib/postgresql/data
-
-volumes:
-  db-data:
-`;
+${db ? `\n${this.getDbServiceBlock(db)}` : ""}`;
     }
     getDockerCompose(options) {
         const services = options.services ?? ["gateway"];
-        const dbImage = options.database === "postgresql"
-            ? "postgres:16-alpine"
-            : options.database === "mysql"
-                ? "mysql:8"
-                : "alpine:latest";
+        const db = this.getDatabaseCompose(options);
+        const databaseUrl = this.getDatabaseUrl(options);
         let serviceDefs = "";
-        for (const service of services) {
+        for (let i = 0; i < services.length; i++) {
+            const service = services[i];
+            const port = 3001 + i;
             serviceDefs += `
   ${service}:
     build:
-      context: apps/${service}
+      context: apps/services/${service}
     ports:
-      - "3000:3000"
+      - "${port}:${port}"
     environment:
-      - DATABASE_URL=postgresql://postgres:postgres@db:5432/${options.projectName}
-    depends_on:
-      - db
-`;
+      - PORT=${port}
+      - DATABASE_URL=${databaseUrl}
+${db ? "    depends_on:\n      - db\n" : ""}`;
         }
-        return `version: "3.8"
-services:${serviceDefs}
-  db:
-    image: ${dbImage}
-    ports:
-      - "5432:5432"
-    environment:
-      - POSTGRES_USER=postgres
-      - POSTGRES_PASSWORD=postgres
-      - POSTGRES_DB=${options.projectName}
-    volumes:
-      - db-data:/var/lib/postgresql/data
-
-volumes:
-  db-data:
-`;
+        return `services:${serviceDefs}${db ? `\n${this.getDbServiceBlock(db)}` : ""}`;
     }
 }
 //# sourceMappingURL=infrastructure.generator.js.map

package/dist/src/generators/integration/integrationGenerator.core.d.ts

@@ -22,6 +22,12 @@ export declare class IntegrationGenerator {
      */
     generate(context: IntegrationContext): Promise<void>;
     private generateEnvFile;
+    /**
+     * Path prefix (relative to projectPath) of the backend application.
+     *
+     * Ends with a "/" when non-empty so it can be prefixed directly.
+     */
+    private getBackendPath;
     private generateApiClient;
     private getApiClientPath;
     private generateCorsConfig;

package/dist/src/generators/integration/integrationGenerator.core.js

@@ -3,6 +3,8 @@
  *
  * @module generators/integration
  */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
 /**
  * Generates integration files between frontend and backend.
@@ -21,12 +23,22 @@ export class IntegrationGenerator {
             const apiPath = this.getApiClientPath(context);
             files[apiPath] = apiClient;
         }
-        // CORS configuration for backend
-        files["config/cors.ts"] = this.generateCorsConfig(context);
-        // Development proxy configuration
+        // CORS configuration, written next to the backend it configures. In a
+        // fullstack workspace the backend lives in apps/api; writing it at the
+        // workspace root left it where nothing could import it.
+        files[`${this.getBackendPath(context)}config/cors.ts`] =
+            this.generateCorsConfig(context);
+        // Development proxy configuration (belongs to the frontend app). The
+        // frontend adapter has already written a vite.config.ts carrying the
+        // framework plugin and path aliases; overwriting it with this minimal
+        // proxy-only config silently destroyed that work, so only create the
+        // file when the adapter did not.
         if (context.project.frontend?.framework === "react" ||
             context.project.frontend?.framework === "vue") {
-            files["vite.config.ts"] = this.generateViteProxy(context);
+            const viteConfigPath = "apps/web/vite.config.ts";
+            if (!existsSync(join(context.projectPath, viteConfigPath))) {
+                files[viteConfigPath] = this.generateViteProxy(context);
+            }
         }
         await writeFileTree(context.projectPath, files);
     }
@@ -38,6 +50,10 @@ export class IntegrationGenerator {
             `API_URL=http://localhost:${backendPort}`,
             "",
             "# Frontend",
+            // The frontend dev-server port was accepted, defaulted and then never
+            // written anywhere, so nothing downstream could agree with the CORS
+            // origins generated from the same value.
+            `FRONTEND_PORT=${frontendPort}`,
             `VITE_API_URL=http://localhost:${backendPort}`,
             "",
             "# Database",
@@ -51,6 +67,14 @@ export class IntegrationGenerator {
         }
         return lines.join("\n");
     }
+    /**
+     * Path prefix (relative to projectPath) of the backend application.
+     *
+     * Ends with a "/" when non-empty so it can be prefixed directly.
+     */
+    getBackendPath(context) {
+        return context.project.type === "fullstack" ? "apps/api/" : "";
+    }
     generateApiClient(context) {
         const backendPort = context.backendPort ?? 3000;
         const isNext = context.project.frontend?.framework === "next";
@@ -153,11 +177,16 @@ export const corsConfig = {
     }
     generateViteProxy(context) {
         const backendPort = context.backendPort ?? 3000;
+        const isVue = context.project.frontend?.framework === "vue";
+        const pluginImport = isVue
+            ? `import vue from "@vitejs/plugin-vue";`
+            : `import react from "@vitejs/plugin-react";`;
+        const pluginCall = isVue ? "vue()" : "react()";
         return `import { defineConfig } from "vite";
-import react from "@vitejs/plugin-react";
+${pluginImport}
 
 export default defineConfig({
-  plugins: [react()],
+  plugins: [${pluginCall}],
   server: {
     proxy: {
       "/api": {

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

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

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

@@ -4,17 +4,23 @@
  * Generates job files.
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
+import { normalizeName, toCamelCase } from "../../utils/utils.name.js";
 export async function generateJob(options, cwd) {
+    const name = normalizeName(options.name);
+    const nameCamel = toCamelCase(options.name);
     const files = {
-        [`${options.basePath}/jobs/${options.name}.job.ts`]: `/**
- * ${options.name} job.
+        [`${options.basePath}/jobs/${name}.job.ts`]: `/**
+ * ${name} job.
  */
 
-export async function ${options.name}Job() {
+export async function ${nameCamel}Job() {
   // Job implementation
 }
 `,
     };
+    if (options.dryRun) {
+        return Object.keys(files);
+    }
     await writeFileTree(cwd, files);
     return Object.keys(files);
 }

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

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

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

@@ -4,19 +4,25 @@
  * Generates middleware files.
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
+import { normalizeName, toCamelCase } from "../../utils/utils.name.js";
 export async function generateMiddleware(options, cwd) {
+    const name = normalizeName(options.name);
+    const nameCamel = toCamelCase(options.name);
     const files = {
-        [`${options.basePath}/middlewares/${options.name}.middleware.ts`]: `/**
- * ${options.name} middleware.
+        [`${options.basePath}/middlewares/${name}.middleware.ts`]: `/**
+ * ${name} middleware.
  */
 
-export function ${options.name}Middleware() {
-  return async (ctx: any, next: () => Promise<void>) => {
+export function ${nameCamel}Middleware() {
+  return async (ctx: unknown, next: () => Promise<void>) => {
     await next();
   };
 }
 `,
     };
+    if (options.dryRun) {
+        return Object.keys(files);
+    }
     await writeFileTree(cwd, files);
     return Object.keys(files);
 }

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

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

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

@@ -4,19 +4,25 @@
  * Generates model files.
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
+import { normalizeName, toPascalCase } from "../../utils/utils.name.js";
 export async function generateModel(options, cwd) {
+    const name = normalizeName(options.name);
+    const namePascal = toPascalCase(options.name);
     const files = {
-        [`${options.basePath}/models/${options.name}.model.ts`]: `/**
- * ${options.name} model.
+        [`${options.basePath}/models/${name}.model.ts`]: `/**
+ * ${name} model.
  */
 
-export interface ${options.name}Model {
+export interface ${namePascal}Model {
   readonly id: string;
   readonly createdAt: Date;
   readonly updatedAt: Date;
 }
 `,
     };
+    if (options.dryRun) {
+        return Object.keys(files);
+    }
     await writeFileTree(cwd, files);
     return Object.keys(files);
 }

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

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

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

@@ -3,21 +3,17 @@
  *
  * Generates a new feature module within a Zudojs project.
  */
-import { mkdir } from "node:fs/promises";
-import { join } from "node:path";
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
-import { CLIGenerationError, CLINotInProjectError, } from "../../errors/index.js";
+import { CLIGenerationError } from "../../errors/index.js";
+import { assertGeneratableName, toPascalCase } from "../../utils/utils.name.js";
 export async function generateModule(options, cwd) {
     const basePath = options.basePath ?? "modules";
-    const name = options.name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+    const name = assertGeneratableName(options.name, "module name");
+    const namePascal = toPascalCase(name);
     const files = {
         [`${basePath}/${name}/${name}.module.ts`]: `import { createLogger } from "@zudojs/logger";
 
-export class ${name
-            .replace(/-([a-z])/g, (_, c) => c.toUpperCase())
-            .charAt(0)
-            .toUpperCase() +
-            name.replace(/-([a-z])/g, (_, c) => c.toUpperCase()).slice(1)}Module {
+export class ${namePascal}Module {
   private readonly logger = createLogger({ name: "${name}-module" });
 
   id = "${name}-module";
@@ -27,11 +23,7 @@ export class ${name
   }
 }
 `,
-        [`${basePath}/${name}/index.ts`]: `export { ${name
-            .replace(/-([a-z])/g, (_, c) => c.toUpperCase())
-            .charAt(0)
-            .toUpperCase() +
-            name.replace(/-([a-z])/g, (_, c) => c.toUpperCase()).slice(1)}Module } from "./${name}.module.js";
+        [`${basePath}/${name}/index.ts`]: `export { ${namePascal}Module } from "./${name}.module.js";
 `,
     };
     if (options.feature) {
@@ -39,21 +31,16 @@ export class ${name
         files[`${basePath}/${name}/features/${featureName}.ts`] =
             `import { createLogger } from "@zudojs/logger";
 
-export class ${name
-                .replace(/-([a-z])/g, (_, c) => c.toUpperCase())
-                .charAt(0)
-                .toUpperCase() +
-                name.replace(/-([a-z])/g, (_, c) => c.toUpperCase()).slice(1)}Feature {
+export class ${namePascal}Feature {
   private readonly logger = createLogger({ name: "${name}-feature" });
 }
 `;
-        files[`${basePath}/${name}/features/index.ts`] = `export { ${name
-            .replace(/-([a-z])/g, (_, c) => c.toUpperCase())
-            .charAt(0)
-            .toUpperCase() +
-            name.replace(/-([a-z])/g, (_, c) => c.toUpperCase()).slice(1)}Feature } from "./${featureName}.js";
+        files[`${basePath}/${name}/features/index.ts`] = `export { ${namePascal}Feature } from "./${featureName}.js";
 `;
     }
+    if (options.dryRun) {
+        return Object.keys(files);
+    }
     try {
         await writeFileTree(cwd, files);
         return Object.keys(files);

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

@@ -1,12 +1,10 @@
 import { mkdir } from "node:fs/promises";
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
-import { execCommand } from "../../utils/utils.exec.js";
 import { CLI_VERSION } from "../../constants/index.js";
 import { generateMonolithFiles } from "../../templates/monolith/index.js";
 import { generateModularMonolithFiles } from "../../templates/modular-monolith/index.js";
 import { generateMicroserviceFiles } from "../../templates/microservice/index.js";
 import { CLIGenerationError } from "../../errors/index.js";
-import { getInstallCommand } from "../../installers/dependency.installer.js";
 export async function generateProject(options, basePath = ".") {
     let templateFiles;
     switch (options.architecture) {
@@ -36,27 +34,8 @@ export async function generateProject(options, basePath = ".") {
         throw new CLIGenerationError(`Failed to write project files:`, error);
     }
     const filesCreated = Object.keys(templateFiles);
-    if (options.initGit) {
-        try {
-            await execCommand("git", ["init"], projectPath);
-            await execCommand("git", ["config", "user.name", "Zudojs CLI"], projectPath);
-            await execCommand("git", ["config", "user.email", "cli@zudojs.dev"], projectPath);
-            await execCommand("git", ["add", "-A"], projectPath);
-            await execCommand("git", ["commit", "-m", "chore: initial commit from Zudojs CLI"], projectPath);
-        }
-        catch {
-            // Git operations are best-effort; non-fatal
-        }
-    }
-    if (options.installDeps) {
-        try {
-            const [installFile, ...installArgs] = getInstallCommand(options.packageManager);
-            await execCommand(installFile, installArgs, projectPath);
-        }
-        catch {
-            // Best-effort: project files are already created.
-        }
-    }
+    // Note: git initialization and dependency installation are orchestrated by
+    // the create command — this generator only writes project files.
     return {
         projectPath,
         filesCreated,

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

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

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

@@ -4,16 +4,19 @@
  * Generates a CQRS query with handler.
  */
 import { writeFileTree } from "../../utils/utils.fileSystem.js";
-import { CLIGenerationError, CLIValidationError } from "../../errors/index.js";
+import { CLIGenerationError } from "../../errors/index.js";
 import { normalizeName } from "../../utils/utils.name.js";
 export async function generateQuery(options, cwd) {
     const name = normalizeName(options.name);
     const nameCamel = name
         .replace(/-([a-z])/g, (_m, c) => c.toUpperCase())
         .replace(/^./, (c) => c.toUpperCase());
-    const service = options.service ?? "default";
+    const service = options.service;
     const basePath = options.basePath ?? "services";
-    const servicePath = `${basePath}/${service}`;
+    // When no service grouping is given the schematic is written directly under
+    // basePath. Callers that resolved the owning app into basePath (the
+    // microservice layout) pass no service, so the path is not nested twice.
+    const servicePath = service ? `${basePath}/${service}` : basePath;
     const files = {
         [`${servicePath}/queries/${name}/${name}.query.ts`]: `import type { BaseQuery } from "@zudojs/cqrs";
 
@@ -48,12 +51,15 @@ export class ${nameCamel}QueryHandler implements QueryHandler<${nameCamel}Query>
 export { ${nameCamel}QueryHandler } from "./${name}.handler.js";
 `,
     };
+    if (options.dryRun) {
+        return Object.keys(files);
+    }
     try {
         await writeFileTree(cwd, files);
         return Object.keys(files);
     }
     catch (error) {
-        throw new CLIGenerationError(`Failed to generate query: ${name} for service: ${service}`, error);
+        throw new CLIGenerationError(`Failed to generate query: ${name} in ${servicePath}`, error);
     }
 }
 //# sourceMappingURL=query.generator.js.map

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

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

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

@@ -1,17 +1,17 @@
 /**
  * zudojs-cli — Repository Generator
  */
-import { writeFileTree } from "../../utils/utils.fileSystem.js";
-import { CLIGenerationError, CLIValidationError } from "../../errors/index.js";
-import { normalizeName } from "../../utils/utils.name.js";
+import { writeFileTree, mergeBarrelExport, } from "../../utils/utils.fileSystem.js";
+import { CLIGenerationError } from "../../errors/index.js";
+import { normalizeName, toPascalCase } from "../../utils/utils.name.js";
 export async function generateRepository(options, cwd) {
     const name = normalizeName(options.name);
-    const nameCamel = name
-        .replace(/-([a-z])/g, (_m, c) => c.toUpperCase())
-        .replace(/^./, (c) => c.toUpperCase());
+    const nameCamel = toPascalCase(options.name);
     const basePath = options.basePath ?? "";
+    const prefix = basePath ? `${basePath}/` : "";
+    const indexPath = `${prefix}repositories/index.ts`;
     const files = {
-        [`${basePath ? `${basePath}/` : ""}repositories/${name}.repository.ts`]: `import { createLogger } from "@zudojs/logger";
+        [`${prefix}repositories/${name}.repository.ts`]: `import { createLogger } from "@zudojs/logger";
 
 export interface ${nameCamel}Entity {
   readonly id: string;
@@ -63,9 +63,12 @@ export class ${nameCamel}Repository {
   }
 }
 `,
-        [`${basePath ? `${basePath}/` : ""}repositories/index.ts`]: `export { ${nameCamel}Repository } from "./${name}.repository.js";
-`,
+        // Merge with any existing barrel content instead of overwriting it.
+        [indexPath]: mergeBarrelExport(cwd, indexPath, `export { ${nameCamel}Repository } from "./${name}.repository.js";`),
     };
+    if (options.dryRun) {
+        return Object.keys(files);
+    }
     try {
         await writeFileTree(cwd, files);
         return Object.keys(files);

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

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