@xeno-js/cli 0.1.0

package/dist/infrastructure/generators/vue/command_query/cqrs.generator.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CqrsVueGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const shared_1 = require("../../../../shared");
+class CqrsVueGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(targetDir, name, type, outputPath) {
+        const pascalName = shared_1.StringUtils.pascalCase(name);
+        const tokenPrefix = shared_1.StringUtils.splitCamelCaseWithUnderscore(pascalName).toUpperCase();
+        const lowerName = name.toLowerCase();
+        const destinationFolder = outputPath ?? lowerName;
+        const componentDir = node_path_1.default.join(targetDir, 'src', destinationFolder);
+        switch (type) {
+            case shared_1.COMMAND_CONSTANTS.COMMAND: {
+                const { GenerateCommandVueGenerator } = await import('./generate-command-vue.generator.js');
+                const generator = new GenerateCommandVueGenerator(this._fileService);
+                return generator.generate(pascalName, lowerName, tokenPrefix, componentDir);
+            }
+            case shared_1.COMMAND_CONSTANTS.QUERY: {
+                const { GenerateQueryVueGenerator } = await import('./generate-query-vue.generator.js');
+                const generatorQuery = new GenerateQueryVueGenerator(this._fileService);
+                return generatorQuery.generate(pascalName, lowerName, tokenPrefix, componentDir);
+            }
+            default:
+                throw new Error(`Unsupported generator type: '${String(type)}'. Use 'command' or 'query'.`);
+        }
+    }
+}
+exports.CqrsVueGenerator = CqrsVueGenerator;

package/dist/infrastructure/generators/vue/command_query/generate-command-vue.generator.js

@@ -0,0 +1,139 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateCommandVueGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+class GenerateCommandVueGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(pascalName, lowerName, tokenPrefix, componentDir) {
+        // 1. Command (Application)
+        const commandContent = `import { Command } from '@xeno-js/vue';
+
+export class ${pascalName}Command extends Command {
+    constructor() {
+        super('${tokenPrefix}_COMMAND');
+    }
+}
+`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(componentDir, `${lowerName}.command.ts`), commandContent);
+        const handlerContent = `import type { IHandler, ResultType } from '@xeno-js/vue';
+import { AppError, Result } from '@xeno-js/vue';
+import type { ${pascalName}Command } from './${lowerName}.command';
+import type { ${pascalName}Response } from './${lowerName}.model';
+
+/*
+ * ⚠️ WARNING: ACTION REQUIRED ⚠️
+ * 
+ * Please register your handler in the IoC container (e.g. src/bootstrap.ts) and add its token to MyRegistry.
+ *
+ * 1. In src/registry.ts:
+ * ${tokenPrefix}_HANDLER: IHandler<${pascalName}Command, ${pascalName}Response>;
+ * 
+ * 2. In src/bootstrap.ts:
+ * .addServices((config, register) => {
+ *     register('${tokenPrefix}_HANDLER', new ${pascalName}Handler());
+ * });
+ */
+export class ${pascalName}Handler implements IHandler<${pascalName}Command, ${pascalName}Response> {
+    constructor(
+        // TODO: Inject your remote DataSources or other services here
+    ) {}
+
+    public async handle(command: ${pascalName}Command, signal: AbortSignal): Promise<ResultType<${pascalName}Response>> {
+        AppError.throwIfAborted(signal, this.constructor.name);
+
+        // TODO: Implement your frontend business logic or API calls here
+        return Result.ok();
+    }
+}
+`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(componentDir, `${lowerName}.handler.ts`), handlerContent);
+        const composableContent = `import { ref } from 'vue';
+import { AppError, Result, type ApiResponseDto, type ResultType } from '@xeno-js/vue';
+import { ServicesUtils } from '@/use-app';
+import { ${pascalName}Command } from './${lowerName}.command';
+import type { ${pascalName}Request, ${pascalName}Response } from './${lowerName}.model';
+
+/*
+ * ⚠️ WARNING: ACTION REQUIRED ⚠️
+ *
+ * Please register your handler in the IoC container (e.g. src/bootstrap.ts) and add its token to MyRegistry.
+ *
+ * 1. In src/registry.ts:
+ * ${tokenPrefix}_HANDLER: IHandler<${pascalName}Command, ${pascalName}Response>;
+ * 
+ * 2. In src/bootstrap.ts:
+ * .addServices((config, register) => {
+ *     register('${tokenPrefix}_HANDLER', new ${pascalName}Handler());
+ * });
+ */
+export function use${pascalName}() {
+    const loading = ref(false);
+    const error = ref<string | null>(null);
+    let abortController: AbortController | null = null;
+
+    const execute = async (payload: ${pascalName}Request): Promise<ResultType<${pascalName}Response>> => {
+        abortController = new AbortController();
+        
+        if (loading.value) return Result.fail(AppError.create({
+            name: '${pascalName}Command',
+            message: '${pascalName}Command is already in progress',
+            code: '${tokenPrefix}_COMMAND_ALREADY_IN_PROGRESS',
+            status: 500,
+            cause: new Error('${tokenPrefix}_COMMAND_ALREADY_IN_PROGRESS'),
+        }));
+        loading.value = true;
+        error.value = null;
+
+        try {
+            // Resolve mediator and handler from the container
+            const { mediator, ${tokenPrefix}_HANDLER: handler } = ServicesUtils.useApp();
+            const command = new ${pascalName}Command();
+
+            const result = await mediator.send(command, async () => {
+                return await handler.handle(command, abortController?.signal);
+            });
+
+            if (!result.isOk()) {
+                error.value = result.getErrorOrThrow().message;
+            }
+
+            return result;
+        } finally {
+            loading.value = false;
+        }
+    };
+
+    const abort = () => {
+        if (abortController) {
+            abortController.abort();
+        }
+    };
+
+    // Automatically cancel pending operations when the component unmounts
+    onUnmounted(() => {
+        abort();
+    });
+
+    return { loading, error, execute };
+}
+`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(componentDir, `use-${lowerName}.composable.ts`), composableContent);
+        // 3. Domain Model (Domain)
+        const modelContent = `export interface ${pascalName}Request {
+    // TODO: Define your request payload properties here
+}
+
+export interface ${pascalName}Response {
+    // TODO: Define your response properties here
+}
+`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(componentDir, `${lowerName}.model.ts`), modelContent);
+    }
+}
+exports.GenerateCommandVueGenerator = GenerateCommandVueGenerator;

