@uofx/cli 1.0.0

package/dist/presentation/ui/interaction.service.js

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * Interaction Service
+ *
+ * 提供統一的 UI 互動抽象層，整合 prompts 和原生 readline 功能
+ * 隱藏底層庫的實作細節，提供一致的互動介面
+ */
+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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserInteraction = void 0;
+const tsyringe_1 = require("tsyringe");
+const prompts_1 = __importDefault(require("prompts"));
+const readline = __importStar(require("readline"));
+/**
+ * 簡單的進度指示器實作
+ */
+class SimpleProgressIndicator {
+    constructor(message, options) {
+        this.spinnerIndex = 0;
+        this.currentMessage = message;
+        this.prefix = options?.prefix || '';
+        this.useSpinner = options?.spinner ?? true;
+        this.render();
+        if (this.useSpinner) {
+            this.startSpinner();
+        }
+    }
+    startSpinner() {
+        if (!process.stdout.isTTY)
+            return;
+        this.spinnerInterval = setInterval(() => {
+            this.spinnerIndex = (this.spinnerIndex + 1) % SimpleProgressIndicator.SPINNER_CHARS.length;
+            this.render();
+        }, 80);
+    }
+    render() {
+        if (!process.stdout.isTTY) {
+            console.log(`${this.prefix}${this.currentMessage}`);
+            return;
+        }
+        const spinner = this.useSpinner
+            ? SimpleProgressIndicator.SPINNER_CHARS[this.spinnerIndex] + ' '
+            : '';
+        readline.clearLine(process.stdout, 0);
+        readline.cursorTo(process.stdout, 0);
+        process.stdout.write(`${this.prefix}${spinner}${this.currentMessage}`);
+    }
+    update(message) {
+        this.currentMessage = message;
+        this.render();
+    }
+    done() {
+        if (this.spinnerInterval) {
+            clearInterval(this.spinnerInterval);
+            this.spinnerInterval = undefined;
+        }
+        if (process.stdout.isTTY) {
+            readline.clearLine(process.stdout, 0);
+            readline.cursorTo(process.stdout, 0);
+        }
+    }
+}
+SimpleProgressIndicator.SPINNER_CHARS = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+/**
+ * 建立驗證函式
+ */
+function createValidator(options) {
+    if (!options)
+        return undefined;
+    return (value) => {
+        // 必填驗證
+        if (options.required && !value.trim()) {
+            return 'This field is required';
+        }
+        // 最小長度驗證
+        if (options.minLength !== undefined && value.length < options.minLength) {
+            return `Minimum length is ${options.minLength} characters`;
+        }
+        // 最大長度驗證
+        if (options.maxLength !== undefined && value.length > options.maxLength) {
+            return `Maximum length is ${options.maxLength} characters`;
+        }
+        // 正則表達式驗證
+        if (options.pattern && !options.pattern.test(value)) {
+            return 'Invalid format';
+        }
+        // 自訂驗證器
+        if (options.validator) {
+            return options.validator(value);
+        }
+        return true;
+    };
+}
+/**
+ * UserInteraction 實作
+ * 統一 UI 互動的抽象層
+ */
+let UserInteraction = class UserInteraction {
+    /**
+     * 顯示確認提示
+     */
+    async confirm(message, defaultValue = false) {
+        const response = await (0, prompts_1.default)({
+            type: 'confirm',
+            name: 'value',
+            message,
+            initial: defaultValue,
+        });
+        // 如果使用者按 Ctrl+C 中斷，response.value 會是 undefined
+        return response.value ?? false;
+    }
+    /**
+     * 顯示選擇提示
+     */
+    async promptChoice(message, choices, options) {
+        const response = await (0, prompts_1.default)({
+            type: 'select',
+            name: 'value',
+            message,
+            choices: choices.map((c) => ({
+                title: c.title,
+                value: c.value,
+                description: c.description,
+                disabled: c.disabled,
+            })),
+            initial: options?.initial ?? 0,
+            hint: options?.hint,
+        });
+        return response.value;
+    }
+    /**
+     * 顯示文字輸入提示
+     */
+    async promptText(message, options) {
+        // 合併驗證選項
+        let validateFn;
+        if (options?.validate) {
+            validateFn = options.validate;
+        }
+        else if (options?.validation) {
+            validateFn = createValidator(options.validation);
+        }
+        const response = await (0, prompts_1.default)({
+            type: 'text',
+            name: 'value',
+            message,
+            initial: options?.initial,
+            validate: validateFn
+                ? (value) => {
+                    const result = validateFn(value);
+                    if (typeof result === 'boolean') {
+                        return result ? true : 'Invalid input';
+                    }
+                    return result;
+                }
+                : undefined,
+        });
+        return response.value;
+    }
+    /**
+     * 顯示密碼輸入提示
+     */
+    async promptPassword(message, options) {
+        const validateFn = createValidator(options?.validation);
+        const response = await (0, prompts_1.default)({
+            type: 'password',
+            name: 'value',
+            message,
+            validate: validateFn
+                ? (value) => {
+                    const result = validateFn(value);
+                    if (typeof result === 'boolean') {
+                        return result ? true : 'Invalid input';
+                    }
+                    return result;
+                }
+                : undefined,
+        });
+        // 如果使用者中斷
+        if (response.value === undefined) {
+            return undefined;
+        }
+        // 如果需要確認密碼
+        if (options?.confirm) {
+            const confirmMessage = options.confirmMessage || 'Confirm password';
+            const confirmResponse = await (0, prompts_1.default)({
+                type: 'password',
+                name: 'value',
+                message: confirmMessage,
+            });
+            // 如果使用者中斷確認
+            if (confirmResponse.value === undefined) {
+                return undefined;
+            }
+            // 如果密碼不匹配
+            if (response.value !== confirmResponse.value) {
+                console.log('Passwords do not match');
+                return undefined;
+            }
+        }
+        return response.value;
+    }
+    /**
+     * 顯示進度指示器
+     */
+    showProgress(message, options) {
+        return new SimpleProgressIndicator(message, options);
+    }
+    /**
+     * 顯示一般訊息
+     */
+    log(message) {
+        console.log(message);
+    }
+    /**
+     * 顯示空白行
+     */
+    newLine() {
+        console.log('');
+    }
+    /**
+     * 清除當前行
+     */
+    clearLine() {
+        if (process.stdout.isTTY) {
+            readline.clearLine(process.stdout, 0);
+            readline.cursorTo(process.stdout, 0);
+        }
+    }
+};
+exports.UserInteraction = UserInteraction;
+exports.UserInteraction = UserInteraction = __decorate([
+    (0, tsyringe_1.injectable)()
+], UserInteraction);
+//# sourceMappingURL=interaction.service.js.map

