@uofx/cli 1.0.0

package/dist/infrastructure/platforms/windows/services/windows-features.service.js

@@ -0,0 +1,191 @@
+"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.WindowsFeaturesService = exports.VM_PLATFORM_FEATURE_NAME = exports.WSL_FEATURE_NAME = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../../di/tokens");
+const errors_1 = require("../../../errors");
+const command_builder_1 = require("../../../execution/command-builder");
+/**
+ * Windows 功能管理服務
+ *
+ * 負責檢查與啟用 Windows 相關功能（如 WSL, 虛擬機器平台），包含：
+ * - 檢查功能狀態
+ * - 檢查管理員權限
+ * - 啟用功能
+ * - 格式化狀態報告
+ */
+exports.WSL_FEATURE_NAME = 'Microsoft-Windows-Subsystem-Linux';
+exports.VM_PLATFORM_FEATURE_NAME = 'VirtualMachinePlatform';
+let WindowsFeaturesService = class WindowsFeaturesService {
+    constructor(commandExecutor) {
+        this.commandExecutor = commandExecutor;
+    }
+    /**
+     * 檢查單一 Windows 功能的狀態
+     * @param featureName - Windows 功能名稱
+     * @returns 功能狀態 ('Enabled', 'Disabled', 'Unknown')
+     * @throws AppSystemError 若查詢失敗
+     */
+    async checkFeatureState(featureName) {
+        try {
+            const builder = command_builder_1.CommandBuilder.create('powershell')
+                .powershell(`[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; $feature = Get-WindowsOptionalFeature -Online -FeatureName ${featureName}; $feature.State`);
+            const result = await builder.exec(this.commandExecutor);
+            const output = result.stdout.trim();
+            if (output.includes('Enable')) {
+                return 'Enabled';
+            }
+            else if (output.includes('Disable')) {
+                return 'Disabled';
+            }
+            else {
+                return 'Unknown';
+            }
+        }
+        catch (error) {
+            throw new errors_1.AppError(`Failed to check Windows feature: ${featureName}`, {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                solution: 'Ensure PowerShell is available and you have permission to query Windows features',
+                cause: error,
+                context: { operation: 'checkFeatureState', resource: 'PowerShell Get-WindowsOptionalFeature' }
+            });
+        }
+    }
+    /**
+     * 檢查 WSL 相關功能的狀態
+     * 包含 'Microsoft-Windows-Subsystem-Linux' 和 'VirtualMachinePlatform'
+     * @returns WSL 功能狀態報告
+     */
+    async checkWSLFeatures() {
+        const wslState = await this.checkFeatureState(exports.WSL_FEATURE_NAME);
+        const wsl = {
+            name: exports.WSL_FEATURE_NAME,
+            displayName: 'Windows Subsystem for Linux',
+            state: wslState
+        };
+        const vmState = await this.checkFeatureState(exports.VM_PLATFORM_FEATURE_NAME);
+        const virtualMachine = {
+            name: exports.VM_PLATFORM_FEATURE_NAME,
+            displayName: 'Virtual Machine Platform',
+            state: vmState
+        };
+        const allEnabled = wslState === 'Enabled' && vmState === 'Enabled';
+        const missingFeatures = [];
+        if (wslState !== 'Enabled') {
+            missingFeatures.push(wsl);
+        }
+        if (vmState !== 'Enabled') {
+            missingFeatures.push(virtualMachine);
+        }
+        return {
+            wsl,
+            virtualMachine,
+            allEnabled,
+            missingFeatures
+        };
+    }
+    /**
+     * 檢查當前處理程序是否具有管理員權限
+     * @returns 若具有管理員權限則回傳 true
+     * @throws AppSystemError 若檢查失敗
+     */
+    async checkAdminPrivileges() {
+        try {
+            const builder = command_builder_1.CommandBuilder.create('powershell')
+                .powershell("([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] 'Administrator')");
+            const result = await builder.exec(this.commandExecutor);
+            const output = result.stdout.trim();
+            return output === 'True';
+        }
+        catch (error) {
+            throw new errors_1.AppError('Failed to check administrator privileges', {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                solution: 'Ensure PowerShell is available and you have permission to check privileges',
+                cause: error,
+                context: { operation: 'checkAdminPrivileges', resource: 'PowerShell Security.Principal' }
+            });
+        }
+    }
+    /**
+     * 啟用指定的 Windows 功能
+     * @param features - 要啟用的功能列表
+     * @returns 成功啟用的功能數量
+     * @throws AppSystemError 若啟用失敗
+     */
+    async enableWSLFeatures(features) {
+        let enabledCount = 0;
+        for (const feature of features) {
+            try {
+                const builder = command_builder_1.CommandBuilder.create('dism.exe')
+                    .arg('/online')
+                    .arg('/enable-feature')
+                    .arg(`/featurename:${feature.name}`)
+                    .arg('/all')
+                    .arg('/norestart');
+                await builder.exec(this.commandExecutor);
+                enabledCount++;
+            }
+            catch (error) {
+                throw new errors_1.AppError(`Failed to enable Windows feature: ${feature.displayName}`, {
+                    exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                    solution: 'Ensure you have administrator privileges and try again',
+                    cause: error,
+                    context: { operation: 'enableWSLFeatures', resource: 'dism.exe' }
+                });
+            }
+        }
+        return enabledCount;
+    }
+    /**
+     * 檢查 WSL 功能需求（整合檢查）
+     * @returns 檢查結果（包含錯誤與警告）
+     */
+    async checkWSLFeaturesRequirement() {
+        const blockingErrors = [];
+        try {
+            const status = await this.checkWSLFeatures();
+            if (!status.allEnabled) {
+                const missingFeatureNames = status.missingFeatures
+                    .map(f => f.displayName)
+                    .join(', ');
+                blockingErrors.push({
+                    code: 'WSL_FEATURES_MISSING',
+                    message: `Required Windows features are not enabled: ${missingFeatureNames}`,
+                    solution: 'Run this command as administrator and agree to enable the features, or manually run: wsl --install'
+                });
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            blockingErrors.push({
+                code: 'WSL_FEATURES_CHECK_FAILED',
+                message: `Failed to check WSL features: ${errorMessage}`,
+                solution: 'Ensure you have administrator privileges and PowerShell is available. Try running as administrator.'
+            });
+        }
+        return {
+            passed: blockingErrors.length === 0,
+            blockingErrors,
+            warnings: []
+        };
+    }
+};
+exports.WindowsFeaturesService = WindowsFeaturesService;
+exports.WindowsFeaturesService = WindowsFeaturesService = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.ICommandExecutor)),
+    __metadata("design:paramtypes", [Object])
+], WindowsFeaturesService);
+//# sourceMappingURL=windows-features.service.js.map

