The modern link attribution platform. Loved by world-class engineering teams at Twilio, Zillow, Jobber, Vercel, Raycast, and more.
TypeScript clickhousemysqlnextjsopen-sourceplanetscaleprismatailwindcsstinybirdtypescriptupstashvercel
Add `GET /api/partners/applications` (#3800)
Kiran K35926d844cc7
diff --git a/apps/web/app/(ee)/api/partners/applications/route.ts b/apps/web/app/(ee)/api/partners/applications/route.tsnew file mode 100644index 0000000000..f52097437d--- /dev/null+++ b/apps/web/app/(ee)/api/partners/applications/route.ts@@ -0,0 +1,89 @@+import { getDefaultProgramIdOrThrow } from "@/lib/api/programs/get-default-program-id-or-throw";+import { withWorkspace } from "@/lib/auth";+import { formatApplicationFormData } from "@/lib/partners/format-application-form-data";+import { polyfillSocialMediaFields } from "@/lib/social-utils";+import {+ getPartnerApplicationsQuerySchema,+ PartnerApplicationSchema,+} from "@/lib/zod/schemas/program-application";+import { prisma } from "@dub/prisma";+import { NextResponse } from "next/server";+import * as z from "zod/v4";++// GET /api/partners/applications - get all pending applications for a program+export const GET = withWorkspace(+ async ({ workspace, searchParams }) => {+ const {+ country,+ groupId,+ page = 1,+ pageSize,+ } = getPartnerApplicationsQuerySchema.parse(searchParams);++ const programId = getDefaultProgramIdOrThrow(workspace);++ const applications = await prisma.programEnrollment.findMany({+ where: {+ programId,+ status: "pending",+ application: {+ isNot: null,+ },+ ...(groupId && { groupId }),+ ...(country && {+ partner: {+ country,+ },+ }),+ },+ include: {+ application: true,+ partner: {+ include: {+ platforms: true,+ },+ },+ },+ orderBy: {+ createdAt: "desc",+ },+ take: pageSize,+ skip: (page - 1) * pageSize,+ });++ const result = applications.map(+ ({ partner, application, ...programEnrollment }) => {+ const applicationFormData = formatApplicationFormData(application!).map(+ ({ title, value }) => ({+ label: title,+ value: value !== "" ? value : null,+ }),+ );++ return {+ id: application!.id,+ createdAt: application!.createdAt,+ applicationFormData,+ partner: {+ ...partner,+ ...polyfillSocialMediaFields(partner.platforms),+ status: programEnrollment.status,+ groupId: programEnrollment.groupId,+ },+ };+ },+ );++ return NextResponse.json(z.array(PartnerApplicationSchema).parse(result));+ },+ {+ requiredPlan: [+ "business",+ "business extra",+ "business max",+ "business plus",+ "advanced",+ "enterprise",+ ],+ },+);diff --git a/apps/web/lib/openapi/partners/index.ts b/apps/web/lib/openapi/partners/index.tsindex ebcf395095..e684540b45 100644--- a/apps/web/lib/openapi/partners/index.ts+++ b/apps/web/lib/openapi/partners/index.ts@@ -3,6 +3,7 @@ import { banPartner } from "./ban-partner";import { createPartner } from "./create-partner";import { createPartnerLink } from "./create-partner-link";import { deactivatePartner } from "./deactivate-partner";+import { listPartnerApplications } from "./list-partner-applications";import { listPartners } from "./list-partners";import { retrievePartnerAnalytics } from "./retrieve-analytics";import { retrievePartnerLinks } from "./retrieve-partner-links";@@ -13,6 +14,9 @@ export const partnersPaths: ZodOpenApiPathsObject = {post: createPartner,get: listPartners,},+ "/partners/applications": {+ get: listPartnerApplications,+ },"/partners/links": {post: createPartnerLink,get: retrievePartnerLinks,diff --git a/apps/web/lib/openapi/partners/list-partner-applications.ts b/apps/web/lib/openapi/partners/list-partner-applications.tsnew file mode 100644index 0000000000..9f8e1c7af1--- /dev/null+++ b/apps/web/lib/openapi/partners/list-partner-applications.ts@@ -0,0 +1,31 @@+import { openApiErrorResponses } from "@/lib/openapi/responses";+import {+ getPartnerApplicationsQuerySchema,+ PartnerApplicationSchema,+} from "@/lib/zod/schemas/program-application";+import { ZodOpenApiOperationObject } from "zod-openapi";+import * as z from "zod/v4";++export const listPartnerApplications: ZodOpenApiOperationObject = {+ operationId: "listPartnerApplications",+ "x-speakeasy-name-override": "list",+ summary: "List pending partner applications",+ description:+ "Retrieve pending partner program applications for the authenticated workspace's default program.",+ requestParams: {+ query: getPartnerApplicationsQuerySchema,+ },+ responses: {+ "200": {+ description: "The list of pending partner applications.",+ content: {+ "application/json": {+ schema: z.array(PartnerApplicationSchema),+ },+ },+ },+ ...openApiErrorResponses,+ },+ tags: ["Partner Applications"],+ security: [{ token: [] }],+};diff --git a/apps/web/lib/types.ts b/apps/web/lib/types.tsindex 8a2d017e50..149778109d 100644--- a/apps/web/lib/types.ts+++ b/apps/web/lib/types.ts@@ -137,6 +137,7 @@ import {PartnerPayoutResponseSchema,PayoutResponseSchema,} from "./zod/schemas/payouts";+import { PartnerApplicationSchema } from "./zod/schemas/program-application";import {programApplicationFormDataWithValuesSchema,programApplicationFormFieldWithValuesSchema,@@ -534,6 +535,8 @@ export type EnrolledPartnerProps = z.infer<typeof EnrolledPartnerSchema> & {platforms: PartnerPlatformProps[];};+export type PartnerApplicationProps = z.infer<typeof PartnerApplicationSchema>;+export type NetworkPartnerProps = z.infer<typeof NetworkPartnerSchema>;export type PartnerConversionScore = z.infer<diff --git a/apps/web/lib/zod/schemas/program-application.ts b/apps/web/lib/zod/schemas/program-application.tsindex c844f35905..d07b5ba27d 100644--- a/apps/web/lib/zod/schemas/program-application.ts+++ b/apps/web/lib/zod/schemas/program-application.ts@@ -1,11 +1,14 @@import * as z from "zod/v4";+import { getPaginationQuerySchema } from "./misc";import {EnrolledPartnerSchema,+ getPartnersQuerySchema,PartnerPartnerPlatformsSchema,+ PARTNERS_MAX_PAGE_SIZE,} from "./partners";import { ProgramEnrollmentSchema } from "./programs";-export const partnerApplicationWebhookSchema = z.object({+export const PartnerApplicationSchema = z.object({id: z.string(),createdAt: z.coerce.date(),partner: EnrolledPartnerSchema.pick({@@ -42,3 +45,16 @@ export const partnerApplicationWebhookSchema = z.object({).nullable(),});++export const partnerApplicationWebhookSchema = PartnerApplicationSchema;++export const getPartnerApplicationsQuerySchema = getPartnersQuerySchema+ .pick({+ country: true,+ groupId: true,+ })+ .extend(+ getPaginationQuerySchema({+ pageSize: PARTNERS_MAX_PAGE_SIZE,+ }),+ );diff --git a/apps/web/lib/zod/schemas/programs.ts b/apps/web/lib/zod/schemas/programs.tsindex bbcb170209..be79b8d0e9 100644--- a/apps/web/lib/zod/schemas/programs.ts+++ b/apps/web/lib/zod/schemas/programs.ts@@ -125,7 +125,7 @@ export const ProgramPartnerLinkSchema = LinkSchema.pick({export const ProgramEnrollmentApplicationSchema = z.object({rejectionReason: z- .nativeEnum(ProgramApplicationRejectionReason)+ .enum(ProgramApplicationRejectionReason).nullable().describe("Preset reason when the application was rejected."),rejectionNote: zdiff --git a/apps/web/tests/partners/applications/list-partner-applications.test.ts b/apps/web/tests/partners/applications/list-partner-applications.test.tsnew file mode 100644index 0000000000..63c9524674--- /dev/null+++ b/apps/web/tests/partners/applications/list-partner-applications.test.ts@@ -0,0 +1,73 @@+import { PartnerApplicationProps } from "@/lib/types";+import { PartnerApplicationSchema } from "@/lib/zod/schemas/program-application";+import { describe, expect, test } from "vitest";+import { IntegrationHarness } from "../../utils/integration";+import { E2E_PARTNER_GROUP, E2E_PARTNERS } from "../../utils/resource";++describe.sequential("GET /partners/applications", async () => {+ const h = new IntegrationHarness();+ const { http } = await h.init();++ test("returns a list of pending partner applications", async () => {+ const { data, status } = await http.get<PartnerApplicationProps[]>({+ path: "/partners/applications",+ });++ expect(status).toEqual(200);+ expect(Array.isArray(data)).toBe(true);++ data.forEach((application) => {+ const parsed = PartnerApplicationSchema.parse(application);+ expect(parsed.partner.status).toBe("pending");+ });+ });++ test("filters applications by country", async () => {+ const country = E2E_PARTNERS[0]!.country;++ const { data, status } = await http.get<PartnerApplicationProps[]>({+ path: "/partners/applications",+ query: { country },+ });++ expect(status).toEqual(200);+ expect(Array.isArray(data)).toBe(true);++ data.forEach((application) => {+ const parsed = PartnerApplicationSchema.parse(application);+ expect(parsed.partner.country).toBe(country);+ expect(parsed.partner.status).toBe("pending");+ });+ });++ test("filters applications by groupId", async () => {+ const { data, status } = await http.get<PartnerApplicationProps[]>({+ path: "/partners/applications",+ query: { groupId: E2E_PARTNER_GROUP.id },+ });++ expect(status).toEqual(200);+ expect(Array.isArray(data)).toBe(true);++ data.forEach((application) => {+ const parsed = PartnerApplicationSchema.parse(application);+ expect(parsed.partner.groupId).toBe(E2E_PARTNER_GROUP.id);+ expect(parsed.partner.status).toBe("pending");+ });+ });++ test("respects pageSize pagination", async () => {+ const { data, status } = await http.get<PartnerApplicationProps[]>({+ path: "/partners/applications",+ query: { page: "1", pageSize: "1" },+ });++ expect(status).toEqual(200);+ expect(Array.isArray(data)).toBe(true);+ expect(data.length).toBeLessThanOrEqual(1);++ data.forEach((application) => {+ PartnerApplicationSchema.parse(application);+ });+ });+});