package/dist/presentation/ui/interfaces/cli-progress.interface.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Progress Service Interface
+ *
+ * 定義 Progress Bar（進度條）進度指示器的介面
+ * 用於可預估進度的長時間操作
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cli-progress.interface.js.map

package/dist/presentation/ui/interfaces/output-formatter.interface.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Output Formatter Service Interface
+ *
+ * 提供統一的輸出格式化抽象層
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STATUS_COLORS = void 0;
+/**
+ * 預設狀態顏色
+ */
+exports.DEFAULT_STATUS_COLORS = {
+    Running: 'green',
+    Stopped: 'yellow',
+    Error: 'red',
+    Pending: 'cyan',
+    Success: 'green',
+    Failed: 'red',
+    Warning: 'yellow',
+    Active: 'green',
+    Inactive: 'yellow',
+};
+//# sourceMappingURL=output-formatter.interface.js.map

package/dist/presentation/ui/log-level.enum.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Log Level Enum
+ *
+ * 定義 CLI 輸出的日誌等級
+ * 用於控制訊息的顯示與過濾
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputLogLevelNames = exports.OutputLogLevel = void 0;
+exports.parseOutputLogLevel = parseOutputLogLevel;
+exports.shouldOutputLevel = shouldOutputLevel;
+/**
+ * 日誌等級枚舉
+ * 數值越低越詳細，越高越精簡
+ */
+var OutputLogLevel;
+(function (OutputLogLevel) {
+    /** 除錯等級 - 顯示所有訊息 */
+    OutputLogLevel[OutputLogLevel["DEBUG"] = 0] = "DEBUG";
+    /** 資訊等級 - 顯示 INFO, WARN, ERROR (預設) */
+    OutputLogLevel[OutputLogLevel["INFO"] = 1] = "INFO";
+    /** 警告等級 - 顯示 WARN, ERROR */
+    OutputLogLevel[OutputLogLevel["WARN"] = 2] = "WARN";
+    /** 錯誤等級 - 僅顯示 ERROR */
+    OutputLogLevel[OutputLogLevel["ERROR"] = 3] = "ERROR";
+})(OutputLogLevel || (exports.OutputLogLevel = OutputLogLevel = {}));
+/**
+ * 日誌等級名稱對應
+ */
+exports.OutputLogLevelNames = {
+    [OutputLogLevel.DEBUG]: 'DEBUG',
+    [OutputLogLevel.INFO]: 'INFO',
+    [OutputLogLevel.WARN]: 'WARN',
+    [OutputLogLevel.ERROR]: 'ERROR',
+};
+/**
+ * 字串轉換為日誌等級
+ * @param level - 日誌等級字串 (debug | info | warn | error)
+ * @returns 對應的 OutputLogLevel，無效時返回 undefined
+ */
+function parseOutputLogLevel(level) {
+    const normalized = level.toLowerCase().trim();
+    switch (normalized) {
+        case 'debug':
+            return OutputLogLevel.DEBUG;
+        case 'info':
+            return OutputLogLevel.INFO;
+        case 'warn':
+        case 'warning':
+            return OutputLogLevel.WARN;
+        case 'error':
+            return OutputLogLevel.ERROR;
+        default:
+            return undefined;
+    }
+}
+/**
+ * 檢查指定等級是否應該被輸出
+ * @param messageLevel - 訊息的日誌等級
+ * @param currentLevel - 目前設定的日誌等級
+ * @returns 是否應該輸出該訊息
+ */
+function shouldOutputLevel(messageLevel, currentLevel) {
+    return messageLevel >= currentLevel;
+}
+//# sourceMappingURL=log-level.enum.js.map