@idlebox/errors 0.1.17 → 0.1.19

package/lib/error-types/dependency.js

@@ -0,0 +1,39 @@
+import { ProgramError } from './development.js';
+export class DependencyError extends ProgramError {
+}
+export class ChildProcessExitError extends DependencyError {
+    pid;
+    commandline;
+    workingDirectory;
+    exitCode;
+    signal;
+    process;
+    constructor({ pid, commandline, workingDirectory, exitCode, signal, process, ...opts }) {
+        let message = '';
+        message += pid ? `子进程 ${pid} ` : '未知子进程';
+        message += '非预期退出, ';
+        if (exitCode) {
+            message += `返回 ${exitCode}`;
+        }
+        else if (signal) {
+            message += `信号 ${signal}`;
+        }
+        else {
+            message += '可能未正常启动';
+        }
+        if (commandline) {
+            message += `\n  命令行: ${commandline.join(' ')}`;
+        }
+        if (workingDirectory) {
+            message += `\n  工作目录: ${workingDirectory}`;
+        }
+        super(message, opts);
+        this.pid = pid;
+        this.commandline = commandline;
+        this.workingDirectory = workingDirectory;
+        this.exitCode = exitCode;
+        this.signal = signal;
+        this.process = process;
+    }
+}
+//# sourceMappingURL=dependency.js.map

package/lib/error-types/dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency.js","sourceRoot":"","sources":["../../src/error-types/dependency.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,OAAO,eAAgB,SAAQ,YAAY;CAAG;AAWpD,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IAClD,GAAG,CAAU;IACb,WAAW,CAAqB;IAChC,gBAAgB,CAAU;IAC1B,QAAQ,CAAU;IAClB,MAAM,CAAe;IACrB,OAAO,CAAgB;IAE9B,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAA6B;QAChH,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;QACzC,OAAO,IAAI,SAAS,CAAC;QACrB,IAAI,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,MAAM,QAAQ,EAAE,CAAC;QAC7B,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YACnB,OAAO,IAAI,MAAM,MAAM,EAAE,CAAC;QAC3B,CAAC;aAAM,CAAC;YACP,OAAO,IAAI,SAAS,CAAC;QACtB,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,YAAY,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,CAAC;QACD,IAAI,gBAAgB,EAAE,CAAC;YACtB,OAAO,IAAI,aAAa,gBAAgB,EAAE,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAErB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD"}

package/lib/error-types/development.d.ts

@@ -0,0 +1,27 @@
+import { ErrorWithCode } from '../common/base.js';
+import type { IErrorOptions } from '../common/type.js';
+/**
+ * 由于程序出现bug导致的各类异常
+ */
+export declare abstract class ProgramError extends ErrorWithCode {
+    constructor(message: string, opts?: IErrorOptions);
+}
+export declare class NotImplementedError extends ProgramError {
+    constructor(message?: string, opts?: IErrorOptions);
+}
+export declare class SoftwareDefectError extends ProgramError {
+}
+export declare class Assertion extends SoftwareDefectError {
+    static ok(value: unknown, message?: string, opts?: IErrorOptions): asserts value;
+}
+interface IVariableTypeErrorOptions extends IErrorOptions {
+    Expected?: Function;
+    variableName?: string;
+}
+export declare class VariableTypeError extends ProgramError {
+    readonly object: any;
+    readonly ExpectedClass?: Function;
+    constructor(object: any, { Expected, variableName, ...opts }?: IVariableTypeErrorOptions);
+}
+export {};
+//# sourceMappingURL=development.d.ts.map

package/lib/error-types/development.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.d.ts","sourceRoot":"","sources":["../../src/error-types/development.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,8BAAsB,YAAa,SAAQ,aAAa;gBAC3C,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa;CAGjD;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACxC,OAAO,GAAE,MAAiB,EAAE,IAAI,CAAC,EAAE,aAAa;CAG5D;AAED,qBAAa,mBAAoB,SAAQ,YAAY;CAAG;AAExD,qBAAa,SAAU,SAAQ,mBAAmB;IACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,MAAe,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK;CASxF;AAED,UAAU,yBAA0B,SAAQ,aAAa;IACxD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,iBAAkB,SAAQ,YAAY;aAIjC,MAAM,EAAE,GAAG;IAH5B,SAAgB,aAAa,CAAC,EAAE,QAAQ,CAAC;gBAGxB,MAAM,EAAE,GAAG,EAC3B,EAAE,QAAQ,EAAE,YAAmB,EAAE,GAAG,IAAI,EAAE,GAAE,yBAA8B;CAiB3E"}

