refactor: improve error messages

Author: joaotonaco

.changeset/angry-terms-tie.md

@@ -0,0 +1,5 @@
+---
+"@solufy/evolution-sdk": minor
+---
+
+Improved error messages

src/api/error.ts

@@ -0,0 +1,65 @@
+import { z } from "zod";
+
+export class EvolutionApiError extends Error {
+	constructor(message: string, cause?: unknown) {
+		const error = getErrorMessage(cause);
+
+		super(message, error ? undefined : { cause });
+
+		this.name = EvolutionApiError.name;
+		this.message = error ?? message;
+	}
+}
+
+const ErrorMessages = [
+	ErrorMessage(
+		z.object({
+			message: z.array(
+				z.object({
+					exists: z.literal(false),
+					jid: z.string(),
+					number: z.string(),
+				}),
+			),
+		}),
+		"Provided number is not a valid WhatsApp number",
+	),
+	ErrorMessage(
+		z.object({
+			message: z.array(z.string().includes("Media upload failed on all hosts")),
+		}),
+		"Media upload failed on all hosts",
+	),
+	ErrorMessage(
+		z.object({
+			message: z.array(z.string().includes("AxiosError")),
+		}),
+		(response) => response.message[0],
+	),
+	ErrorMessage(
+		z.object({
+			message: z.array(z.string().includes("No session")),
+		}),
+		"No session found, try restarting your instance",
+	),
+];
+
+function getErrorMessage(response: unknown) {
+	const error = ErrorMessages.find(
+		(message) => message.schema.safeParse(response).success,
+	);
+
+	return error
+		? typeof error.message === "string"
+			? error.message
+			: // biome-ignore lint/suspicious/noExplicitAny: Generic
+				error.message(response as any)
+		: undefined;
+}
+
+function ErrorMessage<T extends z.ZodType>(
+	schema: T,
+	message: string | ((data: z.infer<T>) => string),
+) {
+	return { schema, message };
+}

src/api/errors.ts

@@ -1,7 +1,7 @@
 import type { ClientOptions } from "@/schemas/client";
 import type { APIRequestInit } from "@/types/api";
 
-import { EvolutionApiError } from "./error";
+import { EvolutionApiError } from "./errors";
 
 export class ApiService {
 	constructor(private readonly options: ClientOptions) {}

src/api/service.ts

@@ -37,7 +37,7 @@ export class EvolutionClient {
 	}
 }
 
-export { EvolutionApiError } from "./api/error";
+export { EvolutionApiError } from "./api/errors";
 export { ChatId, GroupJid, Jid, MessageId } from "./types/tags";
 export { phoneNumberFromJid } from "./utils/phone-numer-from-jid";