quickbase-js 0.1.0-beta.7

package/tests/vitest/unit/apps/deleteApp.test.ts

@@ -0,0 +1,216 @@
+// tests/vitest/unit/apps/deleteApp.test.ts
+
+import { describe, it, expect, beforeEach } from "vitest";
+import {
+  createClient,
+  mockFetch,
+  QB_APP_ID,
+  QB_REALM,
+  QB_USER_TOKEN,
+} from "@tests/setup.ts";
+import { DeleteAppRequest, DeleteApp200Response } from "@/generated/models";
+
+describe("QuickbaseClient Unit - deleteApp", () => {
+  let client: ReturnType<typeof createClient>;
+
+  beforeEach(() => {
+    mockFetch.mockClear();
+  });
+
+  it("initializes without errors", () => {
+    client = createClient(mockFetch, { debug: true });
+    expect(client).toBeDefined();
+  });
+
+  it("has deleteApp method", () => {
+    client = createClient(mockFetch, { debug: true });
+    expect(typeof client.deleteApp).toBe("function");
+  });
+
+  it("calls deleteApp successfully with user token", async () => {
+    client = createClient(mockFetch, { debug: true });
+
+    const request: DeleteAppRequest = {
+      name: "App to Delete",
+    };
+
+    const mockResponse: DeleteApp200Response = {
+      deletedAppId: QB_APP_ID,
+    };
+
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      status: 200,
+      json: () => Promise.resolve(mockResponse),
+    });
+
+    const result = await client.deleteApp({ appId: QB_APP_ID, body: request });
+
+    expect(result).toEqual(mockResponse);
+    expect(mockFetch).toHaveBeenCalledWith(
+      `https://api.quickbase.com/v1/apps/${QB_APP_ID}`,
+      expect.objectContaining({
+        method: "DELETE",
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          Authorization: `QB-USER-TOKEN ${QB_USER_TOKEN}`,
+          "Content-Type": "application/json",
+        }),
+        body: JSON.stringify(request),
+      })
+    );
+  });
+
+  it("calls deleteApp successfully with temp token", async () => {
+    client = createClient(mockFetch, { useTempTokens: true, debug: true });
+
+    const request: DeleteAppRequest = {
+      name: "App to Delete with Temp Token",
+    };
+
+    const mockResponse: DeleteApp200Response = {
+      deletedAppId: QB_APP_ID,
+    };
+
+    mockFetch
+      .mockResolvedValueOnce({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve({ temporaryAuthorization: "temp_token" }),
+      })
+      .mockResolvedValueOnce({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve(mockResponse),
+      });
+
+    const result = await client.deleteApp({ appId: QB_APP_ID, body: request });
+
+    expect(result).toEqual(mockResponse);
+    expect(mockFetch).toHaveBeenCalledTimes(2);
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      1,
+      `https://api.quickbase.com/v1/auth/temporary/${QB_APP_ID}`,
+      expect.objectContaining({
+        method: "GET",
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          "Content-Type": "application/json",
+        }),
+        credentials: "include",
+      })
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      2,
+      `https://api.quickbase.com/v1/apps/${QB_APP_ID}`,
+      expect.objectContaining({
+        method: "DELETE",
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          Authorization: "QB-TEMP-TOKEN temp_token",
+          "Content-Type": "application/json",
+        }),
+        body: JSON.stringify(request),
+      })
+    );
+  });
+
+  it("retries successfully after 401 with temp token", async () => {
+    client = createClient(mockFetch, { useTempTokens: true, debug: true });
+
+    const request: DeleteAppRequest = {
+      name: "Retry Delete App",
+    };
+
+    const mockResponse: DeleteApp200Response = {
+      deletedAppId: QB_APP_ID,
+    };
+
+    mockFetch
+      .mockResolvedValueOnce({
+        ok: true,
+        status: 200,
+        json: () =>
+          Promise.resolve({ temporaryAuthorization: "initial_token" }),
+      })
+      .mockResolvedValueOnce({
+        ok: false,
+        status: 401,
+        json: () => Promise.resolve({ message: "Unauthorized" }),
+      })
+      .mockResolvedValueOnce({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve({ temporaryAuthorization: "new_token" }),
+      })
+      .mockResolvedValueOnce({
+        ok: true,
+        status: 200,
+        json: () => Promise.resolve(mockResponse),
+      });
+
+    const result = await client.deleteApp({ appId: QB_APP_ID, body: request });
+
+    expect(result).toEqual(mockResponse);
+    expect(mockFetch).toHaveBeenCalledTimes(4);
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      1,
+      `https://api.quickbase.com/v1/auth/temporary/${QB_APP_ID}`,
+      expect.any(Object)
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      2,
+      `https://api.quickbase.com/v1/apps/${QB_APP_ID}`,
+      expect.objectContaining({
+        headers: expect.objectContaining({
+          Authorization: "QB-TEMP-TOKEN initial_token",
+        }),
+      })
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      3,
+      `https://api.quickbase.com/v1/auth/temporary/${QB_APP_ID}`,
+      expect.any(Object)
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      4,
+      `https://api.quickbase.com/v1/apps/${QB_APP_ID}`,
+      expect.objectContaining({
+        headers: expect.objectContaining({
+          Authorization: "QB-TEMP-TOKEN new_token",
+        }),
+      })
+    );
+  });
+
+  it("handles 400 error for invalid request", async () => {
+    client = createClient(mockFetch, { debug: true });
+
+    const request: DeleteAppRequest = {
+      name: "Wrong Name",
+    };
+
+    mockFetch.mockResolvedValueOnce({
+      ok: false,
+      status: 400,
+      json: () => Promise.resolve({ message: "Invalid application name" }),
+    });
+
+    await expect(
+      client.deleteApp({ appId: QB_APP_ID, body: request })
+    ).rejects.toThrow("API Error: Invalid application name (Status: 400)");
+
+    expect(mockFetch).toHaveBeenCalledWith(
+      `https://api.quickbase.com/v1/apps/${QB_APP_ID}`,
+      expect.objectContaining({
+        method: "DELETE",
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          Authorization: `QB-USER-TOKEN ${QB_USER_TOKEN}`,
+          "Content-Type": "application/json",
+        }),
+        body: JSON.stringify(request),
+      })
+    );
+  });
+});

