error-message-utils 1.2.1 → 1.2.3

package/README.md

@@ -117,7 +117,7 @@ isEncodedError(encodeError(new Error('Some unknown error.'), 'NASTY_ERROR'));
 In some cases, you may want to check whether the extracted error matches the default message provided by this package:
 
 ```typescript
-import { isDefaultErrorMessage} from 'error-message-utils';
+import { isDefaultErrorMessage } from 'error-message-utils';
 
 const DEFAULT_MESSAGE: string = 'The error message could not be extracted, check the logs for more information.';
 
@@ -134,6 +134,22 @@ isDefaultErrorMessage(`${DEFAULT_MESSAGE} and something else...`, true);
 
 
 
+<br/>
+
+Improve code consistency by handling errors with the `Exception` utility class:
+
+```typescript
+import { Exception } from 'error-message-utils';
+
+const exception = new Exception('Request failed', 'SOME_ERROR_CODE');
+exception instanceof Error; // true
+exception instanceof Exception; // true
+exception.message; // "Request failed"
+exception.code; // "SOME_ERROR_CODE"
+exception.toString(); // "Request failed{(SOME_ERROR_CODE)}"
+```
+
+
 <br/>
 
 ## Types
@@ -156,6 +172,20 @@ type IDecodedError = {
 ```
 
 
+<br/>
+
+## Constants
+
+```typescript
+// the default message if none can be extracted
+const DEFAULT_MESSAGE: string =
+  'The error message could not be extracted, check the logs for more information.';
+
+// the default code if none was provided or could not be extracted
+const DEFAULT_CODE: IErrorCode = -1;
+```
+
+
 
 <br/>
 

package/dist/error-handler/index.d.ts

@@ -0,0 +1,45 @@
+import { IErrorCode, IDecodedError } from '../shared/types.js';
+/**------------------------------------------------------------------------------------------------
+ * General errors
+ -------------------------------------------------------------------------------------------------*/
+/**
+ * Attempts to extract an error message from an error that could be anything. If it fails to do so,
+ * it returns the default message.
+ * @param error The error to extract the message from.
+ * @returns A string containing the extracted message or the default message if extraction fails.
+ */
+declare const extractMessage: (error: any) => string;
+/**------------------------------------------------------------------------------------------------
+ * Encoding
+ -------------------------------------------------------------------------------------------------*/
+/**
+ * Given an error in any format, it extracts the message and inserts the code at the end.
+ * @param error The error to be encoded, can be of any type.
+ * @param code The error code to be wrapped and appended to the message.
+ * @returns A string containing the encoded error message.
+ */
+declare const encodeError: (error: any, code: IErrorCode) => string;
+/**
+ * Given an error, it will extract the encoded message and attempt to decode it. If successful,
+ * it separates the error message from the code so it can be shown directly to the user.
+ * @param error The error to be decoded, can be of any type.
+ * @returns The decoded error, containing the message and the code.
+ */
+declare const decodeError: (error: any) => IDecodedError;
+/**
+ * Determines if a given error (in any format) is an error encoded by this package.
+ * @param error The error to be checked, can be of any type.
+ * @returns A boolean indicating whether the error is an encoded error or not.
+ */
+declare const isEncodedError: (error: any) => boolean;
+/**------------------------------------------------------------------------------------------------
+ * Misc helpers
+ -------------------------------------------------------------------------------------------------*/
+/**
+ * Verifies if a value matches the default error message used by this package.
+ * @param value The value to be checked.
+ * @param fullMatch Whether to check for an exact match or a partial match.
+ * @returns A boolean indicating whether the value matches the default error message.
+ */
+declare const isDefaultErrorMessage: (value: string, fullMatch?: boolean) => value is string;
+export { type IErrorCode, type IDecodedError, extractMessage, encodeError, decodeError, isEncodedError, isDefaultErrorMessage, };

package/dist/error-handler/index.js

