@buenojs/bueno 0.8.9 → 0.8.11

package/dist/cli/commands/generate.js

@@ -0,0 +1,491 @@
+/**
+ * Generate Command
+ *
+ * Generate code artifacts (controllers, services, modules, etc.)
+ */
+import { getOption, hasFlag } from "../core/args";
+import { cliConsole, colors } from "../core/console";
+import { confirm, isInteractive } from "../core/prompt";
+import { spinner } from "../core/spinner";
+import { CLIError, CLIErrorType } from "../index";
+import { fileExists, getProjectRoot, isBuenoProject, joinPaths, processTemplate, writeFile, } from "../utils/fs";
+import { kebabCase } from "../utils/strings";
+import { defineCommand } from "./index";
+/**
+ * Generator aliases
+ */
+const GENERATOR_ALIASES = {
+    c: "controller",
+    s: "service",
+    m: "module",
+    gu: "guard",
+    i: "interceptor",
+    p: "pipe",
+    f: "filter",
+    d: "dto",
+    mw: "middleware",
+    mi: "migration",
+    j: "job",
+    jh: "job-handler",
+};
+/**
+ * Get template content for a generator type
+ */
+function getTemplate(type) {
+    const templates = {
+        controller: `import { Controller, Get, Post, Put, Delete{{#if path}} } from '@buenojs/bueno'{{/if}}{{#if service}}, { {{pascalCase service}}Service } from './{{kebabCase service}}.service'{{/if}};
+import type { Context } from '@buenojs/bueno';
+
+@Controller('{{path}}')
+export class {{pascalCase name}}Controller {
+  {{#if service}}
+  constructor(private readonly {{camelCase service}}Service: {{pascalCase service}}Service) {}
+  {{/if}}
+
+  @Get()
+  async findAll(ctx: Context) {
+    return { message: '{{pascalCase name}} controller' };
+  }
+
+  @Get(':id')
+  async findOne(ctx: Context) {
+    const id = ctx.params.id;
+    return { id, message: '{{pascalCase name}} item' };
+  }
+
+  @Post()
+  async create(ctx: Context) {
+    const body = await ctx.body();
+    return { message: 'Created', data: body };
+  }
+
+  @Put(':id')
+  async update(ctx: Context) {
+    const id = ctx.params.id;
+    const body = await ctx.body();
+    return { id, message: 'Updated', data: body };
+  }
+
+  @Delete(':id')
+  async remove(ctx: Context) {
+    const id = ctx.params.id;
+    return { id, message: 'Deleted' };
+  }
+}
+`,
+        service: `import { Injectable } from '@buenojs/bueno';
+
+@Injectable()
+export class {{pascalCase name}}Service {
+  async findAll() {
+    // TODO: Implement findAll
+    return [];
+  }
+
+  async findOne(id: string) {
+    // TODO: Implement findOne
+    return { id };
+  }
+
+  async create(data: unknown) {
+    // TODO: Implement create
+    return data;
+  }
+
+  async update(id: string, data: unknown) {
+    // TODO: Implement update
+    return { id, ...data };
+  }
+
+  async remove(id: string) {
+    // TODO: Implement remove
+    return { id };
+  }
+}
+`,
+        module: `import { Module } from '@buenojs/bueno';
+import { {{pascalCase name}}Controller } from './{{kebabCase name}}.controller';
+import { {{pascalCase name}}Service } from './{{kebabCase name}}.service';
+
+@Module({
+  controllers: [{{pascalCase name}}Controller],
+  providers: [{{pascalCase name}}Service],
+  exports: [{{pascalCase name}}Service],
+})
+export class {{pascalCase name}}Module {}
+`,
+        guard: `import { Injectable, type CanActivate, type Context } from '@buenojs/bueno';
+
+@Injectable()
+export class {{pascalCase name}}Guard implements CanActivate {
+  async canActivate(ctx: Context): Promise<boolean> {
+    // TODO: Implement guard logic
+    // Return true to allow access, false to deny
+    return true;
+  }
+}
+`,
+        interceptor: `import { Injectable, type NestInterceptor, type CallHandler, type Context } from '@buenojs/bueno';
+import type { Observable } from 'rxjs';
+
+@Injectable()
+export class {{pascalCase name}}Interceptor implements NestInterceptor {
+  async intercept(ctx: Context, next: CallHandler): Promise<Observable<unknown>> {
+    // Before handler execution
+    console.log('{{pascalCase name}}Interceptor - Before');
+
+    // Call the handler
+    const result = await next.handle();
+
+    // After handler execution
+    console.log('{{pascalCase name}}Interceptor - After');
+
+    return result;
+  }
+}
+`,
+        pipe: `import { Injectable, type PipeTransform, type Context } from '@buenojs/bueno';
+
+@Injectable()
+export class {{pascalCase name}}Pipe implements PipeTransform {
+  async transform(value: unknown, ctx: Context): Promise<unknown> {
+    // TODO: Implement transformation/validation logic
+    // Throw an error to reject the value
+    return value;
+  }
+}
+`,
+        filter: `import { Injectable, type ExceptionFilter, type Context } from '@buenojs/bueno';
+import type { Response } from '@buenojs/bueno';
+
+@Injectable()
+export class {{pascalCase name}}Filter implements ExceptionFilter {
+  async catch(exception: Error, ctx: Context): Promise<Response> {
+    // TODO: Implement exception handling
+    console.error('{{pascalCase name}}Filter caught:', exception);
+
+    return new Response(
+      JSON.stringify({
+        statusCode: 500,
+        message: 'Internal Server Error',
+        error: exception.message,
+      }),
+      {
+        status: 500,
+        headers: { 'Content-Type': 'application/json' },
+      }
+    );
+  }
+}
+`,
+        dto: `/**
+ * {{pascalCase name}} DTO
+ */
+export interface {{pascalCase name}}Dto {
+  // TODO: Define properties
+  id?: string;
+  createdAt?: Date;
+  updatedAt?: Date;
+}
+
+/**
+ * Create {{pascalCase name}} DTO
+ */
+export interface Create{{pascalCase name}}Dto {
+  // TODO: Define required properties for creation
+}
+
+/**
+ * Update {{pascalCase name}} DTO
+ */
+export interface Update{{pascalCase name}}Dto extends Partial<Create{{pascalCase name}}Dto> {
+  // TODO: Define optional properties for update
+}
+`,
+        middleware: `import type { Middleware, Context, Handler } from '@buenojs/bueno';
+
+/**
+ * {{pascalCase name}} Middleware
+ */
+export const {{camelCase name}}Middleware: Middleware = async (
+  ctx: Context,
+  next: Handler
+) => {
+  // Before handler execution
+  console.log('{{pascalCase name}}Middleware - Before');
+
+  // Call the next handler
+  const result = await next();
+
+  // After handler execution
+  console.log('{{pascalCase name}}Middleware - After');
+
+  return result;
+};
+`,
+        migration: `import { createMigration, type MigrationRunner } from '@buenojs/bueno/migrations';
+
+export default createMigration('{{migrationId}}', '{{migrationName}}')
+  .up(async (db: MigrationRunner) => {
+    // TODO: Add migration logic
+    // Example:
+    // await db.createTable({
+    //   name: '{{tableName}}',
+    //   columns: [
+    //     { name: 'id', type: 'uuid', primary: true },
+    //     { name: 'created_at', type: 'timestamp', default: 'NOW()' },
+    //   ],
+    // });
+  })
+  .down(async (db: MigrationRunner) => {
+    // TODO: Add rollback logic
+    // Example:
+    // await db.dropTable('{{tableName}}');
+  });
+`,
+        job: `export interface {{pascalCase name}}JobData {
+  // TODO: Define job data properties
+}
+
+export const {{camelCase name}} = (data: {{pascalCase name}}JobData) => ({
+  name: '{{camelCase name}}',
+  data,
+});
+`,
+        "job-handler": `import { type JobHandler } from '@buenojs/bueno/jobs';
+import type { {{pascalCase name}}JobData } from './{{kebabCase name}}.job';
+
+export const handle{{pascalCase name}}: JobHandler<{{pascalCase name}}JobData> = async (job) => {
+  const { data } = job;
+  // TODO: Implement job logic
+};
+`,
+    };
+    return templates[type];
+}
+/**
+ * Get file extension for generator type
+ */
+function getFileExtension(type) {
+    if (type === "dto")
+        return ".dto.ts";
+    if (type === "job")
+        return ".job.ts";
+    if (type === "job-handler")
+        return ".handler.ts";
+    return ".ts";
+}
+/**
+ * Get default directory for generator type
+ */
+function getDefaultDirectory(type) {
+    switch (type) {
+        case "controller":
+        case "service":
+        case "module":
+        case "dto":
+            return "modules";
+        case "guard":
+            return "common/guards";
+        case "interceptor":
+            return "common/interceptors";
+        case "pipe":
+            return "common/pipes";
+        case "filter":
+            return "common/filters";
+        case "middleware":
+            return "common/middleware";
+        case "migration":
+            return "database/migrations";
+        case "job":
+            return "modules/jobs";
+        case "job-handler":
+            return "modules/jobs/handlers";
+        default:
+            return "";
+    }
+}
+/**
+ * Generate a file
+ */
+async function generateFile(config) {
+    const { type, name, module, path: customPath, dryRun, force } = config;
+    // Get project root
+    const projectRoot = await getProjectRoot();
+    if (!projectRoot) {
+        throw new CLIError("Not in a Bueno project directory", CLIErrorType.NOT_FOUND);
+    }
+    // Determine file path
+    const kebabName = kebabCase(name);
+    const defaultDir = getDefaultDirectory(type);
+    let targetDir;
+    if (customPath) {
+        targetDir = joinPaths(projectRoot, customPath);
+    }
+    else if (module) {
+        targetDir = joinPaths(projectRoot, "server", defaultDir, kebabCase(module));
+    }
+    else if (type === "migration") {
+        targetDir = joinPaths(projectRoot, "server", defaultDir);
+    }
+    else {
+        targetDir = joinPaths(projectRoot, "server", defaultDir, kebabName);
+    }
+    const fileName = type === "migration"
+        ? `${generateMigrationId()}_${kebabName}${getFileExtension(type)}`
+        : `${kebabName}${getFileExtension(type)}`;
+    const filePath = joinPaths(targetDir, fileName);
+    // Check if file exists
+    if (!force && (await fileExists(filePath))) {
+        if (isInteractive()) {
+            const shouldOverwrite = await confirm(`File ${colors.cyan(filePath)} already exists. Overwrite?`, { default: false });
+            if (!shouldOverwrite) {
+                throw new CLIError("File already exists. Use --force to overwrite.", CLIErrorType.FILE_EXISTS);
+            }
+        }
+        else {
+            throw new CLIError(`File already exists: ${filePath}. Use --force to overwrite.`, CLIErrorType.FILE_EXISTS);
+        }
+    }
+    // Get template and process it
+    const template = getTemplate(type);
+    const content = processTemplate(template, {
+        name,
+        module: module ?? "",
+        path: customPath ?? kebabName,
+        service: type === "controller" ? name : "",
+        migrationId: generateMigrationId(),
+        migrationName: name,
+        tableName: kebabName,
+    });
+    // Write file or show dry run
+    if (dryRun) {
+        cliConsole.log(`\n${colors.bold("File:")} ${filePath}`);
+        cliConsole.log(colors.bold("Content:"));
+        cliConsole.log(content);
+        cliConsole.log("");
+    }
+    else {
+        await writeFile(filePath, content);
+    }
+    return filePath;
+}
+/**
+ * Generate migration ID
+ */
+function generateMigrationId() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, "0");
+    const day = String(now.getDate()).padStart(2, "0");
+    const hour = String(now.getHours()).padStart(2, "0");
+    const minute = String(now.getMinutes()).padStart(2, "0");
+    const second = String(now.getSeconds()).padStart(2, "0");
+    return `${year}${month}${day}${hour}${minute}${second}`;
+}
+/**
+ * Handle generate command
+ */
+async function handleGenerate(args) {
+    // Get generator type
+    const typeArg = args.positionals[0];
+    if (!typeArg) {
+        throw new CLIError("Generator type is required. Usage: bueno generate <type> <name>", CLIErrorType.INVALID_ARGS);
+    }
+    const type = GENERATOR_ALIASES[typeArg] ?? typeArg;
+    if (!getTemplate(type)) {
+        throw new CLIError(`Unknown generator type: ${typeArg}. Available types: controller, service, module, guard, interceptor, pipe, filter, dto, middleware, migration`, CLIErrorType.INVALID_ARGS);
+    }
+    // Get name
+    const name = args.positionals[1];
+    if (!name) {
+        throw new CLIError("Name is required. Usage: bueno generate <type> <name>", CLIErrorType.INVALID_ARGS);
+    }
+    // Get options
+    const config = {
+        type,
+        name,
+        module: getOption(args, "module", {
+            name: "module",
+            type: "string",
+            description: "",
+        }),
+        path: getOption(args, "path", {
+            name: "path",
+            type: "string",
+            description: "",
+        }),
+        dryRun: hasFlag(args, "dry-run"),
+        force: hasFlag(args, "force"),
+    };
+    // Check if in a Bueno project
+    if (!config.dryRun && !(await isBuenoProject())) {
+        throw new CLIError("Not in a Bueno project directory. Run this command from a Bueno project.", CLIErrorType.NOT_FOUND);
+    }
+    // Generate
+    const s = spinner(`Generating ${colors.cyan(type)} ${colors.cyan(name)}...`);
+    try {
+        const filePath = await generateFile(config);
+        if (config.dryRun) {
+            s.info("Dry run complete");
+        }
+        else {
+            s.success(`Created ${colors.green(filePath)}`);
+        }
+    }
+    catch (error) {
+        s.error();
+        throw error;
+    }
+}
+// Register the command
+defineCommand({
+    name: "generate",
+    alias: "g",
+    description: "Generate code artifacts (controllers, services, modules, etc.)",
+    positionals: [
+        {
+            name: "type",
+            required: true,
+            description: "Type of artifact to generate (controller, service, module, guard, interceptor, pipe, filter, dto, middleware, migration)",
+        },
+        {
+            name: "name",
+            required: true,
+            description: "Name of the artifact",
+        },
+    ],
+    options: [
+        {
+            name: "module",
+            alias: "m",
+            type: "string",
+            description: "Parent module to register with",
+        },
+        {
+            name: "path",
+            type: "string",
+            description: "Custom path for controller routes",
+        },
+        {
+            name: "dry-run",
+            type: "boolean",
+            default: false,
+            description: "Show what would be created without writing",
+        },
+        {
+            name: "force",
+            type: "boolean",
+            default: false,
+            description: "Overwrite existing files",
+        },
+    ],
+    examples: [
+        "bueno generate controller users",
+        "bueno g service auth",
+        "bueno g module posts",
+        "bueno g guard auth-guard --module auth",
+        "bueno g dto create-user --module users",
+    ],
+}, handleGenerate);
+//# sourceMappingURL=generate.js.map

