@xeno-js/cli 0.1.3 → 0.1.4

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

@@ -1,150 +0,0 @@
-import path from 'node:path'
-
-import type { IFileService } from '../../../../domain'
-
-export class GenerateQueryCoreGenerator {
-  constructor(private readonly _fileService: IFileService) {}
-
-  public async generate(
-    pascalName: string,
-    lowerName: string,
-    tokenPrefix: string,
-    componentDir: string,
-    hasZod: boolean,
-  ): Promise<void> {
-    const queryContent = `import { BaseQuery } from '@xeno-js/core';
-
-/*
- * ⚠️ WARNING: ACTION REQUIRED ⚠️
- * Please replace <any> with your specific payload and response types.
- */
-export class ${pascalName}Query extends BaseQuery<any> {
-    constructor(public readonly payload: any) {
-        super(
-            '${tokenPrefix}_QUERY_HANDLER', 
-            // Default cache options:
-            {
-                ttl: 60,
-                cacheKey: \`${lowerName}:\${JSON.stringify(payload)}\`,
-                bypassCache: false,
-                consistentRead: false
-                isUserScoped: false,
-            }
-        );
-    }
-}
-`
-    await this._fileService.writeFileRecursive(
-      path.join(componentDir, `${lowerName}.query.ts`),
-      queryContent,
-    )
-
-    // 2. Handler
-    const handlerContent = `import type { IFactory, ResultType, UserContext } from '@xeno-js/core';
-import { AppError, BaseHandler, Result } from '@xeno-js/core';
-import { ${pascalName}Query } from './${lowerName}.query';
-
-/*
- * ⚠️ WARNING: ACTION REQUIRED ⚠️
- * Please replace <any> with your specific response type.
- */
-export class ${pascalName}Handler extends BaseHandler<${pascalName}Query, any> {
-    constructor(
-        identityFactory: IFactory<void, UserContext>
-        // TODO: Inject your ReadDao or DataSource here
-    ) {
-        super(identityFactory);
-    }
-
-    public async executeAsync(request: ${pascalName}Query, singal: AbortSignal): Promise<ResultType<any>> {
-        // TODO: Implement your query 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}Query } from './${lowerName}.query';
-
-/*
- * ⚠️ 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 query = new ${pascalName}Query(request);
-        const result = await this._query(query);
-
-        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. Schema Zod
-    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 query payload.
- */
-export const ${pascalName}Schema = ZodUtils.createQuerySchema({
-    payload: z.any() // TODO: Update with strict validation
-});
-`
-      await this._fileService.writeFileRecursive(
-        path.join(componentDir, `${lowerName}.schema-zod.ts`),
-        zodContent,
-      )
-    }
-
-    // 5. 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}_QUERY_CONTROLLER', (c) => new ${pascalName}Controller(c.resolve(TOKENS.REQUEST_CONTEXT), c.resolve(TOKENS.MEDIATOR)));
-        opts.addScoped('${tokenPrefix}_QUERY_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}_QUERY_CONTROLLER: IController<any, any>;
-         * ${tokenPrefix}_QUERY_HANDLER: IHandler<${pascalName}Query, any>;
-         */
-    }
-} as const);
-`
-    await this._fileService.writeFileRecursive(
-      path.join(componentDir, `${lowerName}.module.ts`),
-      moduleContent,
-    )
-  }
-}

package/src/infrastructure/generators/core/drizzle-sql-lite.generator.ts

@@ -1,77 +0,0 @@
-import path from 'node:path'
-
-import type { IFileService, IGenerator } from '../../../domain'
-import { type CoreOptions } from '../../../shared'
-
-/**
- * @class DrizzleSqlLiteGenerator
- * @description Generates a Drizzle configuration file (drizzle.config.ts) and a
- * SQLite schema example (src/infrastructure/db/sqlite-schema.ts) when the user
- * opts to use SQLite/libSQL instead of Postgres.
- */
-export class DrizzleSqlLiteGenerator implements IGenerator<CoreOptions> {
-  constructor(private readonly _fileService: IFileService) {}
-
-  async generate(projectPath: string, _options: CoreOptions): Promise<void> {
-    const configContent = this.composeDrizzleConfig()
-    const filePath = path.join(projectPath, 'drizzle.config.ts')
-    await this._fileService.writeFileRecursive(filePath, configContent)
-
-    const schemaPath = path.join(projectPath, 'src', 'schema.ts')
-    const schemaContent = this.composeSchema()
-    await this._fileService.writeFileRecursive(schemaPath, schemaContent)
-  }
-
-  private composeDrizzleConfig(): string {
-    return `/// <reference types="node" />
-import 'dotenv/config';
-import { defineConfig } from 'drizzle-kit';
-
-/**
- * Drizzle Kit configuration for SQLite / libSQL.
- * Uses environment variable SQLITE_DATABASE_URL to locate the database.
- */
-export default defineConfig({
-  schema: './src/schema.ts',
-  out: './drizzle',
-  dialect: 'sqlite',
-  dbCredentials: {
-    url: process.env.SQLITE_DATABASE_URL!,
-  },
-  verbose: true,
-  strict: true,
-});
-`
-  }
-
-  private composeSchema(): string {
-    return `import { sqliteTable, integer, text } from 'drizzle-orm/sqlite-core';
-
- /**
-  * Example SQLite schema using Drizzle's libsql primitives.
-  * Place your application tables here (this file is scaffolded by the CLI when
-  * the user opts into SQLite support).
-  */
- export const usersTable = sqliteTable('users', {
-   id: integer('id').primaryKey().notNull(),
-   name: text('name').notNull(),
-   description: text('description'),
- });
-
-/**
- * Types inferred from the schema.
- * - UserDto: Represents the shape of the data retrieved from the database ($inferSelect).
- * - NewUserDto: Represents the shape of the data required to insert a new record ($inferInsert).
- */
-export type UserDto = typeof usersTable.$inferSelect;
-export type NewUserDto = typeof usersTable.$inferInsert;
-
-/**
- * Centralized Database Schema dictionary.
- */
-export type SqliteSchema = {
-  users: typeof usersTable;
-};
-`
-  }
-}

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

@@ -1,87 +0,0 @@
-import path from 'node:path'
-
-import type { IFileService, IGenerator } from '../../../domain'
-import { type CoreOptions } from '../../../shared'
-
-/**
- * @class DrizzleGenerator
- * @description Generates the Drizzle configuration file (drizzle.config.ts) and a basic schema file (src/schema.ts) for database scaffolding.
- * The generator is only invoked if the user has opted to include database support in their project.
- *
- * @author Xeno
- * @version 1.0.0
- * @license ISC
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-export class DrizzleGenerator implements IGenerator<CoreOptions> {
-  constructor(private readonly _fileService: IFileService) {}
-
-  async generate(projectPath: string, _options: CoreOptions): Promise<void> {
-    const configContent = this.composeDrizzleConfig()
-    const filePath = path.join(projectPath, 'drizzle.config.ts')
-    await this._fileService.writeFileRecursive(filePath, configContent)
-
-    const schemaContent = this.composeSchema()
-    await this._fileService.writeFileRecursive(
-      path.join(projectPath, 'src', 'schema.ts'),
-      schemaContent,
-    )
-  }
-
-  private composeDrizzleConfig(): string {
-    return `/// <reference types="node" />
-import 'dotenv/config';
-import { defineConfig } from 'drizzle-kit';
-
-/**
- * Drizzle Kit configuration file.
- * Defines the schema location, migration output directory, and database connection.
- */
-export default defineConfig({
-  schema: './src/schema.ts',
-  out: './drizzle',
-  dialect: 'postgresql',
-  dbCredentials: {
-    url: process.env.DATABASE_URL!,
-  },
-  verbose: true,
-  strict: true,
-});
-`
-  }
-
-  private composeSchema(): string {
-    return `import { boolean, pgTable, serial, text, timestamp } from 'drizzle-orm/pg-core';
-
-/**
- * @description Define your database tables here.
- * The 'usersTable' serves as a baseline example. 
- * You can add more tables, relations, and indexes according to your domain requirements.
- */
-export const usersTable = pgTable('users', {
-  id: serial('id').primaryKey(),
-  name: text('name').notNull(),
-  email: text('email').notNull().unique(),
-  isDeleted: boolean('is_deleted').notNull().default(false),
-  deletedAt: timestamp('deleted_at'),
-  createdAt: timestamp('created_at').defaultNow(),
-});
-
-/**
- * Types inferred from the schema.
- * - UserDto: Represents the shape of the data retrieved from the database ($inferSelect).
- * - NewUserDto: Represents the shape of the data required to insert a new record ($inferInsert).
- */
-export type UserDto = typeof usersTable.$inferSelect;
-export type NewUserDto = typeof usersTable.$inferInsert;
-
-/**
- * Centralized Database Schema dictionary.
- */
-export type DbSchema = {
-  users: typeof usersTable;
-};
-`
-  }
-}

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

@@ -1,69 +0,0 @@
-import path from 'node:path'
-
-import { type IFileService, type IGenerator } from '../../../domain'
-import { CORE_CONSTANTS, type CoreOptions } from '../../../shared'
-
-export class EnvGenerator implements IGenerator<CoreOptions> {
-  constructor(private readonly _fileService: IFileService) {}
-
-  public async generate(projectPath: string, options: CoreOptions): Promise<void> {
-    let content = `# ─────────────────────────────────────────────────────────────────────────────
-# Xeno APPLICATION ENVIRONMENT VARIABLES
-# ─────────────────────────────────────────────────────────────────────────────
-NODE_ENV=development
-`
-
-    // Configurazione Database
-    if (options.database !== CORE_CONSTANTS.NONE) {
-      if (options.database === CORE_CONSTANTS.DRIZZLE) {
-        content += `\n# --- Database (PostgreSQL) ---
-    DATABASE_URL=postgres://postgres:password@localhost:5432/xeno_db
-    `
-      } else if (options.database === CORE_CONSTANTS.SQL_LITE) {
-        content += `\n# --- Database (SQLite) ---
-    SQLITE_DATABASE_URL=file:./dev.sqlite
-    `
-      }
-    }
-
-    if (options.axios) {
-      content += `\n# --- Axios ---
-BASE_URL=
-`
-    }
-
-    // Configurazione Redis (Caching, Idempotenza, Concorrenza)
-    if (options.redis) {
-      content += `\n# --- Cache (Redis) ---
-REDIS_HOST=localhost
-REDIS_PORT=6379
-REDIS_PASSWORD=
-REDIS_USERNAME=
-REDIS_TLS=false
-`
-    }
-
-    // Configurazione Supabase (Autenticazione)
-    if (options.supabase) {
-      content += `\n# --- Authentication (Supabase) ---
-SUPABASE_URL=https://your-project.supabase.co
-SUPABASE_KEY=your-anon-key
-`
-    }
-
-    // Configurazione Logging & Observability
-    if (options.sentry) {
-      content += `\n# --- Error Tracking (Sentry) ---
-SENTRY_DSN=https://your-sentry-dsn@o0.ingest.sentry.io/0
-SENTRY_ENVIRONMENT=development
-`
-    }
-
-    // Creiamo sia il file effettivo che il file di esempio
-    const envPath = path.join(projectPath, '.env')
-    const envExamplePath = path.join(projectPath, '.env.example')
-
-    await this._fileService.writeFileRecursive(envPath, content)
-    await this._fileService.writeFileRecursive(envExamplePath, content)
-  }
-}

package/src/infrastructure/generators/core/index.ts

@@ -1,9 +0,0 @@
-export * from './bootstrap.generator'
-export * from './drizzle.generator'
-export * from './drizzle-sql-lite.generator'
-export * from './env.generator'
-export * from './main.generator'
-export * from './packagejson.generator'
-export * from './readme.generator'
-export * from './registry.generator'
-export * from './tsconfig.generator'

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

@@ -1,41 +0,0 @@
-import path from 'node:path'
-
-import type { IFileService, IGenerator } from '../../../domain'
-import { type CoreOptions } from '../../../shared'
-
-export class MainGenerator implements IGenerator<CoreOptions> {
-  constructor(private readonly _fileService: IFileService) {}
-
-  public async generate(projectPath: string, options: CoreOptions): Promise<void> {
-    const content = `import 'dotenv/config';
-import { bootstrap } from './bootstrap';
-import { TOKENS } from '@xeno-js/core';
-
-/**
- * Main Application Entry Point
- */
-async function main() {
-  try {
-    console.info('⏳ Bootstrapping ${options.targetDir} application...');
-    
-    // Initialize the dependency injection container and infrastructure modules
-    const container = await bootstrap();
-    
-    const logger = container.resolve(TOKENS.LOGGER)
-    logger.info('✅ Application started successfully!');
-
-    // TODO: Implement your logic here
-    
-  } catch (error) {
-    console.error('❌ Critical error during startup:', error);
-    process.exit(1);
-  }
-}
-
-main();
-`
-
-    const filePath = path.join(projectPath, 'src', 'main.ts')
-    await this._fileService.writeFileRecursive(filePath, content)
-  }
-}

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

@@ -1,70 +0,0 @@
-import path from 'node:path'
-
-import type { IFileService, IGenerator } from '../../../domain'
-import { CORE_CONSTANTS, type CoreOptions } from '../../../shared'
-
-export class PackageJsonCoreGenerator implements IGenerator<CoreOptions> {
-  constructor(private readonly _fileService: IFileService) { }
-
-  public async generate(projectPath: string, options: CoreOptions): Promise<void> {
-    const packageJson = {
-      name: options.targetDir,
-      version: '1.0.0',
-      private: true,
-      main: './dist/index.js',
-      module: './dist/index.js',
-      types: './dist/index.d.ts',
-      scripts: {
-        start: 'tsx src/main.ts',
-        build: 'tsc --project tsconfig.json',
-        g: 'xeno-js generate',
-      } as Record<string, string>,
-      dependencies: {
-        '@xeno-js/core': 'latest',
-        'dotenv': '^16.4.5',
-      } as Record<string, string>,
-      devDependencies: {
-        '@types/node': '^20.0.0',
-        'tsx': '^4.7.0',
-        'typescript': '^5.8.0',
-      } as Record<string, string>,
-    }
-
-    // Database & ORM
-    if (options.database !== CORE_CONSTANTS.NONE) {
-      packageJson.dependencies['drizzle-orm'] = '^0.45.3'
-      packageJson.dependencies['pg'] = '^8.23.0'
-      packageJson.dependencies['postgres'] = '^3.4.9'
-      packageJson.devDependencies['@types/pg'] = '^8.23.1'
-      packageJson.devDependencies['drizzle-kit'] = '^0.31.11'
-      packageJson.scripts['db:migrate'] = 'drizzle-kit migrate'
-      packageJson.dependencies['drizzle-orm'] = '^0.45.3'
-      packageJson.devDependencies['drizzle-kit'] = '^0.31.11'
-      packageJson.dependencies['@libsql/client'] = '^0.14.0'
-      packageJson.scripts['db:generate'] = 'drizzle-kit generate'
-      packageJson.scripts['db:push'] = 'drizzle-kit push'
-    }
-
-    // HTTP / External Calls
-    if (options.axios) packageJson.dependencies['axios'] = '^1.20.0'
-    if (options.cockatiel) packageJson.dependencies['cockatiel'] = '^4.0.0'
-
-    // Logging & Observability
-    if (options.pino) {
-      packageJson.dependencies['pino'] = '^10.3.1'
-      packageJson.devDependencies['pino-pretty'] = '^11.2.2'
-    }
-    if (options.sentry) packageJson.dependencies['@sentry/node'] = '^11.0.0'
-
-    // Services
-    if (options.redis) packageJson.dependencies['ioredis'] = '^6.0.0'
-    if (options.supabase) {
-      packageJson.dependencies['@supabase/supabase-js'] = '^2.117.1'
-      packageJson.dependencies['@supabase/ssr'] = '^0.12.7'
-    }
-    if (options.zod) packageJson.dependencies['zod'] = '^4.6.5'
-
-    const filePath = path.join(projectPath, 'package.json')
-    await this._fileService.writeFileRecursive(filePath, JSON.stringify(packageJson, null, 2))
-  }
-}