keryx 0.24.2 → 0.25.1

package/classes/API.ts

@@ -86,9 +86,9 @@ export class API {
         this.logger.debug(`Initialized initializer ${initializer.name}`);
       } catch (e) {
         throw new TypedError({
-          message: `${e}`,
+          message: `Failed to initialize initializer "${initializer.name}": ${e instanceof Error ? e.message : e}`,
           type: ErrorType.SERVER_INITIALIZATION,
-          originalError: e,
+          cause: e,
         });
       }
     }
@@ -132,9 +132,9 @@ export class API {
         this.logger.debug(`Started initializer ${initializer.name}`);
       } catch (e) {
         throw new TypedError({
-          message: `${e}`,
+          message: `Failed to start initializer "${initializer.name}": ${e instanceof Error ? e.message : e}`,
           type: ErrorType.SERVER_START,
-          originalError: e,
+          cause: e,
         });
       }
     }
@@ -167,9 +167,9 @@ export class API {
         this.logger.debug(`Stopped initializer ${initializer.name}`);
       } catch (e) {
         throw new TypedError({
-          message: `${e}`,
+          message: `Failed to stop initializer "${initializer.name}": ${e instanceof Error ? e.message : e}`,
           type: ErrorType.SERVER_STOP,
-          originalError: e,
+          cause: e,
         });
       }
     }

package/classes/Connection.ts

@@ -161,7 +161,7 @@ export class Connection<
           : new TypedError({
               message: `${e}`,
               type: ErrorType.CONNECTION_ACTION_RUN,
-              originalError: e,
+              cause: e,
             });
     } finally {
       if (action && formattedParams) {
@@ -337,7 +337,7 @@ export class Connection<
         throw new TypedError({
           message: `Error validating params: ${e}`,
           type: ErrorType.CONNECTION_ACTION_PARAM_VALIDATION,
-          originalError: e,
+          cause: e,
         });
       }
     }

package/classes/TypedError.ts

@@ -73,8 +73,11 @@ export type TypedErrorArgs = {
   message: string;
   /** The error category, which determines the HTTP status code. */
   type: ErrorType;
-  /** The original caught error, if wrapping. Its stack trace is preserved on the `TypedError`. */
-  originalError?: unknown;
+  /**
+   * The underlying error being wrapped. Exposed via the standard ES2022 `Error.cause`
+   * field, so `console.error(err)` prints the full "Caused by:" chain natively.
+   */
+  cause?: unknown;
   /** The param key that caused the error (for validation errors). */
   key?: string;
   /** The param value that caused the error (for validation errors). */
@@ -84,7 +87,9 @@ export type TypedErrorArgs = {
 /**
  * Structured error class for action and framework failures. Extends `Error` with an
  * `ErrorType` that maps to an HTTP status code, and optional `key`/`value` fields for
- * param validation errors. If `originalError` is provided, its stack trace is preserved.
+ * param validation errors. When `cause` is provided, it is forwarded to the base
+ * `Error` constructor so the native ES2022 cause chain is preserved — tooling that
+ * inspects errors (Node's default printer, debuggers) will walk both stacks.
  */
 export class TypedError extends Error {
   /** The error category, used to determine the HTTP status code via `ErrorStatusCodes`. */
@@ -95,17 +100,12 @@ export class TypedError extends Error {
   value?: any;
 
   constructor(args: TypedErrorArgs) {
-    super(args.message);
+    super(
+      args.message,
+      args.cause !== undefined ? { cause: args.cause } : undefined,
+    );
     this.type = args.type;
     this.key = args.key;
     this.value = args.value;
-
-    if (args.originalError !== undefined) {
-      if (args.originalError instanceof Error) {
-        this.stack = args.originalError.stack;
-      } else {
-        this.stack = `OriginalStringError: ${args.originalError}`;
-      }
-    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keryx",
-  "version": "0.24.2",
+  "version": "0.25.1",
   "module": "index.ts",
   "type": "module",
   "license": "MIT",

package/util/glob.ts

@@ -38,7 +38,7 @@ export async function globLoader<T>(searchDir: string) {
           throw new TypedError({
             message: `Error loading from ${dir} -  ${name} - ${error}`,
             type: ErrorType.SERVER_INITIALIZATION,
-            originalError: error,
+            cause: error,
           });
         }
       }

package/util/transaction.ts

@@ -73,7 +73,7 @@ export async function withTransaction<T>(
     throw new TypedError({
       message: `${e}`,
       type: ErrorType.CONNECTION_ACTION_RUN,
-      originalError: e,
+      cause: e,
     });
   } finally {
     client.release();

package/util/webRouting.ts

@@ -77,7 +77,7 @@ export async function parseRequestParams(
       throw new TypedError({
         message: `cannot parse request body: ${e}`,
         type: ErrorType.CONNECTION_ACTION_RUN,
-        originalError: e,
+        cause: e,
       });
     }
   } else if (

package/util/webSocket.ts

@@ -122,7 +122,7 @@ export async function handleWebsocketSubscribe(
         : new TypedError({
             message: `${e}`,
             type: ErrorType.CONNECTION_CHANNEL_AUTHORIZATION,
-            originalError: e,
+            cause: e,
           });
     ws.send(
       JSON.stringify({
@@ -174,7 +174,7 @@ export async function handleWebsocketUnsubscribe(
         : new TypedError({
             message: `${e}`,
             type: ErrorType.CONNECTION_CHANNEL_VALIDATION,
-            originalError: e,
+            cause: e,
           });
     ws.send(
       JSON.stringify({