@uofx/cli 1.0.2 → 1.1.0

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

@@ -0,0 +1,389 @@
+"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); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandExecutorService = void 0;
+const tsyringe_1 = require("tsyringe");
+const child_process_1 = require("child_process");
+const cross_spawn_1 = __importDefault(require("cross-spawn"));
+const defaults_1 = require("../../../constants/defaults");
+const sensitive_decorator_1 = require("../../interceptors/decorators/sensitive.decorator");
+const errors_1 = require("../../../domain/errors");
+/**
+ * 命令執行器服務
+ *
+ * 使用 Node.js child_process 模組實作 ICommandExecutor 介面,
+ * 提供真實的命令執行功能。支援同步和非同步執行、串流輸出、timeout 機制。
+ */
+let CommandExecutorService = class CommandExecutorService {
+    /**
+     * 同步執行命令
+     * @param ctx - 執行上下文（命令、安全命令、選項）
+     * @param opts - 同步執行選項（顯示輸出、抑制 stderr）
+     * @returns 命令執行結果
+     */
+    execSync(ctx, opts) {
+        const { command, options } = ctx;
+        const suppressStderr = opts?.suppressStderr ?? false;
+        // 處理 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 errors_1.AppError(`Command execution failed: ${String(error)}`, {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+            });
+        }
+    }
+    /**
+     * 非同步執行命令
+     * @param ctx - 執行上下文（命令、安全命令、選項）
+     * @param callbacks - 標準輸出/錯誤回調函式
+     * @returns 命令執行結果
+     */
+    async exec(ctx, callbacks) {
+        const { command, options } = ctx;
+        const onStdout = callbacks?.onStdout;
+        const onStderr = callbacks?.onStderr;
+        return new Promise((resolve, reject) => {
+            // 預設 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 errors_1.AppError(`Failed to execute command: ${error.message}`, {
+                        exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                    }));
+                });
+                return;
+            }
+            const spawnOptions = {
+                cwd: options?.cwd,
+                env: options?.env,
+                shell,
+                encoding: options?.encoding ?? 'utf8',
+            };
+            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 errors_1.AppError(`Command timed out after ${options.timeout}ms`, {
+                        exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                    }));
+                }, 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 errors_1.AppError(`Failed to execute command: ${error.message}`, {
+                    exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                }));
+            });
+        });
+    }
+    /**
+     * 直接模式執行命令（command + args，無 shell）
+     * 使用 cross-spawn 處理跨平台相容性（自動處理 Windows .cmd、正確跳脫引數），
+     * 不經由 shell 解析，從根源消除 command injection 攻擊面。
+     * @param command - 可執行檔名稱（如 'npx', 'npm'）
+     * @param args - 參數陣列
+     * @param callbacks - 標準輸出/錯誤回調函式
+     * @param options - 執行選項（如 cwd, env, timeout, inheritStdio）
+     * @returns 解析為命令執行結果的 Promise
+     */
+    async spawnProcess(command, args, callbacks, options) {
+        const onStdout = callbacks?.onStdout;
+        const onStderr = callbacks?.onStderr;
+        return new Promise((resolve, reject) => {
+            // 如果需要繼承 stdio（用於需要終端互動的命令）
+            if (options?.inheritStdio) {
+                const childProcess = (0, cross_spawn_1.default)(command, args, {
+                    cwd: options?.cwd,
+                    env: options?.env,
+                    stdio: 'inherit',
+                });
+                childProcess.on('close', (code) => {
+                    resolve({
+                        stdout: '',
+                        stderr: '',
+                        exitCode: code ?? 0,
+                    });
+                });
+                childProcess.on('error', (error) => {
+                    reject(new errors_1.AppError(`Failed to execute command: ${error.message}`, {
+                        exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                    }));
+                });
+                return;
+            }
+            // 根據是否有 input 決定 stdin 模式
+            const hasInput = !!options?.input;
+            const childProcess = (0, cross_spawn_1.default)(command, args, {
+                cwd: options?.cwd,
+                env: options?.env,
+                stdio: [hasInput ? 'pipe' : 'inherit', 'pipe', 'pipe'],
+            });
+            if (hasInput && 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 errors_1.AppError(`Command timed out after ${options.timeout}ms`, {
+                        exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                    }));
+                }, 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 errors_1.AppError(`Failed to execute command: ${error.message}`, {
+                    exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                }));
+            });
+        });
+    }
+    /**
+     * 直接模式同步執行命令（command + args，無 shell）
+     * 使用 cross-spawn 處理跨平台相容性，不經由 shell 解析，
+     * 從根源消除 command injection 攻擊面。
+     * @param command - 可執行檔名稱（如 'wsl', 'node'）
+     * @param args - 參數陣列
+     * @param opts - 同步執行選項與額外選項
+     * @returns 命令執行結果
+     */
+    spawnProcessSync(command, args, opts) {
+        const suppressStderr = opts?.suppressStderr ?? false;
+        const options = opts?.options;
+        try {
+            const result = cross_spawn_1.default.sync(command, args, {
+                cwd: options?.cwd,
+                env: options?.env,
+                timeout: options?.timeout,
+                input: options?.input,
+                maxBuffer: defaults_1.FILE_SIZE.MAX_COMMAND_BUFFER,
+                stdio: suppressStderr ? ['pipe', 'pipe', 'ignore'] : ['pipe', 'pipe', 'pipe'],
+            });
+            if (result.error) {
+                throw new errors_1.AppError(`Failed to execute command: ${result.error.message}`, {
+                    exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                });
+            }
+            const stdout = this.decodeBuffer(result.stdout);
+            const stderr = result.stderr ? this.decodeBuffer(result.stderr) : '';
+            return {
+                stdout,
+                stderr,
+                exitCode: result.status ?? 1,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_1.AppError) {
+                throw error;
+            }
+            throw new errors_1.AppError(`Command execution failed: ${String(error)}`, {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+            });
+        }
+    }
+    /**
+     * 解碼 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(0, (0, sensitive_decorator_1.Sensitive)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Object)
+], CommandExecutorService.prototype, "execSync", null);
+__decorate([
+    __param(0, (0, sensitive_decorator_1.Sensitive)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], CommandExecutorService.prototype, "exec", null);
+__decorate([
+    __param(2, (0, sensitive_decorator_1.Sensitive)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Array, Object]),
+    __metadata("design:returntype", Object)
+], CommandExecutorService.prototype, "spawnProcessSync", null);
+exports.CommandExecutorService = CommandExecutorService = __decorate([
+    (0, tsyringe_1.injectable)()
+], CommandExecutorService);
+//# sourceMappingURL=command-executor.service.js.map

package/dist/infrastructure/execution/services/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScriptExecutorService = exports.CommandExecutorService = void 0;
+var command_executor_service_1 = require("./command-executor.service");
+Object.defineProperty(exports, "CommandExecutorService", { enumerable: true, get: function () { return command_executor_service_1.CommandExecutorService; } });
+var script_executor_service_1 = require("./script-executor.service");
+Object.defineProperty(exports, "ScriptExecutorService", { enumerable: true, get: function () { return script_executor_service_1.ScriptExecutorService; } });
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/execution/{script-executor.service.js → services/script-executor.service.js}

@@ -14,18 +14,17 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ScriptExecutorService = void 0;
 const tsyringe_1 = require("tsyringe");
-const tokens_1 = require("../../di/tokens");
-const sensitive_decorator_1 = require("../../domain/decorators/sensitive.decorator");
-const input_validator_util_1 = require("../utils/input-validator.util");
-const errors_1 = require("../errors");
-const index_1 = require("../../constants/index");
+const tokens_1 = require("../../../di/tokens");
+const sensitive_decorator_1 = require("../../interceptors/decorators/sensitive.decorator");
+const input_validator_util_1 = require("../../utils/input-validator.util");
+const errors_1 = require("../../../domain/errors");
+const index_1 = require("../../../constants/index");
 /**
  * ScriptExecutor 類別負責在 WSL 實例中執行 bash 腳本
  */
 let ScriptExecutorService = class ScriptExecutorService {
-    constructor(envFactory, commandExecutor, logger, ociArtifact) {
+    constructor(envFactory, logger, ociArtifact) {
         this.envFactory = envFactory;
-        this.commandExecutor = commandExecutor;
         this.logger = logger;
         this.ociArtifact = ociArtifact;
     }
@@ -54,11 +53,10 @@ let ScriptExecutorService = class ScriptExecutorService {
             .arg('--')
             .arg('bash')
             .arg(scriptPath);
-        // 取得建構好的命令，加上 timeout 選項執行
-        const command = builder.buildActual();
+        // 透過 withOptions 設定 timeout，使用 builder 的 exec() 執行
         let scriptOutput = '';
         try {
-            const result = await this.commandExecutor.exec(command, (stdout) => {
+            const result = await builder.withOptions({ timeout }).exec((stdout) => {
                 scriptOutput += stdout;
                 if (showDetail) {
                     // 詳細模式：記錄所有輸出到 debug log
@@ -80,7 +78,7 @@ let ScriptExecutorService = class ScriptExecutorService {
                     // 記錄 stderr 到 error log
                     this.logger.error(new Error(`Script stderr: ${stderr}`));
                 }
-            }, { timeout, shell: true }, builder.buildSafe());
+            });
             return { exitCode: result.exitCode, output: scriptOutput };
         }
         catch (error) {
@@ -163,9 +161,8 @@ __decorate([
 exports.ScriptExecutorService = ScriptExecutorService = __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.Internal.ICommandExecutor)),
-    __param(2, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
-    __param(3, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.IOciArtifactService)),
-    __metadata("design:paramtypes", [Object, Object, Object, Object])
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
+    __param(2, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.IOciArtifactService)),
+    __metadata("design:paramtypes", [Object, Object, Object])
 ], ScriptExecutorService);
 //# sourceMappingURL=script-executor.service.js.map

package/dist/infrastructure/filesystem/filesystem.adapter.js

@@ -0,0 +1,86 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemAdapter = void 0;
+const tsyringe_1 = require("tsyringe");
+const fs = __importStar(require("fs"));
+/**
+ * 檔案系統 Adapter
+ *
+ * 實作 IFileSystemPort，封裝 Node.js fs 模組操作
+ */
+let FileSystemAdapter = class FileSystemAdapter {
+    /**
+     * 檢查檔案或目錄是否存在
+     * @param filePath - 檔案或目錄路徑
+     * @returns 是否存在
+     */
+    async exists(filePath) {
+        return fs.existsSync(filePath);
+    }
+    /**
+     * 複製檔案
+     * @param src - 來源檔案路徑
+     * @param dest - 目標檔案路徑
+     */
+    async copyFile(src, dest) {
+        fs.copyFileSync(src, dest);
+    }
+    /**
+     * 確保目錄存在（若不存在則遞迴建立）
+     * @param dirPath - 目錄路徑
+     */
+    async ensureDir(dirPath) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+    /**
+     * 遞迴刪除目錄
+     * @param dirPath - 目錄路徑
+     */
+    async removeDir(dirPath) {
+        fs.rmSync(dirPath, { recursive: true, force: true });
+    }
+};
+exports.FileSystemAdapter = FileSystemAdapter;
+exports.FileSystemAdapter = FileSystemAdapter = __decorate([
+    (0, tsyringe_1.injectable)()
+], FileSystemAdapter);
+//# sourceMappingURL=filesystem.adapter.js.map

package/dist/infrastructure/filesystem/index.js

@@ -0,0 +1,23 @@
+"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 });
+/**
+ * 檔案系統模組
+ *
+ * 匯出檔案系統 Adapter，實作 Domain 層的 IFileSystemPort
+ */
+__exportStar(require("./filesystem.adapter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/http/{http-client.service.js → http-client.adapter.js}

@@ -39,16 +39,17 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpClientService = void 0;
+exports.HttpClientAdapter = void 0;
 const tsyringe_1 = require("tsyringe");
 const axios_1 = __importStar(require("axios"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const timeouts_1 = require("../../constants/timeouts");
+const errors_1 = require("../../domain/errors");
 /**
  * HTTP 客戶端服務
  *
- * 使用 Axios 函式庫實作 IHttpClient 介面,提供真實的 HTTP 請求功能。
+ * 使用 Axios 函式庫實作 IHttpClientPort 介面,提供真實的 HTTP 請求功能。
  * 支援檔案下載、文字內容抓取,以及進度追蹤。
  *
  * @example
@@ -61,7 +62,7 @@ const timeouts_1 = require("../../constants/timeouts");
  * );
  * ```
  */
-let HttpClientService = class HttpClientService {
+let HttpClientAdapter = class HttpClientAdapter {
     /**
      * 下載檔案到指定路徑
      *
@@ -106,9 +107,11 @@ let HttpClientService = class HttpClientService {
             }
             // 包裝錯誤訊息
             if (error instanceof axios_1.AxiosError) {
-                throw new Error(`Failed to download file from ${url}: ${error.message} (status: ${error.response?.status ?? 'unknown'})`);
+                throw new errors_1.AppError(`Failed to download file from ${url}: ${error.message} (status: ${error.response?.status ?? 'unknown'})`, { exitCode: errors_1.EXIT_CODES.NETWORK_ERROR });
             }
-            throw new Error(`Failed to download file from ${url}: ${String(error)}`);
+            throw new errors_1.AppError(`Failed to download file from ${url}: ${String(error)}`, {
+                exitCode: errors_1.EXIT_CODES.NETWORK_ERROR,
+            });
         }
     }
     /**
@@ -130,9 +133,11 @@ let HttpClientService = class HttpClientService {
         catch (error) {
             // 包裝錯誤訊息
             if (error instanceof axios_1.AxiosError) {
-                throw new Error(`Failed to fetch text from ${url}: ${error.message} (status: ${error.response?.status ?? 'unknown'})`);
+                throw new errors_1.AppError(`Failed to fetch text from ${url}: ${error.message} (status: ${error.response?.status ?? 'unknown'})`, { exitCode: errors_1.EXIT_CODES.NETWORK_ERROR });
             }
-            throw new Error(`Failed to fetch text from ${url}: ${String(error)}`);
+            throw new errors_1.AppError(`Failed to fetch text from ${url}: ${String(error)}`, {
+                exitCode: errors_1.EXIT_CODES.NETWORK_ERROR,
+            });
         }
     }
     /**
@@ -148,9 +153,11 @@ let HttpClientService = class HttpClientService {
         }
         catch (error) {
             if (error instanceof axios_1.AxiosError) {
-                throw new Error(`Failed to get JSON from ${url}: ${error.message} (status: ${error.response?.status ?? 'unknown'})`);
+                throw new errors_1.AppError(`Failed to get JSON from ${url}: ${error.message} (status: ${error.response?.status ?? 'unknown'})`, { exitCode: errors_1.EXIT_CODES.NETWORK_ERROR });
             }
-            throw new Error(`Failed to get JSON from ${url}: ${String(error)}`);
+            throw new errors_1.AppError(`Failed to get JSON from ${url}: ${String(error)}`, {
+                exitCode: errors_1.EXIT_CODES.NETWORK_ERROR,
+            });
         }
     }
     /**
@@ -169,8 +176,8 @@ let HttpClientService = class HttpClientService {
         }
     }
 };
-exports.HttpClientService = HttpClientService;
-exports.HttpClientService = HttpClientService = __decorate([
+exports.HttpClientAdapter = HttpClientAdapter;
+exports.HttpClientAdapter = HttpClientAdapter = __decorate([
     (0, tsyringe_1.injectable)()
-], HttpClientService);
-//# sourceMappingURL=http-client.service.js.map
+], HttpClientAdapter);
+//# sourceMappingURL=http-client.adapter.js.map

package/dist/infrastructure/http/index.js

@@ -14,5 +14,5 @@ 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("./http-client.service"), exports);
+__exportStar(require("./http-client.adapter"), exports);
 //# sourceMappingURL=index.js.map