quickbase-js 0.1.0-beta.10

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

@@ -0,0 +1,119 @@
+// tests/vitest/unit/auth/getTempToken.test.ts
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import {
+  createClient,
+  mockFetch,
+  QB_REALM,
+  QB_TABLE_ID_1,
+} from "@tests/setup.ts";
+import { TokenCache } from "../../../../src/tokenCache"; // Corrected path
+import { AuthApi } from "../../../../src/generated/apis/AuthApi";
+
+describe("QuickbaseClient Unit - getTempTokenDBID", () => {
+  let client: ReturnType<typeof createClient>;
+  let tokenCache: TokenCache;
+  let authApi: AuthApi;
+
+  beforeEach(() => {
+    mockFetch.mockClear();
+    tokenCache = new TokenCache();
+    client = createClient(mockFetch, {
+      useTempTokens: true,
+      debug: true,
+      tokenCache,
+    });
+    authApi = new AuthApi(client["configuration"]);
+    vi.spyOn(authApi, "getTempTokenDBIDRaw").mockImplementation(
+      async (params) => {
+        const mockToken = "b123xyz_temp_token";
+        if (params.dbid === QB_TABLE_ID_1) {
+          return {
+            value: () => Promise.resolve({ temporaryAuthorization: mockToken }),
+          } as any;
+        }
+        throw new Error("Unexpected dbid");
+      }
+    );
+  });
+
+  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(
+      new Response(JSON.stringify({ temporaryAuthorization: mockToken }), {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+      })
+    );
+
+    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(
+      new Response(JSON.stringify({ temporaryAuthorization: mockToken }), {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+      })
+    );
+
+    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(
+      new Response(JSON.stringify({ message: "Unauthorized" }), {
+        status: 401,
+        headers: { "Content-Type": "application/json" },
+      })
+    );
+
+    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/retryTempToken401.test.ts

@@ -0,0 +1,95 @@
+// tests/vitest/unit/auth/retryTempToken401.test.ts
+
+import { describe, it, expect, vi } from "vitest";
+import {
+  createClient,
+  mockFetch,
+  QB_REALM,
+  QB_TABLE_ID_1,
+} from "@tests/setup.ts";
+
+describe("QuickbaseClient Unit - Temp Token Retry on 401", () => {
+  it("creates a new token on 401 and retries successfully", async () => {
+    mockFetch
+      .mockResolvedValueOnce(
+        new Response(
+          JSON.stringify({ temporaryAuthorization: "initial_token" }),
+          { status: 200 }
+        )
+      )
+      .mockResolvedValueOnce(
+        new Response(JSON.stringify({ message: "Unauthorized" }), {
+          status: 401,
+        })
+      )
+      .mockResolvedValueOnce(
+        new Response(
+          JSON.stringify({ temporaryAuthorization: "new_token_456" }),
+          { status: 200 }
+        )
+      )
+      .mockResolvedValueOnce(
+        new Response(JSON.stringify([{ id: 1, label: "Field1" }]), {
+          status: 200,
+        })
+      );
+
+    const consoleSpy = vi.spyOn(console, "log");
+    const client = createClient(mockFetch, {
+      realm: QB_REALM,
+      useTempTokens: true,
+      debug: true,
+    });
+
+    const result = await client.getFields({ tableId: QB_TABLE_ID_1 });
+
+    expect(result).toEqual([{ id: 1, label: "Field1" }]);
+    expect(mockFetch).toHaveBeenCalledTimes(4);
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      1,
+      `https://api.quickbase.com/v1/auth/temporary/${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        credentials: "include",
+        method: "GET",
+      })
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      2,
+      `https://api.quickbase.com/v1/fields?tableId=${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        method: "GET",
+        headers: expect.objectContaining({
+          Authorization: "QB-TEMP-TOKEN initial_token",
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          "Content-Type": "application/json",
+        }),
+      })
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      3,
+      `https://api.quickbase.com/v1/auth/temporary/${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        credentials: "include",
+        method: "GET",
+      })
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      4,
+      `https://api.quickbase.com/v1/fields?tableId=${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        method: "GET",
+        headers: expect.objectContaining({
+          Authorization: "QB-TEMP-TOKEN new_token_456",
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          "Content-Type": "application/json",
+        }),
+      })
+    );
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "Authorization error for getFields (temp token), refreshing token:"
+    );
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "[getFields] Retrying with token: new_token_..."
+    );
+  });
+});

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

