@uofx/cli 1.0.0

package/dist/infrastructure/execution/interfaces/script-executor.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=script-executor.interface.js.map

package/dist/infrastructure/execution/script-executor.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.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");
+/**
+ * ScriptExecutor 類別負責在 WSL 實例中執行 bash 腳本
+ */
+let ScriptExecutorService = class ScriptExecutorService {
+    constructor(envFactory, commandExecutor, logger, ociArtifact) {
+        this.envFactory = envFactory;
+        this.commandExecutor = commandExecutor;
+        this.logger = logger;
+        this.ociArtifact = ociArtifact;
+    }
+    get hostEnv() {
+        return this.envFactory.getHostEnvironment();
+    }
+    /**
+     * 在 WSL 實例中執行 bash 腳本
+     * @param instanceName WSL 實例名稱
+     * @param scriptPath WSL 實例內的腳本路徑
+     * @param timeout 執行超時時間(毫秒),預設 30 分鐘
+     * @param showDetail 是否顯示詳細輸出（預設：false）
+     * @param progress 進度通知回調
+     * @returns 執行結果,包含 exitCode 和 output
+     */
+    async executeScript(instanceName, scriptPath, timeout = index_1.TIMEOUTS.SCRIPT_EXECUTION, showDetail = false, output) {
+        // 驗證輸入
+        (0, input_validator_util_1.requireValidInstanceName)(instanceName);
+        (0, input_validator_util_1.requireValidPath)(scriptPath);
+        // 使用 hostEnv.wslCmd 以 root 權限執行腳本
+        // 這是系統初始化所必需的，因為需要修改系統配置
+        const builder = this.hostEnv.wslCmd('-d')
+            .arg(instanceName)
+            .arg('-u')
+            .arg('root')
+            .arg('--')
+            .arg('bash')
+            .arg(scriptPath);
+        // 取得建構好的命令，加上 timeout 選項執行
+        const command = builder.buildActual();
+        let scriptOutput = '';
+        try {
+            const result = await this.commandExecutor.exec(command, (stdout) => {
+                scriptOutput += stdout;
+                if (showDetail) {
+                    // 詳細模式：記錄所有輸出到 debug log
+                    this.logger.debug('Script stdout', { output: stdout });
+                }
+                else {
+                    // 只記錄符合 "Step {num}: {desc}" 格式的行到 debug log
+                    const lines = stdout.split('\n');
+                    for (const line of lines) {
+                        if (/^Step \d+:/.test(line.trim())) {
+                            this.logger.debug('Script step', { step: line.trim() });
+                            output?.indent().item('arrow', line.trim()).outdent().flush();
+                        }
+                    }
+                }
+            }, (stderr) => {
+                scriptOutput += stderr;
+                if (showDetail && stderr.trim()) {
+                    // 記錄 stderr 到 error log
+                    this.logger.error(new Error(`Script stderr: ${stderr}`));
+                }
+            }, { timeout, shell: true }, builder.buildSafe());
+            return { exitCode: result.exitCode, output: scriptOutput };
+        }
+        catch (error) {
+            // 如果是超時錯誤
+            if (error instanceof Error && error.message.includes('timeout')) {
+                throw new errors_1.AppError('Script execution timed out (30 minutes)', {
+                    exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                    solution: `Check WSL instance logs: wsl -d ${instanceName} -- journalctl -xe`,
+                    cause: error,
+                    context: { instanceName, scriptPath }
+                });
+            }
+            throw error;
+        }
+    }
+    /**
+     * 執行系統初始化腳本的完整流程
+     * @param instanceName WSL 實例名稱
+     * @param params 部署參數（包含 ACR 憑證）
+     * @param environmentVersion ubuntu-environment 版本（如 "1.26.100"）
+     * @param output 輸出介面
+     */
+    async runSystemInitialization(instanceName, params, environmentVersion, output) {
+        const remoteScriptPath = '/tmp/environment.sh';
+        // Step 1: 從 OCI registry 下載 ubuntu-environment 腳本到 WSL
+        output?.indent().item('arrow', `Downloading ubuntu-environment v${environmentVersion}...`).outdent().flush();
+        this.logger.info('Downloading environment script from OCI to instance', {
+            instanceName,
+            environmentVersion,
+            remotePath: remoteScriptPath,
+            repo: index_1.OCI_ARTIFACTS.UBUNTU_ENVIRONMENT
+        });
+        try {
+            await this.ociArtifact.downloadToInstance(instanceName, index_1.OCI_ARTIFACTS.UBUNTU_ENVIRONMENT, environmentVersion, remoteScriptPath, params.acrCredentials);
+        }
+        catch (error) {
+            this.logger.error(error instanceof Error ? error : new Error(String(error)), {
+                message: 'Failed to download environment script from OCI',
+                instanceName,
+                environmentVersion
+            });
+            throw new errors_1.AppError(`Failed to download ubuntu-environment v${environmentVersion} from OCI`, {
+                exitCode: errors_1.EXIT_CODES.NETWORK_ERROR,
+                cause: error instanceof Error ? error : new Error(String(error)),
+                solution: 'Check network connectivity and ACR credentials',
+                context: { instanceName, environmentVersion, repo: index_1.OCI_ARTIFACTS.UBUNTU_ENVIRONMENT }
+            });
+        }
+        // Step 2: 執行腳本
+        output?.indent().item('arrow', 'Running system initialization (this may take a few minutes)...').outdent().flush();
+        const result = await this.executeScript(instanceName, remoteScriptPath, index_1.TIMEOUTS.SCRIPT_EXECUTION, false, output);
+        // Step 3: 處理結果
+        if (result.exitCode === 0) {
+            this.logger.info('System initialization completed', { instanceName, exitCode: 0 });
+        }
+        else {
+            const errorMsg = `System initialization failed (exit code: ${result.exitCode})`;
+            output?.error(errorMsg).flush();
+            output?.item('bullet', 'Check the error output above for details').flush();
+            output?.item('bullet', 'You can retry the installation after fixing the issue').flush();
+            this.logger.error(new Error(errorMsg), {
+                instanceName,
+                exitCode: result.exitCode,
+                output: result.output
+            });
+            throw new errors_1.AppError('System initialization failed', {
+                exitCode: errors_1.EXIT_CODES.SYSTEM_ERROR,
+                context: { instanceName, exitCode: result.exitCode }
+            });
+        }
+    }
+};
+exports.ScriptExecutorService = ScriptExecutorService;
+__decorate([
+    __param(1, (0, sensitive_decorator_1.Sensitive)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Number, Boolean, Object]),
+    __metadata("design:returntype", Promise)
+], ScriptExecutorService.prototype, "executeScript", null);
+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])
+], ScriptExecutorService);
+//# sourceMappingURL=script-executor.service.js.map

