@idlebox/errors 0.1.12 → 0.1.14

package/lib/autoindex.d.ts

@@ -13,6 +13,7 @@ export { ExitCode } from "./codes/wellknown-exit-codes.js";
 export { Exit } from "./common/application.js";
 export { InterruptError } from "./common/application.js";
 export { UsageError } from "./common/application.js";
+export type { IErrorOptions } from "./common/base.js";
 export { humanReadable } from "./common/base.js";
 export type { IHumanReadable } from "./common/base.js";
 export { isHumanReadableError } from "./common/base.js";

package/lib/autoindex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoindex.d.ts","sourceRoot":"","sources":["../src/autoindex.ts"],"names":[],"mappings":"AAAA;;;;;;;gFAOgF;AAS/E,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"autoindex.d.ts","sourceRoot":"","sources":["../src/autoindex.ts"],"names":[],"mappings":"AAAA;;;;;;;gFAOgF;AAS/E,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/lib/autoindex.js

@@ -26,8 +26,6 @@ export { ExitCode } from "./codes/wellknown-exit-codes.js";
 export { Exit } from "./common/application.js";
 export { InterruptError } from "./common/application.js";
 export { UsageError } from "./common/application.js";
-/* common/base.ts */
-// Identifiers
 export { humanReadable } from "./common/base.js";
 export { isHumanReadableError } from "./common/base.js";
 export { NotError } from "./common/base.js";

package/lib/autoindex.js.map

