@uofx/cli 1.0.0

package/dist/domain/entities/credentials.entity.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Credentials = void 0;
+const instance_name_value_object_1 = require("../value-objects/instance-name.value-object");
+const mssql_password_value_object_1 = require("../value-objects/mssql-password.value-object");
+const rsa_key_pair_value_object_1 = require("../value-objects/rsa-key-pair.value-object");
+const jwt_key_value_object_1 = require("../value-objects/jwt-key.value-object");
+/**
+ * 憑證 Entity
+ *
+ * 儲存實例的各項憑證資訊
+ */
+class Credentials {
+    constructor(
+    /** 實例名稱 */
+    instanceName, 
+    /** SA 密碼 */
+    saPassword, 
+    /** Admin 密碼 */
+    adminPassword, 
+    /** SignIn RSA 金鑰對 */
+    signInRsaKeys, 
+    /** Uofx RSA 金鑰對 */
+    uofxRsaKeys, 
+    /** JWT 簽署金鑰 */
+    jwtKey, 
+    /** UofxDb 連線字串 */
+    connectionStringUofxDb, 
+    /** UofxSearchDb 連線字串 */
+    connectionStringUofxSearchDb) {
+        this.instanceName = instanceName;
+        this.saPassword = saPassword;
+        this.adminPassword = adminPassword;
+        this.signInRsaKeys = signInRsaKeys;
+        this.uofxRsaKeys = uofxRsaKeys;
+        this.jwtKey = jwtKey;
+        this.connectionStringUofxDb = connectionStringUofxDb;
+        this.connectionStringUofxSearchDb = connectionStringUofxSearchDb;
+    }
+    /**
+     * 從原始物件建立 Credentials
+     */
+    static fromObject(data) {
+        return new Credentials(instance_name_value_object_1.InstanceName.create(data.instanceName), mssql_password_value_object_1.MssqlPassword.create(data.saPassword), mssql_password_value_object_1.MssqlPassword.create(data.adminPassword), rsa_key_pair_value_object_1.RsaKeyPair.create(data.signInRsaPrivateKey, data.signInRsaPublicKey), rsa_key_pair_value_object_1.RsaKeyPair.create(data.uofxRsaPrivateKey, data.uofxRsaPublicKey), jwt_key_value_object_1.JwtKey.create(data.jwtSigningKey), data.connectionStringUofxDb, data.connectionStringUofxSearchDb);
+    }
+    /**
+     * 轉換為回應 DTO
+     */
+    toResponseDto() {
+        return {
+            instanceName: this.instanceName.toString(),
+            saPassword: this.saPassword.toString(),
+            adminPassword: this.adminPassword.toString(),
+            signInRsaPrivateKey: this.signInRsaKeys.privateKey,
+            signInRsaPublicKey: this.signInRsaKeys.publicKey,
+            uofxRsaPrivateKey: this.uofxRsaKeys.privateKey,
+            uofxRsaPublicKey: this.uofxRsaKeys.publicKey,
+            jwtSigningKey: this.jwtKey.toString(),
+            connectionStringUofxDb: this.connectionStringUofxDb,
+            connectionStringUofxSearchDb: this.connectionStringUofxSearchDb,
+        };
+    }
+}
+exports.Credentials = Credentials;
+//# sourceMappingURL=credentials.entity.js.map

