@uofx/cli 1.0.2 → 1.1.0

package/dist/domain/entities/index.js

@@ -5,7 +5,7 @@
  * 業務核心實體，封裝業務邏輯與狀態
  */
 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;
+exports.TemplateInfo = exports.Credentials = 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");
@@ -26,4 +26,8 @@ var delete_instance_validation_entity_1 = require("./delete-instance-validation.
 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; } });
+var credentials_entity_1 = require("./credentials.entity");
+Object.defineProperty(exports, "Credentials", { enumerable: true, get: function () { return credentials_entity_1.Credentials; } });
+var template_info_entity_1 = require("./template-info.entity");
+Object.defineProperty(exports, "TemplateInfo", { enumerable: true, get: function () { return template_info_entity_1.TemplateInfo; } });
 //# sourceMappingURL=index.js.map

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

@@ -1,7 +1,7 @@
 "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");
+const value_objects_1 = require("../value-objects");
 /**
  * 實例列表聚合器 Entity
  *
@@ -31,7 +31,7 @@ class InstanceListAggregator {
     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 connectionInfo = value_objects_1.ConnectionInfo.create(ip);
         const connectionDto = connectionInfo.toDto();
         return {
             name: metadata?.name.toString() || this.extractNameFromFullName(info.name),

package/dist/domain/entities/instance-metadata.entity.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InstanceMetadata = void 0;
-const instance_name_value_object_1 = require("../value-objects/instance-name.value-object");
-const chart_version_value_object_1 = require("../value-objects/chart-version.value-object");
+const value_objects_1 = require("../value-objects");
 /**
  * 實例元資料 Entity
  *
@@ -34,7 +33,7 @@ class InstanceMetadata {
      * @returns 元資料物件
      */
     static fromObject(data) {
-        return new InstanceMetadata(instance_name_value_object_1.InstanceName.create(data.displayName), data.displayName, new Date(data.createdAt), data.version, data.rootfsVersion, data.chartVersion ? chart_version_value_object_1.ChartVersion.create(data.chartVersion) : undefined);
+        return new InstanceMetadata(value_objects_1.InstanceName.create(data.displayName), data.displayName, new Date(data.createdAt), data.version, data.rootfsVersion, data.chartVersion ? value_objects_1.ChartVersion.create(data.chartVersion) : undefined);
     }
     /**
      * 更新 chart 版本

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Instance = void 0;
 const instance_status_entity_1 = require("./instance-status.entity");
+const errors_1 = require("../errors");
 /**
  * WSL 實例 Entity (Aggregate Root)
  *
@@ -20,7 +21,7 @@ class Instance {
      */
     static create(metadata, status) {
         if (metadata.fullName !== status.name) {
-            throw new Error(`Instance name mismatch: metadata.fullName="${metadata.fullName}" vs status.name="${status.name}"`);
+            throw new errors_1.AppError(`Instance name mismatch: metadata.fullName="${metadata.fullName}" vs status.name="${status.name}"`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
         }
         return new Instance(metadata, status);
     }

package/dist/domain/entities/log-filter.entity.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LogFilter = void 0;
-const logger_types_1 = require("../types/logger.types");
+const types_1 = require("../types");
 /**
  * 日誌過濾器 Entity
  *
@@ -132,10 +132,10 @@ LogFilter.TIME_MULTIPLIERS = {
 };
 /** 日誌層級對應表 */
 LogFilter.LEVEL_MAP = {
-    'debug': logger_types_1.LogLevel.DEBUG,
-    'info': logger_types_1.LogLevel.INFO,
-    'warn': logger_types_1.LogLevel.WARN,
-    'error': logger_types_1.LogLevel.ERROR,
-    'fatal': logger_types_1.LogLevel.FATAL,
+    'debug': types_1.LogLevel.DEBUG,
+    'info': types_1.LogLevel.INFO,
+    'warn': types_1.LogLevel.WARN,
+    'error': types_1.LogLevel.ERROR,
+    'fatal': types_1.LogLevel.FATAL,
 };
 //# sourceMappingURL=log-filter.entity.js.map

package/dist/domain/entities/template-info.entity.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Template Info Entity
+ *
+ * 樣板資訊實體，包含樣板的元資料
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateInfo = void 0;
+/**
+ * 樣板資訊實體
+ */
+class TemplateInfo {
+    constructor(name, displayName, version, source, variables, schematics, installedAt, path) {
+        this.name = name;
+        this.displayName = displayName;
+        this.version = version;
+        this.source = source;
+        this.variables = variables;
+        this.schematics = schematics;
+        this.installedAt = installedAt;
+        this.path = path;
+    }
+    /**
+     * 從 template.json 建立實體
+     */
+    static fromJson(json, installedAt, path) {
+        return new TemplateInfo(json.name, json.displayName || json.name, json.version || '1.0.0', json.source || { type: 'local' }, json.variables || [], json.schematics || {}, installedAt, path);
+    }
+    /**
+     * 從名稱與版本建立實體
+     * @param name - 樣板名稱
+     * @param version - 樣板版本
+     * @param installedAt - 安裝時間
+     * @param templatePath - 樣板路徑
+     * @param sourceUrl - 來源 URL
+     */
+    static create(name, version, installedAt, templatePath, sourceUrl) {
+        return new TemplateInfo(name, name, version, sourceUrl ? { type: 'url', url: sourceUrl } : { type: 'local' }, [], {}, installedAt, templatePath);
+    }
+    /**
+     * 轉換為顯示資訊
+     */
+    toDisplayInfo() {
+        return {
+            name: this.name,
+            displayName: this.displayName,
+            version: this.version,
+            installedAt: this.installedAt.toISOString(),
+            path: this.path,
+        };
+    }
+    /**
+     * 取得 schematic 路徑
+     */
+    getSchematicPath(type, platform) {
+        const config = this.schematics[type];
+        if (!config)
+            return undefined;
+        return config[platform];
+    }
+}
+exports.TemplateInfo = TemplateInfo;
+//# sourceMappingURL=template-info.entity.js.map

package/dist/{infrastructure/utils/error-formatter.util.js → domain/errors/error-utils.js}

@@ -26,4 +26,4 @@ function toError(error, defaultMessage = 'Unknown error') {
     }
     return new Error(error ? String(error) : defaultMessage);
 }
