quickbase-js 0.1.0-beta.9 → 1.0.0

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

@@ -1,119 +0,0 @@
-// 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

@@ -1,95 +0,0 @@
-// 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

@@ -1,235 +0,0 @@
-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, // Explicitly set maxRetries to 3
-    });
-
-    const mockDbid = "mockDbid123";
-    let callCount = 0;
-
-    mockFetch.mockImplementation((url) => {
-      callCount++;
-      // Initial temp token fetch
-      if (url.includes("auth/temporary") && callCount === 1) {
-        return Promise.resolve({
-          ok: true,
-          status: 200,
-          json: () => Promise.resolve({ temporaryAuthorization: "token_1" }),
-        });
-      }
-      // First attempt: 401
-      if (url.includes("fields") && callCount === 2) {
-        return Promise.resolve({
-          ok: false,
-          status: 401,
-          json: () => Promise.resolve({ message: "Unauthorized 1" }),
-        });
-      }
-      // Second temp token fetch
-      if (url.includes("auth/temporary") && callCount === 3) {
-        return Promise.resolve({
-          ok: true,
-          status: 200,
-          json: () => Promise.resolve({ temporaryAuthorization: "token_2" }),
-        });
-      }
-      // Second attempt: 401
-      if (url.includes("fields") && callCount === 4) {
-        return Promise.resolve({
-          ok: false,
-          status: 401,
-          json: () => Promise.resolve({ message: "Unauthorized 2" }),
-        });
-      }
-      // Third temp token fetch
-      if (url.includes("auth/temporary") && callCount === 5) {
-        return Promise.resolve({
-          ok: true,
-          status: 200,
-          json: () => Promise.resolve({ temporaryAuthorization: "token_3" }),
-        });
-      }
-      // Third attempt: 401
-      if (url.includes("fields") && callCount === 6) {
-        return Promise.resolve({
-          ok: false,
-          status: 401,
-          json: () => Promise.resolve({ message: "Unauthorized 3" }),
-        });
-      }
-      // Fourth temp token fetch
-      if (url.includes("auth/temporary") && callCount === 7) {
-        return Promise.resolve({
-          ok: true,
-          status: 200,
-          json: () => Promise.resolve({ temporaryAuthorization: "token_4" }),
-        });
-      }
-      // Fourth attempt: 401
-      if (url.includes("fields") && callCount === 8) {
-        return Promise.resolve({
-          ok: false,
-          status: 401,
-          json: () => Promise.resolve({ message: "Unauthorized 4" }),
-        });
-      }
-      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); // 4 token fetches + 4 API attempts
-
-    const tokenLogs = consoleSpy.mock.calls.filter((call) =>
-      call[0].includes("Fetched and cached new token")
-    );
-    expect(tokenLogs).toHaveLength(4);
-    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(tokenLogs).toContainEqual([
-      "Fetched and cached new token for dbid: mockDbid123",
-      "token_4",
-    ]);
-
-    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..."
-    );
-    expect(consoleSpy).toHaveBeenCalledWith(
-      "[getFields] Retrying with token: token_4..."
-    );
-
-    consoleSpy.mockRestore();
-  });
-
-  it("exhausts retries after maxRetries (2) and throws an error", async () => {
-    client = createClient(mockFetch, {
-      useTempTokens: true,
-      debug: true,
-      maxRetries: 2, // Explicitly set maxRetries to 2
-    });
-
-    const mockDbid = "mockDbid123";
-    let callCount = 0;
-
-    mockFetch.mockImplementation((url) => {
-      callCount++;
-      // Initial temp token fetch
-      if (url.includes("auth/temporary") && callCount === 1) {
-        return Promise.resolve({
-          ok: true,
-          status: 200,
-          json: () => Promise.resolve({ temporaryAuthorization: "token_1" }),
-        });
-      }
-      // First attempt: 401
-      if (url.includes("fields") && callCount === 2) {
-        return Promise.resolve({
-          ok: false,
-          status: 401,
-          json: () => Promise.resolve({ message: "Unauthorized 1" }),
-        });
-      }
-      // Second temp token fetch
-      if (url.includes("auth/temporary") && callCount === 3) {
-        return Promise.resolve({
-          ok: true,
-          status: 200,
-          json: () => Promise.resolve({ temporaryAuthorization: "token_2" }),
-        });
-      }
-      // Second attempt: 401
-      if (url.includes("fields") && callCount === 4) {
-        return Promise.resolve({
-          ok: false,
-          status: 401,
-          json: () => Promise.resolve({ message: "Unauthorized 2" }),
-        });
-      }
-      // Third temp token fetch
-      if (url.includes("auth/temporary") && callCount === 5) {
-        return Promise.resolve({
-          ok: true,
-          status: 200,
-          json: () => Promise.resolve({ temporaryAuthorization: "token_3" }),
-        });
-      }
-      // Third attempt: 401
-      if (url.includes("fields") && callCount === 6) {
-        return Promise.resolve({
-          ok: false,
-          status: 401,
-          json: () => Promise.resolve({ message: "Unauthorized 3" }),
-        });
-      }
-      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); // 3 token fetches + 3 API attempts
-
-    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

@@ -1,69 +0,0 @@
-// 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..."
-    );
-  });
-});