package/dist/domain/entities/delete-instance-validation.entity.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteInstanceValidation = void 0;
+/**
+ * 刪除實例驗證 Entity
+ *
+ * 封裝刪除實例的驗證邏輯：
+ * - 運行中 + 無 force → 不允許刪除
+ * - 運行中 + force → 允許刪除，但需先停止
+ * - 已停止 → 直接允許刪除
+ */
+class DeleteInstanceValidation {
+    constructor(instanceName, isRunning, force) {
+        this.instanceName = instanceName;
+        this.isRunning = isRunning;
+        this.force = force;
+    }
+    /**
+     * 從實例狀態建立驗證物件
+     * @param status - 實例狀態
+     * @param force - 是否強制刪除
+     * @returns 驗證物件
+     */
+    static fromStatus(status, force) {
+        return new DeleteInstanceValidation(status.name, status.isRunning, force);
+    }
+    /**
+     * 建立運行中狀態的驗證物件
+     * @param instanceName - 實例名稱
+     * @param force - 是否強制刪除
+     * @returns 驗證物件
+     */
+    static running(instanceName, force) {
+        return new DeleteInstanceValidation(instanceName, true, force);
+    }
+    /**
+     * 建立已停止狀態的驗證物件
+     * @param instanceName - 實例名稱
+     * @returns 驗證物件
+     */
+    static stopped(instanceName) {
+        return new DeleteInstanceValidation(instanceName, false, false);
+    }
+    /**
+     * 驗證是否可以刪除
+     * @returns 驗證結果
+     */
+    validate() {
+        // 已停止：直接允許刪除
+        if (!this.isRunning) {
+            return {
+                canDelete: true,
+                needsStop: false,
+            };
+        }
+        // 運行中 + 無 force：不允許刪除
+        if (!this.force) {
+            return {
+                canDelete: false,
+                needsStop: false,
+                errorMessage: `Instance "${this.instanceName}" is running. Stop it first or use --force flag.`,
+            };
+        }
+        // 運行中 + force：允許刪除，但需先停止
+        return {
+            canDelete: true,
+            needsStop: true,
+        };
+    }
+    /**
+     * 是否可以刪除
+     */
+    get canDelete() {
+        return this.validate().canDelete;
+    }
+    /**
+     * 是否需要先停止實例
+     */
+    get needsStop() {
+        return this.validate().needsStop;
+    }
+    /**
+     * 取得錯誤訊息（如果不允許刪除）
+     */
+    get errorMessage() {
+        return this.validate().errorMessage;
+    }
+    /**
+     * 如果不允許刪除則拋出錯誤
+     * @throws Error 如果不允許刪除
+     */
+    assertCanDelete() {
+        const result = this.validate();
+        if (!result.canDelete) {
+            throw new Error(result.errorMessage);
+        }
+    }
+}
+exports.DeleteInstanceValidation = DeleteInstanceValidation;
+//# sourceMappingURL=delete-instance-validation.entity.js.map

