@uofx/cli 1.0.0

package/dist/domain/types/validation.types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * 系統驗證相關類型定義
+ *
+ * 這些類型用於系統檢查和驗證流程，表示檢查結果的數據結構
+ * 注意：這些是數據傳輸對象（DTO），不是異常類型
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=validation.types.js.map

package/dist/domain/value-objects/acr-credentials.value-object.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcrCredentials = void 0;
+/**
+ * Azure Container Registry 憑證 Value Object
+ *
+ * 封裝 ACR 憑證的資料結構與驗證邏輯
+ */
+class AcrCredentials {
+    constructor(name, account, password) {
+        this.name = name;
+        this.account = account;
+        this.password = password;
+    }
+    /**
+     * 建立 ACR 憑證
+     * @param name - ACR 名稱
+     * @param account - 帳號
+     * @param password - 密碼
+     * @returns ACR 憑證物件
+     * @throws 若任何欄位為空
+     */
+    static create(name, account, password) {
+        if (!this.isValid(name, account, password)) {
+            throw new Error('Invalid ACR credentials: name, account, and password are required');
+        }
+        return new AcrCredentials(name, account, password);
+    }
+    /**
+     * 從物件建立 ACR 憑證
+     * @param data - 包含 name, account, password 的物件
+     * @returns ACR 憑證物件
+     * @throws 若資料格式不正確
+     */
+    static fromObject(data) {
+        return this.create(data.name, data.account, data.password);
+    }
+    /**
+     * 驗證憑證資料是否完整
+     * @param name - ACR 名稱
+     * @param account - 帳號
+     * @param password - 密碼
+     * @returns 若所有欄位都非空則回傳 true
+     */
+    static isValid(name, account, password) {
+        return !!(name && account && password);
+    }
+    /**
+     * 取得完整的 ACR 登入伺服器位址
+     * @returns ACR 登入伺服器 URL
+     */
+    get loginServer() {
+        return `${this.name}.azurecr.io`;
+    }
+    /**
+     * 轉換為一般物件（用於序列化）
+     * @returns 包含 name, account, password 的物件
+     */
+    toObject() {
+        return {
+            name: this.name,
+            account: this.account,
+            password: this.password,
+        };
+    }
+    /**
+     * 比較兩個憑證是否相等
+     * @param other - 另一個憑證
+     * @returns 若所有欄位都相等則回傳 true
+     */
+    equals(other) {
+        return (this.name === other.name &&
+            this.account === other.account &&
+            this.password === other.password);
+    }
+    /**
+     * 回傳可安全記錄到日志的物件
+     * 密碼欄位將被遮罩
+     *
+     * @returns 遮罩後的物件，可安全寫入日志
+     */
+    toSafeLog() {
+        return {
+            name: this.name,
+            account: this.account,
+            password: '***MASKED***',
+            loginServer: this.loginServer,
+        };
+    }
+}
+exports.AcrCredentials = AcrCredentials;
+//# sourceMappingURL=acr-credentials.value-object.js.map

package/dist/domain/value-objects/chart-version.value-object.js

@@ -0,0 +1,124 @@
+"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 __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.ChartVersion = void 0;
+const semver = __importStar(require("semver"));
+/**
+ * Chart 版本 Value Object
+ *
+ * 封裝 Helm Chart 版本的驗證規則與格式化邏輯
+ * 規則：
+ * - 必須是有效的 SemVer 格式 (例如：1.0.0, 2.1.3)
+ * - 或者是特殊關鍵字 'latest'
+ */
+class ChartVersion {
+    constructor(value) {
+        this.value = value;
+    }
+    /**
+     * 建立 Chart 版本
+     * @param version - 版本字串
+     * @returns Chart 版本物件
+     * @throws 若版本格式不正確
+     */
+    static create(version) {
+        if (!this.isValid(version)) {
+            throw new Error(`Invalid chart version: "${version}". ` +
+                `Version must be a valid SemVer format (e.g., 1.0.0) or "latest".`);
+        }
+        return new ChartVersion(version);
+    }
+    /**
+     * 建立 'latest' 版本
+     * @returns Latest 版本物件
+     */
+    static createLatest() {
+        return new ChartVersion(this.LATEST);
+    }
+    /**
+     * 驗證版本格式
+     * @param version - 要驗證的版本
+     * @returns 若格式正確則回傳 true
+     */
+    static isValid(version) {
+        if (!version || typeof version !== 'string') {
+            return false;
+        }
+        // 允許 'latest'
+        if (version.toLowerCase() === this.LATEST) {
+            return true;
+        }
+        // 驗證 SemVer 格式
+        return semver.valid(version) !== null;
+    }
+    /**
+     * 檢查是否為 'latest' 版本
+     * @returns 若為 latest 則回傳 true
+     */
+    get isLatest() {
+        return this.value.toLowerCase() === ChartVersion.LATEST;
+    }
+    /**
+     * 取得版本字串
+     * @returns 版本字串
+     */
+    toString() {
+        return this.value;
+    }
+    /**
+     * 比較兩個版本是否相等
+     * @param other - 另一個版本
+     * @returns 若相等則回傳 true
+     */
+    equals(other) {
+        return this.value === other.value;
+    }
+    /**
+     * 比較版本大小
+     * @param other - 另一個版本
+     * @returns 若 this > other 則回傳 1，this < other 則回傳 -1，相等則回傳 0
+     * @throws 若任一版本為 'latest'
+     */
+    compare(other) {
+        if (this.isLatest || other.isLatest) {
+            throw new Error('Cannot compare versions when either is "latest"');
+        }
+        const result = semver.compare(this.value, other.value);
+        return result;
+    }
+}
+exports.ChartVersion = ChartVersion;
+ChartVersion.LATEST = 'latest';
+//# sourceMappingURL=chart-version.value-object.js.map

