@dxos/errors 0.8.4-main.e098934 → 0.8.4-main.e8ec1fe

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,59 +1,4 @@
1
1
  // src/base.ts
2
- function _check_private_redeclaration(obj, privateCollection) {
3
- if (privateCollection.has(obj)) {
4
- throw new TypeError("Cannot initialize the same private elements twice on an object");
5
- }
6
- }
7
- function _class_apply_descriptor_get(receiver, descriptor) {
8
- if (descriptor.get) {
9
- return descriptor.get.call(receiver);
10
- }
11
- return descriptor.value;
12
- }
13
- function _class_apply_descriptor_set(receiver, descriptor, value) {
14
- if (descriptor.set) {
15
- descriptor.set.call(receiver, value);
16
- } else {
17
- if (!descriptor.writable) {
18
- throw new TypeError("attempted to set read only private field");
19
- }
20
- descriptor.value = value;
21
- }
22
- }
23
- function _class_extract_field_descriptor(receiver, privateMap, action) {
24
- if (!privateMap.has(receiver)) {
25
- throw new TypeError("attempted to " + action + " private field on non-instance");
26
- }
27
- return privateMap.get(receiver);
28
- }
29
- function _class_private_field_get(receiver, privateMap) {
30
- var descriptor = _class_extract_field_descriptor(receiver, privateMap, "get");
31
- return _class_apply_descriptor_get(receiver, descriptor);
32
- }
33
- function _class_private_field_init(obj, privateMap, value) {
34
- _check_private_redeclaration(obj, privateMap);
35
- privateMap.set(obj, value);
36
- }
37
- function _class_private_field_set(receiver, privateMap, value) {
38
- var descriptor = _class_extract_field_descriptor(receiver, privateMap, "set");
39
- _class_apply_descriptor_set(receiver, descriptor, value);
40
- return value;
41
- }
42
- function _define_property(obj, key, value) {
43
- if (key in obj) {
44
- Object.defineProperty(obj, key, {
45
- value,
46
- enumerable: true,
47
- configurable: true,
48
- writable: true
49
- });
50
- } else {
51
- obj[key] = value;
52
- }
53
- return obj;
54
- }
55
- var _code = /* @__PURE__ */ new WeakMap();
56
- var _context = /* @__PURE__ */ new WeakMap();
57
2
  var BaseError = class _BaseError extends Error {
58
3
  /**
59
4
  * Primary way of defining new error classes.
@@ -62,17 +7,25 @@ var BaseError = class _BaseError extends Error {
62
7
  * @param message - Default error message.
63
8
  */
64
9
  static extend(code, message) {
65
- var _class;
66
- return _class = class extends _BaseError {
10
+ return class ExtendedError extends _BaseError {
11
+ static code = code;
67
12
  static is(error) {
68
13
  return typeof error === "object" && error !== null && "code" in error && error.code === code;
69
14
  }
70
15
  static wrap(options) {
71
- return (error) => new this({
72
- message,
73
- ...options,
74
- cause: error
75
- });
16
+ const wrapFn = (error) => {
17
+ if (options?.ifTypeDiffers === true && this.is(error)) {
18
+ return error;
19
+ }
20
+ const newError = new this({
21
+ message,
22
+ ...options,
23
+ cause: error
24
+ });
25
+ Error.captureStackTrace(newError, wrapFn);
26
+ return newError;
27
+ };
28
+ return wrapFn;
76
29
  }
77
30
  constructor(options) {
78
31
  super(code, {
@@ -80,38 +33,29 @@ var BaseError = class _BaseError extends Error {
80
33
  ...options
81
34
  });
82
35
  }
83
- }, _define_property(_class, "code", code), _class;
36
+ };
37
+ }
38
+ // NOTE: Errors go through odd transformations and the private fields seem to break.
39
+ code;
40
+ context;
41
+ constructor(code, options) {
42
+ super(options?.message, {
43
+ cause: options?.cause
44
+ });
45
+ this.code = code;
46
+ this.context = options?.context ?? {};
47
+ Object.setPrototypeOf(this, new.target.prototype);
84
48
  }
85
49
  get name() {
86
- return _class_private_field_get(this, _code);
50
+ return this.code;
87
51
  }
88
52
  /** Fallback message. */
89
53
  get message() {
90
54
  return this.constructor.name;
91
55
  }
92
- get code() {
93
- return _class_private_field_get(this, _code);
94
- }
95
56
  // For effect error matching.
96
57
  get _tag() {
97
- return _class_private_field_get(this, _code);
98
- }
99
- get context() {
100
- return _class_private_field_get(this, _context);
101
- }
102
- constructor(code, options) {
103
- super(options?.message, {
104
- cause: options?.cause
105
- }), _class_private_field_init(this, _code, {
106
- writable: true,
107
- value: void 0
108
- }), _class_private_field_init(this, _context, {
109
- writable: true,
110
- value: void 0
111
- });
112
- _class_private_field_set(this, _code, code);
113
- _class_private_field_set(this, _context, options?.context ?? {});
114
- Object.setPrototypeOf(this, new.target.prototype);
58
+ return this.code;
115
59
  }
116
60
  };
117
61
 
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/base.ts", "../../../src/errors.ts"],
4
- "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"],
5
- "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;",
6
- "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"]
4
+ "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 ExtendedError 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(\n options?: Omit<BaseErrorOptions, 'cause'> & { ifTypeDiffers?: boolean },\n ): (error: unknown) => ExtendedError {\n const wrapFn = (error: unknown) => {\n if (options?.ifTypeDiffers === true && this.is(error)) {\n return error as ExtendedError;\n }\n const newError: ExtendedError = new this({ message, ...options, cause: error });\n Error.captureStackTrace(newError, wrapFn); // Position stack-trace to start from the caller of `wrap`.\n return newError;\n };\n return wrapFn;\n }\n\n constructor(options?: BaseErrorOptions) {\n super(code, { message: options?.message ?? message, ...options });\n }\n };\n }\n\n // NOTE: Errors go through odd transformations and the private fields seem to break.\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 // For effect error matching.\n get _tag(): Code {\n return this.code;\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"],
5
+ "mappings": ";AAsBO,IAAMA,YAAN,MAAMA,mBAAgDC,MAAAA;;;;;;;EAO3D,OAAOC,OAAqCC,MAAYC,SAAkB;AACxE,WAAO,MAAMC,sBAAsBL,WAAAA;MACjC,OAAOG,OAAOA;MAEd,OAAOG,GAAGC,OAAoC;AAC5C,eAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA,SAASA,MAAMJ,SAASA;MAC1F;MAEA,OAAOK,KACLC,SACmC;AACnC,cAAMC,SAAS,CAACH,UAAAA;AACd,cAAIE,SAASE,kBAAkB,QAAQ,KAAKL,GAAGC,KAAAA,GAAQ;AACrD,mBAAOA;UACT;AACA,gBAAMK,WAA0B,IAAI,KAAK;YAAER;YAAS,GAAGK;YAASI,OAAON;UAAM,CAAA;AAC7EN,gBAAMa,kBAAkBF,UAAUF,MAAAA;AAClC,iBAAOE;QACT;AACA,eAAOF;MACT;MAEA,YAAYD,SAA4B;AACtC,cAAMN,MAAM;UAAEC,SAASK,SAASL,WAAWA;UAAS,GAAGK;QAAQ,CAAA;MACjE;IACF;EACF;;EAGAN;EACAY;EAEA,YAAYZ,MAAYM,SAA4B;AAClD,UAAMA,SAASL,SAAS;MAAES,OAAOJ,SAASI;IAAM,CAAA;AAEhD,SAAKV,OAAOA;AACZ,SAAKY,UAAUN,SAASM,WAAW,CAAC;AACpCC,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;EAEA,IAAaC,OAAO;AAClB,WAAO,KAAKhB;EACd;;EAGA,IAAaC,UAAU;AACrB,WAAO,KAAK,YAAYe;EAC1B;;EAGA,IAAIC,OAAa;AACf,WAAO,KAAKjB;EACd;AACF;;;AC5EO,IAAMkB,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;",
6
+ "names": ["BaseError", "Error", "extend", "code", "message", "ExtendedError", "is", "error", "wrap", "options", "wrapFn", "ifTypeDiffers", "newError", "cause", "captureStackTrace", "context", "Object", "setPrototypeOf", "prototype", "name", "_tag", "ApiError", "BaseError", "extend", "SystemError", "InternalError", "TimeoutError", "AbortedError", "NotImplementedError"]
7
7
  }