@@ -0,0 +1 @@
+import{ZodError}from"zod";import{DEFAULT_CODE,DEFAULT_MESSAGE}from"../shared/constants.js";import{wrapCode,unwrapCode}from"../utils/index.js";const __extractPathFromZodError=r=>r&&Array.isArray(r.issues)&&r.issues.length&&Array.isArray(r.issues[0].path)&&r.issues[0].path.length?r.issues[0].path.join("."):"Unknown path",__extractZodErrorMessage=r=>r&&Array.isArray(r.issues)&&r.issues.length&&Array.isArray(r.issues[0].path)&&r.issues[0].message?`${r.issues[0].message} (${__extractPathFromZodError(r)})`:DEFAULT_MESSAGE,extractMessage=r=>{if("string"==typeof r&&r.length)return r;if(r instanceof ZodError)return __extractZodErrorMessage(r);if(r instanceof Error&&r.message)return r.cause?`${r.message}; [CAUSE]: ${extractMessage(r.cause)}`:r.message;if(r&&"object"==typeof r){if(r.message)return extractMessage(r.message);if(r.msg)return extractMessage(r.msg);if(r.error)return extractMessage(r.error);if(r.err)return extractMessage(r.err);if(r.errors)return extractMessage(r.errors);if(r.errs)return extractMessage(r.errs);if(r.reason)return extractMessage(r.reason);if(r.reasons)return extractMessage(r.reasons);if(r.issue)return extractMessage(r.issue);if(r.issues)return extractMessage(r.issues);if(r.data)return extractMessage(r.data);try{return JSON.stringify(r)}catch(e){console.error("Error during extractMessage:"),console.error("Original Error: ",r),console.error("JSON.stringify Error:",e)}}return DEFAULT_MESSAGE},encodeError=(r,e)=>`${extractMessage(r)}${wrapCode(e)}`,decodeError=r=>{const e=extractMessage(r),{code:s,startsAt:t}=unwrapCode(e);return{message:t>0?e.slice(0,t):e,code:s}},isEncodedError=r=>decodeError(r).code!==DEFAULT_CODE,isDefaultErrorMessage=(r,e=!1)=>e?r===DEFAULT_MESSAGE:"string"==typeof r&&r.includes(DEFAULT_MESSAGE);export{extractMessage,encodeError,decodeError,isEncodedError,isDefaultErrorMessage};

package/dist/exception/index.d.ts

@@ -0,0 +1,16 @@
+import { type IErrorCode } from '../shared/types.js';
+export declare class Exception extends Error {
+    readonly code: IErrorCode;
+    constructor(error: unknown, code: IErrorCode);
+    /**
+     * Override the default toString method to return a formatted error message with the code.
+     * @returns A string representation of the error with the code.
+     */
+    toString(): string;
+    /**
+     * Override the default behavior for type conversion to return a formatted error message with the code.
+     * @param hint The type hint for the conversion.
+     * @returns A string representation of the error with the code or null for other types.
+     */
+    [Symbol.toPrimitive](hint: string): string | null;
+}

package/dist/exception/index.js

@@ -0,0 +1 @@
+import{encodeError,extractMessage}from"../error-handler/index.js";export class Exception extends Error{code;constructor(e,r){super(extractMessage(e)),this.name="Exception",this.code=r}toString(){return encodeError(this.message,this.code)}[Symbol.toPrimitive](e){return"string"===e||"default"===e?this.toString():null}}

package/dist/index.d.ts

@@ -1,45 +1,8 @@
 import { IErrorCode, IDecodedError } from './shared/types.js';
-/**------------------------------------------------------------------------------------------------
- * General errors
- -------------------------------------------------------------------------------------------------*/
+import { DEFAULT_CODE, DEFAULT_MESSAGE } from './shared/constants.js';
+import { decodeError, encodeError, extractMessage, isDefaultErrorMessage, isEncodedError } from './error-handler/index.js';
+import { Exception } from './exception/index.js';
 /**
- * Attempts to extract an error message from an error that could be anything. If it fails to do so,
- * it returns the default message.
- * @param error The error to extract the message from.
- * @returns A string containing the extracted message or the default message if extraction fails.
+ * Module exports
  */
