@xeno-js/cli 0.1.0

package/dist/infrastructure/generators/core/registry.generator.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegistryGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const shared_1 = require("../../../shared");
+class RegistryGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, options) {
+        let dbImport = '';
+        let registryType = '';
+        if (options.database !== shared_1.CORE_CONSTANTS.NONE) {
+            if (options.database === shared_1.CORE_CONSTANTS.DRIZZLE) {
+                dbImport = `import type { DbSchema } from './schema';`;
+                registryType = `XenoRegistry<DbSchema>`;
+            }
+            else if (options.database === shared_1.CORE_CONSTANTS.SQL_LITE) {
+                dbImport = `import type { SqliteSchema } from './schema';`;
+                registryType = `XenoRegistry<SqliteSchema>`;
+            }
+        }
+        else {
+            registryType = `XenoRegistry`;
+        }
+        const content = `import type { XenoRegistry } from '@xeno-js/core';
+${dbImport}
+
+/**
+ * @file registry.ts
+ * @description Centralized Type Contract for Dependency Injection.
+ */
+export interface MyRegistry extends ${registryType} {
+    // Add your application injection tokens here
+    // e.g., USER_REPOSITORY: IUserRepository;
+}
+`;
+        const filePath = node_path_1.default.join(projectPath, 'src', 'registry.ts');
+        await this._fileService.writeFileRecursive(filePath, content);
+    }
+}
+exports.RegistryGenerator = RegistryGenerator;

package/dist/infrastructure/generators/core/tsconfig.generator.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsconfigGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const shared_1 = require("../../../shared");
+class TsconfigGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, options) {
+        const tsconfig = {
+            compilerOptions: {
+                target: 'ES2022',
+                module: 'ESNext',
+                moduleResolution: 'bundler',
+                strict: true,
+                esModuleInterop: true,
+                skipLibCheck: true,
+                forceConsistentCasingInFileNames: true,
+                outDir: './dist',
+                rootDir: './src',
+                types: ['node'],
+                paths: {
+                    '@/*': ['./src/*'],
+                },
+            },
+            include: ['src/**/*.ts'],
+        };
+        if (options.database === shared_1.CORE_CONSTANTS.DRIZZLE ||
+            options.database === shared_1.CORE_CONSTANTS.SQL_LITE) {
+            tsconfig.include.push('drizzle.config.ts');
+        }
+        const filePath = node_path_1.default.join(projectPath, 'tsconfig.json');
+        await this._fileService.writeFileRecursive(filePath, JSON.stringify(tsconfig, null, 2));
+    }
+}
+exports.TsconfigGenerator = TsconfigGenerator;

package/dist/infrastructure/generators/core-packagejson.generator.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageJsonCoreGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const shared_1 = require("../../shared");
+class PackageJsonCoreGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, options) {
+        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',
+            },
+            dependencies: {
+                '@xeno-js/core': 'latest',
+                'dotenv': '^16.4.5',
+            },
+            devDependencies: {
+                '@types/node': '^20.0.0',
+                'tsx': '^4.7.0',
+                'typescript': '^5.4.0',
+            },
+        };
+        // Database & ORM
+        if (options.database !== shared_1.CORE_CONSTANTS.NONE) {
+            if (options.database === shared_1.CORE_CONSTANTS.DRIZZLE) {
+                packageJson.dependencies['drizzle-orm'] = '^0.45.2';
+                packageJson.dependencies['pg'] = '^8.22.0';
+                packageJson.dependencies['postgres'] = '^3.4.9';
+                packageJson.devDependencies['@types/pg'] = '^8.11.0';
+                packageJson.devDependencies['drizzle-kit'] = '^0.31.10';
+                packageJson.scripts['db:migrate'] = 'drizzle-kit migrate';
+            }
+            else if (options.database === shared_1.CORE_CONSTANTS.SQL_LITE) {
+                packageJson.dependencies['drizzle-orm'] = '^0.45.2';
+                packageJson.dependencies['@libsql/client'] = '^0.14.0';
+                packageJson.devDependencies['drizzle-kit'] = '^0.31.10';
+            }
+            packageJson.scripts['db:generate'] = 'drizzle-kit generate';
+            packageJson.scripts['db:push'] = 'drizzle-kit push';
+        }
+        // HTTP / External Calls
+        if (options.axios)
+            packageJson.dependencies['axios'] = '^1.16.1';
+        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'] = '^7.64.0';
+        // Services
+        if (options.redis)
+            packageJson.dependencies['ioredis'] = '^5.3.1';
+        if (options.supabase)
+            packageJson.dependencies['@supabase/supabase-js'] = '^2.35.0';
+        if (options.zod)
+            packageJson.dependencies['zod'] = '^4.4.3';
+        const filePath = node_path_1.default.join(projectPath, 'package.json');
+        await this._fileService.writeFileRecursive(filePath, JSON.stringify(packageJson, null, 2));
+    }
+}
+exports.PackageJsonCoreGenerator = PackageJsonCoreGenerator;