package/tests/vitest/unit/apps/getApp.test.ts

@@ -0,0 +1,128 @@
+// tests/vitest/unit/apps/getApp.test.ts
+
+import { describe, it, expect, beforeEach } from "vitest";
+import {
+  createClient,
+  mockFetch,
+  QB_APP_ID,
+  QB_REALM,
+  QB_USER_TOKEN,
+} from "@tests/setup.ts";
+
+describe("QuickbaseClient Unit - getApp", () => {
+  let client: ReturnType<typeof createClient>;
+
+  beforeEach(() => {
+    mockFetch.mockClear();
+  });
+
+  it("initializes without errors", () => {
+    client = createClient(mockFetch, { debug: true });
+    expect(client).toBeDefined();
+  });
+
+  it("has getApp method", () => {
+    client = createClient(mockFetch, { debug: true });
+    expect(typeof client.getApp).toBe("function");
+  });
+
+  it("calls getApp successfully with dates as Date objects", async () => {
+    client = createClient(mockFetch, { debug: true });
+
+    const mockResponse = {
+      id: QB_APP_ID,
+      name: "qb-copy",
+      created: new Date("2025-02-13T18:22:33Z"), // Expect Date object
+      updated: new Date("2025-03-04T04:25:51Z"), // Expect Date object
+      description: "",
+      timeZone: "(UTC-08:00) Pacific Time (US & Canada)",
+      dateFormat: "MM-DD-YYYY",
+      hasEveryoneOnTheInternet: false,
+      memoryInfo: { estMemory: 0, estMemoryInclDependentApps: 0 },
+      securityProperties: {
+        allowClone: false,
+        allowExport: true,
+        enableAppTokens: true,
+        hideFromPublic: false,
+        mustBeRealmApproved: false,
+        useIPFilter: false,
+      },
+      ancestorId: undefined,
+      variables: undefined,
+      dataClassification: undefined,
+    };
+
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      status: 200,
+      json: () => Promise.resolve(mockResponse),
+    });
+
+    const result = await client.getApp({ appId: QB_APP_ID });
+
+    expect(result).toEqual(mockResponse);
+    expect(mockFetch).toHaveBeenCalledWith(
+      `https://api.quickbase.com/v1/apps/${QB_APP_ID}`,
+      expect.objectContaining({
+        method: "GET",
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          Authorization: `QB-USER-TOKEN ${QB_USER_TOKEN}`,
+          "Content-Type": "application/json",
+        }),
+        body: undefined,
+        credentials: "omit",
+      })
+    );
+  });
+
+  it("calls getApp successfully with dates as strings", async () => {
+    client = createClient(mockFetch, { debug: true, convertDates: false });
+
+    const mockResponse = {
+      id: QB_APP_ID,
+      name: "qb-copy",
+      created: "2025-02-13T18:22:33Z", // Expect string
+      updated: "2025-03-04T04:25:51Z", // Expect string
+      description: "",
+      timeZone: "(UTC-08:00) Pacific Time (US & Canada)",
+      dateFormat: "MM-DD-YYYY",
+      hasEveryoneOnTheInternet: false,
+      memoryInfo: { estMemory: 0, estMemoryInclDependentApps: 0 },
+      securityProperties: {
+        allowClone: false,
+        allowExport: true,
+        enableAppTokens: true,
+        hideFromPublic: false,
+        mustBeRealmApproved: false,
+        useIPFilter: false,
+      },
+      ancestorId: undefined,
+      variables: undefined,
+      dataClassification: undefined,
+    };
+
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      status: 200,
+      json: () => Promise.resolve(mockResponse),
+    });
+
+    const result = await client.getApp({ appId: QB_APP_ID });
+
+    expect(result).toEqual(mockResponse);
+    expect(mockFetch).toHaveBeenCalledWith(
+      `https://api.quickbase.com/v1/apps/${QB_APP_ID}`,
+      expect.objectContaining({
+        method: "GET",
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          Authorization: `QB-USER-TOKEN ${QB_USER_TOKEN}`,
+          "Content-Type": "application/json",
+        }),
+        body: undefined,
+        credentials: "omit",
+      })
+    );
+  });
+});

