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.

FEAT: Application Analytics (`ProgramApplicationEvent`) (#3763)

Steven Tey2d239f0b9807
diff --git a/apps/web/app/(ee)/api/applications/analytics/route.ts b/apps/web/app/(ee)/api/applications/analytics/route.ts
new file mode 100644
index 0000000000..6bee9bce44
--- /dev/null
+++ b/apps/web/app/(ee)/api/applications/analytics/route.ts
@@ -0,0 +1,359 @@
+import { getStartEndDates } from "@/lib/analytics/utils/get-start-end-dates";
+import { getDefaultProgramIdOrThrow } from "@/lib/api/programs/get-default-program-id-or-throw";
+import {
+ applicationEventAnalyticsQuerySchema,
+ applicationEventAnalyticsSchema,
+} from "@/lib/application-events/schema";
+import { withWorkspace } from "@/lib/auth";
+import { sqlGranularityMap } from "@/lib/planetscale/granularity";
+import { ApplicationEventAnalyticsQuery } from "@/lib/types";
+import { TZDate, tz } from "@date-fns/tz";
+import { prisma } from "@dub/prisma";
+import { Prisma } from "@dub/prisma/client";
+import { parseFilterValue } from "@dub/utils";
+import { format } from "date-fns/format";
+import { NextResponse } from "next/server";
+import * as z from "zod/v4";
+
+type TimeseriesApplicationRow = {
+ start: string | Date;
+ visits: bigint;
+ starts: bigint;
+ submissions: bigint;
+ approvals: bigint;
+ rejections: bigint;
+};
+
+const aggregations = {
+ _count: {
+ visitedAt: true,
+ startedAt: true,
+ submittedAt: true,
+ approvedAt: true,
+ rejectedAt: true,
+ },
+} as const;
+
+// GET /api/applications/analytics
+export const GET = withWorkspace(async ({ workspace, searchParams }) => {
+ const programId = getDefaultProgramIdOrThrow(workspace);
+
+ const parsedFilters =
+ applicationEventAnalyticsQuerySchema.parse(searchParams);
+
+ const {
+ groupBy,
+ partnerId,
+ country,
+ referralSource,
+ start,
+ end,
+ interval,
+ timezone: timezoneParam,
+ } = parsedFilters;
+
+ // Align with CONVERT_TZ in raw SQL and analyticsQuerySchema default (UTC when omitted).
+ const timezone = timezoneParam ?? "UTC";
+
+ const { startDate, endDate } = getStartEndDates({
+ interval,
+ start,
+ end,
+ timezone,
+ });
+
+ const partnerFilter = parseFilterValue(partnerId);
+ const countryFilter = parseFilterValue(country);
+ const referralSourceFilter = parseFilterValue(referralSource);
+
+ const where: Prisma.ProgramApplicationEventWhereInput = {
+ programId,
+ ...(partnerFilter && {
+ referredByPartnerId:
+ partnerFilter.sqlOperator === "NOT IN"
+ ? { notIn: partnerFilter.values }
+ : { in: partnerFilter.values },
+ }),
+ ...(referralSourceFilter && {
+ referralSource:
+ referralSourceFilter.sqlOperator === "NOT IN"
+ ? { notIn: referralSourceFilter.values }
+ : { in: referralSourceFilter.values },
+ }),
+ ...(countryFilter && {
+ country:
+ countryFilter.sqlOperator === "NOT IN"
+ ? { notIn: countryFilter.values }
+ : { in: countryFilter.values },
+ }),
+ visitedAt: {
+ gte: startDate,
+ lt: endDate,
+ },
+ };
+
+ const responseSchema = applicationEventAnalyticsSchema[groupBy];
+
+ // Get the absolute counts
+ if (groupBy === "count") {
+ const { _count } = await prisma.programApplicationEvent.aggregate({
+ where,
+ ...aggregations,
+ });
+
+ return NextResponse.json(responseSchema.parse(formatCounts(_count)));
+ }
+
+ // Get the counts grouped by the specified column
+ if (["referralSource", "country"].includes(groupBy)) {
+ const groupByColumnMap = {
+ referralSource: "referralSource",
+ country: "country",
+ };
+
+ const groupByColumn = groupByColumnMap[groupBy];
+
+ const events = await prisma.programApplicationEvent.groupBy({
+ by: [groupByColumn],
+ where,
+ ...aggregations,
+ orderBy: {
+ _count: {
+ [groupBy]: "desc",
+ },
+ },
+ });
+
+ const results = events
+ .filter((row) => row[groupByColumn] !== null)
+ .map((row) => ({
+ [groupBy]: row[groupByColumn],
+ ...formatCounts(row._count),
+ }));
+
+ return NextResponse.json(z.array(responseSchema).parse(results));
+ }
+
+ // Get the counts grouped by the partner
+ if (groupBy === "partnerId") {
+ return byPartnerId({
+ where,
+ });
+ }
+
+ // Get the timeseries
+ if (groupBy === "timeseries") {
+ return byTimeseries({
+ ...parsedFilters,
+ programId,
+ timezone,
+ });
+ }
+
+ return NextResponse.json(null);
+});
+
+async function byPartnerId({
+ where,
+}: {
+ where: Prisma.ProgramApplicationEventWhereInput;
+}) {
+ const events = await prisma.programApplicationEvent.groupBy({
+ by: ["referredByPartnerId"],
+ where,
+ ...aggregations,
+ });
+
+ const partnerIds = events
+ .map(({ referredByPartnerId }) => referredByPartnerId)
+ .filter((id): id is string => Boolean(id));
+
+ const partners =
+ partnerIds.length > 0
+ ? await prisma.partner.findMany({
+ where: {
+ id: {
+ in: partnerIds,
+ },
+ },
+ select: {
+ id: true,
+ name: true,
+ image: true,
+ email: true,
+ },
+ })
+ : [];
+
+ const eventCountByPartnerId = new Map(
+ events.map(({ referredByPartnerId, _count }) => [
+ referredByPartnerId,
+ _count,
+ ]),
+ );
+
+ const results = partners
+ .map((partner) => {
+ const partnerEvents = eventCountByPartnerId.get(partner.id);
+
+ if (!partnerEvents) {
+ return null;
+ }
+
+ return {
+ partner,
+ ...formatCounts(partnerEvents),
+ };
+ })
+ .filter((r): r is NonNullable<typeof r> => r !== null);
+
+ return NextResponse.json(
+ z.array(applicationEventAnalyticsSchema["partnerId"]).parse(results),
+ );
+}
+
+async function byTimeseries({
+ programId,
+ partnerId,
+ country,
+ referralSource,
+ timezone,
+ interval,
+ start,
+ end,
+}: ApplicationEventAnalyticsQuery & { programId: string }) {
+ const tzId = timezone ?? "UTC";
+
+ const { startDate, endDate, granularity } = getStartEndDates({
+ interval,
+ start,
+ end,
+ timezone: tzId,
+ });
+
+ const { dateFormat, dateIncrement, startFunction, formatString } =
+ sqlGranularityMap[granularity];
+
+ const partnerFilter = parseFilterValue(partnerId);
+ const countryFilter = parseFilterValue(country);
+ const referralSourceFilter = parseFilterValue(referralSource);
+
+ const conditions: Prisma.Sql[] = [
+ Prisma.sql`e.programId = ${programId}`,
+ Prisma.sql`e.visitedAt >= ${startDate}`,
+ Prisma.sql`e.visitedAt < ${endDate}`,
+ ];
+
+ if (partnerFilter) {
+ const list = Prisma.join(partnerFilter.values.map((v) => Prisma.sql`${v}`));
+ conditions.push(
+ partnerFilter.sqlOperator === "NOT IN"
+ ? Prisma.sql`e.partnerId NOT IN (${list})`
+ : Prisma.sql`e.partnerId IN (${list})`,
+ );
+ }
+
+ if (referralSourceFilter) {
+ const list = Prisma.join(
+ referralSourceFilter.values.map((v) => Prisma.sql`${v}`),
+ );
+ conditions.push(
+ referralSourceFilter.sqlOperator === "NOT IN"
+ ? Prisma.sql`e.referralSource NOT IN (${list})`
+ : Prisma.sql`e.referralSource IN (${list})`,
+ );
+ }
+
+ if (countryFilter) {
+ const list = Prisma.join(countryFilter.values.map((v) => Prisma.sql`${v}`));
+ conditions.push(
+ countryFilter.sqlOperator === "NOT IN"
+ ? Prisma.sql`e.country NOT IN (${list})`
+ : Prisma.sql`e.country IN (${list})`,
+ );
+ }
+
+ const whereClause = Prisma.join(conditions, " AND ");
+
+ const rows = await prisma.$queryRaw<TimeseriesApplicationRow[]>(
+ Prisma.sql`
+ SELECT
+ DATE_FORMAT(CONVERT_TZ(e.visitedAt, "UTC", ${tzId}), ${dateFormat}) AS start,
+ COUNT(e.visitedAt) AS visits,
+ COUNT(e.startedAt) AS starts,
+ COUNT(e.submittedAt) AS submissions,
+ COUNT(e.approvedAt) AS approvals,
+ COUNT(e.rejectedAt) AS rejections
+ FROM ProgramApplicationEvent e
+ WHERE ${whereClause}
+ GROUP BY start
+ ORDER BY start ASC`,
+ );
+
+ const periodKeyFromSql = (start: TimeseriesApplicationRow["start"]) =>
+ typeof start === "string"
+ ? start
+ : format(new TZDate(start, tzId), formatString, {
+ in: tz(tzId),
+ });
+
+ const lookup = Object.fromEntries(
+ rows.map((r) => [
+ periodKeyFromSql(r.start),
+ {
+ visits: Number(r.visits),
+ starts: Number(r.starts),
+ submissions: Number(r.submissions),
+ approvals: Number(r.approvals),
+ rejections: Number(r.rejections),
+ },
+ ]),
+ );
+
+ const tzStartDate = new TZDate(startDate, tzId);
+ const tzEndDate = new TZDate(endDate, tzId);
+
+ let currentDate = startFunction(tzStartDate);
+ const timeseries: z.infer<
+ (typeof applicationEventAnalyticsSchema)["timeseries"]
+ >[] = [];
+
+ while (currentDate < tzEndDate) {
+ const periodKey = format(currentDate, formatString, {
+ in: tz(tzId),
+ });
+
+ timeseries.push({
+ start: currentDate.toISOString(),
+ ...(lookup[periodKey] ?? {
+ visits: 0,
+ starts: 0,
+ submissions: 0,
+ approvals: 0,
+ rejections: 0,
+ }),
+ });
+
+ currentDate = dateIncrement(currentDate);
+ }
+
+ return NextResponse.json(
+ z.array(applicationEventAnalyticsSchema["timeseries"]).parse(timeseries),
+ );
+}
+
+function formatCounts(c: {
+ visitedAt: number;
+ startedAt: number;
+ submittedAt: number;
+ approvedAt: number;
+ rejectedAt: number;
+}) {
+ return {
+ visits: c.visitedAt,
+ starts: c.startedAt,
+ submissions: c.submittedAt,
+ approvals: c.approvedAt,
+ rejections: c.rejectedAt,
+ };
+}
diff --git a/apps/web/app/(ee)/api/applications/events/route.ts b/apps/web/app/(ee)/api/applications/events/route.ts
new file mode 100644
index 0000000000..5e293b5bd6
--- /dev/null
+++ b/apps/web/app/(ee)/api/applications/events/route.ts
@@ -0,0 +1,145 @@
+import { getStartEndDates } from "@/lib/analytics/utils/get-start-end-dates";
+import { getDefaultProgramIdOrThrow } from "@/lib/api/programs/get-default-program-id-or-throw";
+import { assertValidDateRangeForPlan } from "@/lib/api/utils/assert-valid-date-range-for-plan";
+import {
+ applicationEventSchema,
+ applicationEventsQuerySchema,
+} from "@/lib/application-events/schema";
+import { withWorkspace } from "@/lib/auth";
+import { prisma } from "@dub/prisma";
+import { Prisma } from "@dub/prisma/client";
+import { parseFilterValue } from "@dub/utils";
+import { NextResponse } from "next/server";
+import * as z from "zod/v4";
+
+// GET /api/applications/events – list application events
+export const GET = withWorkspace(async ({ workspace, searchParams }) => {
+ const programId = getDefaultProgramIdOrThrow(workspace);
+
+ const {
+ partnerId,
+ country,
+ referralSource,
+ event,
+ start,
+ end,
+ interval,
+ timezone,
+ page,
+ pageSize,
+ sortBy,
+ sortOrder,
+ } = applicationEventsQuerySchema.parse(searchParams);
+
+ assertValidDateRangeForPlan({
+ plan: workspace.plan,
+ dataAvailableFrom: workspace.createdAt,
+ interval,
+ start,
+ end,
+ });
+
+ const { startDate, endDate } = getStartEndDates({
+ interval,
+ start,
+ end,
+ timezone,
+ });
+
+ const partnerFilter = parseFilterValue(partnerId);
+ const countryFilter = parseFilterValue(country);
+ const referralSourceFilter = parseFilterValue(referralSource);
+
+ const where: Prisma.ProgramApplicationEventWhereInput = {
+ programId,
+ ...(partnerFilter && {
+ partnerId:
+ partnerFilter.sqlOperator === "NOT IN"
+ ? { notIn: partnerFilter.values }
+ : { in: partnerFilter.values },
+ }),
+ ...(countryFilter && {
+ country:
+ countryFilter.sqlOperator === "NOT IN"
+ ? { notIn: countryFilter.values }
+ : { in: countryFilter.values },
+ }),
+ ...(referralSourceFilter && {
+ referralSource:
+ referralSourceFilter.sqlOperator === "NOT IN"
+ ? { notIn: referralSourceFilter.values }
+ : { in: referralSourceFilter.values },
+ }),
+ ...(event === "visited" && {
+ visitedAt: {
+ gte: startDate,
+ lt: endDate,
+ },
+ }),
+ ...(event === "started" && {
+ startedAt: {
+ gte: startDate,
+ lt: endDate,
+ },
+ }),
+ ...(event === "submitted" && {
+ submittedAt: {
+ gte: startDate,
+ lt: endDate,
+ },
+ }),
+ ...(event === "approved" && {
+ approvedAt: {
+ gte: startDate,
+ lt: endDate,
+ },
+ }),
+ ...(event === "rejected" && {
+ rejectedAt: {
+ gte: startDate,
+ lt: endDate,
+ },
+ }),
+ };
+
+ const programApplicationEvents =
+ await prisma.programApplicationEvent.findMany({
+ where,
+ orderBy: {
+ [sortBy]: sortOrder,
+ },
+ skip: (page - 1) * pageSize,
+ take: pageSize,
+ include: {
+ programEnrollment: {
+ select: {
+ partner: {
+ select: {
+ id: true,
+ name: true,
+ image: true,
+ },
+ },
+ partnerGroup: {
+ select: {
+ id: true,
+ name: true,
+ slug: true,
+ color: true,
+ },
+ },
+ },
+ },
+ },
+ });
+
+ const response = programApplicationEvents.map(
+ ({ programEnrollment, ...rest }) => ({
+ ...rest,
+ partner: programEnrollment?.partner ?? null,
+ group: programEnrollment?.partnerGroup ?? null,
+ }),
+ );
+
+ return NextResponse.json(z.array(applicationEventSchema).parse(response));
+});
diff --git a/apps/web/app/(ee)/api/commissions/analytics/route.ts b/apps/web/app/(ee)/api/commissions/analytics/route.ts
index fd7df46dde..8b977a3b7f 100644
--- a/apps/web/app/(ee)/api/commissions/analytics/route.ts
+++ b/apps/web/app/(ee)/api/commissions/analytics/route.ts
@@ -1,7 +1,6 @@
import { getStartEndDates } from "@/lib/analytics/utils/get-start-end-dates";
import { getDefaultProgramIdOrThrow } from "@/lib/api/programs/get-default-program-id-or-throw";
import { getProgramOrThrow } from "@/lib/api/programs/get-program-or-throw";
-import { assertValidDateRangeForPlan } from "@/lib/api/utils/assert-valid-date-range-for-plan";
import { withWorkspace } from "@/lib/auth";
import {
commissionAnalyticsQuerySchema,
@@ -109,14 +108,6 @@ export const GET = withWorkspace(async ({ workspace, searchParams }) => {
return byTimeseries({ workspace, programId, parsed });
}
- assertValidDateRangeForPlan({
- plan: workspace.plan,
- dataAvailableFrom: workspace.createdAt,
- interval: parsed.interval,
- start: parsed.start,
- end: parsed.end,
- });
-
const { startDate, endDate } = getStartEndDates({
interval: parsed.interval,
start: parsed.start,
diff --git a/apps/web/app/(ee)/api/cron/partners/auto-reject/route.ts b/apps/web/app/(ee)/api/cron/partners/auto-reject/route.ts
index b7858819e5..85a9183ff6 100644
--- a/apps/web/app/(ee)/api/cron/partners/auto-reject/route.ts
+++ b/apps/web/app/(ee)/api/cron/partners/auto-reject/route.ts
@@ -1,4 +1,5 @@
import { resolveFraudGroups } from "@/lib/api/fraud/resolve-fraud-groups";
+import { trackApplicationEvents } from "@/lib/application-events/update-application-event";
import { withCron } from "@/lib/cron/with-cron";
import { evaluateApplicationRequirements } from "@/lib/partners/evaluate-application-requirements";
import { sendEmail } from "@dub/email";
@@ -123,36 +124,43 @@ export const POST = withCron(async ({ rawBody }) => {
);
}
- await resolveFraudGroups({
- where: {
- programId,
- partnerId,
- },
- resolutionReason:
- "Resolved automatically because the partner application was automatically rejected.",
- });
-
const { partner, program } = programEnrollment;
- if (partner.email) {
- await sendEmail({
- to: partner.email,
- subject: `Your application to ${program.name} was not approved`,
- variant: "notifications",
- replyTo: program.supportEmail || "noreply",
- react: PartnerApplicationRejected({
- partner: {
- name: partner.name ?? "there",
- email: partner.email,
- },
- program: {
- name: program.name,
- slug: program.slug,
- supportEmail: program.supportEmail ?? undefined,
- },
+ await Promise.allSettled([
+ resolveFraudGroups({
+ where: {
+ programId,
+ partnerId,
+ },
+ resolutionReason:
+ "Resolved automatically because the partner application was automatically rejected.",
+ }),
+
+ trackApplicationEvents({
+ event: "rejected",
+ programId,
+ partnerIds: [partnerId],
+ }),
+
+ partner.email &&
+ sendEmail({
+ to: partner.email,
+ subject: `Your application to ${program.name} was not approved`,
+ variant: "notifications",
+ replyTo: program.supportEmail || "noreply",
+ react: PartnerApplicationRejected({
+ partner: {
+ name: partner.name ?? "there",
+ email: partner.email,
+ },
+ program: {
+ name: program.name,
+ slug: program.slug,
+ supportEmail: program.supportEmail ?? undefined,
+ },
+ }),
}),
- });
- }
+ ]);
return logAndRespond(
`Successfully auto-rejected partner ${partnerId} in program ${programId}.`,
diff --git a/apps/web/app/(ee)/api/track/application/route.ts b/apps/web/app/(ee)/api/track/application/route.ts
new file mode 100644
index 0000000000..c0714a365f
--- /dev/null
+++ b/apps/web/app/(ee)/api/track/application/route.ts
@@ -0,0 +1,313 @@
+import { COMMON_CORS_HEADERS } from "@/lib/api/cors";
+import { createId } from "@/lib/api/create-id";
+import { DubApiError, handleAndReturnErrorResponse } from "@/lib/api/errors";
+import { parseRequestBody } from "@/lib/api/utils";
+import { getIP } from "@/lib/api/utils/get-ip";
+import {
+ APPLICATION_ID_COOKIE_MAX_AGE,
+ trackApplicationEventSchema,
+} from "@/lib/application-events/schema";
+import { getApplicationEventCookieName } from "@/lib/application-events/utils";
+import { getSession } from "@/lib/auth";
+import { withAxiom } from "@/lib/axiom/server";
+import { detectBot } from "@/lib/middleware/utils/detect-bot";
+import { getIdentityHash } from "@/lib/middleware/utils/get-identity-hash";
+import { ratelimit } from "@/lib/upstash";
+import { prisma } from "@dub/prisma";
+import { Partner, Program } from "@dub/prisma/client";
+import {
+ capitalize,
+ EU_COUNTRY_CODES,
+ getDomainWithoutWWW,
+ getSearchParams,
+ LOCALHOST_GEO_DATA,
+ LOCALHOST_IP,
+} from "@dub/utils";
+import { geolocation, ipAddress } from "@vercel/functions";
+import { cookies } from "next/headers";
+import { NextRequest, NextResponse, userAgent } from "next/server";
+
+// POST /api/track/application – Track an application event
+export const POST = withAxiom(async (req) => {
+ try {
+ if (detectBot(req)) {
+ return NextResponse.json(
+ { ok: true },
+ { status: 202, headers: COMMON_CORS_HEADERS },
+ );
+ }
+
+ const ip = await getIP();
+ const { success } = await ratelimit(10, "10 s").limit(
+ `track-application:${ip}`,
+ );
+
+ if (!success) {
+ throw new DubApiError({
+ code: "rate_limit_exceeded",
+ message: "Too many requests. Please try again later.",
+ });
+ }
+
+ const { eventName, url, referrer } = trackApplicationEventSchema.parse(
+ await parseRequestBody(req),
+ );
+
+ const { programSlug, isMarketplace } = identityProgramSlug(url);
+
+ if (!programSlug) {
+ throw new DubApiError({
+ code: "bad_request",
+ message:
+ "Couldn't identify the program slug from the URL. Skipping tracking...",
+ });
+ }
+
+ const program = await prisma.program.findUnique({
+ where: {
+ slug: programSlug.toLowerCase(),
+ },
+ select: {
+ id: true,
+ },
+ });
+
+ if (!program) {
+ throw new DubApiError({
+ code: "bad_request",
+ message: `Program not found for slug ${programSlug}. Skipping tracking...`,
+ });
+ }
+
+ if (eventName === "visit") {
+ await trackVisitEvent({
+ req,
+ program,
+ url,
+ referrer,
+ isMarketplace,
+ });
+ } else if (eventName === "start") {
+ await trackStartEvent({
+ req,
+ program,
+ });
+ }
+
+ return NextResponse.json(
+ { ok: true },
+ { status: 202, headers: COMMON_CORS_HEADERS },
+ );
+ } catch (error) {
+ return handleAndReturnErrorResponse(error, COMMON_CORS_HEADERS);
+ }
+});
+
+export const OPTIONS = () => {
+ return new Response(null, {
+ status: 204,
+ headers: COMMON_CORS_HEADERS,
+ });
+};
+
+// Track the "visit" event
+async function trackVisitEvent({
+ req,
+ program,
+ url,
+ referrer,
+ isMarketplace,
+}: {
+ req: NextRequest;
+ program: Pick<Program, "id">;
+ url: string;
+ referrer: string | null | undefined;
+ isMarketplace: boolean;
+}) {
+ const cookieName = getApplicationEventCookieName(program.id);
+ const existingEventId = req.cookies.get(cookieName)?.value;
+
+ if (existingEventId) {
+ console.log(
+ `"visit" event already tracked for program ${program.id}. Skipping tracking...`,
+ );
+ return;
+ }
+
+ // Find the partner who referred the application
+ const searchParams = getSearchParams(url);
+ let referredByPartner: Pick<Partner, "id"> | null = null;
+
+ if (searchParams.via) {
+ const partner = await prisma.partner.findUnique({
+ where: {
+ username: searchParams.via.toLowerCase(),
+ },
+ select: {
+ id: true,
+ },
+ });
+
+ if (partner) {
+ referredByPartner = partner;
+ } else {
+ console.log(
+ `Partner not found for username ${searchParams.via}. Not setting referredByPartnerId.`,
+ );
+ }
+ }
+
+ const session = await getSession();
+ const requestContext = await getRequestContext(req);
+
+ try {
+ const programApplicationEvent = await prisma.programApplicationEvent.create(
+ {
+ data: {
+ id: createId({ prefix: "pga_evt_" }),
+ programId: program.id,
+ referralSource: isMarketplace
+ ? "marketplace"
+ : referrer
+ ? getDomainWithoutWWW(referrer) || "direct"
+ : "direct",
+ referredByPartnerId: referredByPartner?.id,
+ partnerId: session?.user?.defaultPartnerId,
+ visitedAt: new Date(),
+ country: requestContext.country,
+ metadata: requestContext,
+ },
+ },
+ );
+
+ console.log(
+ `Created "visit" event for program ${program.id} with eventId: ${programApplicationEvent.id}`,
+ );
+
+ const cookieStore = await cookies();
+
+ cookieStore.set(cookieName, programApplicationEvent.id, {
+ httpOnly: true,
+ maxAge: APPLICATION_ID_COOKIE_MAX_AGE,
+ secure: process.env.NODE_ENV === "production",
+ sameSite: "lax",
+ path: "/",
+ });
+ } catch {}
+}
+
+// Track the "start" event
+async function trackStartEvent({
+ req,
+ program,
+}: {
+ req: NextRequest;
+ program: Pick<Program, "id">;
+}) {
+ const cookieName = getApplicationEventCookieName(program.id);
+ const eventId = req.cookies.get(cookieName)?.value;
+
+ if (!eventId) {
+ throw new DubApiError({
+ code: "bad_request",
+ message: `"start" event not tracked for program ${program.id} because cookie was not found. Skipping tracking...`,
+ });
+ }
+
+ const session = await getSession();
+ const partnerId = session?.user?.defaultPartnerId;
+
+ try {
+ await prisma.programApplicationEvent.update({
+ where: {
+ id: eventId,
+ startedAt: null,
+ },
+ data: {
+ startedAt: new Date(),
+ ...(partnerId ? { partnerId } : {}),
+ },
+ });
+
+ console.log(
+ `Tracked "start" event for program ${program.id} with eventId: ${eventId}`,
+ );
+ } catch {}
+}
+
+// Get the request context
+async function getRequestContext(req: NextRequest) {
+ const isVercel = process.env.VERCEL === "1";
+
+ const identityHash = await getIdentityHash(req);
+ const ua = userAgent(req);
+
+ const ip = isVercel ? ipAddress(req) : LOCALHOST_IP;
+ const geo = isVercel ? geolocation(req) : LOCALHOST_GEO_DATA;
+
+ const continent = isVercel
+ ? req.headers.get("x-vercel-ip-continent")
+ : LOCALHOST_GEO_DATA.continent;
+
+ const region = isVercel
+ ? req.headers.get("x-vercel-ip-country-region")
+ : LOCALHOST_GEO_DATA.region;
+
+ const isEuCountry = geo.country && EU_COUNTRY_CODES.includes(geo.country);
+
+ return {
+ identityHash,
+ continent,
+ country: geo.country,
+ region,
+ city: geo.city,
+ latitude: geo.latitude,
+ longitude: geo.longitude,
+ vercel_region: geo.region,
+ device: capitalize(ua.device.type),
+ device_vendor: ua.device.vendor,
+ device_model: ua.device.model,
+ browser: ua.browser.name,
+ browser_version: ua.browser.version,
+ engine: ua.engine.name,
+ engine_version: ua.engine.version,
+ os: ua.os.name,
+ os_version: ua.os.version,
+ cpu_architecture: ua.cpu?.architecture,
+ ua: ua.ua,
+ ip:
+ typeof ip === "string" && ip.trim().length > 0 && !isEuCountry
+ ? ip
+ : undefined,
+ };
+}
+
+// Identify the program slug from the URL
+// Supports:
+// - https://partners.dub.co/{programSlug}
+// - https://partners.dub.co/programs/{programSlug}/apply
+// - https://partners.dub.co/programs/marketplace/{programSlug}
+function identityProgramSlug(url: string) {
+ try {
+ const urlObj = new URL(url);
+ const parts = urlObj.pathname.split("/").filter(Boolean);
+
+ if (parts.length === 0) {
+ return { programSlug: null, isMarketplace: false };
+ }
+
+ const isMarketplace = parts[0] === "programs" && parts[1] === "marketplace";
+ const programSlug = isMarketplace // e.g. https://partners.dub.co/programs/marketplace/acme
+ ? parts[2]
+ : parts[0] === "programs" // e.g. https://partners.dub.co/programs/acme/apply
+ ? parts[1]
+ : parts[0]; // e.g. https://partners.dub.co/acme, or https://partners.dub.co/acme/apply, or https://partners.dub.co/acme/group/apply
+
+ return {
+ programSlug: programSlug.toLowerCase(),
+ isMarketplace,
+ };
+ } catch (error) {
+ return { programSlug: null, isMarketplace: false };
+ }
+}
diff --git a/apps/web/app/(ee)/partners.dub.co/(apply)/[programSlug]/(default)/apply/page.tsx b/apps/web/app/(ee)/partners.dub.co/(apply)/[programSlug]/(default)/apply/page.tsx
index 867a5717ee..47657b0280 100644
--- a/apps/web/app/(ee)/partners.dub.co/(apply)/[programSlug]/(default)/apply/page.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(apply)/[programSlug]/(default)/apply/page.tsx
@@ -1,6 +1,7 @@
import { getProgram } from "@/lib/fetchers/get-program";
import { DEFAULT_PARTNER_GROUP } from "@/lib/zod/schemas/groups";
import { programApplicationFormSchema } from "@/lib/zod/schemas/program-application-form";
+import { ApplicationAnalytics } from "@/ui/application-analytics";
import { ApplicationFormHero } from "@/ui/partners/groups/design/application-form/application-hero-preview";
import { ProgramApplicationForm } from "@/ui/partners/groups/design/application-form/program-application-form";
import { LanderRewards } from "@/ui/partners/lander/lander-rewards";
@@ -51,6 +52,7 @@ export default async function ApplicationPage(props: {
}
>
<ApplyHeader group={program.group} showApply={false} />
+ <ApplicationAnalytics />
<div className="p-6">
{/* Hero section */}
<ApplicationFormHero
diff --git a/apps/web/app/(ee)/partners.dub.co/(apply)/[programSlug]/(default)/page.tsx b/apps/web/app/(ee)/partners.dub.co/(apply)/[programSlug]/(default)/page.tsx
index 715f73099a..0f0ef77054 100644
--- a/apps/web/app/(ee)/partners.dub.co/(apply)/[programSlug]/(default)/page.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(apply)/[programSlug]/(default)/page.tsx
@@ -1,6 +1,7 @@
import { getProgram } from "@/lib/fetchers/get-program";
import { DEFAULT_PARTNER_GROUP } from "@/lib/zod/schemas/groups";
import { programLanderSchema } from "@/lib/zod/schemas/program-lander";
+import { ApplicationAnalytics } from "@/ui/application-analytics";
import { BLOCK_COMPONENTS } from "@/ui/partners/lander/blocks";
import { LanderHero } from "@/ui/partners/lander/lander-hero";
import { LanderRewards } from "@/ui/partners/lander/lander-rewards";
@@ -48,6 +49,7 @@ export default async function ApplyPage(props: {
}
>
<ApplyHeader group={program.group} />
+ <ApplicationAnalytics />
<div className="p-6">
<LanderHero program={program} landerData={landerData} />
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/profile/profile-details-form.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/profile/profile-details-form.tsx
index 1ad34d8fd1..14bc08677a 100644
--- a/apps/web/app/(ee)/partners.dub.co/(dashboard)/profile/profile-details-form.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/profile/profile-details-form.tsx
@@ -46,6 +46,7 @@ import { SettingsRow } from "./settings-row";
type BasicInfoFormData = {
name: string;
email: string;
+ username: string;
image: string | null;
country: string;
profileType: PartnerProfileType;
@@ -69,6 +70,7 @@ export function ProfileDetailsForm({
defaultValues: {
name: partner?.name,
email: partner?.email ?? "",
+ username: partner?.username ?? "",
image: partner?.image,
country: partner?.country ?? "",
profileType: partner?.profileType ?? "individual",
@@ -256,6 +258,7 @@ function BasicInfoForm({
await executeAsync({
...data,
+ username: data.username?.trim() ? data.username : null,
image: imageChanged ? data.image : null,
});
})}
@@ -339,6 +342,29 @@ function BasicInfoForm({
})}
/>
</label>
+ <label className="flex flex-col gap-1.5">
+ <span className="text-sm font-medium text-neutral-800">Username</span>
+ <input
+ type="text"
+ disabled={disabled}
+ className={cn(
+ "block w-full rounded-md focus:outline-none sm:text-sm",
+ disabled && "cursor-not-allowed bg-neutral-50 text-neutral-400",
+ errors.username
+ ? "border-red-300 pr-10 text-red-900 placeholder-red-300 focus:border-red-500 focus:ring-red-500"
+ : "border-neutral-300 text-neutral-900 placeholder-neutral-400 focus:border-neutral-500 focus:ring-neutral-500",
+ )}
+ placeholder={partner?.email?.split("@")[0] ?? ""}
+ autoCapitalize="off"
+ autoCorrect="off"
+ spellCheck={false}
+ {...register("username")}
+ />
+ <p className="text-xs text-neutral-500">
+ 3–30 characters. Lowercase letters, numbers, hyphens, and
+ underscores only.
+ </p>
+ </label>
<label className="flex flex-col">
<span className="text-sm font-medium text-neutral-800">Country</span>
<Controller
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/apply/page.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/apply/page.tsx
index 939c25507e..9724b0f46a 100644
--- a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/apply/page.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/[programSlug]/apply/page.tsx
@@ -1,6 +1,7 @@
import { getProgram } from "@/lib/fetchers/get-program";
import { DEFAULT_PARTNER_GROUP } from "@/lib/zod/schemas/groups";
import { programLanderSchema } from "@/lib/zod/schemas/program-lander";
+import { ApplicationAnalytics } from "@/ui/application-analytics";
import { PageContent } from "@/ui/layout/page-content";
import { PageWidthWrapper } from "@/ui/layout/page-width-wrapper";
import { BLOCK_COMPONENTS } from "@/ui/partners/lander/blocks";
@@ -29,6 +30,7 @@ export default async function ProgramDetailsPage(props: {
return (
<PageContent>
+ <ApplicationAnalytics />
<PageWidthWrapper className="mb-10 mt-4">
<BackLink href="/programs">Programs</BackLink>
<div className="mt-8 grid grid-cols-1 gap-x-16 gap-y-10 lg:grid-cols-[300px_minmax(0,600px)]">
diff --git a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/marketplace/[programSlug]/page.tsx b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/marketplace/[programSlug]/page.tsx
index ef867fc920..00f65e0bbb 100644
--- a/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/marketplace/[programSlug]/page.tsx
+++ b/apps/web/app/(ee)/partners.dub.co/(dashboard)/programs/marketplace/[programSlug]/page.tsx
@@ -1,4 +1,5 @@
import { getNetworkProgram } from "@/lib/fetchers/get-network-program";
+import { ApplicationAnalytics } from "@/ui/application-analytics";
import { PageContent } from "@/ui/layout/page-content";
import { PageWidthWrapper } from "@/ui/layout/page-width-wrapper";
import { BLOCK_COMPONENTS } from "@/ui/partners/lander/blocks";
@@ -75,6 +76,7 @@ export default async function MarketplaceProgramPage(props: {
}
controls={<MarketplaceProgramHeaderControls program={program} />}
>
+ <ApplicationAnalytics />
<PageWidthWrapper className="pb-20">
<div
className={cn(
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/applications-analytics-cards.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/applications-analytics-cards.tsx
new file mode 100644
index 0000000000..4bc31a8de8
--- /dev/null
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/applications-analytics-cards.tsx
@@ -0,0 +1,303 @@
+"use client";
+
+import {
+ getReferralSourceDisplayValue,
+ STAGE_VALUE_KEY,
+} from "@/lib/application-events/utils";
+import { ApplicationEventStages } from "@/lib/types";
+import { AnalyticsLoadingSpinner } from "@/ui/analytics/analytics-loading-spinner";
+import { BarList } from "@/ui/analytics/bar-list";
+import { ReferrerIcon } from "@/ui/analytics/referrer-icon";
+import { Modal, TabSelect, useRouterStuff } from "@dub/ui";
+import {
+ CircleCheck,
+ CircleDotted,
+ CircleHalfDottedClock,
+ FlagWavy,
+ Globe,
+ Shop,
+} from "@dub/ui/icons";
+import { cn, COUNTRIES, parseFilterValue } from "@dub/utils";
+import { ReactNode, useCallback, useMemo, useState } from "react";
+import { useApplicationsAnalytics } from "./use-applications-analytics";
+
+type AnalyticsTab = "referralSource" | "country";
+
+type StageValueKey = (typeof STAGE_VALUE_KEY)[ApplicationEventStages];
+
+const STAGE_ICONS: Record<ApplicationEventStages, React.ElementType> = {
+ visited: CircleDotted,
+ started: CircleHalfDottedClock,
+ submitted: CircleHalfDottedClock,
+ approved: CircleCheck,
+};
+
+function ApplicationsAnalyticsCardShell({
+ tab,
+ title,
+ stage,
+ barBackground,
+ hoverBackground,
+ data,
+ isLoading,
+ mapRow,
+}: {
+ tab: AnalyticsTab;
+ title: string;
+ stage: ApplicationEventStages;
+ barBackground: string;
+ hoverBackground: string;
+ data: unknown[] | undefined;
+ isLoading: boolean;
+ mapRow: (
+ row: any,
+ stageKey: StageValueKey,
+ ) => {
+ icon: ReactNode;
+ title: string;
+ filterValue: string;
+ value: number;
+ };
+}) {
+ const { queryParams, searchParamsObj } = useRouterStuff();
+ const [selectedItems, setSelectedItems] = useState<string[]>([]);
+
+ const filterParamKey = tab;
+ const isFilterActive = typeof searchParamsObj[filterParamKey] === "string";
+
+ const activeFilterValues = useMemo(() => {
+ const raw = searchParamsObj[filterParamKey];
+ if (typeof raw !== "string" || raw.length === 0) return [];
+ return parseFilterValue(raw)?.values ?? raw.split(",").filter(Boolean);
+ }, [filterParamKey, searchParamsObj]);
+
+ const stageKey = STAGE_VALUE_KEY[stage];
+ const StageIcon = STAGE_ICONS[stage];
+
+ const mapped = useMemo(() => {
+ const rows = data ?? [];
+ return rows
+ .map((row) => mapRow(row, stageKey))
+ .filter((row) => row.value > 0)
+ .sort((a, b) => b.value - a.value);
+ }, [data, mapRow, stageKey]);
+
+ const maxValue = useMemo(
+ () => Math.max(0, ...mapped.map((d) => d.value)),
+ [mapped],
+ );
+
+ const onToggleFilter = useCallback((val: string) => {
+ setSelectedItems((prev) =>
+ prev.includes(val) ? prev.filter((v) => v !== val) : [...prev, val],
+ );
+ }, []);
+
+ const onApplyFilterValues = useCallback(
+ (values: string[]) => {
+ if (values.length === 0) {
+ queryParams({ del: [filterParamKey, "page"], scroll: false });
+ } else {
+ queryParams({
+ set: { [filterParamKey]: values.join(",") },
+ del: "page",
+ scroll: false,
+ });
+ }
+ setSelectedItems([]);
+ },
+ [filterParamKey, queryParams],
+ );
+
+ const onClearFilter = useCallback(() => {
+ setSelectedItems([]);
+ if (isFilterActive) {
+ queryParams({ del: [filterParamKey, "page"], scroll: false });
+ }
+ }, [filterParamKey, isFilterActive, queryParams]);
+
+ const EXPAND_LIMIT = 8;
+ const [showModal, setShowModal] = useState(false);
+ const showViewAll = mapped.length > EXPAND_LIMIT;
+
+ return (
+ <>
+ <Modal
+ showModal={showModal}
+ setShowModal={setShowModal}
+ className="max-w-lg px-0"
+ >
+ <div className="flex items-center justify-between border-b border-neutral-200 px-6 py-4">
+ <h1 className="text-lg font-semibold">{title}</h1>
+ <div className="flex items-center gap-1 text-neutral-500">
+ <StageIcon className="h-4 w-4" />
+ <p className="text-xs uppercase">{STAGE_VALUE_KEY[stage]}</p>
+ </div>
+ </div>
+ <BarList
+ tab={`Application ${tab === "referralSource" ? "source" : "country"}`}
+ unit="applications"
+ data={mapped}
+ maxValue={maxValue}
+ barBackground={barBackground}
+ hoverBackground={hoverBackground}
+ filterSelectedBackground="bg-neutral-900"
+ filterSelectedHoverBackground="hover:bg-neutral-700"
+ filterHoverClass="bg-white border border-neutral-200"
+ setShowModal={setShowModal}
+ selectedFilterValues={selectedItems}
+ activeFilterValues={activeFilterValues}
+ onToggleFilter={onToggleFilter}
+ onClearFilter={onClearFilter}
+ onClearSelection={() => setSelectedItems([])}
+ onApplyFilterValues={onApplyFilterValues}
+ onRowFilterItem={(val) => onApplyFilterValues([val])}
+ />
+ </Modal>
+
+ <div className="group relative z-0 h-[400px] overflow-hidden rounded-lg border border-neutral-200 bg-white sm:rounded-xl">
+ <div className="flex items-center justify-between border-b border-neutral-200 px-4">
+ <TabSelect
+ options={[{ id: tab, label: title }]}
+ selected={tab}
+ onSelect={() => {}}
+ />
+ <div className="flex items-center gap-1 pr-2 text-neutral-500">
+ <StageIcon className="hidden h-4 w-4 sm:block" />
+ <p className="text-xs uppercase">{STAGE_VALUE_KEY[stage]}</p>
+ </div>
+ </div>
+
+ <div className="py-4">
+ {isLoading ? (
+ <div className="absolute inset-0 flex h-[300px] w-full items-center justify-center bg-white/50">
+ <AnalyticsLoadingSpinner />
+ </div>
+ ) : mapped.length === 0 ? (
+ <div className="flex h-[300px] items-center justify-center">
+ <p className="text-sm text-neutral-600">No data available</p>
+ </div>
+ ) : (
+ <BarList
+ tab={`Application ${tab === "referralSource" ? "source" : "country"}`}
+ unit="applications"
+ data={mapped}
+ maxValue={maxValue}
+ barBackground={barBackground}
+ hoverBackground={hoverBackground}
+ filterSelectedBackground="bg-neutral-900"
+ filterSelectedHoverBackground="hover:bg-neutral-700"
+ filterHoverClass="bg-white border border-neutral-200"
+ setShowModal={setShowModal}
+ limit={EXPAND_LIMIT}
+ selectedFilterValues={selectedItems}
+ activeFilterValues={activeFilterValues}
+ onToggleFilter={onToggleFilter}
+ onClearFilter={onClearFilter}
+ onClearSelection={() => setSelectedItems([])}
+ onApplyFilterValues={onApplyFilterValues}
+ onRowFilterItem={(val) => onApplyFilterValues([val])}
+ />
+ )}
+ </div>
+
+ {(showViewAll || isFilterActive) && (
+ <div className="absolute bottom-0 left-0 z-10 flex w-full items-end">
+ <div className="pointer-events-none absolute bottom-0 left-0 h-48 w-full bg-gradient-to-t from-white" />
+ <div className="relative flex w-full items-center justify-center gap-2 py-4">
+ <button
+ onClick={() => setShowModal(true)}
+ className={cn(
+ "h-8 w-fit rounded-lg px-3 text-sm transition-colors",
+ isFilterActive
+ ? "border-black bg-black text-white hover:bg-neutral-800"
+ : "border border-neutral-200 bg-white text-neutral-950 hover:bg-neutral-100 active:border-neutral-300",
+ )}
+ >
+ View All
+ </button>
+ {isFilterActive && (
+ <button
+ onClick={onClearFilter}
+ className="h-8 w-fit rounded-lg border border-neutral-200 bg-white px-3 text-sm text-neutral-600 transition-colors hover:bg-neutral-50 active:border-neutral-300"
+ >
+ Clear
+ </button>
+ )}
+ </div>
+ </div>
+ )}
+ </div>
+ </>
+ );
+}
+
+export function ApplicationsAnalyticsCards({
+ stage,
+}: {
+ stage: ApplicationEventStages;
+}) {
+ const { data: referralSources, isLoading: referralSourcesLoading } =
+ useApplicationsAnalytics({ groupBy: "referralSource" });
+
+ const { data: countries, isLoading: countriesLoading } =
+ useApplicationsAnalytics({ groupBy: "country" });
+
+ return (
+ <div className="grid grid-cols-1 gap-5 md:grid-cols-2">
+ <ApplicationsAnalyticsCardShell
+ tab="referralSource"
+ title="Application source"
+ stage={stage}
+ data={referralSources}
+ isLoading={referralSourcesLoading}
+ mapRow={(row, stageKey) => {
+ const source = row.referralSource as string;
+ const value = (row?.[stageKey] as number | undefined) ?? 0;
+ return {
+ icon:
+ source === "marketplace" ? (
+ <Shop />
+ ) : source === "direct" ? (
+ <Globe />
+ ) : (
+ <ReferrerIcon display={source} />
+ ),
+ title: getReferralSourceDisplayValue(source),
+ filterValue: source,
+ value,
+ };
+ }}
+ barBackground="bg-orange-100"
+ hoverBackground="hover:bg-gradient-to-r hover:from-orange-50 hover:to-transparent hover:border-orange-500"
+ />
+ <ApplicationsAnalyticsCardShell
+ tab="country"
+ title="Application country"
+ stage={stage}
+ data={countries}
+ isLoading={countriesLoading}
+ mapRow={(row, stageKey) => {
+ const country = row.country as string;
+ const value = (row?.[stageKey] as number | undefined) ?? 0;
+ return {
+ icon: country ? (
+ <img
+ alt={`${country} flag`}
+ src={`https://hatscripts.github.io/circle-flags/flags/${country.toLowerCase()}.svg`}
+ className="size-4 shrink-0"
+ />
+ ) : (
+ <FlagWavy className="size-4 text-neutral-400" />
+ ),
+ title: country ? COUNTRIES[country] ?? country : "Unknown",
+ filterValue: country ?? "Unknown",
+ value,
+ };
+ }}
+ barBackground="bg-blue-100"
+ hoverBackground="hover:bg-gradient-to-r hover:from-blue-50 hover:to-transparent hover:border-blue-500"
+ />
+ </div>
+ );
+}
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/applications-funnel-chart.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/applications-funnel-chart.tsx
new file mode 100644
index 0000000000..72c252d924
--- /dev/null
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/applications-funnel-chart.tsx
@@ -0,0 +1,290 @@
+"use client";
+
+import { formatDateTooltip } from "@/lib/analytics/format-date-tooltip";
+import { ApplicationEventStages } from "@/lib/types";
+import { ToggleGroup, useRouterStuff } from "@dub/ui";
+import {
+ Areas,
+ FunnelChart,
+ TimeSeriesChart,
+ XAxis,
+ YAxis,
+} from "@dub/ui/charts";
+import { ChartLine, Filter2, LoadingSpinner } from "@dub/ui/icons";
+import { capitalize, cn } from "@dub/utils";
+import NumberFlow, { NumberFlowGroup } from "@number-flow/react";
+import { ChevronRight } from "lucide-react";
+import Link from "next/link";
+import { useMemo } from "react";
+import {
+ useApplicationsAnalytics,
+ useApplicationsAnalyticsCount,
+} from "./use-applications-analytics";
+import { ApplicationsView } from "./use-applications-analytics-query";
+
+const STAGE_COLOR: Record<ApplicationEventStages, string> = {
+ visited: "text-blue-500",
+ started: "text-violet-600",
+ submitted: "text-pink-500",
+ approved: "text-teal-400",
+};
+
+const STAGE_KEY: Record<
+ ApplicationEventStages,
+ "visits" | "starts" | "submissions" | "approvals"
+> = {
+ visited: "visits",
+ started: "starts",
+ submitted: "submissions",
+ approved: "approvals",
+};
+
+export function ApplicationsFunnelChart({
+ stage,
+ view,
+}: {
+ stage: ApplicationEventStages;
+ view: ApplicationsView;
+}) {
+ const { searchParamsObj, queryParams } = useRouterStuff();
+
+ const { data, error, isLoading } = useApplicationsAnalyticsCount();
+
+ const { data: timeseries, error: timeseriesError } = useApplicationsAnalytics(
+ {
+ groupBy: "timeseries",
+ },
+ );
+
+ const steps = useMemo(
+ () => [
+ {
+ id: "visited",
+ value: data?.visits ?? 0,
+ colorClassName: "text-blue-600",
+ },
+ {
+ id: "started",
+ value: data?.starts ?? 0,
+ colorClassName: "text-violet-600",
+ },
+ {
+ id: "submitted",
+ value: data?.submissions ?? 0,
+ colorClassName: "text-pink-500",
+ },
+ {
+ id: "approved",
+ value: data?.approvals ?? 0,
+ colorClassName: "text-teal-400",
+ },
+ ],
+ [data],
+ );
+
+ const stageKey = STAGE_KEY[stage];
+ const colorClassName = STAGE_COLOR[stage] ?? "text-violet-500";
+
+ const chartData = timeseries?.map((row) => ({
+ date: new Date(row.start),
+ values: { amount: row[stageKey] },
+ }));
+
+ return (
+ <div>
+ <div className="border-b border-neutral-200">
+ <div className="grid w-full grid-cols-4 divide-x divide-neutral-200 overflow-y-hidden">
+ <NumberFlowGroup>
+ {(
+ [
+ {
+ id: "visited",
+ colorClassName: "text-blue-500/50",
+ value: data?.visits,
+ },
+ {
+ id: "started",
+ colorClassName: "text-violet-600/50",
+ value: data?.starts,
+ },
+ {
+ id: "submitted",
+ colorClassName: "text-pink-500/50",
+ value: data?.submissions,
+ },
+ {
+ id: "approved",
+ colorClassName: "text-teal-400/50",
+ value: data?.approvals,
+ },
+ ] as const
+ ).map(({ id, colorClassName, value }, idx) => (
+ <div key={id} className="relative z-0">
+ {idx > 0 && (
+ <div className="absolute left-0 top-1/2 z-10 -translate-x-1/2 -translate-y-1/2 rounded-full border border-neutral-200 bg-white p-1.5">
+ <ChevronRight
+ className="h-3 w-3 text-neutral-400"
+ strokeWidth={2.5}
+ />
+ </div>
+ )}
+ <Link
+ className={cn(
+ "border-box relative block h-full min-w-[110px] flex-none px-4 py-3 sm:min-w-[240px] sm:px-8 sm:py-6",
+ "transition-colors hover:bg-neutral-50 focus:outline-none active:bg-neutral-100",
+ "ring-inset ring-neutral-500 focus-visible:ring-1",
+ )}
+ href={
+ queryParams({
+ set: { applicationEvent: id },
+ del: "page",
+ scroll: false,
+ getNewPath: true,
+ }) as string
+ }
+ aria-current={stage === id ? "page" : undefined}
+ >
+ <div
+ className={cn(
+ "absolute bottom-0 left-0 h-0.5 w-full bg-black transition-transform duration-100",
+ stage !== id && "translate-y-[3px]",
+ )}
+ />
+ <div className="flex items-center gap-2.5 text-sm text-neutral-600">
+ <div
+ className={cn(
+ "h-2 w-2 rounded-sm bg-current shadow-[inset_0_0_0_1px_#00000019]",
+ colorClassName,
+ )}
+ />
+ <span className="capitalize">{STAGE_KEY[id]}</span>
+ </div>
+ <div className="mt-1 flex h-12 items-center">
+ {value || value === 0 ? (
+ <NumberFlow
+ value={value}
+ className="text-xl font-medium sm:text-3xl"
+ format={{
+ notation: value > 999999 ? "compact" : "standard",
+ }}
+ />
+ ) : (
+ <div className="h-9 w-16 animate-pulse rounded-md bg-neutral-200" />
+ )}
+ </div>
+ </Link>
+ </div>
+ ))}
+ </NumberFlowGroup>
+ </div>
+ </div>
+
+ <div className="relative h-72 md:h-96">
+ {isLoading ? (
+ <div className="flex size-full items-center justify-center">
+ <LoadingSpinner />
+ </div>
+ ) : error || timeseriesError ? (
+ <div className="flex size-full items-center justify-center text-sm text-neutral-500">
+ Failed to load data
+ </div>
+ ) : (
+ <>
+ {view === "timeseries" ? (
+ <div className="relative size-full p-6 pt-10">
+ <TimeSeriesChart
+ data={chartData || []}
+ series={[
+ {
+ id: "amount",
+ valueAccessor: (d) => d.values.amount,
+ colorClassName,
+ isActive: true,
+ },
+ ]}
+ tooltipClassName="p-0"
+ tooltipContent={(d) => (
+ <>
+ <p className="border-b border-neutral-200 px-4 py-3 text-sm text-neutral-900">
+ {formatDateTooltip(d.date, {
+ interval: searchParamsObj.interval,
+ start: searchParamsObj.start,
+ end: searchParamsObj.end,
+ timezone:
+ Intl.DateTimeFormat().resolvedOptions().timeZone,
+ })}
+ </p>
+ <div className="grid grid-cols-2 gap-x-6 gap-y-2 px-4 py-3 text-sm">
+ <div className="flex items-center gap-2">
+ <div
+ className={cn(
+ colorClassName,
+ "h-2 w-2 rounded-sm bg-current opacity-50 shadow-[inset_0_0_0_1px_#0003]",
+ )}
+ />
+ <p className="capitalize text-neutral-600">
+ {STAGE_KEY[stage]}
+ </p>
+ </div>
+ <p className="text-right font-medium text-neutral-900">
+ <NumberFlow value={d.values.amount} />
+ </p>
+ </div>
+ </>
+ )}
+ >
+ <Areas />
+ <XAxis
+ tickFormat={(date) =>
+ formatDateTooltip(date, {
+ interval: searchParamsObj.interval,
+ start: searchParamsObj.start,
+ end: searchParamsObj.end,
+ })
+ }
+ maxTicks={2}
+ />
+ <YAxis showGridLines />
+ </TimeSeriesChart>
+ </div>
+ ) : (
+ <FunnelChart
+ steps={steps.map((step) => ({
+ ...step,
+ label: capitalize(STAGE_KEY[step.id]) as string,
+ }))}
+ />
+ )}
+
+ <div className="absolute right-3 top-3 flex items-center gap-2">
+ <ToggleGroup
+ className="flex w-fit shrink-0 items-center gap-1 border-neutral-100 bg-neutral-100"
+ optionClassName="size-8 p-0 flex items-center justify-center"
+ indicatorClassName="border border-neutral-200 bg-white"
+ options={[
+ {
+ label: <ChartLine className="size-4 text-neutral-600" />,
+ value: "timeseries",
+ },
+ {
+ label: (
+ <Filter2 className="size-4 -rotate-90 text-neutral-600" />
+ ),
+ value: "funnel",
+ },
+ ]}
+ selected={view}
+ selectAction={(next) =>
+ queryParams({
+ set: { view: next },
+ scroll: false,
+ })
+ }
+ />
+ </div>
+ </>
+ )}
+ </div>
+ </div>
+ );
+}
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/applications-partners-table.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/applications-partners-table.tsx
new file mode 100644
index 0000000000..63e3fd8f6d
--- /dev/null
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/applications-partners-table.tsx
@@ -0,0 +1,178 @@
+"use client";
+
+import { APPLICATION_EVENT_STAGES } from "@/lib/application-events/schema";
+import { STAGE_VALUE_KEY } from "@/lib/application-events/utils";
+import {
+ Button,
+ Table,
+ useKeyboardShortcut,
+ usePagination,
+ useRouterStuff,
+ useTable,
+} from "@dub/ui";
+import { capitalize, cn, nFormatter } from "@dub/utils";
+import { AnimatePresence, motion } from "motion/react";
+import { useCallback, useMemo, useState } from "react";
+import { PartnerAnalyticsFilterCell } from "../partner-analytics-filter-cell";
+import { useApplicationsAnalytics } from "./use-applications-analytics";
+
+const PAGE_SIZE = 10;
+
+export function ApplicationsPartnersTable() {
+ const { pagination, setPagination } = usePagination(PAGE_SIZE);
+ const { queryParams, searchParams } = useRouterStuff();
+
+ const [stagedPartnerIds, setStagedPartnerIds] = useState<string[] | null>(
+ null,
+ );
+
+ const activePartnerIdsFromUrl = useMemo(
+ () => searchParams.get("partnerId")?.split(",").filter(Boolean) ?? [],
+ [searchParams],
+ );
+
+ const isFilterActive = searchParams.has("partnerId");
+
+ const toggleStagePartner = useCallback(
+ (partnerId: string) => {
+ setStagedPartnerIds((prev) => {
+ const base = prev ?? activePartnerIdsFromUrl;
+ const next = base.includes(partnerId)
+ ? base.filter((id) => id !== partnerId)
+ : [...base, partnerId];
+ return next.length === 0 ? null : next;
+ });
+ },
+ [activePartnerIdsFromUrl],
+ );
+
+ const applyFilter = useCallback(() => {
+ if (!stagedPartnerIds || stagedPartnerIds.length === 0) {
+ return;
+ }
+
+ queryParams({
+ set: { partnerId: stagedPartnerIds.join(",") },
+ del: "page",
+ scroll: false,
+ });
+
+ setStagedPartnerIds(null);
+ }, [queryParams, stagedPartnerIds]);
+
+ const clearFilter = useCallback(() => {
+ setStagedPartnerIds(null);
+
+ if (searchParams.has("partnerId")) {
+ queryParams({ del: ["partnerId", "page"], scroll: false });
+ }
+ }, [queryParams, searchParams]);
+
+ useKeyboardShortcut("Escape", () => setStagedPartnerIds(null), {
+ enabled: stagedPartnerIds !== null,
+ priority: 2,
+ });
+
+ const { data, error, isLoading } = useApplicationsAnalytics({
+ groupBy: "partnerId",
+ });
+
+ const { table, ...tableProps } = useTable({
+ data: data ?? [],
+ columns: [
+ {
+ id: "partner",
+ header: "Referral partner",
+ enableHiding: false,
+ minSize: 220,
+ cell: ({ row }) => {
+ const partner = row.original.partner;
+
+ if (!partner) {
+ return <span className="text-neutral-400">—</span>;
+ }
+
+ return (
+ <PartnerAnalyticsFilterCell
+ partner={partner}
+ partnerId={partner.id}
+ isStaged={stagedPartnerIds?.includes(partner.id) ?? false}
+ isApplied={activePartnerIdsFromUrl.includes(partner.id)}
+ onToggle={() => toggleStagePartner(partner.id)}
+ onApplyImmediate={() => {
+ queryParams({
+ set: { partnerId: partner.id },
+ del: "page",
+ scroll: false,
+ });
+ setStagedPartnerIds(null);
+ }}
+ />
+ );
+ },
+ },
+ ...APPLICATION_EVENT_STAGES.map((stage) => ({
+ id: stage,
+ header: capitalize(STAGE_VALUE_KEY[stage]) as string,
+ minSize: 160,
+ cell: ({ row }) => {
+ const value = row.original[STAGE_VALUE_KEY[stage]];
+ return <span>{nFormatter(value)}</span>;
+ },
+ })),
+ ],
+ pagination,
+ onPaginationChange: setPagination,
+ thClassName: "border-l-0",
+ tdClassName: "border-l-0",
+ rowCount: data?.length ?? 0,
+ loading: isLoading,
+ error: error ? "Failed to load partners" : undefined,
+ });
+
+ const showFloatingBar = stagedPartnerIds !== null || isFilterActive;
+
+ if (data && data.length === 0) {
+ return null; // hide section if no partner-driven data
+ }
+
+ return (
+ <div className={cn("relative", isLoading && "pointer-events-none")}>
+ <Table
+ {...tableProps}
+ table={table}
+ containerClassName="border-none"
+ scrollWrapperClassName="min-h-[200px]"
+ >
+ <AnimatePresence>
+ {showFloatingBar && (
+ <motion.div
+ initial={{ opacity: 0, y: 8 }}
+ animate={{ opacity: 1, y: 0 }}
+ exit={{ opacity: 0, y: 8 }}
+ transition={{ ease: "easeOut", duration: 0.15 }}
+ className="absolute bottom-1 left-0 z-20 flex h-16 w-full items-end bg-gradient-to-t from-white to-white/0"
+ >
+ <div className="flex w-full items-center justify-center gap-2 pb-2.5">
+ {stagedPartnerIds !== null && stagedPartnerIds.length > 0 && (
+ <Button
+ text="Filter"
+ variant="primary"
+ className="h-8 w-fit rounded-lg px-3 py-2"
+ onClick={applyFilter}
+ />
+ )}
+ <Button
+ text="Clear"
+ variant="secondary"
+ className="h-8 w-fit rounded-lg px-3 py-2"
+ onClick={clearFilter}
+ />
+ </div>
+ </motion.div>
+ )}
+ </AnimatePresence>
+ </Table>
+ </div>
+ );
+}
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-application-events.ts b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-application-events.ts
new file mode 100644
index 0000000000..101749e27b
--- /dev/null
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-application-events.ts
@@ -0,0 +1,34 @@
+import useWorkspace from "@/lib/swr/use-workspace";
+import { ApplicationEvent, ApplicationEventsQuery } from "@/lib/types";
+import { useRouterStuff } from "@dub/ui";
+import { fetcher } from "@dub/utils";
+import useSWR from "swr";
+
+export function useApplicationEvents(filters: ApplicationEventsQuery) {
+ const { id: workspaceId } = useWorkspace();
+ const { getQueryString } = useRouterStuff();
+
+ const queryString = getQueryString(
+ {
+ ...filters,
+ workspaceId,
+ },
+ {
+ exclude: ["pageTab", "applicationEvent", "view"],
+ },
+ );
+
+ const { data, error, isLoading } = useSWR<ApplicationEvent[]>(
+ workspaceId ? `/api/applications/events${queryString}` : null,
+ fetcher,
+ {
+ keepPreviousData: true,
+ },
+ );
+
+ return {
+ data,
+ error,
+ isLoading,
+ };
+}
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-applications-analytics-filters.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-applications-analytics-filters.tsx
new file mode 100644
index 0000000000..37f8103314
--- /dev/null
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-applications-analytics-filters.tsx
@@ -0,0 +1,225 @@
+"use client";
+
+import useWorkspace from "@/lib/swr/use-workspace";
+import { PartnerAvatar } from "@/ui/partners/partner-avatar";
+import { useRouterStuff } from "@dub/ui";
+import { FlagWavy, Globe2, Users } from "@dub/ui/icons";
+import {
+ COUNTRIES,
+ FilterOperator,
+ nFormatter,
+ parseFilterValue,
+} from "@dub/utils";
+import { useCallback, useMemo } from "react";
+import { useApplicationsAnalytics } from "./use-applications-analytics";
+import { useApplicationsAnalyticsQuery } from "./use-applications-analytics-query";
+
+const FILTER_KEYS = ["partnerId", "country", "referralSource"] as const;
+
+export function useApplicationEventsFilters() {
+ const { slug } = useWorkspace();
+ const { stage } = useApplicationsAnalyticsQuery();
+ const { searchParamsObj, queryParams } = useRouterStuff();
+
+ const stageMetricKey = useMemo<
+ "visits" | "starts" | "submissions" | "approvals"
+ >(() => {
+ if (stage === "started") return "starts";
+ if (stage === "submitted") return "submissions";
+ if (stage === "approved") return "approvals";
+ return "visits";
+ }, [stage]);
+
+ const { data: partners } = useApplicationsAnalytics({
+ groupBy: "partnerId",
+ exclude: ["partnerId"],
+ });
+
+ const { data: referralSources } = useApplicationsAnalytics({
+ groupBy: "referralSource",
+ exclude: ["referralSource"],
+ });
+
+ const { data: countries } = useApplicationsAnalytics({
+ groupBy: "country",
+ exclude: ["country"],
+ });
+
+ const filters = useMemo(
+ () => [
+ {
+ key: "partnerId",
+ icon: Users,
+ label: "Partner",
+ shouldFilter: false,
+ options:
+ partners
+ ?.filter((row) => row[stageMetricKey] > 0)
+ .map((row) => {
+ const partner = row.partner;
+
+ return {
+ value: partner.id,
+ label: partner.name,
+ icon: <PartnerAvatar partner={partner} className="size-4" />,
+ right: nFormatter(row[stageMetricKey]),
+ };
+ }) ?? [],
+ },
+ {
+ key: "referralSource",
+ icon: Globe2,
+ label: "Source",
+ labelPlural: "sources",
+ options:
+ referralSources
+ ?.filter((row) => row[stageMetricKey] > 0)
+ .map((row) => ({
+ value: row.referralSource,
+ label: row.referralSource,
+ right: nFormatter(row[stageMetricKey]),
+ })) ?? [],
+ },
+ {
+ key: "country",
+ icon: FlagWavy,
+ label: "Country",
+ labelPlural: "countries",
+ getOptionIcon: (value: unknown) => {
+ if (typeof value !== "string") return null;
+
+ return (
+ <img
+ alt={value}
+ src={`https://hatscripts.github.io/circle-flags/flags/${value.toLowerCase()}.svg`}
+ className="size-4 shrink-0"
+ />
+ );
+ },
+ getOptionLabel: (value: unknown) => {
+ if (typeof value !== "string") return String(value);
+ return COUNTRIES[value] ?? value;
+ },
+ options:
+ countries
+ ?.filter((row) => row[stageMetricKey] > 0)
+ .map((row) => ({
+ value: row.country,
+ label: COUNTRIES[row.country] ?? row.country,
+ right: nFormatter(row[stageMetricKey]),
+ })) ?? [],
+ },
+ ],
+ [countries, partners, referralSources, slug, stageMetricKey],
+ );
+
+ const activeFilters = useMemo(() => {
+ const result: {
+ key: string;
+ operator: FilterOperator;
+ values: string[];
+ }[] = [];
+
+ for (const key of FILTER_KEYS) {
+ const raw = searchParamsObj[key];
+ if (!raw) continue;
+ const parsed = parseFilterValue(raw);
+ if (parsed)
+ result.push({ key, operator: parsed.operator, values: parsed.values });
+ }
+
+ return result;
+ }, [
+ searchParamsObj.partnerId,
+ searchParamsObj.groupId,
+ searchParamsObj.country,
+ searchParamsObj.referralSource,
+ ]);
+
+ const onSelect = useCallback(
+ (key: string, value: string) => {
+ const currentParam = searchParamsObj[key];
+
+ if (!currentParam) {
+ queryParams({ set: { [key]: value }, del: "page", scroll: false });
+ return;
+ }
+
+ const parsed = parseFilterValue(currentParam);
+ if (parsed && !parsed.values.includes(value)) {
+ const newValues = [...parsed.values, value];
+ const newParam = parsed.operator.includes("NOT")
+ ? `-${newValues.join(",")}`
+ : newValues.join(",");
+ queryParams({ set: { [key]: newParam }, del: "page", scroll: false });
+ }
+ },
+ [searchParamsObj, queryParams],
+ );
+
+ const onRemove = useCallback(
+ (key: string, value: string) => {
+ const currentParam = searchParamsObj[key];
+ if (!currentParam) return;
+
+ const parsed = parseFilterValue(currentParam);
+ if (!parsed) {
+ queryParams({ del: [key, "page"], scroll: false });
+ return;
+ }
+
+ const newValues = parsed.values.filter((v) => v !== value);
+ if (newValues.length === 0) {
+ queryParams({ del: [key, "page"], scroll: false });
+ } else {
+ const newParam = parsed.operator.includes("NOT")
+ ? `-${newValues.join(",")}`
+ : newValues.join(",");
+ queryParams({ set: { [key]: newParam }, del: "page", scroll: false });
+ }
+ },
+ [searchParamsObj, queryParams],
+ );
+
+ const onRemoveFilter = useCallback(
+ (key: string) => queryParams({ del: [key, "page"], scroll: false }),
+ [queryParams],
+ );
+
+ const onRemoveAll = useCallback(
+ () =>
+ queryParams({
+ del: [...FILTER_KEYS, "page"],
+ scroll: false,
+ }),
+ [queryParams],
+ );
+
+ const onToggleOperator = useCallback(
+ (key: string) => {
+ const currentParam = searchParamsObj[key];
+ if (!currentParam) return;
+ const isNegated = currentParam.startsWith("-");
+ const cleanValue = isNegated ? currentParam.slice(1) : currentParam;
+ queryParams({
+ set: { [key]: isNegated ? cleanValue : `-${cleanValue}` },
+ del: "page",
+ scroll: false,
+ });
+ },
+ [searchParamsObj, queryParams],
+ );
+
+ const onOpenFilter = useCallback((_key: string | null) => {}, []);
+
+ return {
+ filters,
+ activeFilters,
+ onSelect,
+ onRemove,
+ onRemoveFilter,
+ onRemoveAll,
+ onToggleOperator,
+ onOpenFilter,
+ };
+}
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-applications-analytics-query.ts b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-applications-analytics-query.ts
new file mode 100644
index 0000000000..7b60bb82f9
--- /dev/null
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-applications-analytics-query.ts
@@ -0,0 +1,37 @@
+"use client";
+
+import { ApplicationEventStages } from "@/lib/types";
+import { useRouterStuff } from "@dub/ui";
+import { useMemo } from "react";
+
+export type ApplicationsView = "timeseries" | "funnel";
+
+function parseStage(raw: unknown): ApplicationEventStages {
+ if (raw === "started") return "started";
+ if (raw === "submitted") return "submitted";
+ if (raw === "approved") return "approved";
+ return "visited";
+}
+
+function parseView(raw: unknown): ApplicationsView {
+ return raw === "timeseries" ? "timeseries" : "funnel";
+}
+
+export function useApplicationsAnalyticsQuery() {
+ const { searchParamsObj } = useRouterStuff();
+
+ const stage = useMemo<ApplicationEventStages>(
+ () => parseStage(searchParamsObj.applicationEvent),
+ [searchParamsObj.applicationEvent],
+ );
+
+ const view = useMemo<ApplicationsView>(
+ () => parseView(searchParamsObj.view),
+ [searchParamsObj.view],
+ );
+
+ return {
+ stage,
+ view,
+ };
+}
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-applications-analytics.ts b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-applications-analytics.ts
new file mode 100644
index 0000000000..3777f37702
--- /dev/null
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/applications/use-applications-analytics.ts
@@ -0,0 +1,96 @@
+import useWorkspace from "@/lib/swr/use-workspace";
+import {
+ ApplicationAnalyticsByGroup,
+ ApplicationEventAnalyticsQuery,
+} from "@/lib/types";
+import { useRouterStuff } from "@dub/ui";
+import { fetcher } from "@dub/utils";
+import useSWR from "swr";
+
+type ApplicationAnalyticsFilterKey = Extract<
+ keyof ApplicationEventAnalyticsQuery,
+ "partnerId" | "referralSource" | "country"
+>;
+
+interface UseApplicationsAnalyticsProps<
+ TGroupBy extends keyof ApplicationAnalyticsByGroup,
+> extends ApplicationEventAnalyticsQuery {
+ groupBy: TGroupBy;
+ exclude?: ApplicationAnalyticsFilterKey[];
+}
+
+export function useApplicationsAnalytics<
+ TGroupBy extends keyof ApplicationAnalyticsByGroup,
+>({ exclude, ...filters }: UseApplicationsAnalyticsProps<TGroupBy>) {
+ const { id: workspaceId } = useWorkspace();
+ const { getQueryString } = useRouterStuff();
+
+ const queryString = getQueryString(
+ {
+ ...filters,
+ workspaceId,
+ },
+ {
+ exclude: [
+ "pageTab",
+ "applicationEvent",
+ "view",
+ "sortBy",
+ "sortOrder",
+ "page",
+ "pageSize",
+ ...(exclude ?? []),
+ ],
+ },
+ );
+
+ const { data, error, isLoading } = useSWR<
+ ApplicationAnalyticsByGroup[TGroupBy][]
+ >(workspaceId ? `/api/applications/analytics${queryString}` : null, fetcher, {
+ keepPreviousData: true,
+ });
+
+ return {
+ data,
+ error,
+ isLoading,
+ };
+}
+
+export function useApplicationsAnalyticsCount(
+ filters: Omit<ApplicationEventAnalyticsQuery, "groupBy"> = {},
+) {
+ const { id: workspaceId } = useWorkspace();
+ const { getQueryString } = useRouterStuff();
+
+ const queryString = getQueryString(
+ {
+ ...filters,
+ groupBy: "count",
+ workspaceId,
+ },
+ {
+ exclude: [
+ "pageTab",
+ "applicationEvent",
+ "view",
+ "sortBy",
+ "sortOrder",
+ "page",
+ "pageSize",
+ ],
+ },
+ );
+
+ const { data, error, isLoading } = useSWR<
+ ApplicationAnalyticsByGroup["count"]
+ >(workspaceId ? `/api/applications/analytics${queryString}` : null, fetcher, {
+ keepPreviousData: true,
+ });
+
+ return {
+ data,
+ error,
+ isLoading,
+ };
+}
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-analytics-cards.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-analytics-cards.tsx
index 80998ceb72..98a7ff243c 100644
--- a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-analytics-cards.tsx
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-analytics-cards.tsx
@@ -1,9 +1,8 @@
"use client";
-import useCommissionAnalytics, {
- CommissionCategoryRow,
-} from "@/lib/swr/use-commission-analytics";
+import useCommissionAnalytics from "@/lib/swr/use-commission-analytics";
import useGroups from "@/lib/swr/use-groups";
+import { CommissionCategoryRow } from "@/lib/types";
import { AnalyticsLoadingSpinner } from "@/ui/analytics/analytics-loading-spinner";
import { BarList } from "@/ui/analytics/bar-list";
import { CommissionTypeIcon } from "@/ui/partners/comission-type-icon";
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-partners-table.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-partners-table.tsx
index b5ec6829c4..9901794e0c 100644
--- a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-partners-table.tsx
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-partners-table.tsx
@@ -1,8 +1,7 @@
"use client";
-import useCommissionAnalytics, {
- CommissionAnalyticsPartnerRow,
-} from "@/lib/swr/use-commission-analytics";
+import useCommissionAnalytics from "@/lib/swr/use-commission-analytics";
+import { CommissionAnalyticsPartnerRow } from "@/lib/types";
import { CountryFlag } from "@/ui/shared/country-flag";
import {
Button,
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-status-selector.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-status-selector.tsx
index 349238fa50..0409214890 100644
--- a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-status-selector.tsx
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/commissions-status-selector.tsx
@@ -2,9 +2,10 @@
import { CommissionsCount } from "@/lib/types";
import { ToggleGroup, useMediaQuery, useRouterStuff } from "@dub/ui";
-import { fetcher } from "@dub/utils";
+import { cn, fetcher } from "@dub/utils";
import NumberFlow, { NumberFlowGroup } from "@number-flow/react";
import { ChevronRight } from "lucide-react";
+import Link from "next/link";
import useSWR from "swr";
export type CommissionStatusFilter =
| "pending"
@@ -72,7 +73,7 @@ export function CommissionsStatusSelector({
const key = id ?? "all";
const earnings = commissionsCount?.[key]?.earnings ?? 0;
const count = commissionsCount?.[key]?.count ?? 0;
- const isActive = id === status;
+ const displayValue = unit === "earnings" ? earnings / 100 : count;
const isLast = idx === STATUS_TABS.length - 1;
return (
@@ -85,34 +86,43 @@ export function CommissionsStatusSelector({
/>
</div>
)}
- <button
- className="border-box relative block h-full w-full min-w-[80px] flex-none px-4 py-3 text-left transition-colors hover:bg-neutral-50 focus:outline-none active:bg-neutral-100 sm:min-w-[180px] sm:px-8 sm:py-6"
- onClick={() =>
- id === undefined
- ? queryParams({ del: "status", scroll: false })
- : queryParams({ set: { status: id }, scroll: false })
+ <Link
+ className={cn(
+ "border-box relative block h-full w-full min-w-[110px] flex-none px-4 py-3 text-left sm:min-w-[240px] sm:px-8 sm:py-6",
+ "transition-colors hover:bg-neutral-50 focus:outline-none active:bg-neutral-100",
+ "ring-inset ring-neutral-500 focus-visible:ring-1",
+ )}
+ href={
+ queryParams({
+ ...(id === undefined
+ ? { del: "status" }
+ : { set: { status: id } }),
+ scroll: false,
+ getNewPath: true,
+ }) as string
}
+ aria-current={status === id ? "page" : undefined}
>
<div
- className={[
+ className={cn(
"absolute bottom-0 left-0 h-0.5 w-full bg-black transition-transform duration-100",
- !isActive ? "translate-y-[3px]" : "",
- ].join(" ")}
+ status !== id && "translate-y-[3px]",
+ )}
/>
<div className="flex items-center gap-2.5 text-sm text-neutral-600">
<div
- className={[
+ className={cn(
"h-2 w-2 rounded-sm bg-current shadow-[inset_0_0_0_1px_#00000019]",
colorClassName,
- ].join(" ")}
+ )}
/>
<span>{label}</span>
</div>
<div className="mt-1 flex h-12 items-center">
{commissionsCount ? (
<NumberFlow
- value={unit === "earnings" ? earnings / 100 : count}
- className="text-xl font-medium sm:text-2xl"
+ value={displayValue}
+ className="text-xl font-medium sm:text-3xl"
format={
unit === "earnings"
? {
@@ -133,10 +143,10 @@ export function CommissionsStatusSelector({
}
/>
) : (
- <div className="h-9 w-24 animate-pulse rounded-md bg-neutral-200" />
+ <div className="h-9 w-16 animate-pulse rounded-md bg-neutral-200" />
)}
</div>
- </button>
+ </Link>
{isLast && (
<ToggleGroup
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/page.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/page.tsx
index e857d8d5cd..91be986f07 100644
--- a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/page.tsx
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/page.tsx
@@ -3,6 +3,9 @@
import { notFound, useParams } from "next/navigation";
import { AnalyticsChart } from "./analytics-chart";
import { AnalyticsPartnersTable } from "./analytics-partners-table";
+import { ApplicationsFunnelChart } from "./applications/applications-funnel-chart";
+import { ApplicationsPartnersTable } from "./applications/applications-partners-table";
+import { useApplicationsAnalyticsQuery } from "./applications/use-applications-analytics-query";
import { CommissionsAnalyticsChart } from "./commissions-analytics-chart";
import { CommissionsPartnersTable } from "./commissions-partners-table";
import { CommissionsStatusSelector } from "./commissions-status-selector";
@@ -23,6 +26,10 @@ export default function ProgramAnalyticsTabPage() {
return <CommissionsTab />;
}
+ if (tab === "applications") {
+ return <ApplicationsTab />;
+ }
+
return (
<>
<AnalyticsChart />
@@ -63,3 +70,18 @@ function CommissionsTab() {
</>
);
}
+
+function ApplicationsTab() {
+ const { stage: applicationsStage, view: applicationsView } =
+ useApplicationsAnalyticsQuery();
+
+ return (
+ <>
+ <ApplicationsFunnelChart
+ stage={applicationsStage}
+ view={applicationsView}
+ />
+ <ApplicationsPartnersTable />
+ </>
+ );
+}
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/program-analytics-nav.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/program-analytics-nav.tsx
index a99c724a5e..ab1cf72977 100644
--- a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/program-analytics-nav.tsx
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/program-analytics-nav.tsx
@@ -2,9 +2,12 @@
import useWorkspace from "@/lib/swr/use-workspace";
import { PageNavTabs } from "@/ui/layout/page-nav-tabs";
-import { InvoiceDollar, LinesY } from "@dub/ui";
+import { InvoiceDollar, LinesY, UserCheck } from "@dub/ui";
-export type ProgramAnalyticsTabId = "performance" | "commissions";
+export type ProgramAnalyticsTabId =
+ | "performance"
+ | "commissions"
+ | "applications";
export const PROGRAM_ANALYTICS_TABS: {
id: ProgramAnalyticsTabId;
@@ -13,6 +16,7 @@ export const PROGRAM_ANALYTICS_TABS: {
}[] = [
{ id: "performance", label: "Performance", icon: LinesY },
{ id: "commissions", label: "Commissions", icon: InvoiceDollar },
+ { id: "applications", label: "Applications", icon: UserCheck },
];
export function ProgramAnalyticsNav() {
diff --git a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/program-analytics-shell.tsx b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/program-analytics-shell.tsx
index 4a6b284d0e..a638484ec4 100644
--- a/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/program-analytics-shell.tsx
+++ b/apps/web/app/app.dub.co/(dashboard)/[slug]/(ee)/program/analytics/program-analytics-shell.tsx
@@ -20,13 +20,17 @@ import {
useMediaQuery,
useRouterStuff,
} from "@dub/ui";
-import { cn, fetcher } from "@dub/utils";
+import { capitalize, cn, fetcher } from "@dub/utils";
import Link from "next/link";
import { useParams } from "next/navigation";
import { ContextType, ReactNode, useMemo } from "react";
import useSWR from "swr";
+import { ApplicationsAnalyticsCards } from "./applications/applications-analytics-cards";
+import { useApplicationEventsFilters } from "./applications/use-applications-analytics-filters";
+import { useApplicationsAnalyticsQuery } from "./applications/use-applications-analytics-query";
import { CommissionsAnalyticsCards } from "./commissions-analytics-cards";
import {
+ PROGRAM_ANALYTICS_TABS,
ProgramAnalyticsNav,
ProgramAnalyticsTabId,
} from "./program-analytics-nav";
@@ -41,13 +45,16 @@ export function ProgramAnalyticsShell({ children }: { children: ReactNode }) {
const { tab } = useParams() as { tab?: string };
const pageTab: ProgramAnalyticsTabId =
- tab && ["performance", "commissions"].includes(tab)
+ tab && PROGRAM_ANALYTICS_TABS.some((t) => t.id === tab)
? (tab as ProgramAnalyticsTabId)
: "performance";
const { queryString: commissionsQueryString, status: commissionStatus } =
useCommissionsAnalyticsQuery();
+ const { stage: applicationsStage, view: applicationsView } =
+ useApplicationsAnalyticsQuery();
+
const { start, end, interval, selectedTab, saleUnit, view } = useMemo(() => {
const { event, ...rest } = searchParamsObj;
@@ -116,19 +123,19 @@ export function ProgramAnalyticsShell({ children }: { children: ReactNode }) {
setSearch: commSetSearch,
} = useCommissionsAnalyticsFilters(commissionsQueryString);
+ const {
+ filters: applicationsFilters,
+ activeFilters: applicationsActiveFilters,
+ onSelect: applicationsOnSelect,
+ onRemove: applicationsOnRemove,
+ onRemoveFilter: applicationsOnRemoveFilter,
+ onRemoveAll: applicationsOnRemoveAll,
+ onOpenFilter: applicationsOnOpenFilter,
+ onToggleOperator: applicationsOnToggleOperator,
+ } = useApplicationEventsFilters();
+
const filterSelect =
- pageTab === "performance" ? (
- <Filter.Select
- className="w-full md:w-fit"
- filters={perfFilters}
- activeFilters={perfActiveFilters}
- onSelect={perfOnSelect}
- onRemove={perfOnRemove}
- onOpenFilter={perfOnOpenFilter}
- isAdvancedFilter
- askAI
- />
- ) : (
+ pageTab === "commissions" ? (
<Filter.Select
className="w-full md:w-fit"
filters={commFilters}
@@ -139,6 +146,27 @@ export function ProgramAnalyticsShell({ children }: { children: ReactNode }) {
onSearchChange={commSetSearch}
isAdvancedFilter
/>
+ ) : pageTab === "applications" ? (
+ <Filter.Select
+ className="w-full md:w-fit"
+ filters={applicationsFilters}
+ activeFilters={applicationsActiveFilters}
+ onSelect={applicationsOnSelect}
+ onRemove={applicationsOnRemove}
+ onOpenFilter={applicationsOnOpenFilter}
+ isAdvancedFilter
+ />
+ ) : (
+ <Filter.Select
+ className="w-full md:w-fit"
+ filters={perfFilters}
+ activeFilters={perfActiveFilters}
+ onSelect={perfOnSelect}
+ onRemove={perfOnRemove}
+ onOpenFilter={perfOnOpenFilter}
+ isAdvancedFilter
+ askAI
+ />
);
const dateRangePicker = (
@@ -168,33 +196,28 @@ export function ProgramAnalyticsShell({ children }: { children: ReactNode }) {
<div className="flex w-full grow items-center gap-2 md:w-auto">
{dateRangePicker}
<div className="flex grow justify-end gap-2">
- {pageTab === "performance" ? (
- <Link
- href={`/${slug}/events${getQueryString({ folderId: program?.defaultFolderId, event: selectedTab, interval })}`}
- >
- <Button
- variant="secondary"
- className="w-fit"
- icon={
- <SquareLayoutGrid6 className="h-4 w-4 text-neutral-600" />
- }
- text={isMobile ? undefined : "View Events"}
- />
- </Link>
- ) : (
- <Link
- href={`/${slug}/program/commissions${getQueryString({}, { exclude: ["pageTab", "commissionUnit", "event", "saleUnit", "view"] })}`}
- >
- <Button
- variant="secondary"
- className="w-fit"
- icon={
- <SquareLayoutGrid6 className="h-4 w-4 text-neutral-600" />
- }
- text={isMobile ? undefined : "View Commissions"}
- />
- </Link>
- )}
+ <Link
+ href={
+ pageTab === "commissions"
+ ? `/${slug}/program/commissions${getQueryString({}, { include: ["interval", "start", "end", "partnerId", "groupId", "type"] })}`
+ : pageTab === "applications"
+ ? `/${slug}/program/partners/applications`
+ : `/${slug}/events${getQueryString({ folderId: program?.defaultFolderId, event: selectedTab, interval })}`
+ }
+ >
+ <Button
+ variant="secondary"
+ className="w-fit"
+ icon={
+ <SquareLayoutGrid6 className="h-4 w-4 text-neutral-600" />
+ }
+ text={
+ isMobile
+ ? undefined
+ : `View ${pageTab === "performance" ? "Events" : capitalize(pageTab)}`
+ }
+ />
+ </Link>
</div>
</div>
</div>
@@ -203,27 +226,15 @@ export function ProgramAnalyticsShell({ children }: { children: ReactNode }) {
<div
className={cn(
"transition-[height] duration-[300ms]",
- pageTab === "performance"
- ? streaming || perfActiveFilters.length
- ? "h-3"
- : "h-0"
- : commActiveFilters.length
- ? "h-3"
- : "h-0",
+ streaming ||
+ perfActiveFilters.length ||
+ commActiveFilters.length ||
+ applicationsActiveFilters.length
+ ? "h-3"
+ : "h-0",
)}
/>
- {pageTab === "performance" ? (
- <Filter.List
- filters={perfFilters}
- activeFilters={activeFiltersWithStreaming}
- onSelect={perfOnSelect}
- onRemove={perfOnRemove}
- onRemoveFilter={perfOnRemoveFilter}
- onRemoveAll={perfOnRemoveAll}
- onToggleOperator={perfOnToggleOperator}
- isAdvancedFilter
- />
- ) : (
+ {pageTab === "commissions" ? (
<Filter.List
filters={commFilters}
activeFilters={commActiveFilters}
@@ -234,6 +245,28 @@ export function ProgramAnalyticsShell({ children }: { children: ReactNode }) {
onToggleOperator={commOnToggleOperator}
isAdvancedFilter
/>
+ ) : pageTab === "applications" ? (
+ <Filter.List
+ filters={applicationsFilters}
+ activeFilters={applicationsActiveFilters}
+ onSelect={applicationsOnSelect}
+ onRemove={applicationsOnRemove}
+ onRemoveFilter={applicationsOnRemoveFilter}
+ onRemoveAll={applicationsOnRemoveAll}
+ onToggleOperator={applicationsOnToggleOperator}
+ isAdvancedFilter
+ />
+ ) : (
+ <Filter.List
+ filters={perfFilters}
+ activeFilters={activeFiltersWithStreaming}
+ onSelect={perfOnSelect}
+ onRemove={perfOnRemove}
+ onRemoveFilter={perfOnRemoveFilter}
+ onRemoveAll={perfOnRemoveAll}
+ onToggleOperator={perfOnToggleOperator}
+ isAdvancedFilter
+ />
)}
</div>
</div>
@@ -245,18 +278,20 @@ export function ProgramAnalyticsShell({ children }: { children: ReactNode }) {
</div>
</div>
- {pageTab === "performance" ? (
+ {pageTab === "commissions" ? (
+ <CommissionsAnalyticsCards
+ status={commissionStatus}
+ queryString={commissionsQueryString}
+ />
+ ) : pageTab === "applications" ? (
+ <ApplicationsAnalyticsCards stage={applicationsStage} />
+ ) : (
<div className="grid grid-cols-1 gap-5 md:grid-cols-2">
<PartnerSection />
<ReferrersUTMs />
<LocationSection />
<DeviceSection />
</div>
- ) : (
- <CommissionsAnalyticsCards
- status={commissionStatus}
- queryString={commissionsQueryString}
- />
)}
</div>
</AnalyticsContext.Provider>
diff --git a/apps/web/app/app.dub.co/layout.tsx b/apps/web/app/app.dub.co/layout.tsx
index 9557d328a2..c9900f4fa0 100644
--- a/apps/web/app/app.dub.co/layout.tsx
+++ b/apps/web/app/app.dub.co/layout.tsx
@@ -1,12 +1,22 @@
"use client";
import { ModalProvider } from "@/ui/modals/modal-provider";
+import { Analytics as DubAnalytics } from "@dub/analytics/react";
import { SessionProvider } from "next-auth/react";
import { ReactNode } from "react";
export default function AppLayout({ children }: { children: ReactNode }) {
return (
<SessionProvider>
+ <DubAnalytics
+ apiHost="/_proxy/dub"
+ cookieOptions={{
+ domain: process.env.VERCEL === "1" ? ".dub.co" : "localhost",
+ }}
+ domainsConfig={{
+ refer: "refer.dub.co",
+ }}
+ />
<ModalProvider>{children}</ModalProvider>
</SessionProvider>
);
diff --git a/apps/web/app/providers.tsx b/apps/web/app/providers.tsx
index 9d916efea4..ac1071be3e 100644
--- a/apps/web/app/providers.tsx
+++ b/apps/web/app/providers.tsx
@@ -1,6 +1,5 @@
"use client";
-import { Analytics as DubAnalytics } from "@dub/analytics/react";
import { KeyboardShortcutProvider, TooltipProvider } from "@dub/ui";
import PlausibleProvider from "next-plausible";
import { ReactNode } from "react";
@@ -23,15 +22,6 @@ export default function RootProviders({ children }: { children: ReactNode }) {
<KeyboardShortcutProvider>
<Toaster className="pointer-events-auto" closeButton />
{children}
- <DubAnalytics
- apiHost="/_proxy/dub"
- cookieOptions={{
- domain: process.env.VERCEL === "1" ? ".dub.co" : "localhost",
- }}
- domainsConfig={{
- refer: "refer.dub.co",
- }}
- />
</KeyboardShortcutProvider>
</PlausibleProvider>
</TooltipProvider>
diff --git a/apps/web/lib/actions/partners/bulk-approve-partners.ts b/apps/web/lib/actions/partners/bulk-approve-partners.ts
index 61d08c4650..58d563d23d 100644
--- a/apps/web/lib/actions/partners/bulk-approve-partners.ts
+++ b/apps/web/lib/actions/partners/bulk-approve-partners.ts
@@ -3,6 +3,7 @@
import { trackActivityLog } from "@/lib/api/activity-log/track-activity-log";
import { getGroupOrThrow } from "@/lib/api/groups/get-group-or-throw";
import { getDefaultProgramIdOrThrow } from "@/lib/api/programs/get-default-program-id-or-throw";
+import { trackApplicationEvents } from "@/lib/application-events/update-application-event";
import { triggerWorkflows } from "@/lib/cron/qstash-workflow";
import { throwIfPartnersLimitExceeded } from "@/lib/partners/throw-if-partners-limit-exceeded";
import { bulkApprovePartnersSchema } from "@/lib/zod/schemas/partners";
@@ -150,6 +151,12 @@ export const bulkApprovePartnersAction = authActionClient
},
})),
),
+
+ trackApplicationEvents({
+ event: "approved",
+ programId: program.id,
+ partnerIds: updatedEnrollments.map(({ partnerId }) => partnerId),
+ }),
]);
})(),
);
diff --git a/apps/web/lib/actions/partners/bulk-reject-partner-applications.ts b/apps/web/lib/actions/partners/bulk-reject-partner-applications.ts
index 1e51ffe38b..27f4700c88 100644
--- a/apps/web/lib/actions/partners/bulk-reject-partner-applications.ts
+++ b/apps/web/lib/actions/partners/bulk-reject-partner-applications.ts
@@ -3,6 +3,7 @@
import { trackActivityLog } from "@/lib/api/activity-log/track-activity-log";
import { resolveFraudGroups } from "@/lib/api/fraud/resolve-fraud-groups";
import { getDefaultProgramIdOrThrow } from "@/lib/api/programs/get-default-program-id-or-throw";
+import { trackApplicationEvents } from "@/lib/application-events/update-application-event";
import { bulkRejectPartnersSchema } from "@/lib/zod/schemas/partners";
import { sendBatchEmail } from "@dub/email";
import PartnerApplicationRejected from "@dub/email/templates/partner-application-rejected";
@@ -116,6 +117,12 @@ export const bulkRejectPartnerApplicationsAction = authActionClient
resolutionReason:
"Resolved automatically because the partner application was rejected.",
}),
+
+ trackApplicationEvents({
+ event: "rejected",
+ programId,
+ partnerIds: programEnrollments.map(({ partner }) => partner.id),
+ }),
]);
const program = await prisma.program.findUniqueOrThrow({
diff --git a/apps/web/lib/actions/partners/create-program-application.ts b/apps/web/lib/actions/partners/create-program-application.ts
index 5f301a4e72..450adeeb00 100644
--- a/apps/web/lib/actions/partners/create-program-application.ts
+++ b/apps/web/lib/actions/partners/create-program-application.ts
@@ -4,6 +4,8 @@ import { createId } from "@/lib/api/create-id";
import { detectAndRecordFraudApplication } from "@/lib/api/fraud/detect-record-fraud-application";
import { notifyPartnerApplication } from "@/lib/api/partners/notify-partner-application";
import { getIP } from "@/lib/api/utils/get-ip";
+import { markApplicationEventSubmitted } from "@/lib/application-events/update-application-event";
+import { getApplicationEventCookieName } from "@/lib/application-events/utils";
import { getSession } from "@/lib/auth";
import { qstash } from "@/lib/cron";
import { getPartnerProfileChecklistProgress } from "@/lib/network/get-partner-profile-checklist-progress";
@@ -327,7 +329,7 @@ async function createApplicationAndEnrollment({
}),
);
- await Promise.all([
+ await Promise.allSettled([
notifyPartnerApplication({
partner,
program,
@@ -371,6 +373,8 @@ async function createApplicationAndEnrollment({
partner,
},
}),
+
+ markApplicationEventSubmitted(programEnrollment),
]);
})(),
);
@@ -418,6 +422,23 @@ async function createApplication({
},
);
+ // Attach application ID to application events
+ const cookieName = getApplicationEventCookieName(program.id);
+ const eventId = cookieStore.get(cookieName)?.value;
+
+ if (eventId) {
+ try {
+ await prisma.programApplicationEvent.update({
+ where: {
+ id: eventId,
+ },
+ data: {
+ programApplicationId: application.id,
+ },
+ });
+ } catch {}
+ }
+
return {
programApplicationId: application.id,
partnerData: {
diff --git a/apps/web/lib/actions/partners/onboard-partner.ts b/apps/web/lib/actions/partners/onboard-partner.ts
index 9665d83284..b507f9d5d6 100644
--- a/apps/web/lib/actions/partners/onboard-partner.ts
+++ b/apps/web/lib/actions/partners/onboard-partner.ts
@@ -23,6 +23,11 @@ export const onboardPartnerAction = authUserActionClient
where: {
email: user.email,
},
+ select: {
+ id: true,
+ country: true,
+ profileType: true,
+ },
});
const partnerId = existingPartner
diff --git a/apps/web/lib/actions/partners/update-partner-profile.ts b/apps/web/lib/actions/partners/update-partner-profile.ts
index f45b6d1bbf..b8f4854e1a 100644
--- a/apps/web/lib/actions/partners/update-partner-profile.ts
+++ b/apps/web/lib/actions/partners/update-partner-profile.ts
@@ -18,12 +18,39 @@ import {
deepEqual,
nanoid,
PARTNERS_DOMAIN,
+ RESERVED_SLUGS,
} from "@dub/utils";
import { waitUntil } from "@vercel/functions";
import * as z from "zod/v4";
import { uploadedImageSchema } from "../../zod/schemas/images";
import { authPartnerActionClient } from "../safe-action";
+const USERNAME_REGEX = /^(?![_-])(?!.*[_-]{2})[a-z0-9_-]{3,30}(?<![_-])$/;
+
+// TODO: Add more reserved usernames
+const RESERVED_USERNAMES = [...RESERVED_SLUGS, "dub"];
+
+const usernameSchema = z
+ .string()
+ .trim()
+ .toLowerCase()
+ .pipe(
+ z
+ .string()
+ .min(3, "Username must be at least 3 characters")
+ .max(30, "Username must be at most 30 characters")
+ .regex(USERNAME_REGEX, "Invalid username format"),
+ )
+ .pipe(
+ z
+ .string()
+ .refine(
+ (v) => !RESERVED_USERNAMES.includes(v),
+ "This username is reserved",
+ ),
+ )
+ .nullish();
+
const updatePartnerProfileSchema = z
.object({
name: z.string().trim().min(1, "Name is required").optional(),
@@ -33,6 +60,7 @@ const updatePartnerProfileSchema = z
country: z.enum(Object.keys(COUNTRIES) as [string, ...string[]]).nullish(),
profileType: z.enum(PartnerProfileType).optional(),
companyName: z.string().nullish(),
+ username: usernameSchema,
})
.extend(PartnerProfileSchema.partial().shape)
.transform((data) => ({
@@ -63,6 +91,7 @@ export const updatePartnerProfileAction = authPartnerActionClient
industryInterests,
preferredEarningStructures,
salesChannels,
+ username,
} = parsedInput;
if (
@@ -89,6 +118,21 @@ export const updatePartnerProfileAction = authPartnerActionClient
imageUrl = uploaded.url;
}
+ if (username && username !== partner.username) {
+ const existingPartner = await prisma.partner.findUnique({
+ where: {
+ username,
+ },
+ select: {
+ id: true,
+ },
+ });
+
+ if (existingPartner && existingPartner.id !== partner.id) {
+ throw new Error(`Username "${username}" is already taken.`);
+ }
+ }
+
try {
const updatedPartner = await prisma.partner.update({
where: {
@@ -98,6 +142,7 @@ export const updatePartnerProfileAction = authPartnerActionClient
name,
description,
...(imageUrl && { image: imageUrl }),
+ username,
country,
profileType,
companyName,
diff --git a/apps/web/lib/api/create-id.ts b/apps/web/lib/api/create-id.ts
index 8d53ac857d..f84afc8d97 100644
--- a/apps/web/lib/api/create-id.ts
+++ b/apps/web/lib/api/create-id.ts
@@ -19,6 +19,7 @@ const prefixes = [
"dpn_", // discovered partner
"prog_", // program
"pga_", // program application
+ "pga_evt_", // program application event
"pgi_", // program invitation
"pge_", // program enrollment
"pgr_", // program resources
diff --git a/apps/web/lib/api/partners/applications/approve-partner.ts b/apps/web/lib/api/partners/applications/approve-partner.ts
index b5a3ad092b..57bc300461 100644
--- a/apps/web/lib/api/partners/applications/approve-partner.ts
+++ b/apps/web/lib/api/partners/applications/approve-partner.ts
@@ -1,3 +1,4 @@
+import { trackApplicationEvents } from "@/lib/application-events/update-application-event";
import { prisma } from "@dub/prisma";
import { ProgramEnrollmentStatus } from "@dub/prisma/client";
import { waitUntil } from "@vercel/functions";
@@ -142,6 +143,12 @@ export async function approvePartner({
},
}),
+ trackApplicationEvents({
+ event: "approved",
+ programId,
+ partnerIds: [partnerId],
+ }),
+
triggerWorkflows({
workflowId: "partner-approved",
body: {
diff --git a/apps/web/lib/api/partners/applications/reject-partner.ts b/apps/web/lib/api/partners/applications/reject-partner.ts
index 32d35e212d..f446a05ce4 100644
--- a/apps/web/lib/api/partners/applications/reject-partner.ts
+++ b/apps/web/lib/api/partners/applications/reject-partner.ts
@@ -1,3 +1,4 @@
+import { trackApplicationEvents } from "@/lib/application-events/update-application-event";
import { getProgramApplicationRejectionReasonLabel } from "@/lib/partners/program-application-rejection";
import { WorkspaceProps } from "@/lib/types";
import { rejectPartnerSchema } from "@/lib/zod/schemas/partners";
@@ -131,6 +132,12 @@ export async function rejectPartner({
},
}),
+ trackApplicationEvents({
+ event: "rejected",
+ programId,
+ partnerIds: [partnerId],
+ }),
+
resolveFraudGroups({
where: {
programId,
diff --git a/apps/web/lib/application-events/schema.ts b/apps/web/lib/application-events/schema.ts
new file mode 100644
index 0000000000..c7924badb8
--- /dev/null
+++ b/apps/web/lib/application-events/schema.ts
@@ -0,0 +1,110 @@
+import { GroupSchema } from "@/lib/zod/schemas/groups";
+import { PartnerSchema } from "@/lib/zod/schemas/partners";
+import * as z from "zod/v4";
+import { analyticsQuerySchema } from "../zod/schemas/analytics";
+
+export const APPLICATION_ID_COOKIE_PREFIX = "dub_app_evt_id_";
+
+export const APPLICATION_ID_COOKIE_MAX_AGE = 60 * 60 * 24 * 30; // 30 days
+
+export const APPLICATION_EVENT_STAGES = [
+ "visited",
+ "started",
+ "submitted",
+ "approved",
+] as const;
+
+export const trackApplicationEventSchema = z.object({
+ eventName: z.enum(["visit", "start"]),
+ url: z.url(),
+ referrer: z.string().nullish(),
+});
+
+const sharedFilterSchema = analyticsQuerySchema
+ .pick({
+ start: true,
+ end: true,
+ interval: true,
+ timezone: true,
+ })
+ .extend({
+ partnerId: z.string().optional(),
+ referralSource: z.string().optional(),
+ country: z.string().optional(),
+ });
+
+// Application events
+export const applicationEventsQuerySchema = sharedFilterSchema.extend({
+ event: z
+ .enum(["visited", "started", "submitted", "approved", "rejected"])
+ .optional(),
+ page: z.coerce.number().default(1),
+ pageSize: z.coerce.number().max(100).default(50),
+ sortOrder: z.enum(["asc", "desc"]).default("desc"),
+ sortBy: z
+ .enum(["visitedAt", "startedAt", "submittedAt", "approvedAt", "rejectedAt"])
+ .default("visitedAt"),
+});
+
+export const applicationEventSchema = z.object({
+ id: z.string(),
+ country: z.string().nullable(),
+ referralSource: z.string(),
+ referredByPartnerId: z.string().nullable(),
+ visitedAt: z.date().nullable(),
+ startedAt: z.date().nullable(),
+ submittedAt: z.date().nullable(),
+ approvedAt: z.date().nullable(),
+ rejectedAt: z.date().nullable(),
+ partner: PartnerSchema.pick({
+ id: true,
+ name: true,
+ image: true,
+ }).nullable(),
+ group: GroupSchema.pick({
+ id: true,
+ name: true,
+ slug: true,
+ color: true,
+ }).nullable(),
+});
+
+// Application analytics
+export const applicationEventAnalyticsQuerySchema = sharedFilterSchema.extend({
+ groupBy: z
+ .enum(["count", "timeseries", "partnerId", "referralSource", "country"])
+ .default("count"),
+});
+
+const metricsSchema = z.object({
+ visits: z.number(),
+ starts: z.number(),
+ submissions: z.number(),
+ approvals: z.number(),
+ rejections: z.number(),
+});
+
+export const applicationEventAnalyticsSchema = {
+ count: metricsSchema,
+
+ timeseries: metricsSchema.extend({
+ start: z.string(),
+ }),
+
+ partnerId: metricsSchema.extend({
+ partner: PartnerSchema.pick({
+ id: true,
+ name: true,
+ image: true,
+ email: true,
+ }),
+ }),
+
+ referralSource: metricsSchema.extend({
+ referralSource: z.string(),
+ }),
+
+ country: metricsSchema.extend({
+ country: z.string(),
+ }),
+};
diff --git a/apps/web/lib/application-events/update-application-event.ts b/apps/web/lib/application-events/update-application-event.ts
new file mode 100644
index 0000000000..141e8f7976
--- /dev/null
+++ b/apps/web/lib/application-events/update-application-event.ts
@@ -0,0 +1,83 @@
+import { prisma } from "@dub/prisma";
+import { Prisma } from "@dub/prisma/client";
+import { cookies } from "next/headers";
+import { getApplicationEventCookieName } from "./utils";
+
+// Application events visited as a guest have partnerId: null — look up the
+// event via the browser cookie and backfill partnerId + submittedAt.
+// Fallback to the (programId, partnerId) lookup if no cookie is present (e.g. the
+// partner visited while already logged in on a different browser).
+export async function markApplicationEventSubmitted({
+ programId,
+ partnerId,
+ applicationId,
+}: Pick<
+ Prisma.ProgramEnrollmentCreateManyInput,
+ "programId" | "partnerId" | "applicationId"
+>) {
+ const cookieStore = await cookies();
+ const cookieName = getApplicationEventCookieName(programId);
+ const applicationEventId = cookieStore.get(cookieName)?.value;
+ if (!applicationEventId && !partnerId) {
+ console.error(
+ "[markApplicationEventSubmitted]: No application event ID or partner ID provided, skipping...",
+ );
+ return;
+ }
+
+ try {
+ await prisma.programApplicationEvent.updateMany({
+ where: {
+ ...(applicationEventId
+ ? { id: applicationEventId }
+ : { programId, partnerId }),
+ submittedAt: null,
+ },
+ data: {
+ partnerId,
+ submittedAt: new Date(),
+ programApplicationId: applicationId,
+ },
+ });
+ } catch {}
+}
+
+export async function trackApplicationEvents({
+ programId,
+ partnerIds,
+ event,
+}: {
+ programId: string;
+ partnerIds: string[];
+ event: "approved" | "rejected";
+}) {
+ if (partnerIds.length === 0) {
+ return;
+ }
+
+ const eventToColumnMap = {
+ approved: "approvedAt",
+ rejected: "rejectedAt",
+ } as const;
+
+ const column = eventToColumnMap[event];
+
+ if (!column) {
+ throw new Error(`Invalid event: ${event}`);
+ }
+
+ try {
+ await prisma.programApplicationEvent.updateMany({
+ where: {
+ programId,
+ partnerId: {
+ in: partnerIds,
+ },
+ [column]: null,
+ },
+ data: {
+ [column]: new Date(),
+ },
+ });
+ } catch {}
+}
diff --git a/apps/web/lib/application-events/utils.ts b/apps/web/lib/application-events/utils.ts
new file mode 100644
index 0000000000..b88a7aff6d
--- /dev/null
+++ b/apps/web/lib/application-events/utils.ts
@@ -0,0 +1,22 @@
+import { ApplicationEventStages } from "../types";
+import { APPLICATION_ID_COOKIE_PREFIX } from "./schema";
+
+export function getApplicationEventCookieName(programId: string) {
+ return `${APPLICATION_ID_COOKIE_PREFIX}${programId}`;
+}
+
+export const STAGE_VALUE_KEY: Record<
+ ApplicationEventStages,
+ "visits" | "starts" | "submissions" | "approvals"
+> = {
+ visited: "visits",
+ started: "starts",
+ submitted: "submissions",
+ approved: "approvals",
+};
+
+export const getReferralSourceDisplayValue = (referralSource: string) => {
+ if (referralSource === "marketplace") return "Dub Program Marketplace";
+ if (referralSource === "direct") return "Direct application";
+ return referralSource;
+};
diff --git a/apps/web/lib/commissions/schema.ts b/apps/web/lib/commissions/schema.ts
index d8a87d7d41..79e317a179 100644
--- a/apps/web/lib/commissions/schema.ts
+++ b/apps/web/lib/commissions/schema.ts
@@ -54,23 +54,3 @@ export const commissionAnalyticsSchema = {
partnerId: z.array(commissionPartnerIdRowSchema),
} as const;
-
-export type CommissionAnalyticsQuery = z.infer<
- typeof commissionAnalyticsQuerySchema
->;
-
-export type CommissionAnalyticsGroupBy = CommissionAnalyticsQuery["groupBy"];
-
-export type CommissionAnalyticsByGroup = {
- [K in keyof typeof commissionAnalyticsSchema]: z.infer<
- (typeof commissionAnalyticsSchema)[K]
- >;
-};
-
-export type CommissionCategoryRow = CommissionAnalyticsByGroup["type"][number];
-
-export type CommissionTimeseriesItem =
- CommissionAnalyticsByGroup["timeseries"][number];
-
-export type CommissionAnalyticsPartnerRow =
- CommissionAnalyticsByGroup["partnerId"][number];
diff --git a/apps/web/lib/partners/complete-program-applications.ts b/apps/web/lib/partners/complete-program-applications.ts
index 7b4e81fccf..20e08f0be3 100644
--- a/apps/web/lib/partners/complete-program-applications.ts
+++ b/apps/web/lib/partners/complete-program-applications.ts
@@ -4,6 +4,7 @@ import { APP_DOMAIN_WITH_NGROK } from "@dub/utils";
import { createId } from "../api/create-id";
import { detectAndRecordFraudApplication } from "../api/fraud/detect-record-fraud-application";
import { notifyPartnerApplication } from "../api/partners/notify-partner-application";
+import { markApplicationEventSubmitted } from "../application-events/update-application-event";
import { qstash } from "../cron";
import { buildSocialPlatformLookup } from "../social-utils";
import { sendWorkspaceWebhook } from "../webhook/publish";
@@ -256,6 +257,12 @@ export async function completeProgramApplications(userEmail: string) {
}),
]);
}
+
+ await Promise.allSettled(
+ programEnrollments.map((programEnrollment) =>
+ markApplicationEventSubmitted(programEnrollment),
+ ),
+ );
} catch (error) {
console.error("Failed to complete program applications", error);
}
diff --git a/apps/web/lib/swr/use-commission-analytics.ts b/apps/web/lib/swr/use-commission-analytics.ts
index a9aff01e8c..124fe27af2 100644
--- a/apps/web/lib/swr/use-commission-analytics.ts
+++ b/apps/web/lib/swr/use-commission-analytics.ts
@@ -3,18 +3,12 @@ import { IntervalOptions } from "@/lib/analytics/types";
import type {
CommissionAnalyticsByGroup,
CommissionAnalyticsGroupBy,
-} from "@/lib/commissions/schema";
+} from "@/lib/types";
import { fetcher } from "@dub/utils";
import { useMemo } from "react";
import useSWR from "swr";
import useWorkspace from "./use-workspace";
-export type {
- CommissionAnalyticsPartnerRow,
- CommissionCategoryRow,
- CommissionTimeseriesItem,
-} from "@/lib/commissions/schema";
-
export default function useCommissionAnalytics<
G extends CommissionAnalyticsGroupBy,
>({
diff --git a/apps/web/lib/types.ts b/apps/web/lib/types.ts
index 81760cf49b..db2efcacdb 100644
--- a/apps/web/lib/types.ts
+++ b/apps/web/lib/types.ts
@@ -41,8 +41,19 @@ import {
requestTypeSchema,
} from "./api-logs/schemas";
import { PAID_TRAFFIC_PLATFORMS } from "./api/fraud/constants";
+import {
+ APPLICATION_EVENT_STAGES,
+ applicationEventAnalyticsQuerySchema,
+ applicationEventAnalyticsSchema,
+ applicationEventSchema,
+ applicationEventsQuerySchema,
+} from "./application-events/schema";
import { BOUNTY_SUBMISSION_REQUIREMENTS } from "./bounty/constants";
import { BOUNTY_SOCIAL_PLATFORMS } from "./bounty/social-content";
+import {
+ commissionAnalyticsQuerySchema,
+ commissionAnalyticsSchema,
+} from "./commissions/schema";
import {
FOLDER_PERMISSIONS,
FOLDER_WORKSPACE_ACCESS,
@@ -921,7 +932,39 @@ export type RequestType = z.infer<typeof requestTypeSchema>;
export type ApiLogTB = z.infer<typeof apiLogSchemaTB>;
-export type {
- CommissionAnalyticsByGroup,
- CommissionAnalyticsQuery,
-} from "./commissions/schema";
+// Commission events
+export type CommissionAnalyticsQuery = z.infer<
+ typeof commissionAnalyticsQuerySchema
+>;
+
+export type CommissionAnalyticsGroupBy = CommissionAnalyticsQuery["groupBy"];
+
+export type CommissionAnalyticsByGroup = {
+ [K in keyof typeof commissionAnalyticsSchema]: z.infer<
+ (typeof commissionAnalyticsSchema)[K]
+ >;
+};
+
+export type CommissionCategoryRow = CommissionAnalyticsByGroup["type"][number];
+
+export type CommissionAnalyticsPartnerRow =
+ CommissionAnalyticsByGroup["partnerId"][number];
+
+// Application events
+export type ApplicationEvent = z.infer<typeof applicationEventSchema>;
+
+export type ApplicationEventsQuery = z.infer<
+ typeof applicationEventsQuerySchema
+>;
+
+export type ApplicationEventAnalyticsQuery = z.infer<
+ typeof applicationEventAnalyticsQuerySchema
+>;
+
+export type ApplicationEventStages = (typeof APPLICATION_EVENT_STAGES)[number];
+
+export type ApplicationAnalyticsByGroup = {
+ [K in keyof typeof applicationEventAnalyticsSchema]: z.infer<
+ (typeof applicationEventAnalyticsSchema)[K]
+ >;
+};
diff --git a/apps/web/lib/zod/schemas/partners.ts b/apps/web/lib/zod/schemas/partners.ts
index dae29c1a69..cf7c9bef9e 100644
--- a/apps/web/lib/zod/schemas/partners.ts
+++ b/apps/web/lib/zod/schemas/partners.ts
@@ -369,6 +369,7 @@ export const PartnerSchema = z
.describe(
"The partner's email address. Should be a unique value across Dub.",
),
+ username: z.string().nullable().describe("The partner's unique username."),
image: z.string().nullable().describe("The partner's avatar image."),
description: z
.string()
diff --git a/apps/web/scripts/dev/seed-application-events.ts b/apps/web/scripts/dev/seed-application-events.ts
new file mode 100644
index 0000000000..f8a14bd3e4
--- /dev/null
+++ b/apps/web/scripts/dev/seed-application-events.ts
@@ -0,0 +1,94 @@
+import { prisma } from "@dub/prisma";
+import "dotenv-flow/config";
+
+const randomDateBetween = (start: Date, end: Date) => {
+ const startMs = start.getTime();
+ const endMs = end.getTime();
+ const ms = startMs + Math.random() * (endMs - startMs);
+ return new Date(ms);
+};
+
+const randomInt = (min: number, max: number) =>
+ Math.floor(Math.random() * (max - min + 1)) + min;
+
+const sample = <T>(items: readonly T[]) =>
+ items[Math.floor(Math.random() * items.length)];
+
+const referralSources = [
+ "direct",
+ "linkedin.com",
+ "twitter.com",
+ "marketplace",
+ "acme.com",
+ "google.com",
+] as const;
+
+async function main() {
+ const programId = "prog_1K2J9DRWPPJ2F1RX53N92TSGA";
+
+ const programEnrollments = await prisma.programEnrollment.findMany({
+ where: {
+ programId,
+ },
+ orderBy: {
+ createdAt: "asc",
+ },
+ select: {
+ partnerId: true,
+ partner: {
+ select: {
+ country: true,
+ },
+ },
+ },
+ take: 10,
+ });
+
+ if (programEnrollments.length === 0) {
+ console.log(`No enrollments found for program ${programId}`);
+ return;
+ }
+
+ const now = new Date();
+ const thirtyDaysAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+
+ const { count } = await prisma.programApplicationEvent.createMany({
+ data: programEnrollments.map((programEnrollment) => {
+ const visitedAt = randomDateBetween(thirtyDaysAgo, now);
+
+ const startedAt = new Date(
+ visitedAt.getTime() + randomInt(1, 30) * 60 * 1000,
+ );
+
+ const submittedAt = new Date(
+ startedAt.getTime() + randomInt(1, 90) * 60 * 1000,
+ );
+
+ const decidedAt = new Date(
+ submittedAt.getTime() + randomInt(5, 72) * 60 * 60 * 1000,
+ );
+
+ const isApproved = Math.random() < 0.7;
+
+ return {
+ programId,
+ partnerId: programEnrollment.partnerId,
+ visitedAt,
+ startedAt,
+ submittedAt,
+ approvedAt: isApproved ? decidedAt : null,
+ rejectedAt: isApproved ? null : decidedAt,
+ referralSource: sample(referralSources),
+ country: programEnrollment.partner.country ?? null,
+ // intentionally leaving: referredByPartnerId, programApplicationId
+ };
+ }),
+ skipDuplicates: true,
+ });
+
+ console.log(
+ `Seeded ${count} ProgramApplicationEvent rows for ACME (first ${programEnrollments.length} partners)`,
+ );
+}
+
+main();
diff --git a/apps/web/scripts/migrations/backfill-application-events.ts b/apps/web/scripts/migrations/backfill-application-events.ts
new file mode 100644
index 0000000000..4f304f1a0b
--- /dev/null
+++ b/apps/web/scripts/migrations/backfill-application-events.ts
@@ -0,0 +1,101 @@
+import { createId } from "@/lib/api/create-id";
+import { ACTIVE_ENROLLMENT_STATUSES } from "@/lib/zod/schemas/partners";
+import { prisma } from "@dub/prisma";
+import { Prisma } from "@dub/prisma/client";
+import { randomInt } from "crypto";
+import { addSeconds, differenceInSeconds, subSeconds } from "date-fns";
+import "dotenv-flow/config";
+
+async function main() {
+ while (true) {
+ const programApplications = await prisma.programApplication.findMany({
+ where: {
+ programApplicationEvents: {
+ none: {},
+ },
+ },
+ include: {
+ enrollment: {
+ include: {
+ partner: true,
+ links: {
+ orderBy: {
+ createdAt: "asc",
+ },
+ take: 1,
+ },
+ },
+ },
+ },
+ take: 250,
+ });
+
+ if (programApplications.length === 0) {
+ console.log("No program applications found, skipping...");
+ break;
+ }
+
+ const programApplicationEvents: Prisma.ProgramApplicationEventCreateManyInput[] =
+ programApplications.map((programApplication) => {
+ const { programId, enrollment } = programApplication;
+
+ // for applications created after 2025-12-09 (program marketplace launch),
+ // if the enrollment was created within 5 seconds of the application, it's a marketplace referral
+ const referralSource =
+ enrollment &&
+ programApplication.createdAt > new Date("2025-12-09") &&
+ differenceInSeconds(
+ enrollment.createdAt,
+ programApplication.createdAt,
+ ) < 5
+ ? "marketplace"
+ : "direct";
+
+ // average time from view -> submission is 5-10 mins so let's do 5 min + random seconds between 0-300
+ const visitedAt = subSeconds(
+ programApplication.createdAt,
+ 300 + randomInt(0, 300),
+ );
+ // assume starts application after 15-45 seconds
+ const startedAt = addSeconds(visitedAt, randomInt(15, 45));
+
+ const reviewedAt =
+ programApplication.reviewedAt ??
+ enrollment?.links?.[0]?.createdAt ??
+ programApplication.updatedAt;
+
+ return {
+ id: createId({ prefix: "pga_evt_" }),
+ programId: programId,
+ country: programApplication.country ?? enrollment?.partner?.country,
+ referralSource,
+ programApplicationId: programApplication.id,
+ partnerId: enrollment?.partnerId,
+ visitedAt,
+ startedAt,
+ submittedAt: programApplication.createdAt,
+ ...(enrollment
+ ? ACTIVE_ENROLLMENT_STATUSES.includes(enrollment.status)
+ ? {
+ approvedAt: reviewedAt,
+ }
+ : enrollment.status === "rejected"
+ ? {
+ rejectedAt: reviewedAt,
+ }
+ : {}
+ : {}),
+ };
+ });
+
+ // console.table(programApplicationEvents);
+
+ const { count } = await prisma.programApplicationEvent.createMany({
+ data: programApplicationEvents,
+ });
+
+ console.log(`Created ${count} program application events`);
+ }
+}
+
+main();
diff --git a/apps/web/ui/application-analytics.tsx b/apps/web/ui/application-analytics.tsx
new file mode 100644
index 0000000000..4ae555b482
--- /dev/null
+++ b/apps/web/ui/application-analytics.tsx
@@ -0,0 +1,67 @@
+"use client";
+
+import { trackApplicationEventSchema } from "@/lib/application-events/schema";
+import { prettyPrint } from "@dub/utils";
+import { usePathname } from "next/navigation";
+import { useCallback, useEffect, useRef } from "react";
+import { z } from "zod/v4";
+
+async function trackApplicationEvent({
+ eventName,
+ url,
+ referrer,
+}: z.infer<typeof trackApplicationEventSchema>) {
+ const response = await fetch("/api/track/application", {
+ method: "POST",
+ headers: { "Content-Type": "application/json" },
+ body: JSON.stringify({
+ eventName,
+ url,
+ referrer,
+ }),
+ });
+
+ const result = await response.json();
+
+ if (!response.ok) {
+ console.error(`[trackApplicationEvent] ${prettyPrint(result)}`);
+ return;
+ }
+
+ return result;
+}
+
+// Track application visit event
+export function ApplicationAnalytics() {
+ const pathname = usePathname();
+
+ useEffect(() => {
+ trackApplicationEvent({
+ eventName: "visit",
+ url: window.location.href,
+ referrer: window.document.referrer,
+ });
+ }, [pathname]);
+
+ return <></>;
+}
+
+export function useTrackApplyStart({
+ preview = false,
+}: { preview?: boolean } = {}) {
+ const hasTrackedApplicationStart = useRef(false);
+
+ return useCallback(() => {
+ if (preview || hasTrackedApplicationStart.current) {
+ return;
+ }
+
+ hasTrackedApplicationStart.current = true;
+
+ void trackApplicationEvent({
+ eventName: "start",
+ url: window.location.href,
+ referrer: window.document.referrer,
+ });
+ }, [preview]);
+}
diff --git a/apps/web/ui/partners/groups/design/application-form/program-application-form.tsx b/apps/web/ui/partners/groups/design/application-form/program-application-form.tsx
index 7b47d565a2..9c46ede526 100644
--- a/apps/web/ui/partners/groups/design/application-form/program-application-form.tsx
+++ b/apps/web/ui/partners/groups/design/application-form/program-application-form.tsx
@@ -9,6 +9,7 @@ import {
ProgramApplicationFormDataWithValues,
ProgramProps,
} from "@/lib/types";
+import { useTrackApplyStart } from "@/ui/application-analytics";
import { Button, useLocalStorage, useMediaQuery } from "@dub/ui";
import { cn } from "@dub/utils";
import { useSession } from "next-auth/react";
@@ -42,6 +43,9 @@ export function ProgramApplicationForm({
const { isMobile } = useMediaQuery();
const router = useRouter();
const { data: session } = useSession();
+ const trackApplyStart = useTrackApplyStart({
+ preview,
+ });
const form = useForm<FormData>({
defaultValues: {
@@ -133,6 +137,7 @@ export function ProgramApplicationForm({
return (
<FormProvider {...form}>
<form
+ onInputCapture={trackApplyStart}
onSubmit={handleSubmit(async (data) => {
const result = await executeAsync({
...data,
diff --git a/apps/web/ui/partners/partner-status-badges.ts b/apps/web/ui/partners/partner-status-badges.ts
index ecbf6c7b1d..8251fb6785 100644
--- a/apps/web/ui/partners/partner-status-badges.ts
+++ b/apps/web/ui/partners/partner-status-badges.ts
@@ -35,7 +35,7 @@ export const PartnerStatusBadges = {
},
declined: {
label: "Declined",
- variant: "amber",
+ variant: "neutral",
className: "text-amber-600 bg-amber-100",
icon: EnvelopeAlert,
},
diff --git a/apps/web/ui/partners/program-application-sheet.tsx b/apps/web/ui/partners/program-application-sheet.tsx
index 791f4283db..6a51bf9fbe 100644
--- a/apps/web/ui/partners/program-application-sheet.tsx
+++ b/apps/web/ui/partners/program-application-sheet.tsx
@@ -28,6 +28,7 @@ import { FormProvider, useForm } from "react-hook-form";
import { toast } from "sonner";
import useSWR, { mutate } from "swr";
import * as z from "zod/v4";
+import { useTrackApplyStart } from "../application-analytics";
import { ProgramApplicationFormField } from "./groups/design/application-form/fields";
import { formDataForApplicationFormData } from "./groups/design/application-form/form-data-for-application-form-data";
import { PartnerAvatar } from "./partner-avatar";
@@ -103,6 +104,7 @@ function ProgramApplicationSheetForm({
group: z.infer<typeof PartnerProgramGroupSchema>;
}) {
const { partner } = usePartnerProfile();
+ const trackApplyStart = useTrackApplyStart();
const form = useForm<FormData>({
defaultValues: {
@@ -153,6 +155,7 @@ function ProgramApplicationSheetForm({
return (
<FormProvider {...form}>
<form
+ onInputCapture={trackApplyStart}
onSubmit={handleSubmit(onSubmit)}
className={cn(
"flex h-full flex-col transition-opacity duration-200",
diff --git a/packages/prisma/schema/application.prisma b/packages/prisma/schema/application.prisma
new file mode 100644
index 0000000000..aef67803e9
--- /dev/null
+++ b/packages/prisma/schema/application.prisma
@@ -0,0 +1,73 @@
+enum ProgramApplicationRejectionReason {
+ needsMoreDetail
+ doesNotMeetRequirements
+ notTheRightFit
+ other
+}
+
+model ProgramApplication {
+ id String @id @default(cuid())
+ programId String
+ groupId String?
+ name String
+ email String
+ country String?
+ website String? @db.Text
+ youtube String? @db.Text
+ twitter String? @db.Text
+ linkedin String? @db.Text
+ instagram String? @db.Text
+ tiktok String? @db.Text
+ formData Json? @db.Json
+ userId String? // user who reviewed the application
+ rejectionReason ProgramApplicationRejectionReason?
+ rejectionNote String? @db.Text
+ reviewedAt DateTime?
+ createdAt DateTime @default(now())
+ updatedAt DateTime @updatedAt
+
+ program Program @relation(fields: [programId], references: [id])
+ partnerGroup PartnerGroup? @relation(fields: [groupId], references: [id])
+ enrollment ProgramEnrollment?
+ user User? @relation(fields: [userId], references: [id])
+ programApplicationEvents ProgramApplicationEvent[]
+
+ @@index(programId)
+ @@index(groupId)
+ @@index(email)
+ @@index(userId)
+}
+
+model ProgramApplicationEvent {
+ id String @id @default(cuid())
+ programId String
+
+ visitedAt DateTime @default(now())
+ startedAt DateTime?
+ submittedAt DateTime?
+ approvedAt DateTime?
+ rejectedAt DateTime?
+
+ country String?
+ referralSource String // e.g. company.com, linkedin.com, marketplace, direct
+ referredByPartnerId String? // pn_xxx – partner ID who referred the application
+ metadata Json? @db.Json // full URL, ip address, user agent, geo/device data etc.
+
+ programApplicationId String?
+ partnerId String?
+
+ referredByPartner Partner? @relation(fields: [referredByPartnerId], references: [id])
+ application ProgramApplication? @relation(fields: [programApplicationId], references: [id])
+ programEnrollment ProgramEnrollment? @relation(fields: [programId, partnerId], references: [programId, partnerId])
+
+ @@unique([programId, partnerId])
+ @@index([programId, visitedAt])
+ @@index([programId, startedAt])
+ @@index([programId, submittedAt])
+ @@index([programId, approvedAt])
+ @@index([programId, country])
+ @@index([programId, referralSource])
+ @@index([programId, referredByPartnerId])
+ @@index(referredByPartnerId)
+ @@index(programApplicationId)
+}
diff --git a/packages/prisma/schema/partner.prisma b/packages/prisma/schema/partner.prisma
index 7120365480..0573f84bc2 100644
--- a/packages/prisma/schema/partner.prisma
+++ b/packages/prisma/schema/partner.prisma
@@ -37,6 +37,7 @@ enum IdentityVerificationStatus {
model Partner {
id String @id @default(cuid())
name String
+ username String? @unique
companyName String?
profileType PartnerProfileType @default(individual)
email String? @unique
@@ -69,6 +70,7 @@ model Partner {
// miscellaneous fields
invoiceSettings Json?
changeHistoryLog Json?
+ referredByPartnerId String?
programs ProgramEnrollment[]
users PartnerUser[]
@@ -95,6 +97,7 @@ model Partner {
partnerRewinds PartnerRewind[]
platforms PartnerPlatform[]
referrals PartnerReferral[]
+ referredApplications ProgramApplicationEvent[]
@@index(country)
@@index(discoverableAt)
diff --git a/packages/prisma/schema/program.prisma b/packages/prisma/schema/program.prisma
index a8d65bc46b..e21530deab 100644
--- a/packages/prisma/schema/program.prisma
+++ b/packages/prisma/schema/program.prisma
@@ -141,6 +141,7 @@ model ProgramEnrollment {
customers Customer[]
partnerGroup PartnerGroup? @relation(fields: [groupId], references: [id])
application ProgramApplication? @relation(fields: [applicationId], references: [id])
+ applicationEvent ProgramApplicationEvent?
clickReward Reward? @relation("ClickRewardEnrollments", fields: [clickRewardId], references: [id])
leadReward Reward? @relation("LeadRewardEnrollments", fields: [leadRewardId], references: [id])
saleReward Reward? @relation("SaleRewardEnrollments", fields: [saleRewardId], references: [id])
@@ -178,43 +179,4 @@ model ProgramEnrollment {
@@index(leadRewardId)
@@index(saleRewardId)
@@index(discountId)
-}
-
-enum ProgramApplicationRejectionReason {
- needsMoreDetail
- doesNotMeetRequirements
- notTheRightFit
- other
-}
-
-model ProgramApplication {
- id String @id @default(cuid())
- programId String
- groupId String?
- name String
- email String
- country String?
- website String? @db.Text
- youtube String? @db.Text
- twitter String? @db.Text
- linkedin String? @db.Text
- instagram String? @db.Text
- tiktok String? @db.Text
- formData Json? @db.Json
- userId String? // user who reviewed the application
- rejectionReason ProgramApplicationRejectionReason?
- rejectionNote String? @db.Text
- reviewedAt DateTime?
- createdAt DateTime @default(now())
- updatedAt DateTime @updatedAt
-
- program Program @relation(fields: [programId], references: [id])
- partnerGroup PartnerGroup? @relation(fields: [groupId], references: [id])
- enrollment ProgramEnrollment?
- user User? @relation(fields: [userId], references: [id])
-
- @@index(programId)
- @@index(groupId)
- @@index(email)
- @@index(userId)
-}
+}
\ No newline at end of file