-//# sourceMappingURL=error-formatter.util.js.map
+//# sourceMappingURL=error-utils.js.map

package/dist/domain/errors/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Domain 錯誤系統匯出
+ *
+ * 統一錯誤類別、退出碼與工具函式的匯出點
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toError = exports.formatErrorMessage = exports.EXIT_CODES = exports.AppError = void 0;
+// 錯誤類別
+var app_error_1 = require("./app-error");
+Object.defineProperty(exports, "AppError", { enumerable: true, get: function () { return app_error_1.AppError; } });
+// 退出碼
+var exit_codes_1 = require("./exit-codes");
+Object.defineProperty(exports, "EXIT_CODES", { enumerable: true, get: function () { return exit_codes_1.EXIT_CODES; } });
+// 錯誤工具函式
+var error_utils_1 = require("./error-utils");
+Object.defineProperty(exports, "formatErrorMessage", { enumerable: true, get: function () { return error_utils_1.formatErrorMessage; } });
+Object.defineProperty(exports, "toError", { enumerable: true, get: function () { return error_utils_1.toError; } });
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js

@@ -26,4 +26,10 @@ __exportStar(require("./value-objects"), exports);
 __exportStar(require("./entities"), exports);
 // Ports (介面定義，供 Infrastructure 層實作)
 __exportStar(require("./ports"), exports);
+// Errors (錯誤類別與退出碼)
+__exportStar(require("./errors"), exports);
+// Types (領域類型定義)
+__exportStar(require("./types"), exports);
+// Interfaces (領域介面)
+__exportStar(require("./interfaces"), exports);
 //# sourceMappingURL=index.js.map

package/dist/domain/interfaces/index.js

