@uofx/cli 1.0.0

package/dist/presentation/controllers/credentials.controller.js

@@ -0,0 +1,105 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CredentialsController = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../di/tokens");
+const get_credentials_use_case_1 = require("../../application/use-cases/credentials/get-credentials.use-case");
+const error_formatter_util_1 = require("../../infrastructure/utils/error-formatter.util");
+/**
+ * Credentials Controller
+ *
+ * 處理憑證相關的 CLI 命令
+ */
+let CredentialsController = class CredentialsController {
+    constructor(getCredentialsUseCase, output) {
+        this.getCredentialsUseCase = getCredentialsUseCase;
+        this.output = output;
+    }
+    /**
+     * 取得實例憑證
+     * @param name - 實例名稱
+     * @param reveal - 是否顯示完整憑證
+     */
+    async get(name, reveal = false) {
+        try {
+            const credentials = await this.getCredentialsUseCase.execute({ name });
+            if (!credentials) {
+                this.output
+                    .error(`Credentials not found for instance ${name}`)
+                    .render();
+                return;
+            }
+            this.output
+                .newline()
+                .section(`Credentials for instance '${name}'`)
+                .divider()
+                .newline()
+                .section('Database Credentials')
+                .item('bullet', `SA Default Password: ${this.maskPassword(credentials.saPassword, reveal)}`)
+                .newline()
+                .section('UofX Admin Credentials')
+                .item('bullet', 'Username: uofxadmin')
+                .item('bullet', `Default Password: ${this.maskPassword(credentials.adminPassword, reveal)}`)
+                .newline();
+            // 顯示安全警告
+            if (reveal) {
+                this.output
+                    .warning('Full credentials displayed. Clear your terminal history to avoid exposing secrets.');
+            }
+            else {
+                this.output
+                    .info('Passwords are masked for security. Use --reveal to show full credentials.');
+            }
+            this.output
+                .newline()
+                .section('Important')
+                .item('bullet', 'Keep these credentials secure')
+                .item('bullet', 'Do not share passwords in plain text')
+                .newline()
+                .render();
+        }
+        catch (error) {
+            this.output
+                .error(`Failed to retrieve credentials: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`)
+                .render();
+            throw error;
+        }
+    }
+    /**
+     * 遮罩密碼 - 僅顯示後 4 碼
+     * @param password - 原始密碼
+     * @param reveal - 是否顯示完整密碼
+     */
+    maskPassword(password, reveal) {
+        if (!password) {
+            return '';
+        }
+        if (reveal) {
+            return password;
+        }
+        if (password.length <= 4) {
+            return '****';
+        }
+        return '****' + password.slice(-4);
+    }
+};
+exports.CredentialsController = CredentialsController;
+exports.CredentialsController = CredentialsController = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.GetCredentialsUseCase)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.IOutputPort)),
+    __metadata("design:paramtypes", [get_credentials_use_case_1.GetCredentialsUseCase, Object])
+], CredentialsController);
+//# sourceMappingURL=credentials.controller.js.map

package/dist/presentation/controllers/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Presentation Controllers
+ */
+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("./instance.controller"), exports);
+__exportStar(require("./setup.controller"), exports);
+__exportStar(require("./config.controller"), exports);
+__exportStar(require("./logs.controller"), exports);
+__exportStar(require("./credentials.controller"), exports);
+//# sourceMappingURL=index.js.map

package/dist/presentation/controllers/instance.controller.js

