@uofx/cli 1.0.0

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

@@ -0,0 +1,307 @@
+"use strict";
+/**
+ * File Log Writer Repository
+ * 負責將日誌寫入檔案系統
+ *
+ * 功能：
+ * - JSON Lines 格式（每行一個 JSON 物件）
+ * - 每日檔案命名：uofx-YYYY-MM-DD.jsonl
+ * - 檔案大小輪替
+ * - 舊檔案自動清理
+ * - 錯誤隔離（寫入失敗不影響主程式）
+ */
+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.FileLogWriterRepository = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const tsyringe_1 = require("tsyringe");
+const logger_types_1 = require("../../../domain/types/logger.types");
+const index_1 = require("../../../constants/index");
+const file_operations_util_1 = require("../../utils/file-operations.util");
+/**
+ * 預設配置
+ */
+const DEFAULT_CONFIG = {
+    path: path.join(os.homedir(), index_1.WINDOWS_PATHS.USER_CONFIG_DIR, 'logs', 'uofx.log'),
+    maxSize: index_1.LOG_DEFAULTS.MAX_FILE_SIZE,
+    maxFiles: index_1.LOG_DEFAULTS.MAX_BACKUP_COUNT,
+    format: 'json',
+    level: logger_types_1.LogLevel.DEBUG,
+    enabled: true,
+    dailyRotation: true,
+};
+/**
+ * File Log Writer Repository 實作
+ */
+let FileLogWriterRepository = class FileLogWriterRepository {
+    constructor() {
+        this.initialized = false;
+        this.currentDate = '';
+        this.currentFilePath = '';
+        // 使用默認配置
+        // 如果未來需要自定義配置，應該從 IAppConfig 注入
+        this.config = DEFAULT_CONFIG;
+        this.baseDir = path.dirname(this.config.path);
+        this.updateCurrentFilePath();
+    }
+    /**
+     * 更新當前檔案路徑（根據日期）
+     */
+    updateCurrentFilePath() {
+        const today = this.getDateString();
+        if (this.currentDate !== today) {
+            this.currentDate = today;
+            if (this.config.dailyRotation) {
+                this.currentFilePath = path.join(this.baseDir, `uofx-${today}.jsonl`);
+            }
+            else {
+                this.currentFilePath = this.config.path;
+            }
+        }
+    }
+    /**
+     * 取得當前日期字串（YYYY-MM-DD）
+     */
+    getDateString() {
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        return `${year}-${month}-${day}`;
+    }
+    /**
+     * 初始化 Repository
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        try {
+            if (!fs.existsSync(this.baseDir)) {
+                fs.mkdirSync(this.baseDir, { recursive: true });
+            }
+            this.initialized = true;
+        }
+        catch {
+            // 靜默處理：日誌目錄建立失敗不應影響主程式
+            // 後續寫入操作會各自處理錯誤
+        }
+    }
+    /**
+     * 關閉 Repository
+     */
+    async close() {
+        this.initialized = false;
+    }
+    /**
+     * 檢查是否應該記錄此級別的日誌
+     */
+    shouldLog(level) {
+        return this.config.enabled && level >= this.config.level;
+    }
+    /**
+     * 設定日誌級別
+     */
+    setLogLevel(level) {
+        this.config.level = level;
+    }
+    /**
+     * 同步寫入日誌
+     */
+    write(entry) {
+        if (!this.shouldLog(entry.level)) {
+            return;
+        }
+        try {
+            this.ensureInitialized();
+            this.updateCurrentFilePath();
+            this.rotateIfNeededSync();
+            this.cleanupOldFilesSync();
+            const logLine = this.formatEntry(entry);
+            fs.appendFileSync(this.currentFilePath, logLine + '\n', 'utf8');
+        }
+        catch {
+            // 靜默處理：日誌寫入失敗不應影響主程式
+        }
+    }
+    /**
+     * 非同步寫入日誌
+     */
+    async writeAsync(entry) {
+        if (!this.shouldLog(entry.level)) {
+            return;
+        }
+        try {
+            await this.init();
+            this.updateCurrentFilePath();
+            await this.rotateIfNeeded();
+            await this.cleanupOldFiles();
+            const logLine = this.formatEntry(entry);
+            await fs.promises.appendFile(this.currentFilePath, logLine + '\n', 'utf8');
+        }
+        catch {
+            // 靜默處理：日誌寫入失敗不應影響主程式
+        }
+    }
+    /**
+     * 取得日誌檔案路徑
+     */
+    getLogFilePath() {
+        this.updateCurrentFilePath();
+        return this.currentFilePath;
+    }
+    /**
+     * 清除日誌檔案
+     */
+    async clearLogFile() {
+        try {
+            if (fs.existsSync(this.currentFilePath)) {
+                await fs.promises.writeFile(this.currentFilePath, '', 'utf8');
+            }
+            const files = await fs.promises.readdir(this.baseDir);
+            for (const file of files) {
+                if (file.startsWith('uofx-') && file.endsWith('.jsonl')) {
+                    try {
+                        await fs.promises.unlink(path.join(this.baseDir, file));
+                    }
+                    catch {
+                        // 忽略不存在的檔案
+                    }
+                }
+            }
+        }
+        catch {
+            // 靜默處理：清理日誌失敗不應影響主程式
+        }
+    }
+    /**
+     * 格式化日誌項目
+     */
+    formatEntry(entry) {
+        if (this.config.format === 'json') {
+            return JSON.stringify(entry);
+        }
+        const parts = [
+            entry.timestamp,
+            logger_types_1.LogLevelNames[entry.level].padEnd(5),
+            entry.context?.component ? `[${entry.context.component}]` : '',
+            entry.message,
+        ];
+        let result = parts.filter(Boolean).join(' ');
+        if (entry.error) {
+            result += ` | Error: ${entry.error.name}: ${entry.error.message}`;
+        }
+        return result;
+    }
+    /**
+     * 確保已初始化
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            if (!fs.existsSync(this.baseDir)) {
+                fs.mkdirSync(this.baseDir, { recursive: true });
+            }
+            this.initialized = true;
+        }
+    }
+    /**
+     * 檢查並執行日誌輪轉（非同步）
+     */
+    async rotateIfNeeded() {
+        const needsRotation = await (0, file_operations_util_1.shouldRotate)(this.currentFilePath, this.config.maxSize);
+        if (needsRotation) {
+            await (0, file_operations_util_1.rotateLogFiles)({
+                filePath: this.currentFilePath,
+                maxFiles: this.config.maxFiles,
+            });
+        }
+    }
+    /**
+     * 檢查並執行日誌輪轉（同步）
+     */
+    rotateIfNeededSync() {
+        const needsRotation = (0, file_operations_util_1.shouldRotateSync)(this.currentFilePath, this.config.maxSize);
+        if (needsRotation) {
+            (0, file_operations_util_1.rotateLogFilesSync)({
+                filePath: this.currentFilePath,
+                maxFiles: this.config.maxFiles,
+            });
+        }
+    }
+    /**
+     * 清理過期的日誌檔案（非同步）
+     */
+    async cleanupOldFiles() {
+        if (!this.config.dailyRotation) {
+            return;
+        }
+        await (0, file_operations_util_1.cleanupOldLogFiles)({
+            baseDir: this.baseDir,
+            filePrefix: 'uofx-',
+            fileExtension: '.jsonl',
+            maxFiles: this.config.maxFiles,
+        });
+    }
+    /**
+     * 清理過期的日誌檔案（同步）
+     */
+    cleanupOldFilesSync() {
+        if (!this.config.dailyRotation) {
+            return;
+        }
+        (0, file_operations_util_1.cleanupOldLogFilesSync)({
+            baseDir: this.baseDir,
+            filePrefix: 'uofx-',
+            fileExtension: '.jsonl',
+            maxFiles: this.config.maxFiles,
+        });
+    }
+};
+exports.FileLogWriterRepository = FileLogWriterRepository;
+exports.FileLogWriterRepository = FileLogWriterRepository = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [])
+], FileLogWriterRepository);
+//# sourceMappingURL=file-log-writer.repository.js.map

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

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

