@xeno-js/cli 0.1.3 → 0.1.4

package/eslint.config.mjs

@@ -1,306 +0,0 @@
-import eslint from '@eslint/js'
-import eslintConfigPrettier from 'eslint-config-prettier'
-import simpleImportSort from 'eslint-plugin-simple-import-sort'
-import tseslint from 'typescript-eslint'
-
-export default tseslint.config(
-  // ── Global ignores ───────────────────────────────────────────────────────
-  {
-    ignores: [
-      '**/node_modules/**',
-      '**/dist/**',
-      '**/coverage/**',
-      '.husky/**',
-      'eslint.config.mjs',
-      'lint-staged.config.mjs',
-      'commitlint.config.cjs',
-      'vitest.config.ts',
-      'tsup.config.ts',
-      'demo/**',
-      'packages/**',
-    ],
-  },
-
-  // ── Base configs ─────────────────────────────────────────────────────────
-  eslint.configs.recommended,
-  ...tseslint.configs.recommendedTypeChecked,
-  ...tseslint.configs.stylisticTypeChecked,
-
-  // ── Type-aware parser (project-wide) ─────────────────────────────────────
-  {
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.json', './tsconfig.test.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-    },
-  },
-
-  // ── Source + test rules ──────────────────────────────────────────────────
-  {
-    files: ['src/**/*.ts', 'tests/**/*.ts'],
-    plugins: {
-      'simple-import-sort': simpleImportSort,
-    },
-    rules: {
-      // ── Core JS ──────────────────────────────────────────────────────────
-      'curly': ['error', 'all'],
-      'eqeqeq': ['error', 'always', { null: 'ignore' }],
-      'no-console': ['error', { allow: ['warn', 'error', 'info', 'debug'] }],
-      // Disabled: the core rule does not understand TypeScript's `import type`
-      // and flags intentional type/value split imports from the same module.
-      // `@typescript-eslint/consistent-type-imports` already enforces correct usage.
-      'no-duplicate-imports': 'off',
-      'no-var': 'error',
-      'object-shorthand': ['error', 'always'],
-      'prefer-const': 'error',
-      'prefer-template': 'error',
-
-      // ── Import order ──────────────────────────────────────────────────────
-      'simple-import-sort/imports': 'error',
-      'simple-import-sort/exports': 'error',
-
-      // ── TypeScript: type-safe guarantees ──────────────────────────────────
-      '@typescript-eslint/consistent-type-exports': 'error',
-      '@typescript-eslint/consistent-type-imports': [
-        'error',
-        { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
-      ],
-      '@typescript-eslint/explicit-module-boundary-types': 'error',
-      '@typescript-eslint/no-floating-promises': 'error',
-      '@typescript-eslint/no-misused-promises': [
-        'error',
-        { checksVoidReturn: { attributes: false } },
-      ],
-      '@typescript-eslint/only-throw-error': 'error',
-      // '@typescript-eslint/return-await': ['error', 'in-try-catch'],
-      '@typescript-eslint/strict-boolean-expressions': [
-        'error',
-        {
-          allowString: false,
-          allowNumber: false,
-          allowNullableObject: false,
-          allowNullableBoolean: false,
-          allowNullableString: false,
-          allowNullableNumber: false,
-          allowAny: false,
-        },
-      ],
-      '@typescript-eslint/unbound-method': 'error',
-      '@typescript-eslint/no-unsafe-assignment': 'error',
-      '@typescript-eslint/no-unsafe-call': 'error',
-      '@typescript-eslint/no-unsafe-member-access': 'error',
-      '@typescript-eslint/no-unsafe-return': 'error',
-      '@typescript-eslint/no-unsafe-argument': 'error',
-      '@typescript-eslint/restrict-template-expressions': 'error',
-      '@typescript-eslint/restrict-plus-operands': 'error',
-      '@typescript-eslint/no-unsafe-enum-comparison': 'error',
-      '@typescript-eslint/require-await': 'off',
-      // ── TypeScript: code quality ──────────────────────────────────────────
-      '@typescript-eslint/no-shadow': 'error',
-      '@typescript-eslint/no-unused-vars': [
-        'error',
-        {
-          argsIgnorePattern: '^_',
-          varsIgnorePattern: '^_',
-          ignoreRestSiblings: true,
-        },
-      ],
-
-      // ── TypeScript: naming conventions ────────────────────────────────────
-      '@typescript-eslint/naming-convention': [
-        'error',
-        // Type constructs → PascalCase
-        { selector: 'typeLike', format: ['PascalCase'] },
-        // Enum members → UPPER_CASE (PascalCase tolerated for legacy)
-        { selector: 'enumMember', format: ['UPPER_CASE', 'PascalCase'] },
-        // Default catch-all → camelCase (leading _ allowed for intentionally unused)
-        {
-          selector: 'default',
-          format: ['camelCase'],
-          leadingUnderscore: 'allow',
-          trailingUnderscore: 'forbid',
-        },
-        // Variables: also allow UPPER_CASE for module-level constants, PascalCase for imported classes
-        {
-          selector: 'variable',
-          format: ['camelCase', 'UPPER_CASE', 'PascalCase'],
-          leadingUnderscore: 'allow',
-        },
-        // Imports: PascalCase (classes/namespaces) and camelCase (functions/values)
-        { selector: 'import', format: ['camelCase', 'PascalCase'] },
-        // Object literal properties: no restriction (external API / DB column mapping)
-        { selector: 'objectLiteralProperty', format: null },
-        // Destructured variables: no restriction (external sources)
-        { selector: 'variable', modifiers: ['destructured'], format: null },
-      ],
-
-      // ── Disabled / adjusted ───────────────────────────────────────────────
-      'dot-notation': 'off',
-      '@typescript-eslint/dot-notation': 'off',
-    },
-  },
-
-  // ── Test files: relax rules that conflict with test patterns ────────────
-  {
-    files: ['tests/**/*.ts'],
-    rules: {
-      '@typescript-eslint/explicit-module-boundary-types': 'off',
-      '@typescript-eslint/no-explicit-any': 'off',
-      '@typescript-eslint/no-non-null-assertion': 'off',
-    },
-  },
-
-  // ── Layered architecture boundaries (DDD / Clean Architecture) ─────────
-  {
-    files: ['src/shared/**/*.ts'],
-    rules: {
-      'no-restricted-imports': [
-        'error',
-        {
-          patterns: [
-            {
-              group: [
-                '@/domain',
-                '@/domain/**',
-                '@/application',
-                '@/application/**',
-                '@/infrastructure',
-                '@/infrastructure/**',
-                '@/presentation',
-                '@/presentation/**',
-              ],
-              message: 'shared can only import from shared and external libraries.',
-            },
-            {
-              group: [
-                '../**/domain',
-                '../**/domain/**',
-                '../**/application',
-                '../**/application/**',
-                '../**/infrastructure',
-                '../**/infrastructure/**',
-                '../**/presentation',
-                '../**/presentation/**',
-              ],
-              message: 'shared can only import from shared and external libraries.',
-            },
-          ],
-        },
-      ],
-    },
-  },
-  {
-    files: ['src/domain/**/*.ts'],
-    rules: {
-      'no-restricted-imports': [
-        'error',
-        {
-          patterns: [
-            {
-              group: [
-                '@/application',
-                '@/application/**',
-                '@/infrastructure',
-                '@/infrastructure/**',
-                '@/presentation',
-                '@/presentation/**',
-              ],
-              message: 'domain can only import from domain, shared, and external libraries.',
-            },
-            {
-              group: [
-                '../**/application',
-                '../**/application/**',
-                '../**/infrastructure',
-                '../**/infrastructure/**',
-                '../**/presentation',
-                '../**/presentation/**',
-              ],
-              message: 'domain can only import from domain, shared, and external libraries.',
-            },
-          ],
-        },
-      ],
-    },
-  },
-  {
-    files: ['src/application/**/*.ts'],
-    rules: {
-      'no-restricted-imports': [
-        'error',
-        {
-          patterns: [
-            {
-              group: [
-                '@/infrastructure',
-                '@/infrastructure/**',
-                '@/presentation',
-                '@/presentation/**',
-              ],
-              message:
-                'application can only import from application, domain, shared, and external libraries.',
-            },
-            {
-              group: [
-                '../**/infrastructure',
-                '../**/infrastructure/**',
-                '../**/presentation',
-                '../**/presentation/**',
-              ],
-              message:
-                'application can only import from application, domain, shared, and external libraries.',
-            },
-          ],
-        },
-      ],
-    },
-  },
-  {
-    files: ['src/infrastructure/**/*.ts'],
-    rules: {
-      'no-restricted-imports': [
-        'error',
-        {
-          patterns: [
-            {
-              group: ['@/presentation', '@/presentation/**'],
-              message:
-                'infrastructure can only import from infrastructure, domain, application, shared, and external libraries.',
-            },
-            {
-              group: ['../**/presentation', '../**/presentation/**'],
-              message:
-                'infrastructure can only import from infrastructure, domain, application, shared, and external libraries.',
-            },
-          ],
-        },
-      ],
-    },
-  },
-  {
-    files: ['src/presentation/**/*.ts'],
-    rules: {
-      'no-restricted-imports': [
-        'error',
-        {
-          patterns: [
-            {
-              group: ['@/infrastructure', '@/infrastructure/**'],
-              message:
-                'presentation can only import from presentation, domain, application, shared, and external libraries.',
-            },
-            {
-              group: ['../**/infrastructure', '../**/infrastructure/**'],
-              message:
-                'presentation can only import from presentation, domain, application, shared, and external libraries.',
-            },
-          ],
-        },
-      ],
-    },
-  },
-
-  // ── Prettier (must be last) ───────────────────────────────────────────────
-  eslintConfigPrettier,
-)

