@hz-9/a5-core 0.2.0-alpha.21 → 0.2.0-alpha.23

package/dist/all.d.ts

@@ -391,6 +391,27 @@ declare interface A5FormatMessageOptions {
  */
 export declare type A5GlobalProvideToken = `Global.A5.${string}`;
 
+/**
+ * A5 加载包错误
+ * 当动态加载可选依赖包失败时抛出此错误
+ * @public
+ */
+export declare class A5LoadPackageError extends Error {
+    /**
+     * 错误名称
+     */
+    readonly name: string;
+    /**
+     * 尝试加载的包名
+     */
+    readonly packageName: string;
+    /**
+     * 原始错误（如果有）
+     */
+    readonly cause?: Error;
+    constructor(packageName: string, message?: string, cause?: Error);
+}
+
 /**
  * @public
  *

package/dist/errors/a5-load-package.error.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A5 加载包错误
+ * 当动态加载可选依赖包失败时抛出此错误
+ * @public
+ */
+export declare class A5LoadPackageError extends Error {
+    /**
+     * 错误名称
+     */
+    readonly name: string;
+    /**
+     * 尝试加载的包名
+     */
+    readonly packageName: string;
+    /**
+     * 原始错误（如果有）
+     */
+    readonly cause?: Error;
+    constructor(packageName: string, message?: string, cause?: Error);
+}

package/dist/errors/a5-load-package.error.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A5LoadPackageError = void 0;
+/**
+ * A5 加载包错误
+ * 当动态加载可选依赖包失败时抛出此错误
+ * @public
+ */
+class A5LoadPackageError extends Error {
+    constructor(packageName, message, cause) {
+        super(message || `Failed to load package: ${packageName}`);
+        /**
+         * 错误名称
+         */
+        this.name = 'A5LoadPackageError';
+        this.packageName = packageName;
+        this.cause = cause;
+        // 设置原型链，确保 instanceof 正常工作
+        Object.setPrototypeOf(this, A5LoadPackageError.prototype);
+    }
+}
+exports.A5LoadPackageError = A5LoadPackageError;
+//# sourceMappingURL=a5-load-package.error.js.map

package/dist/errors/index.d.ts

@@ -0,0 +1 @@
+export * from './a5-load-package.error';

package/dist/errors/index.js

@@ -0,0 +1,18 @@
+"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 });
+__exportStar(require("./a5-load-package.error"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './const';
 export * from './core';
+export * from './errors';
 export * from './interface';
 export * from './module';
 export * from './middleware';

package/dist/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./const"), exports);
 __exportStar(require("./core"), exports);
+__exportStar(require("./errors"), exports);
 __exportStar(require("./interface"), exports);
 __exportStar(require("./module"), exports);
 __exportStar(require("./middleware"), exports);

package/dist/util/load-package.util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoadPackageUtil = void 0;
+const errors_1 = require("../errors");
 const a5_util_1 = require("./a5.util");
 // TODO 当前文件，并未编写单元测试
 /**
@@ -25,8 +26,10 @@ class LoadPackageUtil {
             return module;
         }
         catch (error) {
-            // TODO 优化报错显示
-            throw new Error(`Failed to load package "${packageName}": ${error instanceof Error ? error.message : String(error)}`);
+            // 抛出 A5LoadPackageError 错误
+            const cause = error instanceof Error ? error : undefined;
+            const message = error instanceof Error ? error.message : String(error);
+            throw new errors_1.A5LoadPackageError(packageName, `Failed to load package "${packageName}": ${message}`, cause);
         }
     }
     /**
@@ -64,7 +67,8 @@ class LoadPackageUtil {
                 }
             }
         }
-        throw lastError || new Error(`Failed to load package "${packageName}" after ${retries + 1} attempts`);
+        throw (lastError ||
+            new errors_1.A5LoadPackageError(packageName, `Failed to load package "${packageName}" after ${retries + 1} attempts`));
     }
 }
 exports.LoadPackageUtil = LoadPackageUtil;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hz-9/a5-core",
-  "version": "0.2.0-alpha.21",
+  "version": "0.2.0-alpha.23",
   "description": "The core library for the `@hz-9/a5-*` series of repositories.",
   "keywords": [
     "nest",