@@ -0,0 +1,21 @@
+"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 __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 });
+/**
+ * Domain 層介面匯出
+ */
+__exportStar(require("./safe-loggable.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/domain/ports/dotnet-publisher.port.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Dotnet Publisher Port
+ *
+ * 定義執行 dotnet publish 的抽象介面
+ * 由 Infrastructure 層實作
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dotnet-publisher.port.js.map

package/dist/{infrastructure/http/interfaces/http-client.interface.js → domain/ports/file-system.port.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=http-client.interface.js.map
+//# sourceMappingURL=file-system.port.js.map

package/dist/domain/ports/http-client.port.js

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

package/dist/domain/ports/index.js

@@ -43,4 +43,14 @@ __exportStar(require("./base-image.port"), exports);
 __exportStar(require("./app-config.port"), exports);
 __exportStar(require("./error-handler.port"), exports);
 __exportStar(require("./correlation-id.port"), exports);
+__exportStar(require("./http-client.port"), exports);
+__exportStar(require("./output.port"), exports);
+__exportStar(require("./user-interaction.port"), exports);
+__exportStar(require("./template-manager.port"), exports);
+__exportStar(require("./project-scaffolder.port"), exports);
+__exportStar(require("./schematics-runner.port"), exports);
+__exportStar(require("./dotnet-publisher.port"), exports);
+__exportStar(require("./wsl-setup.port"), exports);
+__exportStar(require("./progress.port"), exports);
+__exportStar(require("./file-system.port"), exports);
 //# sourceMappingURL=index.js.map

package/dist/domain/ports/logger.port.js

@@ -8,7 +8,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LogLevelNames = exports.LogLevel = void 0;
 // Re-export 類型供外部使用
-var logger_types_1 = require("../types/logger.types");
-Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_types_1.LogLevel; } });
-Object.defineProperty(exports, "LogLevelNames", { enumerable: true, get: function () { return logger_types_1.LogLevelNames; } });
+var types_1 = require("../types");
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return types_1.LogLevel; } });
+Object.defineProperty(exports, "LogLevelNames", { enumerable: true, get: function () { return types_1.LogLevelNames; } });
 //# sourceMappingURL=logger.port.js.map

package/dist/domain/ports/progress.port.js

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

package/dist/domain/ports/project-scaffolder.port.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Project Scaffolder Port
+ *
+ * 定義建立新專案的抽象介面
+ * 由 Infrastructure 層實作，從已安裝的樣板複製並初始化專案
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=project-scaffolder.port.js.map

package/dist/domain/ports/schematics-runner.port.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Schematics Runner Port
+ *
+ * 定義執行 Angular schematics 的抽象介面
+ * 由 Infrastructure 層實作，透過 npx ng generate 呼叫 @uofx/plugin-schematics
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schematics-runner.port.js.map

package/dist/domain/ports/template-manager.port.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Template Manager Port
+ *
+ * 定義樣板管理能力的抽象介面
+ * 由 Infrastructure 層實作
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=template-manager.port.js.map

package/dist/domain/ports/wsl-setup.port.js

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

package/dist/domain/types/index.js

