@uofx/cli 1.0.0

package/dist/infrastructure/logger/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Logger Infrastructure
+ */
+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("./logger.adapter"), exports);
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./services"), exports);
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/logger/interfaces/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Logger Interfaces
+ */
+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("./log-writer.repository.interface"), exports);
+__exportStar(require("./log-reader.repository.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/logger/interfaces/log-reader.repository.interface.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Log Reader Repository 介面
+ * 定義日誌讀取能力
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=log-reader.repository.interface.js.map

package/dist/infrastructure/logger/interfaces/log-writer.repository.interface.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Log Writer Repository 介面
+ * 定義日誌寫入能力
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=log-writer.repository.interface.js.map

package/dist/infrastructure/logger/logger.adapter.js

@@ -0,0 +1,274 @@
+"use strict";
+/**
+ * Logger Adapter
+ *
+ * 實作 ILoggerPort
+ * 整合日誌寫入和讀取能力
+ */
+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;
+    };
+})();
+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.LoggerAdapter = void 0;
+exports.generateCorrelationId = generateCorrelationId;
+const tsyringe_1 = require("tsyringe");
+const crypto = __importStar(require("crypto"));
+const tokens_1 = require("../../di/tokens");
+const logger_types_1 = require("../../domain/types/logger.types");
+/**
+ * 產生 Correlation ID
+ * 用於追蹤同一次命令執行的所有日誌
+ */
+function generateCorrelationId() {
+    return crypto.randomBytes(8).toString('hex');
+}
+/**
+ * Logger Adapter 實作
+ */
+let LoggerAdapter = class LoggerAdapter {
+    constructor(logWriter, logReader) {
+        this.logWriter = logWriter;
+        this.logReader = logReader;
+        this.currentLevel = logger_types_1.LogLevel.ERROR;
+    }
+    // =========================================================================
+    // 日誌記錄方法
+    // =========================================================================
+    /**
+     * 記錄除錯訊息
+     */
+    debug(message, context) {
+        this.log(logger_types_1.LogLevel.DEBUG, message, context);
+    }
+    /**
+     * 記錄一般資訊
+     */
+    info(message, context) {
+        this.log(logger_types_1.LogLevel.INFO, message, context);
+    }
+    /**
+     * 記錄警告訊息
+     */
+    warn(message, context) {
+        this.log(logger_types_1.LogLevel.WARN, message, context);
+    }
+    /**
+     * 記錄錯誤
+     */
+    error(error, context) {
+        const errorDetails = {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+        };
+        if ('code' in error) {
+            errorDetails.code = error.code;
+        }
+        this.log(logger_types_1.LogLevel.ERROR, error.message, context, errorDetails);
+    }
+    /**
+     * 記錄致命錯誤
+     */
+    fatal(error, context) {
+        const errorDetails = {
+            name: error.name,
+            message: error.message,
+            stack: error.stack,
+        };
+        if ('code' in error) {
+            errorDetails.code = error.code;
+        }
+        this.log(logger_types_1.LogLevel.FATAL, error.message, context, errorDetails);
+    }
+    // =========================================================================
+    // 日誌讀取方法
+    // =========================================================================
+    /**
+     * 讀取最近的日誌項目
+     */
+    async readLogs(count = 50) {
+        return await this.logReader.readRecentEntries(count);
+    }
+    /**
+     * 清除日誌檔案
+     */
+    async clearLogs() {
+        await this.logWriter.clearLogFile();
+    }
+    // =========================================================================
+    // 日誌級別控制
+    // =========================================================================
+    /**
+     * 設定日誌級別
+     */
+    setLogLevel(level) {
+        this.currentLevel = level;
+        this.logWriter.setLogLevel(level);
+    }
+    /**
+     * 取得目前的日誌級別
+     */
+    getLogLevel() {
+        return this.currentLevel;
+    }
+    /**
+     * 取得日誌檔案路徑
+     */
+    getLogFilePath() {
+        return this.logWriter.getLogFilePath();
+    }
+    // =========================================================================
+    // 執行上下文管理
+    // =========================================================================
+    /**
+     * 設定執行上下文
+     */
+    setExecutionContext(context) {
+        this.executionContext = context;
+    }
+    /**
+     * 取得目前的執行上下文
+     */
+    getExecutionContext() {
+        return this.executionContext;
+    }
+    /**
+     * 清除執行上下文
+     */
+    clearExecutionContext() {
+        this.executionContext = undefined;
+    }
+    // =========================================================================
+    // 私有方法
+    // =========================================================================
+    /**
+     * 核心日誌方法
+     */
+    log(level, message, context, error) {
+        // 檢查日誌級別
+        if (level < this.currentLevel) {
+            return;
+        }
+        // 準備並遮罩敏感資料
+        const safeContext = this.prepareContext(context);
+        // 合併執行上下文到日誌 context
+        const mergedContext = {
+            ...safeContext,
+        };
+        // 注入執行上下文（如果存在）
+        if (this.executionContext) {
+            mergedContext.command = mergedContext.command ?? this.executionContext.command;
+            mergedContext.commandGroup = mergedContext.commandGroup ?? this.executionContext.commandGroup;
+            mergedContext.correlationId = mergedContext.correlationId ?? this.executionContext.correlationId;
+        }
+        // 建立日誌項目
+        let entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            levelName: logger_types_1.LogLevelNames[level],
+            message,
+            correlationId: mergedContext.correlationId,
+            context: mergedContext,
+            error,
+            metadata: {
+                pid: process.pid,
+            },
+        };
+        // AOP: beforeLog hook
+        if (this.beforeLog) {
+            entry = this.beforeLog(entry);
+        }
+        // AOP: shouldLog check
+        if (this.shouldLog && !this.shouldLog(entry)) {
+            return;
+        }
+        // 寫入日誌
+        this.logWriter.write(entry);
+        // AOP: afterLog hook
+        if (this.afterLog) {
+            this.afterLog(entry);
+        }
+    }
+    /**
+     * 檢查物件是否實作 ISafeLoggable 介面
+     */
+    isSafeLoggable(obj) {
+        return obj !== null && typeof obj === 'object' && 'toSafeLog' in obj && typeof obj.toSafeLog === 'function';
+    }
+    /**
+     * 準備日誌上下文，自動檢測並遮罩敏感資料
+     * 遞迴檢查物件，若實作 ISafeLoggable 則自動呼叫 toSafeLog()
+     */
+    prepareContext(obj) {
+        if (obj === null || obj === undefined) {
+            return obj;
+        }
+        if (typeof obj !== 'object') {
+            return obj;
+        }
+        // 檢查是否實作 ISafeLoggable
+        if (this.isSafeLoggable(obj)) {
+            return obj.toSafeLog();
+        }
+        // 處理陣列
+        if (Array.isArray(obj)) {
+            return obj.map(item => this.prepareContext(item));
+        }
+        // 遞迴處理物件屬性
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            result[key] = this.prepareContext(value);
+        }
+        return result;
+    }
+};
+exports.LoggerAdapter = LoggerAdapter;
+exports.LoggerAdapter = LoggerAdapter = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.FileLogWriter)),
+    __param(1, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.FileLogReader)),
+    __metadata("design:paramtypes", [Object, Object])
+], LoggerAdapter);
+//# sourceMappingURL=logger.adapter.js.map