package/dist/cli/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/help.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Help Command
+ *
+ * Display help information for commands
+ */
+export {};
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/help.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/cli/commands/help.js

@@ -0,0 +1,51 @@
+/**
+ * Help Command
+ *
+ * Display help information for commands
+ */
+import { generateGlobalHelpText, generateHelpText, hasFlag, } from "../core/args";
+import { cliConsole } from "../core/console";
+import { defineCommand } from "./index";
+import { registry } from "./index";
+defineCommand({
+    name: "help",
+    description: "Show help information for commands",
+    positionals: [
+        {
+            name: "command",
+            required: false,
+            description: "Command to show help for",
+        },
+    ],
+    options: [
+        {
+            name: "all",
+            alias: "a",
+            type: "boolean",
+            default: false,
+            description: "Show help for all commands",
+        },
+    ],
+}, async (args) => {
+    const commandName = args.positionals[0];
+    if (commandName && registry.has(commandName)) {
+        // Show help for specific command
+        const cmd = registry.get(commandName);
+        if (cmd) {
+            cliConsole.log(generateHelpText(cmd.definition));
+        }
+    }
+    else if (hasFlag(args, "all")) {
+        // Show detailed help for all commands
+        cliConsole.log("\nBueno CLI - Available Commands\n");
+        for (const cmd of registry.getAll()) {
+            cliConsole.log(generateHelpText(cmd));
+            cliConsole.log("---");
+        }
+    }
+    else {
+        // Show global help
+        cliConsole.log(generateGlobalHelpText(registry.getAll()));
+    }
+});
+//# sourceMappingURL=help.js.map