package/dist/domain/entities/deployment-parameters.entity.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeploymentParameters = void 0;
+const mssql_password_value_object_1 = require("../value-objects/mssql-password.value-object");
+const jwt_key_value_object_1 = require("../value-objects/jwt-key.value-object");
+const rsa_key_pair_value_object_1 = require("../value-objects/rsa-key-pair.value-object");
+/**
+ * 部署參數 Entity
+ *
+ * 聚合所有部署所需的憑證與參數
+ */
+class DeploymentParameters {
+    constructor(instanceName, saPassword, adminPassword, signInRsaKeys, uofxRsaKeys, jwtKey, acrCredentials) {
+        this.instanceName = instanceName;
+        this.saPassword = saPassword;
+        this.adminPassword = adminPassword;
+        this.signInRsaKeys = signInRsaKeys;
+        this.uofxRsaKeys = uofxRsaKeys;
+        this.jwtKey = jwtKey;
+        this.acrCredentials = acrCredentials;
+    }
+    /**
+     * 建立部署參數
+     * @param instanceName - 實例名稱
+     * @param saPassword - SA 密碼
+     * @param adminPassword - Admin 密碼
+     * @param signInRsaKeys - SignIn RSA 金鑰對
+     * @param uofxRsaKeys - Uofx RSA 金鑰對
+     * @param jwtKey - JWT 金鑰
+     * @param acrCredentials - ACR 憑證
+     * @returns 部署參數物件
+     */
+    static create(instanceName, saPassword, adminPassword, signInRsaKeys, uofxRsaKeys, jwtKey, acrCredentials) {
+        return new DeploymentParameters(instanceName, saPassword, adminPassword, signInRsaKeys, uofxRsaKeys, jwtKey, acrCredentials);
+    }
+    /**
+     * 使用自動生成的憑證建立部署參數
+     * @param instanceName - 實例名稱
+     * @param acrCredentials - ACR 憑證
+     * @returns 部署參數物件
+     */
+    static createWithGeneratedCredentials(instanceName, acrCredentials) {
+        return new DeploymentParameters(instanceName, mssql_password_value_object_1.MssqlPassword.generate(), mssql_password_value_object_1.MssqlPassword.generate(), rsa_key_pair_value_object_1.RsaKeyPair.generate(), rsa_key_pair_value_object_1.RsaKeyPair.generate(), jwt_key_value_object_1.JwtKey.generate(), acrCredentials);
+    }
+    /**
+     * 取得 MSSQL 連線字串
+     * @param database - 資料庫名稱
+     * @param user - 使用者名稱
+     * @param password - 密碼
+     * @returns 連線字串
+     */
+    getConnectionString(database, user, password) {
+        return `Server=uofx-mssql-service;Database=${database};User Id=${user};Password=${password.toString()};TrustServerCertificate=True;`;
+    }
+    /**
+     * 取得 UofxDb 連線字串
+     * @returns 連線字串
+     */
+    get connectionStringUofxDb() {
+        return this.getConnectionString('UofxDb', 'admin', this.adminPassword);
+    }
+    /**
+     * 取得 UofxSearchDb 連線字串
+     * @returns 連線字串
+     */
+    get connectionStringUofxSearchDb() {
+        return this.getConnectionString('UofxSearchDb', 'admin', this.adminPassword);
+    }
+    /**
+     * 轉換為 Helm 部署格式
+     * @returns 包含所有參數的物件（值已編碼）
+     */
+    toHelmParameters() {
+        return {
+            saPasswordB64: Buffer.from(this.saPassword.toString()).toString('base64'),
+            adminPasswordB64: Buffer.from(this.adminPassword.toString()).toString('base64'),
+            rsaSignInPrivateB64: this.signInRsaKeys.toBase64ForSignIn('private'),
+            rsaSignInPublicB64: this.signInRsaKeys.toBase64ForSignIn('public'),
+            rsaUofxPrivateB64: this.uofxRsaKeys.toBase64ForUofx('private'),
+            rsaUofxPublicB64: this.uofxRsaKeys.toBase64ForUofx('public'),
+            jwtKeyB64: this.jwtKey.toBase64(),
+            connectionStringUofxDb: this.connectionStringUofxDb,
+            connectionStringUofxSearchDb: this.connectionStringUofxSearchDb,
+        };
+    }
+    /**
+     * 轉換為一般物件（用於日誌或序列化）
+     * 注意：敏感資訊已遮罩
+     * @returns 包含參數資訊的物件
+     */
+    toObject() {
+        return {
+            instanceName: this.instanceName.toString(),
+            saPassword: this.saPassword.toMasked(),
+            adminPassword: this.adminPassword.toMasked(),
+            acrName: this.acrCredentials.name,
+        };
+    }
+    /**
+     * 回傳可安全記錄到日志的物件
+     * 所有敏感欄位（密碼、金鑰）將被遮罩
+     *
+     * @returns 遮罩後的物件，可安全寫入日志
+     */
+    toSafeLog() {
+        return {
+            instanceName: this.instanceName.toString(),
+            saPassword: '***MASKED***',
+            adminPassword: '***MASKED***',
+            signInRsaKeys: '***MASKED***',
+            uofxRsaKeys: '***MASKED***',
+            jwtKey: '***MASKED***',
+            acrCredentials: this.acrCredentials.toSafeLog(),
+            connectionStringUofxDb: '***MASKED***',
+            connectionStringUofxSearchDb: '***MASKED***',
+        };
+    }
+}
+exports.DeploymentParameters = DeploymentParameters;
+//# sourceMappingURL=deployment-parameters.entity.js.map