@@ -0,0 +1,363 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceController = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../di/tokens");
+const install_instance_use_case_1 = require("../../application/use-cases/instance/install-instance.use-case");
+const start_instance_use_case_1 = require("../../application/use-cases/instance/start-instance.use-case");
+const stop_instance_use_case_1 = require("../../application/use-cases/instance/stop-instance.use-case");
+const delete_instance_use_case_1 = require("../../application/use-cases/instance/delete-instance.use-case");
+const list_instances_use_case_1 = require("../../application/use-cases/instance/list-instances.use-case");
+const list_charts_use_case_1 = require("../../application/use-cases/instance/list-charts.use-case");
+const error_formatter_util_1 = require("../../infrastructure/utils/error-formatter.util");
+/**
+ * Instance Controller
+ *
+ * 處理實例相關的 CLI 命令
+ */
+let InstanceController = class InstanceController {
+    constructor(installUseCase, startUseCase, stopUseCase, deleteUseCase, listUseCase, listChartsUseCase, output, interaction) {
+        this.installUseCase = installUseCase;
+        this.startUseCase = startUseCase;
+        this.stopUseCase = stopUseCase;
+        this.deleteUseCase = deleteUseCase;
+        this.listUseCase = listUseCase;
+        this.listChartsUseCase = listChartsUseCase;
+        this.output = output;
+        this.interaction = interaction;
+        output.resetIndent();
+    }
+    /**
+     * 安裝新實例
+     */
+    async install(options) {
+        try {
+            const request = {
+                name: options.name,
+                chartVersion: options.chartVersion,
+                pullSecretPath: options.pullSecret,
+                rootfsPath: options.rootfs,
+            };
+            this.output
+                .info(`Installing instance: ${request.name}`)
+                .flush();
+            const result = await this.installUseCase.execute(request, this.output);
+            this.output
+                .newline()
+                .success(`Instance ${request.name} installed successfully!`);
+            // 使用統一格式顯示連線資訊
+            this.displayConnectionInfo(result.connectionInfo);
+            this.output
+                .newline()
+                .info('To view credentials, run:')
+                .item('bullet', `uofx env list credentials --name ${result.instanceName} --reveal`)
+                .render();
+        }
+        catch (error) {
+            this.output
+                .error(`Installation failed: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`)
+                .render();
+            throw error;
+        }
+    }
+    /**
+     * 啟動實例
+     */
+    async start(name, options) {
+        try {
+            // 檢查其他運行中的實例
+            const otherRunning = await this.startUseCase.listOtherRunningInstances(name);
+            if (otherRunning.length > 0) {
+                const otherName = otherRunning[0];
+                this.output
+                    .newline()
+                    .warning(`Another instance is already running: ${otherName}`)
+                    .flush();
+                const shouldStop = await this.interaction.confirm(`Do you want to stop "${otherName}" and start "${name}"?`, false);
+                if (!shouldStop) {
+                    this.output.info('Start cancelled').render();
+                    return;
+                }
+                this.output.info(`Stopping ${otherName}...`).flush();
+                await this.startUseCase.stopInstance(otherName, this.output);
+                this.output.success(`${otherName} stopped`).flush();
+            }
+            this.output.newline().flush();
+            const result = await this.startUseCase.execute({ name, waitForReady: true }, this.output);
+            this.output.newline();
+            if (result.alreadyRunning) {
+                this.output.success(`Instance '${result.instanceName}' is already running`);
+            }
+            else {
+                this.output.success(`Instance '${result.instanceName}' started successfully!`);
+            }
+            // 顯示連線資訊
+            this.displayConnectionInfo(result.connectionInfo);
+            if (options?.showCredentials !== false) {
+                this.output
+                    .newline()
+                    .info('To view credentials, run:')
+                    .item('bullet', `uofx env list credentials --name ${name} --reveal`);
+            }
+            this.output.render();
+        }
+        catch (error) {
+            this.output
+                .error(`Start failed: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`)
+                .render();
+            throw error;
+        }
+    }
+    /**
+     * 顯示連線資訊
+     */
+    displayConnectionInfo(connectionInfo) {
+        this.output
+            .newline()
+            .divider()
+            .section('Connection Information')
+            .divider();
+        if (connectionInfo.adminUrl) {
+            this.output
+                .newline()
+                .section('UofX Services')
+                .item('bullet', `Admin Interface: ${connectionInfo.adminUrl}`);
+        }
+        if (connectionInfo.sqlServer) {
+            this.output
+                .newline()
+                .section('SQL Server')
+                .item('bullet', `Server: ${connectionInfo.sqlServer}`)
+                .item('bullet', 'User:   SA');
+        }
+        if (!connectionInfo.instanceIp) {
+            this.output
+                .newline()
+                .warning('Could not determine instance IP address');
+        }
+        this.output.divider();
+    }
+    /**
+     * 停止實例
+     */
+    async stop(name, options) {
+        try {
+            const force = options?.force || false;
+            this.output
+                .info(`Stopping instance: ${name}`)
+                .newline()
+                .flush();
+            const result = await this.stopUseCase.execute({ name, force }, this.output);
+            if (result.alreadyStopped) {
+                this.output
+                    .info(`Instance '${result.instanceName}' is already stopped`)
+                    .newline()
+                    .info(`To start this instance: uofx env start --name ${name}`)
+                    .render();
+                return;
+            }
+            this.output
+                .success(`Instance ${name} stopped`)
+                .render();
+        }
+        catch (error) {
+            this.output
+                .error(`Stop failed: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`)
+                .newline()
+                .section('Troubleshooting')
+                .item('bullet', `Try force stop: uofx env stop --name ${name} --force`)
+                .item('bullet', 'Check WSL status: wsl --list --verbose')
+                .item('bullet', `Manually terminate: wsl --terminate uofx-${name}`)
+                .render();
+            throw error;
+        }
+    }
+    /**
+     * 刪除實例
+     */
+    async delete(name, force = false) {
+        try {
+            // 取得實例詳細資訊
+            const details = await this.deleteUseCase.getInstanceDetails(name);
+            if (!details) {
+                this.output
+                    .error(`Instance "${name}" not found`)
+                    .render();
+                return;
+            }
+            // 顯示實例詳細資訊
+            const installedDisplay = details.installedAt
+                ? new Date(details.installedAt).toLocaleString()
+                : 'N/A';
+            this.output
+                .newline()
+                .divider()
+                .section('Instance Details')
+                .divider()
+                .item('bullet', `Name:          ${details.name}`)
+                .item('bullet', `Status:        ${details.isRunning ? 'Running' : 'Stopped'}`)
+                .item('bullet', `Chart Version: ${details.chartVersion || 'N/A'}`)
+                .item('bullet', `Installed:     ${installedDisplay}`)
+                .divider()
+                .flush();
+            if (!force) {
+                const confirmed = await this.interaction.confirm(`Are you sure you want to delete instance "${name}"? This action cannot be undone.`, false);
+                if (!confirmed) {
+                    this.output.info('Deletion cancelled').render();
+                    return;
+                }
+            }
+            this.output
+                .newline()
+                .info(`Deleting instance: ${name}`)
+                .flush();
+            const result = await this.deleteUseCase.execute({ name, force }, this.output);
+            // 如果停止時有警告，顯示警告
+            if (result.stopWarning) {
+                this.output
+                    .warning(result.stopWarning)
+                    .info('Continuing with deletion...');
+            }
+            this.output.success(`Instance ${name} deleted`);
+            // 顯示剩餘實例數量
+            if (result.remainingInstanceCount > 0) {
+                this.output
+                    .newline()
+                    .info(`Remaining instances: ${result.remainingInstanceCount}`)
+                    .info('Use "uofx env list" to see all instances.');
+            }
+            else {
+                this.output
+                    .newline()
+                    .info('No remaining instances.')
+                    .info('Use "uofx env install --name <name>" to create a new instance.');
+            }
+            this.output.render();
+        }
+        catch (error) {
+            this.output
+                .error(`Deletion failed: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`)
+                .newline()
+                .section('If the instance is corrupted, try manual cleanup')
+                .item('bullet', `wsl --unregister uofx-${name}`)
+                .item('bullet', 'Delete the instance folder manually')
+                .render();
+            throw error;
+        }
+    }
+    /**
+     * 列出所有實例
+     */
+    async list() {
+        try {
+            const result = await this.listUseCase.execute();
+            if (result.instances.length === 0) {
+                this.output
+                    .info('No instances found')
+                    .newline()
+                    .info('Use the following command to install a new instance:')
+                    .item('bullet', 'uofx env install --name <name>')
+                    .render();
+                return;
+            }
+            this.output
+                .newline()
+                .section('Instances')
+                .table(['NAME', 'STATUS', 'VERSION', 'CHART VERSION', 'ADMIN URL', 'SQL SERVER'], result.instances.map(inst => [
+                inst.name,
+                inst.status,
+                inst.wslVersion,
+                inst.chartVersion,
+                inst.adminUrl ?? '',
+                inst.sqlServer ?? '',
+            ]))
+                .newline()
+                .info(`Total: ${result.instances.length} instances`)
+                .render();
+        }
+        catch (error) {
+            this.output
+                .error(`Failed to list instances: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`)
+                .render();
+            throw error;
+        }
+    }
+    /**
+     * 列出可用的 Chart 版本
+     */
+    async listCharts() {
+        try {
+            const versions = await this.listChartsUseCase.execute({ chartName: 'uofx' });
+            if (versions.length === 0) {
+                this.output
+                    .info('No chart versions found')
+                    .render();
+                return;
+            }
+            this.output
+                .newline()
+                .section('Available UOFX Chart Versions')
+                .table(['VERSION', 'TYPE', 'STATUS'], versions.map((v, i) => [
+                v.toString(),
+                this.getVersionType(v.toString()),
+                i === 0 ? 'Latest' : '',
+            ]))
+                .newline()
+                .info(`Total: ${versions.length} versions available`)
+                .newline()
+                .info('Use the following command to install a specific version:')
+                .item('bullet', 'uofx env install --name <name> --chart-version <version>')
+                .render();
+        }
+        catch (error) {
+            this.output
+                .error(`Failed to query chart versions: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`)
+                .render();
+            throw error;
+        }
+    }
+    /**
+     * 判斷版本類型 (Beta/Stable)
+     */
+    getVersionType(version) {
+        const parts = version.split('.');
+        if (parts.length >= 3) {
+            const patch = parts[2];
+            if (patch.startsWith('2')) {
+                return 'Beta';
+            }
+        }
+        return 'Stable';
+    }
+};
+exports.InstanceController = InstanceController;
+exports.InstanceController = InstanceController = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.InstallInstanceUseCase)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.StartInstanceUseCase)),
+    __param(2, (0, tsyringe_1.inject)(tokens_1.TOKENS.StopInstanceUseCase)),
+    __param(3, (0, tsyringe_1.inject)(tokens_1.TOKENS.DeleteInstanceUseCase)),
+    __param(4, (0, tsyringe_1.inject)(tokens_1.TOKENS.ListInstancesUseCase)),
+    __param(5, (0, tsyringe_1.inject)(tokens_1.TOKENS.ListChartsUseCase)),
+    __param(6, (0, tsyringe_1.inject)(tokens_1.TOKENS.IOutputPort)),
+    __param(7, (0, tsyringe_1.inject)(tokens_1.TOKENS.IUserInteractionPort)),
+    __metadata("design:paramtypes", [install_instance_use_case_1.InstallInstanceUseCase,
+        start_instance_use_case_1.StartInstanceUseCase,
+        stop_instance_use_case_1.StopInstanceUseCase,
+        delete_instance_use_case_1.DeleteInstanceUseCase,
+        list_instances_use_case_1.ListInstancesUseCase,
+        list_charts_use_case_1.ListChartsUseCase, Object, Object])
+], InstanceController);
+//# sourceMappingURL=instance.controller.js.map