package/dist/domain/value-objects/config-log-level.value-object.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigLogLevelValue = void 0;
+/**
+ * 配置日誌級別 Value Object
+ *
+ * 封裝配置日誌級別的驗證邏輯
+ * 有效值：debug, info, error
+ */
+class ConfigLogLevelValue {
+    constructor(value) {
+        this.value = value;
+    }
+    /**
+     * 建立日誌級別
+     * @param level - 日誌級別字串
+     * @returns ConfigLogLevelValue 實例
+     * @throws 若級別無效
+     */
+    static create(level) {
+        if (!this.isValid(level)) {
+            throw new Error(`Invalid log level: "${level}". Valid values: ${this.VALID_LEVELS.join(', ')}`);
+        }
+        return new ConfigLogLevelValue(level);
+    }
+    /**
+     * 嘗試建立日誌級別，若無效則返回 null
+     * @param level - 日誌級別字串
+     * @returns ConfigLogLevelValue 實例或 null
+     */
+    static tryCreate(level) {
+        if (!this.isValid(level)) {
+            return null;
+        }
+        return new ConfigLogLevelValue(level);
+    }
+    /**
+     * 驗證級別是否有效
+     * @param level - 日誌級別字串
+     * @returns 若有效則回傳 true
+     */
+    static isValid(level) {
+        return this.VALID_LEVELS.includes(level);
+    }
+    /**
+     * 取得日誌級別字串值
+     * @returns 日誌級別字串
+     */
+    toString() {
+        return this.value;
+    }
+    /**
+     * 轉換為配置類型
+     * @returns ConfigLogLevel 類型值
+     */
+    toConfigType() {
+        return this.value;
+    }
+    /**
+     * 比較兩個日誌級別是否相等
+     * @param other - 另一個日誌級別
+     * @returns 若相等則回傳 true
+     */
+    equals(other) {
+        return this.value === other.value;
+    }
+    /**
+     * 檢查此級別是否高於另一個級別
+     * @param other - 另一個日誌級別
+     * @returns 若此級別更高則回傳 true
+     */
+    isHigherThan(other) {
+        const order = {
+            'debug': 0,
+            'info': 1,
+            'error': 2,
+        };
+        return order[this.value] > order[other.value];
+    }
+}
+exports.ConfigLogLevelValue = ConfigLogLevelValue;
+/** 有效的日誌級別 */
+ConfigLogLevelValue.VALID_LEVELS = ['debug', 'info', 'error'];
+//# sourceMappingURL=config-log-level.value-object.js.map

package/dist/domain/value-objects/connection-info.value-object.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectionInfo = void 0;
+/**
+ * 連線資訊 Value Object
+ *
+ * 封裝實例連線資訊的生成邏輯
+ * 包含實例 IP、管理介面 URL、SQL Server 連線字串
+ */
+class ConnectionInfo {
+    constructor(
+    /** 實例的 IP 位址 */
+    instanceIp, 
+    /** 管理介面 URL */
+    adminUrl, 
+    /** SQL Server 連線位址 */
+    sqlServer) {
+        this.instanceIp = instanceIp;
+        this.adminUrl = adminUrl;
+        this.sqlServer = sqlServer;
+    }
+    /**
+     * 從實例 IP 建立連線資訊
+     * @param instanceIp - 實例的 IP 位址，若為 null 則所有連線資訊皆為 null
+     * @returns 連線資訊物件
+     */
+    static create(instanceIp) {
+        if (!instanceIp) {
+            return new ConnectionInfo(null, null, null);
+        }
+        return new ConnectionInfo(instanceIp, `http://${instanceIp}:${this.ADMIN_PORT}`, `${instanceIp},${this.SQL_PORT}`);
+    }
+    /**
+     * 檢查連線資訊是否可用
+     * @returns 若 IP 存在則回傳 true
+     */
+    get isAvailable() {
+        return this.instanceIp !== null;
+    }
+    /**
+     * 轉換為 DTO 格式
+     * @returns 包含連線資訊的物件
+     */
+    toDto() {
+        return {
+            instanceIp: this.instanceIp,
+            adminUrl: this.adminUrl,
+            sqlServer: this.sqlServer,
+        };
+    }
+    /**
+     * 比較兩個連線資訊是否相等
+     * @param other - 另一個連線資訊
+     * @returns 若相等則回傳 true
+     */
+    equals(other) {
+        return this.instanceIp === other.instanceIp;
+    }
+}
+exports.ConnectionInfo = ConnectionInfo;
+/** 管理介面埠號 */
+ConnectionInfo.ADMIN_PORT = 16888;
+/** SQL Server 埠號 */
+ConnectionInfo.SQL_PORT = 30022;
+//# sourceMappingURL=connection-info.value-object.js.map

