@taicode/common-base 1.7.5 → 3.0.1

package/output/error/error.d.ts

@@ -80,6 +80,9 @@ export declare class UserError<T extends string = string> extends Error {
             cause?: unknown;
         };
         isError(error: unknown): error is Error;
+        captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+        prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
+        stackTraceLimit: number;
     };
 }
 /**
@@ -117,6 +120,9 @@ export declare class SystemError<T extends string = string> extends Error {
             cause?: unknown;
         };
         isError(error: unknown): error is Error;
+        captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+        prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
+        stackTraceLimit: number;
     };
 }
 //# sourceMappingURL=error.d.ts.map

package/output/error/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../source/error/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,eAAe;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAEpD,IAAI,EAAE,CAAC;IACP,OAAO,CAAC,EAAE,YAAY;IACtB,OAAO,EAAE,MAAM;gBAFf,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,YAAY,YAAA,EACtB,OAAO,GAAE,MAAW;IAM7B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC;IAI3E;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,UAAU,EAAE,KAAK;2DAY3D,KAAK,8BAAW,YACjB,MAAM;;+BARS,KAAK,8BAAW;;;;;;QAE1C,kBAAkB;wBACiC,8BAAW;kBAa7C,OAAO,GAAG,KAAK;;+BAhBN,KAAK,8BAAW;;;;;SAgBQ;;;CAKvD;AAED;;;GAGG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAEtD,IAAI,EAAE,CAAC;IACP,OAAO,CAAC,EAAE,YAAY;IACtB,OAAO,EAAE,MAAM;gBAFf,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,YAAY,YAAA,EACtB,OAAO,GAAE,MAAW;IAM7B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC;IAI7E;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,UAAU,EAAE,KAAK;2DAY3D,KAAK,8BAAW,YACjB,MAAM;;+BARS,KAAK,8BAAW;;;;;;QAE1C,kBAAkB;wBACiC,8BAAW;kBAa7C,OAAO,GAAG,KAAK;;+BAhBN,KAAK,8BAAW;;;;;SAgBU;;;CAKzD"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../source/error/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,eAAe;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAmBD;;;GAGG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAEpD,IAAI,EAAE,CAAC;IACP,OAAO,CAAC,EAAE,YAAY;IACtB,OAAO,EAAE,MAAM;gBAFf,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,YAAY,YAAA,EACtB,OAAO,GAAE,MAAW;IAO7B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC;IAI3E;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,UAAU,EAAE,KAAK;2DAa3D,KAAK,8BAAW,YACjB,MAAM;;+BARS,KAAK,8BAAW;;;;;;QAE1C,kBAAkB;wBACiC,8BAAW;kBAe7C,OAAO,GAAG,KAAK;;+BAlBN,KAAK,8BAAW;;;;;SAkBQ;;;;;;CAKvD;AAED;;;GAGG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAEtD,IAAI,EAAE,CAAC;IACP,OAAO,CAAC,EAAE,YAAY;IACtB,OAAO,EAAE,MAAM;gBAFf,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,YAAY,YAAA,EACtB,OAAO,GAAE,MAAW;IAO7B,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC;IAI7E;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,UAAU,EAAE,KAAK;2DAa3D,KAAK,8BAAW,YACjB,MAAM;;+BARS,KAAK,8BAAW;;;;;;QAE1C,kBAAkB;wBACiC,8BAAW;kBAe7C,OAAO,GAAG,KAAK;;+BAlBN,KAAK,8BAAW;;;;;SAkBU;;;;;;CAKzD"}

package/output/error/error.js

@@ -35,6 +35,20 @@
  * }
  * ```
  */
+/**
+ * 用于标识 UserError 实例的品牌标记
+ * 使用 Symbol.for 确保跨模块/编译后仍可正确识别
+ */
+const USER_ERROR_BRAND = Symbol.for('@taicode/common/UserError');
+/**
+ * 用于标识 SystemError 实例的品牌标记
+ * 使用 Symbol.for 确保跨模块/编译后仍可正确识别
+ */
+const SYSTEM_ERROR_BRAND = Symbol.for('@taicode/common/SystemError');
+/** 品牌标记检查辅助函数 */
+function hasBrand(value, brand) {
+    return typeof value === 'object' && value !== null && value[brand] === true;
+}
 /**
  * 用户可见的错误
  * 用于表示用户操作导致的错误，如验证失败、权限不足等
@@ -49,9 +63,10 @@ export class UserError extends Error {
         this.context = context;
         this.message = message;
         this.name = 'UserError';
+        Object.defineProperty(this, USER_ERROR_BRAND, { value: true });
     }
     static is(error) {
-        return error instanceof UserError;
+        return hasBrand(error, USER_ERROR_BRAND);
     }
     /**
      * 定义一个绑定了特定错误类型的 UserError 类
@@ -59,6 +74,7 @@ export class UserError extends Error {
      * @returns 返回绑定了特定类型的 UserError 类
      */
     static define(errorTypes) {
+        const BOUND_BRAND = Symbol();
         return class BoundUserError extends Error {
             type;
             context;
@@ -69,9 +85,11 @@ export class UserError extends Error {
                 this.name = 'UserError';
                 this.type = type;
                 this.context = context;
+                Object.defineProperty(this, USER_ERROR_BRAND, { value: true });
+                Object.defineProperty(this, BOUND_BRAND, { value: true });
             }
             static is(error) {
-                return error instanceof BoundUserError;
+                return hasBrand(error, BOUND_BRAND);
             }
         };
     }