package/dist/infrastructure/generators/vue/command_query/generate-query-vue.generator.js

@@ -0,0 +1,147 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateQueryVueGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+class GenerateQueryVueGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(pascalName, lowerName, tokenPrefix, componentDir) {
+        // 1. Query (Application)
+        const queryContent = `import { Query } from '@xeno-js/vue';
+import type { ${pascalName}Response } from './${lowerName}.model';
+
+export class ${pascalName}Query extends Query<${pascalName}Response> {
+    constructor() {
+        super('${tokenPrefix}_QUERY', {
+            ttl: 60,
+            cacheKey: \`${lowerName}.query\`,
+            bypassCache: false,
+            consistentRead: false,
+            isUserScoped: true
+        });
+    }
+}
+`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(componentDir, `${lowerName}.query.ts`), queryContent);
+        const handlerContent = `import type { IHandler, ResultType } from '@xeno-js/vue';
+import { AppError, Result } from '@xeno-js/vue';
+import type { ${pascalName}Query } from './${lowerName}.query';
+import type { ${pascalName}Response } from './${lowerName}.model';
+
+    /*
+ * ⚠️ WARNING: ACTION REQUIRED ⚠️
+ *
+ * Please register your handler in the IoC container (e.g. src/bootstrap.ts) and add its token to MyRegistry.
+ *
+ * 1. In src/registry.ts:
+ * ${tokenPrefix}_HANDLER: IHandler<${pascalName}Query, ${pascalName}Response>;
+ * 
+ * 2. In src/bootstrap.ts:
+ * .addServices((config, register) => {
+ *     register('${tokenPrefix}_HANDLER', new ${pascalName}Handler());
+ * });
+ */
+export class ${pascalName}Handler implements IHandler<${pascalName}Query, ${pascalName}Response> {
+    constructor(
+        // TODO: Inject your remote DataSources or other services here
+    ) {}
+
+    public async handle(query: ${pascalName}Query, signal: AbortSignal): Promise<ResultType<${pascalName}Response>> {
+        AppError.throwIfAborted(signal, this.constructor.name);
+
+        // TODO: Implement your frontend business logic or API calls here
+        return Result.ok();
+    }
+}
+`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(componentDir, `${lowerName}.handler.ts`), handlerContent);
+        // 2. Composable (Presentation)
+        const composableContent = `import { ref } from 'vue';
+import { AppError, Result, type ApiResponseDto, type ResultType } from '@xeno-js/vue';
+import { ServicesUtils } from '@/use-app';
+import { ${pascalName}Query } from './${lowerName}.query';
+import type { ${pascalName}Response } from './${lowerName}.model';
+
+export function use${pascalName}() {
+    const loading = ref(false);
+    const error = ref<string | null>(null);
+    const data = ref<${pascalName}Response | null>(null);
+    let abortController: AbortController | null = null;
+
+    /*
+ * ⚠️ WARNING: ACTION REQUIRED ⚠️
+ *
+ * Please register your handler in the IoC container (e.g. src/bootstrap.ts) and add its token to MyRegistry.
+ *
+ * 1. In src/registry.ts:
+ * ${tokenPrefix}_HANDLER: IHandler<${pascalName}Query, ${pascalName}Response>;
+ * 
+ * 2. In src/bootstrap.ts:
+ * .addServices((config, register) => {
+ *     register('${tokenPrefix}_HANDLER', new ${pascalName}Handler());
+ * });
+ */
+const fetch = async (): Promise<ResultType<${pascalName}Response>> => {
+        abortController = new AbortController();
+
+        if (loading.value) return Result.fail(AppError.create({
+            name: '${pascalName}Query',
+            message: '${pascalName}Query is already in progress',
+            code: '${tokenPrefix}_QUERY_ALREADY_IN_PROGRESS',
+            status: 500,
+            cause: new Error('${tokenPrefix}_QUERY_ALREADY_IN_PROGRESS'),
+        }));
+        loading.value = true;
+        error.value = null;
+
+        try {
+            try {
+            // Resolve mediator and handler from the container
+            const { mediator, ${tokenPrefix}_HANDLER: handler } = ServicesUtils.useApp();
+            const query = new ${pascalName}Query();
+
+            const result = await mediator.query(query, async () => {
+                return await handler.handle(query, abortController?.signal);
+            });
+
+            if (result.isOk()) {
+                data.value = result.getValueOrThrow();
+            } else {
+                error.value = result.getErrorOrThrow().message;
+            }
+
+            return result;
+        } finally {
+            loading.value = false;
+        }
+    };
+
+    const abort = () => {
+        if (abortController) {
+            abortController.abort();
+        }
+    };
+
+    // Automatically cancel pending operations when the component unmounts
+    onUnmounted(() => {
+        abort();
+    });
+
+    return { loading, error, data, fetch };
+}
+`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(componentDir, `use-${lowerName}.composable.ts`), composableContent);
+        // 3. Domain Model (Domain)
+        const modelContent = `export interface ${pascalName}Response {
+    // TODO: Define your response properties here
+}
+`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(componentDir, `${lowerName}.model.ts`), modelContent);
+    }
+}
+exports.GenerateQueryVueGenerator = GenerateQueryVueGenerator;