package/dist/infrastructure/logger/services/file-log-reader.repository.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * File Log Reader Repository
+ * 負責從檔案系統讀取日誌
+ */
+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;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileLogReaderRepository = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const readline = __importStar(require("readline"));
+const tsyringe_1 = require("tsyringe");
+const index_1 = require("../../../constants/index");
+/**
+ * 預設配置
+ */
+const DEFAULT_CONFIG = {
+    baseDir: path.join(os.homedir(), index_1.WINDOWS_PATHS.USER_CONFIG_DIR, 'logs'),
+};
+/**
+ * File Log Reader Repository 實作
+ */
+let FileLogReaderRepository = class FileLogReaderRepository {
+    constructor() {
+        // 使用默認配置
+        // 如果未來需要自定義配置，應該從 IAppConfig 注入
+        this.config = DEFAULT_CONFIG;
+    }
+    /**
+     * 取得日誌基礎目錄
+     */
+    getBaseDir() {
+        return this.config.baseDir;
+    }
+    /**
+     * 讀取最近的日誌項目
+     */
+    async readRecentEntries(count = 50) {
+        const entries = [];
+        try {
+            if (!fs.existsSync(this.config.baseDir)) {
+                return entries;
+            }
+            const files = await fs.promises.readdir(this.config.baseDir);
+            const logFiles = files
+                .filter((f) => f.startsWith('uofx-') && f.endsWith('.jsonl'))
+                .sort()
+                .reverse();
+            for (const logFile of logFiles) {
+                if (entries.length >= count)
+                    break;
+                const filePath = path.join(this.config.baseDir, logFile);
+                const remaining = count - entries.length;
+                const fileEntries = await this.readEntriesFromFile(filePath, remaining);
+                entries.push(...fileEntries);
+            }
+        }
+        catch {
+            // 靜默處理：讀取日誌失敗時返回空陣列
+        }
+        return entries.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    }
+    /**
+     * 從單個檔案讀取日誌項目
+     */
+    async readEntriesFromFile(filePath, count) {
+        const entries = [];
+        if (!fs.existsSync(filePath)) {
+            return entries;
+        }
+        return new Promise((resolve) => {
+            const lines = [];
+            const rl = readline.createInterface({
+                input: fs.createReadStream(filePath, { encoding: 'utf8' }),
+                crlfDelay: Infinity,
+            });
+            rl.on('line', (line) => {
+                if (line.trim()) {
+                    lines.push(line);
+                }
+            });
+            rl.on('close', () => {
+                const recentLines = lines.slice(-count);
+                for (const line of recentLines) {
+                    try {
+                        const entry = JSON.parse(line);
+                        entries.push(entry);
+                    }
+                    catch {
+                        // 非 JSON 格式，忽略
+                    }
+                }
+                resolve(entries);
+            });
+            rl.on('error', () => {
+                resolve(entries);
+            });
+        });
+    }
+};
+exports.FileLogReaderRepository = FileLogReaderRepository;
+exports.FileLogReaderRepository = FileLogReaderRepository = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [])
+], FileLogReaderRepository);
+//# sourceMappingURL=file-log-reader.repository.js.map