package/dist/domain/entities/environment-validation.entity.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentValidation = void 0;
+/**
+ * 環境驗證 Entity
+ *
+ * 封裝環境驗證的業務邏輯，包括：
+ * - 運行環境檢查（WSL 是否已安裝）
+ * - 網路連線檢查（是否可連線至 Registry）
+ * - 系統資源檢查（記憶體是否足夠）
+ */
+class EnvironmentValidation {
+    constructor(
+    /** 作業系統資訊 */
+    osInfo, 
+    /** 運行環境資訊 */
+    runtimeInfo, 
+    /** 系統資源 */
+    systemResources, 
+    /** 網路狀態 */
+    networkStatus) {
+        this.osInfo = osInfo;
+        this.runtimeInfo = runtimeInfo;
+        this.systemResources = systemResources;
+        this.networkStatus = networkStatus;
+    }
+    /**
+     * 建立環境驗證實例
+     * @param osInfo - 作業系統資訊
+     * @param runtimeInfo - 運行環境資訊
+     * @param systemResources - 系統資源
+     * @param networkStatus - 網路狀態
+     * @returns EnvironmentValidation 實例
+     */
+    static create(osInfo, runtimeInfo, systemResources, networkStatus) {
+        return new EnvironmentValidation(osInfo, runtimeInfo, systemResources, networkStatus);
+    }
+    /**
+     * 檢查運行環境是否已安裝
+     */
+    get isRuntimeInstalled() {
+        return this.runtimeInfo.isInstalled;
+    }
+    /**
+     * 檢查網路是否正常（在線且可連線至 Registry）
+     */
+    get isNetworkHealthy() {
+        return this.networkStatus.isOnline && this.networkStatus.canReachRegistry;
+    }
+    /**
+     * 檢查是否有足夠的記憶體
+     */
+    get hasSufficientMemory() {
+        return this.systemResources.freeMemory >= EnvironmentValidation.REQUIRED_FREE_MEMORY;
+    }
+    /**
+     * 檢查所有驗證是否通過
+     */
+    get allChecksPassed() {
+        return this.isRuntimeInstalled && this.isNetworkHealthy;
+    }
+    /**
+     * 取得驗證失敗原因列表
+     * @returns 失敗原因陣列（若全部通過則為空陣列）
+     */
+    getFailureReasons() {
+        const failures = [];
+        if (!this.isRuntimeInstalled) {
+            failures.push({
+                type: 'runtime',
+                message: `${this.runtimeInfo.type} is not installed`,
+            });
+        }
+        if (!this.networkStatus.isOnline) {
+            failures.push({
+                type: 'network',
+                message: 'Network is offline',
+            });
+        }
+        else if (!this.networkStatus.canReachRegistry) {
+            failures.push({
+                type: 'network',
+                message: 'Cannot reach container registry',
+            });
+        }
+        if (!this.hasSufficientMemory) {
+            const requiredGb = EnvironmentValidation.REQUIRED_FREE_MEMORY / (1024 * 1024 * 1024);
+            const freeGb = (this.systemResources.freeMemory / (1024 * 1024 * 1024)).toFixed(1);
+            failures.push({
+                type: 'memory',
+                message: `Insufficient memory: ${freeGb}GB available, ${requiredGb}GB required`,
+            });
+        }
+        return failures;
+    }
+    /**
+     * 取得驗證失敗訊息（用於顯示）
+     * @returns 失敗訊息字串陣列
+     */
+    getFailureMessages() {
+        return this.getFailureReasons().map(f => f.message);
+    }
+    /**
+     * 取得可用記憶體（GB）
+     */
+    get freeMemoryGb() {
+        return this.systemResources.freeMemory / (1024 * 1024 * 1024);
+    }
+    /**
+     * 取得總記憶體（GB）
+     */
+    get totalMemoryGb() {
+        return this.systemResources.totalMemory / (1024 * 1024 * 1024);
+    }
+    /**
+     * 取得最低記憶體需求（GB）
+     */
+    static get requiredMemoryGb() {
+        return EnvironmentValidation.REQUIRED_FREE_MEMORY / (1024 * 1024 * 1024);
+    }
+}
+exports.EnvironmentValidation = EnvironmentValidation;
+/** 最低可用記憶體需求（16GB） */
+EnvironmentValidation.REQUIRED_FREE_MEMORY = 16 * 1024 * 1024 * 1024;
+//# sourceMappingURL=environment-validation.entity.js.map