package/lint-staged.config.mjs

@@ -1,5 +0,0 @@
-export default {
-  'src/**/*.ts': ['eslint --config eslint.config.mjs --fix --max-warnings=0', 'prettier --write'],
-  '*.{json,md,yml,yaml,css,scss,html}': ['prettier --write'],
-  '*.{js,mjs,cjs}': ['prettier --write'],
-}

package/src/domain/contracts/icommand-cli.contracts.ts

@@ -1,13 +0,0 @@
-export interface ICliCommand {
-  /** Il nome principale del comando (es. 'new', 'generate') */
-  get name(): string
-
-  /** Eventuali alias (es. 'g' per 'generate') */
-  get aliases(): string[]
-
-  /**
-   * Il metodo esecutivo.
-   * Riceve solo gli argomenti di pertinenza (escludendo il nome del comando stesso).
-   */
-  execute(args: string[]): Promise<void>
-}

package/src/domain/contracts/icommand-runner.contracts.ts

@@ -1,3 +0,0 @@
-export interface ICommandRunner {
-  run(command: string, args: string[], cwd: string): Promise<void>
-}

package/src/domain/contracts/idispatch.contracts.ts

@@ -1,3 +0,0 @@
-export interface IDispatcher {
-  dispatch(rawArgs: string[]): Promise<void>
-}

