@xeno-js/cli 0.1.3 → 0.1.4

package/src/infrastructure/commands/help.command.ts

@@ -1,63 +0,0 @@
-import pc from 'picocolors'
-
-import type { ICliCommand } from '../../domain'
-import { ARGS_CONSTANTS, COMMAND_CONSTANTS } from '../../shared'
-
-export class HelpCommand implements ICliCommand {
-  public get name(): string {
-    return COMMAND_CONSTANTS.HELP
-  }
-  public get aliases(): string[] {
-    return [ARGS_CONSTANTS.HELP, '-h']
-  }
-
-  public async execute(): Promise<void> {
-    console.info(pc.greenBright('\n🚀 Xeno CLI - Usage Guide\n'))
-
-    // --- NEW PROJECT ---
-    console.info(pc.bold(pc.blue('1. Create a new project:')))
-    console.info(`  xeno-js new ${pc.yellow('<name>')} ${pc.cyan('[--vue | --core]')}`)
-    console.info(`  ${pc.gray('•')} ${pc.yellow('<name>')}: The name of your project directory.`)
-    console.info(
-      `  ${pc.gray('•')} ${pc.cyan('[--vue | --core]')}: Project type. ${pc.gray('(Default: --core)')}`,
-    )
-    console.info(`    - ${pc.cyan('--core')}: Initializes a Backend project (Node.js/TS).`)
-    console.info(`    - ${pc.cyan('--vue')}: Initializes a Frontend project (Vue.js).\n`)
-
-    // --- GENERATE ---
-    console.info(pc.bold(pc.blue('2. Generate CQRS components:')))
-    console.info(
-      `  xeno-js generate ${pc.magenta('<type>')} ${pc.yellow('<Name>')} ${pc.cyan('[--vue | --core]')} ${pc.green('[--output <path>]')}`,
-    )
-    console.info(
-      `  ${pc.gray('•')} ${pc.magenta('<type>')}: Component type to generate (${pc.magenta('command')} | ${pc.magenta('query')}).`,
-    )
-    console.info(
-      `  ${pc.gray('•')} ${pc.yellow('<Name>')}: The name of the component (e.g., UserCreate).`,
-    )
-    console.info(
-      `  ${pc.gray('•')} ${pc.cyan('[--vue | --core]')}: Target context. ${pc.gray('(Default: --core)')}`,
-    )
-    console.info(
-      `    - ${pc.cyan('--core')}: Generates Controller, Handler, Command/Query, Module, and Zod/DB schemas.`,
-    )
-    console.info(
-      `    - ${pc.cyan('--vue')}: Generates frontend-specific files (Stores, Services, etc.).`,
-    )
-    console.info(
-      `  ${pc.gray('•')} ${pc.green('[--output | -o]')}: Custom destination path inside 'src/'. ${pc.gray('(Default: src/<name-in-lowercase>)')}`,
-    )
-    console.info(
-      `  ${pc.gray('Alias:')} ${pc.gray('xeno-js g <type> <Name> [--vue | --core] [-o | --o <path>]')}\n`,
-    )
-
-    // --- HELP ---
-    console.info(pc.bold(pc.blue('3. Help:')))
-    console.info(`  xeno-js --help     ${pc.gray('Displays this guide.')}`)
-    console.info(`  ${pc.gray('Alias:')} ${pc.gray('xeno-js --h | -h')}\n`)
-
-    // --- DOCS ---
-    console.info(pc.bold(pc.blue('Documentation:')))
-    console.info(`  ${pc.underline('https://www.xeno-js.it')}\n`)
-  }
-}

package/src/infrastructure/commands/index.ts

@@ -1,4 +0,0 @@
-export * from './command-runner.service'
-export * from './generate.command'
-export * from './help.command'
-export * from './new-project.command'

package/src/infrastructure/commands/new-project.command.ts

