Open source alternative to Semrush and Ahrefs
TypeScript backlink-analysisgoogle-search-console-mcpkeyword-researchmcpseoseo-agentseo-auditseo-automationseo-skillsseo-toolssite-audit
import { z } from "zod";
import { useLocalHistoryStore } from "@/client/hooks/useLocalHistoryStore";
import { jsonCodec } from "@/shared/json";
import {
researchScopeSchema,
type ResearchScope,
} from "@/shared/researchScope";
type DomainSortMode = "rank" | "traffic" | "volume" | "score" | "cpc";
type DomainTab = "keywords" | "pages";
export interface DomainSearchHistoryItem {
domain: string;
scope: ResearchScope;
sort: DomainSortMode;
tab: DomainTab;
locationCode?: number;
timestamp: number;
}
type AddDomainSearchInput = Omit<DomainSearchHistoryItem, "timestamp">;
const MAX_HISTORY = 20;
const domainSearchHistoryItemSchema = z
.object({
domain: z.string(),
scope: researchScopeSchema.optional(),
/** Legacy field: pre-scope history encoded "Include subdomains" here. */
subdomains: z.boolean().optional(),
sort: z.enum(["rank", "traffic", "volume", "score", "cpc"]),
tab: z.enum(["keywords", "pages"]),
locationCode: z.number().int().positive().optional(),
timestamp: z.number(),
})
.transform(
({ subdomains, scope, ...item }): DomainSearchHistoryItem => ({
...item,
// Legacy items always carried the boolean, so scope-less means true.
scope: scope ?? (subdomains === false ? "domain" : "subdomains"),
}),
);
const domainSearchHistorySchema = z.array(domainSearchHistoryItemSchema);
const domainSearchHistoryCodec = jsonCodec(domainSearchHistorySchema);
function isSameSearch(
a: DomainSearchHistoryItem,
b: AddDomainSearchInput,
): boolean {
return (
a.domain === b.domain &&
a.scope === b.scope &&
a.sort === b.sort &&
a.tab === b.tab &&
a.locationCode === b.locationCode
);
}
export function useDomainSearchHistory(projectId: string) {
const { history, isLoaded, addItem, removeItem, clearItems } =
useLocalHistoryStore<DomainSearchHistoryItem, AddDomainSearchInput>({
storageKey: `domain-search-history:${projectId}`,
maxItems: MAX_HISTORY,
parse: (raw) => {
const parsed = domainSearchHistoryCodec.safeParse(raw);
return parsed.success ? parsed.data : null;
},
isSameItem: isSameSearch,
createItem: (item) => ({
...item,
timestamp: Date.now(),
}),
getItemKey: (item) => item.timestamp,
});
return {
history,
isLoaded,
addSearch: addItem,
clearHistory: clearItems,
removeHistoryItem: removeItem,
};
}