@uofx/cli 1.0.2 → 1.1.0

package/dist/infrastructure/execution/command-executor.service.js

@@ -1,230 +0,0 @@
-"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.CommandExecutorService = void 0;
-const tsyringe_1 = require("tsyringe");
-const child_process_1 = require("child_process");
-const defaults_1 = require("../../constants/defaults");
-const sensitive_decorator_1 = require("../../domain/decorators/sensitive.decorator");
-/**
- * 命令執行器服務
- *
- * 使用 Node.js child_process 模組實作 ICommandExecutor 介面,
- * 提供真實的命令執行功能。支援同步和非同步執行、串流輸出、timeout 機制。
- */
-let CommandExecutorService = class CommandExecutorService {
-    /**
-     * 同步執行命令
-     * @param command - 要執行的命令字串
-     * @param options - 執行選項（如 cwd, env, timeout）
-     * @param showOutput - 是否在 stdout 顯示輸出（預設：true）
-     * @param suppressStderr - 是否隱藏 stderr 輸出（預設：false）
-     * @param _safeCommandForLogging - 用於日誌記錄的安全命令字串（隱藏敏感資料）
-     * @returns 命令執行結果，包含 stdout, stderr 和 exitCode
-     * @throws 當命令執行嚴重失敗且無法捕捉時拋出 Error
-     */
-    execSync(command, options, _showOutput = true, suppressStderr = false, _safeCommandForLogging) {
-        // 處理 shell 選項
-        let shell;
-        if (options?.shell === true) {
-            shell = process.platform === 'win32' ? 'cmd.exe' : '/bin/sh';
-        }
-        else if (typeof options?.shell === 'string') {
-            shell = options.shell;
-        }
-        const execOptions = {
-            // encoding: 'buffer' 会導致 ERR_UNKNOWN_ENCODING，設為 undefined 則會返回 Buffer
-            encoding: undefined,
-            cwd: options?.cwd,
-            env: options?.env,
-            timeout: options?.timeout,
-            shell,
-            maxBuffer: defaults_1.FILE_SIZE.MAX_COMMAND_BUFFER,
-            input: options?.input,
-            // 總是 pipe stderr 以便正確解碼 UTF-16LE
-            stdio: suppressStderr ? ['pipe', 'pipe', 'ignore'] : ['pipe', 'pipe', 'pipe'],
-        };
-        try {
-            const stdoutBuffer = (0, child_process_1.execSync)(command, execOptions);
-            const stdout = this.decodeBuffer(stdoutBuffer);
-            return {
-                stdout,
-                stderr: '',
-                exitCode: 0,
-            };
-        }
-        catch (error) {
-            if (error && typeof error === 'object' && 'status' in error) {
-                const execError = error;
-                const stdout = this.decodeBuffer(execError.stdout);
-                const stderr = this.decodeBuffer(execError.stderr);
-                return {
-                    stdout,
-                    stderr: stderr,
-                    exitCode: execError.status ?? 1,
-                };
-            }
-            throw new Error(`Command execution failed: ${String(error)}`);
-        }
-    }
-    /**
-     * 非同步執行命令
-     * @param command - 要執行的命令字串
-     * @param onStdout - 標準輸出回調函式
-     * @param onStderr - 標準錯誤回調函式
-     * @param options - 執行選項（如 cwd, env, timeout）
-     * @param _safeCommandForLogging - 用於日誌記錄的安全命令字串（隱藏敏感資料）
-     * @returns 解析為命令執行結果的 Promise
-     */
-    async exec(command, onStdout, onStderr, options, _safeCommandForLogging) {
-        return new Promise((resolve, reject) => {
-            const encoding = options?.encoding ?? 'utf8';
-            // 預設 shell 為 true 以支援命令字串
-            let shell = true;
-            if (options?.shell === false) {
-                shell = false;
-            }
-            else if (typeof options?.shell === 'string') {
-                shell = options.shell;
-            }
-            // 如果需要繼承 stdio（用於 WSL 安裝等需要終端訪問的命令）
-            if (options?.inheritStdio) {
-                const spawnOptions = {
-                    cwd: options?.cwd,
-                    env: options?.env,
-                    shell,
-                    stdio: 'inherit',
-                };
-                const childProcess = (0, child_process_1.spawn)(command, [], spawnOptions);
-                childProcess.on('close', (code) => {
-                    resolve({
-                        stdout: '',
-                        stderr: '',
-                        exitCode: code ?? 0,
-                    });
-                });
-                childProcess.on('error', (error) => {
-                    reject(new Error(`Failed to execute command: ${error.message}`));
-                });
-                return;
-            }
-            const spawnOptions = {
-                cwd: options?.cwd,
-                env: options?.env,
-                shell,
-                encoding,
-            };
-            const childProcess = (0, child_process_1.spawn)(command, [], spawnOptions);
-            if (options?.input && childProcess.stdin) {
-                childProcess.stdin.write(options.input);
-                childProcess.stdin.end();
-            }
-            // 累積輸出 Buffer
-            const stdoutChunks = [];
-            const stderrChunks = [];
-            // 監聽標準輸出
-            if (childProcess.stdout) {
-                childProcess.stdout.on('data', (data) => {
-                    stdoutChunks.push(data);
-                    if (onStdout) {
-                        onStdout(this.decodeBuffer(data));
-                    }
-                });
-            }
-            // 監聽標準錯誤輸出
-            if (childProcess.stderr) {
-                childProcess.stderr.on('data', (data) => {
-                    stderrChunks.push(data);
-                    if (onStderr) {
-                        onStderr(this.decodeBuffer(data));
-                    }
-                });
-            }
-            // 設定 timeout (如果有指定)
-            let timeoutId;
-            if (options?.timeout) {
-                timeoutId = setTimeout(() => {
-                    childProcess.kill('SIGTERM');
-                    reject(new Error(`Command timed out after ${options.timeout}ms`));
-                }, options.timeout);
-            }
-            // 監聽進程結束
-            childProcess.on('close', (code) => {
-                if (timeoutId) {
-                    clearTimeout(timeoutId);
-                }
-                const stdoutBuffer = Buffer.concat(stdoutChunks);
-                const stderrBuffer = Buffer.concat(stderrChunks);
-                resolve({
-                    stdout: this.decodeBuffer(stdoutBuffer),
-                    stderr: this.decodeBuffer(stderrBuffer),
-                    exitCode: code ?? 0,
-                });
-            });
-            childProcess.on('error', (error) => {
-                if (timeoutId) {
-                    clearTimeout(timeoutId);
-                }
-                reject(new Error(`Failed to execute command: ${error.message}`));
-            });
-        });
-    }
-    /**
-     * 解碼 Buffer
-     * 嘗試偵測 UTF-16 LE (常見於 Windows/WSL 輸出)，否則使用 UTF-8
-     */
-    decodeBuffer(buffer) {
-        if (!buffer)
-            return '';
-        if (typeof buffer === 'string')
-            return buffer;
-        if (buffer.length === 0)
-            return '';
-        // 1. 檢查 UTF-16LE BOM (FF FE)
-        if (buffer.length >= 2 && buffer[0] === 0xFF && buffer[1] === 0xFE) {
-            return buffer.toString('utf16le');
-        }
-        // 2. 檢查是否為 UTF-16LE (無 BOM)
-        // WSL 輸出通常沒有 BOM,但使用 UTF-16LE 編碼
-        const sample = buffer.subarray(0, Math.min(buffer.length, 200));
-        let nullCount = 0;
-        for (let i = 0; i < sample.length; i++) {
-            if (sample[i] === 0)
-                nullCount++;
-        }
-        // 如果 null bytes 超過 20%,很可能是 UTF-16LE
-        if (nullCount > sample.length * 0.2) {
-            return buffer.toString('utf16le');
-        }
-        // 3. 預設使用 UTF-8
-        return buffer.toString('utf8');
-    }
-};
-exports.CommandExecutorService = CommandExecutorService;
-__decorate([
-    __param(1, (0, sensitive_decorator_1.Sensitive)()),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Object, Boolean, Boolean, String]),
-    __metadata("design:returntype", Object)
-], CommandExecutorService.prototype, "execSync", null);
-__decorate([
-    __param(3, (0, sensitive_decorator_1.Sensitive)()),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, Function, Function, Object, String]),
-    __metadata("design:returntype", Promise)
-], CommandExecutorService.prototype, "exec", null);
-exports.CommandExecutorService = CommandExecutorService = __decorate([
-    (0, tsyringe_1.injectable)()
-], CommandExecutorService);
-//# sourceMappingURL=command-executor.service.js.map