package/dist/infrastructure/generators/vue/env.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/vue/index-html.generator.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexVueGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+class IndexVueGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, options) {
+        const indexHtml = `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${options.targetDir}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(projectPath, 'index.html'), indexHtml);
+    }
+}
+exports.IndexVueGenerator = IndexVueGenerator;

package/dist/infrastructure/generators/vue/index.js

@@ -0,0 +1,28 @@
+"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("./app-vue.generator"), exports);
+__exportStar(require("./bootstrap-ts.generator"), exports);
+__exportStar(require("./env.generator"), exports);
+__exportStar(require("./index-html.generator"), exports);
+__exportStar(require("./main.generator"), exports);
+__exportStar(require("./packagejson.generator"), exports);
+__exportStar(require("./readme.generator"), exports);
+__exportStar(require("./registry-ts.generator"), exports);
+__exportStar(require("./router.generator"), exports);
+__exportStar(require("./tailwind.generator"), exports);
+__exportStar(require("./tsconfig.generator"), exports);
+__exportStar(require("./vite-config.generator"), exports);

package/dist/infrastructure/generators/vue/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) {
+        // 5. src/main.ts
+        const routerImport = options.router ? `\nimport router from './router';` : '';
+        const piniaImport = options.pinia ? `\nimport { createPinia } from 'pinia';` : '';
+        const tailwindImport = options.tailwind ? `\nimport './assets/style.css';` : '';
+        const mainTs = `import { createApp } from 'vue';
+import App from './App.vue';
+import { bootstrap } from './bootstrap';
+import { XENO_SERVICES_KEY } from '@xeno-js/vue';${routerImport}${piniaImport}${tailwindImport}
+
+async function mountApp() {
+  try {
+    const app = createApp(App);
+    ${options.pinia ? '\n    app.use(createPinia());' : ''}
+    const container = await bootstrap(app, router);
+    ${options.router ? '\n    app.use(router);' : ''}
+    
+
+    // Provide the Xeno IoC container globally to all components
+    app.provide(XENO_SERVICES_KEY, container);
+
+    app.mount('#app');
+  } catch (error) {
+    console.error('Critical error during frontend bootstrap:', error);
+  }
+}
+
+mountApp();
+`;
+        await this._fileService.writeFileRecursive(node_path_1.default.join(projectPath, 'src', 'main.ts'), mainTs);
+    }
+}
+exports.MainGenerator = MainGenerator;

package/dist/infrastructure/generators/vue/packagejson.generator.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageJsonVueGenerator = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+class PackageJsonVueGenerator {
+    _fileService;
+    constructor(_fileService) {
+        this._fileService = _fileService;
+    }
+    async generate(projectPath, options) {
+        const packageJson = {
+            name: options.targetDir,
+            version: '1.0.0',
+            private: true,
+            type: 'module',
+            scripts: {
+                dev: 'vite',
+                build: 'vue-tsc -b && vite build',
+                preview: 'vite preview',
+                g: 'xeno-js generate',
+            },
+            dependencies: {
+                '@xeno-js/vue': 'latest',
+                'vue': '^3.5.0',
+            },
+            devDependencies: {
+                '@types/node': '^20.0.0',
+                '@vitejs/plugin-vue': '^5.1.0',
+                'typescript': '^5.5.0',
+                'vite': '^5.4.0',
+                'vue-tsc': '^2.1.0',
+            },
+        };
+        if (options.axios)
+            packageJson.dependencies['axios'] = '^1.7.0';
+        if (options.cockatiel)
+            packageJson.dependencies['cockatiel'] = '^4.0.0';
+        if (options.supabase)
+            packageJson.dependencies['@supabase/supabase-js'] = '^2.45.0';
+        if (options.sentry)
+            packageJson.dependencies['@sentry/vue'] = '^8.28.0';
+        if (options.pinia)
+            packageJson.dependencies['pinia'] = '^2.2.0';
+        if (options.router)
+            packageJson.dependencies['vue-router'] = '^4.4.0';
+        if (options.zod)
+            packageJson.dependencies['zod'] = '^4.4.3';
+        if (options.tailwind) {
+            packageJson.devDependencies['tailwindcss'] = '^4.0.0';
+            packageJson.devDependencies['@tailwindcss/vite'] = '^4.0.0';
+        }
+        const filePath = node_path_1.default.join(projectPath, 'package.json');
+        await this._fileService.writeFileRecursive(filePath, JSON.stringify(packageJson, null, 2));
+    }
+}
+exports.PackageJsonVueGenerator = PackageJsonVueGenerator;