-declare const extractMessage: (error: any) => string;
-/**------------------------------------------------------------------------------------------------
- * Encoding
- -------------------------------------------------------------------------------------------------*/
-/**
- * Given an error in any format, it extracts the message and inserts the code at the end.
- * @param error The error to be encoded, can be of any type.
- * @param code The error code to be wrapped and appended to the message.
- * @returns A string containing the encoded error message.
- */
-declare const encodeError: (error: any, code: IErrorCode) => string;
-/**
- * Given an error, it will extract the encoded message and attempt to decode it. If successful,
- * it separates the error message from the code so it can be shown directly to the user.
- * @param error The error to be decoded, can be of any type.
- * @returns The decoded error, containing the message and the code.
- */
-declare const decodeError: (error: any) => IDecodedError;
-/**
- * Determines if a given error (in any format) is an error encoded by this package.
- * @param error The error to be checked, can be of any type.
- * @returns A boolean indicating whether the error is an encoded error or not.
- */
-declare const isEncodedError: (error: any) => boolean;
-/**------------------------------------------------------------------------------------------------
- * Misc helpers
- -------------------------------------------------------------------------------------------------*/
-/**
- * Verifies if a value matches the default error message used by this package.
- * @param value The value to be checked.
- * @param fullMatch Whether to check for an exact match or a partial match.
- * @returns A boolean indicating whether the value matches the default error message.
- */
-declare const isDefaultErrorMessage: (value: string, fullMatch?: boolean) => value is string;
-export { type IErrorCode, type IDecodedError, extractMessage, encodeError, decodeError, isEncodedError, isDefaultErrorMessage, };
+export { type IErrorCode, type IDecodedError, DEFAULT_MESSAGE, DEFAULT_CODE, extractMessage, encodeError, decodeError, isEncodedError, isDefaultErrorMessage, Exception, };

package/dist/index.js

@@ -1 +1 @@
-import{ZodError}from"zod";import{DEFAULT_CODE,DEFAULT_MESSAGE}from"./shared/constants.js";import{wrapCode,unwrapCode}from"./utils/utils.js";const __extractPathFromZodError=r=>r&&Array.isArray(r.issues)&&r.issues.length&&Array.isArray(r.issues[0].path)&&r.issues[0].path.length?r.issues[0].path.join("."):"Unknown path",__extractZodErrorMessage=r=>r&&Array.isArray(r.issues)&&r.issues.length&&Array.isArray(r.issues[0].path)&&r.issues[0].message?`${r.issues[0].message} (${__extractPathFromZodError(r)})`:DEFAULT_MESSAGE,extractMessage=r=>{if("string"==typeof r&&r.length)return r;if(r instanceof ZodError)return __extractZodErrorMessage(r);if(r instanceof Error&&r.message)return r.cause?`${r.message}; [CAUSE]: ${extractMessage(r.cause)}`:r.message;if(r&&"object"==typeof r){if(r.message)return extractMessage(r.message);if(r.msg)return extractMessage(r.msg);if(r.error)return extractMessage(r.error);if(r.err)return extractMessage(r.err);if(r.errors)return extractMessage(r.errors);if(r.errs)return extractMessage(r.errs);if(r.reason)return extractMessage(r.reason);if(r.reasons)return extractMessage(r.reasons);if(r.issue)return extractMessage(r.issue);if(r.issues)return extractMessage(r.issues);if(r.data)return extractMessage(r.data);try{return JSON.stringify(r)}catch(e){console.error("Error during extractMessage:"),console.error("Original Error: ",r),console.error("JSON.stringify Error:",e)}}return DEFAULT_MESSAGE},encodeError=(r,e)=>`${extractMessage(r)}${wrapCode(e)}`,decodeError=r=>{const e=extractMessage(r),{code:s,startsAt:t}=unwrapCode(e);return{message:t>0?e.slice(0,t):e,code:s}},isEncodedError=r=>decodeError(r).code!==DEFAULT_CODE,isDefaultErrorMessage=(r,e=!1)=>e?r===DEFAULT_MESSAGE:"string"==typeof r&&r.includes(DEFAULT_MESSAGE);export{extractMessage,encodeError,decodeError,isEncodedError,isDefaultErrorMessage};
+import{DEFAULT_CODE,DEFAULT_MESSAGE}from"./shared/constants.js";import{decodeError,encodeError,extractMessage,isDefaultErrorMessage,isEncodedError}from"./error-handler/index.js";import{Exception}from"./exception/index.js";export{DEFAULT_MESSAGE,DEFAULT_CODE,extractMessage,encodeError,decodeError,isEncodedError,isDefaultErrorMessage,Exception};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "error-message-utils",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "The error-message-utils package simplifies error management in your web applications and RESTful APIs. It ensures consistent and scalable handling of error messages, saving you time and effort. Moreover, it gives you the ability to assign custom error codes so all possible cases can be handled accordingly.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -50,6 +50,7 @@
     "typescript": "5.7.2"
   },
   "dependencies": {
+    "@jest/globals": "30.3.0",
     "zod": "4.3.6"
   }
 }