package/src/domain/contracts/ifile-service.contracts.ts

@@ -1,3 +0,0 @@
-export interface IFileService {
-  writeFileRecursive(filePath: string, content: string): Promise<void>
-}

package/src/domain/contracts/igenerator.contracts.ts

@@ -1,5 +0,0 @@
-import { type BaseOptions, type ScaffoldingOptions } from '../../shared'
-
-export interface IGenerator<T extends BaseOptions = ScaffoldingOptions> {
-  generate(projectPath: string, options: T): Promise<void>
-}

package/src/domain/contracts/index.ts

@@ -1,6 +0,0 @@
-export type * from './icommand-cli.contracts'
-export type * from './icommand-runner.contracts'
-export type * from './idispatch.contracts'
-export type * from './ifile-service.contracts'
-export type * from './igenerator.contracts'
-export type * from './iscaffold-strategy.contracts'

package/src/domain/contracts/iscaffold-strategy.contracts.ts

@@ -1,7 +0,0 @@
-import { type BaseOptions, type ScaffoldingOptions } from '../../shared'
-import { type IGenerator } from './igenerator.contracts'
-
-export interface IScaffoldStrategy<T extends BaseOptions> {
-  promptOptions(targetDir: string): Promise<ScaffoldingOptions>
-  getGenerators(options: ScaffoldingOptions): Promise<IGenerator<T>[]>
-}

package/src/domain/index.ts

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

package/src/index.ts