package/dist/presentation/controllers/logs.controller.js

@@ -0,0 +1,103 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogsController = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../di/tokens");
+const show_logs_use_case_1 = require("../../application/use-cases/logs/show-logs.use-case");
+const error_formatter_util_1 = require("../../infrastructure/utils/error-formatter.util");
+/**
+ * Logs Controller
+ *
+ * 處理日誌相關的 CLI 命令
+ */
+let LogsController = class LogsController {
+    constructor(showLogsUseCase, output) {
+        this.showLogsUseCase = showLogsUseCase;
+        this.output = output;
+    }
+    /**
+     * 顯示日志
+     */
+    async show(options) {
+        try {
+            const request = {
+                lines: options.lines || 50,
+                level: options.level,
+                since: options.since,
+                correlation: options.correlation,
+                command: options.command,
+                commandGroup: options.commandGroup,
+                follow: options.follow || false,
+            };
+            const result = await this.showLogsUseCase.execute(request);
+            this.formatAndDisplayLogs(result);
+        }
+        catch (error) {
+            this.output
+                .error(`Failed to show logs: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`)
+                .render();
+            throw error;
+        }
+    }
+    /**
+     * 格式化並顯示日誌
+     */
+    formatAndDisplayLogs(result) {
+        // 檢查是否有日誌
+        if (result.entries.length === 0) {
+            this.output
+                .info('No logs found matching the criteria.')
+                .render();
+            return;
+        }
+        // 顯示每個日誌項目
+        result.entries.forEach(entry => {
+            const level = entry.level.padEnd(5);
+            let logLine = `[${entry.timestamp}] ${level} ${entry.message}`;
+            // 顯示 correlation ID
+            if (entry.correlationId) {
+                logLine += ` (correlation: ${entry.correlationId})`;
+            }
+            // 顯示命令資訊
+            if (entry.command) {
+                logLine += ` [${entry.command}]`;
+            }
+            this.output.line(logLine);
+            // 顯示錯誤堆疊
+            if (entry.errorStack) {
+                this.output.indent().item('bullet', `Stack: ${entry.errorStack}`).outdent();
+            }
+        });
+        // 顯示總計
+        this.output
+            .newline()
+            .info(`--- Total: ${result.total} entries ---`);
+        // 如果是追蹤模式，顯示提示
+        if (result.isFollowing) {
+            this.output
+                .newline()
+                .info('[Following logs... Press Ctrl+C to exit]');
+        }
+        this.output.render();
+    }
+};
+exports.LogsController = LogsController;
+exports.LogsController = LogsController = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.ShowLogsUseCase)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.IOutputPort)),
+    __metadata("design:paramtypes", [show_logs_use_case_1.ShowLogsUseCase, Object])
+], LogsController);
+//# sourceMappingURL=logs.controller.js.map