package/dist/infrastructure/http/http-client.service.js

@@ -0,0 +1,176 @@
+"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.HttpClientService = 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");
+/**
+ * HTTP 客戶端服務
+ *
+ * 使用 Axios 函式庫實作 IHttpClient 介面,提供真實的 HTTP 請求功能。
+ * 支援檔案下載、文字內容抓取,以及進度追蹤。
+ *
+ * @example
+ * ```typescript
+ * const httpClient = new HttpClientService();
+ * await httpClient.downloadFile(
+ *   'https://example.com/file.tar.xz',
+ *   '/tmp/file.tar.xz',
+ *   (current, total) => console.log(`${current}/${total}`)
+ * );
+ * ```
+ */
+let HttpClientService = class HttpClientService {
+    /**
+     * 下載檔案到指定路徑
+     *
+     * 使用 axios stream mode 下載檔案,支援大檔案下載和進度追蹤。
+     *
+     * @param url - 檔案的 URL
+     * @param destPath - 目標檔案路徑
+     * @param onProgress - 可選的進度回調函式
+     * @throws 當網路錯誤、檔案寫入失敗或回應非 2xx 狀態碼時拋出錯誤
+     */
+    async downloadFile(url, destPath, onProgress) {
+        // 確保目標目錄存在
+        const destDir = path.dirname(destPath);
+        if (!fs.existsSync(destDir)) {
+            fs.mkdirSync(destDir, { recursive: true });
+        }
+        // 建立寫入串流
+        const writer = fs.createWriteStream(destPath);
+        try {
+            // 使用 axios stream mode 下載
+            const response = await axios_1.default.get(url, {
+                responseType: 'stream',
+                onDownloadProgress: (progressEvent) => {
+                    if (onProgress && progressEvent.total) {
+                        onProgress(progressEvent.loaded, progressEvent.total);
+                    }
+                },
+            });
+            // 將回應資料導入寫入串流
+            response.data.pipe(writer);
+            // 等待寫入完成
+            await new Promise((resolve, reject) => {
+                writer.on('finish', resolve);
+                writer.on('error', reject);
+                response.data.on('error', reject);
+            });
+        }
+        catch (error) {
+            // 清理部分下載的檔案
+            if (fs.existsSync(destPath)) {
+                fs.unlinkSync(destPath);
+            }
+            // 包裝錯誤訊息
+            if (error instanceof axios_1.AxiosError) {
+                throw new Error(`Failed to download file from ${url}: ${error.message} (status: ${error.response?.status ?? 'unknown'})`);
+            }
+            throw new Error(`Failed to download file from ${url}: ${String(error)}`);
+        }
+    }
+    /**
+     * 抓取 URL 的文字內容
+     *
+     * 使用 axios.get 抓取文字內容。
+     *
+     * @param url - 要抓取的 URL
+     * @returns Promise,解析為文字內容
+     * @throws 當網路錯誤或回應非 2xx 狀態碼時拋出錯誤
+     */
+    async fetchText(url) {
+        try {
+            const response = await axios_1.default.get(url, {
+                responseType: 'text',
+            });
+            return response.data;
+        }
+        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 Error(`Failed to fetch text from ${url}: ${String(error)}`);
+        }
+    }
+    /**
+     * 發送 GET 請求並解析 JSON 回應
+     */
+    async getJson(url, headers) {
+        try {
+            const response = await axios_1.default.get(url, {
+                headers,
+                responseType: 'json',
+            });
+            return response.data;
+        }
+        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 Error(`Failed to get JSON from ${url}: ${String(error)}`);
+        }
+    }
+    /**
+     * 執行 HTTP 健康檢查
+     */
+    async checkHealth(url, timeoutMs = timeouts_1.TIMEOUTS.HEALTH_CHECK_REQUEST_TIMEOUT) {
+        try {
+            const response = await axios_1.default.get(url, {
+                timeout: timeoutMs,
+                validateStatus: (status) => status === 200,
+            });
+            return response.status === 200;
+        }
+        catch {
+            return false;
+        }
+    }
+};
+exports.HttpClientService = HttpClientService;
+exports.HttpClientService = HttpClientService = __decorate([
+    (0, tsyringe_1.injectable)()
+], HttpClientService);
+//# sourceMappingURL=http-client.service.js.map

