@uofx/cli 1.0.0

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

@@ -0,0 +1,175 @@
+"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.SetupController = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../di/tokens");
+const setup_environment_use_case_1 = require("../../application/use-cases/setup/setup-environment.use-case");
+const runtime_environment_port_1 = require("../../domain/ports/runtime-environment.port");
+const error_formatter_util_1 = require("../../infrastructure/utils/error-formatter.util");
+/**
+ * Setup Controller
+ *
+ * 處理環境設定相關的 CLI 命令
+ */
+let SetupController = class SetupController {
+    constructor(setupUseCase, output, wslUpdater, runtimeEnvironment) {
+        this.setupUseCase = setupUseCase;
+        this.output = output;
+        this.wslUpdater = wslUpdater;
+        this.runtimeEnvironment = runtimeEnvironment;
+    }
+    /**
+     * 執行環境檢查
+     */
+    async setup(_options) {
+        try {
+            this.output
+                .item('arrow', 'Checking system environment...')
+                .newline()
+                .flush();
+            const result = await this.setupUseCase.execute();
+            // 顯示作業系統資訊
+            this.output
+                .section('Checking Operating System')
+                .item('bullet', `Platform: ${result.osInfo.platform}`)
+                .item('bullet', `Version: ${result.osInfo.version}`)
+                .item('bullet', `Architecture: ${result.osInfo.arch}`)
+                .success('OS check passed')
+                .newline();
+            // 顯示執行環境資訊
+            this.output
+                .section('Checking Runtime Environment')
+                .item('bullet', `Type: ${result.runtimeInfo.type}`)
+                .item('bullet', `Version: ${result.runtimeInfo.version}`);
+            if (result.runtimeInfo.isInstalled) {
+                this.output.success('Runtime installed');
+            }
+            else {
+                this.output.error('Runtime not installed').newline().render();
+                // 詢問使用者是否要安裝 WSL
+                const shouldInstall = await this.wslUpdater.promptWslInstall(this.output);
+                if (shouldInstall) {
+                    const { needsRestart } = await this.wslUpdater.installWsl('install', this.output);
+                    if (needsRestart) {
+                        this.output
+                            .newline()
+                            .info('Please restart your computer and run "uofx env setup" again.')
+                            .render();
+                    }
+                    else {
+                        this.output
+                            .newline()
+                            .success('WSL installation completed. You can now continue with setup.')
+                            .info('Run "uofx env setup" again to verify the installation.')
+                            .render();
+                    }
+                    return;
+                }
+            }
+            this.output.newline();
+            // 顯示記憶體資訊
+            const memoryInfo = await this.runtimeEnvironment.getMemoryAvailability();
+            this.output.section('Checking Remaining Memory');
+            for (const detail of memoryInfo.details) {
+                const suffix = detail.suffix ? ` (${detail.suffix})` : '';
+                this.output.item('bullet', `${detail.label}: ${detail.valueGB.toFixed(2)} GB${suffix}`);
+            }
+            const memoryOk = memoryInfo.availableGB >= runtime_environment_port_1.UOFX_REQUIRED_MEMORY_GB;
+            if (memoryOk) {
+                this.output.success('Memory sufficient for UOFX');
+            }
+            else {
+                this.output
+                    .warning(`Available memory (${memoryInfo.availableGB.toFixed(2)} GB) is below recommended ${runtime_environment_port_1.UOFX_REQUIRED_MEMORY_GB} GB`)
+                    .newline()
+                    .info('Insufficient memory may cause:')
+                    .item('bullet', 'Kubernetes pods failing to start')
+                    .item('bullet', 'Services becoming unresponsive');
+            }
+            this.output.newline();
+            // 顯示其他系統資源
+            const totalMemoryGB = (result.systemResources.totalMemory / (1024 * 1024 * 1024)).toFixed(2);
+            this.output
+                .section('Checking System Resources')
+                .item('bullet', `Total system memory: ${totalMemoryGB} GB`)
+                .item('bullet', `CPU cores: ${result.systemResources.cpuCount}`)
+                .success('System resources check passed')
+                .newline();
+            // 顯示網路狀態
+            this.output
+                .section('Checking Network Status');
+            if (result.networkStatus.isOnline) {
+                this.output.success('Network connected');
+            }
+            else {
+                this.output.error('Network disconnected');
+            }
+            if (result.networkStatus.canReachRegistry) {
+                this.output.success('Registry accessible');
+            }
+            else {
+                this.output.error('Registry not accessible');
+            }
+            // 計算是否有警告
+            const hasWarnings = !memoryOk;
+            // 總結
+            this.output
+                .newline()
+                .divider();
+            if (result.allChecksPassed && !hasWarnings) {
+                // 全部通過，無警告
+                this.output
+                    .newline()
+                    .success('All checks passed. System meets requirements.')
+                    .newline()
+                    .info('You can now install a UOFX instance with:')
+                    .item('bullet', 'uofx env install --name <instance-name>');
+            }
+            else if (result.allChecksPassed && hasWarnings) {
+                // 通過但有警告
+                this.output
+                    .newline()
+                    .warning('Checks passed with warnings. Review the warnings above before proceeding.')
+                    .newline()
+                    .info('You can still install a UOFX instance, but insufficient memory may cause pods to fail starting:')
+                    .item('bullet', 'uofx env install --name <instance-name>');
+            }
+            else {
+                // 有錯誤
+                this.output
+                    .newline()
+                    .error('Some checks failed. Please fix the issues above.')
+                    .newline();
+            }
+            this.output.render();
+        }
+        catch (error) {
+            this.output
+                .error(`Environment check failed: ${(0, error_formatter_util_1.formatErrorMessage)(error)}`)
+                .render();
+            throw error;
+        }
+    }
+};
+exports.SetupController = SetupController;
+exports.SetupController = SetupController = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.SetupEnvironmentUseCase)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.IOutputPort)),
+    __param(2, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.WslUpdaterService)),
+    __param(3, (0, tsyringe_1.inject)(tokens_1.TOKENS.IRuntimeEnvironmentPort)),
+    __metadata("design:paramtypes", [setup_environment_use_case_1.SetupEnvironmentUseCase, Object, Object, Object])
+], SetupController);
+//# sourceMappingURL=setup.controller.js.map

