FEAT: Dynamic bounty start date

apps/web/app/(ee)/api/bounties/[bountyId]/route.ts

@@ -6,7 +6,9 @@ import { parseRequestBody } from "@/lib/api/utils";
 import { WorkflowCondition } from "@/lib/api/workflows/types";
 import { validateWorkflowConditions } from "@/lib/api/workflows/validate-workflow-conditions";
 import { withWorkspace } from "@/lib/auth";
+import { bountyEligibilityIncludes } from "@/lib/bounty/api/bounty-availability";
 import { generatePerformanceBountyName } from "@/lib/bounty/api/generate-performance-bounty-name";
+import { getBountyOrThrow } from "@/lib/bounty/api/get-bounty-or-throw";
 import { getBountyWithDetails } from "@/lib/bounty/api/get-bounty-with-details";
 import { PERFORMANCE_BOUNTY_SCOPE_ATTRIBUTES } from "@/lib/bounty/api/performance-bounty-scope-attributes";
 import { validateBounty } from "@/lib/bounty/api/validate-bounty";
@@ -19,7 +21,7 @@ import {
   updateBountySchema,
 } from "@/lib/zod/schemas/bounties";
 import { arrayEqual, deepEqual } from "@dub/utils";
-import { PartnerGroup, Prisma } from "@prisma/client";
+import { BountyStartMode, PartnerGroup, Prisma } from "@prisma/client";
 import { waitUntil } from "@vercel/functions";
 import { NextResponse } from "next/server";
 
