@dxos/errors 0.1.58-next.3349da8 → 0.7.5-labs.e27f9b9

package/README.md

@@ -1,21 +1 @@
-# @dxos/errors
-
-Error definitions and utilities.
-
-## Installation
-
-```bash
-pnpm i @dxos/errors
-```
-
-## DXOS Resources
-
-- [Website](https://dxos.org)
-- [Developer Documentation](https://docs.dxos.org)
-- Talk to us on [Discord](https://discord.gg/eXVfryv3sW)
-
-## Contributions
-
-Your ideas, issues, and code are most welcome. Please take a look at our [community code of conduct](https://github.com/dxos/dxos/blob/main/CODE_OF_CONDUCT.md), the [issue guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-issues), and the [PR contribution guide](https://github.com/dxos/dxos/blob/main/CONTRIBUTING.md#submitting-prs).
-
-License: [MIT](./LICENSE) Copyright 2022 © DXOS
+# errors

package/dist/lib/browser/index.mjs

@@ -1,84 +1,54 @@
-// packages/sdk/errors/src/errors.ts
-var BaseError = class extends Error {
-  constructor(code, message, context) {
-    super(message ? `${code}: ${message}` : code.toString());
-    this.code = code;
-    this.context = context;
+// packages/common/errors/src/base.ts
+var BaseError = class _BaseError extends Error {
+  static extend(code) {
+    return class extends _BaseError {
+      static {
+        this.code = code;
+      }
+      static is(error) {
+        return typeof error === "object" && error !== null && "code" in error && error.code === code;
+      }
+      constructor(message, options) {
+        super(code, message, options);
+      }
+    };
+  }
+  #code;
+  #context;
+  constructor(code, message, options) {
+    super(message, options);
+    this.#code = code;
+    this.#context = options?.context ?? {};
     Object.setPrototypeOf(this, new.target.prototype);
   }
-};
-var ApiError = class extends BaseError {
-};
-var SystemError = class extends BaseError {
-};
-var CancelledError = class extends SystemError {
-  constructor(message, context) {
-    super("CANCELLED", message, context);
-  }
-};
-var InvalidConfigError = class extends ApiError {
-  constructor(message, context) {
-    super("INVALID_CONFIG", message, context);
-  }
-};
-var RemoteServiceConnectionError = class extends ApiError {
-  constructor(message, context) {
-    super("REMOTE_SERVICE_CONNECTION_ERROR", message, context);
-  }
-};
-var RemoteServiceConnectionTimeout = class extends ApiError {
-  constructor(message, context) {
-    super("REMOTE_SERVICE_CONNECTION_TIMEOUT", message, context);
+  get name() {
+    return this.#code;
   }
-};
-var DataCorruptionError = class extends SystemError {
-  constructor(message, context) {
-    super("DATA_CORRUPTION", message, context);
+  get code() {
+    return this.#code;
   }
-};
-var InvalidInvitationExtensionRoleError = class extends SystemError {
-  constructor(message, context) {
-    super("INVALID_INVITATION_EXTENSION_ROLE", message, context);
+  get context() {
+    return this.#context;
   }
 };
-var ConnectionResetError = class extends BaseError {
-  constructor(message, context) {
-    super("ConnectionResetError", message, context);
-  }
+
+// packages/common/errors/src/errors.ts
+var TimeoutError = class extends BaseError.extend("TIMEOUT") {
 };
-var TimeoutError = class extends BaseError {
-  constructor(message, context) {
-    super("TimeoutError", message, context);
-  }
+var AbortedError = class extends BaseError.extend("ABORTED") {
 };
-var ProtocolError = class extends BaseError {
-  constructor(message, context) {
-    super("ProtocolError: general protocol error", message, context);
-  }
+var UnimplementedError = class extends BaseError.extend("UNIMPLEMENTED") {
 };
-var ConnectivityError = class extends BaseError {
-  constructor(message, context) {
-    super("ConnectivityError", message, context);
-  }
+var ApiError = class extends BaseError.extend("API_ERROR") {
 };
-var UnknownProtocolError = class extends BaseError {
-  constructor(message, innerError) {
-    super("UnknownProtocolError", message, innerError);
-  }
+var SystemError = class extends BaseError.extend("SYSTEM_ERROR") {
 };
 export {
+  AbortedError,
   ApiError,
-  CancelledError,
-  ConnectionResetError,
-  ConnectivityError,
-  DataCorruptionError,
-  InvalidConfigError,
-  InvalidInvitationExtensionRoleError,
-  ProtocolError,
-  RemoteServiceConnectionError,
-  RemoteServiceConnectionTimeout,
+  BaseError,
   SystemError,
   TimeoutError,
-  UnknownProtocolError
+  UnimplementedError
 };
 //# sourceMappingURL=index.mjs.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/errors.ts"],
-  "sourcesContent": ["//\n// Copyright 2021 DXOS.org\n//\n\n/**\n * NOTE: Messages should be sentences (Start with a capital letter and end with a period).\n * Errors can optionally include a JSON context object.\n */\nclass BaseError extends Error {\n  constructor(readonly code: string, message?: string, readonly context?: any) {\n    super(message ? `${code}: ${message}` : code.toString());\n    // NOTE: Restores prototype chain (https://stackoverflow.com/a/48342359).\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * User facing API Errors.\n * E.g., something was misconfigured.\n */\nexport class ApiError extends BaseError {}\n\n/**\n * Internal system errors.\n * E.g., unexpected/unrecoverable runtime error.\n */\nexport class SystemError extends BaseError {}\n\nexport class CancelledError extends SystemError {\n  constructor(message?: string, context?: any) {\n    super('CANCELLED', message, context);\n  }\n}\n\nexport class InvalidConfigError extends ApiError {\n  constructor(message: string, context?: any) {\n    super('INVALID_CONFIG', message, context);\n  }\n}\n\n/**\n * Explicit failure to connect with remote client services.\n */\nexport class RemoteServiceConnectionError extends ApiError {\n  constructor(message?: string, context?: any) {\n    super('REMOTE_SERVICE_CONNECTION_ERROR', message, context);\n  }\n}\n\n/**\n * Failed to open a connection to remote client services.\n */\nexport class RemoteServiceConnectionTimeout extends ApiError {\n  constructor(message?: string, context?: any) {\n    super('REMOTE_SERVICE_CONNECTION_TIMEOUT', message, context);\n  }\n}\n\nexport class DataCorruptionError extends SystemError {\n  constructor(message?: string, context?: any) {\n    super('DATA_CORRUPTION', message, context);\n  }\n}\n\nexport class InvalidInvitationExtensionRoleError extends SystemError {\n  constructor(message?: string, context?: any) {\n    super('INVALID_INVITATION_EXTENSION_ROLE', message, context);\n  }\n}\n\nexport class ConnectionResetError extends BaseError {\n  constructor(message?: string, context?: any) {\n    super('ConnectionResetError', message, context);\n  }\n}\n\nexport class TimeoutError extends BaseError {\n  constructor(message?: string, context?: any) {\n    super('TimeoutError', message, context);\n  }\n}\n\n// general protocol error\nexport class ProtocolError extends BaseError {\n  constructor(message?: string, context?: any) {\n    super('ProtocolError: general protocol error', message, context);\n  }\n}\n\n// general connectivity errors\nexport class ConnectivityError extends BaseError {\n  constructor(message?: string, context?: any) {\n    super('ConnectivityError', message, context);\n  }\n}\n\n// TODO(nf): rename? the protocol isn't what's unknown...\nexport class UnknownProtocolError extends BaseError {\n  constructor(message?: string, innerError?: Error) {\n    super('UnknownProtocolError', message, innerError);\n  }\n}\n"],
-  "mappings": ";AAQA,IAAMA,YAAN,cAAwBC,MAAAA;EACtBC,YAAqBC,MAAcC,SAA2BC,SAAe;AAC3E,UAAMD,UAAU,GAAGD,IAAAA,KAASC,OAAAA,KAAYD,KAAKG,SAAQ,CAAA;gBADlCH;mBAAyCE;AAG5DE,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;AACF;AAMO,IAAMC,WAAN,cAAuBV,UAAAA;AAAW;AAMlC,IAAMW,cAAN,cAA0BX,UAAAA;AAAW;AAErC,IAAMY,iBAAN,cAA6BD,YAAAA;EAClCT,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,aAAaD,SAASC,OAAAA;EAC9B;AACF;AAEO,IAAMQ,qBAAN,cAAiCH,SAAAA;EACtCR,YAAYE,SAAiBC,SAAe;AAC1C,UAAM,kBAAkBD,SAASC,OAAAA;EACnC;AACF;AAKO,IAAMS,+BAAN,cAA2CJ,SAAAA;EAChDR,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,mCAAmCD,SAASC,OAAAA;EACpD;AACF;AAKO,IAAMU,iCAAN,cAA6CL,SAAAA;EAClDR,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,qCAAqCD,SAASC,OAAAA;EACtD;AACF;AAEO,IAAMW,sBAAN,cAAkCL,YAAAA;EACvCT,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,mBAAmBD,SAASC,OAAAA;EACpC;AACF;AAEO,IAAMY,sCAAN,cAAkDN,YAAAA;EACvDT,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,qCAAqCD,SAASC,OAAAA;EACtD;AACF;AAEO,IAAMa,uBAAN,cAAmClB,UAAAA;EACxCE,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,wBAAwBD,SAASC,OAAAA;EACzC;AACF;AAEO,IAAMc,eAAN,cAA2BnB,UAAAA;EAChCE,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,gBAAgBD,SAASC,OAAAA;EACjC;AACF;AAGO,IAAMe,gBAAN,cAA4BpB,UAAAA;EACjCE,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,yCAAyCD,SAASC,OAAAA;EAC1D;AACF;AAGO,IAAMgB,oBAAN,cAAgCrB,UAAAA;EACrCE,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,qBAAqBD,SAASC,OAAAA;EACtC;AACF;AAGO,IAAMiB,uBAAN,cAAmCtB,UAAAA;EACxCE,YAAYE,SAAkBmB,YAAoB;AAChD,UAAM,wBAAwBnB,SAASmB,UAAAA;EACzC;AACF;",
-  "names": ["BaseError", "Error", "constructor", "code", "message", "context", "toString", "Object", "setPrototypeOf", "prototype", "ApiError", "SystemError", "CancelledError", "InvalidConfigError", "RemoteServiceConnectionError", "RemoteServiceConnectionTimeout", "DataCorruptionError", "InvalidInvitationExtensionRoleError", "ConnectionResetError", "TimeoutError", "ProtocolError", "ConnectivityError", "UnknownProtocolError", "innerError"]
+  "sources": ["../../../src/base.ts", "../../../src/errors.ts"],
+  "sourcesContent": ["export 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\nexport class BaseError extends Error {\n  static extend(code: string) {\n    return class extends BaseError {\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      constructor(message: string, options?: BaseErrorOptions) {\n        super(code, message, options);\n      }\n    };\n  }\n\n  #code: string;\n  #context: Record<string, unknown>;\n\n  constructor(code: string, 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() {\n    return this.#code;\n  }\n\n  get context() {\n    return this.#context;\n  }\n}\n", "import { 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"],
+  "mappings": ";AAaO,IAAMA,YAAN,MAAMA,mBAAkBC,MAAAA;EAC7B,OAAOC,OAAOC,MAAc;AAC1B,WAAO,cAAcH,WAAAA;MACnB;aAAOG,OAAOA;;MAEd,OAAOC,GAAGC,OAAoC;AAC5C,eAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA,SAASA,MAAMF,SAASA;MAC1F;MAEAG,YAAYC,SAAiBC,SAA4B;AACvD,cAAML,MAAMI,SAASC,OAAAA;MACvB;IACF;EACF;EAEA;EACA;EAEAF,YAAYH,MAAcI,SAAiBC,SAA4B;AACrE,UAAMD,SAASC,OAAAA;AAEf,SAAK,QAAQL;AACb,SAAK,WAAWK,SAASC,WAAW,CAAC;AACrCC,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;EAEA,IAAaC,OAAO;AAClB,WAAO,KAAK;EACd;EAEA,IAAIV,OAAO;AACT,WAAO,KAAK;EACd;EAEA,IAAIM,UAAU;AACZ,WAAO,KAAK;EACd;AACF;;;AChDO,IAAMK,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;",
+  "names": ["BaseError", "Error", "extend", "code", "is", "error", "constructor", "message", "options", "context", "Object", "setPrototypeOf", "prototype", "name", "TimeoutError", "BaseError", "extend", "AbortedError", "UnimplementedError", "ApiError", "SystemError"]
 }

package/dist/lib/browser/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/sdk/errors/src/errors.ts":{"bytes":9519,"imports":[],"format":"esm"},"packages/sdk/errors/src/index.ts":{"bytes":457,"imports":[{"path":"packages/sdk/errors/src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"}},"outputs":{"packages/sdk/errors/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":4811},"packages/sdk/errors/dist/lib/browser/index.mjs":{"imports":[],"exports":["ApiError","CancelledError","ConnectionResetError","ConnectivityError","DataCorruptionError","InvalidConfigError","InvalidInvitationExtensionRoleError","ProtocolError","RemoteServiceConnectionError","RemoteServiceConnectionTimeout","SystemError","TimeoutError","UnknownProtocolError"],"entryPoint":"packages/sdk/errors/src/index.ts","inputs":{"packages/sdk/errors/src/errors.ts":{"bytesInOutput":1996},"packages/sdk/errors/src/index.ts":{"bytesInOutput":0}},"bytes":2376}}}
+{"inputs":{"packages/common/errors/src/base.ts":{"bytes":3711,"imports":[],"format":"esm"},"packages/common/errors/src/errors.ts":{"bytes":1666,"imports":[{"path":"packages/common/errors/src/base.ts","kind":"import-statement","original":"./base"}],"format":"esm"},"packages/common/errors/src/index.ts":{"bytes":439,"imports":[{"path":"packages/common/errors/src/base.ts","kind":"import-statement","original":"./base"},{"path":"packages/common/errors/src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"}},"outputs":{"packages/common/errors/dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":2700},"packages/common/errors/dist/lib/browser/index.mjs":{"imports":[],"exports":["AbortedError","ApiError","BaseError","SystemError","TimeoutError","UnimplementedError"],"entryPoint":"packages/common/errors/src/index.ts","inputs":{"packages/common/errors/src/base.ts":{"bytesInOutput":742},"packages/common/errors/src/index.ts":{"bytesInOutput":0},"packages/common/errors/src/errors.ts":{"bytesInOutput":344}},"bytes":1305}}}

package/dist/lib/node/index.cjs

@@ -16,108 +16,65 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// packages/sdk/errors/src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var node_exports = {};
+__export(node_exports, {
+  AbortedError: () => AbortedError,
   ApiError: () => ApiError,
-  CancelledError: () => CancelledError,
-  ConnectionResetError: () => ConnectionResetError,
-  ConnectivityError: () => ConnectivityError,
-  DataCorruptionError: () => DataCorruptionError,
-  InvalidConfigError: () => InvalidConfigError,
-  InvalidInvitationExtensionRoleError: () => InvalidInvitationExtensionRoleError,
-  ProtocolError: () => ProtocolError,
-  RemoteServiceConnectionError: () => RemoteServiceConnectionError,
-  RemoteServiceConnectionTimeout: () => RemoteServiceConnectionTimeout,
+  BaseError: () => BaseError,
   SystemError: () => SystemError,
   TimeoutError: () => TimeoutError,
-  UnknownProtocolError: () => UnknownProtocolError
+  UnimplementedError: () => UnimplementedError
 });
-module.exports = __toCommonJS(src_exports);
-
-// packages/sdk/errors/src/errors.ts
-var BaseError = class extends Error {
-  constructor(code, message, context) {
-    super(message ? `${code}: ${message}` : code.toString());
-    this.code = code;
-    this.context = context;
+module.exports = __toCommonJS(node_exports);
+var BaseError = class _BaseError extends Error {
+  static extend(code) {
+    return class extends _BaseError {
+      static {
+        this.code = code;
+      }
+      static is(error) {
+        return typeof error === "object" && error !== null && "code" in error && error.code === code;
+      }
+      constructor(message, options) {
+        super(code, message, options);
+      }
+    };
+  }
+  #code;
+  #context;
+  constructor(code, message, options) {
+    super(message, options);
+    this.#code = code;
+    this.#context = options?.context ?? {};
     Object.setPrototypeOf(this, new.target.prototype);
   }
-};
-var ApiError = class extends BaseError {
-};
-var SystemError = class extends BaseError {
-};
-var CancelledError = class extends SystemError {
-  constructor(message, context) {
-    super("CANCELLED", message, context);
+  get name() {
+    return this.#code;
   }
-};
-var InvalidConfigError = class extends ApiError {
-  constructor(message, context) {
-    super("INVALID_CONFIG", message, context);
+  get code() {
+    return this.#code;
   }
-};
-var RemoteServiceConnectionError = class extends ApiError {
-  constructor(message, context) {
-    super("REMOTE_SERVICE_CONNECTION_ERROR", message, context);
+  get context() {
+    return this.#context;
   }
 };
-var RemoteServiceConnectionTimeout = class extends ApiError {
-  constructor(message, context) {
-    super("REMOTE_SERVICE_CONNECTION_TIMEOUT", message, context);
-  }
+var TimeoutError = class extends BaseError.extend("TIMEOUT") {
 };
-var DataCorruptionError = class extends SystemError {
-  constructor(message, context) {
-    super("DATA_CORRUPTION", message, context);
-  }
+var AbortedError = class extends BaseError.extend("ABORTED") {
 };
-var InvalidInvitationExtensionRoleError = class extends SystemError {
-  constructor(message, context) {
-    super("INVALID_INVITATION_EXTENSION_ROLE", message, context);
-  }
+var UnimplementedError = class extends BaseError.extend("UNIMPLEMENTED") {
 };
-var ConnectionResetError = class extends BaseError {
-  constructor(message, context) {
-    super("ConnectionResetError", message, context);
-  }
-};
-var TimeoutError = class extends BaseError {
-  constructor(message, context) {
-    super("TimeoutError", message, context);
-  }
-};
-var ProtocolError = class extends BaseError {
-  constructor(message, context) {
-    super("ProtocolError: general protocol error", message, context);
-  }
-};
-var ConnectivityError = class extends BaseError {
-  constructor(message, context) {
-    super("ConnectivityError", message, context);
-  }
+var ApiError = class extends BaseError.extend("API_ERROR") {
 };
-var UnknownProtocolError = class extends BaseError {
-  constructor(message, innerError) {
-    super("UnknownProtocolError", message, innerError);
-  }
+var SystemError = class extends BaseError.extend("SYSTEM_ERROR") {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AbortedError,
   ApiError,
-  CancelledError,
-  ConnectionResetError,
-  ConnectivityError,
-  DataCorruptionError,
-  InvalidConfigError,
-  InvalidInvitationExtensionRoleError,
-  ProtocolError,
-  RemoteServiceConnectionError,
-  RemoteServiceConnectionTimeout,
+  BaseError,
   SystemError,
   TimeoutError,
-  UnknownProtocolError
+  UnimplementedError
 });
 //# sourceMappingURL=index.cjs.map

package/dist/lib/node/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../src/index.ts", "../../../src/errors.ts"],
-  "sourcesContent": ["//\n// Copyright 2022 DXOS.org\n//\n\nexport * from './errors';\n", "//\n// Copyright 2021 DXOS.org\n//\n\n/**\n * NOTE: Messages should be sentences (Start with a capital letter and end with a period).\n * Errors can optionally include a JSON context object.\n */\nclass BaseError extends Error {\n  constructor(readonly code: string, message?: string, readonly context?: any) {\n    super(message ? `${code}: ${message}` : code.toString());\n    // NOTE: Restores prototype chain (https://stackoverflow.com/a/48342359).\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * User facing API Errors.\n * E.g., something was misconfigured.\n */\nexport class ApiError extends BaseError {}\n\n/**\n * Internal system errors.\n * E.g., unexpected/unrecoverable runtime error.\n */\nexport class SystemError extends BaseError {}\n\nexport class CancelledError extends SystemError {\n  constructor(message?: string, context?: any) {\n    super('CANCELLED', message, context);\n  }\n}\n\nexport class InvalidConfigError extends ApiError {\n  constructor(message: string, context?: any) {\n    super('INVALID_CONFIG', message, context);\n  }\n}\n\n/**\n * Explicit failure to connect with remote client services.\n */\nexport class RemoteServiceConnectionError extends ApiError {\n  constructor(message?: string, context?: any) {\n    super('REMOTE_SERVICE_CONNECTION_ERROR', message, context);\n  }\n}\n\n/**\n * Failed to open a connection to remote client services.\n */\nexport class RemoteServiceConnectionTimeout extends ApiError {\n  constructor(message?: string, context?: any) {\n    super('REMOTE_SERVICE_CONNECTION_TIMEOUT', message, context);\n  }\n}\n\nexport class DataCorruptionError extends SystemError {\n  constructor(message?: string, context?: any) {\n    super('DATA_CORRUPTION', message, context);\n  }\n}\n\nexport class InvalidInvitationExtensionRoleError extends SystemError {\n  constructor(message?: string, context?: any) {\n    super('INVALID_INVITATION_EXTENSION_ROLE', message, context);\n  }\n}\n\nexport class ConnectionResetError extends BaseError {\n  constructor(message?: string, context?: any) {\n    super('ConnectionResetError', message, context);\n  }\n}\n\nexport class TimeoutError extends BaseError {\n  constructor(message?: string, context?: any) {\n    super('TimeoutError', message, context);\n  }\n}\n\n// general protocol error\nexport class ProtocolError extends BaseError {\n  constructor(message?: string, context?: any) {\n    super('ProtocolError: general protocol error', message, context);\n  }\n}\n\n// general connectivity errors\nexport class ConnectivityError extends BaseError {\n  constructor(message?: string, context?: any) {\n    super('ConnectivityError', message, context);\n  }\n}\n\n// TODO(nf): rename? the protocol isn't what's unknown...\nexport class UnknownProtocolError extends BaseError {\n  constructor(message?: string, innerError?: Error) {\n    super('UnknownProtocolError', message, innerError);\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;ACQA,IAAMA,YAAN,cAAwBC,MAAAA;EACtBC,YAAqBC,MAAcC,SAA2BC,SAAe;AAC3E,UAAMD,UAAU,GAAGD,IAAAA,KAASC,OAAAA,KAAYD,KAAKG,SAAQ,CAAA;gBADlCH;mBAAyCE;AAG5DE,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;AACF;AAMO,IAAMC,WAAN,cAAuBV,UAAAA;AAAW;AAMlC,IAAMW,cAAN,cAA0BX,UAAAA;AAAW;AAErC,IAAMY,iBAAN,cAA6BD,YAAAA;EAClCT,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,aAAaD,SAASC,OAAAA;EAC9B;AACF;AAEO,IAAMQ,qBAAN,cAAiCH,SAAAA;EACtCR,YAAYE,SAAiBC,SAAe;AAC1C,UAAM,kBAAkBD,SAASC,OAAAA;EACnC;AACF;AAKO,IAAMS,+BAAN,cAA2CJ,SAAAA;EAChDR,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,mCAAmCD,SAASC,OAAAA;EACpD;AACF;AAKO,IAAMU,iCAAN,cAA6CL,SAAAA;EAClDR,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,qCAAqCD,SAASC,OAAAA;EACtD;AACF;AAEO,IAAMW,sBAAN,cAAkCL,YAAAA;EACvCT,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,mBAAmBD,SAASC,OAAAA;EACpC;AACF;AAEO,IAAMY,sCAAN,cAAkDN,YAAAA;EACvDT,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,qCAAqCD,SAASC,OAAAA;EACtD;AACF;AAEO,IAAMa,uBAAN,cAAmClB,UAAAA;EACxCE,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,wBAAwBD,SAASC,OAAAA;EACzC;AACF;AAEO,IAAMc,eAAN,cAA2BnB,UAAAA;EAChCE,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,gBAAgBD,SAASC,OAAAA;EACjC;AACF;AAGO,IAAMe,gBAAN,cAA4BpB,UAAAA;EACjCE,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,yCAAyCD,SAASC,OAAAA;EAC1D;AACF;AAGO,IAAMgB,oBAAN,cAAgCrB,UAAAA;EACrCE,YAAYE,SAAkBC,SAAe;AAC3C,UAAM,qBAAqBD,SAASC,OAAAA;EACtC;AACF;AAGO,IAAMiB,uBAAN,cAAmCtB,UAAAA;EACxCE,YAAYE,SAAkBmB,YAAoB;AAChD,UAAM,wBAAwBnB,SAASmB,UAAAA;EACzC;AACF;",
-  "names": ["BaseError", "Error", "constructor", "code", "message", "context", "toString", "Object", "setPrototypeOf", "prototype", "ApiError", "SystemError", "CancelledError", "InvalidConfigError", "RemoteServiceConnectionError", "RemoteServiceConnectionTimeout", "DataCorruptionError", "InvalidInvitationExtensionRoleError", "ConnectionResetError", "TimeoutError", "ProtocolError", "ConnectivityError", "UnknownProtocolError", "innerError"]
+  "sources": ["../../../src/base.ts", "../../../src/errors.ts"],
+  "sourcesContent": ["export 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\nexport class BaseError extends Error {\n  static extend(code: string) {\n    return class extends BaseError {\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      constructor(message: string, options?: BaseErrorOptions) {\n        super(code, message, options);\n      }\n    };\n  }\n\n  #code: string;\n  #context: Record<string, unknown>;\n\n  constructor(code: string, 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() {\n    return this.#code;\n  }\n\n  get context() {\n    return this.#context;\n  }\n}\n", "import { 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"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaO,IAAMA,YAAN,MAAMA,mBAAkBC,MAAAA;EAC7B,OAAOC,OAAOC,MAAc;AAC1B,WAAO,cAAcH,WAAAA;MACnB,OAAA;aAAOG,OAAOA;;MAEd,OAAOC,GAAGC,OAAoC;AAC5C,eAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA,SAASA,MAAMF,SAASA;MAC1F;MAEAG,YAAYC,SAAiBC,SAA4B;AACvD,cAAML,MAAMI,SAASC,OAAAA;MACvB;IACF;EACF;EAEA;EACA;EAEAF,YAAYH,MAAcI,SAAiBC,SAA4B;AACrE,UAAMD,SAASC,OAAAA;AAEf,SAAK,QAAQL;AACb,SAAK,WAAWK,SAASC,WAAW,CAAC;AACrCC,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;EAEA,IAAaC,OAAO;AAClB,WAAO,KAAK;EACd;EAEA,IAAIV,OAAO;AACT,WAAO,KAAK;EACd;EAEA,IAAIM,UAAU;AACZ,WAAO,KAAK;EACd;AACF;AChDO,IAAMK,eAAN,cAA2Bd,UAAUE,OAAO,SAAA,EAAA;AAAY;AAExD,IAAMa,eAAN,cAA2Bf,UAAUE,OAAO,SAAA,EAAA;AAAY;AAExD,IAAMc,qBAAN,cAAiChB,UAAUE,OAAO,eAAA,EAAA;AAAkB;AAEpE,IAAMe,WAAN,cAAuBjB,UAAUE,OAAO,WAAA,EAAA;AAAc;AAEtD,IAAMgB,cAAN,cAA0BlB,UAAUE,OAAO,cAAA,EAAA;AAAiB;",
+  "names": ["BaseError", "Error", "extend", "code", "is", "error", "constructor", "message", "options", "context", "Object", "setPrototypeOf", "prototype", "name", "TimeoutError", "AbortedError", "UnimplementedError", "ApiError", "SystemError"]
 }

package/dist/lib/node/meta.json

@@ -1 +1 @@
-{"inputs":{"packages/sdk/errors/src/errors.ts":{"bytes":9519,"imports":[],"format":"esm"},"packages/sdk/errors/src/index.ts":{"bytes":457,"imports":[{"path":"packages/sdk/errors/src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"}},"outputs":{"packages/sdk/errors/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":4947},"packages/sdk/errors/dist/lib/node/index.cjs":{"imports":[],"exports":[],"entryPoint":"packages/sdk/errors/src/index.ts","inputs":{"packages/sdk/errors/src/index.ts":{"bytesInOutput":739},"packages/sdk/errors/src/errors.ts":{"bytesInOutput":1996}},"bytes":4031}}}
+{"inputs":{"packages/common/errors/src/base.ts":{"bytes":3711,"imports":[],"format":"esm"},"packages/common/errors/src/errors.ts":{"bytes":1666,"imports":[{"path":"packages/common/errors/src/base.ts","kind":"import-statement","original":"./base"}],"format":"esm"},"packages/common/errors/src/index.ts":{"bytes":439,"imports":[{"path":"packages/common/errors/src/base.ts","kind":"import-statement","original":"./base"},{"path":"packages/common/errors/src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"}},"outputs":{"packages/common/errors/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":2700},"packages/common/errors/dist/lib/node/index.cjs":{"imports":[],"exports":["AbortedError","ApiError","BaseError","SystemError","TimeoutError","UnimplementedError"],"entryPoint":"packages/common/errors/src/index.ts","inputs":{"packages/common/errors/src/base.ts":{"bytesInOutput":742},"packages/common/errors/src/index.ts":{"bytesInOutput":0},"packages/common/errors/src/errors.ts":{"bytesInOutput":344}},"bytes":1305}}}

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

@@ -0,0 +1,56 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+
+// packages/common/errors/src/base.ts
+var BaseError = class _BaseError extends Error {
+  static extend(code) {
+    return class extends _BaseError {
+      static {
+        this.code = code;
+      }
+      static is(error) {
+        return typeof error === "object" && error !== null && "code" in error && error.code === code;
+      }
+      constructor(message, options) {
+        super(code, message, options);
+      }
+    };
+  }
+  #code;
+  #context;
+  constructor(code, message, options) {
+    super(message, options);
+    this.#code = code;
+    this.#context = options?.context ?? {};
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  get name() {
+    return this.#code;
+  }
+  get code() {
+    return this.#code;
+  }
+  get context() {
+    return this.#context;
+  }
+};
+
+// packages/common/errors/src/errors.ts
+var TimeoutError = class extends BaseError.extend("TIMEOUT") {
+};
+var AbortedError = class extends BaseError.extend("ABORTED") {
+};
+var UnimplementedError = class extends BaseError.extend("UNIMPLEMENTED") {
+};
+var ApiError = class extends BaseError.extend("API_ERROR") {
+};
+var SystemError = class extends BaseError.extend("SYSTEM_ERROR") {
+};
+export {
+  AbortedError,
+  ApiError,
+  BaseError,
+  SystemError,
+  TimeoutError,
+  UnimplementedError
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/base.ts", "../../../src/errors.ts"],
+  "sourcesContent": ["export 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\nexport class BaseError extends Error {\n  static extend(code: string) {\n    return class extends BaseError {\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      constructor(message: string, options?: BaseErrorOptions) {\n        super(code, message, options);\n      }\n    };\n  }\n\n  #code: string;\n  #context: Record<string, unknown>;\n\n  constructor(code: string, 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() {\n    return this.#code;\n  }\n\n  get context() {\n    return this.#context;\n  }\n}\n", "import { 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"],
+  "mappings": ";;;AAaO,IAAMA,YAAN,MAAMA,mBAAkBC,MAAAA;EAC7B,OAAOC,OAAOC,MAAc;AAC1B,WAAO,cAAcH,WAAAA;MACnB;aAAOG,OAAOA;;MAEd,OAAOC,GAAGC,OAAoC;AAC5C,eAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,UAAUA,SAASA,MAAMF,SAASA;MAC1F;MAEAG,YAAYC,SAAiBC,SAA4B;AACvD,cAAML,MAAMI,SAASC,OAAAA;MACvB;IACF;EACF;EAEA;EACA;EAEAF,YAAYH,MAAcI,SAAiBC,SAA4B;AACrE,UAAMD,SAASC,OAAAA;AAEf,SAAK,QAAQL;AACb,SAAK,WAAWK,SAASC,WAAW,CAAC;AACrCC,WAAOC,eAAe,MAAM,WAAWC,SAAS;EAClD;EAEA,IAAaC,OAAO;AAClB,WAAO,KAAK;EACd;EAEA,IAAIV,OAAO;AACT,WAAO,KAAK;EACd;EAEA,IAAIM,UAAU;AACZ,WAAO,KAAK;EACd;AACF;;;AChDO,IAAMK,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;",
+  "names": ["BaseError", "Error", "extend", "code", "is", "error", "constructor", "message", "options", "context", "Object", "setPrototypeOf", "prototype", "name", "TimeoutError", "BaseError", "extend", "AbortedError", "UnimplementedError", "ApiError", "SystemError"]
+}

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

@@ -0,0 +1 @@
+{"inputs":{"packages/common/errors/src/base.ts":{"bytes":3711,"imports":[],"format":"esm"},"packages/common/errors/src/errors.ts":{"bytes":1666,"imports":[{"path":"packages/common/errors/src/base.ts","kind":"import-statement","original":"./base"}],"format":"esm"},"packages/common/errors/src/index.ts":{"bytes":439,"imports":[{"path":"packages/common/errors/src/base.ts","kind":"import-statement","original":"./base"},{"path":"packages/common/errors/src/errors.ts","kind":"import-statement","original":"./errors"}],"format":"esm"}},"outputs":{"packages/common/errors/dist/lib/node-esm/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":2702},"packages/common/errors/dist/lib/node-esm/index.mjs":{"imports":[],"exports":["AbortedError","ApiError","BaseError","SystemError","TimeoutError","UnimplementedError"],"entryPoint":"packages/common/errors/src/index.ts","inputs":{"packages/common/errors/src/base.ts":{"bytesInOutput":742},"packages/common/errors/src/index.ts":{"bytesInOutput":0},"packages/common/errors/src/errors.ts":{"bytesInOutput":344}},"bytes":1398}}}

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

@@ -0,0 +1,37 @@
+export type BaseErrorOptions = {
+    /**
+     * The cause of the error.
+     * An instance of Error.
+     */
+    cause?: unknown;
+    /**
+     * Structured details about the error.
+     */
+    context?: Record<string, unknown>;
+};
+export declare class BaseError extends Error {
+    #private;
+    static extend(code: string): {
+        new (message: string, options?: BaseErrorOptions): {
+            "__#1@#code": string;
+            "__#1@#context": Record<string, unknown>;
+            readonly name: string;
+            readonly code: string;
+            readonly context: Record<string, unknown>;
+            message: string;
+            stack?: string;
+            cause?: unknown;
+        };
+        code: string;
+        is(error: unknown): error is BaseError;
+        extend(code: string): /*elided*/ any;
+        captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+        prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+        stackTraceLimit: number;
+    };
+    constructor(code: string, message: string, options?: BaseErrorOptions);
+    get name(): string;
+    get code(): string;
+    get context(): Record<string, unknown>;
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/base.ts"],"names":[],"mappings":"AAAA,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,qBAAa,SAAU,SAAQ,KAAK;;IAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM;sBAQD,MAAM,YAAY,gBAAgB;0BAMpD,MAAM;6BACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;kBAXZ,OAAO,GAAG,KAAK,IAAI,SAAS;qBAJ7B,MAAM;;uDAqCkpJ,OAAQ,QAAQ;;;gBApBhrJ,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB;IAQrE,IAAa,IAAI,WAEhB;IAED,IAAI,IAAI,WAEP;IAED,IAAI,OAAO,4BAEV;CACF"}

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

@@ -1,62 +1,103 @@
-/**
- * NOTE: Messages should be sentences (Start with a capital letter and end with a period).
- * Errors can optionally include a JSON context object.
- */
-declare class BaseError extends Error {
-    readonly code: string;
-    readonly context?: any;
-    constructor(code: string, message?: string, context?: any);
+import { BaseError } from './base';
+declare const TimeoutError_base: {
+    new (message: string, options?: import("./base").BaseErrorOptions): {
+        "__#1@#code": string;
+        "__#1@#context": Record<string, unknown>;
+        readonly name: string;
+        readonly code: string;
+        readonly context: Record<string, unknown>;
+        message: string;
+        stack?: string;
+        cause?: unknown;
+    };
+    code: string;
+    is(error: unknown): error is BaseError;
+    extend(code: string): /*elided*/ any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class TimeoutError extends TimeoutError_base {
 }
-/**
- * User facing API Errors.
- * E.g., something was misconfigured.
- */
-export declare class ApiError extends BaseError {
+declare const AbortedError_base: {
+    new (message: string, options?: import("./base").BaseErrorOptions): {
+        "__#1@#code": string;
+        "__#1@#context": Record<string, unknown>;
+        readonly name: string;
+        readonly code: string;
+        readonly context: Record<string, unknown>;
+        message: string;
+        stack?: string;
+        cause?: unknown;
+    };
+    code: string;
+    is(error: unknown): error is BaseError;
+    extend(code: string): /*elided*/ any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class AbortedError extends AbortedError_base {
 }
-/**
- * Internal system errors.
- * E.g., unexpected/unrecoverable runtime error.
- */
-export declare class SystemError extends BaseError {
+declare const UnimplementedError_base: {
+    new (message: string, options?: import("./base").BaseErrorOptions): {
+        "__#1@#code": string;
+        "__#1@#context": Record<string, unknown>;
+        readonly name: string;
+        readonly code: string;
+        readonly context: Record<string, unknown>;
+        message: string;
+        stack?: string;
+        cause?: unknown;
+    };
+    code: string;
+    is(error: unknown): error is BaseError;
+    extend(code: string): /*elided*/ any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class UnimplementedError extends UnimplementedError_base {
 }
-export declare class CancelledError extends SystemError {
-    constructor(message?: string, context?: any);
+declare const ApiError_base: {
+    new (message: string, options?: import("./base").BaseErrorOptions): {
+        "__#1@#code": string;
+        "__#1@#context": Record<string, unknown>;
+        readonly name: string;
+        readonly code: string;
+        readonly context: Record<string, unknown>;
+        message: string;
+        stack?: string;
+        cause?: unknown;
+    };
+    code: string;
+    is(error: unknown): error is BaseError;
+    extend(code: string): /*elided*/ any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class ApiError extends ApiError_base {
 }
-export declare class InvalidConfigError extends ApiError {
-    constructor(message: string, context?: any);
-}
-/**
- * Explicit failure to connect with remote client services.
- */
-export declare class RemoteServiceConnectionError extends ApiError {
-    constructor(message?: string, context?: any);
-}
-/**
- * Failed to open a connection to remote client services.
- */
-export declare class RemoteServiceConnectionTimeout extends ApiError {
-    constructor(message?: string, context?: any);
-}
-export declare class DataCorruptionError extends SystemError {
-    constructor(message?: string, context?: any);
-}
-export declare class InvalidInvitationExtensionRoleError extends SystemError {
-    constructor(message?: string, context?: any);
-}
-export declare class ConnectionResetError extends BaseError {
-    constructor(message?: string, context?: any);
-}
-export declare class TimeoutError extends BaseError {
-    constructor(message?: string, context?: any);
-}
-export declare class ProtocolError extends BaseError {
-    constructor(message?: string, context?: any);
-}
-export declare class ConnectivityError extends BaseError {
-    constructor(message?: string, context?: any);
-}
-export declare class UnknownProtocolError extends BaseError {
-    constructor(message?: string, innerError?: Error);
+declare const SystemError_base: {
+    new (message: string, options?: import("./base").BaseErrorOptions): {
+        "__#1@#code": string;
+        "__#1@#context": Record<string, unknown>;
+        readonly name: string;
+        readonly code: string;
+        readonly context: Record<string, unknown>;
+        message: string;
+        stack?: string;
+        cause?: unknown;
+    };
+    code: string;
+    is(error: unknown): error is BaseError;
+    extend(code: string): /*elided*/ any;
+    captureStackTrace(targetObject: object, constructorOpt?: Function): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+export declare class SystemError extends SystemError_base {
 }
 export {};
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,cAAM,SAAU,SAAQ,KAAK;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAoB,QAAQ,CAAC,OAAO,CAAC;gBAAjD,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAW,OAAO,CAAC,KAAK;CAK5E;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,SAAS;CAAG;AAE1C;;;GAGG;AACH,qBAAa,WAAY,SAAQ,SAAS;CAAG;AAE7C,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG5C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG3C;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,QAAQ;gBAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG5C;AAED;;GAEG;AACH,qBAAa,8BAA+B,SAAQ,QAAQ;gBAC9C,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG5C;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG5C;AAED,qBAAa,mCAAoC,SAAQ,WAAW;gBACtD,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG5C;AAED,qBAAa,oBAAqB,SAAQ,SAAS;gBACrC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG5C;AAED,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG5C;AAGD,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG5C;AAGD,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAG5C;AAGD,qBAAa,oBAAqB,SAAQ,SAAS;gBACrC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK;CAGjD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;;;;;;;;;;;;;;;;mDAW8zK,OAAQ,QAAQ;;;AATj3K,qBAAa,YAAa,SAAQ,iBAA2B;CAAG;;;;;;;;;;;;;;;;mDASiyK,OAAQ,QAAQ;;;AAPj3K,qBAAa,YAAa,SAAQ,iBAA2B;CAAG;;;;;;;;;;;;;;;;mDAOiyK,OAAQ,QAAQ;;;AALj3K,qBAAa,kBAAmB,SAAQ,uBAAiC;CAAG;;;;;;;;;;;;;;;;mDAKqxK,OAAQ,QAAQ;;;AAHj3K,qBAAa,QAAS,SAAQ,aAA6B;CAAG;;;;;;;;;;;;;;;;mDAGmyK,OAAQ,QAAQ;;;AADj3K,qBAAa,WAAY,SAAQ,gBAAgC;CAAG"}

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

@@ -1,2 +1,3 @@
+export * from './base';
 export * from './errors';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/types/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"version":"5.7.3"}

package/package.json

@@ -1,19 +1,32 @@
 {
   "name": "@dxos/errors",
-  "version": "0.1.58-next.3349da8",
-  "description": "Error definitions and utilities.",
+  "version": "0.7.5-labs.e27f9b9",
+  "description": "Error definitions",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
   "license": "MIT",
   "author": "DXOS.org",
-  "main": "dist/lib/node/index.cjs",
-  "browser": {
-    "./dist/lib/node/index.cjs": "./dist/lib/browser/index.mjs"
+  "sideEffects": true,
+  "exports": {
+    ".": {
+      "browser": "./dist/lib/browser/index.mjs",
+      "node": {
+        "require": "./dist/lib/node/index.cjs",
+        "default": "./dist/lib/node-esm/index.mjs"
+      },
+      "types": "./dist/types/src/index.d.ts"
+    }
   },
   "types": "dist/types/src/index.d.ts",
+  "typesVersions": {
+    "*": {}
+  },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
+  "dependencies": {},
+  "devDependencies": {},
   "publishConfig": {
     "access": "public"
   }

package/src/base.ts

@@ -0,0 +1,51 @@
+export type BaseErrorOptions = {
+  /**
+   * The cause of the error.
+   * An instance of Error.
+   */
+  cause?: unknown;
+
+  /**
+   * Structured details about the error.
+   */
+  context?: Record<string, unknown>;
+};
+
+export class BaseError extends Error {
+  static extend(code: string) {
+    return class extends BaseError {
+      static code = code;
+
+      static is(error: unknown): error is BaseError {
+        return typeof error === 'object' && error !== null && 'code' in error && error.code === code;
+      }
+
+      constructor(message: string, options?: BaseErrorOptions) {
+        super(code, message, options);
+      }
+    };
+  }
+
+  #code: string;
+  #context: Record<string, unknown>;
+
+  constructor(code: string, message: string, options?: BaseErrorOptions) {
+    super(message, options);
+
+    this.#code = code;
+    this.#context = options?.context ?? {};
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+
+  override get name() {
+    return this.#code;
+  }
+
+  get code() {
+    return this.#code;
+  }
+
+  get context() {
+    return this.#context;
+  }
+}

package/src/errors.test.ts

@@ -0,0 +1,39 @@
+import { describe, expect, test } from 'vitest';
+import { SystemError } from './errors';
+
+describe('errors', () => {
+  test('error code and message, cause', () => {
+    const error = new SystemError('Test message', { cause: new Error('Test cause'), context: { a: 1, b: 2 } });
+    expect(error).toBeInstanceOf(SystemError);
+    expect(error).toBeInstanceOf(SystemError);
+    expect(error.code).toBe(SystemError.code);
+    expect(error.message).toBe('Test message');
+    expect(error.cause).toBeInstanceOf(Error);
+    expect((error.cause as Error).message).toBe('Test cause');
+    expect(error.context).toEqual({ a: 1, b: 2 });
+  });
+
+  test('error formatting', () => {
+    try {
+      throwError();
+      expect.fail('Expected error to be thrown');
+    } catch (error: any) {
+      expect(error).toBeInstanceOf(SystemError);
+      expect(String(error)).toEqual(`SYSTEM_ERROR: Test message`);
+      const stackLines = error.stack!.split('\n');
+      expect(stackLines?.[0]).toEqual(`SYSTEM_ERROR: Test message`);
+      expect(stackLines?.[1]).toMatch(/^    at two \(.*$/);
+      expect(stackLines?.[2]).toMatch(/^    at one \(.*$/);
+    }
+  });
+});
+
+function throwError() {
+  function one() {
+    function two() {
+      throw new SystemError('Test message');
+    }
+    two();
+  }
+  one();
+}

package/src/errors.ts

@@ -0,0 +1,11 @@
+import { BaseError } from './base';
+
+export class TimeoutError extends BaseError.extend('TIMEOUT') {}
+
+export class AbortedError extends BaseError.extend('ABORTED') {}
+
+export class UnimplementedError extends BaseError.extend('UNIMPLEMENTED') {}
+
+export class ApiError extends BaseError.extend('API_ERROR') {}
+
+export class SystemError extends BaseError.extend('SYSTEM_ERROR') {}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './base';
+export * from './errors';