Feat/parse invitation

source/errors.ts

@@ -1,3 +1,35 @@
+import type { $ZodIssue } from 'zod/v4/core';
+
+/**
+ * Formats the Zod validation failures into a single string with one line each: "- <field>: <message>" and top level failures
+ * with no field path show as "(root)" for better readability.
+ *
+ * @param issues The Zod validation failures to format.
+ * @returns A human readable error string for better debugging.
+ */
+export const buildErrorDescription = (issues: $ZodIssue[]): string => {
+    // Initialize an empty array to store the formatted lines.
+    const lines: string[] = [];
+
+    // Iterate over the issues and format them into a string.
+    for (const issue of issues) {
+        // Get the issue path.
+        const issuePath = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+
+        // The prefix that Zod adds to messages.
+        const messagePrefix = 'Invalid input: ';
+
+        // Remove the prefix for better readability.
+        const issueMessage = issue.message.startsWith(messagePrefix) ? issue.message.slice(messagePrefix.length) : issue.message;
+
+        // Add the formatted line to the array.
+        lines.push(`- ${issuePath}: ${issueMessage}`);
+    }
+
+    // Return the formatted string.
+    return `\n${lines.join('\n')}`;
+};
+
 /**
  * Error thrown when a waitFor timeout is reached
  */