@@ -55,6 +57,8 @@ export const PATCH = withWorkspace(
       description,
       startsAt,
       endsAt,
+      startMode,
+      endsAfterDays,
       submissionsOpenAt,
       submissionFrequency,
       maxSubmissions,
@@ -65,26 +69,57 @@ export const PATCH = withWorkspace(
       groupIds,
     } = updateBountySchema.parse(await parseRequestBody(req));
 
-    const bounty = await prisma.bounty.findUniqueOrThrow({
-      where: {
-        id: bountyId,
-        programId,
-      },
+    const bounty = await getBountyOrThrow({
+      bountyId,
+      programId,
       include: {
-        groups: true,
         workflow: true,
         _count: {
           select: {
             submissions: true,
           },
         },
+        ...bountyEligibilityIncludes,
       },
     });
 
+    const nextStartMode =
+      startMode !== undefined ? startMode : bounty.startMode;
+
+    // Absolute end dates are cleared when switching to relative (unless the
+    // client explicitly sends endsAt) or when setting endsAfterDays.
+    let endsAtUpdate: { endsAt?: Date | null } = {};
+
+    if (endsAt !== undefined) {
+      endsAtUpdate = { endsAt };
+    } else if (endsAfterDays != null) {
+      endsAtUpdate = { endsAt: null };
+    } else if (
+      nextStartMode === BountyStartMode.relative &&
+      bounty.endsAt != null
+    ) {
+      endsAtUpdate = { endsAt: null };
+    }
+
     validateBounty({
       type: bounty.type,
-      startsAt,
-      endsAt: endsAt !== undefined ? endsAt : bounty.endsAt,
+      // Relative bounties never store startsAt; coerce so mode switches don't
+      // fail validation against a leftover absolute startsAt.
+      startsAt:
+        nextStartMode === BountyStartMode.relative
+          ? null
+          : startsAt !== undefined
+            ? startsAt
+            : bounty.startsAt,
+      endsAt:
+        endsAtUpdate.endsAt !== undefined ? endsAtUpdate.endsAt : bounty.endsAt,
+      startMode: nextStartMode,
+      endsAfterDays:
+        endsAfterDays !== undefined
+          ? endsAfterDays
+          : nextStartMode === BountyStartMode.absolute
+            ? null
+            : bounty.endsAfterDays,
       submissionsOpenAt,
       submissionFrequency:
         submissionFrequency !== undefined
@@ -121,17 +156,22 @@ export const PATCH = withWorkspace(
 
     // if groupIds is provided and is different from the current groupIds, update the groups
     let updatedPartnerGroups: PartnerGroup[] | undefined = undefined;
-    if (
-      groupIds &&
-      !arrayEqual(
-        bounty.groups.map((group) => group.groupId),
-        groupIds,
-      )
-    ) {
-      updatedPartnerGroups = await throwIfInvalidGroupIds({
-        programId,
-        groupIds,
-      });
+    let shouldUpdatePartnerGroups = false;
+
+    if (groupIds !== undefined) {
+      const currentGroupIds = bounty.groups.map((group) => group.groupId);
+      const newGroupIds = groupIds || [];
+
+      if (!arrayEqual(currentGroupIds, newGroupIds)) {
+        if (newGroupIds.length > 0) {
+          updatedPartnerGroups = await throwIfInvalidGroupIds({
+            programId,
+            groupIds: newGroupIds,
+          });
+        }
+
+        shouldUpdatePartnerGroups = true;
+      }
     }
 
     // Prevent updates if `performanceCondition.attribute` differs from the current value if there are existing submissions
@@ -187,6 +227,19 @@ export const PATCH = withWorkspace(
       });
     }
 
+    // Relative bounties start when a partner joins, so startsAt is cleared.
+    // For absolute bounties, only update startsAt when explicitly provided.
+    let startsAtUpdate: { startsAt?: Date | null } = {};
+
+    if (nextStartMode === BountyStartMode.relative) {
+      startsAtUpdate = { startsAt: null };
+    } else if (startsAt !== undefined) {
+      startsAtUpdate = { startsAt: startsAt ?? new Date() };
+    } else if (bounty.startsAt === null) {
+      // Switching relative -> absolute without a startsAt: default to now
+      startsAtUpdate = { startsAt: new Date() };
+    }
+
     const data = await prisma.$transaction(async (tx) => {
       const updatedBounty = await tx.bounty.update({
         where: {
@@ -195,8 +248,15 @@ export const PATCH = withWorkspace(
         data: {
           name: bountyName ?? undefined,
           description,
-          startsAt: startsAt!, // Can remove the ! when we're on a newer TS version (currently 5.4.4)
-          endsAt,
+          ...startsAtUpdate,
+          ...endsAtUpdate,
+          ...(startMode !== undefined && { startMode }),
+          ...(endsAfterDays !== undefined
+            ? { endsAfterDays }
+            : nextStartMode === BountyStartMode.absolute &&
+                bounty.endsAfterDays != null
+              ? { endsAfterDays: null }
+              : {}),
           submissionsOpenAt:
             bounty.type === "submission" ? submissionsOpenAt : null,
           ...(bounty.type === "submission" &&
@@ -212,18 +272,21 @@ export const PATCH = withWorkspace(
             submissionRequirements !== undefined && {
               submissionRequirements: submissionRequirements ?? Prisma.DbNull,
             }),
-          ...(updatedPartnerGroups && {
+          ...(shouldUpdatePartnerGroups && {
             groups: {
               deleteMany: {},
-              create: updatedPartnerGroups.map((group) => ({
-                groupId: group.id,
-              })),
+              ...(updatedPartnerGroups &&
+                updatedPartnerGroups.length > 0 && {
+                  create: updatedPartnerGroups.map((group) => ({
+                    groupId: group.id,
+                  })),
+                }),
             },
           }),
         },
         include: {
           workflow: true,
-          groups: true,
+          ...bountyEligibilityIncludes,
         },
       });
 
@@ -289,19 +352,17 @@ export const DELETE = withWorkspace(
     const { bountyId } = params;
     const programId = getDefaultProgramIdOrThrow(workspace);
 
-    const bounty = await prisma.bounty.findUniqueOrThrow({
-      where: {
-        id: bountyId,
-        programId,
-      },
+    const bounty = await getBountyOrThrow({
+      bountyId,
+      programId,
       include: {
-        groups: true,
         workflow: true,
         _count: {
           select: {
             submissions: true,
           },
         },
+        ...bountyEligibilityIncludes,
       },
     });
 

apps/web/app/(ee)/api/bounties/[bountyId]/submissions/route.ts

@@ -17,9 +17,6 @@ export const GET = withWorkspace(
     await getBountyOrThrow({
       bountyId,
       programId,
-      include: {
-        groups: true,
-      },
     });
 
     const {

apps/web/app/(ee)/api/bounties/[bountyId]/sync-social-metrics/route.ts

@@ -2,8 +2,10 @@ import { DubApiError } from "@/lib/api/errors";
 import { getDefaultProgramIdOrThrow } from "@/lib/api/programs/get-default-program-id-or-throw";
 import { parseRequestBody } from "@/lib/api/utils";
 import { withWorkspace } from "@/lib/auth";
+import { getEffectiveBountyPeriod } from "@/lib/bounty/api/bounty-availability";
 import { getBountyOrThrow } from "@/lib/bounty/api/get-bounty-or-throw";
 import { getSocialMetricsUpdates } from "@/lib/bounty/api/get-social-metrics-updates";
+import { isBountyEnded, isBountyStarted } from "@/lib/bounty/bounty-period";
 import { resolveBountyDetails } from "@/lib/bounty/utils";
 import { qstash } from "@/lib/cron";
 import { prisma } from "@/lib/prisma";
@@ -52,6 +54,11 @@ export const POST = withWorkspace(
                 urls: true,
                 status: true,
                 partner: true,
+                programEnrollment: {
+                  select: {
+                    createdAt: true,
+                  },
+                },
               },
             },
           }
@@ -67,58 +74,60 @@ export const POST = withWorkspace(
       });
     }
 
-    const submission = submissionId ? bounty.submissions?.[0] : undefined;
-
-    if (submissionId) {
-      if (!submission) {
-        throw new DubApiError({
-          code: "not_found",
-          message: `Submission ${submissionId} not found.`,
-        });
-      }
+    // Bounty-wide sync (no submissionId): run asynchronously via a background job
+    if (!submissionId) {
+      const response = await qstash.publishJSON({
+        url: `${APP_DOMAIN_WITH_NGROK}/api/cron/bounties/sync-social-metrics`,
+        method: "POST",
+        body: {
+          bountyId,
+        },
+      });
 
-      if (submission.status === "approved") {
+      if (!response.messageId) {
         throw new DubApiError({
           code: "bad_request",
-          message: "Social metrics can't be synced for an approved submission.",
+          message: "Could not sync social metrics for this bounty now.",
         });
       }
+
+      return NextResponse.json({});
     }
 
-    const now = new Date();
+    // Single-submission sync
+    const submission = bounty.submissions?.[0];
 
-    if (bounty.startsAt && bounty.startsAt > now) {
+    if (!submission || !submission.programEnrollment) {
       throw new DubApiError({
-        code: "bad_request",
-        message: "Social metrics can only be synced after the bounty starts.",
+        code: "not_found",
+        message: `Submission ${submissionId} not found.`,
       });
     }
 
-    if (bounty.endsAt && bounty.endsAt < now) {
+    if (submission.status === "approved") {
       throw new DubApiError({
         code: "bad_request",
-        message: "Social metrics can't be synced after the bounty ends.",
+        message: "Social metrics can't be synced for an approved submission.",
       });
     }
 
-    // Do the sync in a background job if no submissionId is provided
-    if (!submissionId) {
-      const response = await qstash.publishJSON({
-        url: `${APP_DOMAIN_WITH_NGROK}/api/cron/bounties/sync-social-metrics`,
-        method: "POST",
-        body: {
-          bountyId,
-        },
-      });
+    const { startsAt, endsAt } = getEffectiveBountyPeriod({
+      programEnrollment: submission.programEnrollment,
+      bounty,
+    });
 
-      if (!response.messageId) {
-        throw new DubApiError({
-          code: "bad_request",
-          message: "Could not sync social metrics for this bounty now.",
-        });
-      }
+    if (!isBountyStarted(startsAt)) {
+      throw new DubApiError({
+        code: "bad_request",
+        message: "Social metrics can only be synced after the bounty starts.",
+      });
+    }
 
-      return NextResponse.json({});
+    if (isBountyEnded(endsAt)) {
+      throw new DubApiError({
+        code: "bad_request",
+        message: "Social metrics can't be synced after the bounty ends.",
+      });
     }
 
     // Otherwise, do the sync for the specific submission