package/dist/infrastructure/generators/drizzle-sql-lite.generator.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DrizzleSqlLiteGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * @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.
+ */
+class DrizzleSqlLiteGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, _options) {
+        const configContent = this.composeDrizzleConfig();
+        const filePath = node_path_1.default.join(projectPath, 'drizzle.config.ts');
+        await this._fileService.writeFileRecursive(filePath, configContent);
+        const schemaPath = node_path_1.default.join(projectPath, 'src', 'schema.ts');
+        const schemaContent = this.composeSchema();
+        await this._fileService.writeFileRecursive(schemaPath, schemaContent);
+    }
+    composeDrizzleConfig() {
+        return `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,
+});
+`;
+    }
+    composeSchema() {
+        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;
+};
+`;
+    }
+}
+exports.DrizzleSqlLiteGenerator = DrizzleSqlLiteGenerator;

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

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DrizzleGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+/**
+ * @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/Mattia-Carcione/xeno-js
+ */
+class DrizzleGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, _options) {
+        const configContent = this.composeDrizzleConfig();
+        const filePath = node_path_1.default.join(projectPath, 'drizzle.config.ts');
+        await this._fileService.writeFileRecursive(filePath, configContent);
+        const schemaContent = this.composeSchema();
+        await this._fileService.writeFileRecursive(node_path_1.default.join(projectPath, 'src', 'schema.ts'), schemaContent);
+    }
+    composeDrizzleConfig() {
+        return `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,
+});
+`;
+    }
+    composeSchema() {
+        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;
+};
+`;
+    }
+}
+exports.DrizzleGenerator = DrizzleGenerator;

package/dist/infrastructure/generators/env-vue.generator.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvVueGenerator = void 0;
+// src/infrastructure/generators/env-vue.generator.ts
+const node_path_1 = __importDefault(require("node:path"));
+class EnvVueGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, options) {
+        let content = `# ─────────────────────────────────────────────────────────────────────────────
+# Xeno VUE APPLICATION ENVIRONMENT VARIABLES
+# ─────────────────────────────────────────────────────────────────────────────
+VITE_APP_ENV=development
+`;
+        if (options.axios) {
+            content += `\n# --- Axios ---
+VITE_API_BASE_URL=http://localhost:3000
+`;
+        }
+        if (options.supabase) {
+            content += `\n# --- Authentication (Supabase) ---
+VITE_SUPABASE_URL=https://your-project.supabase.co
+VITE_SUPABASE_KEY=your-anon-key
+`;
+        }
+        if (options.sentry) {
+            content += `\n# --- Error Tracking (Sentry) ---
+VITE_SENTRY_DSN=https://your-sentry-dsn@o0.ingest.sentry.io/0
+`;
+        }
+        await this._fileService.writeFileRecursive(node_path_1.default.join(projectPath, '.env'), content);
+        await this._fileService.writeFileRecursive(node_path_1.default.join(projectPath, '.env.example'), content);
+    }
+}
+exports.EnvVueGenerator = EnvVueGenerator;

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

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const shared_1 = require("../../shared");
+const file_service_1 = require("../file/file.service");
+class EnvGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, options) {
+        const fileUtils = new file_service_1.FileUtils();
+        let content = `# ─────────────────────────────────────────────────────────────────────────────
+# Xeno APPLICATION ENVIRONMENT VARIABLES
+# ─────────────────────────────────────────────────────────────────────────────
+NODE_ENV=development
+`;
+        // Configurazione Database
+        if (options.database !== shared_1.CORE_CONSTANTS.NONE) {
+            if (options.database === shared_1.CORE_CONSTANTS.DRIZZLE) {
+                content += `\n# --- Database (PostgreSQL) ---
+    DATABASE_URL=postgres://postgres:password@localhost:5432/xeno_db
+    `;
+            }
+            else if (options.database === shared_1.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 = node_path_1.default.join(projectPath, '.env');
+        const envExamplePath = node_path_1.default.join(projectPath, '.env.example');
+        await fileUtils.writeFileRecursive(envPath, content);
+        await fileUtils.writeFileRecursive(envExamplePath, content);
+    }
+}
+exports.EnvGenerator = EnvGenerator;

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

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitIgnoreGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const shared_1 = require("../../shared");
+class GitIgnoreGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, options) {
+        let content = `# Dependencies
+node_modules/
+
+# Build artifacts
+dist/
+out/
+build/
+
+# Environment variables
+# We ignore actual .env files for security, but keep .env.example for documentation
+.env
+.env.local
+.env.*
+!.env.example
+
+# Logs
+*.log
+logs/
+npm-debug.log*
+
+# Test coverage
+coverage/
+.nyc_output/
+
+# OS and IDE
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+`;
+        if (options.database === shared_1.CORE_CONSTANTS.SQL_LITE) {
+            content += `\n# SQLite Database
+*.sqlite
+*.sqlite3
+*.sqlite-journal
+`;
+        }
+        // Ignora la cartella di compilazione locale di Vercel se l'ambiente lo richiede
+        if (options.targetEnv === shared_1.CORE_CONSTANTS.VERCEL) {
+            content += `\n# Vercel
+.vercel/
+`;
+        }
+        const filePath = node_path_1.default.join(projectPath, '.gitignore');
+        await this._fileService.writeFileRecursive(filePath, content);
+    }
+}
+exports.GitIgnoreGenerator = GitIgnoreGenerator;

package/dist/infrastructure/generators/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./bootstrap.generator"), exports);
+__exportStar(require("./core-packagejson.generator"), exports);
+__exportStar(require("./drizzle.generator"), exports);
+__exportStar(require("./drizzle-sql-lite.generator"), exports);
+__exportStar(require("./env.generator"), exports);
+__exportStar(require("./gitignore.generator"), exports);
+__exportStar(require("./main.generator"), exports);
+__exportStar(require("./readme.generator"), exports);
+__exportStar(require("./registry.generator"), exports);
+__exportStar(require("./tsconfig.generator"), exports);

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

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MainGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+class MainGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, options) {
+        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 = node_path_1.default.join(projectPath, 'src', 'main.ts');
+        await this._fileService.writeFileRecursive(filePath, content);
+    }
+}
+exports.MainGenerator = MainGenerator;