package/tests/vitest/unit/auth/fetchTempToken401.test.ts

@@ -0,0 +1,82 @@
+// tests/vitest/unit/auth/fetchTempToken401.test.ts
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import {
+  createClient,
+  mockFetch,
+  QB_REALM,
+  QB_TABLE_ID_1,
+} from "@tests/setup.ts";
+
+describe("QuickbaseClient Unit - 401 with fetchTempToken 401", () => {
+  let client: ReturnType<typeof createClient>;
+
+  beforeEach(() => {
+    mockFetch.mockClear();
+    client = createClient(mockFetch, { useTempTokens: true, debug: true });
+  });
+
+  it("fails without infinite loop when fetchTempToken returns 401 after initial 401", async () => {
+    let callCount = 0;
+
+    mockFetch.mockImplementation((url) => {
+      callCount++;
+      if (url.includes("auth/temporary") && callCount === 1) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          json: () =>
+            Promise.resolve({ temporaryAuthorization: "initial_token" }),
+        });
+      }
+      if (url.includes("fields") && callCount === 2) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          json: () => Promise.resolve({ message: "Unauthorized" }),
+        });
+      }
+      if (url.includes("auth/temporary") && callCount === 3) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          json: () =>
+            Promise.resolve({ message: "Unauthorized in fetchTempToken" }),
+        });
+      }
+      return Promise.reject(new Error(`Unexpected fetch call: ${url}`));
+    });
+
+    const consoleSpy = vi.spyOn(console, "log");
+
+    await expect(client.getFields({ tableId: QB_TABLE_ID_1 })).rejects.toThrow(
+      "API Error: Unauthorized in fetchTempToken (Status: 401)"
+    );
+
+    expect(mockFetch).toHaveBeenCalledTimes(3);
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      1,
+      `https://api.quickbase.com/v1/auth/temporary/${QB_TABLE_ID_1}`,
+      expect.any(Object)
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      2,
+      `https://api.quickbase.com/v1/fields?tableId=${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+        }),
+      })
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      3,
+      `https://api.quickbase.com/v1/auth/temporary/${QB_TABLE_ID_1}`,
+      expect.any(Object)
+    );
+
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "Authorization error for getFields, refreshing token:",
+      expect.any(String)
+    );
+    consoleSpy.mockRestore();
+  });
+});

package/tests/vitest/unit/auth/getTempToken.test.ts