package/dist/infrastructure/http/index.js

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

package/dist/infrastructure/http/interfaces/http-client.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=http-client.interface.js.map

package/dist/infrastructure/interceptors/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InterceptorFactory = exports.LoggingInterceptor = void 0;
+var logging_interceptor_1 = require("./logging.interceptor");
+Object.defineProperty(exports, "LoggingInterceptor", { enumerable: true, get: function () { return logging_interceptor_1.LoggingInterceptor; } });
+var interceptor_factory_1 = require("./interceptor.factory");
+Object.defineProperty(exports, "InterceptorFactory", { enumerable: true, get: function () { return interceptor_factory_1.InterceptorFactory; } });
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/interceptors/interceptor.factory.js

@@ -0,0 +1,44 @@
+"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.InterceptorFactory = void 0;
+const tsyringe_1 = require("tsyringe");
+const logging_interceptor_1 = require("./logging.interceptor");
+/**
+ * 攔截器工廠
+ *
+ * 用於包裝服務並套用攔截器。
+ * 是否記錄 log 由 LoggingInterceptor 內部根據 logLevel 決定。
+ */
+let InterceptorFactory = class InterceptorFactory {
+    constructor(loggingInterceptor) {
+        this.loggingInterceptor = loggingInterceptor;
+    }
+    /**
+     * 用攔截器包裝服務
+     * @param target - 要包裝的服務實例
+     * @param serviceName - 服務名稱（用於 log 標識）
+     * @returns 被攔截器包裝的服務
+     */
+    wrapWithInterceptors(target, serviceName) {
+        return this.loggingInterceptor.intercept(target, serviceName);
+    }
+};
+exports.InterceptorFactory = InterceptorFactory;
+exports.InterceptorFactory = InterceptorFactory = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(logging_interceptor_1.LoggingInterceptor)),
+    __metadata("design:paramtypes", [logging_interceptor_1.LoggingInterceptor])
+], InterceptorFactory);
+//# sourceMappingURL=interceptor.factory.js.map