@@ -1,47 +0,0 @@
-import pc from 'picocolors'
-
-import type { ICliCommand } from '../../domain'
-import type { IScaffoldStrategy } from '../../domain'
-import { type ScaffoldingOptions } from '../../shared'
-import { Bootstrapper } from '../bootstrap'
-import { FileUtils } from '../file'
-import { CommandRunner } from './command-runner.service'
-
-export class NewProjectCommand implements ICliCommand {
-  public readonly name: string = 'new'
-  public readonly aliases: string[] = []
-
-  public async execute(args: string[]): Promise<void> {
-    const targetDir = args.find((arg) => !arg.startsWith('--')) ?? 'my-xeno-app'
-    const isVue = args.includes('--vue')
-    const fileService = new FileUtils()
-
-    let strategy: IScaffoldStrategy<ScaffoldingOptions>
-
-    if (isVue) {
-      const { VueScaffoldStrategy } = await import('../strategies/vue-scaffold.strategy.js')
-      strategy = new VueScaffoldStrategy(fileService)
-    } else {
-      const { CoreScaffoldStrategy } = await import('../strategies/core-scaffold.strategy.js')
-      strategy = new CoreScaffoldStrategy(fileService)
-    }
-
-    const options = await strategy.promptOptions(targetDir)
-
-    const generators = await strategy.getGenerators(options)
-    const bootstrapper = new Bootstrapper(generators)
-    await bootstrapper.run(targetDir, options)
-
-    const commandRunner = new CommandRunner()
-    if (options.gitInit) {
-      console.info(pc.greenBright('\n🗂️ Initializing Git repository...'))
-      await commandRunner.run('git', ['init'], targetDir)
-    }
-    console.info(pc.greenBright('\n📦 Installing dependencies...'))
-    const isWin = process.platform === 'win32'
-    await commandRunner.run('npm', ['install'], targetDir, isWin)
-
-    console.info(pc.green(`\n✅ Project successfully created in ./${targetDir}`))
-    console.info(pc.white(`\nNext steps:\n  cd ${targetDir}\n  npm run start\n`))
-  }
-}

package/src/infrastructure/dispatcher/dispatcher.ts

@@ -1,45 +0,0 @@
-import pc from 'picocolors'
-
-import type { ICliCommand, IDispatcher } from '../../domain'
-import { ARGS_CONSTANTS, COMMAND_CONSTANTS, Guards } from '../../shared'
-
-export class CliDispatcher implements IDispatcher {
-  private readonly _commands = new Map<string, ICliCommand>()
-
-  constructor(commands: ICliCommand[]) {
-    for (const command of commands) {
-      this._commands.set(command.name, command)
-      for (const alias of command.aliases) {
-        this._commands.set(alias, command)
-      }
-    }
-  }
-
-  public async dispatch(rawArgs: string[]): Promise<void> {
-    const action = rawArgs[0]
-
-    if (
-      !Guards.isDefined(action) ||
-      action === ARGS_CONSTANTS.HELP ||
-      action === '-h' ||
-      action === '--h'
-    ) {
-      const helpCommand = this._commands.get(COMMAND_CONSTANTS.HELP)
-      await helpCommand?.execute([])
-      return
-    }
-
-    const command = this._commands.get(action)
-
-    if (!Guards.isDefined(command)) {
-      console.error(pc.red(`\n❌ '${action}' is not a command`))
-      console.info(
-        pc.yellow(`See 'xeno-js --help' for cli usage guide or https://www.xeno-js.it for docs.\n`),
-      )
-      process.exit(1)
-    }
-
-    const commandArgs = rawArgs.slice(1)
-    await command.execute(commandArgs)
-  }
-}

package/src/infrastructure/dispatcher/index.ts

@@ -1 +0,0 @@
-export * from './dispatcher'

package/src/infrastructure/file/file.service.ts

@@ -1,14 +0,0 @@
-import { mkdir, writeFile } from 'fs/promises'
-import { dirname } from 'path'
-
-import { type IFileService } from '../../domain'
-
-export class FileUtils implements IFileService {
-  public async writeFileRecursive(filePath: string, content: string): Promise<void> {
-    const dir = dirname(filePath)
-
-    await mkdir(dir, { recursive: true })
-
-    await writeFile(filePath, content, 'utf8')
-  }
-}

package/src/infrastructure/file/index.ts

@@ -1 +0,0 @@
-export * from './file.service'

package/src/infrastructure/generators/core/bootstrap.generator.ts