@@ -0,0 +1,206 @@
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { createClient, mockFetch } from "@tests/setup.ts";
+
+describe("QuickbaseClient - Temp Token Retry Limit", () => {
+  let client: ReturnType<typeof createClient>;
+
+  beforeEach(() => {
+    mockFetch.mockClear();
+  });
+
+  it("exhausts retries after maxRetries (3) and throws an error", async () => {
+    client = createClient(mockFetch, {
+      useTempTokens: true,
+      debug: true,
+      maxRetries: 3,
+    });
+
+    const mockDbid = "mockDbid123";
+    let callCount = 0;
+
+    mockFetch.mockImplementation((url) => {
+      callCount++;
+      if (url.includes("auth/temporary") && callCount === 1) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ temporaryAuthorization: "token_1" }),
+        });
+      }
+      if (url.includes("fields") && callCount === 2) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ message: "Unauthorized 1" }),
+        });
+      }
+      if (url.includes("auth/temporary") && callCount === 3) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ temporaryAuthorization: "token_2" }),
+        });
+      }
+      if (url.includes("fields") && callCount === 4) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ message: "Unauthorized 2" }),
+        });
+      }
+      if (url.includes("auth/temporary") && callCount === 5) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ temporaryAuthorization: "token_3" }),
+        });
+      }
+      if (url.includes("fields") && callCount === 6) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ message: "Unauthorized 3" }),
+        });
+      }
+      if (url.includes("auth/temporary") && callCount === 7) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ temporaryAuthorization: "token_4" }),
+        });
+      }
+      if (url.includes("fields") && callCount === 8) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ message: "Unauthorized 4" }),
+        });
+      }
+      console.log(
+        `[mockFetch] Unexpected call: ${url}, callCount: ${callCount}`
+      );
+      return Promise.reject(new Error(`Unexpected fetch call: ${url}`));
+    });
+
+    const consoleSpy = vi.spyOn(console, "log");
+
+    await expect(client.getFields({ tableId: mockDbid })).rejects.toThrow(
+      "API Error: Unauthorized 4 (Status: 401)"
+    );
+
+    expect(mockFetch).toHaveBeenCalledTimes(8);
+    // Rest of assertions...
+  });
+
+  it("exhausts retries after maxRetries (2) and throws an error", async () => {
+    client = createClient(mockFetch, {
+      useTempTokens: true,
+      debug: true,
+      maxRetries: 2,
+    });
+
+    const mockDbid = "mockDbid123";
+    let callCount = 0;
+
+    mockFetch.mockImplementation((url) => {
+      callCount++;
+      if (url.includes("auth/temporary") && callCount === 1) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ temporaryAuthorization: "token_1" }),
+        });
+      }
+      if (url.includes("fields") && callCount === 2) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ message: "Unauthorized 1" }),
+        });
+      }
+      if (url.includes("auth/temporary") && callCount === 3) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ temporaryAuthorization: "token_2" }),
+        });
+      }
+      if (url.includes("fields") && callCount === 4) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ message: "Unauthorized 2" }),
+        });
+      }
+      if (url.includes("auth/temporary") && callCount === 5) {
+        return Promise.resolve({
+          ok: true,
+          status: 200,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ temporaryAuthorization: "token_3" }),
+        });
+      }
+      if (url.includes("fields") && callCount === 6) {
+        return Promise.resolve({
+          ok: false,
+          status: 401,
+          headers: new Headers({ "Content-Type": "application/json" }),
+          json: () => Promise.resolve({ message: "Unauthorized 3" }),
+        });
+      }
+      console.log(
+        `[mockFetch] Unexpected call: ${url}, callCount: ${callCount}`
+      );
+      return Promise.reject(new Error(`Unexpected fetch call: ${url}`));
+    });
+
+    const consoleSpy = vi.spyOn(console, "log");
+
+    await expect(client.getFields({ tableId: mockDbid })).rejects.toThrow(
+      "API Error: Unauthorized 3 (Status: 401)"
+    );
+
+    expect(mockFetch).toHaveBeenCalledTimes(6);
+
+    const tokenLogs = consoleSpy.mock.calls.filter((call) =>
+      call[0].includes("Fetched and cached new token")
+    );
+    expect(tokenLogs).toHaveLength(3);
+    expect(tokenLogs).toContainEqual([
+      "Fetched and cached new token for dbid: mockDbid123",
+      "token_1",
+    ]);
+    expect(tokenLogs).toContainEqual([
+      "Fetched and cached new token for dbid: mockDbid123",
+      "token_2",
+    ]);
+    expect(tokenLogs).toContainEqual([
+      "Fetched and cached new token for dbid: mockDbid123",
+      "token_3",
+    ]);
+
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "Authorization error for getFields (temp token), refreshing token:"
+    );
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "[getFields] Retrying with token: token_2..."
+    );
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "[getFields] Retrying with token: token_3..."
+    );
+
+    consoleSpy.mockRestore();
+  });
+});

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