@@ -1 +1 @@
1
- {"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}}}
1
+ {"inputs":{"src/base.ts":{"bytes":7183,"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":4645},"dist/lib/browser/index.mjs":{"imports":[],"exports":["AbortedError","ApiError","BaseError","InternalError","NotImplementedError","SystemError","TimeoutError"],"entryPoint":"src/index.ts","inputs":{"src/base.ts":{"bytesInOutput":1594},"src/index.ts":{"bytesInOutput":0},"src/errors.ts":{"bytesInOutput":491}},"bytes":2276}}}
@@ -1,61 +1,6 @@
1
1
  import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
2
2
 
3
3
  // src/base.ts
4
- function _check_private_redeclaration(obj, privateCollection) {
5
- if (privateCollection.has(obj)) {
6
- throw new TypeError("Cannot initialize the same private elements twice on an object");
7
- }
8
- }
9
- function _class_apply_descriptor_get(receiver, descriptor) {
10
- if (descriptor.get) {
11
- return descriptor.get.call(receiver);
12
- }
13
- return descriptor.value;
14
- }
15
- function _class_apply_descriptor_set(receiver, descriptor, value) {
16
- if (descriptor.set) {
17
- descriptor.set.call(receiver, value);
18
- } else {
19
- if (!descriptor.writable) {
20
- throw new TypeError("attempted to set read only private field");
21
- }
22
- descriptor.value = value;
23
- }
24
- }
25
- function _class_extract_field_descriptor(receiver, privateMap, action) {
26
- if (!privateMap.has(receiver)) {
27
- throw new TypeError("attempted to " + action + " private field on non-instance");
28
- }
29
- return privateMap.get(receiver);
30
- }
31
- function _class_private_field_get(receiver, privateMap) {
32
- var descriptor = _class_extract_field_descriptor(receiver, privateMap, "get");
33
- return _class_apply_descriptor_get(receiver, descriptor);
34
- }
35
- function _class_private_field_init(obj, privateMap, value) {
36
- _check_private_redeclaration(obj, privateMap);
37
- privateMap.set(obj, value);
38
- }
39
- function _class_private_field_set(receiver, privateMap, value) {
40
- var descriptor = _class_extract_field_descriptor(receiver, privateMap, "set");
41
- _class_apply_descriptor_set(receiver, descriptor, value);
42
- return value;
43
- }
44
- function _define_property(obj, key, value) {
45
- if (key in obj) {
46
- Object.defineProperty(obj, key, {
47
- value,
48
- enumerable: true,
49
- configurable: true,
50
- writable: true
51
- });
52
- } else {
53
- obj[key] = value;
54
- }
55
- return obj;
56
- }
57
- var _code = /* @__PURE__ */ new WeakMap();
58
- var _context = /* @__PURE__ */ new WeakMap();
59
4
  var BaseError = class _BaseError extends Error {
60
5
  /**
61
6
  * Primary way of defining new error classes.
@@ -64,17 +9,25 @@ var BaseError = class _BaseError extends Error {
64
9
  * @param message - Default error message.
65
10
  */
66
11
  static extend(code, message) {
67
- var _class;
68
- return _class = class extends _BaseError {
12
+ return class ExtendedError extends _BaseError {
13
+ static code = code;
69
14
  static is(error) {
70
15
  return typeof error === "object" && error !== null && "code" in error && error.code === code;
71
16
  }
72
17
  static wrap(options) {
73
- return (error) => new this({
74
- message,
75
- ...options,
76
- cause: error
77
- });
18
+ const wrapFn = (error) => {
19
+ if (options?.ifTypeDiffers === true && this.is(error)) {
20
+ return error;
21
+ }
22
+ const newError = new this({
23
+ message,
24
+ ...options,
25
+ cause: error
26
+ });
27
+ Error.captureStackTrace(newError, wrapFn);
28
+ return newError;
29
+ };
30
+ return wrapFn;
78
31
  }
79
32
  constructor(options) {
80
33
  super(code, {
@@ -82,38 +35,29 @@ var BaseError = class _BaseError extends Error {
82
35
  ...options
83
36
  });
84
37
  }
85
- }, _define_property(_class, "code", code), _class;
38
+ };
39
+ }
40
+ // NOTE: Errors go through odd transformations and the private fields seem to break.
41
+ code;
42
+ context;
43
+ constructor(code, options) {
44
+ super(options?.message, {
45
+ cause: options?.cause
46
+ });
47
+ this.code = code;
48
+ this.context = options?.context ?? {};
49
+ Object.setPrototypeOf(this, new.target.prototype);
86
50
  }
87
51
  get name() {
88
- return _class_private_field_get(this, _code);
52
+ return this.code;
89
53
  }
90
54
  /** Fallback message. */
91
55
  get message() {
92
56
  return this.constructor.name;
93
57
  }
94
- get code() {
95
- return _class_private_field_get(this, _code);
96
- }
97
58
  // For effect error matching.
98
59
  get _tag() {
99
- return _class_private_field_get(this, _code);
100
- }
101
- get context() {
102
- return _class_private_field_get(this, _context);
103
- }
104
- constructor(code, options) {
105
- super(options?.message, {
106
- cause: options?.cause
107
- }), _class_private_field_init(this, _code, {
108
- writable: true,
109
- value: void 0
110
- }), _class_private_field_init(this, _context, {
111
- writable: true,
112
- value: void 0
113
- });
114
- _class_private_field_set(this, _code, code);
115
- _class_private_field_set(this, _context, options?.context ?? {});
116
- Object.setPrototypeOf(this, new.target.prototype);
60
+ return this.code;
117
61
  }
118
62
  };
119
63
 
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../src/base.ts", "../../../src/errors.ts"],
4
- "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"],
5
- "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;",
6
- "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"]
4
+ "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 ExtendedError 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(\n options?: Omit<BaseErrorOptions, 'cause'> & { ifTypeDiffers?: boolean },\n ): (error: unknown) => ExtendedError {\n const wrapFn = (error: unknown) => {\n if (options?.ifTypeDiffers === true && this.is(error)) {\n return error as ExtendedError;\n }\n const newError: ExtendedError = new this({ message, ...options, cause: error });\n Error.captureStackTrace(newError, wrapFn); // Position stack-trace to start from the caller of `wrap`.\n return newError;\n };\n return wrapFn;\n }\n\n constructor(options?: BaseErrorOptions) {\n super(code, { message: options?.message ?? message, ...options });\n }\n };\n }\n\n // NOTE: Errors go through odd transformations and the private fields seem to break.\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 // For effect error matching.\n get _tag(): Code {\n return this.code;\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"],
5
+ "mappings": ";;;AAsBO,IAAMA,YAAN,MAAMA,mBAAgDC,MAAAA;;;;;;;EAO3D,OAAOC,OAAqCC,MAAYC,SAAkB;AACxE,WAAO,MAAMC,sBAAsBL,WAAAA;MACjC,OAAOG,OAAOA;MAEd,OAAOG,GAAGC,OAAoC;AAC5C,eAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA,SAASA,MAAMJ,SAASA;MAC1F;MAEA,OAAOK,KACLC,SACmC;AACnC,cAAMC,SAAS,CAACH,UAAAA;AACd,cAAIE,SAASE,kBAAkB,QAAQ,KAAKL,GAAGC,KAAAA,GAAQ;AACrD,mBAAOA;UACT;AACA,gBAAMK,WAA0B,IAAI,KAAK;YAAER;YAAS,GAAGK;YAASI,OAAON;UAAM,CAAA;AAC7EN,gBAAMa,kBAAkBF,UAAUF,MAAAA;AAClC,iBAAOE;QACT;AACA,eAAOF;MACT;MAEA,YAAYD,SAA4B;AACtC,cAAMN,MAAM;UAAEC,SAASK,SAASL,WAAWA;UAAS,GAAGK;QAAQ,CAAA;MACjE;IACF;EACF;;EAGAN;EACAY;EAEA,YAAYZ,MAAYM,SAA4B;AAClD,UAAMA,SAASL,SAAS;MAAES,OAAOJ,SAASI;IAAM,CAAA;AAEhD,SAAKV,OAAOA;AACZ,SAAKY,UAAUN,SAASM,WAAW,CAAC;AACpCC,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;EAEA,IAAaC,OAAO;AAClB,WAAO,KAAKhB;EACd;;EAGA,IAAaC,UAAU;AACrB,WAAO,KAAK,YAAYe;EAC1B;;EAGA,IAAIC,OAAa;AACf,WAAO,KAAKjB;EACd;AACF;;;AC5EO,IAAMkB,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;",
6
+ "names": ["BaseError", "Error", "extend", "code", "message", "ExtendedError", "is", "error", "wrap", "options", "wrapFn", "ifTypeDiffers", "newError", "cause", "captureStackTrace", "context", "Object", "setPrototypeOf", "prototype", "name", "_tag", "ApiError", "BaseError", "extend", "SystemError", "InternalError", "TimeoutError", "AbortedError", "NotImplementedError"]
7
7
  }