@@ -1 +1 @@
-{"version":3,"file":"autoindex.js","sourceRoot":"","sources":["../src/autoindex.ts"],"names":[],"mappings":"AAAA;;;;;;;gFAOgF;AAChF,8BAA8B;AAC9B,wCAAwC;AACxC,0CAA0C;AAC1C,oBAAoB;AACpB,aAAa;AAEb,gCAAgC;AAC/B,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC/D,+BAA+B;AAC9B,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAChE,mCAAmC;AAClC,cAAc;AACd,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC5D,2BAA2B;AAC1B,cAAc;AACd,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACtD,oBAAoB;AACnB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjD,2BAA2B;AAC1B,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAIpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClD,gCAAgC;AAC/B,cAAc;AACd,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"autoindex.js","sourceRoot":"","sources":["../src/autoindex.ts"],"names":[],"mappings":"AAAA;;;;;;;gFAOgF;AAChF,8BAA8B;AAC9B,wCAAwC;AACxC,0CAA0C;AAC1C,oBAAoB;AACpB,aAAa;AAEb,gCAAgC;AAC/B,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC/D,+BAA+B;AAC9B,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAChE,mCAAmC;AAClC,cAAc;AACd,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC5D,2BAA2B;AAC1B,cAAc;AACd,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjD,2BAA2B;AAC1B,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAIpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClD,gCAAgC;AAC/B,cAAc;AACd,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/lib/codes/wellknown-exit-codes.d.ts

@@ -11,6 +11,10 @@ export declare enum ExitCode {
      * 使用方式错误，例如传入了不正确的参数
      */
     USAGE = 3,
+    /**
+     * 未处理的超时
+     */
+    TIMEOUT = 4,
     /**
      * 由于程序代码不完善导致的错误
      */

package/lib/codes/wellknown-exit-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wellknown-exit-codes.d.ts","sourceRoot":"","sources":["../../src/codes/wellknown-exit-codes.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IACnB;;OAEG;IACH,SAAS,IAAI;IAEb;;OAEG;IACH,SAAS,IAAI;IAEb;;OAEG;IACH,KAAK,IAAI;IAET;;OAEG;IACH,OAAO,KAAK;CACZ"}
+{"version":3,"file":"wellknown-exit-codes.d.ts","sourceRoot":"","sources":["../../src/codes/wellknown-exit-codes.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IACnB;;OAEG;IACH,SAAS,IAAI;IAEb;;OAEG;IACH,SAAS,IAAI;IAEb;;OAEG;IACH,KAAK,IAAI;IAET;;OAEG;IACH,OAAO,IAAI;IAEX;;OAEG;IACH,OAAO,KAAK;CACZ"}

package/lib/codes/wellknown-exit-codes.js

@@ -12,6 +12,10 @@ export var ExitCode;
      * 使用方式错误，例如传入了不正确的参数
      */
     ExitCode[ExitCode["USAGE"] = 3] = "USAGE";
+    /**
+     * 未处理的超时
+     */
+    ExitCode[ExitCode["TIMEOUT"] = 4] = "TIMEOUT";
     /**
      * 由于程序代码不完善导致的错误
      */

package/lib/codes/wellknown-exit-codes.js.map

@@ -1 +1 @@
-{"version":3,"file":"wellknown-exit-codes.js","sourceRoot":"","sources":["../../src/codes/wellknown-exit-codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAoBX;AApBD,WAAY,QAAQ;IACnB;;OAEG;IACH,iDAAa,CAAA;IAEb;;OAEG;IACH,iDAAa,CAAA;IAEb;;OAEG;IACH,yCAAS,CAAA;IAET;;OAEG;IACH,8CAAY,CAAA;AACb,CAAC,EApBW,QAAQ,KAAR,QAAQ,QAoBnB"}
+{"version":3,"file":"wellknown-exit-codes.js","sourceRoot":"","sources":["../../src/codes/wellknown-exit-codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAyBX;AAzBD,WAAY,QAAQ;IACnB;;OAEG;IACH,iDAAa,CAAA;IAEb;;OAEG;IACH,iDAAa,CAAA;IAEb;;OAEG;IACH,yCAAS,CAAA;IAET;;OAEG;IACH,6CAAW,CAAA;IAEX;;OAEG;IACH,8CAAY,CAAA;AACb,CAAC,EAzBW,QAAQ,KAAR,QAAQ,QAyBnB"}

package/lib/common/application.d.ts

@@ -1,10 +1,10 @@
-import { ErrorWithCode, humanReadable } from './base.js';
+import { ErrorWithCode, humanReadable, type IErrorOptions } from './base.js';
 /**
  * 程序因为正常运行结束而退出
  * catch到此错误时应直接重新抛出，不应做其他处理
  */
 export declare class Exit extends ErrorWithCode {
-    constructor(code: number, boundary?: CallableFunction);
+    constructor(code: number, opts?: IErrorOptions);
 }
 /**
  * SIGINT (Ctrl+C)
@@ -12,14 +12,14 @@ export declare class Exit extends ErrorWithCode {
  */
 export declare class InterruptError extends ErrorWithCode {
     readonly signal: NodeJS.Signals;
-    constructor(signal: NodeJS.Signals, boundary?: CallableFunction);
+    constructor(signal: NodeJS.Signals, opts?: IErrorOptions);
     [humanReadable](): string;
 }
 /**
  * 由于错误的参数、配置导致错误
  */
 export declare class UsageError extends ErrorWithCode {
-    constructor(message: string, boundary?: CallableFunction);
+    constructor(message: string, opts?: IErrorOptions);
     [humanReadable](): string;
 }
 //# sourceMappingURL=application.d.ts.map

package/lib/common/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/common/application.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEzD;;;GAGG;AACH,qBAAa,IAAK,SAAQ,aAAa;gBAC1B,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB;CAGrD;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,aAAa;aAE/B,MAAM,EAAE,MAAM,CAAC,OAAO;gBAAtB,MAAM,EAAE,MAAM,CAAC,OAAO,EACtC,QAAQ,CAAC,EAAE,gBAAgB;IAKnB,CAAC,aAAa,CAAC;CAGxB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAChC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB;IAI/C,CAAC,aAAa,CAAC;CAGxB"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/common/application.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAE7E;;;GAGG;AACH,qBAAa,IAAK,SAAQ,aAAa;gBAC1B,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa;CAG9C;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,aAAa;aAE/B,MAAM,EAAE,MAAM,CAAC,OAAO;gBAAtB,MAAM,EAAE,MAAM,CAAC,OAAO,EACtC,IAAI,CAAC,EAAE,aAAa;IAKZ,CAAC,aAAa,CAAC;CAGxB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAChC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa;IAIxC,CAAC,aAAa,CAAC;CAGxB"}

package/lib/common/application.js

@@ -5,8 +5,8 @@ import { ErrorWithCode, humanReadable } from './base.js';
  * catch到此错误时应直接重新抛出，不应做其他处理
  */
 export class Exit extends ErrorWithCode {
-    constructor(code, boundary) {
-        super(`process exit with code ${code}`, code, boundary);
+    constructor(code, opts) {
+        super(`process exit with code ${code}`, code, opts);
     }
 }
 /**
@@ -15,8 +15,8 @@ export class Exit extends ErrorWithCode {
  */
 export class InterruptError extends ErrorWithCode {
     signal;
-    constructor(signal, boundary) {
-        super(`interrupt by signal ${signal}`, ExitCode.INTERRUPT, boundary);
+    constructor(signal, opts) {
+        super(`interrupt by signal ${signal}`, ExitCode.INTERRUPT, opts);
         this.signal = signal;
     }
     [humanReadable]() {
@@ -27,8 +27,8 @@ export class InterruptError extends ErrorWithCode {
  * 由于错误的参数、配置导致错误
  */
 export class UsageError extends ErrorWithCode {
-    constructor(message, boundary) {
-        super(message, ExitCode.USAGE, boundary);
+    constructor(message, opts) {
+        super(message, ExitCode.USAGE, opts);
     }
     [humanReadable]() {
         return `参数错误: ${this.message}\n  - 此为非程序性错误，使用 --help 查看帮助`;

package/lib/common/application.js.map

@@ -1 +1 @@
-{"version":3,"file":"application.js","sourceRoot":"","sources":["../../src/common/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEzD;;;GAGG;AACH,MAAM,OAAO,IAAK,SAAQ,aAAa;IACtC,YAAY,IAAY,EAAE,QAA2B;QACpD,KAAK,CAAC,0BAA0B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IAE/B;IADjB,YACiB,MAAsB,EACtC,QAA2B;QAE3B,KAAK,CAAC,uBAAuB,MAAM,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAHrD,WAAM,GAAN,MAAM,CAAgB;IAIvC,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,OAAO,SAAS,IAAI,CAAC,MAAM,OAAO,CAAC;IACpC,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,aAAa;IAC5C,YAAY,OAAe,EAAE,QAA2B;QACvD,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,OAAO,SAAS,IAAI,CAAC,OAAO,+BAA+B,CAAC;IAC7D,CAAC;CACD"}
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../../src/common/application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAsB,MAAM,WAAW,CAAC;AAE7E;;;GAGG;AACH,MAAM,OAAO,IAAK,SAAQ,aAAa;IACtC,YAAY,IAAY,EAAE,IAAoB;QAC7C,KAAK,CAAC,0BAA0B,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IAE/B;IADjB,YACiB,MAAsB,EACtC,IAAoB;QAEpB,KAAK,CAAC,uBAAuB,MAAM,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAHjD,WAAM,GAAN,MAAM,CAAgB;IAIvC,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,OAAO,SAAS,IAAI,CAAC,MAAM,OAAO,CAAC;IACpC,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,aAAa;IAC5C,YAAY,OAAe,EAAE,IAAoB;QAChD,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,OAAO,SAAS,IAAI,CAAC,OAAO,+BAA+B,CAAC;IAC7D,CAAC;CACD"}

package/lib/common/base.d.ts

@@ -1,29 +1,45 @@
+export interface IErrorOptions {
+    /**
+     * stack属性的边界函数
+     * @see {Error.captureStackTrace}
+     */
+    boundary?: CallableFunction;
+    /**
+     * cause属性的值
+     * @see {Error.cause}
+     */
+    cause?: unknown;
+}
 export declare const humanReadable: unique symbol;
 export interface IHumanReadable {
     [humanReadable](): string;
 }
 export declare function isHumanReadableError(error: unknown): error is IHumanReadable;
-export declare class NotError extends Error implements IHumanReadable {
+/**
+ * 利用try...catch统一接口，或是用于分支条件等，未发生错误的情况
+ */
+export declare class NotError implements IHumanReadable {
+    readonly extra_message: string;
     constructor(extra_message?: string);
-    get stack(): string;
+    get stack(): void;
+    get message(): void;
     [humanReadable](): string;
 }
 /**
- * 应用程序退出
- * 此错误通常不需要输出到日志
  * @abstract
  */
 export declare class ErrorWithCode extends Error implements IHumanReadable {
     readonly code: number;
-    constructor(message: string, code: number, boundary?: CallableFunction);
+    constructor(message: string, code: number, opts?: IErrorOptions);
+    get name(): string;
     [humanReadable](): string;
 }
 /**
  * Error when something.cancel() is called
  * @public
  */
-export declare class CanceledError extends Error implements IHumanReadable {
-    constructor();
+export declare class CanceledError extends ErrorWithCode implements IHumanReadable {
+    constructor(opts?: IErrorOptions);
     static is(e: unknown): e is CanceledError;
     [humanReadable](): string;
 }
@@ -31,11 +47,13 @@ export declare class CanceledError extends Error implements IHumanReadable {
  * Error when something timeout
  * @public
  */
-export declare class TimeoutError extends Error implements IHumanReadable {
+export declare class TimeoutError extends ErrorWithCode implements IHumanReadable {
     private readonly ms;
     private readonly why;
     private readonly what?;
-    constructor(ms: number, why?: string, what?: string | undefined);
+    constructor(ms: number, why?: string, opts?: IErrorOptions & {
+        what?: string;
+    });
     static is(error: unknown): error is TimeoutError;
     [humanReadable](): string;
 }

package/lib/common/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/common/base.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,eAA0B,CAAC;AACrD,MAAM,WAAW,cAAc;IAC9B,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAE5E;AAED,qBAAa,QAAS,SAAQ,KAAM,YAAW,cAAc;gBAChD,aAAa,GAAE,MAAW;IAGtC,IAAa,KAAK,WAEjB;IAED,CAAC,aAAa,CAAC;CAGf;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,KAAM,YAAW,cAAc;aAGhD,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EAC5B,QAAQ,CAAC,EAAE,gBAAgB;IAY5B,CAAC,aAAa,CAAC;CASf;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAM,YAAW,cAAc;;IAKjE,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa;IAIzC,CAAC,aAAa,CAAC;CAGf;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAM,YAAW,cAAc;IAE/D,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAFL,EAAE,EAAE,MAAM,EACV,GAAG,SAAgB,EACnB,IAAI,CAAC,EAAE,MAAM,YAAA;IAK/B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY;IAIhD,CAAC,aAAa,CAAC;CAGf"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/common/base.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,aAAa,eAA0B,CAAC;AACrD,MAAM,WAAW,cAAc;IAC9B,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAE5E;AAED;;GAEG;AACH,qBAAa,QAAS,YAAW,cAAc;aAClB,aAAa,EAAE,MAAM;gBAArB,aAAa,GAAE,MAAW;IAEtD,IAAI,KAAK,SAER;IACD,IAAI,OAAO,SAEV;IAED,CAAC,aAAa,CAAC;CAGf;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAM,YAAW,cAAc;aAGhD,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EAC5B,IAAI,CAAC,EAAE,aAAa;IAOrB,IAAoB,IAAI,WAEvB;IAED,CAAC,aAAa,CAAC;CASf;AAID;;;GAGG;AACH,qBAAa,aAAc,SAAQ,aAAc,YAAW,cAAc;gBAC7D,IAAI,CAAC,EAAE,aAAa;IAIhC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa;IAIhC,CAAC,aAAa,CAAC;CAGxB;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,aAAc,YAAW,cAAc;IAIvE,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAS;gBAGb,EAAE,EAAE,MAAM,EACV,GAAG,SAAgB,EACpC,IAAI,CAAC,EAAE,aAAa,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAMzC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY;IAIvC,CAAC,aAAa,CAAC;CAGxB"}

package/lib/common/base.js

@@ -1,35 +1,40 @@
+import { ExitCode } from '../codes/wellknown-exit-codes.js';
 function noop() { }
 const replaceStackTrace = Error.captureStackTrace ?? noop;
 export const humanReadable = Symbol('humanReadable');
 export function isHumanReadableError(error) {
     return error instanceof Object && humanReadable in error;
 }
-export class NotError extends Error {
+/**
+ * 利用try...catch统一接口，或是用于分支条件等，未发生错误的情况
+ */
+export class NotError {
+    extra_message;
     constructor(extra_message = '') {
-        super(`你不应该看到此消息: ${extra_message}`);
+        this.extra_message = extra_message;
     }
     get stack() {
-        return this.message;
+        throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
+    }
+    get message() {
+        throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
     }
     [humanReadable]() {
-        return '你不应该看到此消息。你无需尝试处理该错误，请联系开发者。';
+        return `你不应该看到此消息。你无需尝试处理该错误，请联系开发者。[hint: ${this.extra_message}]`;
     }
 }
 /**
- * 应用程序退出
- * 此错误通常不需要输出到日志
  * @abstract
  */
 export class ErrorWithCode extends Error {
     code;
-    constructor(message, code, boundary) {
-        const { stackTraceLimit } = Error;
-        Error.stackTraceLimit = 0;
-        super(message);
+    constructor(message, code, opts) {
+        super(message, opts);
         this.code = code;
-        Error.stackTraceLimit = stackTraceLimit;
-        this.name = this.constructor.name;
-        replaceStackTrace(this, boundary ?? this.constructor);
+        replaceStackTrace(this, opts?.boundary ?? this.constructor);
+    }
+    get name() {
+        return this.constructor.name;
     }
     [humanReadable]() {
         let msg;
@@ -42,13 +47,14 @@ export class ErrorWithCode extends Error {
         return `${msg}\n  - 但是你不应该看到此信息，开发者忘记处理此种情况`;
     }
 }
+Object.setPrototypeOf(ErrorWithCode.prototype, Error.prototype);
 /**
  * Error when something.cancel() is called
  * @public
  */
-export class CanceledError extends Error {
-    constructor() {
-        super('Canceled');
+export class CanceledError extends ErrorWithCode {
+    constructor(opts) {
+        super('Canceled', ExitCode.INTERRUPT, opts);
     }
     static is(e) {
         return e instanceof CanceledError;
@@ -61,15 +67,15 @@ export class CanceledError extends Error {
  * Error when something timeout
  * @public
  */
-export class TimeoutError extends Error {
+export class TimeoutError extends ErrorWithCode {
     ms;
     why;
     what;
-    constructor(ms, why = 'no response', what) {
-        super(`Timeout: ${why} in ${ms}ms${what ? ` (when ${what})` : ''}`);
+    constructor(ms, why = 'no response', opts) {
+        super(`Timeout: ${why} in ${ms}ms${opts?.what ? ` (when ${opts.what})` : ''}`, ExitCode.TIMEOUT, opts);
         this.ms = ms;
         this.why = why;
-        this.what = what;
+        this.what = opts?.what;
     }
     static is(error) {
         return error instanceof TimeoutError;

package/lib/common/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/common/base.ts"],"names":[],"mappings":"AAAA,SAAS,IAAI,KAAI,CAAC;AAElB,MAAM,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,IAAI,IAAI,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAKrD,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAClD,OAAO,KAAK,YAAY,MAAM,IAAI,aAAa,IAAI,KAAK,CAAC;AAC1D,CAAC;AAED,MAAM,OAAO,QAAS,SAAQ,KAAK;IAClC,YAAY,gBAAwB,EAAE;QACrC,KAAK,CAAC,cAAc,aAAa,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAa,KAAK;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,CAAC,aAAa,CAAC;QACd,OAAO,8BAA8B,CAAC;IACvC,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGtB;IAFjB,YACC,OAAe,EACC,IAAY,EAC5B,QAA2B;QAE3B,MAAM,EAAE,eAAe,EAAE,GAAG,KAAK,CAAC;QAClC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QAM5B,KAAK,CAAC,eAAe,GAAG,eAAe,CAAC;QAExC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAElC,iBAAiB,CAAC,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,CAAC,aAAa,CAAC;QACd,IAAI,GAAW,CAAC;QAChB,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACrB,GAAG,GAAG,QAAQ,CAAC;QAChB,CAAC;aAAM,CAAC;YACP,GAAG,GAAG,mBAAmB,IAAI,CAAC,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,OAAO,GAAG,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACvC;QACC,KAAK,CAAC,UAAU,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,CAAU;QACnB,OAAO,CAAC,YAAY,aAAa,CAAC;IACnC,CAAC;IAED,CAAC,aAAa,CAAC;QACd,OAAO,aAAa,CAAC;IACtB,CAAC;CACD;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAEpB;IACA;IACA;IAHlB,YACkB,EAAU,EACV,MAAM,aAAa,EACnB,IAAa;QAE9B,KAAK,CAAC,YAAY,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAJnD,OAAE,GAAF,EAAE,CAAQ;QACV,QAAG,GAAH,GAAG,CAAgB;QACnB,SAAI,GAAJ,IAAI,CAAS;IAG/B,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,KAAc;QACvB,OAAO,KAAK,YAAY,YAAY,CAAC;IACtC,CAAC;IAED,CAAC,aAAa,CAAC;QACd,OAAO,SAAS,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,aAAa,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/F,CAAC;CACD"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/common/base.ts"],"names":[],"mappings":"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"}

package/lib/common/development.d.ts

@@ -1,14 +1,12 @@
-import { ErrorWithCode } from './base.js';
+import { ErrorWithCode, type IErrorOptions } from './base.js';
 export declare abstract class ProgramError extends ErrorWithCode {
-    constructor(message: string, boundary?: CallableFunction);
+    constructor(message: string, opts?: IErrorOptions);
 }
 export declare class NotImplementedError extends ProgramError {
-    constructor(message: string, boundary?: CallableFunction);
 }
 export declare class SoftwareDefectError extends ProgramError {
-    constructor(message: string, boundary?: CallableFunction);
 }
 export declare class Assertion extends SoftwareDefectError {
-    static ok(value: unknown, message?: string, boundary?: CallableFunction): asserts value;
+    static ok(value: unknown, message?: string, opts?: IErrorOptions): asserts value;
 }
 //# sourceMappingURL=development.d.ts.map

package/lib/common/development.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"development.d.ts","sourceRoot":"","sources":["../../src/common/development.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,8BAAsB,YAAa,SAAQ,aAAa;gBAC3C,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB;CAGxD;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACxC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB;CAIxD;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACxC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB;CAIxD;AAED,qBAAa,SAAU,SAAQ,mBAAmB;IACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,MAA2B,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK;CAK3G"}
+{"version":3,"file":"development.d.ts","sourceRoot":"","sources":["../../src/common/development.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAE9D,8BAAsB,YAAa,SAAQ,aAAa;gBAC3C,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa;CAGjD;AAED,qBAAa,mBAAoB,SAAQ,YAAY;CAAG;AAExD,qBAAa,mBAAoB,SAAQ,YAAY;CAAG;AAExD,qBAAa,SAAU,SAAQ,mBAAmB;IACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,MAA2B,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK;CASpG"}

package/lib/common/development.js

@@ -1,26 +1,23 @@
 import { ExitCode } from '../codes/wellknown-exit-codes.js';
 import { ErrorWithCode } from './base.js';
 export class ProgramError extends ErrorWithCode {
-    constructor(message, boundary) {
-        super(message, ExitCode.PROGRAM, boundary);
+    constructor(message, opts) {
+        super(message, ExitCode.PROGRAM, opts);
     }
 }
 export class NotImplementedError extends ProgramError {
-    constructor(message, boundary) {
-        super(message, boundary);
-        this.name = 'NotImplemented';
-    }
 }
 export class SoftwareDefectError extends ProgramError {
-    constructor(message, boundary) {
-        super(message, boundary);
-        this.name = 'SoftwareDefect';
-    }
 }
 export class Assertion extends SoftwareDefectError {
-    static ok(value, message = 'Assertion failed', boundary) {
+    static ok(value, message = 'Assertion failed', opts) {
         if (!value) {
-            throw new SoftwareDefectError(`${message}: value should be truthy, got ${typeof value} (${value})`, boundary ?? Assertion.ok);
+            if (!opts?.boundary) {
+                if (!opts)
+                    opts = {};
+                opts.boundary = Assertion.ok;
+            }
+            throw new SoftwareDefectError(`${message}: value should be truthy, got ${typeof value} (${value})`, opts);
         }
     }
 }

package/lib/common/development.js.map

@@ -1 +1 @@
-{"version":3,"file":"development.js","sourceRoot":"","sources":["../../src/common/development.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,OAAgB,YAAa,SAAQ,aAAa;IACvD,YAAY,OAAe,EAAE,QAA2B;QACvD,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACpD,YAAY,OAAe,EAAE,QAA2B;QACvD,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;IACpD,YAAY,OAAe,EAAE,QAA2B;QACvD,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD;AAED,MAAM,OAAO,SAAU,SAAQ,mBAAmB;IACjD,MAAM,CAAC,EAAE,CAAC,KAAc,EAAE,UAAkB,kBAAkB,EAAE,QAA2B;QAC1F,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,MAAM,IAAI,mBAAmB,CAAC,GAAG,OAAO,iCAAiC,OAAO,KAAK,KAAK,KAAK,GAAG,EAAE,QAAQ,IAAI,SAAS,CAAC,EAAE,CAAC,CAAC;QAC/H,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"development.js","sourceRoot":"","sources":["../../src/common/development.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAsB,MAAM,WAAW,CAAC;AAE9D,MAAM,OAAgB,YAAa,SAAQ,aAAa;IACvD,YAAY,OAAe,EAAE,IAAoB;QAChD,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;CAAG;AAExD,MAAM,OAAO,mBAAoB,SAAQ,YAAY;CAAG;AAExD,MAAM,OAAO,SAAU,SAAQ,mBAAmB;IACjD,MAAM,CAAC,EAAE,CAAC,KAAc,EAAE,UAAkB,kBAAkB,EAAE,IAAoB;QACnF,IAAI,CAAC,KAAK,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI;oBAAE,IAAI,GAAG,EAAE,CAAC;gBACrB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC;YAC9B,CAAC;YACD,MAAM,IAAI,mBAAmB,CAAC,GAAG,OAAO,iCAAiC,OAAO,KAAK,KAAK,KAAK,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3G,CAAC;IACF,CAAC;CACD"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@idlebox/errors",
   "description": "A collection of my errors.",
   "type": "module",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "exports": {
     ".": {
       "source": "./src/autoindex.ts",
@@ -12,11 +12,11 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@idlebox/node-error-codes": "^0.1.12"
+    "@idlebox/node-error-codes": "^0.1.13"
   },
   "devDependencies": {
     "@build-script/baseline-rig": "latest",
-    "@mpis/run": "^0.0.17"
+    "@mpis/run": "^0.0.19"
   },
   "license": "MIT",
   "author": "GongT <admin@gongt.me>",

package/src/autoindex.ts

@@ -29,6 +29,7 @@
 	export { UsageError } from "./common/application.js";
 /* common/base.ts */
 	// Identifiers
+	export type { IErrorOptions } from "./common/base.js";
 	export { humanReadable } from "./common/base.js";
 	export type { IHumanReadable } from "./common/base.js";
 	export { isHumanReadableError } from "./common/base.js";

package/src/codes/wellknown-exit-codes.ts

@@ -14,6 +14,11 @@ export enum ExitCode {
 	 */
 	USAGE = 3,
 
+	/**
+	 * 未处理的超时
+	 */
+	TIMEOUT = 4,
+
 	/**
 	 * 由于程序代码不完善导致的错误
 	 */

package/src/common/application.ts

@@ -1,13 +1,13 @@
 import { ExitCode } from '../codes/wellknown-exit-codes.js';
-import { ErrorWithCode, humanReadable } from './base.js';
+import { ErrorWithCode, humanReadable, type IErrorOptions } from './base.js';
 
 /**
  * 程序因为正常运行结束而退出
  * catch到此错误时应直接重新抛出，不应做其他处理
  */
 export class Exit extends ErrorWithCode {
-	constructor(code: number, boundary?: CallableFunction) {
-		super(`process exit with code ${code}`, code, boundary);
+	constructor(code: number, opts?: IErrorOptions) {
+		super(`process exit with code ${code}`, code, opts);
 	}
 }
 
@@ -18,9 +18,9 @@ export class Exit extends ErrorWithCode {
 export class InterruptError extends ErrorWithCode {
 	constructor(
 		public readonly signal: NodeJS.Signals,
-		boundary?: CallableFunction,
+		opts?: IErrorOptions,
 	) {
-		super(`interrupt by signal ${signal}`, ExitCode.INTERRUPT, boundary);
+		super(`interrupt by signal ${signal}`, ExitCode.INTERRUPT, opts);
 	}
 
 	override [humanReadable]() {
@@ -32,8 +32,8 @@ export class InterruptError extends ErrorWithCode {
  * 由于错误的参数、配置导致错误
  */
 export class UsageError extends ErrorWithCode {
-	constructor(message: string, boundary?: CallableFunction) {
-		super(message, ExitCode.USAGE, boundary);
+	constructor(message: string, opts?: IErrorOptions) {
+		super(message, ExitCode.USAGE, opts);
 	}
 
 	override [humanReadable]() {

package/src/common/base.ts

@@ -1,7 +1,23 @@
+import { ExitCode } from '../codes/wellknown-exit-codes.js';
+
 function noop() {}
 
 const replaceStackTrace = Error.captureStackTrace ?? noop;
 
+export interface IErrorOptions {
+	/**
+	 * stack属性的边界函数
+	 * @see {Error.captureStackTrace}
+	 */
+	boundary?: CallableFunction;
+
+	/**
+	 * cause属性的值
+	 * @see {Error.cause}
+	 */
+	cause?: unknown;
+}
+
 export const humanReadable = Symbol('humanReadable');
 export interface IHumanReadable {
 	[humanReadable](): string;
@@ -11,38 +27,40 @@ export function isHumanReadableError(error: unknown): error is IHumanReadable {
 	return error instanceof Object && humanReadable in error;
 }
 
-export class NotError extends Error implements IHumanReadable {
-	constructor(extra_message: string = '') {
-		super(`你不应该看到此消息: ${extra_message}`);
+/**
+ * 利用try...catch统一接口，或是用于分支条件等，未发生错误的情况
+ */
+export class NotError implements IHumanReadable {
+	constructor(public readonly extra_message: string = '') {}
+
+	get stack() {
+		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
 	}
-	override get stack() {
-		return this.message;
+	get message() {
+		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
 	}
 
 	[humanReadable]() {
-		return '你不应该看到此消息。你无需尝试处理该错误，请联系开发者。';
+		return `你不应该看到此消息。你无需尝试处理该错误，请联系开发者。[hint: ${this.extra_message}]`;
 	}
 }
 
 /**
- * 应用程序退出
- * 此错误通常不需要输出到日志
  * @abstract
  */
 export class ErrorWithCode extends Error implements IHumanReadable {
 	constructor(
 		message: string,
 		public readonly code: number,
-		boundary?: CallableFunction,
+		opts?: IErrorOptions,
 	) {
-		const { stackTraceLimit } = Error;
-		Error.stackTraceLimit = 0;
-		super(message);
-		Error.stackTraceLimit = stackTraceLimit;
+		super(message, opts);
 
-		this.name = this.constructor.name;
+		replaceStackTrace(this, opts?.boundary ?? this.constructor);
+	}
 
-		replaceStackTrace(this, boundary ?? this.constructor);
+	public override get name() {
+		return this.constructor.name;
 	}
 
 	[humanReadable]() {
@@ -56,20 +74,22 @@ export class ErrorWithCode extends Error implements IHumanReadable {
 	}
 }
 
+Object.setPrototypeOf(ErrorWithCode.prototype, Error.prototype);
+
 /**
  * Error when something.cancel() is called
  * @public
  */
-export class CanceledError extends Error implements IHumanReadable {
-	constructor() {
-		super('Canceled');
+export class CanceledError extends ErrorWithCode implements IHumanReadable {
+	constructor(opts?: IErrorOptions) {
+		super('Canceled', ExitCode.INTERRUPT, opts);
 	}
 
 	static is(e: unknown): e is CanceledError {
 		return e instanceof CanceledError;
 	}
 
-	[humanReadable]() {
+	override [humanReadable]() {
 		return '操作已应用户要求而取消';
 	}
 }
@@ -78,20 +98,23 @@ export class CanceledError extends Error implements IHumanReadable {
  * Error when something timeout
  * @public
  */
-export class TimeoutError extends Error implements IHumanReadable {
+export class TimeoutError extends ErrorWithCode implements IHumanReadable {
+	private readonly what?: string;
+
 	constructor(
 		private readonly ms: number,
 		private readonly why = 'no response',
-		private readonly what?: string,
+		opts?: IErrorOptions & { what?: string },
 	) {
-		super(`Timeout: ${why} in ${ms}ms${what ? ` (when ${what})` : ''}`);
+		super(`Timeout: ${why} in ${ms}ms${opts?.what ? ` (when ${opts.what})` : ''}`, ExitCode.TIMEOUT, opts);
+		this.what = opts?.what;
 	}
 
 	static is(error: unknown): error is TimeoutError {
 		return error instanceof TimeoutError;
 	}
 
-	[humanReadable]() {
+	override [humanReadable]() {
 		return `操作超时: ${this.what ? this.what : '操作没有说明'}\n  - 时长: ${this.ms}ms\n  - 原因: ${this.why}`;
 	}
 }

package/src/common/development.ts

@@ -1,30 +1,24 @@
 import { ExitCode } from '../codes/wellknown-exit-codes.js';
-import { ErrorWithCode } from './base.js';
+import { ErrorWithCode, type IErrorOptions } from './base.js';
 
 export abstract class ProgramError extends ErrorWithCode {
-	constructor(message: string, boundary?: CallableFunction) {
-		super(message, ExitCode.PROGRAM, boundary);
+	constructor(message: string, opts?: IErrorOptions) {
+		super(message, ExitCode.PROGRAM, opts);
 	}
 }
 
-export class NotImplementedError extends ProgramError {
-	constructor(message: string, boundary?: CallableFunction) {
-		super(message, boundary);
-		this.name = 'NotImplemented';
-	}
-}
+export class NotImplementedError extends ProgramError {}
 
-export class SoftwareDefectError extends ProgramError {
-	constructor(message: string, boundary?: CallableFunction) {
-		super(message, boundary);
-		this.name = 'SoftwareDefect';
-	}
-}
+export class SoftwareDefectError extends ProgramError {}
 
 export class Assertion extends SoftwareDefectError {
-	static ok(value: unknown, message: string = 'Assertion failed', boundary?: CallableFunction): asserts value {
+	static ok(value: unknown, message: string = 'Assertion failed', opts?: IErrorOptions): asserts value {
 		if (!value) {
-			throw new SoftwareDefectError(`${message}: value should be truthy, got ${typeof value} (${value})`, boundary ?? Assertion.ok);
+			if (!opts?.boundary) {
+				if (!opts) opts = {};
+				opts.boundary = Assertion.ok;
+			}
+			throw new SoftwareDefectError(`${message}: value should be truthy, got ${typeof value} (${value})`, opts);
 		}
 	}
 }