@@ -1,118 +0,0 @@
-import path from 'node:path'
-
-import { type IFileService, type IGenerator } from '../../../domain'
-import { CORE_CONSTANTS, type CoreOptions } from '../../../shared'
-
-export class BootstrapGenerator implements IGenerator<CoreOptions> {
-  constructor(private readonly _fileService: IFileService) {}
-
-  public async generate(projectPath: string, options: CoreOptions): Promise<void> {
-    // Costruisce in modo flessibile i nodi di configurazione
-    let builderNodes = `
-  const builder = new AppBuilder<MyRegistry>()
-    .addContext()
-    .addMiddlewares((opts) => {
-      // Add your options here
-    })
-    .addPipeline((opts) => {
-      // Add your options here
-    })`
-
-    if (options.database !== CORE_CONSTANTS.NONE) {
-      if (options.database === CORE_CONSTANTS.DRIZZLE) {
-        builderNodes += `
-        .addDb((opts, config) => {
-          opts.enableSqlLite = false
-          opts.connectionString = config.getOrThrow('DATABASE_URL');
-        })`
-      } else if (options.database === CORE_CONSTANTS.SQL_LITE) {
-        builderNodes += `
-        .addDb((opts, config) => {
-          opts.enableSqlLite = true;
-          opts.connectionString = config.getOrThrow('SQLITE_DATABASE_URL');
-        })`
-      }
-    }
-
-    if (options.redis) {
-      builderNodes += `
-    .addCache((opts, config) => {
-      const isDev = config.get('NODE_ENV') === 'development';
-      opts.inMemory = isDev;
-      opts.redis = !isDev ? {
-        host: config.getOrThrow('REDIS_HOST'),
-        port: config.getNumber('REDIS_PORT') ?? 6379,
-        username: config.get('REDIS_USERNAME') ?? '',
-        password: config.get('REDIS_PASSWORD') ?? '',
-        tls: config.getBoolean('REDIS_TLS') ?? false,
-        maxRetriesPerRequest: 3
-      } : undefined
-    })`
-    } else {
-      // Default in-memory cache if no redis selected but CQRS pipeline exists
-      builderNodes += `
-    .addCache((opts) => {
-      opts.inMemory = true;
-    })`
-    }
-
-    if (options.supabase) {
-      builderNodes += `
-    .addAuth((opts, config) => {
-      opts.url = config.getOrThrow('SUPABASE_URL');
-      opts.key = config.getOrThrow('SUPABASE_KEY');
-    })`
-    }
-
-    if (options.pino || options.sentry) {
-      const pinoConfig = options.pino
-        ? `opts.pino.config = !isDev ? { env: config.getOrThrow('NODE_ENV'), destination: 'stdout', prettyPrint: false } : undefined;`
-        : ''
-      const sentryConfig = options.sentry
-        ? `opts.sentry.config = !isDev ? { dsn: config.getOrThrow('SENTRY_DSN'), environment: config.getOrThrow('NODE_ENV') } : undefined;`
-        : ''
-
-      builderNodes += `
-    .addLogger((opts, config) => {
-      const isDev = config.get('NODE_ENV') === 'development';
-      opts.level = LOG_LEVEL.INFO;
-      opts.console = isDev;
-      ${pinoConfig}
-      ${sentryConfig}
-    })`
-    }
-
-    builderNodes += `
-    .addServices((opts, config) => {
-      // Register custom repositories and handlers here
-    });`
-
-    const content = `import type { IServiceContainer } from '@xeno-js/core';
-import { AppBuilder, LOG_LEVEL, Nullable, TOKENS } from '@xeno-js/core';
-import type { MyRegistry } from './registry';
-
-let containerPromise: Nullable<Promise<IServiceContainer<MyRegistry>>> = null;
-
-export async function bootstrap() {
-  if (!containerPromise) {
-    containerPromise = (async () => {
-      const builder = getContainer();
-      return await builder.build();
-    })().catch((err) => {
-      containerPromise = null;
-      throw err;
-    });
-  }
-  return containerPromise;
-}
-
-function getContainer() {
-${builderNodes}
-  return builder;
-}
-`
-
-    const filePath = path.join(projectPath, 'src', 'bootstrap.ts')
-    await this._fileService.writeFileRecursive(filePath, content)
-  }
-}

package/src/infrastructure/generators/core/command/cqrs.generator.ts