package/lib/error-types/development.js

@@ -0,0 +1,50 @@
+import { ExitCode } from '../codes/wellknown-exit-codes.js';
+import { ErrorWithCode } from '../common/base.js';
+/**
+ * 由于程序出现bug导致的各类异常
+ */
+export class ProgramError extends ErrorWithCode {
+    constructor(message, opts) {
+        super(message, ExitCode.PROGRAM, opts);
+    }
+}
+export class NotImplementedError extends ProgramError {
+    constructor(message = '此功能未实现', opts) {
+        super(message, opts);
+    }
+}
+export class SoftwareDefectError extends ProgramError {
+}
+export class Assertion extends SoftwareDefectError {
+    static ok(value, message = '断言失败', opts) {
+        if (!value) {
+            if (!opts?.boundary) {
+                if (!opts)
+                    opts = {};
+                opts.boundary = Assertion.ok;
+            }
+            throw new SoftwareDefectError(`${message}: 应为真值, 实际为${typeof value}类型的 "${value}"`, opts);
+        }
+    }
+}
+export class VariableTypeError extends ProgramError {
+    object;
+    ExpectedClass;
+    constructor(object, { Expected, variableName = '变量', ...opts } = {}) {
+        let message = '';
+        if (Expected) {
+            message += `应是 ${Expected.name}`;
+        }
+        const Actual = object.constructor;
+        if (message) {
+            message += ', 实际是 ';
+        }
+        else {
+            message += '不能是 ';
+        }
+        message += Actual.name;
+        super(`${object}的类型${message}`, opts);
+        this.object = object;
+    }
+}
+//# sourceMappingURL=development.js.map

package/lib/error-types/development.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development.js","sourceRoot":"","sources":["../../src/error-types/development.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;GAEG;AACH,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;IACpD,YAAY,UAAkB,QAAQ,EAAE,IAAoB;QAC3D,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAY;CAAG;AAExD,MAAM,OAAO,SAAU,SAAQ,mBAAmB;IACjD,MAAM,CAAC,EAAE,CAAC,KAAc,EAAE,UAAkB,MAAM,EAAE,IAAoB;QACvE,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,cAAc,OAAO,KAAK,QAAQ,KAAK,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3F,CAAC;IACF,CAAC;CACD;AAOD,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IAIjC;IAHD,aAAa,CAAY;IAEzC,YACiB,MAAW,EAC3B,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,IAAI,KAAgC,EAAE;QAE1E,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,QAAQ,CAAC;QACrB,CAAC;aAAM,CAAC;YACP,OAAO,IAAI,MAAM,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC;QAEvB,KAAK,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;QAhBtB,WAAM,GAAN,MAAM,CAAK;IAiB5B,CAAC;CACD"}

package/lib/error-types/nodejs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodejs.d.ts","sourceRoot":"","sources":["../../src/error-types/nodejs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,IAAgC;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC;AAErF,MAAM,WAAW,gBAAiB,SAAQ,KAAK;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,aAAa,CAAC,aAAa,CAAC,gBAAgB,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAE7I;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,CAEtF;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,CAEnF;AAED,uCAAuC;AACvC,eAAO,MAAM,WAAW,wBAAkB,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAAC,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAE9G;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAE1D"}

package/lib/error-types/nodejs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodejs.js","sourceRoot":"","sources":["../../src/error-types/nodejs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAW/D;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAW;IAClD,OAAO,WAAW,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,aAAa,CAAC,gBAAgB,IAAI,EAAE,CAAC,IAAI,KAAK,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAC1H,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAU;IAC1C,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAU;IACvC,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,CAAC;AAC3D,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,CAAU;IACzC,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAU;IACrC,OAAO,CAAC,YAAY,KAAK,IAAI,OAAQ,CAAS,CAAC,IAAI,KAAK,QAAQ,CAAC;AAClE,CAAC"}

package/lib/{common/unhandled-errors.d.ts → error-types/nodejs.unhandled.d.ts}

