@devua-lab/error-serialization 1.0.2 → 1.0.5

package/dist/index.cjs

@@ -27,7 +27,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/contants.ts
+// src/constants.ts
 var ErrorPriority = {
   /**
    * Fallback priority for unhandled errors
@@ -144,20 +144,48 @@ var AxiosErrorPlugin = class extends ErrorPlugin {
     return (0, import_axios.isAxiosError)(error);
   }
   /**
-   * Maps HTTP response details to the global schema
+   * Maps HTTP response details to the global schema.
+   * Flattens any nested validation error structures into a single-level object.
    */
   serialize(error) {
     const responseData = error.response?.data;
     const backendMessage = responseData?.message || responseData?.error?.message;
     const backendCode = responseData?.code || responseData?.errorCode;
+    const rawValidation = responseData?.validationErrors || responseData?.errors;
+    const validation = rawValidation ? this.flatten(rawValidation) : void 0;
     const finalMessage = backendMessage || error.message || "Network Error";
     const finalCodes = backendCode ? Array.isArray(backendCode) ? backendCode : [String(backendCode)] : [`HTTP_${error.response?.status || 0}`];
     return this.createResponse(error, {
       global: finalMessage,
       code: finalCodes,
-      status: error.response?.status || 0
+      status: error.response?.status || 0,
+      validation
     });
   }
+  /**
+   * Recursively flattens a nested object into a flat record with dot-separated keys.
+   * Traverses nested objects but keeps arrays as leaf values.
+   * If an array has exactly one element, it returns the element itself.
+   */
+  flatten(obj, prefix = "") {
+    return Object.keys(obj).reduce((acc, k) => {
+      const path = prefix ? `${prefix}.${k}` : k;
+      const value = obj[k];
+      if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        Object.assign(
+          acc,
+          this.flatten(value, path)
+        );
+      } else {
+        if (Array.isArray(value) && value.length === 1) {
+          acc[path] = value[0];
+        } else {
+          acc[path] = value;
+        }
+      }
+      return acc;
+    }, {});
+  }
 };
 
 // src/plugins/StandardErrorPlugin.ts

package/dist/index.d.cts