@@ -19,4 +19,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./logger.types"), exports);
+__exportStar(require("./validation.types"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AcrCredentials = void 0;
+const errors_1 = require("../errors");
 /**
  * Azure Container Registry 憑證 Value Object
  *
@@ -22,7 +23,7 @@ class AcrCredentials {
      */
     static create(name, account, password) {
         if (!this.isValid(name, account, password)) {
-            throw new Error('Invalid ACR credentials: name, account, and password are required');
+            throw new errors_1.AppError('Invalid ACR credentials: name, account, and password are required', { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
         }
         return new AcrCredentials(name, account, password);
     }
@@ -63,6 +64,17 @@ class AcrCredentials {
             password: this.password,
         };
     }
+    /**
+     * 防止 JSON.stringify 意外洩露密碼，回傳遮罩值
+     * @returns 遮罩後的物件
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            account: this.account,
+            password: '***MASKED***',
+        };
+    }
     /**
      * 比較兩個憑證是否相等
      * @param other - 另一個憑證

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

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChartVersion = void 0;
 const semver = __importStar(require("semver"));
+const errors_1 = require("../errors");
 /**
  * Chart 版本 Value Object
  *
@@ -55,8 +56,8 @@ class ChartVersion {
      */
     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".`);
+            throw new errors_1.AppError(`Invalid chart version: "${version}". ` +
+                `Version must be a valid SemVer format (e.g., 1.0.0) or "latest".`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
         }
         return new ChartVersion(version);
     }
@@ -105,6 +106,20 @@ class ChartVersion {
     equals(other) {
         return this.value === other.value;
     }
+    /**
+     * 取得版本類型
+     * @returns 'Beta' 或 'Stable'
+     */
+    getType() {
+        const parts = this.value.split('.');
+        if (parts.length >= 3) {
+            const patch = parts[2];
+            if (patch.startsWith('2')) {
+                return 'Beta';
+            }
+        }
+        return 'Stable';
+    }
     /**
      * 比較版本大小
      * @param other - 另一個版本
@@ -113,7 +128,9 @@ class ChartVersion {
      */
     compare(other) {
         if (this.isLatest || other.isLatest) {
-            throw new Error('Cannot compare versions when either is "latest"');
+            throw new errors_1.AppError('Cannot compare versions when either is "latest"', {
+                exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR,
+            });
         }
         const result = semver.compare(this.value, other.value);
         return result;

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigLogLevelValue = void 0;
+const errors_1 = require("../errors");
 /**
  * 配置日誌級別 Value Object
  *
@@ -19,7 +20,7 @@ class ConfigLogLevelValue {
      */
     static create(level) {
         if (!this.isValid(level)) {
-            throw new Error(`Invalid log level: "${level}". Valid values: ${this.VALID_LEVELS.join(', ')}`);
+            throw new errors_1.AppError(`Invalid log level: "${level}". Valid values: ${this.VALID_LEVELS.join(', ')}`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
         }
         return new ConfigLogLevelValue(level);
     }

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

@@ -5,7 +5,7 @@
  * 不可變物件，封裝驗證規則與轉換邏輯
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConfigLogLevelValue = exports.ConnectionInfo = exports.AcrCredentials = exports.RsaKeyPair = exports.JwtKey = exports.MssqlPassword = exports.ChartVersion = exports.InstanceName = void 0;
+exports.OutputPath = 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");
@@ -22,4 +22,6 @@ 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; } });
+var output_path_value_object_1 = require("./output-path.value-object");
+Object.defineProperty(exports, "OutputPath", { enumerable: true, get: function () { return output_path_value_object_1.OutputPath; } });
 //# sourceMappingURL=index.js.map

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InstanceName = void 0;
+const errors_1 = require("../errors");
 /**
  * 實例名稱 Value Object
  *
@@ -27,9 +28,9 @@ class InstanceName {
             ? name.substring(prefix.length)
             : name;
         if (!this.isValid(normalizedName)) {
-            throw new Error(`Invalid instance name: "${name}". ` +
+            throw new errors_1.AppError(`Invalid instance name: "${name}". ` +
                 `Name must be ${this.MIN_LENGTH}-${this.MAX_LENGTH} characters, ` +
-                `start and end with alphanumeric characters, and may contain hyphens.`);
+                `start and end with alphanumeric characters, and may contain hyphens.`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
         }
         return new InstanceName(normalizedName);
     }
@@ -42,7 +43,9 @@ class InstanceName {
     static createFromFullName(fullName) {
         const prefix = 'uofx-';
         if (!fullName.startsWith(prefix)) {
-            throw new Error(`Invalid full instance name: "${fullName}". Expected format: uofx-{name}`);
+            throw new errors_1.AppError(`Invalid full instance name: "${fullName}". Expected format: uofx-{name}`, {
+                exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR,
+            });
         }
         const name = fullName.substring(prefix.length);
         return this.create(name);

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

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JwtKey = void 0;
 const crypto_1 = __importDefault(require("crypto"));
+const errors_1 = require("../errors");
 /**
  * JWT 簽署金鑰 Value Object
  *
@@ -25,7 +26,9 @@ class JwtKey {
      */
     static generate(length = 63) {
         if (length < this.MIN_LENGTH) {
-            throw new Error(`JWT key length must be at least ${this.MIN_LENGTH} characters`);
+            throw new errors_1.AppError(`JWT key length must be at least ${this.MIN_LENGTH} characters`, {
+                exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR,
+            });
         }
         try {
             let key = '';
@@ -35,12 +38,14 @@ class JwtKey {
             }
             // 驗證生成的金鑰
             if (!this.isValid(key)) {
-                throw new Error('Generated JWT key validation failed');
+                throw new errors_1.AppError('Generated JWT key validation failed', {
+                    exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR,
+                });
             }
             return new JwtKey(key);
         }
         catch (error) {
-            throw new Error(`Failed to generate JWT signing key: ${error instanceof Error ? error.message : String(error)}`);
+            throw new errors_1.AppError(`Failed to generate JWT signing key: ${error instanceof Error ? error.message : String(error)}`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
         }
     }
     /**
@@ -51,8 +56,8 @@ class JwtKey {
      */
     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.`);
+            throw new errors_1.AppError(`Invalid JWT signing key. Must be at least ${this.MIN_LENGTH} characters ` +
+                `and contain only alphanumeric characters.`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
         }
         return new JwtKey(key);
     }
@@ -82,6 +87,23 @@ class JwtKey {
     toBase64() {
         return Buffer.from(this.value, 'utf8').toString('base64');
     }
+    /**
+     * 防止 JSON.stringify 意外洩露金鑰，回傳遮罩值
+     * @returns 遮罩後的金鑰字串
+     */
+    toJSON() {
+        return '***MASKED***';
+    }
+    /**
+     * 回傳可安全記錄到日志的物件
+     * 金鑰欄位將被遮罩
+     * @returns 遮罩後的物件，可安全寫入日志
+     */
+    toSafeLog() {
+        return {
+            key: '***MASKED***',
+        };
+    }
     /**
      * 比較兩個金鑰是否相等
      * @param other - 另一個金鑰

package/dist/domain/value-objects/mssql-password.value-object.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MssqlPassword = void 0;
 const crypto_1 = __importDefault(require("crypto"));
+const errors_1 = require("../errors");
 /**
  * MSSQL 密碼 Value Object
  *
@@ -26,7 +27,9 @@ class MssqlPassword {
      */
     static generate(length = 16) {
         if (length < this.MIN_LENGTH) {
-            throw new Error(`Password length must be at least ${this.MIN_LENGTH} characters`);
+            throw new errors_1.AppError(`Password length must be at least ${this.MIN_LENGTH} characters`, {
+                exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR,
+            });
         }
         try {
             // 確保包含所有必要字元類型
@@ -44,12 +47,14 @@ class MssqlPassword {
             const shuffled = this.shuffleString(password);
             // 驗證生成的密碼
             if (!this.isValid(shuffled)) {
-                throw new Error('Generated password does not meet MSSQL complexity requirements');
+                throw new errors_1.AppError('Generated password does not meet MSSQL complexity requirements', {
+                    exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR,
+                });
             }
             return new MssqlPassword(shuffled);
         }
         catch (error) {
-            throw new Error(`Failed to generate MSSQL password: ${error instanceof Error ? error.message : String(error)}`);
+            throw new errors_1.AppError(`Failed to generate MSSQL password: ${error instanceof Error ? error.message : String(error)}`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
         }
     }
     /**
@@ -60,8 +65,8 @@ class MssqlPassword {
      */
     static create(password) {
         if (!this.isValid(password)) {
-            throw new Error(`Invalid MSSQL password. Must be at least ${this.MIN_LENGTH} characters ` +
-                `and contain at least 3 of: uppercase, lowercase, numbers, special characters.`);
+            throw new errors_1.AppError(`Invalid MSSQL password. Must be at least ${this.MIN_LENGTH} characters ` +
+                `and contain at least 3 of: uppercase, lowercase, numbers, special characters.`, { exitCode: errors_1.EXIT_CODES.VALIDATION_ERROR });
         }
         return new MssqlPassword(password);
     }
@@ -122,6 +127,23 @@ class MssqlPassword {
         const suffix = this.value.substring(this.value.length - 4);
         return `${prefix}******${suffix}`;
     }
+    /**
+     * 防止 JSON.stringify 意外洩露密碼，回傳遮罩值
+     * @returns 遮罩後的密碼字串
+     */
+    toJSON() {
+        return '***MASKED***';
+    }
+    /**
+     * 回傳可安全記錄到日志的物件
+     * 密碼欄位將被遮罩
+     * @returns 遮罩後的物件，可安全寫入日志
+     */
+    toSafeLog() {
+        return {
+            password: '***MASKED***',
+        };
+    }
     /**
      * 比較兩個密碼是否相等
      * @param other - 另一個密碼