@@ -1,7 +1,4 @@
-/**
- *
- */
-declare class ProxiedError extends Error {
+export declare abstract class ProxiedError extends Error {
     cause: any;
     constructor(prefix: string, original: unknown);
     get stack(): string;
@@ -14,5 +11,4 @@ export declare class UncaughtException extends ProxiedError {
     readonly error: Error;
     constructor(error: Error);
 }
-export {};
-//# sourceMappingURL=unhandled-errors.d.ts.map
+//# sourceMappingURL=nodejs.unhandled.d.ts.map

package/lib/error-types/nodejs.unhandled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodejs.unhandled.d.ts","sourceRoot":"","sources":["../../src/error-types/nodejs.unhandled.ts"],"names":[],"mappings":"AAAA,8BAAsB,YAAa,SAAQ,KAAK;IACvC,KAAK,EAAE,GAAG,CAAC;gBAEP,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;IAK7C,IAAa,KAAK,IAAI,MAAM,CAS3B;CACD;AAED,qBAAa,kBAAmB,SAAQ,YAAY;aAGlC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;gBADzC,MAAM,EAAE,OAAO,EACC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;CAI1C;AAED,qBAAa,iBAAkB,SAAQ,YAAY;aACtB,KAAK,EAAE,KAAK;gBAAZ,KAAK,EAAE,KAAK;CAGxC"}

package/lib/{common/unhandled-errors.js → error-types/nodejs.unhandled.js}

@@ -1,7 +1,4 @@
-/**
- *
- */
-class ProxiedError extends Error {
+export class ProxiedError extends Error {
     constructor(prefix, original) {
         super(`${prefix}: ${get_message(original)}`, { cause: original });
         delete this.stack;
@@ -47,4 +44,4 @@ function removeFirstLine(text) {
     }
     return text;
 }
-//# sourceMappingURL=unhandled-errors.js.map
+//# sourceMappingURL=nodejs.unhandled.js.map

package/lib/{common/unhandled-errors.js.map → error-types/nodejs.unhandled.js.map}

@@ -1 +1 @@
-{"version":3,"file":"unhandled-errors.js","sourceRoot":"","sources":["../../src/common/unhandled-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,YAAa,SAAQ,KAAK;IAG/B,YAAY,MAAc,EAAE,QAAiB;QAC5C,KAAK,CAAC,GAAG,MAAM,KAAK,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClE,OAAQ,IAAY,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,IAAa,KAAK;QACjB,MAAM,KAAK,GAAQ,IAAI,CAAC,KAAK,CAAC;QAC9B,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,CAAC;QACF,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,OAAO,wBAAwB,CAAC;IAChD,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAGlC;IAFjB,YACC,MAAe,EACC,OAAyB;QAEzC,KAAK,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QAF7B,YAAO,GAAP,OAAO,CAAkB;IAG1C,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACtB;IAA5B,YAA4B,KAAY;QACvC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QADR,UAAK,GAAL,KAAK,CAAO;IAExC,CAAC;CACD;AAED,SAAS,WAAW,CAAC,MAAW;IAC/B,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACjE,OAAO,MAAM,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}
+{"version":3,"file":"nodejs.unhandled.js","sourceRoot":"","sources":["../../src/error-types/nodejs.unhandled.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,YAAa,SAAQ,KAAK;IAG/C,YAAY,MAAc,EAAE,QAAiB;QAC5C,KAAK,CAAC,GAAG,MAAM,KAAK,WAAW,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClE,OAAQ,IAAY,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,IAAa,KAAK;QACjB,MAAM,KAAK,GAAQ,IAAI,CAAC,KAAK,CAAC;QAC9B,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,CAAC;QACF,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,OAAO,wBAAwB,CAAC;IAChD,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAGlC;IAFjB,YACC,MAAe,EACC,OAAyB;QAEzC,KAAK,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QAF7B,YAAO,GAAP,OAAO,CAAkB;IAG1C,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACtB;IAA5B,YAA4B,KAAY;QACvC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QADR,UAAK,GAAL,KAAK,CAAO;IAExC,CAAC;CACD;AAED,SAAS,WAAW,CAAC,MAAW;IAC/B,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACjE,OAAO,MAAM,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}

package/lib/error-types/tools.d.ts

@@ -0,0 +1,28 @@
+import { ErrorWithCode } from '../common/base.js';
+import { humanReadable, type IHumanReadable } from '../common/human-readable.js';
+import type { IErrorOptions } from '../common/type.js';
+/**
+ * 发生本程序主动发起的取消行为时
+ * @public
+ */
+export declare class CanceledError extends ErrorWithCode implements IHumanReadable {
+    constructor(opts?: IErrorOptions);
+    static is(e: unknown): e is CanceledError;
+    [humanReadable](): string;
+}
+/**
+ * 某种操作超时
+ *
+ * @public
+ */
+export declare class TimeoutError extends ErrorWithCode implements IHumanReadable {
+    private readonly ms;
+    private readonly why;
+    private readonly what?;
+    constructor(ms: number, why?: string, opts?: IErrorOptions & {
+        what?: string;
+    });
+    static is(error: unknown): error is TimeoutError;
+    [humanReadable](): string;
+}
+//# sourceMappingURL=tools.d.ts.map

package/lib/error-types/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/error-types/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;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;;;;GAIG;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/error-types/tools.js

@@ -0,0 +1,41 @@
+import { ExitCode } from '../codes/wellknown-exit-codes.js';
+import { ErrorWithCode } from '../common/base.js';
+import { humanReadable } from '../common/human-readable.js';
+/**
+ * 发生本程序主动发起的取消行为时
+ * @public
+ */
+export class CanceledError extends ErrorWithCode {
+    constructor(opts) {
+        super('Canceled', ExitCode.INTERRUPT, opts);
+    }
+    static is(e) {
+        return e instanceof CanceledError;
+    }
+    [humanReadable]() {
+        return '操作已应要求而取消';
+    }
+}
+/**
+ * 某种操作超时
+ *
+ * @public
+ */
+export class TimeoutError extends ErrorWithCode {
+    ms;
+    why;
+    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 = opts?.what;
+    }
+    static is(error) {
+        return error instanceof TimeoutError;
+    }
+    [humanReadable]() {
+        return `操作超时: ${this.what ? this.what : '操作没有说明'}\n  - 时长: ${this.ms}ms\n  - 原因: ${this.why}`;
+    }
+}
+//# sourceMappingURL=tools.js.map

package/lib/error-types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/error-types/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAuB,MAAM,6BAA6B,CAAC;AAGjF;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC/C,YAAY,IAAoB;QAC/B,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,CAAU;QACnB,OAAO,CAAC,YAAY,aAAa,CAAC;IACnC,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,OAAO,WAAW,CAAC;IACpB,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IAI5B;IACA;IAJD,IAAI,CAAU;IAE/B,YACkB,EAAU,EACV,MAAM,aAAa,EACpC,IAAwC;QAExC,KAAK,CAAC,YAAY,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAJtF,OAAE,GAAF,EAAE,CAAQ;QACV,QAAG,GAAH,GAAG,CAAgB;QAIpC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,KAAc;QACvB,OAAO,KAAK,YAAY,YAAY,CAAC;IACtC,CAAC;IAEQ,CAAC,aAAa,CAAC;QACvB,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"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@idlebox/errors",
   "description": "A collection of my errors.",
   "type": "module",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "exports": {
     ".": {
       "source": "./src/autoindex.ts",
@@ -16,7 +16,7 @@
   },
   "devDependencies": {
     "@build-script/baseline-rig": "latest",
-    "@mpis/run": "^0.0.21"
+    "@mpis/run": "^0.0.25"
   },
   "license": "MIT",
   "author": "GongT <admin@gongt.me>",

package/src/autoindex.ts

@@ -22,37 +22,54 @@
 /* codes/wellknown-exit-codes.ts */
 	// Identifiers (1)
 	export { ExitCode } from "./codes/wellknown-exit-codes.js";
-/* common/application.ts */
-	// Identifiers (3)
-	export { Exit } from "./common/application.js";
-	export { InterruptError } from "./common/application.js";
-	export { UsageError } from "./common/application.js";
 /* common/base.ts */
-	// Identifiers (8)
-	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";
-	export { NotError } from "./common/base.js";
+	// Identifiers (2)
 	export { ErrorWithCode } from "./common/base.js";
-	export { CanceledError } from "./common/base.js";
-	export { TimeoutError } from "./common/base.js";
-/* common/development.ts */
-	// Identifiers (4)
-	export { ProgramError } from "./common/development.js";
-	export { NotImplementedError } from "./common/development.js";
-	export { SoftwareDefectError } from "./common/development.js";
-	export { Assertion } from "./common/development.js";
-/* common/nodejs.ts */
+	export { TypeErrorWithCode } from "./common/base.js";
+/* common/human-readable.ts */
+	// Identifiers (3)
+	export { humanReadable } from "./common/human-readable.js";
+	export type { IHumanReadable } from "./common/human-readable.js";
+	export { isHumanReadable } from "./common/human-readable.js";
+/* common/not-error.ts */
+	// Identifiers (1)
+	export { NotError } from "./common/not-error.js";
+/* common/type.ts */
+	// Identifiers (1)
+	export type { IErrorOptions } from "./common/type.js";
+/* common/v8.ts */
+	// Identifiers (0)
+/* error-types/application.ts */
+	// Identifiers (3)
+	export { Exit } from "./error-types/application.js";
+	export { InterruptError } from "./error-types/application.js";
+	export { UsageError } from "./error-types/application.js";
+/* error-types/dependency.ts */
+	// Identifiers (2)
+	export { DependencyError } from "./error-types/dependency.js";
+	export { ChildProcessExitError } from "./error-types/dependency.js";
+/* error-types/development.ts */
+	// Identifiers (5)
+	export { ProgramError } from "./error-types/development.js";
+	export { NotImplementedError } from "./error-types/development.js";
+	export { SoftwareDefectError } from "./error-types/development.js";
+	export { Assertion } from "./error-types/development.js";
+	export { VariableTypeError } from "./error-types/development.js";
+/* error-types/nodejs.ts */
 	// Identifiers (7)
-	export type { OpenSSLException } from "./common/nodejs.js";
-	export { isModuleResolutionError } from "./common/nodejs.js";
-	export { isNotExistsError } from "./common/nodejs.js";
-	export { isExistsError } from "./common/nodejs.js";
-	export { isTypeError } from "./common/nodejs.js";
-	export { isFileTypeError } from "./common/nodejs.js";
-	export { isNodeError } from "./common/nodejs.js";
-/* common/unhandled-errors.ts */
+	export type { OpenSSLException } from "./error-types/nodejs.js";
+	export { isModuleResolutionError } from "./error-types/nodejs.js";
+	export { isNotExistsError } from "./error-types/nodejs.js";
+	export { isExistsError } from "./error-types/nodejs.js";
+	export { isTypeError } from "./error-types/nodejs.js";
+	export { isFileTypeError } from "./error-types/nodejs.js";
+	export { isNodeError } from "./error-types/nodejs.js";
+/* error-types/nodejs.unhandled.ts */
+	// Identifiers (3)
+	export { ProxiedError } from "./error-types/nodejs.unhandled.js";
+	export { UnhandledRejection } from "./error-types/nodejs.unhandled.js";
+	export { UncaughtException } from "./error-types/nodejs.unhandled.js";
+/* error-types/tools.ts */
 	// Identifiers (2)
-	export { UnhandledRejection } from "./common/unhandled-errors.js";
-	export { UncaughtException } from "./common/unhandled-errors.js";
+	export { CanceledError } from "./error-types/tools.js";
+	export { TimeoutError } from "./error-types/tools.js";

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

@@ -20,7 +20,28 @@ export enum ExitCode {
 	TIMEOUT = 4,
 
 	/**
-	 * 由于程序代码不完善导致的错误
+	 * 工作状态异常
+	 * 状态转移错误等
+	 */
+	INVALID_STATE = 5,
+
+	/**
+	 * 由于程序代码不完善导致的未知错误
 	 */
 	PROGRAM = 66,
+
+	/**
+	 * 由资源引起的错误，例如文件不存在、网络错误等
+	 */
+	RESOURCE = 100,
+
+	/**
+	 * 重复操作，例如重复调用dispose
+	 */
+	DUPLICATE = 101,
+
+	/**
+	 * 未曾设想的错误
+	 */
+	UNKNOWN = 233,
 }

package/src/common/base.ts

@@ -1,51 +1,10 @@
-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;
-}
-
-export function isHumanReadableError(error: unknown): error is IHumanReadable {
-	return error instanceof Object && humanReadable in error;
-}
-
-/**
- * 利用try...catch统一接口，或是用于分支条件等，未发生错误的情况
- */
-export class NotError implements IHumanReadable {
-	constructor(public readonly extra_message: string = '') {}
-
-	get stack() {
-		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
-	}
-	get message() {
-		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
-	}
-
-	[humanReadable]() {
-		return `你不应该看到此消息。你无需尝试处理该错误，请联系开发者。[hint: ${this.extra_message}]`;
-	}
-}
+import { humanReadable, type IHumanReadable } from './human-readable.js';
+import type { IErrorOptions } from './type.js';
+import { captureStackTrace } from './v8.js';
 
 /**
+ * 最基本的错误类型
+ * 其他所有错误的基类
  * @abstract
  */
 export class ErrorWithCode extends Error implements IHumanReadable {
@@ -56,7 +15,7 @@ export class ErrorWithCode extends Error implements IHumanReadable {
 	) {
 		super(message, opts);
 
-		replaceStackTrace(this, opts?.boundary ?? this.constructor);
+		captureStackTrace(this, opts?.boundary ?? this.constructor);
 	}
 
 	public override get name() {
@@ -66,55 +25,17 @@ export class ErrorWithCode extends Error implements IHumanReadable {
 	[humanReadable]() {
 		let msg: string;
 		if (this.code === 0) {
-			msg = '程序正常结束';
+			msg = '未发生异常';
 		} else {
-			msg = `程序以非0状态正常结束，状态码：${this.code}`;
+			msg = `异常状态 [${this.code}]`;
 		}
 		return `${msg}\n  - 但是你不应该看到此信息，开发者忘记处理此种情况`;
 	}
 }
 
-Object.setPrototypeOf(ErrorWithCode.prototype, Error.prototype);
+export class TypeErrorWithCode extends ErrorWithCode {}
 
 /**
- * Error when something.cancel() is called
- * @public
+ * 假装继承自 TypeError
  */
-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;
-	}
-
-	override [humanReadable]() {
-		return '操作已应用户要求而取消';
-	}
-}
-
-/**
- * Error when something timeout
- * @public
- */
-export class TimeoutError extends ErrorWithCode implements IHumanReadable {
-	private readonly what?: string;
-
-	constructor(
-		private readonly ms: number,
-		private readonly why = 'no response',
-		opts?: IErrorOptions & { what?: string },
-	) {
-		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;
-	}
-
-	override [humanReadable]() {
-		return `操作超时: ${this.what ? this.what : '操作没有说明'}\n  - 时长: ${this.ms}ms\n  - 原因: ${this.why}`;
-	}
-}
+Object.setPrototypeOf(TypeErrorWithCode.prototype, TypeError.prototype);

package/src/common/human-readable.ts

@@ -0,0 +1,8 @@
+export const humanReadable = Symbol('humanReadable');
+export interface IHumanReadable {
+	[humanReadable](): string;
+}
+
+export function isHumanReadable(error: unknown): error is IHumanReadable {
+	return error instanceof Object && humanReadable in error;
+}

package/src/common/not-error.ts

@@ -0,0 +1,19 @@
+import { humanReadable, type IHumanReadable } from './human-readable.js';
+
+/**
+ * 利用try...catch统一接口，或是用于分支条件等，未发生错误的情况
+ */
+export class NotError implements IHumanReadable {
+	constructor(public readonly extra_message: string = '') {}
+
+	get stack() {
+		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
+	}
+	get message() {
+		throw new Error(`NotError 未被正确捕获 [hint: ${this.extra_message}]`);
+	}
+
+	[humanReadable]() {
+		return `你不应该看到此消息。你无需尝试处理该错误，请联系开发者。[hint: ${this.extra_message}]`;
+	}
+}

package/src/common/type-shim.ts

@@ -0,0 +1,7 @@
+// biome-ignore-all lint/suspicious/noTsIgnore: 切换文件
+
+/** @ts-ignore */
+export type ChildProcess = import('node:child_process').ChildProcess;
+
+/** @ts-ignore */
+export type SignalsType = NodeJS.Signals;

package/src/common/type.ts

@@ -0,0 +1,13 @@
+export interface IErrorOptions {
+	/**
+	 * stack属性的边界函数
+	 * @see {Error.captureStackTrace}
+	 */
+	boundary?: CallableFunction;
+
+	/**
+	 * cause属性的值
+	 * @see {Error.cause}
+	 */
+	cause?: unknown;
+}

package/src/common/v8.ts

@@ -0,0 +1,4 @@
+function noop() {}
+
+/** @internal */
+export const captureStackTrace = Error.captureStackTrace ?? noop;

package/src/{common → error-types}/application.ts

@@ -1,5 +1,7 @@
 import { ExitCode } from '../codes/wellknown-exit-codes.js';
-import { ErrorWithCode, humanReadable, type IErrorOptions } from './base.js';
+import { ErrorWithCode } from '../common/base.js';
+import { humanReadable } from '../common/human-readable.js';
+import type { IErrorOptions } from '../common/type.js';
 
 /**
  * 程序因为正常运行结束而退出
@@ -30,6 +32,7 @@ export class InterruptError extends ErrorWithCode {
 
 /**
  * 由于错误的参数、配置导致错误
+ * 非程序问题
  */
 export class UsageError extends ErrorWithCode {
 	constructor(message: string, opts?: IErrorOptions) {