@@ -1 +1 @@
1
- {"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}}}
1
+ {"inputs":{"src/base.ts":{"bytes":7183,"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":4647},"dist/lib/node-esm/index.mjs":{"imports":[],"exports":["AbortedError","ApiError","BaseError","InternalError","NotImplementedError","SystemError","TimeoutError"],"entryPoint":"src/index.ts","inputs":{"src/base.ts":{"bytesInOutput":1594},"src/index.ts":{"bytesInOutput":0},"src/errors.ts":{"bytesInOutput":491}},"bytes":2369}}}
@@ -15,7 +15,6 @@ export type BaseErrorOptions = ErrorOptions & {
15
15
  * Base class for all DXOS errors.
16
16
  */
17
17
  export declare class BaseError<Code extends string = string> extends Error {
18
- #private;
19
18
  /**
20
19
  * Primary way of defining new error classes.
21
20
  * Extended class may specialize constructor for required context params.
@@ -24,28 +23,26 @@ export declare class BaseError<Code extends string = string> extends Error {
24
23
  */
25
24
  static extend<Code extends string = string>(code: Code, message?: string): {
26
25
  new (options?: BaseErrorOptions): {
27
- #code: Code;
28
- #context: Record<string, unknown>;
26
+ code: Code;
27
+ context: Record<string, unknown>;
29
28
  get name(): Code;
30
29
  /** Fallback message. */
31
30
  get message(): string;
32
- get code(): Code;
33
31
  get _tag(): Code;
34
- get context(): Record<string, unknown>;
35
32
  stack?: string;
36
33
  cause?: unknown;
37
34
  };
38
35
  code: Code;
39
36
  is(error: unknown): error is BaseError;
40
- wrap(options?: Omit<BaseErrorOptions, "cause">): (error: unknown) => {
41
- #code: Code;
42
- #context: Record<string, unknown>;
37
+ wrap(options?: Omit<BaseErrorOptions, "cause"> & {
38
+ ifTypeDiffers?: boolean;
39
+ }): (error: unknown) => {
40
+ code: Code;
41
+ context: Record<string, unknown>;
43
42
  get name(): Code;
44
43
  /** Fallback message. */
45
44
  get message(): string;
46
- get code(): Code;
47
45
  get _tag(): Code;
48
- get context(): Record<string, unknown>;
49
46
  stack?: string;
50
47
  cause?: unknown;
51
48
  };
@@ -55,12 +52,12 @@ export declare class BaseError<Code extends string = string> extends Error {
55
52
  prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
56
53
  stackTraceLimit: number;
57
54
  };
55
+ code: Code;
56
+ context: Record<string, unknown>;
58
57
  constructor(code: Code, options?: BaseErrorOptions);
59
58
  get name(): Code;
60
59
  /** Fallback message. */
61
60
  get message(): string;
62
- get code(): Code;
63
61
  get _tag(): Code;
64
- get context(): Record<string, unknown>;
65
62
  }
66
63
  //# sourceMappingURL=base.d.ts.map
@@ -1 +1 @@
1
- {"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"}
1
+ {"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;;YAchC,wBAAwB;;;;;;;kBAxCH,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;;YAchC,wBAAwB;;;;;SAlCgB;eAV1B,IAAI,SAAS,MAAM,iBAAiB,IAAI,YAAY,MAAM;;;;;;IA6BxE,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAErB,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAQlD,IAAa,IAAI,SAEhB;IAED,wBAAwB;IACxB,IAAa,OAAO,WAEnB;IAGD,IAAI,IAAI,IAAI,IAAI,CAEf;CACF"}