package/dist/domain/value-objects/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Domain Value Objects
+ *
+ * 不可變物件，封裝驗證規則與轉換邏輯
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigLogLevelValue = exports.ConnectionInfo = exports.AcrCredentials = exports.RsaKeyPair = exports.JwtKey = exports.MssqlPassword = exports.ChartVersion = exports.InstanceName = void 0;
+var instance_name_value_object_1 = require("./instance-name.value-object");
+Object.defineProperty(exports, "InstanceName", { enumerable: true, get: function () { return instance_name_value_object_1.InstanceName; } });
+var chart_version_value_object_1 = require("./chart-version.value-object");
+Object.defineProperty(exports, "ChartVersion", { enumerable: true, get: function () { return chart_version_value_object_1.ChartVersion; } });
+var mssql_password_value_object_1 = require("./mssql-password.value-object");
+Object.defineProperty(exports, "MssqlPassword", { enumerable: true, get: function () { return mssql_password_value_object_1.MssqlPassword; } });
+var jwt_key_value_object_1 = require("./jwt-key.value-object");
+Object.defineProperty(exports, "JwtKey", { enumerable: true, get: function () { return jwt_key_value_object_1.JwtKey; } });
+var rsa_key_pair_value_object_1 = require("./rsa-key-pair.value-object");
+Object.defineProperty(exports, "RsaKeyPair", { enumerable: true, get: function () { return rsa_key_pair_value_object_1.RsaKeyPair; } });
+var acr_credentials_value_object_1 = require("./acr-credentials.value-object");
+Object.defineProperty(exports, "AcrCredentials", { enumerable: true, get: function () { return acr_credentials_value_object_1.AcrCredentials; } });
+var connection_info_value_object_1 = require("./connection-info.value-object");
+Object.defineProperty(exports, "ConnectionInfo", { enumerable: true, get: function () { return connection_info_value_object_1.ConnectionInfo; } });
+var config_log_level_value_object_1 = require("./config-log-level.value-object");
+Object.defineProperty(exports, "ConfigLogLevelValue", { enumerable: true, get: function () { return config_log_level_value_object_1.ConfigLogLevelValue; } });
+//# sourceMappingURL=index.js.map