@@ -0,0 +1,69 @@
+// tests/vitest/unit/auth/retryUserToken401.test.ts
+
+import { describe, it, expect, vi } from "vitest";
+import {
+  createClient,
+  mockFetch,
+  QB_REALM,
+  QB_TABLE_ID_1,
+} from "@tests/setup.ts";
+
+describe("QuickbaseClient Unit - User Token Retry on 401", () => {
+  it("retries with the same user token on 401 and succeeds", async () => {
+    const userToken = "b9f3pk_q4jd_0_b4qu5eebyvuix3xs57ysd7zn3";
+    mockFetch
+      .mockResolvedValueOnce(
+        new Response(JSON.stringify({ message: "Unauthorized" }), {
+          status: 401,
+        })
+      )
+      .mockResolvedValueOnce(
+        new Response(JSON.stringify([{ id: 1, label: "Field1" }]), {
+          status: 200,
+        })
+      );
+
+    const consoleSpy = vi.spyOn(console, "log");
+    const client = createClient(mockFetch, {
+      realm: QB_REALM,
+      userToken,
+      useTempTokens: false,
+      debug: true,
+    });
+
+    const result = await client.getFields({ tableId: QB_TABLE_ID_1 });
+
+    expect(result).toEqual([{ id: 1, label: "Field1" }]);
+    expect(mockFetch).toHaveBeenCalledTimes(2);
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      1,
+      `https://api.quickbase.com/v1/fields?tableId=${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        method: "GET",
+        headers: expect.objectContaining({
+          Authorization: `QB-USER-TOKEN ${userToken}`,
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          "Content-Type": "application/json",
+        }),
+      })
+    );
+    expect(mockFetch).toHaveBeenNthCalledWith(
+      2,
+      `https://api.quickbase.com/v1/fields?tableId=${QB_TABLE_ID_1}`,
+      expect.objectContaining({
+        method: "GET",
+        headers: expect.objectContaining({
+          Authorization: `QB-USER-TOKEN ${userToken}`,
+          "QB-Realm-Hostname": `${QB_REALM}.quickbase.com`,
+          "Content-Type": "application/json",
+        }),
+      })
+    );
+    expect(consoleSpy).toHaveBeenCalledWith(
+      `Retrying getFields with existing user token: b9f3pk_q4j...`
+    );
+    expect(consoleSpy).toHaveBeenCalledWith(
+      "[getFields] Retrying with token: b9f3pk_q4j..."
+    );
+  });
+});