The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.
TypeScript clickhousemysqlnextjsopen-sourceplanetscaleprismatailwindcsstinybirdtypescriptupstashvercel
Add partner search types, mock provider, and tests
Rafif17c4f8161f7
diff --git a/apps/web/lib/api/partners/search/index.ts b/apps/web/lib/api/partners/search/index.tsnew file mode 100644index 0000000000..a025445e12--- /dev/null+++ b/apps/web/lib/api/partners/search/index.ts@@ -0,0 +1,3 @@+export * from "./mock-provider";+export * from "./searchable-values";+export * from "./types";diff --git a/apps/web/lib/api/partners/search/mock-provider.ts b/apps/web/lib/api/partners/search/mock-provider.tsnew file mode 100644index 0000000000..a2a3bd0455--- /dev/null+++ b/apps/web/lib/api/partners/search/mock-provider.ts@@ -0,0 +1,54 @@+import {+ getPartnerSearchableValues,+ normalizePartnerSearchQuery,+} from "./searchable-values";+import {+ PartnerSearchDocument,+ PartnerSearchProvider,+ PartnerSearchQuery,+} from "./types";++/**+ * In-memory search used for unit tests and API plumbing. It is not+ * intended for production or performance testing.+ */+export function createMockPartnerSearchProvider(+ initialDocuments: PartnerSearchDocument[] = [],+): PartnerSearchProvider {+ const documents = new Map(+ initialDocuments.map((document) => [document.id, document]),+ );++ return {+ async search({ programId, query, limit, offset }: PartnerSearchQuery) {+ const normalizedQuery = normalizePartnerSearchQuery(query);+ const matches = Array.from(documents.values()).filter(+ (document) =>+ document.programId === programId &&+ getPartnerSearchableValues(document).some((value) =>+ normalizePartnerSearchQuery(value).includes(normalizedQuery),+ ),+ );++ return {+ hits: matches.slice(offset, offset + limit).map((document) => ({+ id: document.id,+ partnerId: document.partnerId,+ })),+ total: matches.length,+ };+ },++ async upsert(updatedDocuments) {+ for (const document of updatedDocuments) {+ documents.set(document.id, document);+ }+ },++ async delete(documentIds) {+ for (const documentId of documentIds) {+ documents.delete(documentId);+ }+ },+ };+}diff --git a/apps/web/lib/api/partners/search/searchable-values.ts b/apps/web/lib/api/partners/search/searchable-values.tsnew file mode 100644index 0000000000..f3549b9f24--- /dev/null+++ b/apps/web/lib/api/partners/search/searchable-values.ts@@ -0,0 +1,27 @@+import { PartnerSearchDocument } from "./types";++/**+ * Returns every value covered by the partner-search assignment. Providers can+ * index these as separate weighted fields or as one normalized search field.+ */+export function getPartnerSearchableValues(+ document: PartnerSearchDocument,+): string[] {+ return [+ document.name,+ document.email,+ document.companyName,+ document.description,+ ...document.platformTypes,+ ...document.platformIdentifiers,+ ...document.linkDomains,+ ...document.linkKeys,+ ...document.shortLinks,+ ...document.destinationUrls,+ ].filter((value): value is string => Boolean(value));+}++export function normalizePartnerSearchQuery(query: string): string {+ // Normalize equivalent Unicode characters for consistent matching.+ return query.normalize("NFKC").trim().toLowerCase();+}diff --git a/apps/web/lib/api/partners/search/types.ts b/apps/web/lib/api/partners/search/types.tsnew file mode 100644index 0000000000..784c0e71a3--- /dev/null+++ b/apps/web/lib/api/partners/search/types.ts@@ -0,0 +1,58 @@+import { PlatformType, ProgramEnrollmentStatus } from "@prisma/client";++/**+ * Program enrollment data stored in the partner search index.+ * The database remains the source of truth, so every field must be rebuildable.+ */+export interface PartnerSearchDocument {+ id: string;+ programId: string;+ partnerId: string;++ // Searchable partner profile fields+ name: string;+ email: string | null;+ companyName: string | null;+ description: string | null;++ // Searchable platform fields+ platformTypes: PlatformType[];+ platformIdentifiers: string[];++ // Searchable link fields+ linkDomains: string[];+ linkKeys: string[];+ shortLinks: string[];+ destinationUrls: string[];++ // Program-scoped fields needed to constrain search results+ status: ProgramEnrollmentStatus;+ groupId: string | null;+ country: string | null;+ createdAt: string;+ updatedAt: string;+}++export interface PartnerSearchQuery {+ programId: string;+ query: string;+ limit: number;+ offset: number;+}++export interface PartnerSearchHit {+ id: string;+ partnerId: string;+ score?: number;+}++export interface PartnerSearchResult {+ hits: PartnerSearchHit[];+ total: number;+}++export interface PartnerSearchProvider {+ search(query: PartnerSearchQuery): Promise<PartnerSearchResult>;+ upsert(documents: PartnerSearchDocument[]): Promise<void>;+ delete(documentIds: string[]): Promise<void>;+}diff --git a/apps/web/tests/partners/partner-search-provider.test.ts b/apps/web/tests/partners/partner-search-provider.test.tsnew file mode 100644index 0000000000..8fc430d1d2--- /dev/null+++ b/apps/web/tests/partners/partner-search-provider.test.ts@@ -0,0 +1,66 @@+import {+ createMockPartnerSearchProvider,+ PartnerSearchDocument,+} from "@/lib/api/partners/search";+import { describe, expect, it } from "vitest";++const partnerDocument: PartnerSearchDocument = {+ id: "pge_test",+ programId: "prog_test",+ partnerId: "pn_test",+ name: "Rafi Hasan",+ email: "[email protected]",+ companyName: "Dub Partners",+ description: "Developer tools educator",+ platformTypes: ["website", "youtube", "twitter"],+ platformIdentifiers: ["rafi.dev", "@rafi-youtube", "@rafi-on-x"],+ linkDomains: ["dub.sh"],+ linkKeys: ["rafi"],+ shortLinks: ["https://dub.sh/rafi"],+ destinationUrls: ["https://example.com/referrals/rafi"],+ status: "approved",+ groupId: null,+ country: "CA",+ createdAt: "2026-08-08T00:00:00.000Z",+ updatedAt: "2026-08-08T00:00:00.000Z",+};++describe("partner search provider contract", () => {+ it.each([+ ["name", "rafi"],+ ["partial email", "examp"],+ ["company name", "dub partners"],+ ["description", "educator"],+ ["platform type", "twitter"],+ ["platform identifier", "rafi-on-x"],+ ["link domain", "dub.sh"],+ ["link key", "rafi"],+ ["short link", "dub.sh/rafi"],+ ["link destination", "referrals/rafi"],+ ])("searches by %s", async (_field, query) => {+ const provider = createMockPartnerSearchProvider([partnerDocument]);++ const result = await provider.search({+ programId: partnerDocument.programId,+ query,+ limit: 10,+ offset: 0,+ });++ expect(result.total).toBe(1);+ expect(result.hits[0]?.partnerId).toBe(partnerDocument.partnerId);+ });++ it("keeps search results scoped to a program", async () => {+ const provider = createMockPartnerSearchProvider([partnerDocument]);++ const result = await provider.search({+ programId: "prog_other",+ query: "rafi",+ limit: 10,+ offset: 0,+ });++ expect(result).toEqual({ hits: [], total: 0 });+ });+});