package/dist/domain/value-objects/instance-name.value-object.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceName = void 0;
+/**
+ * 實例名稱 Value Object
+ *
+ * 封裝實例名稱的驗證規則與轉換邏輯
+ * 規則：
+ * - 長度：1-50 字元
+ * - 格式：開頭與結尾必須是英數字元，中間可包含連字號
+ * - 完整名稱格式：uofx-{name}
+ */
+class InstanceName {
+    constructor(value) {
+        this.value = value;
+    }
+    /**
+     * 建立實例名稱
+     * @param name - 原始名稱（可包含或不包含 uofx- 前綴）
+     * @returns 實例名稱物件
+     * @throws 若名稱格式不正確
+     */
+    static create(name) {
+        // 如果輸入已有 uofx- 前綴，自動去除（允許用戶輸入完整名稱）
+        const prefix = 'uofx-';
+        const normalizedName = name.startsWith(prefix)
+            ? name.substring(prefix.length)
+            : name;
+        if (!this.isValid(normalizedName)) {
+            throw new Error(`Invalid instance name: "${name}". ` +
+                `Name must be ${this.MIN_LENGTH}-${this.MAX_LENGTH} characters, ` +
+                `start and end with alphanumeric characters, and may contain hyphens.`);
+        }
+        return new InstanceName(normalizedName);
+    }
+    /**
+     * 從完整名稱建立實例名稱
+     * @param fullName - 完整名稱 (uofx-{name})
+     * @returns 實例名稱物件
+     * @throws 若名稱格式不正確
+     */
+    static createFromFullName(fullName) {
+        const prefix = 'uofx-';
+        if (!fullName.startsWith(prefix)) {
+            throw new Error(`Invalid full instance name: "${fullName}". Expected format: uofx-{name}`);
+        }
+        const name = fullName.substring(prefix.length);
+        return this.create(name);
+    }
+    /**
+     * 驗證名稱格式
+     * @param name - 要驗證的名稱
+     * @returns 若格式正確則回傳 true
+     */
+    static isValid(name) {
+        if (!name || typeof name !== 'string') {
+            return false;
+        }
+        if (name.length < this.MIN_LENGTH || name.length > this.MAX_LENGTH) {
+            return false;
+        }
+        return this.PATTERN.test(name);
+    }
+    /**
+     * 取得完整的 WSL 實例名稱
+     * @returns 格式化後的完整名稱 (uofx-{name})
+     */
+    get fullName() {
+        return `uofx-${this.value}`;
+    }
+    /**
+     * 取得原始名稱
+     * @returns 原始名稱
+     */
+    toString() {
+        return this.value;
+    }
+    /**
+     * 比較兩個實例名稱是否相等
+     * @param other - 另一個實例名稱
+     * @returns 若相等則回傳 true
+     */
+    equals(other) {
+        return this.value === other.value;
+    }
+}
+exports.InstanceName = InstanceName;
+InstanceName.PATTERN = /^[a-zA-Z0-9]([a-zA-Z0-9-]{0,48}[a-zA-Z0-9])?$/;
+InstanceName.MIN_LENGTH = 1;
+InstanceName.MAX_LENGTH = 50;
+//# sourceMappingURL=instance-name.value-object.js.map

package/dist/domain/value-objects/jwt-key.value-object.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JwtKey = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+/**
+ * JWT 簽署金鑰 Value Object
+ *
+ * 封裝 JWT 簽署金鑰的生成與驗證邏輯
+ * 規則：
+ * - 長度至少 63 字元
+ * - 僅包含英數字元 (A-Za-z0-9)
+ */
+class JwtKey {
+    constructor(value) {
+        this.value = value;
+    }
+    /**
+     * 生成 JWT 簽署金鑰
+     * @param length - 金鑰長度（預設：63）
+     * @returns JWT 金鑰物件
+     * @throws 若長度小於 63 或生成失敗
+     */
+    static generate(length = 63) {
+        if (length < this.MIN_LENGTH) {
+            throw new Error(`JWT key length must be at least ${this.MIN_LENGTH} characters`);
+        }
+        try {
+            let key = '';
+            for (let i = 0; i < length; i++) {
+                const randomIndex = crypto_1.default.randomInt(0, this.CHARSET.length);
+                key += this.CHARSET.charAt(randomIndex);
+            }
+            // 驗證生成的金鑰
+            if (!this.isValid(key)) {
+                throw new Error('Generated JWT key validation failed');
+            }
+            return new JwtKey(key);
+        }
+        catch (error) {
+            throw new Error(`Failed to generate JWT signing key: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 從現有金鑰建立金鑰物件
+     * @param key - 金鑰字串
+     * @returns JWT 金鑰物件
+     * @throws 若金鑰格式不正確
+     */
+    static create(key) {
+        if (!this.isValid(key)) {
+            throw new Error(`Invalid JWT signing key. Must be at least ${this.MIN_LENGTH} characters ` +
+                `and contain only alphanumeric characters.`);
+        }
+        return new JwtKey(key);
+    }
+    /**
+     * 驗證 JWT 簽署金鑰格式
+     * @param key - 要驗證的金鑰
+     * @returns 若格式正確則回傳 true
+     */
+    static isValid(key) {
+        if (!key || key.length < this.MIN_LENGTH) {
+            return false;
+        }
+        // 僅允許英數字元
+        return /^[A-Za-z0-9]+$/.test(key);
+    }
+    /**
+     * 取得金鑰明文
+     * @returns 金鑰字串
+     */
+    toString() {
+        return this.value;
+    }
+    /**
+     * 格式化 JWT Signing Key 給 Helm 使用 (Base64 編碼)
+     * @returns Base64 編碼後的金鑰
+     */
+    toBase64() {
+        return Buffer.from(this.value, 'utf8').toString('base64');
+    }
+    /**
+     * 比較兩個金鑰是否相等
+     * @param other - 另一個金鑰
+     * @returns 若相等則回傳 true
+     */
+    equals(other) {
+        return this.value === other.value;
+    }
+}
+exports.JwtKey = JwtKey;
+JwtKey.MIN_LENGTH = 63;
+JwtKey.CHARSET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+//# sourceMappingURL=jwt-key.value-object.js.map