package/dist/infrastructure/platforms/windows/services/windows-info.service.js

@@ -0,0 +1,138 @@
+"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.WindowsInfoService = exports.MIN_WIN11_BUILD = exports.MIN_WIN10_BUILD = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../../di/tokens");
+const command_builder_1 = require("../../../execution/command-builder");
+const errors_1 = require("../../../errors");
+/**
+ * Windows 支援的最低 Build 號碼
+ */
+exports.MIN_WIN10_BUILD = 19041; // Windows 10 Version 2004
+exports.MIN_WIN11_BUILD = 22000; // Windows 11
+/**
+ * PowerShell 查詢命令
+ */
+const PS_QUERY_COMMAND = '[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; Get-CimInstance Win32_OperatingSystem | Select-Object Caption, Version, BuildNumber | ConvertTo-Json';
+let WindowsInfoService = class WindowsInfoService {
+    constructor(commandExecutor) {
+        this.commandExecutor = commandExecutor;
+    }
+    async getWindowsVersion() {
+        // 檢查是否在 Windows 平台上執行
+        if (process.platform !== 'win32') {
+            throw new errors_1.AppError(`Unsupported platform: ${process.platform}. This tool requires Windows.`, {
+                exitCode: errors_1.EXIT_CODES.ENVIRONMENT_ERROR,
+                solution: 'This tool requires Windows 10 (Build 19041+) or Windows 11. Please run on a Windows system.',
+                context: { operation: 'getWindowsVersion', resource: 'Windows OS', platform: process.platform }
+            });
+        }
+        try {
+            const builder = command_builder_1.CommandBuilder.create('powershell')
+                .arg('-NoProfile')
+                .arg('-NoLogo')
+                .arg('-Command')
+                .arg(`"${PS_QUERY_COMMAND}"`);
+            const result = await builder.exec(this.commandExecutor);
+            const info = JSON.parse(result.stdout.trim());
+            if (!info.Caption || !info.Version || !info.BuildNumber) {
+                throw new Error('Invalid PowerShell output format');
+            }
+            const buildNumber = parseInt(info.BuildNumber, 10);
+            if (isNaN(buildNumber)) {
+                throw new Error(`Invalid build number: ${info.BuildNumber}`);
+            }
+            const isWindows11 = buildNumber >= exports.MIN_WIN11_BUILD;
+            const isSupported = buildNumber >= exports.MIN_WIN10_BUILD;
+            return {
+                productName: info.Caption,
+                version: info.Version,
+                buildNumber,
+                isWindows11,
+                isSupported
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.AppError) {
+                throw error;
+            }
+            throw new errors_1.AppError('Failed to query Windows version information', {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                solution: 'Ensure PowerShell is available and you have permission to query system information',
+                cause: error,
+                context: { operation: 'getWindowsVersion', resource: 'PowerShell' }
+            });
+        }
+    }
+    isWindowsSupported(version) {
+        if (version.isWindows11) {
+            return true;
+        }
+        return version.buildNumber >= exports.MIN_WIN10_BUILD;
+    }
+    async checkWindowsVersionRequirement() {
+        const blockingErrors = [];
+        if (process.platform !== 'win32') {
+            const platformNames = {
+                darwin: 'macOS',
+                linux: 'Linux',
+                freebsd: 'FreeBSD',
+                openbsd: 'OpenBSD'
+            };
+            const platformName = platformNames[process.platform] || process.platform;
+            blockingErrors.push({
+                code: 'WIN_PLATFORM',
+                message: `Unsupported platform: ${process.platform} (${platformName})`,
+                solution: 'This tool requires Windows 10 (Build 19041+) or Windows 11. Please run on a Windows system.'
+            });
+            return {
+                passed: false,
+                blockingErrors,
+                warnings: []
+            };
+        }
+        try {
+            const version = await this.getWindowsVersion();
+            if (!version.isSupported) {
+                const name = version.productName.replace('Microsoft ', '');
+                blockingErrors.push({
+                    code: 'WIN_VERSION',
+                    message: `Windows version not supported: ${name} (Build ${version.buildNumber})`,
+                    solution: `Please upgrade to Windows 10 (Build ${exports.MIN_WIN10_BUILD}) or higher. Visit https://aka.ms/wslinstall for more information.`
+                });
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            blockingErrors.push({
+                code: 'WIN_VERSION_CHECK_FAILED',
+                message: `Failed to check Windows version: ${errorMessage}`,
+                solution: 'Ensure PowerShell is available and you have permission to query system information.'
+            });
+        }
+        return {
+            passed: blockingErrors.length === 0,
+            blockingErrors,
+            warnings: []
+        };
+    }
+};
+exports.WindowsInfoService = WindowsInfoService;
+exports.WindowsInfoService = WindowsInfoService = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.ICommandExecutor)),
+    __metadata("design:paramtypes", [Object])
+], WindowsInfoService);
+//# sourceMappingURL=windows-info.service.js.map

