Skip to content

armgit / dub

Public Imported from GitHub
0

The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.

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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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 });
+ });
+});