@@ -154,6 +154,11 @@ declare class ErrorSerializer {
 
 /**
  * Plugin for handling Axios errors and extracting server-side data.
+ * Supports extraction of messages, error codes, and recursive validation errors
+ * which are automatically flattened into a dot-notation structure.
+ *
+ * Special behavior: If a validation field contains an array with a single value,
+ * it will be extracted as a direct value instead of an array.
  */
 declare class AxiosErrorPlugin extends ErrorPlugin<AxiosError> {
     /**
@@ -166,9 +171,16 @@ declare class AxiosErrorPlugin extends ErrorPlugin<AxiosError> {
      */
     match(error: unknown): error is AxiosError;
     /**
-     * Maps HTTP response details to the global schema
+     * Maps HTTP response details to the global schema.
+     * Flattens any nested validation error structures into a single-level object.
      */
     serialize(error: AxiosError): AppErrorResponse;
+    /**
+     * Recursively flattens a nested object into a flat record with dot-separated keys.
+     * Traverses nested objects but keeps arrays as leaf values.
+     * If an array has exactly one element, it returns the element itself.
+     */
+    private flatten;
 }
 
 /**

package/dist/index.d.ts

@@ -154,6 +154,11 @@ declare class ErrorSerializer {
 
 /**
  * Plugin for handling Axios errors and extracting server-side data.
+ * Supports extraction of messages, error codes, and recursive validation errors
+ * which are automatically flattened into a dot-notation structure.
+ *
+ * Special behavior: If a validation field contains an array with a single value,
+ * it will be extracted as a direct value instead of an array.
  */
 declare class AxiosErrorPlugin extends ErrorPlugin<AxiosError> {
     /**
@@ -166,9 +171,16 @@ declare class AxiosErrorPlugin extends ErrorPlugin<AxiosError> {
      */
     match(error: unknown): error is AxiosError;
     /**
-     * Maps HTTP response details to the global schema
+     * Maps HTTP response details to the global schema.
+     * Flattens any nested validation error structures into a single-level object.
      */
     serialize(error: AxiosError): AppErrorResponse;
+    /**
+     * Recursively flattens a nested object into a flat record with dot-separated keys.
+     * Traverses nested objects but keeps arrays as leaf values.
+     * If an array has exactly one element, it returns the element itself.
+     */
+    private flatten;
 }
 
 /**

package/dist/index.js

@@ -1,4 +1,4 @@
-// src/contants.ts
+// src/constants.ts
 var ErrorPriority = {
   /**
    * Fallback priority for unhandled errors
@@ -115,20 +115,48 @@ var AxiosErrorPlugin = class extends ErrorPlugin {
     return isAxiosError(error);
   }
   /**
-   * Maps HTTP response details to the global schema
+   * Maps HTTP response details to the global schema.
+   * Flattens any nested validation error structures into a single-level object.
    */
   serialize(error) {
     const responseData = error.response?.data;
     const backendMessage = responseData?.message || responseData?.error?.message;
     const backendCode = responseData?.code || responseData?.errorCode;
+    const rawValidation = responseData?.validationErrors || responseData?.errors;
+    const validation = rawValidation ? this.flatten(rawValidation) : void 0;
     const finalMessage = backendMessage || error.message || "Network Error";
     const finalCodes = backendCode ? Array.isArray(backendCode) ? backendCode : [String(backendCode)] : [`HTTP_${error.response?.status || 0}`];
     return this.createResponse(error, {
       global: finalMessage,
       code: finalCodes,
-      status: error.response?.status || 0
+      status: error.response?.status || 0,
+      validation
     });
   }
+  /**
+   * Recursively flattens a nested object into a flat record with dot-separated keys.
+   * Traverses nested objects but keeps arrays as leaf values.
+   * If an array has exactly one element, it returns the element itself.
+   */
+  flatten(obj, prefix = "") {
+    return Object.keys(obj).reduce((acc, k) => {
+      const path = prefix ? `${prefix}.${k}` : k;
+      const value = obj[k];
+      if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        Object.assign(
+          acc,
+          this.flatten(value, path)
+        );
+      } else {
+        if (Array.isArray(value) && value.length === 1) {
+          acc[path] = value[0];
+        } else {
+          acc[path] = value;
+        }
+      }
+      return acc;
+    }, {});
+  }
 };
 
 // src/plugins/StandardErrorPlugin.ts

package/package.json

@@ -1,57 +1,57 @@
 {
-	"name": "@devua-lab/error-serialization",
-	"version": "1.0.2",
-	"type": "module",
-	"main": "./dist/index.cjs",
-	"module": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"import": {
-				"types": "./dist/index.d.ts",
-				"default": "./dist/index.js"
-			},
-			"require": {
-				"types": "./dist/index.d.cts",
-				"default": "./dist/index.cjs"
-			}
-		}
-	},
-	"scripts": {
-		"build": "tsup src/index.ts --format cjs,esm --dts --clean",
-		"dev": "tsup src/index.ts --format cjs,esm --watch --dts",
-		"format": "biome format --write .",
-		"lint": "biome lint .",
-		"check": "biome check --write .",
-		"ci": "biome ci .",
-		"test": "vitest",
-		"test:run": "vitest run",
-		"test:cov": "vitest run --coverage"
-	},
-	"devDependencies": {
-		"@biomejs/biome": "2.3.14",
-		"@types/node": "^25.2.2",
-		"axios": "^1.13.5",
-		"tsup": "^8.5.1",
-		"typescript": "^5.9.3",
-		"vite": "^7.3.1",
-		"vitest": "^4.0.18",
-		"zod": "^4.3.6"
-	},
-	"peerDependencies": {
-		"axios": ">=1.0.0",
-		"zod": ">=3.0.0"
-	},
-	"peerDependenciesMeta": {
-		"axios": {
-			"optional": true
-		},
-		"zod": {
-			"optional": true
-		}
-	},
-	"files": [
-		"dist",
-		"README.md"
-	]
+  "name": "@devua-lab/error-serialization",
+  "version": "1.0.5",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --watch --dts",
+    "format": "biome format --write .",
+    "lint": "biome lint .",
+    "check": "biome check --write .",
+    "ci": "biome ci .",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:cov": "vitest run --coverage"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.14",
+    "@types/node": "^25.2.2",
+    "axios": "^1.13.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.18",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "axios": ">=1.0.0",
+    "zod": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "axios": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
 }