package/dist/infrastructure/platforms/windows/services/wsl-config.service.js

@@ -0,0 +1,171 @@
+"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.WslConfigService = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../../../di/tokens");
+const index_1 = require("../../../../constants/index");
+const input_validator_util_1 = require("../../../utils/input-validator.util");
+/**
+ * 延遲執行輔助函式
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * WSL 配置服務
+ *
+ * 負責 WSL 實例的配置管理,包括建立 wsl.conf 檔案、
+ * 啟用 systemd、設定預設使用者等。
+ *
+ * 安全性：
+ * - 所有使用者輸入都經過驗證
+ * - 使用 CommandBuilder 避免命令注入
+ * - 敏感資料透過 stdin 傳遞
+ */
+let WslConfigService = class WslConfigService {
+    constructor(envFactory, appLogger) {
+        this.envFactory = envFactory;
+        this.appLogger = appLogger;
+    }
+    get hostEnv() {
+        return this.envFactory.getHostEnvironment();
+    }
+    /**
+     * 生成 WSL 配置檔案內容
+     *
+     * 安全性設計：
+     * - [automount] enabled=false：禁用 Windows 檔案系統掛載（/mnt/c 等），
+     *   避免在 WSL 中誤執行 rm 等命令刪除 Windows 檔案，
+     *   同時讓進入 WSL 時預設目錄為用戶 home 目錄而非 Windows 路徑
+     * - [interop] appendWindowsPath=false：禁用 Windows PATH 附加，
+     *   因為 automount=false 後 Windows 路徑無法轉換，會產生警告訊息
+     *
+     * @param defaultUser 預設使用者名稱
+     * @returns WSL 配置檔案內容
+     */
+    generateWslConfigContent(defaultUser = 'ubuntu') {
+        (0, input_validator_util_1.requireValidUsername)(defaultUser);
+        return `[boot]
+systemd=true
+
+[user]
+default=${defaultUser}
+
+[automount]
+enabled=false
+
+[interop]
+appendWindowsPath=false`;
+    }
+    async createWslConfig(instanceName, defaultUser = 'ubuntu') {
+        // 驗證輸入
+        (0, input_validator_util_1.requireValidInstanceName)(instanceName);
+        (0, input_validator_util_1.requireValidUsername)(defaultUser);
+        this.appLogger?.debug('[WSL] Creating wsl.conf', {
+            instanceName,
+            defaultUser,
+            component: 'WslConfigService'
+        });
+        // 生成完整的配置內容
+        const configContent = this.generateWslConfigContent(defaultUser);
+        // 使用 stdin 傳遞配置內容，避免命令注入
+        const env = this.envFactory.getForInstance(instanceName);
+        const builder = env.shellScript('cat > /etc/wsl.conf')
+            .stdin(configContent);
+        const result = await builder.exec();
+        if (result.exitCode !== 0) {
+            throw new Error(`Failed to create wsl.conf in instance '${instanceName}': ${result.stderr}`);
+        }
+        return true;
+    }
+    async restartWslInstance(instanceName) {
+        (0, input_validator_util_1.requireValidInstanceName)(instanceName);
+        // 使用 wslCmd 終止實例
+        const terminateBuilder = this.hostEnv.wslCmd('--terminate')
+            .arg(instanceName);
+        const terminateResult = await terminateBuilder.exec();
+        if (terminateResult.exitCode !== 0) {
+            throw new Error(`Failed to terminate instance '${instanceName}': ${terminateResult.stderr}`);
+        }
+        await sleep(index_1.TIMEOUTS.WSL_CONFIG_APPLY);
+        // 重啟實例
+        const env = this.envFactory.getForInstance(instanceName);
+        const restartBuilder = env.shell('exit');
+        const restartResult = await restartBuilder.exec();
+        if (restartResult.exitCode !== 0) {
+            throw new Error(`Failed to restart instance '${instanceName}': ${restartResult.stderr}`);
+        }
+        await sleep(index_1.TIMEOUTS.WSL_SHUTDOWN_DELAY);
+    }
+    async checkUserExists(instanceName, username) {
+        (0, input_validator_util_1.requireValidInstanceName)(instanceName);
+        (0, input_validator_util_1.requireValidUsername)(username);
+        try {
+            const env = this.envFactory.getForInstance(instanceName);
+            const builder = env.shell('id')
+                .arg(username);
+            const result = await builder.exec();
+            return result.exitCode === 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    async createUser(instanceName, username = 'ubuntu') {
+        // 驗證輸入
+        (0, input_validator_util_1.requireValidInstanceName)(instanceName);
+        (0, input_validator_util_1.requireValidUsername)(username);
+        if (await this.checkUserExists(instanceName, username)) {
+            return true;
+        }
+        const env = this.envFactory.getForInstance(instanceName);
+        // 建立使用者
+        const createBuilder = env.shell('useradd')
+            .arg('-m')
+            .arg('-s')
+            .arg('/bin/bash')
+            .arg(username);
+        const createResult = await createBuilder.exec();
+        if (createResult.exitCode !== 0) {
+            throw new Error(`Failed to create user '${username}' in instance '${instanceName}': ${createResult.stderr}`);
+        }
+        // 加入 sudo 群組
+        const sudoGroupBuilder = env.shell('usermod')
+            .arg('-aG')
+            .arg('sudo')
+            .arg(username);
+        const sudoGroupResult = await sudoGroupBuilder.exec();
+        if (sudoGroupResult.exitCode !== 0) {
+            throw new Error(`Failed to add user '${username}' to sudo group: ${sudoGroupResult.stderr}`);
+        }
+        // 設定 sudoers 權限 - 使用 stdin 傳遞內容，避免命令注入
+        const sudoersContent = `${username} ALL=(ALL) NOPASSWD:ALL\n`;
+        const sudoersBuilder = env.shellScript(`cat > /etc/sudoers.d/${username}`)
+            .stdin(sudoersContent);
+        const sudoersResult = await sudoersBuilder.exec();
+        if (sudoersResult.exitCode !== 0) {
+            throw new Error(`Failed to configure passwordless sudo for '${username}': ${sudoersResult.stderr}`);
+        }
+        return true;
+    }
+};
+exports.WslConfigService = WslConfigService;
+exports.WslConfigService = WslConfigService = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.IExecutionEnvironmentFactory)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
+    __metadata("design:paramtypes", [Object, Object])
+], WslConfigService);
+//# sourceMappingURL=wsl-config.service.js.map