@dxos/errors 0.8.4-main.84f28bd → 0.8.4-main.b97322e

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/errors",
-  "version": "0.8.4-main.84f28bd",
+  "version": "0.8.4-main.b97322e",
   "description": "Error definitions",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",

package/src/base.ts

@@ -15,25 +15,41 @@ export type BaseErrorOptions = {
   context?: Record<string, unknown>;
 };
 
-export class BaseError extends Error {
-  static extend(code: string) {
-    return class extends BaseError {
+/**
+ * Base class for all DXOS errors.
+ */
+export class BaseError<Code extends string = string> extends Error {
+  /**
+   * Primary way of defining new error classes.
+   *
+   * Expample:
+   *
+   * ```ts
+   * export class AiInputPreprocessingError extends BaseError.extend('AI_INPUT_PREPROCESSING_ERROR') {}
+   * ```
+   */
+  static extend<Code extends string>(code: Code) {
+    return class extends BaseError<Code> {
       static code = code;
 
       static is(error: unknown): error is BaseError {
         return typeof error === 'object' && error !== null && 'code' in error && error.code === code;
       }
 
+      static wrap(message: string, options?: Omit<BaseErrorOptions, 'cause'>) {
+        return (error: unknown) => new this(message, { ...options, cause: error });
+      }
+
       constructor(message: string, options?: BaseErrorOptions) {
         super(code, message, options);
       }
     };
   }
 
-  #code: string;
+  #code: Code;
   #context: Record<string, unknown>;
 
-  constructor(code: string, message: string, options?: BaseErrorOptions) {
+  constructor(code: Code, message: string, options?: BaseErrorOptions) {
     super(message, options);
 
     this.#code = code;
@@ -45,7 +61,12 @@ export class BaseError extends Error {
     return this.#code;
   }
 
-  get code() {
+  get code(): Code {
+    return this.#code;
+  }
+
+  // For effect error matching.
+  get _tag(): Code {
     return this.#code;
   }