@@ -1,63 +0,0 @@
-import fs from 'node:fs/promises'
-import path from 'node:path'
-
-import type { IFileService } from '../../../../domain'
-import { COMMAND_CONSTANTS, Guards, StringUtils } from '../../../../shared'
-
-export class CqrsGenerator {
-  constructor(private readonly _fileService: IFileService) {}
-
-  public async generate(
-    targetDir: string,
-    name: string,
-    type: 'command' | 'query',
-    outputPath?: string,
-  ): Promise<void> {
-    const pascalName = StringUtils.pascalCase(name)
-    const tokenPrefix = StringUtils.splitCamelCaseWithUnderscore(pascalName).toUpperCase()
-    const lowerName = name.toLowerCase()
-    const destinationFolder = outputPath ?? lowerName
-    const componentDir = path.join(targetDir, 'src', destinationFolder)
-
-    let hasZod = false
-    let hasDrizzle = false
-
-    try {
-      const pkgJsonStr = await fs.readFile(path.join(targetDir, 'package.json'), 'utf8')
-      const pkgJson = JSON.parse(pkgJsonStr) as {
-        dependencies?: Record<string, string>
-        devDependencies?: Record<string, string>
-      }
-      const deps = { ...(pkgJson.dependencies ?? {}), ...(pkgJson.devDependencies ?? {}) }
-      hasZod = !!Guards.isDefined(deps['zod'])
-      hasDrizzle = !!Guards.isDefined(deps['drizzle-orm'])
-    } catch (error) {
-      console.warn(
-        '  Warning: Could not read package.json. Assuming Zod and Drizzle are not installed.',
-        error,
-      )
-    }
-
-    switch (type) {
-      case COMMAND_CONSTANTS.COMMAND: {
-        const { GenerateCommandCoreGenerator } = await import('./generate-command.generator.js')
-        const generator = new GenerateCommandCoreGenerator(this._fileService)
-        return generator.generate(
-          pascalName,
-          lowerName,
-          tokenPrefix,
-          componentDir,
-          hasZod,
-          hasDrizzle,
-        )
-      }
-      case COMMAND_CONSTANTS.QUERY: {
-        const { GenerateQueryCoreGenerator } = await import('./generate-query.generator.js')
-        const generatorQuery = new GenerateQueryCoreGenerator(this._fileService)
-        return generatorQuery.generate(pascalName, lowerName, tokenPrefix, componentDir, hasZod)
-      }
-      default:
-        throw new Error(`Unsupported generator type: '${String(type)}'. Use 'command' or 'query'.`)
-    }
-  }
-}

package/src/infrastructure/generators/core/command/generate-command.generator.ts