@@ -1,30 +0,0 @@
-#!/usr/bin/env node
-import pc from 'picocolors'
-
-import { Builder } from './infrastructure/builder'
-
-/**
- * @function init
- * @description Initializes the scaffolding process for a new Xeno project.
- *
- * @author Xeno
- * @version 1.0.0
- * @license ISC
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-async function init() {
-  try {
-    const dispatcher = Builder.getDispatcher()
-
-    const rawArgs = process.argv.slice(2)
-
-    await dispatcher.dispatch(rawArgs)
-  } catch (error) {
-    console.error(pc.red('\n❌ Execution interrupted:'))
-    console.error(error instanceof Error ? error.message : error)
-    process.exit(1)
-  }
-}
-
-init().catch(console.error)

package/src/infrastructure/bootstrap/bootstrapper.ts

@@ -1,30 +0,0 @@
-// src/core/bootstrapper.ts
-import { mkdir } from 'node:fs/promises'
-import { resolve } from 'node:path'
-
-import pc from 'picocolors'
-
-import type { IGenerator } from '../../domain'
-import { type BaseOptions, type ScaffoldingOptions } from '../../shared'
-
-export class Bootstrapper<T extends BaseOptions = ScaffoldingOptions> {
-  constructor(private readonly _generators: IGenerator<T>[]) {}
-
-  public async run(projectPath: string, options: T): Promise<void> {
-    console.info(pc.cyan('\n🚀 Initializing scaffolding...'))
-
-    const absolutePath = resolve(process.cwd(), projectPath)
-    await mkdir(absolutePath, { recursive: true })
-
-    for (const generator of this._generators) {
-      try {
-        await generator.generate(absolutePath, options)
-      } catch (error) {
-        console.error(pc.red(`\n❌ Error during execution of ${generator.constructor.name}`))
-        throw error
-      }
-    }
-
-    console.info(pc.green('\n✨ Scaffolding completed succesfully!'))
-  }
-}

package/src/infrastructure/bootstrap/index.ts

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

package/src/infrastructure/builder/builder.test.ts

@@ -1,36 +0,0 @@
-import { describe, expect, it, vi } from 'vitest'
-
-import { GenerateCommandQuery, HelpCommand, NewProjectCommand } from '../commands'
-import { CliDispatcher } from '../dispatcher'
-import { Builder } from './builder'
-
-describe('Builder', () => {
-  it('should create a dispatcher with the CLI commands registered', () => {
-    const dispatcher = Builder.getDispatcher()
-
-    expect(dispatcher).toBeInstanceOf(CliDispatcher)
-  })
-
-  it('should dispatch the registered commands through the built dispatcher', async () => {
-    const dispatcher = Builder.getDispatcher()
-
-    const newSpy = vi.spyOn(NewProjectCommand.prototype, 'execute').mockResolvedValue()
-    const generateSpy = vi.spyOn(GenerateCommandQuery.prototype, 'execute').mockResolvedValue()
-    const helpSpy = vi.spyOn(HelpCommand.prototype, 'execute').mockResolvedValue()
-
-    await dispatcher.dispatch(['new', 'demo-app'])
-    await dispatcher.dispatch(['generate', 'command', 'User'])
-    await dispatcher.dispatch(['--help'])
-    await dispatcher.dispatch(['-h'])
-
-    expect(newSpy).toHaveBeenCalledWith(['demo-app'])
-    expect(generateSpy).toHaveBeenCalledWith(['command', 'User'])
-    expect(helpSpy).toHaveBeenCalledTimes(2)
-    expect(helpSpy).toHaveBeenNthCalledWith(1, [])
-    expect(helpSpy).toHaveBeenNthCalledWith(2, [])
-
-    newSpy.mockRestore()
-    generateSpy.mockRestore()
-    helpSpy.mockRestore()
-  })
-})

package/src/infrastructure/builder/builder.ts

@@ -1,15 +0,0 @@
-import { type IDispatcher } from '../../domain'
-import { GenerateCommandQuery, HelpCommand, NewProjectCommand } from '../commands'
-import { CliDispatcher } from '../dispatcher'
-
-export class Builder {
-  public static getDispatcher(): IDispatcher {
-    const dispatcher = new CliDispatcher([
-      new NewProjectCommand(),
-      new GenerateCommandQuery(),
-      new HelpCommand(),
-    ])
-
-    return dispatcher
-  }
-}

package/src/infrastructure/builder/index.ts

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

package/src/infrastructure/command_launcher/command.utils.ts

@@ -1,31 +0,0 @@
-// import { spawn } from 'node:child_process';
-
-// /**
-//  * @class CommandUtils
-//  * @description Utility class for executing shell commands in a cross-platform manner.
-//  *
-//  * @author Xeno
-//  * @version 1.0.0
-//  * @license ISC
-//  * @since 2025-09-30
-//  * @link https://github.com/xeno-js/xeno-js
-//  */
-// export const CommandLauncher = {
-//     runCommand: (command: string, args: string[], cwd: string): Promise<void> => {
-//         return new Promise((resolve, reject) => {
-//             const isWin = process.platform === "win32";
-//             const cmd = isWin ? `${command}.cmd` : command;
-
-//             const child = spawn(cmd, args, {
-//                 cwd,
-//                 stdio: 'inherit',
-//                 shell: true
-//             });
-
-//             child.on('close', (code) => {
-//                 if (code === 0) resolve();
-//                 else reject(new Error(`Command ${command} failed with code ${code}`));
-//             });
-//         });
-//     }
-// };