package/dist/infrastructure/persistence/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Persistence 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("./instance-storage.adapter"), exports);
+__exportStar(require("./user-settings.adapter"), exports);
+__exportStar(require("./instance-metadata.adapter"), exports);
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./services"), exports);
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/persistence/instance-metadata.adapter.js

@@ -0,0 +1,100 @@
+"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.InstanceMetadataAdapter = void 0;
+const tsyringe_1 = require("tsyringe");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 實例 Metadata Adapter
+ *
+ * 實作 IInstanceMetadataPort，負責 metadata 的檔案系統持久化
+ */
+let InstanceMetadataAdapter = class InstanceMetadataAdapter {
+    constructor() {
+        this.METADATA_FILENAME = 'metadata.json';
+    }
+    /**
+     * 儲存實例 metadata
+     */
+    save(metadata, installPath) {
+        const metadataPath = this.getMetadataPath(installPath);
+        // 確保目錄存在
+        if (!fs.existsSync(installPath)) {
+            fs.mkdirSync(installPath, { recursive: true });
+        }
+        fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2), 'utf8');
+    }
+    /**
+     * 載入實例 metadata
+     */
+    load(installPath) {
+        const metadataPath = this.getMetadataPath(installPath);
+        if (!fs.existsSync(metadataPath)) {
+            return null;
+        }
+        try {
+            const content = fs.readFileSync(metadataPath, 'utf8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 檢查 metadata 是否存在
+     */
+    exists(installPath) {
+        const metadataPath = this.getMetadataPath(installPath);
+        return fs.existsSync(metadataPath);
+    }
+    /**
+     * 取得 metadata 檔案路徑
+     */
+    getMetadataPath(installPath) {
+        return path.join(installPath, this.METADATA_FILENAME);
+    }
+};
+exports.InstanceMetadataAdapter = InstanceMetadataAdapter;
+exports.InstanceMetadataAdapter = InstanceMetadataAdapter = __decorate([
+    (0, tsyringe_1.injectable)()
+], InstanceMetadataAdapter);
+//# sourceMappingURL=instance-metadata.adapter.js.map

package/dist/infrastructure/persistence/instance-storage.adapter.js

@@ -0,0 +1,64 @@
+"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.InstanceStorageAdapter = void 0;
+const tsyringe_1 = require("tsyringe");
+const tokens_1 = require("../../di/tokens");
+/**
+ * 實例儲存 Adapter
+ *
+ * 實作 IInstanceStoragePort，負責實例 Metadata 的持久化操作
+ */
+let InstanceStorageAdapter = class InstanceStorageAdapter {
+    constructor(instanceRepo) {
+        this.instanceRepo = instanceRepo;
+    }
+    /**
+     * 儲存實例 metadata
+     */
+    async saveInstance(metadata) {
+        await this.instanceRepo.save(metadata);
+    }
+    /**
+     * 載入實例 metadata
+     */
+    async loadInstance(name) {
+        return await this.instanceRepo.load(name);
+    }
+    /**
+     * 刪除實例 metadata
+     */
+    async deleteInstance(name) {
+        await this.instanceRepo.delete(name);
+    }
+    /**
+     * 列出所有實例 metadata
+     */
+    async listInstances() {
+        return await this.instanceRepo.listAll();
+    }
+    /**
+     * 檢查實例 metadata 是否存在
+     */
+    async instanceExists(name) {
+        return await this.instanceRepo.exists(name);
+    }
+};
+exports.InstanceStorageAdapter = InstanceStorageAdapter;
+exports.InstanceStorageAdapter = InstanceStorageAdapter = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(tokens_1.TOKENS.Internal.FileInstanceRepository)),
+    __metadata("design:paramtypes", [Object])
+], InstanceStorageAdapter);
+//# sourceMappingURL=instance-storage.adapter.js.map

package/dist/infrastructure/persistence/interfaces/config.repository.interface.js

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

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

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

package/dist/infrastructure/persistence/interfaces/instance.repository.interface.js

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