@@ -0,0 +1,95 @@
+// tests/vitest/unit/auth/getTempTokenDBID.test.ts
+import { describe, it, expect, beforeEach } from "vitest";
+import {
+  createClient,
+  mockFetch,
+  QB_REALM,
+  QB_TABLE_ID_1,
+} from "@tests/setup.ts";
+
+describe("QuickbaseClient Unit - getTempTokenDBID", () => {
+  let client: ReturnType<typeof createClient>;
+
+  beforeEach(() => {
+    mockFetch.mockClear();
+    client = createClient(mockFetch, { useTempTokens: true, debug: false });
+  });
+
+  it("initializes without errors", () => {
+    expect(client).toBeDefined();
+  });
+
+  it("has getTempTokenDBID method", () => {
+    expect(typeof client.getTempTokenDBID).toBe("function");
+  });
+
+  it("fetches and caches temp token on first call", async () => {
+    const mockToken = "b123xyz_temp_token";
+
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      status: 200,
+      json: () => Promise.resolve({ temporaryAuthorization: mockToken }),
+    });
+
+    const result = await client.getTempTokenDBID({ dbid: QB_TABLE_ID_1 });
+    expect(result).toEqual({ temporaryAuthorization: mockToken });
+    expect(mockFetch).toHaveBeenCalledWith(
+      `https://api.quickbase.com/v1/auth/temporary/${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        method: "GET",
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          "Content-Type": "application/json",
+        }),
+        credentials: "include",
+      })
+    );
+  });
+
+  it("reuses cached temp token on second call", async () => {
+    const mockToken = "b123xyz_temp_token";
+
+    mockFetch.mockResolvedValueOnce({
+      ok: true,
+      status: 200,
+      json: () => Promise.resolve({ temporaryAuthorization: mockToken }),
+    });
+
+    const firstResult = await client.getTempTokenDBID({ dbid: QB_TABLE_ID_1 });
+    expect(firstResult).toEqual({ temporaryAuthorization: mockToken });
+    expect(mockFetch).toHaveBeenCalledTimes(1);
+
+    mockFetch.mockClear();
+    const secondResult = await client.getTempTokenDBID({ dbid: QB_TABLE_ID_1 });
+    expect(secondResult).toEqual({ temporaryAuthorization: mockToken });
+    expect(mockFetch).not.toHaveBeenCalled();
+  });
+
+  it("handles API error", async () => {
+    mockFetch.mockResolvedValueOnce({
+      ok: false,
+      status: 401,
+      json: () => Promise.resolve({ message: "Unauthorized" }),
+    });
+
+    await expect(
+      client.getTempTokenDBID({ dbid: QB_TABLE_ID_1 })
+    ).rejects.toSatisfy((error: Error) => {
+      expect(error).toBeInstanceOf(Error);
+      expect(error.message).toBe("API Error: Unauthorized (Status: 401)");
+      return true;
+    });
+    expect(mockFetch).toHaveBeenCalledWith(
+      `https://api.quickbase.com/v1/auth/temporary/${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        method: "GET",
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          "Content-Type": "application/json",
+        }),
+        credentials: "include",
+      })
+    );
+  });
+});

package/tests/vitest/unit/auth/retryOn401.test.ts

@@ -0,0 +1,116 @@
+// tests/vitest/unit/auth/retryOn401.test.ts
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import {
+  createClient,
+  mockFetch,
+  QB_REALM,
+  QB_TABLE_ID_1,
+} from "@tests/setup.ts";
+
+describe("QuickbaseClient Unit - 401 Retry Creates New Token", () => {
+  let client: ReturnType<typeof createClient>;
+
+  beforeEach(() => {
+    mockFetch.mockClear();
+    client = createClient(mockFetch, { useTempTokens: true, debug: true });
+  });
+
+  it("creates a new token on 401 and retries successfully", async () => {
+    const mockToken = "new_token_456";
+    const mockFields = [{ id: 1, label: "Field1" }];
+    let callCount = 0;
+
+    // Mock fetch without console.log interference
+    mockFetch.mockImplementation((url) => {
+      callCount++;
+      if (url.includes("auth/temporary") && callCount === 1) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          json: () => Promise.resolve({ temporaryAuthorization: mockToken }),
+        });
+      }
+      if (url.includes("fields") && callCount === 2) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          json: () => Promise.resolve({ message: "Unauthorized" }),
+        });
+      }
+      if (url.includes("auth/temporary") && callCount === 3) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          json: () =>
+            Promise.resolve({ temporaryAuthorization: mockToken + "_retry" }),
+        });
+      }
+      if (url.includes("fields") && callCount === 4) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          json: () => Promise.resolve(mockFields),
+        });
+      }
+      return Promise.reject(new Error(`Unexpected fetch call: ${url}`));
+    });
+
+    const consoleSpy = vi.spyOn(console, "log");
+
+    const result = await client.getFields({ tableId: QB_TABLE_ID_1 });
+
+    expect(result).toEqual(mockFields);
+    expect(mockFetch).toHaveBeenCalledTimes(4);
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      1,
+      `https://api.quickbase.com/v1/auth/temporary/${QB_TABLE_ID_1}`,
+      expect.any(Object)
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      2,
+      `https://api.quickbase.com/v1/fields?tableId=${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+        }),
+      })
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      3,
+      `https://api.quickbase.com/v1/auth/temporary/${QB_TABLE_ID_1}`,
+      expect.any(Object)
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      4,
+      `https://api.quickbase.com/v1/fields?tableId=${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        headers: expect.objectContaining({
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+        }),
+      })
+    );
+
+    // Filter console logs to only those we care about
+    const tokenLogs = consoleSpy.mock.calls.filter((call) =>
+      call[0].includes("Fetched and cached new token")
+    );
+    expect(tokenLogs).toContainEqual([
+      `Fetched and cached new token for dbid: ${QB_TABLE_ID_1}`,
+      mockToken,
+    ]);
+    expect(tokenLogs).toContainEqual([
+      `Fetched and cached new token for dbid: ${QB_TABLE_ID_1}`,
+      mockToken + "_retry",
+    ]);
+
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "Authorization error for getFields, refreshing token:",
+      expect.any(String)
+    );
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "Retrying getFields with new token"
+    );
+
+    consoleSpy.mockRestore();
+  });
+});