package/src/infrastructure/commands/command-runner.service.ts

@@ -1,36 +0,0 @@
-import { spawn } from 'node:child_process'
-
-import { type ICommandRunner } from '../../domain'
-
-/**
- * @class CommandUtils
- * @description Utility class for executing shell commands in a cross-platform manner.
- *
- * @author Xeno
- * @version 1.0.0
- * @license ISC
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-export class CommandRunner implements ICommandRunner {
-  public async run(command: string, args: string[], cwd: string, isWin = false): Promise<void> {
-    return new Promise((resolve, reject) => {
-      const cmd = isWin ? `${command}.cmd` : command
-
-      const child = spawn(cmd, args, {
-        cwd,
-        stdio: 'inherit',
-        shell: isWin,
-      })
-
-      child.on('error', (error) => {
-        reject(new Error(`Error during execution of the command ${command}: ${error.message}`))
-      })
-
-      child.on('close', (code) => {
-        if (code === 0) resolve()
-        else reject(new Error(`Command ${command} failed with code ${code}`))
-      })
-    })
-  }
-}

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

@@ -1,55 +0,0 @@
-import pc from 'picocolors'
-
-import type { ICliCommand } from '../../domain'
-import { Guards } from '../../shared'
-import { COMMAND_CONSTANTS } from '../../shared/constants/command.constants'
-import { FileUtils } from '../file'
-
-export class GenerateCommandQuery implements ICliCommand {
-  public readonly name: string = 'generate'
-  public readonly aliases: string[] = ['g']
-
-  public async execute(args: string[]): Promise<void> {
-    const type = args[0] // "command" o "query"
-    const componentName = args[1] // es: "User"
-    const isCore = args.includes('--core')
-    const isVue = args.includes('--vue')
-
-    if (Guards.isNullOrEmpty(type) || Guards.isNullOrEmpty(componentName)) {
-      throw new Error(`Invalid syntax. Usage: xeno-js g [command | query] <Name> [--core | --vue]`)
-    }
-
-    let outputPath: string | undefined = undefined
-    const outputIndex = args.findIndex((arg) => arg === '--output' || arg === '-o' || arg === '--o')
-    if (outputIndex !== -1 && args.length > outputIndex + 1) {
-      outputPath = args[outputIndex + 1]
-    }
-
-    const targetDir = process.cwd()
-    const fileService = new FileUtils()
-
-    if (isCore || !isVue) {
-      const cqrsType =
-        type === COMMAND_CONSTANTS.COMMAND ? COMMAND_CONSTANTS.COMMAND : COMMAND_CONSTANTS.QUERY
-      const { CqrsGenerator } = await import('../generators/core/command/cqrs.generator.js')
-      const generator = new CqrsGenerator(fileService)
-
-      await generator.generate(targetDir, componentName, cqrsType, outputPath)
-
-      console.info(pc.green(`\n  Successfully generated ${type} component '${componentName}'!`))
-    } else if (isVue) {
-      const cqrsType =
-        type === COMMAND_CONSTANTS.COMMAND ? COMMAND_CONSTANTS.COMMAND : COMMAND_CONSTANTS.QUERY
-      const { CqrsVueGenerator } = await import('../generators/vue/command_query/cqrs.generator.js')
-      const generator = new CqrsVueGenerator(fileService)
-
-      await generator.generate(targetDir, componentName, cqrsType, outputPath)
-
-      console.info(
-        pc.green(`\n✅ Successfully generated Vue ${type} component '${componentName}'!`),
-      )
-    } else {
-      throw new Error(`Unsupported generator type: '${type}'. Use 'command' or 'query'.`)
-    }
-  }
-}