Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
import { afterEach, describe, expect, it, vi } from "vitest";
vi.mock("@/server/lib/runtime-env", () => ({
// AUTH_MODE unset: the deployment holds the DataForSEO key.
getOptionalEnvValue: vi.fn(async () => undefined),
getRequiredEnvValue: vi.fn(async () => "encoded-credentials"),
}));
import { dataforseoPost } from "@/server/lib/dataforseo/core";
afterEach(() => {
vi.unstubAllGlobals();
});
describe("DataForSEO transport", () => {
it("retries a transient 5xx on idempotent reads and returns the parsed envelope", async () => {
const fetchMock = vi
.fn<typeof fetch>()
.mockResolvedValueOnce(new Response("upstream failure", { status: 503 }))
.mockResolvedValueOnce(Response.json({ status_code: 20000, tasks: [] }));
vi.stubGlobal("fetch", fetchMock);
await expect(
dataforseoPost("/v3/backlinks/summary/live", []),
).resolves.toEqual({ status_code: 20000, tasks: [] });
expect(fetchMock).toHaveBeenCalledTimes(2);
const [url, init] = fetchMock.mock.calls[0];
expect(url).toBe("https://api.dataforseo.com/v3/backlinks/summary/live");
expect(new Headers(init?.headers).get("Authorization")).toBe(
"Basic encoded-credentials",
);
});
// An unverified account answers with HTTP 403 (status_code 40104). Left as
// INTERNAL_ERROR it reached self-hosters as "an unexpected error occurred".
it("maps a 403 to DATAFORSEO_AUTH_FAILED", async () => {
const fetchMock = vi
.fn<typeof fetch>()
.mockResolvedValue(
Response.json({ status_code: 40104 }, { status: 403 }),
);
vi.stubGlobal("fetch", fetchMock);
await expect(
dataforseoPost("/v3/backlinks/summary/live", []),
).rejects.toMatchObject({ code: "DATAFORSEO_AUTH_FAILED" });
expect(fetchMock).toHaveBeenCalledOnce();
});
// The request-deadline abort arrives as a bare DOMException. Left unclassified
// it escapes as an anonymous INTERNAL_ERROR; retrying it would replay a call
// DataForSEO may already have billed. Both names are reachable: the shared
// budget aborts with TimeoutError, Lighthouse's own controller with AbortError.
it.each(["TimeoutError", "AbortError"])(
"maps a %s abort to UPSTREAM_UNAVAILABLE without retrying",
async (name) => {
const fetchMock = vi
.fn<typeof fetch>()
.mockRejectedValue(new DOMException("aborted", name));
vi.stubGlobal("fetch", fetchMock);
await expect(
dataforseoPost("/v3/serp/google/organic/live/advanced", []),
).rejects.toMatchObject({
code: "UPSTREAM_UNAVAILABLE",
name: "DataForSEOTimeoutError",
});
expect(fetchMock).toHaveBeenCalledOnce();
},
);
});