package/dist/presentation/interfaces/cli-options.interface.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * CLI Options 介面定義
+ *
+ * 為 Commander.js 命令選項提供型別安全
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cli-options.interface.js.map

package/dist/presentation/prompts/acr-credentials.prompt.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcrCredentialsPrompt = void 0;
+const prompts_1 = __importDefault(require("prompts"));
+const chalk_1 = __importDefault(require("chalk"));
+const value_objects_1 = require("../../domain/value-objects");
+/**
+ * ACR 憑證互動 Prompt
+ * 負責從使用者獲取 Azure Container Registry 憑證
+ */
+class AcrCredentialsPrompt {
+    /**
+     * 提示使用者輸入 ACR 憑證
+     */
+    async prompt() {
+        console.log(chalk_1.default.cyan('\nℹ Azure Container Registry credentials required\n'));
+        try {
+            const response = await (0, prompts_1.default)([
+                {
+                    type: 'text',
+                    name: 'name',
+                    message: 'ACR Name:',
+                    validate: (value) => value.trim().length > 0 || 'ACR name is required',
+                },
+                {
+                    type: 'text',
+                    name: 'account',
+                    message: 'Account:',
+                    validate: (value) => value.trim().length > 0 || 'Account is required',
+                },
+                {
+                    type: 'password',
+                    name: 'password',
+                    message: 'Password:',
+                    validate: (value) => value.trim().length > 0 || 'Password is required',
+                },
+            ]);
+            // 如果使用者取消（Ctrl+C），prompts 會返回空物件
+            if (!response.name || !response.account || !response.password) {
+                return null;
+            }
+            return value_objects_1.AcrCredentials.create(response.name.trim(), response.account.trim(), response.password.trim());
+        }
+        catch (error) {
+            // 使用者取消輸入
+            console.log(chalk_1.default.yellow('\nPrompt cancelled'));
+            return null;
+        }
+    }
+    /**
+     * 確認是否使用預設憑證
+     */
+    async confirmUseDefault(defaultCredentials) {
+        console.log(chalk_1.default.cyan('\nFound stored ACR credentials:'));
+        console.log(`  ACR Name: ${chalk_1.default.white(defaultCredentials.name)}`);
+        console.log(`  Account:  ${chalk_1.default.white(defaultCredentials.account)}`);
+        console.log('');
+        try {
+            const response = await (0, prompts_1.default)({
+                type: 'confirm',
+                name: 'useDefault',
+                message: 'Use these credentials?',
+                initial: true,
+            });
+            return response.useDefault ?? false;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+}
+exports.AcrCredentialsPrompt = AcrCredentialsPrompt;
+//# sourceMappingURL=acr-credentials.prompt.js.map

package/dist/presentation/prompts/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Presentation Prompts
+ */
+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("./acr-credentials.prompt"), exports);
+//# sourceMappingURL=index.js.map

package/dist/presentation/ui/cli-progress.service.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Progress Service
+ *
+ * 包裝 cli-progress 套件，提供統一的 Progress Bar（進度條）指示器
+ * 用於可預估進度的長時間操作
+ */
+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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliProgress = void 0;
+const tsyringe_1 = require("tsyringe");
+const cli_progress_1 = __importDefault(require("cli-progress"));
+/**
+ * 進度條實例實作
+ * 包裝 cli-progress SingleBar 實例
+ */
+class ProgressBarInstance {
+    constructor(bar, total, message) {
+        this.bar = bar;
+        this.total = total;
+        this.currentMessage = message;
+        this.bar.start(total, 0, { message });
+    }
+    update(current) {
+        this.bar.update(current, { message: this.currentMessage });
+    }
+    increment(delta = 1) {
+        this.bar.increment(delta, { message: this.currentMessage });
+    }
+    setTotal(total) {
+        this.total = total;
+        this.bar.setTotal(total);
+    }
+    updateMessage(message) {
+        this.currentMessage = message;
+        this.bar.update({ message });
+    }
+    stop() {
+        this.bar.stop();
+    }
+}
+/**
+ * 格式化位元組大小
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(1))} ${sizes[i]}`;
+}
+/**
+ * 格式化 ETA 時間
+ */
+function formatEta(seconds) {
+    if (!isFinite(seconds) || seconds < 0)
+        return '--:--';
+    const mins = Math.floor(seconds / 60);
+    const secs = Math.floor(seconds % 60);
+    return `${mins}:${secs.toString().padStart(2, '0')}`;
+}
+/**
+ * CliProgress 實作
+ * 提供創建和管理進度條的功能
+ */
+let CliProgress = class CliProgress {
+    constructor() {
+        this.tty = process.stdout.isTTY ?? false;
+    }
+    /**
+     * 創建並啟動一個新的進度條
+     */
+    create(message, total, options) {
+        const barSize = options?.barSize ?? 40;
+        const barCompleteChar = options?.barCompleteChar ?? '█';
+        const barIncompleteChar = options?.barIncompleteChar ?? '░';
+        const showPercentage = options?.showPercentage ?? true;
+        const showValue = options?.showValue ?? true;
+        const showEta = options?.showEta ?? false;
+        const showSpeed = options?.showSpeed ?? false;
+        // 構建格式字串
+        let format = '{message} [{bar}]';
+        if (showPercentage) {
+            format += ' {percentage}%';
+        }
+        if (showValue) {
+            if (options?.formatValue) {
+                format += ' ({value})';
+            }
+            else {
+                format += ' ({value}/{total})';
+            }
+        }
+        if (showEta) {
+            format += ' ETA: {eta_formatted}';
+        }
+        if (showSpeed) {
+            format += ' {speed}';
+        }
+        const bar = new cli_progress_1.default.SingleBar({
+            format,
+            barCompleteChar,
+            barIncompleteChar,
+            barsize: barSize,
+            hideCursor: options?.hideCursor ?? true,
+            clearOnComplete: options?.clearOnComplete ?? false,
+            stopOnComplete: true,
+            forceRedraw: true,
+            etaBuffer: 10,
+            formatValue: (value, _opts, type) => {
+                // 處理自訂格式化
+                if (type === 'value' && options?.formatValue) {
+                    return options.formatValue(value, total);
+                }
+                if (type === 'total' && options?.formatValue) {
+                    return ''; // 自訂格式化已包含在 value 中
+                }
+                if (type === 'eta' && options?.formatEta) {
+                    return options.formatEta(value);
+                }
+                return String(value);
+            },
+        }, cli_progress_1.default.Presets.shades_classic);
+        return new ProgressBarInstance(bar, total, message);
+    }
+    /**
+     * 創建一個下載進度條（預設顯示 bytes 格式和 ETA）
+     */
+    createDownloadProgress(message, totalBytes) {
+        const format = `{message} [{bar}] {percentage}% ({value}) ETA: {eta_formatted}`;
+        const bar = new cli_progress_1.default.SingleBar({
+            format,
+            barCompleteChar: '█',
+            barIncompleteChar: '░',
+            barsize: 25,
+            hideCursor: true,
+            clearOnComplete: false,
+            stopOnComplete: true,
+            forceRedraw: true,
+            etaBuffer: 10,
+            formatValue: (value, _opts, type) => {
+                if (type === 'value') {
+                    return `${formatBytes(value)} / ${formatBytes(totalBytes)}`;
+                }
+                return String(value);
+            },
+            formatTime: formatEta,
+        }, cli_progress_1.default.Presets.shades_classic);
+        return new ProgressBarInstance(bar, totalBytes, message);
+    }
+    /**
+     * 執行一個非同步操作並顯示進度條
+     */
+    async withProgress(message, total, task, options) {
+        const bar = this.create(message, total, options);
+        const updateProgress = (current) => {
+            bar.update(current);
+        };
+        try {
+            const result = await task(updateProgress);
+            bar.stop();
+            return result;
+        }
+        catch (error) {
+            bar.stop();
+            throw error;
+        }
+    }
+    /**
+     * 檢查環境是否支援進度條
+     */
+    isSupported() {
+        return this.tty;
+    }
+};
+exports.CliProgress = CliProgress;
+exports.CliProgress = CliProgress = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [])
+], CliProgress);
+//# sourceMappingURL=cli-progress.service.js.map

