feat: Use API error messages when throwing errors, whenever possible. (#13)

Author: dlxmj

src/client.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { TursoClient, createClient } from "./client";
+import { TursoClient, TursoClientError, createClient } from "./client";
 
 describe("TursoClient", () => {
   it("should throw an error if no API token is provided", () => {
@@ -17,6 +17,23 @@ describe("TursoClient", () => {
 
     expect(client).toBeInstanceOf(TursoClient);
   });
+
+  it("should throw an error message that will match with API's error message", async () => {
+    const config = { org: "turso", token: "abc" };
+    const client = new TursoClient(config);
+
+    const error = await client.databases
+      .get("databaseName")
+      .catch((err: Error) => err);
+
+    expect(error).toBeInstanceOf(TursoClientError);
+    if (error instanceof TursoClientError) {
+      expect(error.message).toBe(
+        "token contains an invalid number of segments"
+      );
+      expect(error.status).toBe(401);
+    }
+  });
 });
 
 describe("createClient", () => {

src/client.ts

@@ -5,6 +5,23 @@ import { LocationClient } from "./location";
 import { GroupClient } from "./group";
 import { DatabaseClient } from "./database";
 
+interface ApiErrorResponse {
+  error: string;
+}
+
+interface AdditionalInfo {
+  status?: number;
+}
+
+export class TursoClientError extends Error {
+  status?: number;
+  constructor(message: string, additionalInfo?: AdditionalInfo) {
+    super(message);
+    this.name = "TursoClientError";
+    this.status = additionalInfo?.status;
+  }
+}
+
 export class TursoClient {
   private config: TursoConfig;
   public apiTokens: ApiTokenClient;
@@ -45,7 +62,13 @@ export class TursoClient {
     });
 
     if (!response.ok) {
-      throw new Error(`Something went wrong! Status ${response.status}`);
+      const errorResponse = (await response.json().catch(() => {
+        throw new Error(`Something went wrong! Status ${response.status}`);
+      })) as ApiErrorResponse;
+
+      throw new TursoClientError(errorResponse.error, {
+        status: response.status,
+      });
     }
 
     return response.json() as T;