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 `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.ts
new file mode 100644
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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: z
diff --git a/apps/web/tests/partners/applications/list-partner-applications.test.ts b/apps/web/tests/partners/applications/list-partner-applications.test.ts
new file mode 100644
index 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);
+ });
+ });
+});