@dxos/errors 0.8.4-main.5ea62a8 → 0.8.4-main.60689f5b1c

package/dist/types/src/base.d.ts

@@ -1,9 +1,11 @@
-export type BaseErrorOptions = {
+/**
+ * Options for creating a BaseError.
+ */
+export type BaseErrorOptions = ErrorOptions & {
     /**
-     * The cause of the error.
-     * An instance of Error.
+     * Override base message.
      */
-    cause?: unknown;
+    message?: string;
     /**
      * Structured details about the error.
      */
@@ -12,52 +14,47 @@ export type BaseErrorOptions = {
 /**
  * Base class for all DXOS errors.
  */
-export declare class BaseError<Code extends string = string> extends Error {
-    #private;
+export declare class BaseError<Name extends string = string> extends Error {
     /**
      * Primary way of defining new error classes.
-     *
-     * Expample:
-     *
-     * ```ts
-     * export class AiInputPreprocessingError extends BaseError.extend('AI_INPUT_PREPROCESSING_ERROR') {}
-     * ```
+     * Extended class may specialize constructor for required context params.
+     * @param name - Error name.
+     * @param message - Default error message.
      */
-    static extend<Code extends string>(code: Code): {
-        new (message: string, options?: BaseErrorOptions): {
-            #code: Code;
-            #context: Record<string, unknown>;
-            get name(): Code;
-            get code(): Code;
-            get _tag(): Code;
-            get context(): Record<string, unknown>;
-            message: string;
-            stack?: string;
+    static extend<Name extends string = string>(name: Name, message?: string): {
+        new (options?: BaseErrorOptions): {
             cause?: unknown;
+            stack?: string;
+            name: Name;
+            context: Record<string, unknown>;
+            /** Fallback message. */
+            get message(): string;
+            get _tag(): Name;
         };
-        code: Code;
+        isError(error: unknown): error is Error;
+        name: Name;
         is(error: unknown): error is BaseError;
-        wrap(message: string, options?: Omit<BaseErrorOptions, "cause">): (error: unknown) => {
-            #code: Code;
-            #context: Record<string, unknown>;
-            get name(): Code;
-            get code(): Code;
-            get _tag(): Code;
-            get context(): Record<string, unknown>;
-            message: string;
-            stack?: string;
+        wrap(options?: Omit<BaseErrorOptions, 'cause'> & {
+            ifTypeDiffers?: boolean;
+        }): (error: unknown) => {
             cause?: unknown;
+            stack?: string;
+            name: Name;
+            context: Record<string, unknown>;
+            /** Fallback message. */
+            get message(): string;
+            get _tag(): Name;
         };
-        extend<Code extends string>(code: Code): /*elided*/ any;
-        isError(error: unknown): error is Error;
+        extend<Name extends string = string>(name: Name, message?: string): /*elided*/ any;
         captureStackTrace(targetObject: object, constructorOpt?: Function): void;
         prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
         stackTraceLimit: number;
     };
-    constructor(code: Code, message: string, options?: BaseErrorOptions);
-    get name(): Code;
-    get code(): Code;
-    get _tag(): Code;
-    get context(): Record<string, unknown>;
+    name: Name;
+    context: Record<string, unknown>;
+    constructor(name: Name, options?: BaseErrorOptions);
+    /** Fallback message. */
+    get message(): string;
+    get _tag(): Name;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/types/src/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/base.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;;IAChE;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI;sBAYpB,MAAM,YAAY,gBAAgB;;sBAOjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;kBAfZ,OAAO,GAAG,KAAK,IAAI,SAAS;sBAIxB,MAAM,YAAY,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,IAC5D,OAAO,OAAO;;sBAUlB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;eAnBnB,IAAI,SAAS,MAAM,QAAQ,IAAI;;;;;;gBAqBjC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAQnE,IAAa,IAAI,SAEhB;IAED,IAAI,IAAI,IAAI,IAAI,CAEf;IAGD,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,IAAI,OAAO,4BAEV;CACF"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/base.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG;IAC5C;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,KAAK;IAChE;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM;uBAsB9C,gBAAgB;;;;qBAQjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;YAgBhC,wBAAwB;;;;;cA5CE,IAAI;kBAET,OAAO,GAAG,KAAK,IAAI,SAAS;uBAKjC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GAAG;YAAE,aAAa,CAAC,EAAE,OAAO,CAAA;SAAE,GACtE,CAAC,KAAK,EAAE,OAAO;;;;qBAoBb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;YAgBhC,wBAAwB;;;SApCgB;eAV1B,IAAI,SAAS,MAAM,iBAAiB,IAAI,YAAY,MAAM;;;;MA0BvE;IAGQ,IAAI,EAAE,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,YAAY,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB,EAYjD;IAED,wBAAwB;IACxB,IAAa,OAAO,WAEnB;IAGD,IAAI,IAAI,IAAI,IAAI,CAEf;CACF"}