package/dist/infrastructure/interceptors/interceptor.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interceptor.interface.js.map

package/dist/infrastructure/interceptors/logging.interceptor.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); }
+};
+var LoggingInterceptor_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggingInterceptor = void 0;
+const tsyringe_1 = require("tsyringe");
+require("reflect-metadata");
+const tokens_1 = require("../../di/tokens");
+const sensitive_decorator_1 = require("../../domain/decorators/sensitive.decorator");
+/**
+ * 日誌攔截器
+ *
+ * 使用 Proxy 模式攔截服務方法調用，自動記錄 debug log。
+ * 整合 @Sensitive、@NoLogArgs、@SensitiveReturn 裝飾器，自動遮蔽敏感資料。
+ *
+ * 特點：
+ * - 只在 logLevel=debug 時記錄
+ * - 自動遮蔽標記為敏感的參數和返回值
+ * - 記錄方法執行時間
+ */
+let LoggingInterceptor = LoggingInterceptor_1 = class LoggingInterceptor {
+    constructor(logger, appConfig) {
+        this.logger = logger;
+        this.appConfig = appConfig;
+    }
+    /**
+     * 檢查是否應該記錄 log（只在 debug level 時記錄）
+     */
+    shouldLog() {
+        return this.appConfig.getConfig().logLevel === 'debug';
+    }
+    /**
+     * 攔截目標物件的方法調用
+     */
+    intercept(target, serviceName) {
+        const self = this;
+        return new Proxy(target, {
+            get(obj, prop) {
+                const value = Reflect.get(obj, prop);
+                if (typeof value !== 'function')
+                    return value;
+                const methodName = String(prop);
+                if (LoggingInterceptor_1.EXCLUDED_METHODS.has(methodName) ||
+                    methodName.startsWith('_') ||
+                    methodName === 'constructor') {
+                    return value;
+                }
+                return function (...args) {
+                    // 每次調用時檢查 log level
+                    if (!self.shouldLog()) {
+                        return value.apply(obj, args);
+                    }
+                    const startTime = Date.now();
+                    // 讀取敏感資料 metadata
+                    const noLogArgs = Reflect.getMetadata(sensitive_decorator_1.NO_LOG_ARGS_KEY, obj, prop) === true;
+                    const sensitiveParams = Reflect.getMetadata(sensitive_decorator_1.SENSITIVE_PARAMS_KEY, obj, prop) || [];
+                    const sensitiveReturn = Reflect.getMetadata(sensitive_decorator_1.SENSITIVE_RETURN_KEY, obj, prop) === true;
+                    // 處理參數 - 遮蔽敏感資料
+                    const safeArgs = noLogArgs ? '[REDACTED]' : self.summarizeArgs(args, sensitiveParams);
+                    self.logger.debug(`[Interceptor] [${serviceName}] ${methodName} called`, {
+                        source: 'interceptor',
+                        class: serviceName,
+                        method: methodName,
+                        args: safeArgs,
+                    });
+                    try {
+                        const result = value.apply(obj, args);
+                        if (result instanceof Promise) {
+                            return result
+                                .then((res) => {
+                                self.logCompleted(serviceName, methodName, startTime, res, sensitiveReturn);
+                                return res;
+                            })
+                                .catch((error) => {
+                                self.logFailed(serviceName, methodName, startTime, error);
+                                throw error;
+                            });
+                        }
+                        self.logCompleted(serviceName, methodName, startTime, result, sensitiveReturn);
+                        return result;
+                    }
+                    catch (error) {
+                        self.logFailed(serviceName, methodName, startTime, error);
+                        throw error;
+                    }
+                };
+            },
+        });
+    }
+    /**
+     * 記錄方法完成
+     */
+    logCompleted(serviceName, methodName, startTime, result, sensitiveReturn) {
+        this.logger.debug(`[Interceptor] [${serviceName}] ${methodName} completed`, {
+            source: 'interceptor',
+            class: serviceName,
+            method: methodName,
+            duration: Date.now() - startTime,
+            result: sensitiveReturn ? '[REDACTED]' : this.summarizeResult(result),
+        });
+    }
+    /**
+     * 記錄方法失敗
+     */
+    logFailed(serviceName, methodName, startTime, error) {
+        this.logger.debug(`[Interceptor] [${serviceName}] ${methodName} failed`, {
+            source: 'interceptor',
+            class: serviceName,
+            method: methodName,
+            duration: Date.now() - startTime,
+            error: error.message,
+        });
+    }
+    /**
+     * 摘要化參數（遮蔽敏感資料、截斷長字串）
+     */
+    summarizeArgs(args, sensitiveParams) {
+        const sensitiveIndexes = new Set(sensitiveParams.map(p => p.index));
+        return args.map((arg, index) => {
+            // 敏感參數遮蔽
+            if (sensitiveIndexes.has(index)) {
+                return '[REDACTED]';
+            }
+            if (typeof arg === 'string' && arg.length > 100)
+                return arg.substring(0, 100) + '...';
+            if (Array.isArray(arg))
+                return { type: 'array', length: arg.length };
+            if (arg && typeof arg === 'object')
+                return { type: 'object', keys: Object.keys(arg) };
+            return arg;
+        });
+    }
+    /**
+     * 摘要化返回值
+     */
+    summarizeResult(result) {
+        if (result === undefined || result === null)
+            return result;
+        if (Array.isArray(result))
+            return { type: 'array', length: result.length };
+        if (typeof result === 'object')
+            return { type: 'object', keys: Object.keys(result) };
+        return result;
+    }
+};
+exports.LoggingInterceptor = LoggingInterceptor;
+LoggingInterceptor.EXCLUDED_METHODS = new Set([
+    'toString',
+    'valueOf',
+    'toJSON',
+    'Symbol.iterator',
+    'Symbol.toStringTag',
+]);
+exports.LoggingInterceptor = LoggingInterceptor = LoggingInterceptor_1 = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.ILoggerPort)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.IAppConfig)),
+    __metadata("design:paramtypes", [Object, Object])
+], LoggingInterceptor);
+//# sourceMappingURL=logging.interceptor.js.map

package/dist/infrastructure/logger/correlation-id.adapter.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Correlation ID Adapter
+ *
+ * 實作 ICorrelationIdPort
+ * 產生用於追蹤日誌的唯一識別碼
+ */
+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.CorrelationIdAdapter = void 0;
+const tsyringe_1 = require("tsyringe");
+const crypto = __importStar(require("crypto"));
+/**
+ * Correlation ID Adapter 實作
+ */
+let CorrelationIdAdapter = class CorrelationIdAdapter {
+    /**
+     * 產生 Correlation ID
+     * 使用 crypto.randomBytes 產生 8 bytes 的隨機十六進位字串
+     * @returns 16 字元的唯一識別碼
+     */
+    generate() {
+        return crypto.randomBytes(8).toString('hex');
+    }
+};
+exports.CorrelationIdAdapter = CorrelationIdAdapter;
+exports.CorrelationIdAdapter = CorrelationIdAdapter = __decorate([
+    (0, tsyringe_1.injectable)()
+], CorrelationIdAdapter);
+//# sourceMappingURL=correlation-id.adapter.js.map