@@ -90,9 +108,10 @@ export class SystemError extends Error {
         this.context = context;
         this.message = message;
         this.name = 'SystemError';
+        Object.defineProperty(this, SYSTEM_ERROR_BRAND, { value: true });
     }
     static is(error) {
-        return error instanceof SystemError;
+        return hasBrand(error, SYSTEM_ERROR_BRAND);
     }
     /**
      * 定义一个绑定了特定错误类型的 SystemError 类
@@ -100,6 +119,7 @@ export class SystemError extends Error {
      * @returns 返回绑定了特定类型的 SystemError 类
      */
     static define(errorTypes) {
+        const BOUND_BRAND = Symbol();
         return class BoundSystemError extends Error {
             type;
             context;
@@ -110,9 +130,11 @@ export class SystemError extends Error {
                 this.name = 'SystemError';
                 this.type = type;
                 this.context = context;
+                Object.defineProperty(this, SYSTEM_ERROR_BRAND, { value: true });
+                Object.defineProperty(this, BOUND_BRAND, { value: true });
             }
             static is(error) {
-                return error instanceof BoundSystemError;
+                return hasBrand(error, BOUND_BRAND);
             }
         };
     }

package/output/error/error.test.js

@@ -84,6 +84,17 @@ describe('UserError', () => {
                 expect(error.name).toBe('UserError');
             }
         });
+        it('在原型链丢失的情况下仍能通过品牌标记正确识别', () => {
+            const error = new UserError('TEST_ERROR', undefined, '测试错误');
+            // 模拟编译/序列化后原型链丢失的情况
+            const plainObj = Object.create(null);
+            Object.assign(plainObj, error);
+            // 手动复制品牌标记（Symbol.for 在不同模块实例中指向同一个 Symbol）
+            const brand = Symbol.for('@taicode/common/UserError');
+            Object.defineProperty(plainObj, brand, { value: true });
+            expect(plainObj instanceof UserError).toBe(false); // instanceof 失效
+            expect(UserError.is(plainObj)).toBe(true); // 品牌标记仍然有效
+        });
     });
     describe('继承行为', () => {
         it('应该正确继承Error的所有属性和方法', () => {
@@ -188,6 +199,16 @@ describe('SystemError', () => {
                 expect(error.name).toBe('SystemError');
             }
         });
+        it('在原型链丢失的情况下仍能通过品牌标记正确识别', () => {
+            const error = new SystemError('TEST_ERROR', undefined, '测试错误');
+            // 模拟编译/序列化后原型链丢失的情况
+            const plainObj = Object.create(null);
+            Object.assign(plainObj, error);
+            const brand = Symbol.for('@taicode/common/SystemError');
+            Object.defineProperty(plainObj, brand, { value: true });
+            expect(plainObj instanceof SystemError).toBe(false); // instanceof 失效
+            expect(SystemError.is(plainObj)).toBe(true); // 品牌标记仍然有效
+        });
     });
     describe('继承行为', () => {
         it('应该正确继承Error的所有属性和方法', () => {
@@ -224,6 +245,22 @@ describe('错误类型区分', () => {
         expect(userError instanceof Error).toBe(true);
         expect(systemError instanceof Error).toBe(true);
     });
+    it('define 创建的 BoundError 也能被基类 is 方法识别', () => {
+        const MyUserError = UserError.define({
+            'test': {}
+        });
+        const MySystemError = SystemError.define({
+            'test': {}
+        });
+        const userError = new MyUserError('test', { msg: 'hello' }, '测试');
+        const systemError = new MySystemError('test', { msg: 'world' }, '测试');
+        // 基类的 is 方法应该能识别 define 创建的子类实例
+        expect(UserError.is(userError)).toBe(true);
+        expect(SystemError.is(systemError)).toBe(true);
+        // 但不会互相匹配
+        expect(UserError.is(systemError)).toBe(false);
+        expect(SystemError.is(userError)).toBe(false);
+    });
 });
 describe('泛型类型支持', () => {
     it('UserError应该支持字符串字面量类型', () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taicode/common-base",
-  "version": "1.7.5",
+  "version": "3.0.1",
   "author": "Alain",
   "license": "ISC",
   "description": "",