package/dist/domain/entities/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Domain Entities
+ *
+ * 業務核心實體，封裝業務邏輯與狀態
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CredentialsResolver = exports.DeleteInstanceValidation = exports.InstanceListAggregator = exports.EnvironmentValidation = exports.InstanceLifecycleState = exports.LogFilter = exports.DeploymentParameters = exports.InstanceStatus = exports.InstanceMetadata = exports.Instance = void 0;
+var instance_entity_1 = require("./instance.entity");
+Object.defineProperty(exports, "Instance", { enumerable: true, get: function () { return instance_entity_1.Instance; } });
+var instance_metadata_entity_1 = require("./instance-metadata.entity");
+Object.defineProperty(exports, "InstanceMetadata", { enumerable: true, get: function () { return instance_metadata_entity_1.InstanceMetadata; } });
+var instance_status_entity_1 = require("./instance-status.entity");
+Object.defineProperty(exports, "InstanceStatus", { enumerable: true, get: function () { return instance_status_entity_1.InstanceStatus; } });
+var deployment_parameters_entity_1 = require("./deployment-parameters.entity");
+Object.defineProperty(exports, "DeploymentParameters", { enumerable: true, get: function () { return deployment_parameters_entity_1.DeploymentParameters; } });
+var log_filter_entity_1 = require("./log-filter.entity");
+Object.defineProperty(exports, "LogFilter", { enumerable: true, get: function () { return log_filter_entity_1.LogFilter; } });
+var instance_lifecycle_state_entity_1 = require("./instance-lifecycle-state.entity");
+Object.defineProperty(exports, "InstanceLifecycleState", { enumerable: true, get: function () { return instance_lifecycle_state_entity_1.InstanceLifecycleState; } });
+var environment_validation_entity_1 = require("./environment-validation.entity");
+Object.defineProperty(exports, "EnvironmentValidation", { enumerable: true, get: function () { return environment_validation_entity_1.EnvironmentValidation; } });
+var instance_list_aggregator_entity_1 = require("./instance-list-aggregator.entity");
+Object.defineProperty(exports, "InstanceListAggregator", { enumerable: true, get: function () { return instance_list_aggregator_entity_1.InstanceListAggregator; } });
+var delete_instance_validation_entity_1 = require("./delete-instance-validation.entity");
+Object.defineProperty(exports, "DeleteInstanceValidation", { enumerable: true, get: function () { return delete_instance_validation_entity_1.DeleteInstanceValidation; } });
+var credentials_resolver_entity_1 = require("./credentials-resolver.entity");
+Object.defineProperty(exports, "CredentialsResolver", { enumerable: true, get: function () { return credentials_resolver_entity_1.CredentialsResolver; } });
+//# sourceMappingURL=index.js.map

package/dist/domain/entities/instance-lifecycle-state.entity.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceLifecycleState = void 0;
+/**
+ * 實例生命週期狀態 Entity
+ *
+ * 封裝實例的運行狀態判斷邏輯，包括 WSL 和 MicroK8s 的狀態組合
+ *
+ * 狀態組合：
+ * - WSL 停止 + K8s 停止 = 完全停止
+ * - WSL 運行 + K8s 停止 = 部分啟動（需要啟動 K8s）
+ * - WSL 運行 + K8s 運行 = 完全運行
+ */
+class InstanceLifecycleState {
+    constructor(
+    /** WSL 是否運行中 */
+    isWslRunning, 
+    /** MicroK8s 是否運行中 */
+    isMicroK8sRunning) {
+        this.isWslRunning = isWslRunning;
+        this.isMicroK8sRunning = isMicroK8sRunning;
+    }
+    /**
+     * 從狀態資訊建立生命週期狀態
+     * @param wslStatus - WSL 實例狀態
+     * @param k8sRunning - MicroK8s 是否運行中
+     * @returns InstanceLifecycleState 實例
+     */
+    static fromStatus(wslStatus, k8sRunning) {
+        return new InstanceLifecycleState(wslStatus.isRunning, k8sRunning);
+    }
+    /**
+     * 建立完全停止狀態
+     * @returns InstanceLifecycleState 實例
+     */
+    static stopped() {
+        return new InstanceLifecycleState(false, false);
+    }
+    /**
+     * 建立完全運行狀態
+     * @returns InstanceLifecycleState 實例
+     */
+    static fullyRunning() {
+        return new InstanceLifecycleState(true, true);
+    }
+    /**
+     * 建立部分啟動狀態（WSL 運行但 K8s 未運行）
+     * @returns InstanceLifecycleState 實例
+     */
+    static partiallyRunning() {
+        return new InstanceLifecycleState(true, false);
+    }
+    /**
+     * 檢查是否完全運行（WSL + K8s 都在運行）
+     */
+    get isFullyRunning() {
+        return this.isWslRunning && this.isMicroK8sRunning;
+    }
+    /**
+     * 檢查是否完全停止
+     */
+    get isStopped() {
+        return !this.isWslRunning && !this.isMicroK8sRunning;
+    }
+    /**
+     * 檢查是否可以啟動 K8s（WSL 運行但 K8s 未運行）
+     */
+    get canStartK8s() {
+        return this.isWslRunning && !this.isMicroK8sRunning;
+    }
+    /**
+     * 檢查是否需要啟動（非完全運行狀態）
+     */
+    get needsStart() {
+        return !this.isFullyRunning;
+    }
+    /**
+     * 取得狀態描述
+     */
+    get description() {
+        if (this.isFullyRunning) {
+            return 'Fully Running';
+        }
+        if (this.canStartK8s) {
+            return 'WSL Running, K8s Stopped';
+        }
+        return 'Stopped';
+    }
+    /**
+     * 比較兩個狀態是否相等
+     * @param other - 另一個生命週期狀態
+     * @returns 若相等則回傳 true
+     */
+    equals(other) {
+        return (this.isWslRunning === other.isWslRunning &&
+            this.isMicroK8sRunning === other.isMicroK8sRunning);
+    }
+}
+exports.InstanceLifecycleState = InstanceLifecycleState;
+//# sourceMappingURL=instance-lifecycle-state.entity.js.map