package/dist/presentation/ui/constants/output-symbols.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INDENT_CONFIG = exports.OUTPUT_SYMBOLS = void 0;
+exports.getSymbolForItem = getSymbolForItem;
+/**
+ * 統一的輸出符號定義
+ *
+ * 集中管理 CLI 輸出使用的符號，確保風格一致性
+ */
+exports.OUTPUT_SYMBOLS = {
+    // 狀態符號
+    SUCCESS: '\u2713', // ✓
+    ERROR: '\u2717', // ✗
+    WARNING: '!', // !
+    ARROW: '\u2192', // →
+    BULLET: '\u2022', // •
+    // 分隔符號
+    DIVIDER: '\u2500', // ─
+};
+/**
+ * 縮排配置
+ */
+exports.INDENT_CONFIG = {
+    /** 每層縮排的字元 */
+    UNIT: '  ', // 2 個空格
+    /** 最大縮排層級 */
+    MAX_LEVEL: 5,
+};
+/**
+ * 根據項目類型取得對應符號
+ */
+function getSymbolForItem(type) {
+    const symbolMap = {
+        check: exports.OUTPUT_SYMBOLS.SUCCESS,
+        arrow: exports.OUTPUT_SYMBOLS.ARROW,
+        bullet: exports.OUTPUT_SYMBOLS.BULLET,
+        warning: exports.OUTPUT_SYMBOLS.WARNING,
+        error: exports.OUTPUT_SYMBOLS.ERROR,
+    };
+    return symbolMap[type];
+}
+//# sourceMappingURL=output-symbols.js.map

package/dist/presentation/ui/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Presentation UI Services
+ */
+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 });
+// Enums
+__exportStar(require("./log-level.enum"), exports);
+// Services
+__exportStar(require("./output-builder.service"), exports);
+__exportStar(require("./cli-progress.service"), exports);
+__exportStar(require("./output-formatter.service"), exports);
+__exportStar(require("./interaction.service"), exports);
+//# sourceMappingURL=index.js.map