@imcms/core 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imcms/core",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -31,6 +31,9 @@
     "tsx": "^4.23.15",
     "typescript": "^5.9.3"
   },
+  "dependencies": {
+    "zod": "^4.6.7"
+  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   }

package/src/formatZodError.ts

@@ -0,0 +1,35 @@
+import type { ZodError, ZodIssue } from "zod";
+
+export interface FormatZodErrorOptions {
+    /**
+     * Prefixo exibido no início de cada linha de erro.
+     * @default "  • "
+     */
+    prefix?: string;
+}
+
+/**
+ * Formata um erro do Zod (ZodError ou array de ZodIssue) em uma string legível para logs e terminal.
+ * 
+ * Exemplo de saída:
+ *   • [PORT]: Expected number, received string
+ *   • [DATABASE_URL]: Required
+ */
+export function formatZodError(
+    error: ZodError | ZodIssue[],
+    options: FormatZodErrorOptions = {}
+): string {
+    const { prefix = "  • " } = options;
+    const issues = Array.isArray(error) ? error : error.issues;
+
+    if (!issues || issues.length === 0) {
+        return `${prefix}Erro de validação desconhecido.`;
+    }
+
+    return issues
+        .map((issue) => {
+            const path = issue.path.length > 0 ? issue.path.join(".") : "ENV";
+            return `${prefix}[${path}]: ${issue.message}`;
+        })
+        .join("\n");
+}