package/dist/domain/entities/instance-list-aggregator.entity.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstanceListAggregator = void 0;
+const connection_info_value_object_1 = require("../value-objects/connection-info.value-object");
+/**
+ * 實例列表聚合器 Entity
+ *
+ * 封裝實例列表的聚合邏輯，包括：
+ * - 合併 WSL 實例資訊與 Metadata
+ * - 處理缺失的 Metadata 情況
+ * - 計算統計資訊
+ */
+class InstanceListAggregator {
+    /**
+     * 聚合實例資訊與 Metadata
+     * @param infos - WSL 實例資訊陣列
+     * @param metadataList - Metadata 陣列
+     * @param ipMap - 實例 IP 對照表 (fullName -> IP)
+     * @returns 聚合後的實例列表項目
+     */
+    static aggregate(infos, metadataList, ipMap) {
+        return infos.map(info => this.mergeInstanceInfo(info, metadataList, ipMap));
+    }
+    /**
+     * 合併單一實例資訊與 Metadata
+     * @param info - WSL 實例資訊
+     * @param metadataList - Metadata 陣列
+     * @param ipMap - 實例 IP 對照表
+     * @returns 聚合後的實例列表項目
+     */
+    static mergeInstanceInfo(info, metadataList, ipMap) {
+        const metadata = metadataList.find(m => m.name.fullName === info.name);
+        const ip = ipMap.get(info.name) ?? null;
+        const connectionInfo = connection_info_value_object_1.ConnectionInfo.create(ip);
+        const connectionDto = connectionInfo.toDto();
+        return {
+            name: metadata?.name.toString() || this.extractNameFromFullName(info.name),
+            fullName: info.name,
+            status: info.state,
+            wslVersion: info.version.toString(),
+            chartVersion: metadata?.chartVersion?.toString() || 'unknown',
+            installedAt: metadata?.createdAt.toISOString() || 'unknown',
+            adminUrl: connectionDto.adminUrl,
+            sqlServer: connectionDto.sqlServer,
+        };
+    }
+    /**
+     * 從完整名稱提取顯示名稱
+     * @param fullName - 完整名稱（uofx-xxx）
+     * @returns 顯示名稱
+     */
+    static extractNameFromFullName(fullName) {
+        const prefix = 'uofx-';
+        if (fullName.startsWith(prefix)) {
+            return fullName.substring(prefix.length);
+        }
+        return fullName;
+    }
+    /**
+     * 計算實例統計資訊
+     * @param instances - 實例列表項目陣列
+     * @returns 統計資訊
+     */
+    static calculateStatistics(instances) {
+        const total = instances.length;
+        const runningCount = instances.filter(i => i.status === 'Running').length;
+        const stoppedCount = instances.filter(i => i.status === 'Stopped').length;
+        return {
+            total,
+            runningCount,
+            stoppedCount,
+        };
+    }
+    /**
+     * 聚合並計算統計資訊（組合方法）
+     * @param infos - WSL 實例資訊陣列
+     * @param metadataList - Metadata 陣列
+     * @param ipMap - 實例 IP 對照表 (fullName -> IP)
+     * @returns 包含實例列表和統計資訊的物件
+     */
+    static aggregateWithStatistics(infos, metadataList, ipMap) {
+        const instances = this.aggregate(infos, metadataList, ipMap);
+        const statistics = this.calculateStatistics(instances);
+        return { instances, statistics };
+    }
+    /**
+     * 過濾運行中的實例
+     * @param instances - 實例列表項目陣列
+     * @returns 運行中的實例
+     */
+    static filterRunning(instances) {
+        return instances.filter(i => i.status === 'Running');
+    }
+    /**
+     * 過濾停止的實例
+     * @param instances - 實例列表項目陣列
+     * @returns 停止的實例
+     */
+    static filterStopped(instances) {
+        return instances.filter(i => i.status === 'Stopped');
+    }
+}
+exports.InstanceListAggregator = InstanceListAggregator;
+//# sourceMappingURL=instance-list-aggregator.entity.js.map