@dxos/errors 0.8.4-main.dedc0f3 → 0.8.4-main.e99c46d

package/dist/lib/browser/index.mjs

@@ -57,33 +57,38 @@ var _context = /* @__PURE__ */ new WeakMap();
 var BaseError = class _BaseError 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 code - Error code.
+  * @param message - Default error message.
   */
-  static extend(code) {
+  static extend(code, message) {
     var _class;
     return _class = class extends _BaseError {
       static is(error) {
         return typeof error === "object" && error !== null && "code" in error && error.code === code;
       }
-      static wrap(message, options) {
-        return (error) => new this(message, {
+      static wrap(options) {
+        return (error) => new this({
+          message,
           ...options,
           cause: error
         });
       }
-      constructor(message, options) {
-        super(code, message, options);
+      constructor(options) {
+        super(code, {
+          message: options?.message ?? message,
+          ...options
+        });
       }
     }, _define_property(_class, "code", code), _class;
   }
   get name() {
     return _class_private_field_get(this, _code);
   }
+  /** Fallback message. */
+  get message() {
+    return this.constructor.name;
+  }
   get code() {
     return _class_private_field_get(this, _code);
   }
@@ -94,8 +99,10 @@ var BaseError = class _BaseError extends Error {
   get context() {
     return _class_private_field_get(this, _context);
   }
-  constructor(code, message, options) {
-    super(message, options), _class_private_field_init(this, _code, {
+  constructor(code, options) {
+    super(options?.message, {
+      cause: options?.cause
+    }), _class_private_field_init(this, _code, {
       writable: true,
       value: void 0
     }), _class_private_field_init(this, _context, {
@@ -109,25 +116,25 @@ var BaseError = class _BaseError extends Error {
 };
 
 // src/errors.ts
-var TimeoutError = class extends BaseError.extend("TIMEOUT") {
+var ApiError = class extends BaseError.extend("API", "API error") {
 };
-var AbortedError = class extends BaseError.extend("ABORTED") {
+var SystemError = class extends BaseError.extend("SYSTEM", "System error") {
 };
-var UnimplementedError = class extends BaseError.extend("UNIMPLEMENTED") {
+var InternalError = class extends BaseError.extend("INTERNAL", "Internal error") {
 };
-var ApiError = class extends BaseError.extend("API_ERROR") {
+var TimeoutError = class extends BaseError.extend("TIMEOUT", "Timeout") {
 };
-var SystemError = class extends BaseError.extend("SYSTEM_ERROR") {
+var AbortedError = class extends BaseError.extend("ABORTED", "Aborted") {
 };
-var InternalError = class extends BaseError.extend("INTERNAL_ERROR") {
+var NotImplementedError = class extends BaseError.extend("NOT_IMPLEMENTED", "Not implemented") {
 };
 export {
   AbortedError,
   ApiError,
   BaseError,
   InternalError,
+  NotImplementedError,
   SystemError,
-  TimeoutError,
-  UnimplementedError
+  TimeoutError
 };
 //# sourceMappingURL=index.mjs.map

package/dist/lib/browser/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/base.ts", "../../../src/errors.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nexport type BaseErrorOptions = {\n  /**\n   * The cause of the error.\n   * An instance of Error.\n   */\n  cause?: unknown;\n\n  /**\n   * Structured details about the error.\n   */\n  context?: Record<string, unknown>;\n};\n\n/**\n * Base class for all DXOS errors.\n */\nexport class BaseError<Code extends string = string> extends Error {\n  /**\n   * Primary way of defining new error classes.\n   *\n   * Expample:\n   *\n   * ```ts\n   * export class AiInputPreprocessingError extends BaseError.extend('AI_INPUT_PREPROCESSING_ERROR') {}\n   * ```\n   */\n  static extend<Code extends string>(code: Code) {\n    return class extends BaseError<Code> {\n      static code = code;\n\n      static is(error: unknown): error is BaseError {\n        return typeof error === 'object' && error !== null && 'code' in error && error.code === code;\n      }\n\n      static wrap(message: string, options?: Omit<BaseErrorOptions, 'cause'>) {\n        return (error: unknown) => new this(message, { ...options, cause: error });\n      }\n\n      constructor(message: string, options?: BaseErrorOptions) {\n        super(code, message, options);\n      }\n    };\n  }\n\n  #code: Code;\n  #context: Record<string, unknown>;\n\n  constructor(code: Code, message: string, options?: BaseErrorOptions) {\n    super(message, options);\n\n    this.#code = code;\n    this.#context = options?.context ?? {};\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  override get name() {\n    return this.#code;\n  }\n\n  get code(): Code {\n    return this.#code;\n  }\n\n  // For effect error matching.\n  get _tag(): Code {\n    return this.#code;\n  }\n\n  get context() {\n    return this.#context;\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { BaseError } from './base';\n\nexport class TimeoutError extends BaseError.extend('TIMEOUT') {}\n\nexport class AbortedError extends BaseError.extend('ABORTED') {}\n\nexport class UnimplementedError extends BaseError.extend('UNIMPLEMENTED') {}\n\nexport class ApiError extends BaseError.extend('API_ERROR') {}\n\nexport class SystemError extends BaseError.extend('SYSTEM_ERROR') {}\n\nexport class InternalError extends BaseError.extend('INTERNAL_ERROR') {}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgDE,QAAA,oBAAA,QAAA;IACA,WAAA,oBAAA,QAAA;AA7BK,IAAMA,YAAN,MAAMA,mBAAgDC,MAAAA;;;;;;;;;;EAU3D,OAAOC,OAA4BC,MAAY;;AAC7C,WAAA,SAAO,cAAcH,WAAAA;MAGnB,OAAOI,GAAGC,OAAoC;AAC5C,eAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA,SAASA,MAAMF,SAASA;MAC1F;MAEA,OAAOG,KAAKC,SAAiBC,SAA2C;AACtE,eAAO,CAACH,UAAmB,IAAI,KAAKE,SAAS;UAAE,GAAGC;UAASC,OAAOJ;QAAM,CAAA;MAC1E;MAEA,YAAYE,SAAiBC,SAA4B;AACvD,cAAML,MAAMI,SAASC,OAAAA;MACvB;IACF,GAbE,iBAAA,QAAOL,QAAOA,IAAAA,GAAAA;EAclB;EAaA,IAAaO,OAAO;AAClB,WAAA,yBAAO,MAAK,KAAA;EACd;EAEA,IAAIP,OAAa;AACf,WAAA,yBAAO,MAAK,KAAA;EACd;;EAGA,IAAIQ,OAAa;AACf,WAAA,yBAAO,MAAK,KAAA;EACd;EAEA,IAAIC,UAAU;AACZ,WAAA,yBAAO,MAAK,QAAA;EACd;EAvBA,YAAYT,MAAYI,SAAiBC,SAA4B;AACnE,UAAMD,SAASC,OAAAA,GAJjB,0BAAA,MAAA,OAAA;;aAAA;QACA,0BAAA,MAAA,UAAA;;aAAA;;mCAKO,OAAQL,IAAAA;mCACR,UAAWK,SAASI,WAAW,CAAC,CAAA;AACrCC,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;AAkBF;;;ACrEO,IAAMC,eAAN,cAA2BC,UAAUC,OAAO,SAAA,EAAA;AAAY;AAExD,IAAMC,eAAN,cAA2BF,UAAUC,OAAO,SAAA,EAAA;AAAY;AAExD,IAAME,qBAAN,cAAiCH,UAAUC,OAAO,eAAA,EAAA;AAAkB;AAEpE,IAAMG,WAAN,cAAuBJ,UAAUC,OAAO,WAAA,EAAA;AAAc;AAEtD,IAAMI,cAAN,cAA0BL,UAAUC,OAAO,cAAA,EAAA;AAAiB;AAE5D,IAAMK,gBAAN,cAA4BN,UAAUC,OAAO,gBAAA,EAAA;AAAmB;",
-  "names": ["BaseError", "Error", "extend", "code", "is", "error", "wrap", "message", "options", "cause", "name", "_tag", "context", "Object", "setPrototypeOf", "prototype", "TimeoutError", "BaseError", "extend", "AbortedError", "UnimplementedError", "ApiError", "SystemError", "InternalError"]
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Options for creating a BaseError.\n */\nexport type BaseErrorOptions = ErrorOptions & {\n  /**\n   * Override base message.\n   */\n  message?: string;\n\n  /**\n   * Structured details about the error.\n   */\n  context?: Record<string, unknown>;\n};\n\n/**\n * Base class for all DXOS errors.\n */\nexport class BaseError<Code extends string = string> extends Error {\n  /**\n   * Primary way of defining new error classes.\n   * Extended class may specialize constructor for required context params.\n   * @param code - Error code.\n   * @param message - Default error message.\n   */\n  static extend<Code extends string = string>(code: Code, message?: string) {\n    return class extends BaseError<Code> {\n      static code = code;\n\n      static is(error: unknown): error is BaseError {\n        return typeof error === 'object' && error !== null && 'code' in error && error.code === code;\n      }\n\n      static wrap(options?: Omit<BaseErrorOptions, 'cause'>) {\n        return (error: unknown) => new this({ message, ...options, cause: error });\n      }\n\n      constructor(options?: BaseErrorOptions) {\n        super(code, { message: options?.message ?? message, ...options });\n      }\n    };\n  }\n\n  #code: Code;\n  #context: Record<string, unknown>;\n\n  constructor(code: Code, options?: BaseErrorOptions) {\n    super(options?.message, { cause: options?.cause });\n\n    this.#code = code;\n    this.#context = options?.context ?? {};\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  override get name() {\n    return this.#code;\n  }\n\n  /** Fallback message. */\n  override get message() {\n    return this.constructor.name;\n  }\n\n  get code(): Code {\n    return this.#code;\n  }\n\n  // For effect error matching.\n  get _tag(): Code {\n    return this.#code;\n  }\n\n  get context() {\n    return this.#context;\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { BaseError } from './base';\n\nexport class ApiError extends BaseError.extend('API', 'API error') {}\n\nexport class SystemError extends BaseError.extend('SYSTEM', 'System error') {}\n\nexport class InternalError extends BaseError.extend('INTERNAL', 'Internal error') {}\n\nexport class TimeoutError extends BaseError.extend('TIMEOUT', 'Timeout') {}\n\nexport class AbortedError extends BaseError.extend('ABORTED', 'Aborted') {}\n\nexport class NotImplementedError extends BaseError.extend('NOT_IMPLEMENTED', 'Not implemented') {}\n"],
+  "mappings": ";AAMC,SAAA,6BAAA,KAAA,mBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyCC,QAAA,oBAAA,QAAA;IACA,WAAA,oBAAA,QAAA;AA1BK,IAAMA,YAAN,MAAMA,mBAAgDC,MAAAA;;;;;;;EAO3D,OAAOC,OAAqCC,MAAYC,SAAkB;;AACxE,WAAA,SAAO,cAAcJ,WAAAA;MAGnB,OAAOK,GAAGC,OAAoC;AAC5C,eAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA,SAASA,MAAMH,SAASA;MAC1F;MAEA,OAAOI,KAAKC,SAA2C;AACrD,eAAO,CAACF,UAAmB,IAAI,KAAK;UAAEF;UAAS,GAAGI;UAASC,OAAOH;QAAM,CAAA;MAC1E;MAEA,YAAYE,SAA4B;AACtC,cAAML,MAAM;UAAEC,SAASI,SAASJ,WAAWA;UAAS,GAAGI;QAAQ,CAAA;MACjE;IACF,GAbE,iBAAA,QAAOL,QAAOA,IAAAA,GAAAA;EAclB;EAaA,IAAaO,OAAO;AAClB,WAAA,yBAAO,MAAK,KAAA;EACd;;EAGA,IAAaN,UAAU;AACrB,WAAO,KAAK,YAAYM;EAC1B;EAEA,IAAIP,OAAa;AACf,WAAA,yBAAO,MAAK,KAAA;EACd;;EAGA,IAAIQ,OAAa;AACf,WAAA,yBAAO,MAAK,KAAA;EACd;EAEA,IAAIC,UAAU;AACZ,WAAA,yBAAO,MAAK,QAAA;EACd;EA5BA,YAAYT,MAAYK,SAA4B;AAClD,UAAMA,SAASJ,SAAS;MAAEK,OAAOD,SAASC;IAAM,CAAA,GAJlD,0BAAA,MAAA,OAAA;;aAAA;QACA,0BAAA,MAAA,UAAA;;aAAA;;mCAKO,OAAQN,IAAAA;mCACR,UAAWK,SAASI,WAAW,CAAC,CAAA;AACrCC,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;AAuBF;;;ACzEO,IAAMC,WAAN,cAAuBC,UAAUC,OAAO,OAAO,WAAA,EAAA;AAAc;AAE7D,IAAMC,cAAN,cAA0BF,UAAUC,OAAO,UAAU,cAAA,EAAA;AAAiB;AAEtE,IAAME,gBAAN,cAA4BH,UAAUC,OAAO,YAAY,gBAAA,EAAA;AAAmB;AAE5E,IAAMG,eAAN,cAA2BJ,UAAUC,OAAO,WAAW,SAAA,EAAA;AAAY;AAEnE,IAAMI,eAAN,cAA2BL,UAAUC,OAAO,WAAW,SAAA,EAAA;AAAY;AAEnE,IAAMK,sBAAN,cAAkCN,UAAUC,OAAO,mBAAmB,iBAAA,EAAA;AAAoB;",
+  "names": ["BaseError", "Error", "extend", "code", "message", "is", "error", "wrap", "options", "cause", "name", "_tag", "context", "Object", "setPrototypeOf", "prototype", "ApiError", "BaseError", "extend", "SystemError", "InternalError", "TimeoutError", "AbortedError", "NotImplementedError"]
 }

package/dist/lib/browser/meta.json

@@ -1 +1 @@
-{"inputs":{"src/base.ts":{"bytes":7660,"imports":[],"format":"esm"},"src/errors.ts":{"bytes":2000,"imports":[{"path":"src/base.ts","kind":"import-statement","original":"./base"}],"format":"esm"},"src/index.ts":{"bytes":523,"imports":[{"path":"src/base.ts","kind":"import-statement","original":"./base"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":3885},"dist/lib/browser/index.mjs":{"imports":[],"exports":["AbortedError","ApiError","BaseError","InternalError","SystemError","TimeoutError","UnimplementedError"],"entryPoint":"src/index.ts","inputs":{"src/base.ts":{"bytesInOutput":3300},"src/index.ts":{"bytesInOutput":0},"src/errors.ts":{"bytesInOutput":418}},"bytes":3908}}}
+{"inputs":{"src/base.ts":{"bytes":8342,"imports":[],"format":"esm"},"src/errors.ts":{"bytes":2213,"imports":[{"path":"src/base.ts","kind":"import-statement","original":"./base"}],"format":"esm"},"src/index.ts":{"bytes":523,"imports":[{"path":"src/base.ts","kind":"import-statement","original":"./base"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":4277},"dist/lib/browser/index.mjs":{"imports":[],"exports":["AbortedError","ApiError","BaseError","InternalError","NotImplementedError","SystemError","TimeoutError"],"entryPoint":"src/index.ts","inputs":{"src/base.ts":{"bytesInOutput":3482},"src/index.ts":{"bytesInOutput":0},"src/errors.ts":{"bytesInOutput":491}},"bytes":4164}}}

package/dist/lib/node-esm/index.mjs

@@ -59,33 +59,38 @@ var _context = /* @__PURE__ */ new WeakMap();
 var BaseError = class _BaseError 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 code - Error code.
+  * @param message - Default error message.
   */
-  static extend(code) {
+  static extend(code, message) {
     var _class;
     return _class = class extends _BaseError {
       static is(error) {
         return typeof error === "object" && error !== null && "code" in error && error.code === code;
       }
-      static wrap(message, options) {
-        return (error) => new this(message, {
+      static wrap(options) {
+        return (error) => new this({
+          message,
           ...options,
           cause: error
         });
       }
-      constructor(message, options) {
-        super(code, message, options);
+      constructor(options) {
+        super(code, {
+          message: options?.message ?? message,
+          ...options
+        });
       }
     }, _define_property(_class, "code", code), _class;
   }
   get name() {
     return _class_private_field_get(this, _code);
   }
+  /** Fallback message. */
+  get message() {
+    return this.constructor.name;
+  }
   get code() {
     return _class_private_field_get(this, _code);
   }
@@ -96,8 +101,10 @@ var BaseError = class _BaseError extends Error {
   get context() {
     return _class_private_field_get(this, _context);
   }
-  constructor(code, message, options) {
-    super(message, options), _class_private_field_init(this, _code, {
+  constructor(code, options) {
+    super(options?.message, {
+      cause: options?.cause
+    }), _class_private_field_init(this, _code, {
       writable: true,
       value: void 0
     }), _class_private_field_init(this, _context, {
@@ -111,25 +118,25 @@ var BaseError = class _BaseError extends Error {
 };
 
 // src/errors.ts
-var TimeoutError = class extends BaseError.extend("TIMEOUT") {
+var ApiError = class extends BaseError.extend("API", "API error") {
 };
-var AbortedError = class extends BaseError.extend("ABORTED") {
+var SystemError = class extends BaseError.extend("SYSTEM", "System error") {
 };
-var UnimplementedError = class extends BaseError.extend("UNIMPLEMENTED") {
+var InternalError = class extends BaseError.extend("INTERNAL", "Internal error") {
 };
-var ApiError = class extends BaseError.extend("API_ERROR") {
+var TimeoutError = class extends BaseError.extend("TIMEOUT", "Timeout") {
 };
-var SystemError = class extends BaseError.extend("SYSTEM_ERROR") {
+var AbortedError = class extends BaseError.extend("ABORTED", "Aborted") {
 };
-var InternalError = class extends BaseError.extend("INTERNAL_ERROR") {
+var NotImplementedError = class extends BaseError.extend("NOT_IMPLEMENTED", "Not implemented") {
 };
 export {
   AbortedError,
   ApiError,
   BaseError,
   InternalError,
+  NotImplementedError,
   SystemError,
-  TimeoutError,
-  UnimplementedError
+  TimeoutError
 };
 //# sourceMappingURL=index.mjs.map

package/dist/lib/node-esm/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/base.ts", "../../../src/errors.ts"],
-  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nexport type BaseErrorOptions = {\n  /**\n   * The cause of the error.\n   * An instance of Error.\n   */\n  cause?: unknown;\n\n  /**\n   * Structured details about the error.\n   */\n  context?: Record<string, unknown>;\n};\n\n/**\n * Base class for all DXOS errors.\n */\nexport class BaseError<Code extends string = string> extends Error {\n  /**\n   * Primary way of defining new error classes.\n   *\n   * Expample:\n   *\n   * ```ts\n   * export class AiInputPreprocessingError extends BaseError.extend('AI_INPUT_PREPROCESSING_ERROR') {}\n   * ```\n   */\n  static extend<Code extends string>(code: Code) {\n    return class extends BaseError<Code> {\n      static code = code;\n\n      static is(error: unknown): error is BaseError {\n        return typeof error === 'object' && error !== null && 'code' in error && error.code === code;\n      }\n\n      static wrap(message: string, options?: Omit<BaseErrorOptions, 'cause'>) {\n        return (error: unknown) => new this(message, { ...options, cause: error });\n      }\n\n      constructor(message: string, options?: BaseErrorOptions) {\n        super(code, message, options);\n      }\n    };\n  }\n\n  #code: Code;\n  #context: Record<string, unknown>;\n\n  constructor(code: Code, message: string, options?: BaseErrorOptions) {\n    super(message, options);\n\n    this.#code = code;\n    this.#context = options?.context ?? {};\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  override get name() {\n    return this.#code;\n  }\n\n  get code(): Code {\n    return this.#code;\n  }\n\n  // For effect error matching.\n  get _tag(): Code {\n    return this.#code;\n  }\n\n  get context() {\n    return this.#context;\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { BaseError } from './base';\n\nexport class TimeoutError extends BaseError.extend('TIMEOUT') {}\n\nexport class AbortedError extends BaseError.extend('ABORTED') {}\n\nexport class UnimplementedError extends BaseError.extend('UNIMPLEMENTED') {}\n\nexport class ApiError extends BaseError.extend('API_ERROR') {}\n\nexport class SystemError extends BaseError.extend('SYSTEM_ERROR') {}\n\nexport class InternalError extends BaseError.extend('INTERNAL_ERROR') {}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgDE,QAAA,oBAAA,QAAA;IACA,WAAA,oBAAA,QAAA;AA7BK,IAAMA,YAAN,MAAMA,mBAAgDC,MAAAA;;;;;;;;;;EAU3D,OAAOC,OAA4BC,MAAY;;AAC7C,WAAA,SAAO,cAAcH,WAAAA;MAGnB,OAAOI,GAAGC,OAAoC;AAC5C,eAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA,SAASA,MAAMF,SAASA;MAC1F;MAEA,OAAOG,KAAKC,SAAiBC,SAA2C;AACtE,eAAO,CAACH,UAAmB,IAAI,KAAKE,SAAS;UAAE,GAAGC;UAASC,OAAOJ;QAAM,CAAA;MAC1E;MAEA,YAAYE,SAAiBC,SAA4B;AACvD,cAAML,MAAMI,SAASC,OAAAA;MACvB;IACF,GAbE,iBAAA,QAAOL,QAAOA,IAAAA,GAAAA;EAclB;EAaA,IAAaO,OAAO;AAClB,WAAA,yBAAO,MAAK,KAAA;EACd;EAEA,IAAIP,OAAa;AACf,WAAA,yBAAO,MAAK,KAAA;EACd;;EAGA,IAAIQ,OAAa;AACf,WAAA,yBAAO,MAAK,KAAA;EACd;EAEA,IAAIC,UAAU;AACZ,WAAA,yBAAO,MAAK,QAAA;EACd;EAvBA,YAAYT,MAAYI,SAAiBC,SAA4B;AACnE,UAAMD,SAASC,OAAAA,GAJjB,0BAAA,MAAA,OAAA;;aAAA;QACA,0BAAA,MAAA,UAAA;;aAAA;;mCAKO,OAAQL,IAAAA;mCACR,UAAWK,SAASI,WAAW,CAAC,CAAA;AACrCC,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;AAkBF;;;ACrEO,IAAMC,eAAN,cAA2BC,UAAUC,OAAO,SAAA,EAAA;AAAY;AAExD,IAAMC,eAAN,cAA2BF,UAAUC,OAAO,SAAA,EAAA;AAAY;AAExD,IAAME,qBAAN,cAAiCH,UAAUC,OAAO,eAAA,EAAA;AAAkB;AAEpE,IAAMG,WAAN,cAAuBJ,UAAUC,OAAO,WAAA,EAAA;AAAc;AAEtD,IAAMI,cAAN,cAA0BL,UAAUC,OAAO,cAAA,EAAA;AAAiB;AAE5D,IAAMK,gBAAN,cAA4BN,UAAUC,OAAO,gBAAA,EAAA;AAAmB;",
-  "names": ["BaseError", "Error", "extend", "code", "is", "error", "wrap", "message", "options", "cause", "name", "_tag", "context", "Object", "setPrototypeOf", "prototype", "TimeoutError", "BaseError", "extend", "AbortedError", "UnimplementedError", "ApiError", "SystemError", "InternalError"]
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\n/**\n * Options for creating a BaseError.\n */\nexport type BaseErrorOptions = ErrorOptions & {\n  /**\n   * Override base message.\n   */\n  message?: string;\n\n  /**\n   * Structured details about the error.\n   */\n  context?: Record<string, unknown>;\n};\n\n/**\n * Base class for all DXOS errors.\n */\nexport class BaseError<Code extends string = string> extends Error {\n  /**\n   * Primary way of defining new error classes.\n   * Extended class may specialize constructor for required context params.\n   * @param code - Error code.\n   * @param message - Default error message.\n   */\n  static extend<Code extends string = string>(code: Code, message?: string) {\n    return class extends BaseError<Code> {\n      static code = code;\n\n      static is(error: unknown): error is BaseError {\n        return typeof error === 'object' && error !== null && 'code' in error && error.code === code;\n      }\n\n      static wrap(options?: Omit<BaseErrorOptions, 'cause'>) {\n        return (error: unknown) => new this({ message, ...options, cause: error });\n      }\n\n      constructor(options?: BaseErrorOptions) {\n        super(code, { message: options?.message ?? message, ...options });\n      }\n    };\n  }\n\n  #code: Code;\n  #context: Record<string, unknown>;\n\n  constructor(code: Code, options?: BaseErrorOptions) {\n    super(options?.message, { cause: options?.cause });\n\n    this.#code = code;\n    this.#context = options?.context ?? {};\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n\n  override get name() {\n    return this.#code;\n  }\n\n  /** Fallback message. */\n  override get message() {\n    return this.constructor.name;\n  }\n\n  get code(): Code {\n    return this.#code;\n  }\n\n  // For effect error matching.\n  get _tag(): Code {\n    return this.#code;\n  }\n\n  get context() {\n    return this.#context;\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { BaseError } from './base';\n\nexport class ApiError extends BaseError.extend('API', 'API error') {}\n\nexport class SystemError extends BaseError.extend('SYSTEM', 'System error') {}\n\nexport class InternalError extends BaseError.extend('INTERNAL', 'Internal error') {}\n\nexport class TimeoutError extends BaseError.extend('TIMEOUT', 'Timeout') {}\n\nexport class AbortedError extends BaseError.extend('ABORTED', 'Aborted') {}\n\nexport class NotImplementedError extends BaseError.extend('NOT_IMPLEMENTED', 'Not implemented') {}\n"],
+  "mappings": ";;;AAMC,SAAA,6BAAA,KAAA,mBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyCC,QAAA,oBAAA,QAAA;IACA,WAAA,oBAAA,QAAA;AA1BK,IAAMA,YAAN,MAAMA,mBAAgDC,MAAAA;;;;;;;EAO3D,OAAOC,OAAqCC,MAAYC,SAAkB;;AACxE,WAAA,SAAO,cAAcJ,WAAAA;MAGnB,OAAOK,GAAGC,OAAoC;AAC5C,eAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA,SAASA,MAAMH,SAASA;MAC1F;MAEA,OAAOI,KAAKC,SAA2C;AACrD,eAAO,CAACF,UAAmB,IAAI,KAAK;UAAEF;UAAS,GAAGI;UAASC,OAAOH;QAAM,CAAA;MAC1E;MAEA,YAAYE,SAA4B;AACtC,cAAML,MAAM;UAAEC,SAASI,SAASJ,WAAWA;UAAS,GAAGI;QAAQ,CAAA;MACjE;IACF,GAbE,iBAAA,QAAOL,QAAOA,IAAAA,GAAAA;EAclB;EAaA,IAAaO,OAAO;AAClB,WAAA,yBAAO,MAAK,KAAA;EACd;;EAGA,IAAaN,UAAU;AACrB,WAAO,KAAK,YAAYM;EAC1B;EAEA,IAAIP,OAAa;AACf,WAAA,yBAAO,MAAK,KAAA;EACd;;EAGA,IAAIQ,OAAa;AACf,WAAA,yBAAO,MAAK,KAAA;EACd;EAEA,IAAIC,UAAU;AACZ,WAAA,yBAAO,MAAK,QAAA;EACd;EA5BA,YAAYT,MAAYK,SAA4B;AAClD,UAAMA,SAASJ,SAAS;MAAEK,OAAOD,SAASC;IAAM,CAAA,GAJlD,0BAAA,MAAA,OAAA;;aAAA;QACA,0BAAA,MAAA,UAAA;;aAAA;;mCAKO,OAAQN,IAAAA;mCACR,UAAWK,SAASI,WAAW,CAAC,CAAA;AACrCC,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;AAuBF;;;ACzEO,IAAMC,WAAN,cAAuBC,UAAUC,OAAO,OAAO,WAAA,EAAA;AAAc;AAE7D,IAAMC,cAAN,cAA0BF,UAAUC,OAAO,UAAU,cAAA,EAAA;AAAiB;AAEtE,IAAME,gBAAN,cAA4BH,UAAUC,OAAO,YAAY,gBAAA,EAAA;AAAmB;AAE5E,IAAMG,eAAN,cAA2BJ,UAAUC,OAAO,WAAW,SAAA,EAAA;AAAY;AAEnE,IAAMI,eAAN,cAA2BL,UAAUC,OAAO,WAAW,SAAA,EAAA;AAAY;AAEnE,IAAMK,sBAAN,cAAkCN,UAAUC,OAAO,mBAAmB,iBAAA,EAAA;AAAoB;",
+  "names": ["BaseError", "Error", "extend", "code", "message", "is", "error", "wrap", "options", "cause", "name", "_tag", "context", "Object", "setPrototypeOf", "prototype", "ApiError", "BaseError", "extend", "SystemError", "InternalError", "TimeoutError", "AbortedError", "NotImplementedError"]
 }

package/dist/lib/node-esm/meta.json

@@ -1 +1 @@
-{"inputs":{"src/base.ts":{"bytes":7660,"imports":[],"format":"esm"},"src/errors.ts":{"bytes":2000,"imports":[{"path":"src/base.ts","kind":"import-statement","original":"./base"}],"format":"esm"},"src/index.ts":{"bytes":523,"imports":[{"path":"src/base.ts","kind":"import-statement","original":"./base"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"}},"outputs":{"dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":3887},"dist/lib/node-esm/index.mjs":{"imports":[],"exports":["AbortedError","ApiError","BaseError","InternalError","SystemError","TimeoutError","UnimplementedError"],"entryPoint":"src/index.ts","inputs":{"src/base.ts":{"bytesInOutput":3300},"src/index.ts":{"bytesInOutput":0},"src/errors.ts":{"bytesInOutput":418}},"bytes":4001}}}
+{"inputs":{"src/base.ts":{"bytes":8342,"imports":[],"format":"esm"},"src/errors.ts":{"bytes":2213,"imports":[{"path":"src/base.ts","kind":"import-statement","original":"./base"}],"format":"esm"},"src/index.ts":{"bytes":523,"imports":[{"path":"src/base.ts","kind":"import-statement","original":"./base"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"}},"outputs":{"dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":4279},"dist/lib/node-esm/index.mjs":{"imports":[],"exports":["AbortedError","ApiError","BaseError","InternalError","NotImplementedError","SystemError","TimeoutError"],"entryPoint":"src/index.ts","inputs":{"src/base.ts":{"bytesInOutput":3482},"src/index.ts":{"bytesInOutput":0},"src/errors.ts":{"bytesInOutput":491}},"bytes":4257}}}

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.
      */
@@ -16,46 +18,47 @@ export declare class BaseError<Code extends string = string> extends Error {
     #private;
     /**
      * 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 code - Error code.
+     * @param message - Default error message.
      */
-    static extend<Code extends string>(code: Code): {
-        new (message: string, options?: BaseErrorOptions): {
+    static extend<Code extends string = string>(code: Code, message?: string): {
+        new (options?: BaseErrorOptions): {
             #code: Code;
             #context: Record<string, unknown>;
             get name(): Code;
+            /** Fallback message. */
+            get message(): string;
             get code(): Code;
             get _tag(): Code;
             get context(): Record<string, unknown>;
-            message: string;
             stack?: string;
             cause?: unknown;
         };
         code: Code;
         is(error: unknown): error is BaseError;
-        wrap(message: string, options?: Omit<BaseErrorOptions, "cause">): (error: unknown) => {
+        wrap(options?: Omit<BaseErrorOptions, "cause">): (error: unknown) => {
             #code: Code;
             #context: Record<string, unknown>;
             get name(): Code;
+            /** Fallback message. */
+            get message(): string;
             get code(): Code;
             get _tag(): Code;
             get context(): Record<string, unknown>;
-            message: string;
             stack?: string;
             cause?: unknown;
         };
-        extend<Code extends string>(code: Code): /*elided*/ any;
+        extend<Code extends string = string>(code: Code, message?: string): /*elided*/ any;
         isError(error: unknown): error is Error;
         captureStackTrace(targetObject: object, constructorOpt?: Function): void;
         prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
         stackTraceLimit: number;
     };
-    constructor(code: Code, message: string, options?: BaseErrorOptions);
+    constructor(code: Code, options?: BaseErrorOptions);
     get name(): Code;
+    /** Fallback message. */
+    get message(): string;
     get code(): Code;
     get _tag(): Code;
     get context(): Record<string, unknown>;

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;uBAY9C,gBAAgB;;sBAOhC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;YAcjC,wBAAwB;;;;;;;;;kBA7BH,OAAO,GAAG,KAAK,IAAI,SAAS;uBAIvB,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,IAC3C,OAAO,OAAO;;sBAUlB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;YAcjC,wBAAwB;;;;;;;;eAjCV,IAAI,SAAS,MAAM,iBAAiB,IAAI,YAAY,MAAM;;;;;;gBAqB5D,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAQlD,IAAa,IAAI,SAEhB;IAED,wBAAwB;IACxB,IAAa,OAAO,WAEnB;IAED,IAAI,IAAI,IAAI,IAAI,CAEf;IAGD,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,IAAI,OAAO,4BAEV;CACF"}