Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
import { beforeEach, describe, expect, it, vi } from "vitest";
import { makeGa4ReportResult } from "./ga4-test-fixtures";
import { SearchOpportunityService } from "./SearchOpportunityService";
const mocks = vi.hoisted(() => ({
getGa4Connection: vi.fn(),
getGscConnection: vi.fn(),
getPerformance: vi.fn(),
runGa4Report: vi.fn(),
}));
vi.mock("@/server/features/ga4/repositories/Ga4ConnectionRepository", () => ({
Ga4ConnectionRepository: { getByProjectId: mocks.getGa4Connection },
}));
vi.mock("@/server/features/gsc/services/GscService", () => ({
GscService: {
getConnection: mocks.getGscConnection,
getPerformance: mocks.getPerformance,
},
}));
vi.mock("@/server/features/ga4/services/Ga4ReportingService", () => ({
Ga4ReportingService: { runReport: mocks.runGa4Report },
resolveGa4DateRange: vi.fn(),
}));
const ga4Result = makeGa4ReportResult({
rows: [
{
hostName: "example.com",
landingPage: "/High-Value/?utm_source=x",
sessions: 100,
activeUsers: 90,
engagedSessions: 80,
engagementRate: 0.8,
keyEvents: 10,
sessionKeyEventRate: 0.1,
transactions: 2,
purchaseRevenue: 500,
},
{
hostName: "example.com",
landingPage: "/other/",
sessions: 10,
activeUsers: 9,
engagedSessions: 5,
engagementRate: 0.5,
keyEvents: 1,
sessionKeyEventRate: 0.02,
transactions: 0,
purchaseRevenue: 0,
},
],
rowCount: 2,
totalRowCount: 2,
});
describe("SearchOpportunityService", () => {
beforeEach(() => {
mocks.getGa4Connection.mockResolvedValue({
propertyTimeZone: "America/New_York",
});
mocks.getGscConnection.mockResolvedValue({
siteUrl: "https://example.com/",
});
mocks.runGa4Report.mockResolvedValue(ga4Result);
});
it("normalizes URLs, scores joined candidates, and leaves unmatched pages unscored", async () => {
mocks.getPerformance.mockResolvedValue({
siteUrl: "https://example.com/",
request: {},
rows: [
{
keys: ["https://EXAMPLE.com/High-Value/?ref=gsc"],
clicks: 10,
impressions: 1_000,
ctr: 0.01,
position: 6,
},
{
keys: ["https://example.com/other"],
clicks: 5,
impressions: 500,
ctr: 0.01,
position: 12,
},
{
keys: ["https://example.com/no-analytics"],
clicks: 1,
impressions: 2_000,
ctr: 0.0005,
position: 8,
},
{
keys: ["https://example.com/top-result"],
clicks: 100,
impressions: 3_000,
ctr: 0.03,
position: 2,
},
],
});
const result = await SearchOpportunityService.getOpportunities(
{ projectId: "project_1" },
{ now: new Date("2026-08-06T12:00:00Z") },
);
expect(mocks.getPerformance).toHaveBeenCalledWith(
expect.objectContaining({
startDate: "2026-07-07",
endDate: "2026-08-03",
dimensions: ["page"],
rowLimit: 1_000,
}),
);
expect(mocks.runGa4Report).toHaveBeenCalledWith(
expect.objectContaining({
startDate: "2026-07-07",
endDate: "2026-08-03",
kind: "landing_pages",
}),
);
expect(result.totalCandidateRows).toBe(3);
expect(result.coverage).toMatchObject({
matchedRows: 2,
unmatchedGscRows: 1,
});
expect(result.rows[0]).toMatchObject({
page: "https://EXAMPLE.com/High-Value/?ref=gsc",
normalizedPage: "example.com/High-Value",
joinStatus: "joined",
score: 100,
});
expect(
result.rows.find((row) => row.joinStatus === "gsc_only"),
).toMatchObject({
ga4: null,
score: null,
scoreComponents: null,
});
expect(result.scoring.businessValueMetric).toBe("sessionKeyEventRate");
expect(result.warnings).toContain("source_time_zones_differ");
});
it("uses engagement rate when all joined rows have zero key events", async () => {
mocks.getPerformance.mockResolvedValue({
siteUrl: "https://example.com/",
request: {},
rows: [
{
keys: ["https://example.com/other"],
clicks: 1,
impressions: 100,
ctr: 0.01,
position: 10,
},
],
});
mocks.runGa4Report.mockResolvedValue({
...ga4Result,
rows: [{ ...ga4Result.rows[1], keyEvents: 0, sessionKeyEventRate: 0 }],
rowCount: 1,
totalRowCount: 1,
});
const result = await SearchOpportunityService.getOpportunities({
projectId: "project_1",
});
expect(result.scoring).toMatchObject({
engagementFallback: true,
businessValueMetric: "engagementRate",
});
});
it("anchors the shared default range to the GA4 property date", async () => {
mocks.getGa4Connection.mockResolvedValue({
propertyTimeZone: "America/Los_Angeles",
});
mocks.getPerformance.mockResolvedValue({
siteUrl: "https://example.com/",
request: {},
rows: [],
});
await SearchOpportunityService.getOpportunities(
{ projectId: "project_1" },
{ now: new Date("2026-08-06T01:00:00Z") },
);
expect(mocks.getPerformance).toHaveBeenCalledWith(
expect.objectContaining({
startDate: "2026-07-06",
endDate: "2026-08-02",
}),
);
expect(mocks.runGa4Report).toHaveBeenCalledWith(
expect.objectContaining({
startDate: "2026-07-06",
endDate: "2026-08-02",
}),
);
});
});