refactor error handling in assertion functions

Author: joaotonaco

src/assertions/application.ts

@@ -27,10 +27,11 @@ export function assertApplication(
 ): asserts value is z.infer<typeof applicationSchema> {
 	try {
 		applicationSchema.parse(value);
-	} catch {
+	} catch (err) {
 		throw new SquareCloudAPIError(
 			"INVALID_API_APPLICATION",
 			"Invalid application object received from API /apps/{app_id}",
+			{ cause: err.errors },
 		);
 	}
 }
@@ -40,10 +41,11 @@ export function assertWebsiteApplication(
 ): asserts value is z.infer<typeof websiteApplicationSchema> {
 	try {
 		websiteApplicationSchema.parse(value);
-	} catch {
+	} catch (err) {
 		throw new SquareCloudAPIError(
 			"INVALID_API_WEBSITE_APPLICATION",
 			"Invalid website application object received from API /apps/{app_id}",
+			{ cause: err.errors },
 		);
 	}
 }

src/assertions/status.ts

@@ -40,10 +40,11 @@ export function assertSimpleStatus(
 ): asserts value is z.infer<typeof simpleStatusSchema> {
 	try {
 		simpleStatusSchema.parse(value);
-	} catch {
+	} catch (err) {
 		throw new SquareCloudAPIError(
 			"INVALID_API_STATUS_ALL",
 			"Invalid simple status object received from API /apps/all/status",
+			{ cause: err.errors },
 		);
 	}
 }
@@ -53,10 +54,11 @@ export function assertStatus(
 ): asserts value is z.infer<typeof statusSchema> {
 	try {
 		statusSchema.parse(value);
-	} catch {
+	} catch (err) {
 		throw new SquareCloudAPIError(
 			"INVALID_API_STATUS",
 			"Invalid status object received from API /apps/{app_id}/status",
+			{ cause: err.errors },
 		);
 	}
 }

src/assertions/user.ts

@@ -42,10 +42,11 @@ export function assertUserInfo(
 ): asserts value is z.infer<typeof userInfoSchema> {
 	try {
 		userInfoSchema.parse(value);
-	} catch {
+	} catch (err) {
 		throw new SquareCloudAPIError(
 			"INVALID_API_USER_INFO",
 			"Invalid user info object received from API /user",
+			{ cause: err.errors },
 		);
 	}
 }

src/structures/error.ts

@@ -1,5 +1,9 @@
 export class SquareCloudAPIError extends TypeError {
-	constructor(code: string, message?: string) {
+	constructor(
+		code: string,
+		message?: string,
+		options?: { stack?: string; cause?: unknown },
+	) {
 		super(code);
 
 		this.name = "SquareCloudAPIError";
@@ -10,5 +14,13 @@ export class SquareCloudAPIError extends TypeError {
 				.toLowerCase()
 				.replace(/(^|\s)\S/g, (L) => L.toUpperCase()) || "UNKNOWN_CODE") +
 			(message ? `: ${message}` : "");
+
+		if (options?.stack) {
+			this.stack = options.stack;
+		}
+
+		if (options?.cause) {
+			this.cause = options.cause;
+		}
 	}
 }