package/dist/cli/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/cli/commands/help.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,sBAAsB,EACtB,gBAAgB,EAChB,OAAO,GACP,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,aAAa,CACZ;IACC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,oCAAoC;IACjD,WAAW,EAAE;QACZ;YACC,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,0BAA0B;SACvC;KACD;IACD,OAAO,EAAE;QACR;YACC,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,4BAA4B;SACzC;KACD;CACD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACd,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAExC,IAAI,WAAW,IAAI,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,iCAAiC;QACjC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,CAAC;YACT,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QAClD,CAAC;IACF,CAAC;SAAM,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;QACjC,sCAAsC;QACtC,UAAU,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAErD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;SAAM,CAAC;QACP,mBAAmB;QACnB,UAAU,CAAC,GAAG,CAAC,sBAAsB,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;AACF,CAAC,CACD,CAAC"}

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Command Registry for Bueno CLI
+ *
+ * Manages command registration and execution
+ */
+import type { CommandDefinition, ParsedArgs } from "../core/args";
+/**
+ * Command handler function type
+ */
+export type CommandHandler = (args: ParsedArgs) => Promise<void> | void;
+/**
+ * Registered command
+ */
+export interface RegisteredCommand {
+    definition: CommandDefinition;
+    handler: CommandHandler;
+}
+/**
+ * Command registry
+ */
+declare class CommandRegistry {
+    private commands;
+    private aliases;
+    /**
+     * Register a command
+     */
+    register(definition: CommandDefinition, handler: CommandHandler): void;
+    /**
+     * Get a command by name or alias
+     */
+    get(name: string): RegisteredCommand | undefined;
+    /**
+     * Check if a command exists
+     */
+    has(name: string): boolean;
+    /**
+     * Get all command definitions
+     */
+    getAll(): CommandDefinition[];
+    /**
+     * Get all registered commands
+     */
+    getCommands(): Map<string, RegisteredCommand>;
+    /**
+     * Execute a command
+     */
+    execute(name: string, args: ParsedArgs): Promise<void>;
+}
+export declare const registry: CommandRegistry;
+/**
+ * Register a command (decorator-style)
+ */
+export declare function command(definition: CommandDefinition): (handler: CommandHandler) => void;
+/**
+ * Define a command with its handler
+ */
+export declare function defineCommand(definition: CommandDefinition, handler: CommandHandler): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;CACxB;AAED;;GAEG;AACH,cAAM,eAAe;IACpB,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,OAAO,CAAkC;IAEjD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAWtE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAKhD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1B;;OAEG;IACH,MAAM,IAAI,iBAAiB,EAAE;IAI7B;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAI7C;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAS5D;AAGD,eAAO,MAAM,QAAQ,iBAAwB,CAAC;AAE9C;;GAEG;AACH,wBAAgB,OAAO,CACtB,UAAU,EAAE,iBAAiB,GAC3B,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAInC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,cAAc,GACrB,IAAI,CAEN"}