@@ -1,191 +0,0 @@
-import path from 'node:path'
-
-import type { IFileService } from '../../../../domain'
-
-export class GenerateCommandCoreGenerator {
-  constructor(private readonly _fileService: IFileService) {}
-
-  public async generate(
-    pascalName: string,
-    lowerName: string,
-    tokenPrefix: string,
-    componentDir: string,
-    hasZod: boolean,
-    hasDrizzle: boolean,
-  ): Promise<void> {
-    // 1. Command
-    const commandContent = `import { Command } from '@xeno-js/core';
-
-/*
- * ⚠️ WARNING: ACTION REQUIRED ⚠️
- * Please replace <any> with your specific payload and response types.
- */
-export class ${pascalName}Command extends Command<any> {
-    constructor(public readonly payload: any) {
-        super('${tokenPrefix}_COMMAND_HANDLER');
-    }
-}
-`
-    await this._fileService.writeFileRecursive(
-      path.join(componentDir, `${lowerName}.command.ts`),
-      commandContent,
-    )
-
-    // 2. Handler
-    const handlerContent = `import type { IFactory, ResultType, UserContext } from '@xeno-js/core';
-import { AppError, BaseHandler, Result } from '@xeno-js/core';
-import { ${pascalName}Command } from './${lowerName}.command';
-
-/*
- * ⚠️ WARNING: ACTION REQUIRED ⚠️
- * Please replace <any> with your specific response type.
- */
-export class ${pascalName}Handler extends BaseHandler<${pascalName}Command, any> {
-    constructor(
-        identityFactory: IFactory<void, UserContext>
-    ) {
-        super(identityFactory);
-    }
-
-    public async executeAsync(request: ${pascalName}Command, singal: AbortSignal): Promise<ResultType<any>> {
-        // TODO: Implement your business logic here
-
-        return Result.ok();
-    }
-}
-`
-    await this._fileService.writeFileRecursive(
-      path.join(componentDir, `${lowerName}.handler.ts`),
-      handlerContent,
-    )
-
-    // 3. Controller
-    const controllerContent = `import type { IContextAccessor, IMediator, RequestContext, ResponseDto } from '@xeno-js/core';
-import { BaseController } from '@xeno-js/core';
-import { ${pascalName}Command } from './${lowerName}.command';
-
-/*
- * ⚠️ WARNING: ACTION REQUIRED ⚠️
- * Please replace <any, any> with your specific request and response types.
- */
-export class ${pascalName}Controller extends BaseController<any, any> {
-    constructor(
-        requestContext: IContextAccessor<RequestContext>,
-        mediator: IMediator,
-    ) {
-        super(requestContext, mediator);
-    }
-
-    public async handle(request: any): Promise<ResponseDto<any>> {
-        const cmd = new ${pascalName}Command(request);
-        const result = await this._send(cmd);
-
-        if (!result.isOk()) {
-            return this.fail(result.getErrorOrThrow(), 'Error during ${pascalName} operation');
-        }
-
-        return this.ok(result.getValueOrThrow());
-    }
-}
-`
-    await this._fileService.writeFileRecursive(
-      path.join(componentDir, `${lowerName}.controller.ts`),
-      controllerContent,
-    )
-
-    // 4. Entity
-    const entityContent = `import { Entity } from '@xeno-js/core';
-
-export interface ${pascalName}Props {
-    // TODO: Define your entity properties
-}
-
-/*
- * ⚠️ WARNING: ACTION REQUIRED ⚠️
- * Adjust the properties and types according to your domain logic.
- */
-export class ${pascalName} extends Entity<${pascalName}Props> {
-    private constructor(props: ${pascalName}Props, id?: string) {
-        super(props, id);
-    }
-
-    static create(props: ${pascalName}Props, id?: string): ${pascalName} {
-        return new ${pascalName}(props, id);
-    }
-}
-`
-    await this._fileService.writeFileRecursive(
-      path.join(componentDir, `${lowerName}.entity.ts`),
-      entityContent,
-    )
-
-    // 5. Schema Zod (Condizionale)
-    if (hasZod) {
-      const zodContent = `import { z } from 'zod';
-import { ZodUtils } from '@xeno-js/core';
-
-/*
- * ⚠️ WARNING: ACTION REQUIRED ⚠️
- * Define the actual Zod validation schema for your command payload.
- */
-export const ${pascalName}Schema = ZodUtils.createCommandSchema({
-    payload: z.any() // TODO: Update with strict validation
-});
-`
-      await this._fileService.writeFileRecursive(
-        path.join(componentDir, `${lowerName}.schema-zod.ts`),
-        zodContent,
-      )
-    }
-
-    // 6. Schema DB (Condizionale)
-    if (hasDrizzle) {
-      const dbContent = `import { pgTable, text, timestamp } from 'drizzle-orm/pg-core';
-// Note: If you are using SQLite, change the import to 'drizzle-orm/sqlite-core' and update the table definition.
-
-/*
- * ⚠️ WARNING: ACTION REQUIRED ⚠️
- * Update the schema definition with your actual database columns.
- */
-export const ${lowerName}s = pgTable('${lowerName}s', {
-    id: text('id').primaryKey(),
-    createdAt: timestamp('created_at').defaultNow(),
-    updatedAt: timestamp('updated_at').defaultNow().$onUpdate(() => new Date()),
-});
-
-export type ${pascalName}Dto = typeof ${lowerName}s.$inferSelect;
-export type New${pascalName}Dto = typeof ${lowerName}s.$inferInsert;
-`
-      await this._fileService.writeFileRecursive(
-        path.join(componentDir, `${lowerName}.schema-db.ts`),
-        dbContent,
-      )
-    }
-
-    // 7. Module
-    const moduleContent = `import type { IServiceContainer, IConfigurationService } from '@xeno-js/core';
-import { TOKENS } from '@xeno-js/core';
-import { ${pascalName}Controller } from './${lowerName}.controller';
-import { ${pascalName}Handler } from './${lowerName}.handler';
-
-export const ${pascalName}Module = Object.freeze({
-    register(opts: IServiceContainer<any>, _config: IConfigurationService): void {
-        opts.addTransient('${tokenPrefix}_COMMAND_CONTROLLER', (c) => new ${pascalName}Controller(c.resolve(TOKENS.REQUEST_CONTEXT), c.resolve(TOKENS.MEDIATOR)));
-        opts.addScoped('${tokenPrefix}_COMMAND_HANDLER', (c) => new ${pascalName}Handler(c.resolve(TOKENS.USER_CONTEXT_FACTORY)));
-
-        /*
-         * ⚠️ WARNING: ACTION REQUIRED ⚠️
-         * Please copy and paste the following tokens to your MyRegistry interface (usually in src/registry.ts):
-         *
-         * ${tokenPrefix}_COMMAND_CONTROLLER: IController<any, any>;
-         * ${tokenPrefix}_COMMAND_HANDLER: IHandler<${pascalName}Command, any>;
-         */
-    }
-} as const);
-`
-    await this._fileService.writeFileRecursive(
-      path.join(componentDir, `${lowerName}.module.ts`),
-      moduleContent,
-    )
-  }
-}